Agent skill · forcedotcom
consumer-goods-promotion-bo-api-deploy
Use to enable the Consumer Goods Cloud TPM Promotion Business Object (BO) API framework in a Salesforce org, interview the user for the custom Workflow Step they want to add, generate and deploy that Apex class, wire it into the create/update/copy workflows, and prove it end-to-end via headless REST ingest. Ships a worked reference example (SetCommentValue) but the customization is user-supplied per org. Triggers on \"deploy the promotion BO API\", \"set up promotion BO API\", \"headless promotion create\", \"add a BO API workflow step\".
What it needs
About 10k tokens when loaded.
What this skill does
Deploy the Promotion BO API What this does Turns on the Consumer Goods Cloud TPM Promotion Business Object (BO) API in a Salesforce org, interviews the user for one custom Workflow Step to add to the promotion pipeline, generates and deploys that Apex class, registers it against a BO API entity, wires it into the customer's chosen subset of {create, update, copy} workflows, then proves the whole path end-to-end via three REST endpoints: POST /services/apexrest/<prefix>/promotions/initialize POST /services/apexrest/<prefix>/promotions/ingest GET /services/apexrest/<prefix>/promotions/status?importId=... It is meant for headless delivery: point it at an org, answer the interview, and the skill installs the step and verifies it. The Promotion BO API ships in the CGCloud managed package (namespace cgcloud released, cgclouddev dev/beta). Every Apex identifier, object/field API name, and REST URL is derived from the detected package prefix at runtime — this skill never hard-codes it. derive is out of scope here (a follow-up skill covers it). Detailed runbooks for the write and smoke phases live under references/: references/conventions-and-payload-rules.md — sales-org partitioning, schema-first contract derivation, and the eight cross-workflow payload rules R1–R8. references/generate-and-wire.md — Phase 5a (generate + deploy the class) and Phase 5b (register + wire the step), with the full register-step.apex. references/smoke-and-verify.md — Phase 6 (contract derivation, payload materialization, create/update/copy legs + verification). references/reference-example-set-comment-value.md — the shipped SetCommentValue preset (assets at assets/set-comment-value/). Inputs to collect first Ask before starting; do not guess. 1. Org alias — the sf alias of the target org. Required. 2. Sales org — required pre-parameter, default 0001. Must be 4 chars, uppercase (mirrors TPMSetupData.validateSalesOrg). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills forcedotcom/consumer-goods-promotion-bo-api-deploy