[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides change orders multilevel omnichannel inventory external marketplaces in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/getting-started)

---

Integration Guides

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

[VTEX Shipping Network](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-shipping-network)

[VTEX Tracking](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-tracking)

[VTEX Pick and Pack](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-pick-and-pack)

[Multilevel Omnichannel Inventory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/multilevel-omnichannel-inventory)

[Multilevel omnichannel inventory API integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/multilevel-omnichannel-inventory-api-integration)

[Change chain orders in external marketplaces](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces)

[Pickup point](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/setting-up-white-label-seller-as-pickup-point)

[Delivery Promise](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/delivery-promise)

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/getting-started)

---

Integration Guides

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

[VTEX Shipping Network](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-shipping-network)

[VTEX Tracking](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-tracking)

[VTEX Pick and Pack](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-pick-and-pack)

[Multilevel Omnichannel Inventory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/multilevel-omnichannel-inventory)

[Multilevel omnichannel inventory API integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/multilevel-omnichannel-inventory-api-integration)

[Change chain orders in external marketplaces](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces)

[Pickup point](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/setting-up-white-label-seller-as-pickup-point)

[Delivery Promise](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/delivery-promise)

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides)

Logistics

[Multilevel Omnichannel Inventory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/multilevel-omnichannel-inventory)

[Change chain orders in external marketplaces](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces)

Change chain orders in external marketplaces

