Get delivery information by QR token
GET/company/qr/:token
Recupera todas as informações de uma entrega a partir do seu token QR único.
O token QR é gerado ao criar a entrega. Ao escanear o QR com o aplicativo móvel, este endpoint retorna os detalhes da entrega e, no processo, rotaciona o token:
- Remove o
qr_tokenda entrega - Gera um novo
confirm_token(usado emPUT /confirm)
Este endpoint é PÚBLICO — não requer autenticação.
Fluxo típico de uso
- O transportador chega ao destino e escaneia o QR
- O aplicativo chama este endpoint com o token do QR
- Os detalhes da entrega são exibidos ao signatário
- O signatário confirma via
PUT /company/qr/confirm
Campos retornados
- Dados do envio (
service_code,status,cargo_type, etc.) - Endereço de carga e descarga (
etl_address,etd_address) - Veículo e motorista designados
- Datas estimadas e reais
confirm_tokenpara usar na confirmação
Notas técnicas
- Código-fonte:
src/features/company/qr_delivery/controller.js→getDeliveryFromToken - O
qr_tokenoriginal fica invalidado após a primeira consulta - O
confirm_tokengerado é necessário para concluir a entrega
Request
Responses
- 200
- 404
- 500
Informação da entrega obtida com sucesso.
Entrega não encontrada. Pode ocorrer quando:
- O token QR não existe, já foi utilizado ou expirou
- A entrega foi removida do sistema
- O formato do token está incorreto
Erro interno do servidor ao consultar o banco de dados