[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 collect orders 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-collect-orders/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/updates/release-notes)

Guides

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

---

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

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/docs/guides/erp-integration-guide)

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

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

[Marketplace / Seller architecture](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/docs/guides/external-marketplace-integration-app-template)

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

[Catalog logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/docs/guides/external-marketplace-integration-orders)

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

[New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/docs/guides/external-marketplace-integration-canceled-orders)

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

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

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

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

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

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

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

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

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

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

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

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

---

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

---

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

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/docs/guides/data-protection-plus)

---

Weni by VTEX

---

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

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

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

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

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

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

---

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

Guides

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

---

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

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/docs/guides/erp-integration-guide)

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

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

[Marketplace / Seller architecture](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/docs/guides/external-marketplace-integration-app-template)

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

[Catalog logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/docs/guides/external-marketplace-integration-orders)

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

[New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/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-collect-orders/docs/guides/external-marketplace-integration-canceled-orders)

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

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

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

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

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

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

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

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

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

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

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

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

---

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

---

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

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/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-collect-orders/docs/guides/data-protection-plus)

---

Weni by VTEX

---

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

Integration Guides

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

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

New Order Integration

> If you used our previous method for integrating orders, you can still find their documentation in [Order Logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/deprecated-order-logs) and [How to collect orders from sales channels](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/deprecated-how-to-collect-orders-from-sales-channels). The previous method, however, will not be maintained. If you are integrating orders for the first time, we recommend you use the instructions in this article.

## Authentication/authorization

When sending a request to our APIs, you must inform in the headers a X-VTEX-API-AppKey + X-VTEX-API-AppToken pair or a VtexIdclientAutCookie (the connector’s app token, if using our [App Template](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-app-template)) that has access to the specified account.

## API Reference: New order Integration

Use the request example below to Place an order. The description and requirement of each of the fields present in the request body are found in our [API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders).

It’s important to note that although some fields are optional in our API, depending on the order's country of origin or trade policy, they may be mandatory for Checkout/Fulfillment. In such cases, when trying to process the order, we will return the validation error in question to the connector, as well as other possible errors and success notifications.

`1

{

2

 "marketplaceOrderId": string,

3

 "connectorName": string,

4

 "connectorEndpoint": string,

5

 "marketplaceOrderStatus": string,

6

 "marketplacePaymentValue": int,

7

 "marketplaceInterestValue": int,

8

 "priceDivergenceAllowanceRate": decimal,

9

 "allowFranchises": bool,

10

 "pickupAccountName": string,

11

 "items": [

12

 {

13

 "id": string,

14

 "price": int,

15

 "quantity": int

16

 }

17

 ],

18

 "clientProfileData": {

19

 "email": string,

20

 "firstName": string,

21

 "lastName": string,

22

 "phone": string,

23

 "document": string,

24

 "corporateDocument": string,

25

 "corporatePhone": string,

26

 "corporateName": string,

27

 "tradeName": string,

28

 "stateInscription": string

29

 },

30

 "shippingData": {

31

 "logisticsInfo": [

32

 {

33

 "price": int,

34

 "selectedDeliveryChannel": string,

35

 "selectedSla": string,

36

 "lockTTL": string,

37

 "shippingEstimate": string,

38

 "deliveryIds": [

39

 {

40

 "warehouseId": string

41

 }

42

 ]

43

 }

44

 ],

45

 "selectedAddresses": [

46

 {

47

 "addressType": string,

48

 "addressId": string,

49

 "receiverName": string,

50

 "postalCode": string,

51

 "city": string,

52

 "state": string,

53

 "country": string,

54

 "street": string,

55

 "number": string,

56

 "neighborhood": string,

57

 "complement": string,

58

 "geoCoordinates": {

59

 "latitude": double,

60

 "longitude": double

61

 }

62

 }

63

 ],

64

 "isFob": bool,

65

 "isMarketplaceFulfillment": bool,

66

 "trackingHints": [

67

 {

68

 "trackingId": string,

69

 "courierName": string,

70

 "trackingUrl": string,

71

 "trackingLabel": string

72

 }

73

 ]

74

 },

75

 "invoiceData": {

76

 "userPaymentInfo": {

77

 "paymentMethods": string[]

78

 }

79

 },

80

 "customData": {

81

 "customApps": [

82

 {

83

 "id": string,

84

 "major": int,

85

 "fields": {

86

 string: string

87

 }

88

 }

89

 ]

90

 },

91

 "taxData": [

92

 {

93

 "skuId": string,

94

 "value": int

95

 }

96

 ],

97

 "openTextField": string

98

}

`

