VTEX · Schema

Data

CommerceE-CommerceRetailMarketplacePayments

Properties

Name Type Description
id string Service ID.
orderId string Order ID.
carrierId string Carrier ID.
serviceId string Service ID.
carrierName string Carrier name.
seller string Identifier representing the seller associated with the order.
status string Order [status](https://help.vtex.com/en/tutorial/order-flow-and-status--tutorials_196).
type string Order's type of delivery, `Delivery` or [`Pickup`](https://help.vtex.com/en/tutorial/pickup-points--2fljn6wLjn8M4lJHA6HP3R).
tags array Array of tags.
labels array Array containing information about all shipping labels printed in the order.
evidences array Array with additional notes when an incident occurs in the delivery of the package.
packages array Array containing information about all order's packages.
timeline array Array containing information about the timeline of order changes.
notes array Array with services information.
timezone object
carrierLogo string Carrier logo.
trackingUrl string Tracking URL.
comments string Comments.
paymentMethod string Payment method.
carrierServiceType string Carrier service type. The `carrierServiceType` value is not limited to these specific values. It will be defined by the carrier integrating with the Pick and Pack Last Mile Protocol API.
rate object
shippingEstimatedDate string Shipping estimated date in [UTC time format](https://learn.microsoft.com/en-us/rest/api/storageservices/formatting-datetime-values), as in `YYYY-MM-DDThh:mm:ssZ`.
shippingFinishedDate string Shipping finished date in [UTC time format](https://learn.microsoft.com/en-us/rest/api/storageservices/formatting-datetime-values), as in `YYYY-MM-DDThh:mm:ssZ`.
metaData object
View JSON Schema on GitHub

JSON Schema

vtex-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Data",
  "title": "Data",
  "required": [
    "id",
    "orderId",
    "carrierId",
    "serviceId",
    "carrierName",
    "seller",
    "status",
    "type",
    "tags",
    "labels",
    "evidences",
    "packages",
    "timeline",
    "notes",
    "timezone",
    "carrierLogo",
    "trackingUrl",
    "comments",
    "paymentMethod",
    "carrierServiceType",
    "rate",
    "shippingEstimatedDate",
    "shippingFinishedDate",
    "metaData"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Service ID."
    },
    "orderId": {
      "type": "string",
      "description": "Order ID."
    },
    "carrierId": {
      "type": "string",
      "description": "Carrier ID."
    },
    "serviceId": {
      "type": "string",
      "description": "Service ID."
    },
    "carrierName": {
      "type": "string",
      "description": "Carrier name."
    },
    "seller": {
      "type": "string",
      "description": "Identifier representing the seller associated with the order."
    },
    "status": {
      "type": "string",
      "description": "Order [status](https://help.vtex.com/en/tutorial/order-flow-and-status--tutorials_196)."
    },
    "type": {
      "type": "string",
      "description": "Order's type of delivery, `Delivery` or [`Pickup`](https://help.vtex.com/en/tutorial/pickup-points--2fljn6wLjn8M4lJHA6HP3R)."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Extra information added in the order."
      },
      "description": "Array of tags."
    },
    "labels": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Label"
      },
      "description": "Array containing information about all shipping labels printed in the order."
    },
    "evidences": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Message explaining the delivery incident."
      },
      "description": "Array with additional notes when an incident occurs in the delivery of the package."
    },
    "packages": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Package"
      },
      "description": "Array containing information about all order's packages."
    },
    "timeline": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Timeline"
      },
      "description": "Array containing information about the timeline of order changes."
    },
    "notes": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Note"
      },
      "description": "Array with services information."
    },
    "timezone": {
      "$ref": "#/components/schemas/Timezone"
    },
    "carrierLogo": {
      "type": "string",
      "description": "Carrier logo."
    },
    "trackingUrl": {
      "type": "string",
      "description": "Tracking URL."
    },
    "comments": {
      "type": "string",
      "description": "Comments."
    },
    "paymentMethod": {
      "type": "string",
      "description": "Payment method."
    },
    "carrierServiceType": {
      "type": "string",
      "description": "Carrier service type. The `carrierServiceType` value is not limited to these specific values. It will be defined by the carrier integrating with the Pick and Pack Last Mile Protocol API.",
      "enum": [
        "BROKER",
        "PICKUP_IN_STORE",
        "NATIONAL",
        "INTERNATIONAL",
        "EXPRESS",
        "SPECIALIZED",
        "OTHERS"
      ]
    },
    "rate": {
      "$ref": "#/components/schemas/Rate"
    },
    "shippingEstimatedDate": {
      "type": "string",
      "description": "Shipping estimated date in [UTC time format](https://learn.microsoft.com/en-us/rest/api/storageservices/formatting-datetime-values), as in `YYYY-MM-DDThh:mm:ssZ`."
    },
    "shippingFinishedDate": {
      "type": "string",
      "nullable": true,
      "description": "Shipping finished date in [UTC time format](https://learn.microsoft.com/en-us/rest/api/storageservices/formatting-datetime-values), as in `YYYY-MM-DDThh:mm:ssZ`."
    },
    "metaData": {
      "$ref": "#/components/schemas/MetaData1"
    }
  },
  "example": {
    "id": "519400fb-f980-4a6a-809c-9f986fdb98a4",
    "orderId": "46369545534253-01",
    "carrierId": "MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50",
    "serviceId": "MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50&78c83922-d658-48bf-89d5-0658a6a94e27",
    "carrierName": "AfterShip",
    "seller": "lastmile",
    "status": "DELIVERED",
    "type": "PICKUP_DELIVERY",
    "tags": [],
    "labels": [
      {
        "id": "78c83922-d658-48bf-89d5-0658a6a94e27",
        "name": "Shipping label",
        "url": "https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf",
        "type": "PDF"
      }
    ],
    "evidences": [],
    "packages": [
      {
        "id": "a46e5bc1-8959-459f-a094-b6e699f7214c",
        "orderId": "46369545534253-01",
        "envelope": "Foam or Plastic Containers",
        "dimensions": {
          "height": "5",
          "length": "11",
          "width": "7"
        },
        "weight": "48",
        "totalValue": 5352,
        "items": [
          {
            "id": "184",
            "name": "Chicken",
            "ean": "EAN354",
            "quantity": 8,
            "price": 669,
            "refId": "314",
            "image": "https://picsum.photos/seed/YtoZ9/128/480",
            "type": "other",
            "weight": "6"
          }
        ],
        "categories": [
          "Movies",
          "Garden",
          "Books"
        ],
        "description": "Unde deserunt libero cupiditate illum."
      }
    ],
    "timeline": [
      {
        "id": "77263f59-0ac5-4b0c-bfe5-f17a1648474d",
        "date": "2024-03-09T01:33:14.917Z",
        "createdAt": "2024-03-09T01:33:14.917Z",
        "updatedAt": "2024-03-09T01:33:14.917Z",
        "type": "STATUS",
        "description": "Service pending in DEV",
        "author": "System",
        "metaData": {
          "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
          "metaData": null,
          "serviceId": "78c83922-d658-48bf-89d5-0658a6a94e27",
          "shippingPrice": 284.02,
          "status": "PENDING",
          "labels": [
            {
              "name": "Shipping label",
              "id": "78c83922-d658-48bf-89d5-0658a6a94e27",
              "type": "PDF",
              "url": "https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf"
            }
          ]
        }
      },
      {
        "id": "9906da15-15e4-4dbd-8e90-c34ec43ed446",
        "date": "2024-03-09T01:46:20.006Z",
        "createdAt": "2024-03-09T01:46:20.006Z",
        "updatedAt": "2024-03-09T01:46:20.006Z",
        "type": "NOTE",
        "description": "A new note has been added",
        "author": "afterShip",
        "metaData": {
          "0": {
            "type": "COMMENT",
            "note": "The package is delivered at the door",
            "author": "afterShip"
          }
        }
      },
      {
        "id": "35619274-3bca-4749-8a38-53a62776144a",
        "date": "2024-03-09T01:44:17.437Z",
        "createdAt": "2024-03-09T01:44:17.437Z",
        "updatedAt": "2024-03-09T01:44:17.437Z",
        "type": "NOTE",
        "description": "A new note has been added",
        "author": "afterShip",
        "metaData": {
          "0": {
            "type": "COMMENT",
            "note": "Tracking Number: 10001709948594168",
            "author": "afterShip"
          }
        }
      },
      {
        "id": "9b60e3fd-5bf9-43c6-99f2-4292a57fa408",
        "date": "2024-03-09T01:46:19.689Z",
        "createdAt": "2024-03-09T01:46:19.689Z",
        "updatedAt": "2024-03-09T01:46:19.689Z",
        "type": "STATUS",
        "description": "The package was delivered",
        "author": "System",
        "metaData": {
          "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
          "trackingUrl": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011",
          "status": "DELIVERED"
        }
      },
      {
        "id": "21c9acaa-e14b-41bd-aaa7-a2cebd7384c0",
        "date": "2024-03-09T01:43:15.887Z",
        "createdAt": "2024-03-09T01:43:15.887Z",
        "updatedAt": "2024-03-09T01:43:15.887Z",
        "type": "STATUS",
        "description": "Service pending",
        "author": "System",
        "metaData": {
          "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
          "trackingUrl": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011",
          "status": "PENDING"
        }
      },
      {
        "id": "7a1a3a63-f94c-49f1-a912-bc3f095d7845",
        "date": "2024-03-09T01:45:18.812Z",
        "createdAt": "2024-03-09T01:45:18.812Z",
        "updatedAt": "2024-03-09T01:45:18.812Z",
        "type": "STATUS",
        "description": "Courier picked the package",
        "author": "System",
        "metaData": {
          "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
          "trackingUrl": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011",
          "status": "PICKED"
        }
      },
      {
        "id": "9ca25940-bdae-4f19-a5b4-92477abfa059",
        "date": "2024-03-09T01:33:14.978Z",
        "createdAt": "2024-03-09T01:33:14.978Z",
        "updatedAt": "2024-03-09T01:33:14.978Z",
        "type": "LABEL",
        "description": "Added a label",
        "author": "System",
        "metaData": {
          "name": "Shipping label",
          "id": "78c83922-d658-48bf-89d5-0658a6a94e27",
          "type": "PDF",
          "url": "https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf"
        }
      },
      {
        "id": "24b84b8b-7418-4ed8-bc89-b6a1cbee2331",
        "date": "2024-03-09T01:43:16.289Z",
        "createdAt": "2024-03-09T01:43:16.289Z",
        "updatedAt": "2024-03-09T01:43:16.289Z",
        "type": "NOTE",
        "description": "A new note has been added",
        "author": "afterShip",
        "metaData": {
          "0": {
            "type": "COMMENT",
            "note": "Tracking Number: 10001709948594168",
            "author": "afterShip"
          }
        }
      },
      {
        "id": "9dfad688-e99a-4b27-9ccb-959da40c3bf8",
        "date": "2024-03-09T01:33:08.385Z",
        "createdAt": "2024-03-09T01:33:08.385Z",
        "updatedAt": "2024-03-09T01:33:08.385Z",
        "type": "STATUS",
        "description": "Service creation by AfterShip",
        "author": "System",
        "metaData": {
          "status": "CREATED"
        }
      },
      {
        "id": "781ab0af-e62a-4a21-a837-8d0eea3f57c2",
        "date": "2024-03-09T01:44:17.077Z",
        "createdAt": "2024-03-09T01:44:17.077Z",
        "updatedAt": "2024-03-09T01:44:17.077Z",
        "type": "STATUS",
        "description": "Courier on route",
        "author": "System",
        "metaData": {
          "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
          "trackingUrl": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011",
          "status": "ON_ROUTE"
        }
      }
    ],
    "notes": [
      {
        "type": "COMMENT",
        "date": "2024-03-09T01:43:16.280Z",
        "content": "Tracking Number: 10001709948594168",
        "author": "afterShip"
      },
      {
        "type": "COMMENT",
        "date": "2024-03-09T01:44:17.423Z",
        "content": "Tracking Number: 10001709948594168",
        "author": "afterShip"
      },
      {
        "type": "COMMENT",
        "date": "2024-03-09T01:46:19.998Z",
        "content": "The package is delivered at the door",
        "author": "afterShip"
      }
    ],
    "timezone": {
      "offset": 300,
      "value": "America/Bogota",
      "label": null
    },
    "carrierLogo": "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",
    "trackingUrl": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011",
    "comments": "Comments.",
    "paymentMethod": "ONLINE",
    "carrierServiceType": "BROKER",
    "rate": {
      "shippingPrice": {
        "value": 0,
        "currency": "USD"
      },
      "insurancePrice": {
        "value": 0,
        "currency": "USD"
      }
    },
    "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
    "shippingFinishedDate": "2024-01-05T11:11:11.000Z",
    "metaData": {
      "integrationResponse": {},
      "carrier": {
        "name": "[FedEx] Postmen Testing Account",
        "image": null,
        "metaData": {},
        "id": "fedex",
        "type": {
          "metaData": {},
          "terms": "",
          "rate": {
            "shippingPrice": {
              "value": 284.02,
              "currency": "USD"
            },
            "insurancePrice": {
              "value": 0,
              "currency": "USD"
            }
          },
          "name": "FedEx First Overnight\u00ae",
          "transitTime": 0,
          "shippingEstimatedDate": "2024-01-05T11:11:11.000Z",
          "description": "FedEx",
          "id": "fedex_first_overnight",
          "international": false
        }
      }
    }
  }
}