Pedido (Order / Invoice)

Entidade central no GO: solicitação de entrega recebida de um embarcador, com nota fiscal, status, envios e vínculo com rotas

Pedido é a entidade central que representa uma solicitação de entrega (ou coleta/retorno) recebida de um embarcador e vinculada a uma filial. No sistema, a mesma entidade é chamada de order na API e, em parte do contexto de negócio, de invoice quando se fala da nota fiscal ou do documento do pedido.


O que compõe um pedido

Identificação

  • id — identificador interno Abbiamo
  • number — número do pedido
  • external_id — ID do embarcador
  • tracking — código de rastreio

Nota fiscal / Invoice

  • invoice_number — número da NF
  • access_keys — chave de acesso da NF
  • content_declaration — dados da DC-e quando o pedido foi criado com declaração de conteúdo informada pelo embarcador (key, serie, number)
  • Dados de emissão

Valores

  • amount — valor total do pedido
  • Preço e prazo prometido ao cliente — valor do frete e data de entrega prometidos

Status

  • status / sub_status — refletem o estado atual do pedido. Para a lista completa de códigos e traduções, veja Status de pedido.

Tipo

  • type — Entrega (DELIVERY), Retirada em loja (TAKEOUT) ou Reversa (RETURN)

Relacionamentos

RelaçãoDescrição
FilialA qual filial o pedido pertence
EmbarcadorO embarcador que originou o pedido
ClienteDestinatário e dados de contato
EndereçosOrigem (endereço da filial) e destino
Volumes e itensVolumes e itens associados
EnviosUm pedido pode ter um ou mais envios (ex.: reenvio)
RotaA rota à qual o pedido está associado (quando houver)

Outros dados

  • Entrega: dados da última entrega — motorista, data de entrega, janela de entrega etc.
  • Marcadores: tags/labels associadas ao pedido
  • Datas: criação, atualização de status, data prevista de entrega

Como um pedido chega ao GO

  • Do embarcador Abbiamo (LOG) — pedidos chegam automaticamente via integração quando o embarcador usa o LOG e configura uma integração de transportadora apontando para a sua operação GO.
  • De embarcador externo — pedidos entram via API ou importação manual para embarcadores cadastrados diretamente no GO.
  • Criação manual — pelo formulário na tela de Pedidos.

Pedido vs. Invoice

Na Abbiamo, são a mesma coisa

Na Abbiamo, pedido e invoice representam a mesma entidade. Um pedido carrega as informações de uma nota fiscal (número, chave de acesso, dados de emissão), mas não são entidades separadas — é tudo o mesmo registro.

Nesta página