### Response Notifications

To receive notifications from our service, the connector must implement some API routes in the base endpoint informed in connectorEndpoint (be in the request or the App Template). Order Processing Result

Notifications with the orders processing result are sent through the following request: POST {connectorEndpoint}/order-integration/notification/processing-result?an={accountName}. The body is the same as described here.

#### Response Body

All API responses and order notifications from our service return the same data contract, as detailed bellow:

`1

{

2

 "accountName": string,

3

 "success": bool,

4

 "flow": string,

5

 "operationId": string,

6

 "marketplaceOrderId": string,

7

 "code": string,

8

 "message": string,

9

 "errors":

10

 [

11

 {

12

 "source": string,

13

 "code": string,

14

 "description": string

15

 }

16

 ],

17

 "fields": {

18

 "mainOrderId": string,

19

 "franchiseOrderId": string

20

 }

21

}

`

Some fields can return as null in some cases, such as accountName, marketplaceOrderId and operationId, for example.

#### Response Codes

| Code   | Description                                                                                |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SOI001 | The order was integrated into VTEX successfully                                                                                |
| SOI002 | The order was approved in VTEX successfully                                                                                |
| SOI003 | The order was successfully enqueued in our service for processing                                                                                |
| EOI000 | An unknown error occurred when processing the order, and in this case, the solution would be contacting VTEX for support                                                                                |
| EOI001 | An unmapped error occurred when processing the order, and more details about the error can be found in the response error list                                                                                |
| EOI002 | There are no SLAs or items available to fulfill this order. That is: the item(s) can be without stock, inactive in the catalog or not included in connector’s trade policy; the SLA/pickup point chosen in the order is not available or doesn’t have stock for the order’s items; or there aren’t any SLAs available at all to fulfill the order |
| EOI003 | The order total payment value differs from what is expected by the seller, and they do not have Order Authorization rules set up to deal with price divergence                                                                                |
| EOI004 | This order's cart is invalid. That can mean that either the item(s) in it don’t exist in VTEX catalog or the order's data doesn’t comply with the store configuration (for example, the minimum total value or quantity of items set by the seller was not reached in the order)                                                                  |
| EOI005 | A validation error occurred while trying to process the order. That is, some field/value sent in the order’s contract is invalid and not filled according to our’s or Checkout/Fulfillment’s documentation                                                                                |
| EOI006 | An unexpected error occurred in one of VTEX's internal services. Please try to send the request again later, as it’s possible one of our services is going through instabilities                                                                                |
| EOI007 | The order specified already exists in VTEX and we are not able to create duplicated orders                                                                                |
| EOI008 | The order cannot be approved because it’s not integrated in VTEX yet                                                                                |
| EOI009 | This order is out of the valid status to approve, such as canceled, for example                                                                                |
| EOI010 | The request to our API timed out, meaning we exceeded the response time limit                                                                                |
| EOI011 | The order was integrated with a price divergence, and we cannot approve it yet because we are waiting for the seller's manual authorization before proceeding                                                                                |

#### Order Notification Results

* Error
   * EOI000 - Unknown error
   * EOI001 - Unmapped error
   * EOI002 - SLA not available
   * EOI003 - Price divergence
   * EOI004 - Invalid cart
   * EOI005 - Validation error
   * EOI006 - VTEX unexpected error
   * EOI007 - Duplicated order
* Success
   * SOI001 - Order integrated

## Scenario 1: new order, with pending payment

To integrate orders with pending payment, you just need to set the marketplaceOrderStatus field to NEW in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) request.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "a1a0e124-6cfc-404e-a8c5-95f5a494dc86",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 2: Approved order, with approved payment

To integrate orders with approved payment (automatically approving them afterwards) you just need to set the `marketplaceOrderStatus` field to `approved` in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

**Integration:**

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "8cd93fe7-db90-4e1b-b55f-890a61e72bad",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

**Approval:**

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI002",

5

 "flow": "ApproveOrder",

6

 "success": true,

7

 "operationId": "8cd93fe7-db90-4e1b-b55f-890a61e72bad",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order approved successfully"

14

}

