# Pedidos de Venda ## Listagem de pedidos de venda com filtros específicos `GET` `{url_base}/orders` São permitidos apenas filtros com até 30 dias no período informado nos parâmetros `from` e `to`. Status dos pedidos de venda disponíveis: `error`, `stockout`, `holded`, `waiting_label`, `picking`, `picked`, `packing`, `packed, waiting_dispatch`, `dispatched` e `cancelled` ### Descrição dos Status | Status | Descrição | | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `stockout` | Indicar que o SKU teve ruptura de Estoca e que precisa ser feito um novo inbound para o pedido avançar | | `holded` | Gatilho para envio da NFe, quando o pedido é de fato reservado na plataforma | | `waiting_label` | Etapa onde será adicionar NFe, emitido CTe, fazer a verificação de frete e gerar a etiqueta de transportes, para de fato o pedido ser processado fisicamente | | `cancelled` | Quando o pedido é cancelado no ERP, o pedido pode ser cancelado apenas até x momento/status | | `picking`, `picked`, `packing`, `packed`, `waiting_dispatch`, `dispatched`, `error` | Outros status disponiveis | ### Marketplaces Suportados A plataforma suporta integração com os seguintes marketplaces: | Marketplace | Nome para uso na API | | ------------- | -------------------- | | Mercado Livre | `MercadoLivre` | | Shopee | `shopee` | | TikTok | `tiktok` | | Amazon | `Amazon` | > **Nota:** Utilize exatamente os nomes listados na coluna "Nome para uso na API" no campo `marketplace_name` ao criar ou atualizar pedidos. #### Query Parameters | Name | Type | Description | | ----------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------- | | from\* | DateString |

Data de início da criação dos pedidos de venda para filtro

Formato: YYYY-MM-DD

| | to\* | DateString |

Data de fim da criação dos pedidos de venda para filtro

Formato: YYYY-MM-DD

| | updated\* | DateString |

Data de última atualização dos pedidos de venda para filtro

Formato: YYYY-MM-DD

| | columns\* | Array | Lista do nome das colunas requisitadas, separadas por vírgula | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- | | X-Api-Key\* | String | Chave de API criada através da plataforma | | X-Api-Version\* | String |

Versão da API a ser utilizada, de acordo com a documentação

Enviar "v1" como default