> The [Multilevel Omnichannel Inventory (MOI)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/multilevel-omnichannel-inventory) feature has been discontinued for integrations with external marketplaces. Now, MOI is available only for integrations between VTEX marketplaces and sellers. We recommend reviewing your integration strategies to align with the currently supported functionalities. For more information, please contact [VTEX support](https://read.calvincode.net/reader?url=https://help.vtex.com/en/support).

[Multilevel Omnichannel Inventory](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/docs/multilevel-omnichannel-inventory) is the VTEX setting that allows franchise accounts or white label sellers' inventory to be sold in marketplaces connected to the main account. This article explains how to use the [Change order](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/docs/change-order) while performing Multilevel Omnichannel Inventory operations in [external marketplaces](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/docs/external-marketplace-integration-guide).

By configuring this feature, your VTEX store will be able to have orders' items or prices changed when selling products that belong to a franchise account in orders made in external marketplaces. This happens due to a new endpoint is created to receive change order’s notifications sent by a VTEX seller in a Multilevel Omnichannel Inventory operation.

The image below shows how the process occurs, in more detail:

![{"base64":"  ","img":{"width":8253,"height":5936,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":991954,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/Integration-Guides/change%20chain%20orders%20in%20multilevel%20omnichannel%20inventory%20%20marketplace.jpg"}}](https://read.calvincode.net/reader?url=https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/Integration-Guides/change%20chain%20orders%20in%20multilevel%20omnichannel%20inventory%20%20marketplace.jpg)

## Implementators

The integration can be implemented by:

* **Integration partner** with the technical ability to implement integrations.
* **External marketplace** who develops an integration with a VTEX store.

This article is suitable for both cases.

> The external marketplace must be responsible for the payment process, otherwise the change order in Multilevel Omnichannel Inventory chain orders in external marketplaces operations will be blocked by the Order Management System (OMS).

## Implementation steps

The feature is implemented as follows:

1. The external marketplace or partner creates an endpoint to receive notifications of order changes in Multilevel Omnichannel Inventory operations in external marketplaces, as specified in [Expected payloads](#expected-payloads). The endpoint must have a base URL followed by `/pvt/orders/{orderGroup}/changes` .
> For example: `https://www.{{storeName}}.com.br/pvt/orders/orderGroup/changes`.
2. The external marketplace informs the base URL to VTEX's Order Management System (OMS) when a new order is placed in the external marketplace, by using the `marketplaceServicesEndpoint` field in the [Order placement](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/reference/order-placement) API.
3. When an order is changed in the external marketplace, the OMS uses the base URL informed through `marketplaceServicesEndpoint` and concatenates it with `/pvt/orders/{orderGroup}/changes`, so that the endpoint created in step 1 receives notifications about order changes.

> We have considered the `OrderGroup` to build the endpoint because it follows the [Multilevel Omnichannel Inventory](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/docs/multilevel-omnichannel-inventory) communication standards.

## Expected payloads

The endpoint created will have a request body and a response body, as shown in the next sections.

### Request body

The payload sent to the external marketplace follows the same structure used in the [Register change on order](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/reference/registerchange) API. You have an example below:

`1

{

2

 "reason": "Some text about the change. E.g: Add item XPTO",

3

 "discountValue": 0,

4

 "incrementValue": 0,

5

 "itemsRemoved": [],

6

 "itemsAdded": [

7

 {

8

 "sellerItemId": "8",

9

 "quantity": 1,

10

 "price": 12,

11

 "unitMultiplier": 1.0000,

12

 "measurementUnit": "un"

13

 }

14

 ]

15

}

`

| **Field**       | **Type**         | **Description**                                                                                |
| --------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| reason          | string           | Text explaining why there was a change in the order. This information may be shown to the shopper in the storefront or transactional emails. |
| discountValue   | integer          | This field can be used to apply a discount to the total value of the order. Value in cents.                                                  |
| incrementValue  | integer          | This field can be used to increment the total value of the order. Value in cents.                                                            |
| itemsAdded      | array of objects | List of items that should be added to the order.                                                                                |
| sellerItemId    | string           | SKU ID of the item to be added to the order.                                                                                |
| quantity        | integer          | Quantity of items to be added to the order.                                                                                |
| price           | integer          | Total amount in cents of the item to be added to the order.                                                                                |
| unitMultiplier  | integer          | Unit multiplier of the item to be added to the order.                                                                                |
| measurementUnit | string           | Item's measurement unit.                                                                                |
| itemsRemoved    | array of objects | List of items that should be removed from the order. Has the same fields of itemsAdded.                                                      |

### Response body

The request returns two types of responses:

* **Response 200 OK:** confirmation and payload as the following example:

`1

{

2

"orderId": "SLR-v20918230965-01",

3

"receipt": "61d49ff5-eee4-4093-aba1-1560435dedb0"

4

}

`

| Field   | Type   | Description                                                                                |
| ------- | ------ | ------------------------------------------------------------------------------------------- |
| orderId | string | Order ID is a unique code that identifies an order.                                         |
| receipt | string | Hash for transaction identification or any string that uniquely identifies the transaction. |

* **Response 500 error:** message of failure and there is no payload.

Contributors

4

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F91396357%3Fv%3D4%26w=64%26q=75)](https://github.com/anabaarbosa)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F83723439%3Fv%3D4%26w=64%26q=75)](https://github.com/jumeyermattosarruda)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F77300325%3Fv%3D4%26w=64%26q=75)](https://github.com/Isabella-Veloso)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Fulfillment/multilevel-omnichannel-inventory/change-orders-multilevel-omnichannel-inventory-external-marketplaces.md)

[Multilevel omnichannel inventory API integration« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces//docs/guides/multilevel-omnichannel-inventory-api-integration)[Pickup pointNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces//docs/guides/setting-up-white-label-seller-as-pickup-point)

Contributors

4

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F91396357%3Fv%3D4%26w=64%26q=75)](https://github.com/anabaarbosa)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F83723439%3Fv%3D4%26w=64%26q=75)](https://github.com/jumeyermattosarruda)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F77300325%3Fv%3D4%26w=64%26q=75)](https://github.com/Isabella-Veloso)

ON THIS PAGE

[Implementators](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23implementators)

[Implementation steps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23implementation-steps)

[Expected payloads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23expected-payloads)

[Request body](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23request-body)[Response body](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23response-body)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Fulfillment/multilevel-omnichannel-inventory/change-orders-multilevel-omnichannel-inventory-external-marketplaces.md)

Copy page

On this page

ON THIS PAGE

[Implementators](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23implementators)

[Implementation steps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23implementation-steps)

[Expected payloads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23expected-payloads)

[Request body](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23request-body)[Response body](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces/docs/guides/change-orders-multilevel-omnichannel-inventory-external-marketplaces%23response-body)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)


[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/getting-started)

---

Integration Guides

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/getting-started)

---

Integration Guides

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/data-protection-plus)

---

Weni by VTEX

---

API Guides

Get to know our Commerce APIs to extend the VTEX platform and leverage your business.

![App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fapi-guides.67b120a0.png%26w=3840%26q=75)

Get started

Our core commerce capabilities, provided by over 70 shared microservices, are available for flexible customization through our REST APIs. This enables our clients to integrate third-party solutions into a single platform for all experiences.

![Platform overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fplatform.3092968d.png%26w=3840%26q=75)

Using our REST APIs with our serverless development platform (VTEX IO) and scalable data service (Master Data), you can expand the VTEX platform to address your unique business needs.

Data orchestration

Our platform orchestrates data through multiple channels and sources to remove barriers and enable more possibilities. E-commerce, Brick-and-mortar, Marketplace, B2B... You name it, we enable it. That is why we are a unified commerce platform for unified businesses.

