Skip to main content

​
1. External client integration

How to obtain an OAuth client? NOTE: Before requesting an OAuth client, it is necessary to have established a commercial agreement with Trade. Once this step is completed and the required information detailed below is gathered, you can start the account configuration process using the designated channels provided by X-Mart. Information needed to create an OAuth client:

​
2. Overview of Stores and Lists

X-Mart provides a series of API endpoints that facilitate the management and synchronization of stores, sales channels, and lists within the platform. Below is a summary of the main endpoints available:

​
Stores and Sales Channels

This endpoint allows you to retrieve a list of stores associated with a specific brand. It is useful for getting an overview of all operational locations under a brand.
This endpoint is used to add new stores and sales channels to the system. It facilitates the efficient expansion and updating of the store network.
Allows you to retrieve specific details of a store based on its unique identifier. It is essential for the management and updating of precise information for each individual store.
With this endpoint, you can modify the operational status of a store (e.g., active or inactive). It is crucial for keeping the store’s availability up-to-date in real-time.

​
Lists

This endpoint provides a detailed report of the data synchronization, allowing you to monitor and verify the status of the synchronizations performed.
This endpoint is used to add new stores and sales channels to the system. It facilitates the efficient expansion and updating of the store network.
This set of endpoints ensures comprehensive and efficient management of store, sales, and list operations within X-Mart, offering robust tools for real-time control and monitoring.

​
3. Explanation of v3 injection

X-Mart’s Service Catalog includes a series of methods that facilitate the management and synchronization of data on the platform. Below is a summary of the main endpoints available:
Token Retrieval This endpoint allows obtaining an authentication token necessary to access other services on the platform. It is essential to ensure that all interactions with the API are secure and authorized.
New Order Webhook This endpoint is used to receive notifications of new orders. It allows external systems to integrate with X-Mart to process and manage orders in real-time.
Order Retrieval This endpoint allows retrieving specific details of an order based on its unique identifier. It is crucial for the management and tracking of orders, ensuring that each transaction is recorded and can be consulted at any time.

​
4. Fulfillment (status changes)

X-Mart provides a series of API endpoints that facilitate the management and processing of orders, ensuring an efficient flow from order placement to fulfillment. Below is a summary of the main endpoints available:
This endpoint allows obtaining an authentication token using a registered client. It is essential to ensure that all interactions with the API are secure and authorized.
This endpoint is used to redeem a local coupon using a UID (Unique Identifier) and a promotion code. It facilitates the application of discounts and promotions on customer orders.
This endpoint is crucial for keeping customers informed about the status and location of their orders in real-time.
It is vital for managing and updating the status of orders as they progress through the fulfillment process.
This endpoint is essential for managing logistics and ensuring that orders are delivered efficiently.
It helps coordinate the collection of orders by customers and ensures the pickup process runs smoothly.
This endpoint is important for verifying and managing the payments made by customers, ensuring that all transactions are accurate and correctly recorded.