Introduction
API
Manage Incoming Orders
Manage your Catalog of products
SFTP
Manage your Catalog of products
Manage your Promotions
Testing Integration#
Click below to jump to the topics:
Prerequisites for Testing#
In order to test your integration, you’ll need to do the following:#
Choose a Test Vendor#
- Option 1: Use an existing test vendor from your chain
- Option 2: Create and onboard a new test store for testing
Validate Your Integration#
You can leverage our end-to-end (E2E) test cases to validate that integration meeting your requirements
Note!
How do I perform E2E testing?#
In order to send requests , please create a Bearer Token in Partner Portal. Please refer to the Token Management & Access Section.
As you send the request to update the product - an asynchronous job will be created in the background, meaning that the job is later sent to the configured webhook.
Creating a Promotion#
- Prepare the Request:
- Create the API request to create a promotion.
- Ensure the request contains valid SKUs and promotion details.
Note!
- Send the Request: When the request is submitted, the status of the promotion will be queued, meaning it is in the process of being created.
- Check Promotion Status: Use the GET endpoint to query the status of the promotion and confirm its completion.
- Review the Promotion: Validate the promotion in the Vendor Portal or the Platform App to ensure it was successfully created.
Best Practices:#
- To minimize operational impact, create promotions for one or two products with a small discount (e.g. a few cents).
- Ensure the discounted price is always lower than the original price; otherwise, the promotion will not be created.
- Consider running promotions outside of working hours to avoid potential disruptions.
Modifying a Promotion#
- Prepare the Modification Request:
- Use the same API request as for the promotions creation.
- To remove a SKU, set "active": false at the SKU level.
Note
- Submit the Request: Send the request and ensure the job is processed.
- Check the Update Status: Use the GET endpoint to confirm the job was completed.
- Validate in the Vendor Portal: Verify that the SKU was successfully removed from the promotion.
Deactivating a Promotion#
- Prepare the Deactivation Request: Send the same request with "active": false at the campaign level.
- Submit the Request: The promotion will be deactivated upon successful processing.
- Confirm Deactivation: Use the GET endpoint to ensure the job was completed.
- Verify in the Vendor Portal: Confirm that the promotion is no longer active.