Criação de Pedido

Formas de criar pedidos: formulário, CSV, XLSX no dashboard, API pública e integração de pedido

A criação de pedido é a ação de registrar um novo pedido no sistema. Existem três formas principais: pelo dashboard (formulário, CSV ou XLSX), via API pública ou por integração de pedido.

Pelo dashboard

Na página de Pedidos, o botão Criar pedido permite criar pedidos de três formas:

Forma	Descrição
Formulário	Preenchimento manual dos dados do pedido (cliente, endereço, volumes, NF etc.) em um formulário na interface.
CSV	Upload de arquivo CSV com os dados dos pedidos. Útil para criar vários pedidos de uma vez.
XLSX	Upload de planilha Excel (.xlsx) com os dados dos pedidos. Também permite criação em lote.

Latitude e longitude na planilha (pula o geocoding automático)

A planilha (CSV ou XLSX) aceita colunas de latitude e longitude para o endereço do pedido. Se as duas vierem preenchidas na linha, a Abbiamo não roda o geocoding automático para aquele endereço — usa direto a coordenada informada e marca o pedido com geolocation_provider = SELLER.

Pra que serve

É um workaround self-service valioso para endereços que o geocoder automático não resolve bem — condomínios, vias privadas, loteamentos fechados. Em vez de abrir chamado de suporte, basta preencher a coordenada certa na planilha na hora do upload.

As duas colunas juntas

Latitude e longitude precisam vir as duas preenchidas ou as duas vazias na mesma linha. Se só uma vier preenchida, o pedido é rejeitado na validação.

O mesmo comportamento vale para pedidos criados via API pública (campos latitude/longitude dentro de destination_address ou source_address — veja Criar pedido (v2)) e para pedidos recebidos por integração de pedido que já chegam com coordenada na origem.

Janela de entrega em horas e tipo de moradia na planilha

A planilha (CSV ou XLSX) também aceita os campos delivery_start_window_hour, delivery_end_window_hour (formato HH:mm, ex.: 09:00) e residence_type (commercial ou residential). São os mesmos campos aceitos pela API pública — veja a descrição completa em Pedido (conceito).

Horário no fuso da filial

Preencha delivery_start_window_hour/delivery_end_window_hour no fuso horário da filial que está criando o pedido — a Abbiamo converte e guarda o valor em UTC.

Via API pública

A API da Abbiamo permite criar pedidos programaticamente. O endpoint Create order V2 (POST https://api.abbiamo.io/v2/order) cria pedidos individuais.

O objeto delivery na requisição pode automatizar a solicitação de coleta para transportadoras — desde configurações simples até regras de preferência e condições especiais. Consulte a documentação do Delivery Object para montar o objeto conforme sua necessidade.

Header obrigatório

O header x-abbiamo-seller-group-key é obrigatório para criar pedidos via API.

O corpo da requisição também aceita delivery_start_window_hour/delivery_end_window_hour (janela de entrega em horário, formato HH:mm, sem data associada) e residence_type (commercial ou residential) — veja a descrição completa em Pedido (conceito).

Via integração de pedido

Quando a integração de pedido está configurada (ex.: VTEX), os pedidos são criados automaticamente no sistema a partir dos canais conectados — marketplace, e-commerce, ERP etc.

Links relacionados

Pedido (conceito) — o que compõe um pedido
Integração de Pedido — conceito das integrações
Tela de Pedidos — onde criar e acompanhar novos pedidos
Create order V2 — endpoint da API