| {% tabs %} {% tab title="200: OK Pedidos de venda listados com sucesso" %} {% endtab %} {% tab title="401: Unauthorized Acesso não autorizado" %} {% endtab %} {% endtabs %} #### Colunas disponíveis para listagem dos pedidos de venda: | Nome | Descrição | Tipo | Formato | | :-------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------: | :------------: | | `cancelled_at` | Data e hora de cancelamento do pedido de venda | Timestamp | | | `delivered_at` | Data e hora de entrega do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `delivery_full_address` | Endereço completo de entrega do pedido de venda | String | | | `delivery_name` | Nome do recebedor do pedido de venda | String | | | `external_id` | ID único externo de referência para o pedido de venda | String | | | `external_tracking_code` | Código de rastreamento externo do pedido de venda | String | | | `handoff_finished_at` | Data e hora de despacho do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `has_extra_packaging` | Indicador se o pedido de venda contém empacotamento extra | Boolean | | | `has_returned` | Indicador se o pedido de venda possui devolução | Boolean | | | `holded_at` | Data e hora de reserva do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `human_id` | ID único da Estoca para o pedido de venda em formato legível | String | | | `id` | ID único da Estoca para o pedido de venda | UUID | | | `integration_erp` | Identificador da integração ERP associada ao pedido de venda | String | | | `invoice_access_key` | Chave de acesso da nota fiscal | String | | | `invoice_number` | Número da nota fiscal | String | | | `invoice_released_at` | Data e hora de liberação da nota fiscal do pedido de venda | Timestamp | | | `invoice_serie` | Série da nota fiscal | String | | | `is_estoca_contract` | Indicador se o pedido de venda utiliza contrato de frete da Estoca | Boolean | | | `is_manual_order` | Indicador se o pedido de venda foi criado manualmente na plataforma | Boolean | | | `is_same_day_delivery` | Indicador se o pedido de venda tem entrega no mesmo dia | Boolean | | | `labels_released_at` | Data e hora de liberação das etiquetas do pedido de venda | Timestamp | | | `last_updated_at` | Data e hora da última atualização do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `marketplace_id` | ID único do Marketplace para o pedido de venda | String | | | `marketplace_name` | Nome descritivo do Marketplace, de acordo com a origem do pedido de venda. Nota: Para ver os marketplaces suportados, consulte a seção Marketplaces Suportados acima. | String | | | `order_created_at` | Data de criação do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `order_price` | Valor total do pedido de venda | Decimal | | | `packer_id` | | | | | `packing_finished_at` | Data e hora de finalização do empacotamento do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `packing_started_at` | Data e hora de início do empacotamento do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `picker_id` | | | | | `picking_finished_at` | Data e hora de finalização da separação do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `picking_started_at` | Data e hora de início da separação do pedido de venda | Timestamp | YYYYMMDDHHMMSS | | `return_invoice_access_key` | Chave de acesso da nota fiscal de devolução | String | | | `return_invoice_number` | Número da nota fiscal de devolução | String | | | `return_invoice_serie` | Série da nota fiscal de devolução | String | | | `returned_at` | Data e hora de devolução do pedido de venda | Timestamp | | | `service_name` | Nome do serviço de entrega | String | | | `shipping_label` | Identificador da operadora de etiqueta do pedido de venda | String | | | `shipping_released_at` | Data e hora de liberação do frete | Timestamp | YYYYMMDDHHMMSS | | `signed_at` | Data e hora de assinatura/confirmação do pedido de venda | Timestamp | | | `status` | Status atual do pedido de venda | String | | | `store_id` | ID único da Estoca para a loja | UUID | | | `store_name` | Nome descritivo da Estoca para a loja | String | | | `store_type` | Tipo da loja associada ao pedido de venda | String | | | `tag_b2b` | | | | | `total_items` | Quantidade total de itens no pedido de venda | Int | | | `total_products` | Quantidade total de produtos distintos no pedido de venda | Int | | | `tracking_code` | Código de rastreamento do pedido de venda | String | | | `tracking_status` | Status atual do rastreamento do pedido de venda | String | | | `tracking_sub_status` | Sub-status do rastreamento do pedido de venda | String | | | `tracking_updated_at` | Data e hora da última atualização do rastreamento | Timestamp | YYYYMMDDHHMMSS | | `warehouse_id` | ID único da Estoca para o armazém | UUID | | | `warehouse_name` | Nome do armazém associado ao pedido de venda | String | | | `withdrawal_order` | Indicador se o pedido de venda é uma ordem de retirada | Boolean | | ## Consulta de um pedido de venda específico pelo ID Estoca `GET` `{url_base}/orders/{id}` Status dos pedidos de venda disponíveis: `error`, `stockout`, `holded`, `waiting_label`, `picking`, `picked`, `packing`, `packed, waiting_dispatch`, `dispatched` e `cancelled` #### Path Parameters | Name | Type | Description | | ------------------------------------ | ------ | ----------------------------------------- | | id\* | String | ID único da Estoca para o pedido de venda | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- | | X-Api-Key\* | String | Chave de API criada através da plataforma | | X-Api-Version\* | String |

Versão da API a ser utilizada, de acordo com a documentação

Enviar "v1" como default

