Shipments
The shipments section provides a searchable, filterable list of all shipments and a detailed view for each shipment.
Shipment list
Section titled “Shipment list”Navigate to Shipments in the main navigation. The list displays shipments in a paginated table (25 per page by default) with the following columns:
| Column | Description |
|---|---|
| Reference | Your internal reference or the auto-generated DP... reference |
| Brand | The brand that owns the shipment |
| Consignee | Consignee name |
| Country | Destination country |
| Total | Total amount (duties + taxes + additional fees) |
| Status | Payment status (PENDING, PAID, FAILED, ABANDONED) |
| Created | Shipment creation timestamp |
Filtering and search
Section titled “Filtering and search”- Search — Search by reference number, consignee name, or consignee email.
- Brand filter — Filter by a specific brand using the dropdown.
- Sort — Click column headers to sort ascending or descending.
- Live/Test toggle — The dashboard header toggle filters between live and test shipments. Test shipments are marked with a visible badge.
Click any row to open the shipment detail view.
Shipment detail
Section titled “Shipment detail”The detail view shows comprehensive information about a single shipment, organized in a two-column layout.
Left column
Section titled “Left column”Shipment items
Section titled “Shipment items”A table showing each item in the shipment:
| Field | Description |
|---|---|
| Description | Original product description |
| HS Code | Original HS code (if provided) and resolved HS code |
| Quantity | Number of units |
| Value | Declared value per unit and total value |
| Duty | Calculated duty amount |
| Tax | Calculated tax amount |
For each item, you can see both the submitted HS code and the codes resolved by Duty Pro (import and export variants for the specific origin/destination country pair).
Fee breakdown
Section titled “Fee breakdown”An itemized breakdown of all fees applied to the shipment:
- Duties — Total duty amount across all items
- Taxes — Total tax amount across all items
- Additional fees — Each additional fee with its display name, amount, and type
- Grand total — Sum of all fees
Communication history
Section titled “Communication history”A timeline of all email and SMS notifications sent for this shipment:
| Field | Description |
|---|---|
| Channel | Email or SMS |
| Recipient | Email address or phone number |
| Status | SCHEDULED, SIMULATED, SENT, DELIVERED, or FAILED |
| Timestamp | When the communication was sent or scheduled |
| Content | Template content (viewable for simulated and sent communications) |
| Error | Error message (for failed deliveries) |
Payments
Section titled “Payments”Payment records with transaction details:
| Field | Description |
|---|---|
| Status | PENDING, SUCCEEDED, FAILED, or REFUNDED |
| Amount | Payment amount |
| Transaction ID | Payment transaction identifier |
| Paid at | Payment timestamp |
Status relay log
Section titled “Status relay log”A record of all webhook and SFTP relay events for this shipment:
| Field | Description |
|---|---|
| Event type | e.g., “payment_completed”, “payment_expired” |
| Status | PENDING, SUCCESS, or FAILED |
| Payload | JSON payload sent (expandable) |
| Response code | HTTP status code (for webhooks) |
| File name | SFTP file name (for SFTP relay) |
| Attempt count | Number of delivery attempts |
| Error | Error message (for failed deliveries) |
Right column
Section titled “Right column”Consignee card
Section titled “Consignee card”Name, email, phone number, and full address of the consignee.
Route card
Section titled “Route card”Visual display of the shipment route — origin country to destination country.
Brand card
Section titled “Brand card”Link to the associated brand’s detail page.
Sender card
Section titled “Sender card”Name and address of the shipping originator.
Test shipments
Section titled “Test shipments”Test shipments (created with a dp_test_ API key) display an orange “TEST” badge throughout the UI. They appear only when the “Test” toggle is active in the dashboard header.
Test shipments show the same detail view as live shipments, but with:
- Communications marked as
SIMULATEDinstead ofSENT/DELIVERED - Receipts watermarked “TEST”
- SFTP relay files generated but not pushed