VTEX · Schema

Request

CommerceE-CommerceRetailMarketplacePayments

Properties

Name Type Description
requestId string Unique code that identifies an order change.
workflowId string Code that identifies the transaction of changing the orders in the [order flow](https://help.vtex.com/en/tutorial/order-flow-and-status--tutorials_196).
reason string Reason that motivated the order change.
manualDiscountValue integer This field shows if it was applied a manual price for the total order amount. The value is in cents.
manualIncrementValue integer This field shows if an increment value was applied to the total order amount. The value is in cents.
totalChangeValue integer This field shows how much the order total price is, considering that price changes might have been made. The value is in cents.
totals array Array containing information about change prices per item.
add object Information about an `add` operation, when there was one. It will have the same schema of `request.replace.to`.
remove object Information about a `remove` operation, when there was one. It will have the same schema of `request.replace.from`.
replace array Array with information about the replacement operation performed.
date string Date and time of the request. The value is in UTC ISO 8601 format `yyyy-mm-ddThh:mm:ss.sssZ`.
origin object
settings object
View JSON Schema on GitHub

JSON Schema

vtex-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Request",
  "title": "Request",
  "required": [
    "requestId",
    "workflowId",
    "reason",
    "manualDiscountValue",
    "manualIncrementValue",
    "totalChangeValue",
    "totals",
    "add",
    "remove",
    "replace",
    "date",
    "origin",
    "settings"
  ],
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Unique code that identifies an order change.",
      "example": "e8532a32-7f7e-434a-88ec-29609f0ede46"
    },
    "workflowId": {
      "type": "string",
      "description": "Code that identifies the transaction of changing the orders in the [order flow](https://help.vtex.com/en/tutorial/order-flow-and-status--tutorials_196).",
      "example": "74f40e7a-68c6-4699-b874-a8a297fb3f6a"
    },
    "reason": {
      "type": "string",
      "description": "Reason that motivated the order change.",
      "example": "The client wants to change the items weight."
    },
    "manualDiscountValue": {
      "type": "integer",
      "description": "This field shows if it was applied a manual price for the total order amount. The value is in cents.",
      "example": 0
    },
    "manualIncrementValue": {
      "type": "integer",
      "description": "This field shows if an increment value was applied to the total order amount. The value is in cents.",
      "example": 0
    },
    "totalChangeValue": {
      "type": "integer",
      "description": "This field shows how much the order total price is, considering that price changes might have been made. The value is in cents.",
      "example": 0
    },
    "totals": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array containing information about change prices per item."
    },
    "add": {
      "type": "object",
      "nullable": true,
      "description": "Information about an `add` operation, when there was one. It will have the same schema of `request.replace.to`.",
      "example": null
    },
    "remove": {
      "type": "object",
      "nullable": true,
      "description": "Information about a `remove` operation, when there was one. It will have the same schema of `request.replace.from`.",
      "example": null
    },
    "replace": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Replace2"
      },
      "description": "Array with information about the replacement operation performed."
    },
    "date": {
      "type": "string",
      "description": "Date and time of the request. The value is in UTC ISO 8601 format `yyyy-mm-ddThh:mm:ss.sssZ`.",
      "example": "2023-07-27T17:52:18.6483116Z"
    },
    "origin": {
      "$ref": "#/components/schemas/OriginV2"
    },
    "settings": {
      "$ref": "#/components/schemas/Settings"
    }
  },
  "example": {
    "requestId": "e8532a32-7f7e-434a-88ec-29609f0ede46",
    "workflowId": "74f40e7a-68c6-4699-b874-a8a297fb3f6a",
    "reason": "The client did not like the size.",
    "manualDiscountValue": 0,
    "manualIncrementValue": 0,
    "totalChangeValue": 0,
    "totals": [],
    "add": null,
    "remove": null,
    "replace": [
      {
        "from": {
          "paymentData": {
            "transactions": []
          },
          "items": [
            {
              "id": "31",
              "quantity": 1,
              "price": 5000,
              "measurementUnit": "un",
              "unitMultiplier": 1,
              "sellingPrice": 5000,
              "name": "Fusca miniatura Fusca preto",
              "detailUrl": "/fusca-miniatura-24/p",
              "imageUrl": "http://qastore.vteximg.com.br/arquivos/ids/155431-55-55/image-bdab69af1e5c41cdbc498d02e370b376.jpg?v=636579391945870000"
            }
          ],
          "shippingData": {
            "logisticsInfo": [
              {
                "itemIndex": 0,
                "selectedSla": "Lenta",
                "selectedDeliveryChannel": "delivery",
                "addressId": "9ec276fd3a604eb1aa151b5333ca5db6",
                "slas": [
                  {
                    "id": "Lenta",
                    "deliveryChannel": "delivery",
                    "name": "Lenta",
                    "deliveryIds": [
                      {
                        "courierId": "1c083bf",
                        "warehouseId": "1_1",
                        "dockId": "1",
                        "courierName": "Donkey",
                        "quantity": 1,
                        "kitItemDetails": [],
                        "accountCarrierName": null
                      }
                    ],
                    "shippingEstimate": "25bd",
                    "shippingEstimateDate": "2023-08-30T10:17:24.6436519Z",
                    "lockTTL": "12d",
                    "availableDeliveryWindows": [],
                    "deliveryWindow": null,
                    "price": 180,
                    "listPrice": 180,
                    "tax": 0,
                    "pickupStoreInfo": {
                      "isPickupStore": false,
                      "friendlyName": null,
                      "address": null,
                      "additionalInfo": null,
                      "dockId": null
                    },
                    "pickupPointId": null,
                    "pickupDistance": null,
                    "polygonName": "",
                    "transitTime": "25bd"
                  },
                  {
                    "id": "Normal",
                    "deliveryChannel": "delivery",
                    "name": "Normal",
                    "deliveryIds": [
                      {
                        "courierId": "1",
                        "warehouseId": "1_1",
                        "dockId": "1",
                        "courierName": "Transportadora",
                        "quantity": 1,
                        "kitItemDetails": [],
                        "accountCarrierName": null
                      }
                    ],
                    "shippingEstimate": "3bd",
                    "shippingEstimateDate": null,
                    "lockTTL": "12d",
                    "availableDeliveryWindows": [],
                    "deliveryWindow": null,
                    "price": 500,
                    "listPrice": 500,
                    "tax": 0,
                    "pickupStoreInfo": {
                      "isPickupStore": false,
                      "friendlyName": null,
                      "address": null,
                      "additionalInfo": null,
                      "dockId": null
                    },
                    "pickupPointId": null,
                    "pickupDistance": null,
                    "polygonName": "",
                    "transitTime": "3bd"
                  },
                  {
                    "id": "Pickup",
                    "deliveryChannel": "delivery",
                    "name": "Pickup",
                    "deliveryIds": [
                      {
                        "courierId": "ech018654",
                        "warehouseId": "1_1",
                        "dockId": "1",
                        "courierName": "Retirada",
                        "quantity": 1,
                        "kitItemDetails": [],
                        "accountCarrierName": null
                      }
                    ],
                    "shippingEstimate": "25bd",
                    "shippingEstimateDate": null,
                    "lockTTL": "12d",
                    "availableDeliveryWindows": [],
                    "deliveryWindow": null,
                    "price": 700,
                    "listPrice": 700,
                    "tax": 0,
                    "pickupStoreInfo": {
                      "isPickupStore": false,
                      "friendlyName": null,
                      "address": null,
                      "additionalInfo": null,
                      "dockId": null
                    },
                    "pickupPointId": null,
                    "pickupDistance": null,
                    "polygonName": "",
                    "transitTime": "25bd"
                  }
                ],
                "shipsTo": [
                  "BRA"
                ],
                "itemId": "31",
                "deliveryChannels": [
                  {
                    "id": "delivery"
                  }
                ],
                "price": 180,
                "listPrice": 180,
                "shippingEstimate": "25bd",
                "dockEstimate": null,
                "shippingEstimateDate": "2023-08-30T10:17:24.6436519Z",
                "lockTTL": "12d",
                "deliveryCompany": null,
                "polygonName": "",
                "transitTime": "25bd",
                "sellingPrice": 180,
                "deliveryIds": [
                  {
                    "courierId": "1c083bf",
                    "warehouseId": "1_1",
                    "dockId": "1",
                    "courierName": "Donkey",
                    "quantity": 1,
                    "kitItemDetails": null,
                    "accountCarrierName": "qastoreecho"
                  }
                ],
                "deliveryWindow": null,
                "pickupPointId": null,
                "pickupStoreInfo": {
                  "isPickupStore": false,
                  "friendlyName": null,
                  "address": null,
                  "additionalInfo": null,
                  "dockId": null
                },
                "pickupDistance": null
              }
            ]
          }
        },
        "to": {
          "items": [
            {
              "uniqueId": "40E763F4378E4F40AD1FE915FE1078E1",
              "id": "1",
              "productId": "1",
              "productRefId": "",
              "refId": "codrefxicaraazul",
              "ean": "8745121641",
              "name": "x\u00edcara azul",
              "skuName": "azul",
              "modalType": null,
              "parentItemIndex": null,
              "parentAssemblyBinding": null,
              "assemblies": [],
              "priceValidUntil": null,
              "tax": 0,
              "price": 5000,
              "listPrice": null,
              "manualPrice": null,
              "manualPriceAppliedBy": null,
              "sellingPrice": 5000,
              "rewardValue": 0,
              "isGift": false,
              "additionalInfo": {
                "dimension": null,
                "brandName": null,
                "brandId": null,
                "offeringInfo": null,
                "offeringType": null,
                "offeringTypeId": null,
                "categoriesIds": null,
                "productClusterId": null,
                "commercialConditionId": null
              },
              "preSaleDate": null,
              "productCategoryIds": "/1/",
              "productCategories": {
                "1": "Category"
              },
              "quantity": 1,
              "seller": "1",
              "sellerChain": [
                "1"
              ],
              "imageUrl": "http://qastore.vteximg.com.br/arquivos/ids/155394-55-55/xicara.jpg?v=636565506415770000",
              "detailUrl": "/xicara/p",
              "components": [],
              "bundleItems": [],
              "attachments": [],
              "attachmentOfferings": [],
              "offerings": [],
              "priceTags": [],
              "availability": null,
              "measurementUnit": "un",
              "unitMultiplier": 1,
              "manufacturerCode": null,
              "priceDefinition": {
                "calculatedSellingPrice": 5000,
                "total": 5000,
                "sellingPrices": [
                  {
                    "value": 5000,
                    "quantity": 1
                  }
                ]
              }
            }
          ],
          "paymentData": {
            "transactions": []
          },
          "receiptData": null,
          "shippingData": {
            "logisticsInfo": [
              {
                "itemIndex": 0,
                "selectedSla": "Lenta",
                "selectedDeliveryChannel": "delivery",
                "addressId": "9ec276fd3a604eb1aa151b5333ca5db6",
                "slas": [
                  {
                    "id": "Lenta",
                    "deliveryChannel": "delivery",
                    "name": "Lenta",
                    "deliveryIds": [
                      {
                        "courierId": "1c083bf",
                        "warehouseId": "1_1",
                        "dockId": "1",
                        "courierName": "Donkey",
                        "quantity": 1,
                        "kitItemDetails": [],
                        "accountCarrierName": null
                      }
                    ],
                    "shippingEstimate": "25bd",
                    "shippingEstimateDate": "2023-08-30T10:17:24.6436519Z",
                    "lockTTL": "12d",
                    "availableDeliveryWindows": [],
                    "deliveryWindow": null,
                    "price": 600,
                    "listPrice": 180,
                    "tax": 0,
                    "pickupStoreInfo": {
                      "isPickupStore": false,
                      "friendlyName": null,
                      "address": null,
                      "additionalInfo": null,
                      "dockId": null
                    },
                    "pickupPointId": null,
                    "pickupDistance": null,
                    "polygonName": "",
                    "transitTime": "25bd"
                  },
                  {
                    "id": "Normal",
                    "deliveryChannel": "delivery",
                    "name": "Normal",
                    "deliveryIds": [
                      {
                        "courierId": "1",
                        "warehouseId": "1_1",
                        "dockId": "1",
                        "courierName": "Transportadora",
                        "quantity": 1,
                        "kitItemDetails": [],
                        "accountCarrierName": null
                      }
                    ],
                    "shippingEstimate": "3bd",
                    "shippingEstimateDate": null,
                    "lockTTL": "12d",
                    "availableDeliveryWindows": [],
                    "deliveryWindow": null,
                    "price": 500,
                    "listPrice": 500,
                    "tax": 0,
                    "pickupStoreInfo": {
                      "isPickupStore": false,
                      "friendlyName": null,
                      "address": null,
                      "additionalInfo": null,
                      "dockId": null
                    },
                    "pickupPointId": null,
                    "pickupDistance": null,
                    "polygonName": "",
                    "transitTime": "3bd"
                  },
                  {
                    "id": "Pickup",
                    "deliveryChannel": "delivery",
                    "name": "Pickup",
                    "deliveryIds": [
                      {
                        "courierId": "ech018654",
                        "warehouseId": "1_1",
                        "dockId": "1",
                        "courierName": "Retirada",
                        "quantity": 1,
                        "kitItemDetails": [],
                        "accountCarrierName": null
                      }
                    ],
                    "shippingEstimate": "25bd",
                    "shippingEstimateDate": null,
                    "lockTTL": "12d",
                    "availableDeliveryWindows": [],
                    "deliveryWindow": null,
                    "price": 700,
                    "listPrice": 700,
                    "tax": 0,
                    "pickupStoreInfo": {
                      "isPickupStore": false,
                      "friendlyName": null,
                      "address": null,
                      "additionalInfo": null,
                      "dockId": null
                    },
                    "pickupPointId": null,
                    "pickupDistance": null,
                    "polygonName": "",
                    "transitTime": "25bd"
                  }
                ],
                "shipsTo": [
                  "BRA"
                ],
                "itemId": "1",
                "deliveryChannels": [
                  {
                    "id": "delivery"
                  }
                ],
                "price": 600,
                "listPrice": 180,
                "shippingEstimate": "25bd",
                "dockEstimate": null,
                "shippingEstimateDate": "2023-08-30T10:17:24.6436519Z",
                "lockTTL": "12d",
                "deliveryCompany": null,
                "polygonName": "",
                "transitTime": "25bd",
                "sellingPrice": 600,
                "deliveryIds": [
                  {
                    "courierId": "1c083bf",
                    "warehouseId": "1_1",
                    "dockId": "1",
                    "courierName": "Donkey",
                    "quantity": 1,
                    "kitItemDetails": null,
                    "accountCarrierName": "qastoreecho"
                  }
                ],
                "deliveryWindow": null,
                "pickupPointId": null,
                "pickupStoreInfo": {
                  "isPickupStore": false,
                  "friendlyName": null,
                  "address": null,
                  "additionalInfo": null,
                  "dockId": null
                },
                "pickupDistance": null
              }
            ]
          }
        }
      }
    ],
    "date": "2023-07-27T17:52:18.6483116Z",
    "origin": {
      "account": "qastore",
      "orderId": "v12772213qst-02",
      "component": "MarketplaceComponent"
    },
    "settings": {
      "customPaymentSystemsAllowed": []
    }
  }
}