# Status Model

## Status Codes

Every update is mapped to a status code. Not every status code directly relates to a scan event by the carrier but can also be caused by a change in product code or other base data of the delivery, or the lack of expected scans.

The status codes available are described in the following table.

<table><thead><tr><th width="264">Code</th><th>Description</th></tr></thead><tbody><tr><td>InternalStatus</td><td>The internal status.</td></tr><tr><td>Ignore</td><td>A note (not shown to recipient).</td></tr><tr><td>Pending</td><td>No tracking information available yet.</td></tr><tr><td>OrderProcessed</td><td>The order has been processed.</td></tr><tr><td>PickUpScheduled</td><td>The goods are being processed for pickup.</td></tr><tr><td>PickUpPlanned</td><td>The goods will be handed over to the logistics company at the latest by the defined time.</td></tr><tr><td>Upgrade</td><td>The goods are being finished and personalized.</td></tr><tr><td>InboundScan</td><td>The goods have been sent.</td></tr><tr><td>InterimHaul</td><td>The goods are on their way.</td></tr><tr><td>InTransit</td><td>The goods are on their way.</td></tr><tr><td>CustomsIn</td><td>The goods have entered customs for processing.</td></tr><tr><td>CustomsReleased</td><td>The goods have been processed and released from customs.</td></tr><tr><td>ExportHub</td><td>The goods are being processed for export into the destination country.</td></tr><tr><td>ImportHub</td><td>The goods have arrived in the destination country.</td></tr><tr><td>Scheduled</td><td>An appointment to make the delivery has been made.</td></tr><tr><td>DestinationDeliveryCenter</td><td>The goods have arrived in the destination region.</td></tr><tr><td>DestinationDeliveryDepot</td><td>The goods are being prepared for delivery.</td></tr><tr><td>OutForDelivery</td><td>The goods will be delivered today.</td></tr><tr><td>Rerouted</td><td>The goods have been rerouted.</td></tr><tr><td>FailedAttemptFirst</td><td>The goods could not be delivered.</td></tr><tr><td>FailedAttemptSecond</td><td>The goods could not be delivered on the second delivery attempt.</td></tr><tr><td>FailedAttemptFinal</td><td>The goods could not be delivered on the final delivery attempt.</td></tr><tr><td>Return</td><td>The goods are being returned to the consigner.</td></tr><tr><td>ReturnWarning</td><td>The goods must be collected as soon as possible.</td></tr><tr><td>Stored</td><td>The goods are being stored temporarily.</td></tr><tr><td>PickupReadyToday</td><td>The goods are ready for collection.</td></tr><tr><td>PickupReadyNextDay</td><td>The goods will be ready for collection on the next working day.</td></tr><tr><td>PartiallyDelivered</td><td>The goods have been partially delivered.</td></tr><tr><td>Delivered</td><td>The goods have been successfully delivered. See the list of possible delivery location codes below.</td></tr><tr><td>Exception</td><td>An exception has occurred.<br>See the list of possible exception reasons below.</td></tr><tr><td>Cancelled</td><td>The order has been cancelled.</td></tr><tr><td>None</td><td>There is no matching for that status.</td></tr></tbody></table>

## Exception Reasons

The reasons available for the `Exception` status code are described in the following table.

