Abbiamo DocsCriar pedido (v2)
Cria um pedido na Abbiamo e, opcionalmente, dispara a solicitação de coleta para a transportadora.
Header obrigatório. Toda chamada exige o header x-abbiamo-seller-group-key. Preencha-o no canto superior direito desta página ou veja como obter a sua chave.
Validação de duplicidade. Para garantir integridade operacional e evitar despacho de múltiplos motoristas pro mesmo pacote, a Abbiamo bloqueia a criação de pedidos duplicados.
Como funciona a validação?
O sistema não olha só o número do pedido. Pra um pedido ser considerado duplicado, ele precisa ter paridade simultânea em todos estes critérios:
- Número do pedido (
number): identificador único da carga. - ID da filial (
seller_id): origem da venda. - Tipo do pedido (
type): categoria da entrega. - Documento do cliente (
document_number): CPF ou CNPJ do destinatário. - Número da nota (
invoice_number): se presente nos dois registros. - Janela de tempo: a verificação cobre pedidos criados nos últimos 3 meses.
Rate limit: 300 requisições por minuto por chave. Acima disso a API retorna HTTP 429. Veja Limite de Requisições.
The delivery object automates order dispatches to carriers during order creation. Its composition can be adapted to different levels of complexity, ranging from simple and direct configurations ideal for quick shipments without specific adjustments to more advanced customizations that allow detailed adaptations to meet specific logistical needs. This may include selecting carriers, preference rules, or special transportation conditions according to the requirements of each order. Please check the Delivery Object page for more details on how to build this object according your needs.
Este endpoint cria pedidos individuais para a filial identificada por seller_identifier parameter
Authorization
sec0 In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v2/order" \ -H "Content-Type: application/json" \ -d '{ "order_number": "136411778", "seller_identifier": "54857486000108", "external_id": "pedido_524", "type": "DELIVERY", "amount": 600, "invoice_created_timestamp": "2020-08-14T19:43:09.4740645+03:00", "invoice_number": "5467203", "access_key": "51080701212344000127550010000000981364117781", "volumes": [ { "weight": 1570, "height": 20, "length": 30, "width": 10, "items": [ { "name": "Vinho Miolo Rose", "sku": "VMR_001", "thumb_url": "www.thumb.com/thumb.png", "quantity": 7, "amount": 550, "weight": 250 } ] } ], "customer": { "email": "joaosilva@gmail.com", "phone_country_code": "55", "phone": "11999999999", "document_type": "CPF", "document_number": "21903118026", "name": "João Ferreira" }, "destination_address": { "zip_code": "01412100", "country": "BRA", "state": "RJ", "city": "Rio de Janeiro", "neighborhood": "Ipanema", "street": "Rua Conde de Bonfim", "street_number": "10", "complement": "sala comercial, 13º andar", "reference": "Portão azul" }, "delivery": { "carrier_name": "TRANSLEGAL", "method_type": "CONVENCIONAL" } }'"{\n \"status\": \"success\",\n \"id\": \"30c24480-8e45-4afa-af35-0231b460e9ed\",\n \"tracking\": \"abc123d\",\n \"mail_label_link\": \"https://mail-label-api.abbiamo.io/mail-label/v1?trackings=abc123d\",\n \"tracking_link\": \"http://meupedido.abbiamolog.com/abc123d\"\n}""{\n \"statusCode\": \"400\",\n \"message\": [\n \"order_number must be a string\",\n \"volumes must contain at least 1 elements\",\n \"volumes must be an array\",\n \"customer must be a non-empty object\",\n \"customer must be an object\",\n \"destination_address must be a non-empty object\",\n \"destination_address must be an object\"\n ],\n \"error\": \"Bad Request\"\n}""{\n \"message\": \"Unauthorized\"\n}"