![Data orchestration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fdata-orchestration.3cd3a0d8.png%26w=3840%26q=75)

Core services

Get to know our core microsservices and leverage your business with our Headless architecture. Our API Guides and Reference cover VTEX Core Services, as illustrated in the image below.

For details about customizing and composing each service, see our[ Composability](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/composability) guide.

Merchant channels

CDN

Web Store

PWA

Live Shopping

Conversational

Marketplace Out

Personal Shopper

Mobile App

IOT

VTEX Core services

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/catalog-overview)

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/checkout-overview)

[Promotions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/promotions-overview)

[Pricing](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/pricing-overview)

[Payment Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/payments-overview)

[Intelligent Search](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/search-overview)

[Account management](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/docs/guides/account-management)

DaaS - Master Data

OMS

Subscriptions

Ratings and reviews

CMS

Search

Messages

Logistics/ Inventory

Customers

VTEX IO Apps (PaaS)

Custom Admin

Custom store component

Custom backend service (API)

VTEX App

3rd party optional

Search

Personalization

Ratings and Reviews

Loyalty

Analytics and Reporting

DXP

Customer Payments

ADA

Integration Layer

Merchant back office

ERP

OMS

WMS

PIM

CRM

Data Lake

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)


[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides external marketplace integration invoice tracking in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-guide)

[Marketplace / Seller architecture](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-architecture)

[Store setup for VTEX Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-vtex-seller-setup)

[Creating an integration app from a Template](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-app-template)

[Catalog Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-catalog)

[Catalog logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-logs)

[Get product list for an initial load](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-product-load)

[How to get a new product to offer in the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-new-products)

[How to get product updates](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-product-updates)

[Product and Category Mappings](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-catalog-mapping)

[How to keep prices updated](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-price-update)

[How to keep stock updated](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-stock-update)

[Order Integration overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-orders)

[Recommendations](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-recommendations)

[New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-collect-orders)

[Update Order Status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-update-order-status)

[How to validate if items are available for delivery](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-delivery-validation)

[Sending invoice and tracking code to the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking)

[How to update a canceled order’s status in VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-canceled-orders)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/login-integration-guide)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/sent-offers-integration-guide-connectors)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/payments-integration-guide)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-guide)

[Marketplace / Seller architecture](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-architecture)

[Store setup for VTEX Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-vtex-seller-setup)

[Creating an integration app from a Template](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-app-template)

[Catalog Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-catalog)

[Catalog logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-logs)

[Get product list for an initial load](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-product-load)

[How to get a new product to offer in the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-new-products)

[How to get product updates](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-product-updates)

[Product and Category Mappings](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-catalog-mapping)

[How to keep prices updated](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-price-update)

[How to keep stock updated](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-stock-update)

[Order Integration overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-orders)

[Recommendations](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-recommendations)

[New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-collect-orders)

[Update Order Status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-update-order-status)

[How to validate if items are available for delivery](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-delivery-validation)

[Sending invoice and tracking code to the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking)

[How to update a canceled order’s status in VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-canceled-orders)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/login-integration-guide)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/sent-offers-integration-guide-connectors)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/payments-integration-guide)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides)

Integration Guides

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-guide)

[Sending invoice and tracking code to the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking)

Sending invoice and tracking code to the marketplace

When integrating orders fulfilled by VTEX sellers, it is important to include tracking codes and invoice data. There are some requirements needed, before connectors can make sure that invoice and tracking code were sent to the marketplace:

* The tracking code and invoice information must be contained within the VTEX Order.
* Connectors should offer a secure endpoint to receive VTEX notification from our [Retrieve feed order status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/orders-api%23get-/api/orders/feed) endpoint updating tracking code and invoice data
* Tracking code and other data about the order’s delivery will only be made available to orders where the seller is in charge of delivery.

## Invoice notification from VTEX

The invoice sent by VTEX consists of a notification for the connector's URL, with the following structure:

`http://{{marketplaceServicesEndpoint}}/pub/orders/{{orderId}}/invoice`.

If the connector does not take that into account in their integration, they might receive an error 400 in VTEX's Send Invoice requests.

## Integrating tracking code and invoice data

The diagram below describes the notification flow, for integrating tracking code and invoice data:

Follow the steps below to integrate them, once receiving the notification. Make sure to review our [Recommendations](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-recommendations) page before you start.

