Skip to main content

Status update

Updating shipment statuses is a key element in Parcelsync. This part will show you how to access shipment statuses in your project.

Given the data nature of a shipment in Parcelsync, it is important to understand that we only update statuses of parcels included in the shipment (more here).

Parcels can be in different states, which are updated by carriers. The states parcels can be in are:

  • DATA_SENT - Data about parcels has been sent to the carrier
  • ACCEPTED_BY_CARRIER - Parcels have been accepted by the carrier
  • IN_TRANSIT - Parcels are in transit
  • OUT_FOR_DELIVERY - Parcels are out for delivery
  • DELIVERED - Parcels have been delivered
  • PICKED_UP - Parcels have been picked up
  • DELIVERY_FAILED - Delivery failed
  • RETURNED - Parcels have been returned
  • CANCELED - Parcels have been canceled
  • EXCEPTION - Exception occurred

Automatic status updates​

Automatic status updates are performed based on information provided by carriers. This information is processed and statuses are converted into a unified format, which is then available through the UI and API. We also store metadata (metadata) provided by carriers.

PPL metadata​

  • services - field containing services and their prices for a given package (toll, fuel charge, etc.)
  • deliveryFeature - delivery features (delivDate and delivPerson)
  • paymentInfo.invoiceNumber - invoice number

Czech Post metadata​

  • postOffice - code/zip code of the post office where the status occurred
  • postOfficeName - post office name
  • statusDescription - description of the status

Packeta​

  • isReturning
  • externalTrackingCode - external tracking code
  • storedUntil - date until the package is stored

## Getting shipment status by tracking number

For chosen carriers (PPL) it is possible to retrive status of shipments by tracking number. This status is retrived directly from the carrier and is available through the API, see API documentation. This way you can get the current status of a shipment that was not sent through Parcelsync.