v67.0
Consumer Goods Cloud Trade Promotion Management (TPM) provides a number of Integration APIs to help clients get CG Cloud TPM up and running.
Integration APIs are used to integrate data from external systems to the Consumer Goods Cloud TPM. See Get Started with Integrated Service API.
Limits and Quotas
The API request limitations are 200 requests per second or 4000 requests per minute.
Upto version 57.0, the Consumer Goods Cloud integration APIs were versioned as either v1 or v2, in the format:
curl /api/v1/templates/measures
From version 58.0 onwards, the Consumer Goods Cloud APIs are available in the standard Salesforce API format:
curl /api/v67.0/templates/measures?salesorg=0001
The above URL contains an additional salesorg parameter, and hence a few API contracts have changed. Organizations that follow non-Hyperforce-based permissions will not be able to support the v1 and v2 versions of the Consumer Goods Cloud APIs. APIs will raise a timeout after 120s seconds of processing. Ensure to reduce the response and load using strict filters. Always implement a fallback in case of an HTTP timeout in projects with mixed load scenarios.
Note: You can access the CGCloud processing services integration URL from the processing services pairing app page in your Salesforce org.
What's New in Version v67.0
Starting with API version 67.0, the Promotion and Tactic Volume APIs accept both Salesforce record IDs and External IDs in the promotion and tactic fields you send (for example, prm and tac in POST payloads, and promotion and tactic in DELETE filters). This makes it easier to integrate data from external systems that use their own identifier schemes.
Let us know so we can improve!