`

## Scenario 3: order with interest

To integrate orders with additional interest values, you need to fill in the marketplaceInterestValue field, with the desired amount in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "7425f2ef-0849-4b73-94c7-355982119e51",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 4: Order with discounts

To integrate orders with discounts, you need to apply the discount directly in the order in the[New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request, before sending it to our service. This means:

* If shipping costs $10 for a SKU, but the marketplace is offering a 10% discount on it, the `price` in `logisticsInfo` should be $9 (in integer format, 900).
* If the SKU is priced at $100, and the marketplace is offering a 10% discount on it, the `price` of the SKU in `items` should be $90 (in integer format, 9000).
* And when the marketplace is offering a discount applied to all shipping or all SKUs in the order, this value should be split between the items, for example:
   * SKU 1 price: $10, SKU 2 price: $40\. Marketplace discount: $10\. SKU 1 final `price` in `items` should be $5 (in integer format, 500) and SKU 2 final `price` should be $35 (in integer format, 3500).

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "9e396ae7-1e76-4915-b1ba-adb860e177bd",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 5: Order delivered by the seller

To input an order delivered by the seller, you must do the following in the[New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request:

* Fill the `selectedDeliveryChannel` field with the value `delivery`.
* Fill the `selectedSla` field with the name of the seller’s SLA selected to deliver this order. In this case, this field can also be left empty, and Fulfillment’s service will choose an available SLA automatically, if there’s any.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "grocery1",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "e30cf30c-7b89-4a04-aa20-eb3d116e2ac7",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 6: Order delivered by seller’s franchise (Multilevel Omnichannel Inventory)

To input an order delivered by a seller’s franchise, to allow the Multilevel Omnichannel Inventory feature, in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request, you must do the following:

* Fill the `selectedDeliveryChannel` field with the value `delivery`;
* Fill the `selectedSla` field with the name of the seller’s SLA selected to deliver this order;
* Set the `allowFranchises` field to `true`.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "e1d447aa-c885-4b03-97c4-ddf20090a3c3",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789-01",

11

 "franchiseOrderId": "MKT-MKP-123456789-01"

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 7: Order delivered by the marketplace (with stock in the seller)

To input an order delivered by the marketplace with the stock in the seller, in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request, you must do the following:

* Fill the `selectedDeliveryChannel` field with the value `delivery`.
* Don’t fill the `selectedSla` field.
* Set the `isFob` field to `true`.
* Set the `isMarketplaceFulfillment` to false.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "94c3242a-74b9-4261-9820-8e26bb73dbbd",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 8: Order delivered by the marketplace (with stock in the marketplace)

To input an order delivered by and with the stock in the marketplace, in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request, you must do the following:

* Fill the `selectedDeliveryChannel` field with the value `delivery`;
* Don’t fill the `selectedSla` field;
* Set the `isFob` field to `true`;
* Set the `isMarketplaceFulfillment` to `true`;
* Fill the `warehouseId` within the `deliveryIds` field with the id of the warehouse set by the seller to handle orders from the marketplace.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "grocery1",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "42ca5760-e229-49b1-a731-73bebd0c48a0",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 9: Order with pickup-in-point

To input a pickup-in-point order, where the customer’ll be responsible for retrieving the products in a specified store, you must do the following in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request:

* Fill the `selectedDeliveryChannel` field with the value `pickup-in-point`.
* Fill the `selectedAddresses` list with the pickup point address, instead of the customers’s, specifying:
   * In the `addressType` field the value `pickup`.
   * In the `addressId` field the pickup point’s ID in VTEX’s logistics system.
* Fill the `geoCoordinates` field with the geo coordinates from the pickup address.
* The `isFob` field cannot be set to `true` if the order’s delivery type is pickup-in-point.
* The `selectedSla` should be left empty for `pickup-in-point` orders as well.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "b830df0e-3377-4b44-9601-85ecfd848b41",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 10: Order with a franchise pickup-in-point (Multilevel Omnichannel Inventory)

To input a franchise pickup-in-point order, where the customer’ll be responsible for retrieving the products in a specified seller’s franchise store, you must do the following in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request:

* Fill the `selectedDeliveryChannel` field with the value `pickup-in-point`.
* Fill the `selectedAddresses` list with the pickup point address, instead of the customers’s, specifying:
   * In the `addressType` field the value `pickup`.
   * In the `addressId` field the pickup point’s ID in VTEX’s logistics system.
* Set the `allowFranchises` field to `true`.
* Fill the `pickupAccountName` field, indicating from which account name the pickup point selected in the order is from, even if it’s from the main account.
* Fill the `geoCoordinates` field with the geo coordinates from the pickup address.
* The `isFob` field cannot be set to true if the order’s delivery type is pickup-in-point.
* The `selectedSla` should be left empty for `pickup-in-point` orders as well.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "c1f00956-801c-4ab5-b343-b05c1d33863e",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789-01",

11

 "franchiseOrderId": "MKT-MKP-123456789-01"

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 11: Order with taxes

To integrate orders with additional taxes values, in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request, you need to fill in the taxData field, a list containing all taxes, one per SKU. If you don’t have the value individually by SKU, you can add only one item in the list, using one SKU ID from the order and adding all the taxes in field value.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "7425f2ef-0849-4b73-94c7-355982119e51",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

## Scenario 12: Order with tracking hints

To integrate orders with label information, in the [New Order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders%23post-/api/order-integration/orders) API request, you need to fill in the trackingHints field, a list containing all infos related to order label.

### Response

`1