| {% tabs %} {% tab title="200: OK Pedido de venda encontrado com sucesso" %} ```json { "status": "success", { "order_data": { "id": "fd59d262-1234-4c97-91d1-39c8f5g2w8f5", "price": 857.71, "freight": 38.85, "discount": 0, "total_value": 366.56, "human_id": "G2W.8F5", "synced_at": "2024-05-30 15:00:13", "holded_at": "2024-05-30 15:00:14", "date": "2024-05-30", "released_at": "2024-05-30 15:13:19", "external_id": "1234", "status": "dispatched", "store": { "id": "e4d62580-07d5-4ed3-a132-4ba9358rv123", "name": "Store Name" }, "delivery": { "name": "Client Name", "transporter": "Transporter Name", "transporter_federal_registration": "", "transporter_state": "", "volumes": { "f3d49f97-f1bd-4f26-b0f1-3fa99ba55d4f": { "service_name": "Transporter Name", "tracking_code": "3528852as155" } }, "address": { "zip_code": "12345678", "address": "Rua", "number": "1234", "complement": "Complemento", "neighborhood": "Bairro", "city": "Cidade", "state": "ES" } }, "customer": { "name": "Client Name", "email": "email@gmail.com", "federal_registration": "98544123272", "state_registration": null, "address": { "zip_code": "12345678", "address": "Rua", "number": "1234", "complement": "Complemento", "neighborhood": "Bairro", "city": "Cidade", "state": "ES" } }, "marketplace": null, "intermediary": null, "invoice": { "requested": false }, "return_invoice": null, "warehouse": { "id": "3ad1cc54-2cf5-44be-ade6-de6bdb123ABC", "name": "Armazém" }, "items": { "c3ecd3a0-291a-434a-b88d-85e1ba123ABC": { "name": "Produto", "sku": "SKUCODE", "amount": 1.0, "freight": 0.0, "serial_number": [], "batch": { "3f37bc7e-4ab9-4378-8e36-d10df1ad428a": { "expiration_date": "2024-06-30", "fabrication_date": "2024-06-03", "quantity": 10, "batch": "01" }, "2d48d541-d951-48c7-b46e-21747db177f6": { "expiration_date": "2024-06-30", "fabrication_date": "2024-06-03", "quantity": 1, "batch": "01" } }, "holds": { "ef5540c4-62cf-4a2b-aabc-42c375123ABC": { "invoice": { "number": "12345", "serie": "1", "issue_date": "2024-04-17 19:25:05+00:00", "access_key": "35240432761719000131550010000479431123456789" }, "amount": 1 } } } }, "cancel": {}, "pick": { "started_at": "2024-05-31 11:43:42", "picker": "email@loja.com.br", "finished_at": "2024-05-31 12:09:03" }, "pack": { "started_at": "2024-05-31 14:55:41", "packer": "email@loja.com.br", "finished_at": "2024-05-31 14:56:27" }, "handoff": { "finished_at": "2024-05-31 21:19:35", "operator": "email@loja.com.br" }, "tracking": { "status": "bipe de sa\u00edda para entrega", "shipped_date": "2024-06-03 21:12:57", "delivered_date": null } }, "status": "success" } } ``` {% endtab %} {% tab title="200: OK Pedido em processamento" %} ```json { "status": "Order processing", "order_data": {} } ``` {% endtab %} {% tab title="400: Bad Request Pedido de venda com erro no processamento" %} ```json { "status": "Order processed with error", "order_data": {} } ``` {% endtab %} {% tab title="401: Unauthorized Acesso não autorizado" %} {% endtab %} {% tab title="404: Not Found Pedido de venda não encontrado" %} ```json { "status": "No order found", "order_data": {} } ``` {% endtab %} {% endtabs %} ## Consulta de um pedido de venda específico pelo ID externo de referência `GET` `{url_base}/orders/{id}/external` ID externo pode ser uma referência no ERP ou Marketplace, de acordo com a origem do pedido de venda para integração na plataforma. Status dos pedidos de venda disponíveis: `error`, `stockout`, `holded`, `waiting_label`, `picking`, `picked`, `packing`, `packed, waiting_dispatch`, `dispatched` e `cancelled` #### Path Parameters | Name | Type | Description | | ------------------------------------ | ------ | ----------------------------------------------------- | | id\* | String | ID único externo de referência para o pedido de venda | #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- | | X-Api-Key\* | String | Chave de API criada através da plataforma | | X-Api-Version\* | String |

Versão da API a ser utilizada, de acordo com a documentação

Enviar "v1" como default

| {% tabs %} {% tab title="200: OK Pedido de venda encontrado com sucesso" %} ```json { "status": "success", { "order_data": { "id": "fd59d262-1234-4c97-91d1-39c8f5g2w8f5", "price": 857.71, "freight": 38.85, "discount": 0, "total_value": 366.56, "human_id": "G2W.8F5", "synced_at": "2024-05-30 15:00:13", "holded_at": "2024-05-30 15:00:14", "date": "2024-05-30", "released_at": "2024-05-30 15:13:19", "external_id": "1234", "status": "dispatched", "store": { "id": "e4d62580-07d5-4ed3-a132-4ba9358rv123", "name": "Store Name" }, "delivery": { "name": "Client Name", "transporter": "Transporter Name", "transporter_federal_registration": "", "transporter_state": "", "volumes": { "f3d49f97-f1bd-4f26-b0f1-3fa99ba55d4f": { "service_name": "Transporter Name", "tracking_code": "3528852as155" } }, "address": { "zip_code": "12345678", "address": "Rua", "number": "1234", "complement": "Complemento", "neighborhood": "Bairro", "city": "Cidade", "state": "ES" } }, "customer": { "name": "Client Name", "email": "email@gmail.com", "federal_registration": "98544123272", "state_registration": null, "address": { "zip_code": "12345678", "address": "Rua", "number": "1234", "complement": "Complemento", "neighborhood": "Bairro", "city": "Cidade", "state": "ES" } }, "marketplace": null, "intermediary": null, "invoice": { "requested": false }, "return_invoice": null, "warehouse": { "id": "3ad1cc54-2cf5-44be-ade6-de6bdb123ABC", "name": "Armazém" }, "items": { "c3ecd3a0-291a-434a-b88d-85e1ba123ABC": { "name": "Produto", "sku": "SKUCODE", "amount": 1.0, "freight": 0.0, "serial_number": [], "batch": { "3f37bc7e-4ab9-4378-8e36-d10df1ad428a": { "expiration_date": "2024-06-30", "fabrication_date": "2024-06-03", "quantity": 10, "batch": "01" }, "2d48d541-d951-48c7-b46e-21747db177f6": { "expiration_date": "2024-06-30", "fabrication_date": "2024-06-03", "quantity": 1, "batch": "01" } }, "holds": { "ef5540c4-62cf-4a2b-aabc-42c375123ABC": { "invoice": { "number": "12345", "serie": "1", "issue_date": "2024-04-17 19:25:05+00:00", "access_key": "35240432761719000131550010000479431123456789" }, "amount": 1 } } } }, "cancel": {}, "pick": { "started_at": "2024-05-31 11:43:42", "picker": "email@loja.com.br", "finished_at": "2024-05-31 12:09:03" }, "pack": { "started_at": "2024-05-31 14:55:41", "packer": "email@loja.com.br", "finished_at": "2024-05-31 14:56:27" }, "handoff": { "finished_at": "2024-05-31 21:19:35", "operator": "email@loja.com.br" }, "tracking": { "status": "bipe de sa\u00edda para entrega", "shipped_date": "2024-06-03 21:12:57", "delivered_date": null } }, "status": "success" } } ``` {% endtab %} {% tab title="200: OK Pedido de venda em processamento" %} ```json { "status": "Order processing", "order_data": {} } ``` {% endtab %} {% tab title="400: Bad Request Pedido de venda com erro no processamento" %} ```json { "status": "Order processed with error", "order_data": {} } ``` {% endtab %} {% tab title="401: Unauthorized Acesso não autorizado" %} {% endtab %} {% tab title="404: Not Found Pedido de venda não encontrado" %} ```json { "status": "No order found", "order_data": {} } ``` {% endtab %} {% endtabs %} ## Criação de novo pedido de venda `POST` `{url_base}/orders` A criação de pedidos de venda funciona de forma assíncrona, ou seja, o ID do pedido que retorna na resposta da rota é o ID reservado para aquele pedido, porém o pedido passará por uma fila de integração, e precisa de verificação para saber se o mesmo foi criado de fato, ou se houve alguma falha. (o pedido pode ser consultado utilizando esse [método](#consulta-de-um-pedido-de-venda-especifico-pelo-id-estoca)) A NFe pode ser enviada na criação do pedido ou quando o pedido for para o status de holded, independente do momento a NFe é obrigatória para o pedido ser processado e ela deve ser enviada como string e com o conteúdo literal (O próprio XML), não usar outros formatos pois não será possível processar a NF. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- | | X-Api-Key\* | String | Chave de API criada através da plataforma | | X-Api-Version\* | String |

