VTEX

Pedidos

GET
/v1/vtex/orders

Retorna pedidos de venda VTEX com status, detalhamento de totais, pagamento, envio e atribuição de marketing (UTMs, cupom).

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório)

userId?string

Identificador do usuário

integrationName?string

Nome da integração VTEX

orderId?string

Filtrar por id do pedido VTEX

status?string

Filtrar por status do pedido VTEX (ex.: invoiced, canceled)

dateStart?string

Filtrar pedidos com creation_date igual ou posterior a esta data (YYYY-MM-DD)

Formatodate
dateEnd?string

Filtrar pedidos com creation_date igual ou anterior a esta data (YYYY-MM-DD)

Formatodate
page?integer

Número da página (padrão 1)

Padrão1
limit?integer

Itens por página (padrão 500, máx. 5000)

Intervalovalue <= 5000
Padrão500

Corpo da resposta

Resposta de pedidos VTEX

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/vtex/orders?organizationId=org_123"
{  "data": [    {      "order_id": "string",      "sequence": "string",      "seller_order_id": "string",      "origin": "string",      "affiliate_id": "string",      "sales_channel": "string",      "merchant_name": "string",      "status": "string",      "status_description": "string",      "value": 0,      "creation_date": "2019-08-24T14:15:22Z",      "last_change": "2019-08-24T14:15:22Z",      "order_group": "string",      "follow_up_email": "string",      "last_message": "string",      "is_completed": true,      "order_form_id": "string",      "authorized_date": "2019-08-24T14:15:22Z",      "invoiced_date": "2019-08-24T14:15:22Z",      "cancel_reason": "string",      "tracking_id": "string",      "courier_name": "string",      "tracking_url": "string",      "tracking_labels": "string",      "utm_source": "string",      "utm_medium": "string",      "utm_campaign": "string",      "utmi_campaign": "string",      "coupon_code": "string",      "marketing_tags": "string",      "total_items_value": 0,      "total_discounts": 0,      "total_shipping": 0,      "total_tax": 0,      "payment_method": "string",      "payment_method_group": "string",      "installments": 0,      "shipping_city": "string",      "shipping_state": "string",      "shipping_country": "string",      "shipping_postal_code": "string",      "integration_id": "string",      "organization_id": "string",      "organization_id_legacy": "string",      "user_id": "string",      "document_id": "string",      "inserted_at": "2019-08-24T14:15:22Z",      "integration_name": "string",      "net_revenue": 0,      "retained_cogs": 0,      "margin": 0,      "margin_nd_reason": "incomplete_gross_value",      "cost_coverage_ratio": 0    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}