Etiquetas do cliente: envio por API ou upload no armazém

Alguns clientes compram as próprias etiquetas e enviam o PDF com o pedido. Registre esse PDF como a etiqueta do pedido — por API na criação do pedido ou por upload na página do pedido — e o armazém vai imprimir e colar como está, sem comprar outra etiqueta.

Uma etiqueta do cliente só conta como etiqueta quando o PDF vem com três coisas: o código de rastreio, a transportadora e um arquivo de etiqueta padrão de 4×6 polegadas com uma página. Um PDF sem código de rastreio é só um arquivo — o sistema não o trata como etiqueta. Depois de registrada, o cartão de etiqueta do pedido mostra transportadora, serviço e rastreio, e a expedição em lote (WMS → Pedidos de saída → Expedição com etiqueta primeiro) usa essa etiqueta primeiro, sem cobrar frete pelo pedido — vale apenas o manuseio de impressão e colagem do armazém.

Opção A: o cliente envia a etiqueta com o pedido (API)#

1. Ao criar o pedido pela API de pedidos, adicione o bloco de etiqueta: o PDF (como referência de arquivo ou base64), o código de rastreio e o código da transportadora; o código de serviço é opcional. Sua equipe de integração encontra os campos exatos na documentação da API de criação de pedidos.
2. O pedido é sempre criado. Se a etiqueta não puder ser registrada — tamanho errado, mais de uma página ou rastreio já usado por outro pedido — a resposta diz isso claramente no resultado da etiqueta, e o pedido continua válido. Corrija o arquivo e registre depois pela página do pedido (Opção B), sem recriar o pedido.
3. Um código de rastreio só pode pertencer a um pedido por vez. Se o mesmo código chegar duas vezes, o segundo registro é recusado com uma mensagem clara — confira se o arquivo foi enviado ao pedido errado antes de tentar de novo.

Opção B: upload no armazém#

1. Abra o pedido (OMS → Pedidos → abrir o pedido) ou seu pedido de saída (WMS → Pedidos de saída → abrir o pedido). As duas páginas têm o mesmo cartão «Etiqueta do cliente» — o que você envia de um lado aparece no outro.
2. Escolha o arquivo PDF, confirme o rastreio e a transportadora (o cartão preenche o que o pedido já declara — confira com a etiqueta de papel) e envie. Um novo envio substitui a etiqueta atual automaticamente; a antiga deixa de valer, então nunca há confusão sobre qual está vigente.
3. Arquivo errado? Use «Anular» no cartão para liberar o código de rastreio e envie o certo. Se o código da etiqueta for diferente do declarado no pedido, vale a etiqueta registrada e o pedido é atualizado para esse código — o número da etiqueta física é o que a transportadora reconhece.

Recursos do Docklify usados neste artigo#

• Cartão de etiqueta do cliente (ver, enviar, substituir, anular) — OMS → Pedidos → detalhe do pedido (/oms/orders) e WMS → Pedidos de saída → detalhe do pedido (/wms/orders)
• Bloco de etiqueta na API de criação de pedidos — veja a documentação da API de criação (/api/oms/orders)
• A expedição em lote de etiqueta primeiro usa primeiro a etiqueta registrada — WMS → Pedidos de saída → Expedição com etiqueta primeiro (/wms/orders)