Comunidade

Ask a Question
Back to all

Dúvida técnica – Identificador de vínculo entre Ordem de Coleta (PickupPost) e Rastreio (DeliveryReceipt)

Olá time Rodonaves,

Estamos integrando o fluxo completo de Ordem de Coleta (Pickup Post) e posteriormente a consulta de rastreio via endpoint /deliveryreceipt.

Hoje, no nosso processo:

  1. Emitimos uma ordem de coleta via /api/v1/pickuppost
  2. A Rodonaves retorna um código/número da ordem de coleta
  3. Nós salvamos esse identificador internamente como referência da coleta

O ponto é que, ao avançarmos para o rastreio, percebemos que esse identificador da ordem de coleta não pode ser utilizado diretamente para consulta no endpoint de rastreio (/deliveryreceipt), que exige parâmetros como:

  • CPF/CNPJ + Número do CT-e
  • CPF/CNPJ + Número da NF-e
  • Chave da NF-e
  • Protocolo

Dessa forma, nossa dúvida principal é:

Qual é o identificador oficial que relaciona a Ordem de Coleta emitida (pickuppost) com o CT-e e os eventos de rastreio (deliveryreceipt)?

Precisamos entender qual campo devemos persistir na emissão para garantir o vínculo correto entre:

  • nosso registro interno da coleta
  • o transporte efetivamente gerado (CT-e)
  • os eventos de rastreamento

Perguntas objetivas:

  1. Após emitir uma ordem de coleta, como obter o CT-e Number correspondente?

  2. Existe algum identificador único retornado no pickuppost que posteriormente possa ser usado para rastreio?

  3. O vínculo correto deve ser feito via:

    • ProtocolNumber?
    • BillOfLadingId?
    • outro identificador interno da Rodonaves?
  4. Qual é a melhor prática recomendada para sistemas integrados que precisam acompanhar rastreio desde a coleta até a entrega?

Nosso objetivo é armazenar o identificador correto desde a emissão, para que cada rastreio seja associado de forma determinística à coleta correspondente, sem depender de CPF/CNPJ (que não é único).

Agradecemos se puderem orientar o fluxo correto e os campos recomendados.