{

2

 "marketplaceOrderId": null,

3

 "accountName": "connections",

4

 "code": "SOI003",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": null,

8

 "errors": null,

9

 "fields": null,

10

 "message": "Order successfully enqueued"

11

}

`

### Notification

`1

{

2

 "marketplaceOrderId": "123456789",

3

 "accountName": "connections",

4

 "code": "SOI001",

5

 "flow": "PlaceOrder",

6

 "success": true,

7

 "operationId": "7425f2ef-0849-4b73-94c7-355982119e51",

8

 "errors": null,

9

 "fields": {

10

 "mainOrderId": "MKP-123456789",

11

 "franchiseOrderId": null

12

 },

13

 "message": "Order integrated successfully"

14

}

`

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/_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-collect-orders/_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-collect-orders.md)

[Recommendations« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders//docs/guides/external-marketplace-integration-recommendations)[Update Order StatusNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders//docs/guides/external-marketplace-update-order-status)

Contributors

2

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

ON THIS PAGE

[Authentication/authorization](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23authenticationauthorization)

[API Reference: New order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23api-reference-new-order-integration)

[Response Notifications](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response-notifications)

[Scenario 1: new order, with pending payment](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-1-new-order-with-pending-payment)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 2: Approved order, with approved payment](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-2-approved-order-with-approved-payment)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 3: order with interest](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-3-order-with-interest)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 4: Order with discounts](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-4-order-with-discounts)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 5: Order delivered by the seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-5-order-delivered-by-the-seller)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 6: Order delivered by seller’s franchise (Multilevel Omnichannel Inventory)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-6-order-delivered-by-sellers-franchise-multilevel-omnichannel-inventory)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 7: Order delivered by the marketplace (with stock in the seller)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-7-order-delivered-by-the-marketplace-with-stock-in-the-seller)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 8: Order delivered by the marketplace (with stock in the marketplace)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-8-order-delivered-by-the-marketplace-with-stock-in-the-marketplace)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 9: Order with pickup-in-point](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-9-order-with-pickup-in-point)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 10: Order with a franchise pickup-in-point (Multilevel Omnichannel Inventory)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-10-order-with-a-franchise-pickup-in-point-multilevel-omnichannel-inventory)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 11: Order with taxes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-11-order-with-taxes)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 12: Order with tracking hints](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-12-order-with-tracking-hints)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

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-collect-orders.md)

Copy page

On this page

ON THIS PAGE

[Authentication/authorization](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23authenticationauthorization)

[API Reference: New order Integration](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23api-reference-new-order-integration)

[Response Notifications](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response-notifications)

[Scenario 1: new order, with pending payment](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-1-new-order-with-pending-payment)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 2: Approved order, with approved payment](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-2-approved-order-with-approved-payment)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 3: order with interest](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-3-order-with-interest)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 4: Order with discounts](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-4-order-with-discounts)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 5: Order delivered by the seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-5-order-delivered-by-the-seller)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 6: Order delivered by seller’s franchise (Multilevel Omnichannel Inventory)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-6-order-delivered-by-sellers-franchise-multilevel-omnichannel-inventory)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 7: Order delivered by the marketplace (with stock in the seller)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-7-order-delivered-by-the-marketplace-with-stock-in-the-seller)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 8: Order delivered by the marketplace (with stock in the marketplace)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-8-order-delivered-by-the-marketplace-with-stock-in-the-marketplace)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 9: Order with pickup-in-point](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-9-order-with-pickup-in-point)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 10: Order with a franchise pickup-in-point (Multilevel Omnichannel Inventory)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-10-order-with-a-franchise-pickup-in-point-multilevel-omnichannel-inventory)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 11: Order with taxes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-11-order-with-taxes)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

[Scenario 12: Order with tracking hints](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23scenario-12-order-with-tracking-hints)

[Response](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23response)[Notification](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/external-marketplace-integration-collect-orders/docs/guides/external-marketplace-integration-collect-orders%23notification)

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 scheduling prices for a range of hours 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/scheduling-prices-for-a-range-of-hours/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/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/scheduling-prices-for-a-range-of-hours/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/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/scheduling-prices-for-a-range-of-hours/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/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/scheduling-prices-for-a-range-of-hours/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/getting-started)

---

Integration Guides

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

[Scheduling prices for a range of hours](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/scheduling-prices-for-a-range-of-hours)

[Contextual price per shopper](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/contextual-price-per-shopper)

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/getting-started)

---

Integration Guides

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

[Scheduling prices for a range of hours](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/scheduling-prices-for-a-range-of-hours)

[Contextual price per shopper](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/contextual-price-per-shopper)

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides)

Pricing

[Scheduling prices for a range of hours](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/scheduling-prices-for-a-range-of-hours)

Scheduling prices for a range of hours

One of the most important actions in massive events such as Black Friday is establishing prices during a limited period of time. Scheduling a price for a specific time range allows you to temporarily optimize a product’s profitability during promotional actions and switch back to the regular price automatically given an end date.

This is possible using [Pricing API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/pricing-api%23overview), more specifically by making a request to `PUT` [Create or Update Base Price or Fixed Prices](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/reference/createupdatepriceorfixedprice).

In the request body, you should include the `fixedPrices` object containing a `dateRange` object, with `from` and `to` properties. Make sure to check out the [request body example](#request-body-example) and include all properties as specified in the `PUT` [Create or Update Base Price or Fixed Prices](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-rest-api/reference/createupdatepriceorfixedprice) documentation.

By default, dates are in Coordinated Universal Time (UTC) and they must follow the [RFC3339](https://read.calvincode.net/reader?url=https://www.ietf.org/rfc/rfc3339.txt) format. Example: `"2017-06-23T03:00:00Z"`.

> In case a price is changed through the VTEX Admin, the scheduled hour will be lost and only the date will be considered.

## Request body example

`1

