Skip to main content

Get delivery information by QR token

GET 
/company/qr/:token

Retrieve all information for a delivery using its unique QR token.

The QR token is generated when the delivery is created. When the QR code is scanned with the mobile app, this endpoint returns the delivery details and in the process rotates the token:

  • Removes the qr_token from the delivery
  • Generates a new confirm_token (used in PUT /confirm)

This endpoint is PUBLIC — no authentication required.

Typical Usage Flow​

  1. The carrier arrives at the destination and scans the QR code.
  2. The app calls this endpoint with the QR token.
  3. The delivery details are displayed to the signer.
  4. The signer confirms via PUT /company/qr/confirm.

Returned Fields​

  • Shipment data (service_code, status, cargo_type, etc.)
  • Pickup and delivery addresses (etl_address, etd_address)
  • Assigned vehicle and driver
  • Estimated and actual dates
  • confirm_token to use for confirmation

Technical Notes​

  • Source code: src/features/company/qr_delivery/controller.js → getDeliveryFromToken
  • The original qr_token is invalidated after the first query.
  • The generated confirm_token is required to complete the delivery.

Request​

Responses​

Delivery information obtained successfully