Abbiamo DocsCriar pedido (v2)
Cria um pedido na Abbiamo e, opcionalmente, dispara a solicitação de coleta para a transportadora.
Conceito relacionado
Entenda o fluxo no guia: Conceito: Pedido · Como criar um pedido.
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.
Objeto delivery. Esse objeto automatiza o despacho do pedido pra transportadora já no momento da criação. Você pode usar desde a forma mais simples (só uma preference_rule tipo cheapest/fastest) até a mais específica (escolher transportadora, método e prazo). Veja a página Objeto delivery pra entender as 4 formas de montar esse objeto e qual usar em cada caso.
Este endpoint cria pedidos individuais para a filial identificada pelo seller_identifier.
Authorization
sellerGroupKey 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": "12345678000190", "external_id": "pedido_524", "type": "DELIVERY", "amount": 600, "invoice_created_timestamp": "2020-08-14T19:43:09.4740645+03:00", "invoice_number": "5467203", "access_key": "35200000000000000000000000000000000000000000", "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": "12345678909", "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": "TRANSPORTADORA-A", "method_type": "CONVENCIONAL" } }'{
"status": "success",
"id": "30c24480-8e45-4afa-af35-0231b460e9ed",
"tracking": "abc123d",
"mail_label_link": "https://mail-label-api.abbiamo.io/mail-label/v1?trackings=abc123d",
"tracking_link": "http://meupedido.abbiamolog.com/abc123d"
}{
"statusCode": "400",
"message": [
"order_number must be a string",
"volumes must contain at least 1 elements",
"volumes must be an array",
"customer must be a non-empty object",
"customer must be an object",
"destination_address must be a non-empty object",
"destination_address must be an object"
],
"error": "Bad Request"
}{
"message": "Unauthorized"
}