Pular para o conteúdo principal

Confirm delivery via QR token

PUT 
/company/qr/confirm

Confirma a conclusão de uma entrega. Ao confirmar:

  • O status do envio muda para delivered
  • Registra-se a assinatura digital do destinatário
  • Guardam-se fotos de prova de entrega (se anexadas)
  • Registra-se a geolocalização da confirmação
  • Invalida-se o confirm_token
  • Processa-se o pagamento do serviço (Stripe)
  • Assina-se o eCMR digitalmente
  • Enviam-se emails de confirmação para todas as partes

Este endpoint é PÚBLICO — não requer autenticação.

Fluxo de uso​

  1. Obter o confirm_token do endpoint GET /company/qr/{token}
  2. Recolher a assinatura digital do destinatário (canvas base64)
  3. Opcionalmente, tirar fotos da entrega
  4. Chamar este endpoint com todos os dados

Campo data​

O campo data deve ser enviado como string JSON no formulário multipart. Contém os dados do signatário e sua assinatura digital:

{
  name: Juan,
  surname: Pérez,
  taxid: 12345678A,
  email: juan@example.com,
  image: data:image/png;base64,iVBORw0KG...
}

Notas técnicas​

  • Código-fonte: src/features/company/qr_delivery/controller.js → confirmDelivery
  • Aceita até 6 imagens anexadas (campo images, carregadas no S3)
  • A geolocalização é opcional mas recomendada para auditoria
  • A ação é irreversível: um envio confirmado não pode ser revertido para um estado anterior

Request​

Responses​

Entrega confirmada com sucesso