{

2

 "markup": 30,

3

 "basePrice": 100,

4

 "listPrice": 35,

5

 "fixedPrices": [

6

 {

7

 "tradePolicyId": "1",

8

 "value": 31,

9

 "listPrice": 32,

10

 "minQuantity": 1,

11

 "dateRange": {

12

 "from": "2022-05-21T22:00:00Z",

13

 "to": "2022-05-21T23:00:00Z"

14

 }

15

 },

16

 {

17

 "tradePolicyId": "1",

18

 "value": 31.5,

19

 "listPrice": 33,

20

 "minQuantity": 2

21

 }

22

 ]

23

}

`

Contributors

1

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

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/Pricing/scheduling-prices-for-a-range-of-hours.md)

[Including order variables in the transactional email template« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours//docs/guides/including-order-variables-in-the-transactional-email-template)[Contextual price per shopperNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours//docs/guides/contextual-price-per-shopper)

Contributors

1

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

ON THIS PAGE

[Request body example](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/scheduling-prices-for-a-range-of-hours%23request-body-example)

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/Pricing/scheduling-prices-for-a-range-of-hours.md)

Copy page

On this page

ON THIS PAGE

[Request body example](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/scheduling-prices-for-a-range-of-hours/docs/guides/scheduling-prices-for-a-range-of-hours%23request-body-example)

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] How do I use the VTEX product summary 2.91.0 ProductSummaryPrice app? Provide documentation and configuration details.

[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/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides)

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

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

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

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

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/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/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/updates/release-notes)

VTEX IO Apps

[Basic components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/basic-components)

---

[Store Components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/store-components)

---

[Advanced components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/advanced-components)

---

[B2B components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/b2b-components)

---

[B2B Suite](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/apps/vtex.b2b-suite)

---

[Functional Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/functional-apps)

---

[Layout Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/layout-apps)

---

[Pixel Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/pixel-apps)

---

[My Account - StoreV2 version](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/apps/vtex.my-account)

---

[VTEX IO deprecated apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/vtex-io-deprecated-apps)

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/storefront-development)

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

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/updates/release-notes)

VTEX IO Apps

[Basic components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/basic-components)

---

[Store Components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/store-components)

---

[Advanced components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/advanced-components)

---

[B2B components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/b2b-components)

---

[B2B Suite](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/apps/vtex.b2b-suite)

---

[Functional Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/functional-apps)

---

[Layout Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/layout-apps)

---

[Pixel Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/pixel-apps)

---

[My Account - StoreV2 version](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/apps/vtex.my-account)

---

[VTEX IO deprecated apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/guides/vtex-io-deprecated-apps)

---

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

Product Summary Price

[vtex.product-summary](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary)

Version: 2.91.0

Latest version: 2.91.0

![{"base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAABCAIAAAB2XpiaAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAFUlEQVR4nGNoYGD6v3v+/6ask37WACanBhm9KoMJAAAAAElFTkSuQmCC","img":{"src":"https://img.shields.io/badge/-Deprecated-red","width":73,"height":20,"type":"svg"}}](https://read.calvincode.net/reader?url=https://img.shields.io/badge/-Deprecated-red)

> **The Product Summary Price block has been deprecated in favor of the [Product Price](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-developer-docs/docs/vtex-product-price) app**. Although support for this block is still available, we strongly recommend that you update your store theme with the Product Price app to stay up with the component's evolution.

`ProductSummaryPrice` is a block exported by the [Product Summary app](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-developer-docs/docs/vtex-product-summary) responsible for rendering the product's price.

![{"base64":"  ","img":{"width":1883,"height":773,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":377933,"url":"https://user-images.githubusercontent.com/67270558/156375295-9fc9b1b8-2534-4a12-ac59-4db52b763bf7.png"}}](https://read.calvincode.net/reader?url=https://user-images.githubusercontent.com/67270558/156375295-9fc9b1b8-2534-4a12-ac59-4db52b763bf7.png)

### Configuration

1. Import the `vtex.product-summary` app to your theme's dependencies in the `manifest.json`:

`1

 dependencies: {

2

 "vtex.product-summary": "2.x"

3

 }

