Skip to main content

Feed

If you use the Feed flow either as a contingency or as the normal flow, it is important to understand that changes to entities generate a record in the Feed to be consumed, as well as how the Callback works.

These records can be obtained through the endpoint of their respective Feed.

Order Feed - /v2/orders/feeds

Transmission Feed - /v2/transmissions/feeds

Stock reservation Feed - under construction

Flow​

For the Feed to work correctly, whether it is an order feed, a transmission feed, or a stock reservation feed, after processing the information the integrator must send a request confirming that the record has been read, so that the notification is considered as read and no longer appears in subsequent queries.

The ideal process is:

  1. Read the list of Feeds, obtaining the list of updated records (GET method on the endpoints mentioned above);
  2. Retrieve the details of the updated record — for example, by performing a GET on the order that has a notification in the Feed;
  3. Process the order in the integrating partner's system. At this point, it is important that the integrator ensures the uniqueness of the information, treating IDs as unique keys;
  4. Send a PUT request to mark the Feed as read, so it will no longer appear in the notification listing.

Order Feed​

The Order Feed, being widely used, has some additional particularities. The main ones are listed below. Pay attention to these points when developing your integration.

  • Re-notification: ANYMARKET may notify the same order, for the same status, more than once in specific scenarios. We apply rules to try to minimize these occurrences; however, the integrating client must ensure the uniqueness of an order through the order ID. Typically, the following scenarios may occur:
    • Instability Situations: if failures occur in external services or during scheduled maintenance in ANYMARKET.
    • Data Update by the Marketplace: if the sales channel sends us a change in the order data (even if the status remains the same), we will notify you.
    • Error Correction at the Source: when the marketplace itself resends a notification to correct information.
    • Manual user action on the order screen: when the user selects the order on the ANYMARKET screen and triggers the "Sync with: ERP/Platform" feature.
danger

Attention​

Notifications in the Feed are available for reading for up to 30 days from the moment they are created. After this period, the records will no longer be displayed.