> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crbtrack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parcel Status Codes

> Complete reference of parcel status codes and transitions

## Status Overview

```mermaid theme={null}
graph TD
    A[ORDERED] --> B[LABEL_GENERATED]
    B --> C[MANIFEST_SUBMITTED]
    C --> D[PICKED_UP]
    D --> E[CUSTOMS_CLEARANCE]
    E --> F[IN_TRANSIT]
    F --> G[OUT_FOR_DELIVERY]
    G --> H[DELIVERED]
    
    B --> V[VOIDED]
    G --> I[DELIVERY_FAILED]
    I --> J[RETURN_TO_SENDER]
    E --> K[CUSTOMS_HOLD]
```

## Status Codes

| Code                 | Name                   | Description                           |
| -------------------- | ---------------------- | ------------------------------------- |
| `ORDERED`            | Order Created          | Initial status when order is received |
| `LABEL_GENERATED`    | Label Generated        | Shipping label has been created       |
| `MANIFEST_SUBMITTED` | Manifest Submitted     | Added to AWB manifest                 |
| `PICKED_UP`          | Picked Up              | Collected by carrier                  |
| `CUSTOMS_CLEARANCE`  | Customs Clearance      | Processing at export customs          |
| `IN_TRANSIT`         | In Transit             | On the way to destination             |
| `CUSTOMS_ARRIVED`    | Arrived at Destination | Arrived in destination country        |
| `CUSTOMS_PROCESSING` | Customs Processing     | Import customs processing             |
| `CUSTOMS_HOLD`       | Customs Hold           | Held for additional documentation     |
| `CUSTOMS_RELEASED`   | Customs Released       | Cleared customs                       |
| `OUT_FOR_DELIVERY`   | Out for Delivery       | With local delivery driver            |
| `DELIVERY_ATTEMPTED` | Delivery Attempted     | Delivery was attempted but failed     |
| `DELIVERED`          | Delivered              | Successfully delivered                |
| `DELIVERY_FAILED`    | Delivery Failed        | Could not be delivered                |
| `RETURN_TO_SENDER`   | Return to Sender       | Being returned to origin              |
| `RETURNED`           | Returned               | Returned to sender                    |
| `VOIDED`             | Voided                 | Order cancelled                       |
| `EXCEPTION`          | Exception              | General exception/issue               |

## Status Details

### ORDERED

```json theme={null}
{
  "status": "ORDERED",
  "statusName": "Order Created",
  "description": "Order has been received and is being processed"
}
```

**Next statuses**: `LABEL_GENERATED`, `VOIDED`

### LABEL\_GENERATED

```json theme={null}
{
  "status": "LABEL_GENERATED",
  "statusName": "Label Generated",
  "description": "Shipping label has been created and is ready for printing",
  "labelUrl": "https://..."
}
```

**Next statuses**: `MANIFEST_SUBMITTED`, `VOIDED`

### MANIFEST\_SUBMITTED

```json theme={null}
{
  "status": "MANIFEST_SUBMITTED",
  "statusName": "Manifest Submitted",
  "description": "Parcel has been added to AWB manifest",
  "awbNumber": "180-12345678"
}
```

**Next statuses**: `PICKED_UP`

### IN\_TRANSIT

```json theme={null}
{
  "status": "IN_TRANSIT",
  "statusName": "In Transit",
  "description": "Package is on the way to destination",
  "location": "Guayaquil, EC",
  "estimatedDelivery": "2024-12-28T18:00:00Z"
}
```

**Next statuses**: `OUT_FOR_DELIVERY`, `CUSTOMS_HOLD`, `EXCEPTION`

### DELIVERED

```json theme={null}
{
  "status": "DELIVERED",
  "statusName": "Delivered",
  "description": "Package has been delivered successfully",
  "deliveredAt": "2024-12-27T14:30:00Z",
  "signature": "M. García",
  "deliveryLocation": "Front Door"
}
```

**Terminal status** - No further transitions

### CUSTOMS\_HOLD

```json theme={null}
{
  "status": "CUSTOMS_HOLD",
  "statusName": "Customs Hold",
  "description": "Package is held at customs pending documentation",
  "holdReason": "Additional documentation required",
  "requiredDocuments": ["Commercial Invoice", "ID Copy"]
}
```

**Next statuses**: `CUSTOMS_RELEASED`, `RETURN_TO_SENDER`

### DELIVERY\_FAILED

```json theme={null}
{
  "status": "DELIVERY_FAILED",
  "statusName": "Delivery Failed",
  "description": "Package could not be delivered",
  "failureReason": "Recipient not available",
  "attemptCount": 3
}
```

**Next statuses**: `RETURN_TO_SENDER`, `OUT_FOR_DELIVERY` (retry)

## Status Groups

### Pre-Shipment

* `ORDERED`
* `LABEL_GENERATED`
* `MANIFEST_SUBMITTED`

### In Transit

* `PICKED_UP`
* `CUSTOMS_CLEARANCE`
* `IN_TRANSIT`
* `CUSTOMS_ARRIVED`
* `CUSTOMS_PROCESSING`
* `CUSTOMS_RELEASED`

### Delivery

* `OUT_FOR_DELIVERY`
* `DELIVERY_ATTEMPTED`
* `DELIVERED`

### Exceptions

* `CUSTOMS_HOLD`
* `DELIVERY_FAILED`
* `RETURN_TO_SENDER`
* `RETURNED`
* `EXCEPTION`

### Cancelled

* `VOIDED`

## Webhook Events by Status

| Status               | Webhook Event               |
| -------------------- | --------------------------- |
| `LABEL_GENERATED`    | `parcel.label_generated`    |
| `MANIFEST_SUBMITTED` | `parcel.manifest_submitted` |
| `IN_TRANSIT`         | `parcel.status_changed`     |
| `OUT_FOR_DELIVERY`   | `parcel.out_for_delivery`   |
| `DELIVERED`          | `parcel.delivered`          |
| `DELIVERY_FAILED`    | `parcel.exception`          |
| `CUSTOMS_HOLD`       | `parcel.exception`          |
| `RETURN_TO_SENDER`   | `parcel.exception`          |