Abbiamo DocsEnvio (Delivery)
Unidade de trabalho da transportadora: a execução logística de um pedido, com eventos, motorista e status
Envio é a unidade de trabalho da transportadora: a "viagem" ou a execução logística de um pedido (ou parte dele). Um mesmo pedido pode ter vários envios ao longo do tempo (ex.: primeiro envio falhou, reenvio). No sistema aparece como delivery.
O que compõe um envio
Identificação
| Campo | Descrição |
|---|---|
id | Identificador interno Abbiamo |
external_id | ID na transportadora |
support_id | ID de suporte na transportadora |
Status
status/sub_status— estado do envio (ex.: criado, em coleta, em rota, entregue, cancelado). A referência de códigos e traduções está em Status de pedido.
Transportadora
O envio está sempre associado a uma integração de transportadora que o atendeu.
Modalidade e prazo
O envio está sempre associado a uma modalidade e um prazo. A combinação identifica o tipo de serviço — por exemplo: UBER/CARRO/EXP60.
Para entender os códigos de prazo (EXP60, EXP120, D0, D1 etc.), veja Prazos de Entrega.
Motorista
- Nome, documento, telefone
- Veículo: tipo, cor, placa
- Imagem do motorista e do veículo
Eventos
Lista de eventos de entrega — cada mudança de status ou ocorrência (ex.: saída para entrega, entrega realizada).
Datas e valores
- Criação, ETA, data prevista de entrega
- Expectativa de prazo e preço — vêm da tabela de frete no momento da solicitação de coleta (ou da cotação, quando o envio é criado por automação). São o preço e a data de entrega esperada calculados com base na tabela.
- Valor previsto/auditado da transportadora
- Códigos de verificação (coleta, entrega, retorno)
Criação
manual_action— indica se foi criado manualmente ou pelo sistema- Usuário que solicitou envio/cancelamento, quando aplicável
Relação com pedido e filial
| Relação | Descrição |
|---|---|
| Envio → Pedido | Todo envio pertence a um pedido |
| Envio → Filial | Indiretamente, via pedido — o envio "herda" a filial do pedido |
| Envio → Integração de transportadora | O envio é criado/gerenciado por uma integração de transportadora |
Onde aparece
- Na página de Envios do painel: lista de envios com filtros por filial, status, transportadora etc.
- No sidepanel de um pedido: ao abrir um pedido, os envios associados aparecem no painel lateral com seus eventos e status.
Ciclo de vida de um envio
Roteirização e reenvio
Um pedido pode ser enviado quando está em estado roteirizável (veja Roteirização — em breve). Após o envio, se houver falha ou retorno, o pedido volta a ser roteirizável e pode ter outra tentativa de entrega — gerando um novo envio. Cada envio tem seu próprio histórico de eventos e status.