![{"base64":"  ","img":{"width":5262,"height":1134,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":163337,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/external-marketplace-integration-invoice-tracking-0.jpg"}}](https://read.calvincode.net/reader?url=https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/external-marketplace-integration-invoice-tracking-0.jpg)

1. VTEX Orders receive tracking and/or invoice data. This information can be inserted via [Invoice notification from VTEX](#invoice-notification-from-vtex) or manually in VTEX Admin. After receiving invoice information, the order status is updated to invoiced in VTEX. In this case, it is not possible to cancel the order anymore.
2. VTEX OMS notifies the connector through the URL informed in the [Place Fulfillment Order API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/fulfillment/pvt/orders) by the connector through the property `marketplaceServicesEndpoint`, once the order is inserted in VTEX.
3. Connector collects information sent through the notification. a. To collect information about **invoice**, use the properties:
   * `invoiceNumber`: invoice’s ID code.
   * `invoiceUrl`: URL that leads to the invoice document.
   * `embeddedInvoice`: invoice document’s XML file.
   * `invoiceValue`: value declared in the invoice.
   * `invoiceKey`: invoice’s key. b. To collect information about **tracking code**, use the properties:
   * `courier`: carrier’s name.
   * `trackingNumber`: number used by the carrier to identify the delivery
   * `trackingUrl`: carrier’s URL used by clients to track the order’s delivery.
4. Connector transforms the information to the expected format in the marketplace.
5. Connector sends the information to the marketplace.
6. Marketplace validates and records information, and responds with a success or failure status.
7. Connector generates an [Order log](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-order-logs) for each situation.

Note that:

* An order can have more than one invoice with partial values
* The tracking code and/or invoice can be filled in at different moments. In this case it is important to understand the flow demanded by the marketplace for sending separate information.
* Not all fields listed are demanded by the marketplace. Keep in mind to check which ones are in fact mandatory and the correct moment to send them.

> Make sure that all steps are logged as either success or failure, to offer the operation's full traceability. Check out the [Order logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-order-logs) page to learn more

## API Reference

Use the endpoints described below to perform this step. It is important to note that when consuming this API, the connector must have a valid VTEX App Key and App Token.

![{"base64":"  ","img":{"width":5262,"height":3389,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":460342,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/external-marketplace-integration-invoice-tracking-1.jpg"}}](https://read.calvincode.net/reader?url=https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/external-marketplace-integration-invoice-tracking-1.jpg)

> All parameters in the endpoints below must be declared in the request. In case one of the parameters does not have a value, you must still send it as `null`.

### Shopping cart simulation

Use the request example below to perform the Shopping Cart Simulation. Check out our [Shopping cart Simulation](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/checkout-api%23post-/api/checkout/pub/orderForms/simulation) API Reference to know more details.

`1

{

2

"items":[

3

{...}

4

]

5

"ratesAndBenefitsData":{

6

"rateAndBenefitsIdentifiers":[]

7

"teaser":[]

8

}

9

"paymentData":{

10

"installmentOptions":[...]

11

"paymentSystems":[...]

12

"payments":[]

13

"giftCards":[]

14

"giftCardMessages":[]

15

"availableAccounts":[]

16

"availableTokens":[]

17

}

18

"selectableGifts":[]

19

"marketingData":NULL

20

"postalCode":NULL

21

"country":"BRA"

22

"logisticsInfo":[

23

{...}

24

]

25

"messages":[]

26

"purchaseConditions":{

27

"itemPurchaseConditions":[...]

28

}

29

"pickupPoints":[]

30

"subscriptionData":NULL

31

"totals":[

32

{...}

33

]

34

"itemMetadata":NULL

35

}

`

### Place fulfillment order

Use the request example below to place fulfillment order. Check out our [Place fulfillment order](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/fulfillment/pvt/orders) API Reference to know more details.

`1

[

2

 {

3

 "items": [

4

 {

5

 "id": "1",

6

 "price": 900,

7

 "quantity": 1,

8

 "seller": "1"

9

 }

10

 ],

11

 "isCreatedAsync": true,

12

 "marketplaceOrderGroup" : "794901324",

13

 "marketplaceOrderId": "2630580124",

14

 "marketplacePaymentValue": 1100,

15

 "marketplacePaymentReferenceValue": 1100,

16

 "marketplaceServicesEndpoint": "http://skyhubintegration.vtexinternal.com/api/skyhubintegration/commercialcondition?an=grocery1",

17

 "clientProfileData": {

18

 "CorporateDocument": null, //Cnpj

19

 "CorporateName": null, //nome da empresa

20

 "CorporatePhone": null, // ddd+telefone

21

 "Document": "14310315771", //cpf

22

 "DocumentType": null, //se pessoa fisica, colocar CPF, senão CNPJ

23

 "Email": "conta@dominio.com.br",

24

 "FirstName": "Nome",

25

 "IsCorporate": false, //caso pessoa juridica o valor deve ser true

26

 "LastName": "Sobrenome",

27

 "Phone": "41998718616",

28

 "StateInscription": null, //inscrição estadual

29

 "TradeName": null,

30

 "UserProfileId": null //utilizado somente com pedidos VTEX

31

 },

32

 "shippingData": {

33

 "address": {

34

 "addressId": "Casa",

35

 "addressType": "Residencial",

36

 "receiverName": "Marcelo",

37

 "city": "Curitiba",

38

 "complement": null,

39

 "country": "BRA",

40

 "geoCoordinates": [],

41

 "neighborhood": "Novo Mundo",

42

 "number": "4000",

43

 "postalCode": "81020230",

44

 "reference": null,

45

 "state": "PR",

46

 "street": "Rua Eduardo Carlos Pereira"

47

 },

48

 "logisticsInfo": [

49

 {

50

 "itemIndex": 0,

51

 "price": 200,

52

 "selectedDeliveryChannel":"delivery",

53

 "selectedSla": null,

54

 "lockTTL": "1d", //tempo para reserva do estoque do pedido

55

 "shippingEstimate":"1d" //tempo de entrega do pedido

56

 }

57

 ],

58

 "selectedAddresses":[

59

 {

60

 "addressType": "Residencial",

61

 "receiverName": "Henrique Vianna",

62

 "addressId": "2",

63

 "postalCode": "81020-235",

64

 "city": "Curitiba",

65

 "state": "PR",

66

 "country": "BRA",

67

 "street": "Rua Eduardo Carlos Pereira",

68

 "number": "4125",

69

 "neighborhood": "Portão",

70

 "complement": "",

71

 "reference": null,

72

 "geoCoordinates": [

73

 -49.2892059,

74

 -25.4826319

75

 ]

76

 }],

77

 "isFob": false //se entrega feita pelo lojista coloque false, senão true

78

 },

79

 "customData": {

80

 "customApps": [{

81

 "fields": {

82

 "orderIdMarketplace": "2630580148",

83

 "paymentIdMarketplace": "8191598627"

84

 },

85

 "id": "marketplace-integration",

86

 "major": 1

87

 }]

88

 },

89

 "openTextField": {

90

 "value": "{\"Phones\":[\"21998718616\"]}"

91

 }

92

 }

93

]

`

### Authorize dispatch

Use the request example below to authorize dispatch. Check out our [Authorize Dispatch](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/fulfillment/pvt/orders/-orderId-/fulfill)API Reference to know more details.

`1

[

2

 {

3

 "marketplaceOrderId": "956"

4

 }

5

]

`

Contributors

4

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F90937468%3Fv%3D4%26w=64%26q=75)](https://github.com/RuanUFSC)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F77292838%3Fv%3D4%26w=64%26q=75)](https://github.com/julia-rabello)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F7108339%3Fv%3D4%26w=64%26q=75)](https://github.com/brunoamui)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/external-marketplace-integration-guide/external-marketplace-integration-invoice-tracking.md)

[How to validate if items are available for delivery« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking//docs/guides/external-marketplace-integration-delivery-validation)[How to update a canceled order’s status in VTEXNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking//docs/guides/external-marketplace-integration-canceled-orders)

Contributors

4

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F90937468%3Fv%3D4%26w=64%26q=75)](https://github.com/RuanUFSC)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F77292838%3Fv%3D4%26w=64%26q=75)](https://github.com/julia-rabello)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F7108339%3Fv%3D4%26w=64%26q=75)](https://github.com/brunoamui)

ON THIS PAGE

[Invoice notification from VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23invoice-notification-from-vtex)

[Integrating tracking code and invoice data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23integrating-tracking-code-and-invoice-data)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23api-reference)

[Shopping cart simulation](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23shopping-cart-simulation)[Place fulfillment order](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23place-fulfillment-order)[Authorize dispatch](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23authorize-dispatch)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/external-marketplace-integration-guide/external-marketplace-integration-invoice-tracking.md)

Copy page

On this page

ON THIS PAGE

[Invoice notification from VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23invoice-notification-from-vtex)

[Integrating tracking code and invoice data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23integrating-tracking-code-and-invoice-data)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23api-reference)

[Shopping cart simulation](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23shopping-cart-simulation)[Place fulfillment order](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23place-fulfillment-order)[Authorize dispatch](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-invoice-tracking/docs/guides/external-marketplace-integration-invoice-tracking%23authorize-dispatch)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)