<table><thead><tr><th width="265">Reason</th><th>Description</th></tr></thead><tbody><tr><td>AddressIssue</td><td>The address could not be found.</td></tr><tr><td>ContactIssue</td><td>The delivery was delayed due to missing or incorrect contact information.</td></tr><tr><td>CustomerRefusal</td><td>The delivery was rejected by the recipient.</td></tr><tr><td>Customs</td><td>There was problem with the customs clearance process.</td></tr><tr><td>Damaged</td><td>The packaging or goods were damaged.</td></tr><tr><td>DeliveryPayment</td><td>The delivery required cash on delivery but was not paid.</td></tr><tr><td>Destroyed</td><td>The package was physically destroyed, damaged beyond repair or disposed of.</td></tr><tr><td>Exception</td><td>There was an issue with the delivery and it could not be performed.</td></tr><tr><td>FailedAttempt</td><td>The carrier tried to reach the recipient unsuccessfully.</td></tr><tr><td>ForceMajeure</td><td>The delivery could not be performed due to unforeseen circumstances (for example: severe weather conditions).</td></tr><tr><td>IdentFailed</td><td>The delivery required identification from the recipient but they could not be verified.</td></tr><tr><td>ItemsMissing</td><td>Not all listed items were found.</td></tr><tr><td>LackSpace</td><td>The delivery could not be loaded onto the truck.</td></tr><tr><td>Lost</td><td>The package cannot be located, investigations closed, tracking terminated or stolen.</td></tr><tr><td>Misrouted</td><td>The delivery was routed to the wrong depot/tour.</td></tr><tr><td>MissingData</td><td>Missing essential documentation for this package is causing delays.</td></tr><tr><td>NotCollected</td><td>The goods were not collected from the pickup point and will be returned to the sender.</td></tr><tr><td>Notified</td><td>Notification to the recipient that the delivery could not be performed.</td></tr><tr><td>OperationalError</td><td>The delivery was delayed due to unforeseen operational or technical issues.</td></tr><tr><td>Prohibited</td><td>The package could not be delivered as it may contain prohibited items.</td></tr><tr><td>Recall</td><td>The goods were recalled by the retailer.</td></tr><tr><td>Return</td><td>The goods will be returned to the sender.</td></tr><tr><td>Seized</td><td>The package was confiscated by authorities, customs seizure.</td></tr><tr><td>Strike</td><td>Any kind of labor dispute.</td></tr><tr><td>TimeIssue</td><td>The tour had to be aborted because the driver exceeded the working period.</td></tr><tr><td>TrafficProblem</td><td>The delivery was delayed due to traffic problems.</td></tr><tr><td>Other</td><td></td></tr></tbody></table>

## Delivery Location Codes

The delivery location codes available for the `Delivered` status code are described in the following table.

<table><thead><tr><th width="267">Delivery Location Code</th><th>Description</th></tr></thead><tbody><tr><td>Doorstep</td><td>A direct delivery to the recipient.</td></tr><tr><td>Postbox</td><td>A letterbox with the recipient's name on it.</td></tr><tr><td>Neighbor</td><td>A delivery to a neighbor.</td></tr><tr><td>HomeDeposit</td><td>A safe deposit as authorized by the recipient.</td></tr><tr><td>ParcelShop</td><td>A pickup location operated by the carrier or a third party (for example: post offices, access points, and collection points).</td></tr><tr><td>ParcelLocker</td><td>Any parcel locker solution that usually allows for 24/7 collections.</td></tr><tr><td>Notified</td><td>The exact pickup location is not given but as per the carrier's information listed on the notification card left in the recipient's post box.</td></tr><tr><td>Reception</td><td>The goods have been delivered to the reception.</td></tr><tr><td>Unknown</td><td><p>The pickup location is not further specified by the courier. This does not mean that it is unknown to the courier where it was delivered, but rather only no delivery location has been explicitly stated.</p><p><strong>Note:</strong> The majority of these deliveries will be direct deliveries to customers.</p></td></tr></tbody></table>

## Next Actions

The next action statuses available for a delivery are described in the following table.

<table><thead><tr><th width="267">Next Action</th><th>Description</th></tr></thead><tbody><tr><td>Scheduled</td><td>The goods are scheduled for delivery.</td></tr><tr><td>PickUpReady</td><td>The goods will be ready for collection.</td></tr><tr><td>NewAttemptToday</td><td>A new attempt to deliver the goods will be made today.</td></tr><tr><td>NewAttemptNextDay</td><td>A new attempt to deliver the goods will be made tomorrow.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parcellab.com/docs/developers/v2/data-elements/status-model.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.