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
  • cost_center: Cost center for internal accounting
  • purchase_order: Purchase order number
  • bill_of_lading: Bill of lading reference

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
  • delivered_packages_count: Packages delivered so far (for per-package deliveries)
  • delivery_progress: Packages delivered vs. total, as a fraction string (e.g. "2/3")
  • valuation: Declared value (integer)

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 DeliveryDeliveredPartially DeliveredFailedCancelled

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
partially_deliveredSome packages were delivered, others failed
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?