Orders

When you sync an order from your system, it works just like creating one in your panel. You'll see the same information: sender, recipient, destination, and tracking status.

What's in an order

Every order has the same fields you fill out in your panel:

Identifiers

  • id: Internal order ID
  • tracking_number: Public tracking number (e.g., 4N000000012345)
  • external_reference: Your custom reference for the order

Sender Information

  • sender_name: Name of the sender or business
  • sender_phone: Contact phone number
  • sender_email: Contact email address
  • sender_company: Company name

Recipient Information

  • recipient_name: Name of the recipient
  • recipient_phone: Contact phone number
  • recipient_email: Contact email address
  • recipient_company: Company name

Destination

  • destination_address: Street address
  • destination_locality: Locality (comuna) name
  • destination_reference: Reference or landmark
  • destination_building_number: Building or apartment number

Package Details

  • weight: Package weight in kilograms
  • packages_count: Number of packages
  • valuation: Declared value

Delivery Information

  • delivery_state: Current state of the delivery
  • service_id: Type of delivery service
  • estimated_delivery_date: Expected delivery date
  • delivery_date: Actual delivery date (when delivered)

Delivery states

These are the same statuses you see in your panel. Your orders move through them as they're picked up and delivered:

PendingPicked UpIn TransitOut for DeliveryDeliveredFailedCancelled

State Descriptions

StateDescription
pendingOrder has been created and is awaiting pickup
picked_upPackage has been collected from the sender
in_transitPackage is being transported to the destination area
out_for_deliveryPackage is on the delivery vehicle for final delivery
deliveredPackage has been successfully delivered to the recipient
failedDelivery attempt failed (recipient unavailable, wrong address, etc.)
nulledOrder has been cancelled

How orders flow

Orders move through these states - same as what you see in your panel:

pending → picked_up → in_transit → out_for_delivery → delivered
                                         ↓
                                      failed → (retry or nulled)

Normal flow

  1. pending: You sync the order from your system
  2. picked_up: Courier collects the package from you
  3. in_transit: Package is on its way
  4. out_for_delivery: Package is out with the driver
  5. delivered: Customer receives the package

When things don't go as planned

  • Failed delivery: If the driver can't deliver, the order moves to failed. It can be retried.
  • Cancellation: You can cancel orders in any non-final state. They move to nulled.

Want to know when statuses change? Set up webhooks to get notified automatically - no need to check your panel.

Proof of delivery

When an order is delivered, you get the same proof you see in your panel:

  • Recipient name: Who signed for the package
  • Recipient RUT: Their Chilean ID (if provided)
  • Recipient role: Their relationship to the order
  • Location: GPS coordinates of where it was delivered
  • Photos: Pictures taken at delivery

You can fetch this through the Tracking API to show customers in your app.

Was this page helpful?