Versão da API a ser utilizada, de acordo com a documentação

Enviar "v1" como default

| #### Request Body | Name | Type | Description | | -------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | order\* | Object | Objeto do pedido de venda | | order.date\* | DateString |

Data de criação do pedido de venda

Formato: YYYY-MM-DD HH:mm:ss

| | order.id\* | String | ID único externo de referência para o pedido de venda | | order.external\_id | String | ID único auxiliar de referência para o pedido de venda | | order.marketplace\_name | String | Nome descritivo do Marketplace, de acordo com a origem do pedido de venda. Nota: Para ver os marketplaces suportados, consulte a seção [Marketplaces Suportados](#marketplaces-suportados) acima. | | order.marketplace\_id | String | ID único do Marketplace, de acordo com a origem do pedido de venda | | order.total\_value\* | String |

Valor total do pedido de venda

Formato: 0.00

| | order.freight\_value | String |

Valor de frete do pedido de venda

Formato: 0.00

| | order.status | String | Status do pedido de venda | | order.integration\_type | String | Tipo de integração para referência interna do pedido de venda | | order.client | Object | Objeto do cliente destinatário do pedido de venda | | order.client.name\* | String | Nome ou razão social do cliente destinatário do pedido de venda | | order.client.cnpj\* | String | CNPJ ou CPF do cliente destinatário do pedido de venda | | order.client.ie | String | Inscrição estuadal do cliente destinatário do pedido de venda | | order.client.rg | String | RG do cliente destinatário do pedido de venda | | order.client.email | String | E-mail do cliente destinatário do pedido de venda | | order.client.mobile | String | Telefone celular do cliente destinatário do pedido de venda | | order.client.phone | String | Telefone fixo ou comercial do cliente destinatário do pedido de venda | | order.client.address | String | Logradouro do cliente destinatário do pedido de venda | | order.client.number | String | Número referente ao endereço do cliente destinatário do pedido de venda | | order.client.complement | String | Complemente referente ao endereço do cliente destinatário do pedido de venda | | order.client.neighborhood | String | Bairro referente ao endereço do cliente destinatário do pedido de venda | | order.client.city | String | Cidade referente ao endereço do cliente destinatário do pedido de venda | | order.client.zip\_code | String |

Código de CEP referente ao endereço do cliente destinatário do pedido de venda

Utilizar base dos Correios

Formato: 00000-000

| | order.client.state | String | Estado referente ao endereço do cliente destinatário do pedido de venda | | order.intermediary | Object | Objeto do intermediador do pedido de venda | | order.intermediary.name | String | Nome de usuário do intermediador do pedido de venda | | order.intermediary.federal\_registration | String | CNPJ do intermediador do pedido de venda | | order.items\* | Array | Objeto dos produtos pertencentes ao pedido de venda | | order.items.sku\* | String | SKU do produto, de acordo com a nota fiscal e catálogo da plataforma | | order.items.quantity\* | String | Quantidade do produto, de acordo com a nota fiscal | | order.items.name\* | String | Nome do produto, de acordo com a nota fiscal | | order.items.value\* | String |

Preço unitário do produto, de acordo com a nota fiscal

Formato: 0.00

| | order.invoice\* | Object | Objeto da nota fiscal de venda | | order.invoice.number\* | String | Número da nota fiscal | | order.invoice.serie\* | String | Série da nota fiscal | | order.invoice.access\_key\* | String | Chave de acesso da nota fiscal | | order.invoice.status\* | String | Status da nota fiscal | | order.invoice.value\* | String |

Valor total da nota fiscal

Formato: 0.00

| | order.invoice.issue\_date\* | String |

Data de emissão da nota fiscal

Formato: YYYY-MM-DD HH:mm:ss

| | order.invoice.xml\* | String | Conteúdo literal do XML da nota fiscal | | order.transport\* | Object | Objeto de dados do transporte | | order.transport.transporter\* | String | Nome da tansportadora | | order.transport.volumes\* | Array | Objeto de volumes de transporte | | order.transport.volumes.service\_name\* | String | Nome do serviço para entrega | | order.transport.volumes.tracking\_code | String | Código de rastreio da entrega | | order.transport.volumes.label | String |

Link da etiqueta de transportes para entrega

Formato: URL pública completa e sem autenticação via cabeçalho da requisição

Etiqueta de transportes para entrega em ZPL

Formato: Texto no padrão ZPL

| | order.transport.delivery\_address\* | Object | Objeto de entrega do transporte | | order.transport.delivery\_address.name\* | String | Nome do recebedor para entrega do pedido de venda | | order.transport.delivery\_address.address\* | String | Logradouro para entrega do pedido de venda | | order.transport.delivery\_address.number\* | String | Número do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.complement\* | String | Complemento do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.neighborhood\* | String | Bairro do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.zip\_code\* | String | Código de CEP do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.city\* | String | Cidade do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.state\* | String | Estado referente ao endereço de entrega do pedido de venda | \* Propriedades obrigatórias \* Propriedades obrigatórias quando o objeto pai for enviado {% tabs %} {% tab title="200: OK Pedido de venda criado com sucesso" %} ```json { "status": "Order Created: [UUID('00000000-0000-0000-0000-000000000000')]" } ``` {% endtab %} {% tab title="401: Unauthorized Acesso não autorizado" %} {% endtab %} {% endtabs %} Payload de exemplo: ```json { "order": { "date": "2024-10-22 00:00:00", "id": "000101", "external_id": "0632c43c-5276-4401-8fac-bd8949afebfe", "total_value": "39.11", "integration_type": "API", "client": { "name": "Letícia Almeida Castro", "cnpj": "894.105.169-00", "email": "LeticiaAlmeidaCastro@armyspy.com", "phone": "(11) 4211-2384", "address": "Rua Noel Rosa", "number": "1944", "complement": "", "neighborhood": "Planalto", "city": "São Bernardo do Campo", "zip_code": "09896-350", "state": "SP" }, "items": [ { "sku": "952181", "quantity": "3", "name": "Produto Teste", "value": "8.8" } ], "invoice": { "number": "000000001", "serie": "001", "access_key": "31240940595809000713550010000000011527903731", "status": "Autorizada", "value": "39.11", "issue_date": "2024-10-22 00:00:00", "xml": " 31 52790373 VENDA MERC. RECEB.TERC. C/ S.TRIBUT. CONT. SUBSTITUIDO 55 1 1 2024-09-26T15: 59: 00-03: 00 2024-09-26T15: 59: 00-03: 00 1 1 3125101 1 1 0 2 1 1 2 0 0 12.1.2310 | 3.0 40595809000713 SP. SUMARE - EXTREMA - MG SP. SUMARE - EXTREMA - MG AV JOAQUIM LOURENCO DE LIMA 2150 GALPAO11 Q VARGEM DO JOAO PINTO 3125101 EXTREMA MG 37644901 1058 BRASIL 1130265999 0048727000060 3 56035322620 NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL Rua Noel Rosa 1944 Planalto 3106200 São Bernardo do Campo SP 30180109 1058 BRASIL 1142112384 9 MONICA@DIREITODEFAMILIA.ADV.BR 952181 27898085944749 CAC OLEO CORPORAL SUAVE 120ML 12UN 33072090 2002900 5405 UN 3.0000 8.8000000000 26.40 7898085944745 UN 3.0000 8.8000000000 12.71 1 615492 01 0 60 0 0.0000 0 0 0.0000 39.11 18.0000 7.04 999 53 02 39.11 1.6500 0.65 02 39.11 7.6000 2.97 - EAN: 27898085944749 - EANTrib: 7898085944745 0 0 0 0 0 0 0 0 0 0 0 26.40 12.71 0 0 0 0 0 0.65 2.97 0 39.11 0 TEX COURIER LTDA 206214714111 AV PIRACEMA, 155 BARUERI SP CAIXA 0.360 0.437 001000000001 39.11 0 39.11 001 2024-09-26 39.11 0 15 39.11 - Pedido: 615492- Vendedor: VENDEDOR LOJA VIRTUAL- Via de Transporte: Rodoviario- Cond.Pagto.: A VISTA- Frete: CIF 53113791000122 Rodrigo de Almeida Sartorio resp_tecnico_dfe_protheus@totvs.com.br 1128593904 c42VHgKIrwAbpU8TjAGaiggo1OY= WW5/4ZG/XdgNgkJBwkm/hhlpLoiUp66MtjcyD0c5ABhNHhO3LDS5aH6MJWwE2hnp4GdCWdTdXLGuTT7J6YZb/fozmqgkE7+2TkFHXD7+ROKu2QkwSzOrfkL/PE3k9gzaoiqHwraxJhK/RMQ1Y4NZDjsc/gAANSdj6FJQFogTkqrwmmA3EN4+MBct6km8/uuKUIwWTMNdfRAsN3sFr4pc3IWOKc/JukR5APbS8mXZaO6Ii0r1BLbRBZeXJEQNlpQFeYbgGRRIX4Ih8M2+hNegCeB4SzXN/jE3AHnwAqaRf6NAempSjksOnT3/8BbyCy/XuP0ElD1/iMk/uMhpYWo9tw== MIIH6DCCBdCgAwIBAgIUAzVwhM0zBPAfPUj69uvOh9S6BvkwDQYJKoZIhvcNAQELBQAwejELMAkGA1UEBhMCQlIxEzARBgNVBAoTCklDUC1CcmFzaWwxNjA0BgNVBAsTLVNlY3JldGFyaWEgZGEgUmVjZWl0YSBGZWRlcmFsIGRvIEJyYXNpbCAtIFJGQjEeMBwGA1UEAxMVQUMgRElHSVRBTFNJR04gUkZCIEczMB4XDTI0MDYxMDE2NTMyMVoXDTI1MDYxMDE2NTMyMVowggEBMQswCQYDVQQGEwJCUjETMBEGA1UECgwKSUNQLUJyYXNpbDELMAkGA1UECAwCTUcxEDAOBgNVBAcMB0V4dHJlbWExNjA0BgNVBAsMLVNlY3JldGFyaWEgZGEgUmVjZWl0YSBGZWRlcmFsIGRvIEJyYXNpbCAtIFJGQjEWMBQGA1UECwwNUkZCIGUtQ05QSiBBMTEXMBUGA1UECwwOMjQxODEyNTMwMDAxNzcxGTAXBgNVBAsMEHZpZGVvY29uZmVyZW5jaWExOjA4BgNVBAMMMVNQIFNVTUFSRSBQUk9EVVRPUyBERSBISUdJRU5FIExUREE6NDA1OTU4MDkwMDA3MTMwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCv1uybp0F52hm3CFwtSvmJgq+Byq1cS47mcUmJMb73FnoHsm0A5PmY+RVU2OiI69uXXViMNHWSeFbiFi7QZVr3wYU2Tg0OXFBt/eY93GQDRYKBhyaAu/7rKGdroDphszwWKgv3gf/WmXhI26rQFAUaPBNaRviLhpJ1TWJLRW9c4DC4v558ZdY1bN7dIhI9Nxzo6lL5UgZl5lqzXFuJ/Moq6khISo3NCfb5C4ijeJpItVQ5mNLXrhMvJhV/drT2m1TxDq0muQ+sDlIpvgLBasXGrMxPgSSAoOgraelGNQ9CZwyDpNQQVKwsFJZ2rdqWu4j54Fze4NKenaL58uAkgtx9AgMBAAGjggLbMIIC1zAJBgNVHRMEAjAAMB8GA1UdIwQYMBaAFN24td0C3LhQyn4GVEPBfvyu9K17MIGoBggrBgEFBQcBAQSBmzCBmDBdBggrBgEFBQcwAoZRaHR0cDovL3d3dy5kaWdpdGFsc2lnbmNlcnRpZmljYWRvcmEuY29tLmJyL3JlcG9zaXRvcmlvL3JmYi9BQ0RJR0lUQUxTSUdOUkZCRzMucDdiMDcGCCsGAQUFBzABhitodHRwOi8vb2NzcC5kaWdpdGFsc2lnbmNlcnRpZmljYWRvcmEuY29tLmJyMF0GA1UdIARWMFQwUgYGYEwBAgEsMEgwRgYIKwYBBQUHAgEWOmh0dHA6Ly93d3cuZGlnaXRhbHNpZ25jZXJ0aWZpY2Fkb3JhLmNvbS5ici9yZXBvc2l0b3Jpby9yZmIwHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMEMIGxBgNVHR8EgakwgaYwV6BVoFOGUWh0dHA6Ly93d3cuZGlnaXRhbHNpZ25jZXJ0aWZpY2Fkb3JhLmNvbS5ici9yZXBvc2l0b3Jpby9yZmIvQUNESUdJVEFMU0lHTlJGQkczLmNybDBLoEmgR4ZFaHR0cDovL3d3dy5kaWdpdGFsdHJ1c3QuY29tLmJyL3JlcG9zaXRvcmlvL3JmYi9BQ0RJR0lUQUxTSUdOUkZCRzMuY3JsMA4GA1UdDwEB/wQEAwIF4DCBuwYDVR0RBIGzMIGwgRVjb250YWJpbEBmaW9yZS5jbnQuYnKgPQYFYEwBAwSgNAQyMDEwOTE5OTU0MzQ3Njc4OTgzNzAwMDAwMDAwMDAwMDAwMDAwMzQxNTk3OTcxU1NQU1CgJAYFYEwBAwKgGwQZTUFOQVNIQSBWRU5BTkNJTyBNT1JJWk9OT6AZBgVgTAEDA6AQBA40MDU5NTgwOTAwMDcxM6AXBgVgTAEDB6AOBAwwMDAwMDAwMDAwMDAwDQYJKoZIhvcNAQELBQADggIBAHA9EQGst9YCAQLpW8hieoNaUVKCFTj8A0wtqHhuSSF/ZP6gQZk+/ASIox9ZEPgEH/STUn+QUNLWXfEpkLXR4qBacP8QUvZYDFWiSgbqsuc6nwQRwGFLwRSkhjcdjjHiVTmAT64QDxsv+vsFLSDXdFLEAADA+Pl/+iiAWWBmlr3ejIYXvcK0Jmlsn0Xo1TwQkW/9t5e4Lu45R2vwXvfusqMqOKNkj69ovUyaB8EIFAdHE2WmuFLU6Y35GZD6VKOVRNFXIJ62SKB1xo+odyymk9h/DDoTkeF7kJzIdxNxzb8z7ChN1F2skAzVMuE5I71pfyaAhqD9ROR/ofqtuihzwED9M1zVC2z2B5lejVOwoyCDQ/itICkPszuOXaxOFFAQUIA1ssJHKl5J6lROh+TxE8oFSsmnMGCf8iaWuUqTHR2vJRrbhRzJMDPa+MTDfv4Nra0UHLTQ+X/teyss/jq66XPi/olHtHAa7mZ0itPtmJAAbd34mvZukDVqDVTvbr8bdXWf5v+iXRIKFsBNYkAZbWZaegVI0U/ANaE+yBuWVQ/+gtavLlM9CL9em0j33GvMei4eNkiohaT6z9rr+g81 //q2BrQEaSTDmlVcL6oxsj7btOrwz+NHSGfjXcc9JjRgr43D6IQONy1/hDNlgcf5ipGN2GGu4oy6TuelIhSjjexo 2 J-3.2.57 31240940595809000713550010000000011527903730 2024-09-26T16: 01: 38-03: 00 131240149311126 c42VHgKIrwAbpU8TjAGaiggo1OY= 100 Autorizado o uso da NF-e " }, "transport": { "transporter": "ESTOCA TECNOLOGIAS DO BRASIL LTDA", "delivery_address": { "name": "Letícia Almeida Castro", "address": "Rua Noel Rosa", "number": "1944", "complement": "", "neighborhood": "Planalto", "city": "São Bernardo do Campo", "zip_code": "09896-350", "state": "SP" }, "volumes": [ { "service_name": "Expresso" } ] } } } ``` ## Atualização de um pedido de venda `PUT` `{url_base}/orders` #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- | | X-Api-Key\* | String | Chave de API criada através da plataforma | | X-Api-Version\* | String |

Versão da API a ser utilizada, de acordo com a documentação

Enviar "v1" como default

| #### Request Body | Name | Type | Description | | -------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | order\* | Object | Objeto do pedido de venda | | order.date\* | DateString |

Data de criação do pedido de venda

Formato: YYYY-MM-DD HH:mm:ss

| | order.id\* | String | ID único externo de referência para o pedido de venda | | order.external\_id | String | ID único auxiliar de referência para o pedido de venda | | order.marketplace\_name | String | Nome descritivo do Marketplace, de acordo com a origem do pedido de venda. Nota: Para ver os marketplaces suportados, consulte a seção [Marketplaces Suportados](#marketplaces-suportados) acima. | | order.marketplace\_id | String | ID único do Marketplace, de acordo com a origem do pedido de venda | | order.total\_value\* | String |

Valor total do pedido de venda

Formato: 0.00

| | order.freight\_value | String |

Valor de frete do pedido de venda

Formato: 0.00

| | order.status | String | Status do pedido de venda | | order.integration\_type | String | Tipo de integração para referência interna do pedido de venda | | order.client | Object | Objeto do cliente destinatário do pedido de venda | | order.client.name\* | String | Nome ou razão social do cliente destinatário do pedido de venda | | order.client.cnpj\* | String | CNPJ ou CPF do cliente destinatário do pedido de venda | | order.client.ie | String | Inscrição estuadal do cliente destinatário do pedido de venda | | order.client.rg | String | RG do cliente destinatário do pedido de venda | | order.client.email | String | E-mail do cliente destinatário do pedido de venda | | order.client.mobile | String | Telefone celular do cliente destinatário do pedido de venda | | order.client.phone | String | Telefone fixo ou comercial do cliente destinatário do pedido de venda | | order.client.address | String | Logradouro do cliente destinatário do pedido de venda | | order.client.number | String | Número referente ao endereço do cliente destinatário do pedido de venda | | order.client.complement | String | Complemente referente ao endereço do cliente destinatário do pedido de venda | | order.client.neighborhood | String | Bairro referente ao endereço do cliente destinatário do pedido de venda | | order.client.city | String | Cidade referente ao endereço do cliente destinatário do pedido de venda | | order.client.zip\_code | String |

Código de CEP referente ao endereço do cliente destinatário do pedido de venda

Utilizar base dos Correios

Formato: 00000-000

| | order.client.state | String | Estado referente ao endereço do cliente destinatário do pedido de venda | | order.intermediary | Object | Objeto do intermediador do pedido de venda | | order.intermediary.name | String | Nome de usuário do intermediador do pedido de venda | | order.intermediary.federal\_registration | String | CNPJ do intermediador do pedido de venda | | order.items\* | Object | Objeto dos produtos pertencentes ao pedido de venda | | order.items.sku\* | String | SKU do produto, de acordo com a nota fiscal e catálogo da plataforma | | order.items.quantity\* | String | Quantidade do produto, de acordo com a nota fiscal | | order.items.name\* | String | Nome do produto, de acordo com a nota fiscal | | order.items.value\* | String |

Preço unitário do produto, de acordo com a nota fiscal

Formato: 0.00

| | order.invoice\* | Object | Objeto da nota fiscal de venda | | order.invoice.number\* | String | Número da nota fiscal | | order.invoice.serie\* | String | Série da nota fiscal | | order.invoice.access\_key | String | Chave de acesso da nota fiscal | | order.invoice.status | String | Status da nota fiscal | | order.invoice.value | String |

Valor total da nota fiscal

Formato: 0.00

| | order.invoice.issue\_date | String | Data de emissão da nota fiscal | | order.invoice.xml | String | Conteúdo literal do XML da nota fiscal (deve ser o xml da nota autorizada) | | order.transport\* | Object | Objeto de dados do transporte | | order.transport.transporter\* | String | Nome da transportadora | | order.transport.volumes\* | Object | Objeto de volumes de transporte | | order.transport.volumes.service\_name\* | String | Nome do serviço para entrega | | order.transport.volumes.tracking\_code | String | Código de rastreio da entrega | | order.transport.volumes.label | String |

Link da etiqueta de transportes para entrega

Formato: URL pública completa e sem autenticação via cabeçalho da requisição

Etiqueta de transportes para entrega em ZPL

Formato: Texto no padrão ZPL

| | order.transport.delivery\_address.name\* | String | Nome do recebedor para entrega do pedido de venda | | order.transport.delivery\_address.address\* | String | Logradouro para entrega do pedido de venda | | order.transport.delivery\_address.number\* | String | Número do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.complement\* | String | Complemento do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.neighborhood\* | String | Bairro do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.zip\_code\* | String | Código de CEP do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.city\* | String | Cidade do logradouro para entrega do pedido de venda | | order.transport.delivery\_address.state\* | String | Estado referente ao endereço de entrega do pedido de venda | {% tabs %} {% tab title="200: OK Pedido de venda atualizado com sucesso" %} ```json { "status": "Order Created: [UUID('00000000-0000-0000-0000-000000000000')]" } ``` {% endtab %} {% tab title="400: Bad Request Pedido de venda em processamento" %} ```json { "status": "Order processing", "order_data": {} } ``` {% endtab %} {% tab title="401: Unauthorized Acesso não autorizado" %} {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.estoca.com.br/api-docs/v1/outbounds.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.