Introduction
API
API
Manage Incoming Orders
Manage Incoming Orders
Manage your Catalog of products
Manage your Catalog of products
SFTP
SFTP
Manage your Catalog of products
Manage your Catalog of products
Manage your Promotions
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.