`

1. Add the `product-summary-price` block to your store theme as a child of the `product-summary.shelf` block. For example:

`1

 "product-summary.shelf": {

2

 "children": [

3

 "product-summary-image",

4

 "product-summary-name",

5

+ "product-summary-price",

6

 "product-summary-attachment-list",

7

 "product-summary-space",

8

 "product-summary-column#1"

9

 ]

10

 },

`

1. Then, declare the `product-summary-price` and configure its behavior using the props stated below.

| Prop name             | Type    | Description                                                                     | Default value |
| --------------------- | ------- | ------------------------------------------------------------------------------- | ------------- |
| showListPrice         | Boolean | Shows the product list price                                                    | true          |
| showInstallments      | Boolean | Set installments' visibility                                                    | true          |
| showDiscountValue     | Boolean | Set discount value's visibility                                                 | false         |
| showLabels            | Boolean | Set pricing labels' visibility                                                  | true          |
| labelSellingPrice     | String  | Text of selling price's label                                                   |               |
| labelListPrice        | String  | Text of list price's label                                                      |               |
| showBorders           | Boolean | Set product's borders visibility                                                | false         |
| showListPriceRange    | Boolean | Set if you want to see list price as range (lowest - highest) when available    | false         |
| showSellingPriceRange | Boolean | Set if you want to see selling price as range (lowest - highest) when available | false         |

## Customization

To apply CSS customizations in this and other blocks, follow the [Using CSS Handles for store customization](https://read.calvincode.net/reader?url=https://developers.vtex.com/vtex-developer-docs/docs/vtex-io-documentation-using-css-handles-for-store-customization) guide.

| CSS Handles           |
| --------------------- |
| priceContainer        |
| productPriceClass     |
| listPriceContainer    |
| listPriceLabel        |
| listPrice             |
| sellingPriceContainer |
| sellingPriceLabel     |
| sellingPrice          |
| savingsContainer      |
| savings               |
| interestRate          |
| installmentContainer  |
| listPriceRange        |
| sellingPriceRange     |
| priceLoading          |

See also

[Vtex.product SummaryVTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/apps/vtex.product-summary)[VTEX App StoreVTEX IO Apps](https://read.calvincode.net/reader?url=https://apps.vtex.com/)

ON THIS PAGE

[Customization](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice/docs/apps/vtex.product-summary@2.91.0/ProductSummaryPrice%23customization)

Was this helpful?

[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=)