Overview
Nexus integrates with courier/delivery services for AWB (airway bill) creation, label printing, and real-time shipment tracking. The primary integration is with Bosta (a MENA-region last-mile delivery service).
Capabilities
- Create shipments/AWBs via courier API.
- Generate and print shipping labels.
- Real-time tracking status updates via webhooks.
- Automatic order status updates on delivery events.
Edge Functions
| Function | Direction | Purpose |
|---|
create-awb-bosta | Outbound | Creates a shipment with Bosta courier |
print-awb | Read | Generates a printable shipping label |
tracking-webhook | Inbound | Receives shipment status updates |
internal-tracking-webhook | Inbound | Internal tracking event handler |
logistics-webhook | Inbound | General logistics event handler |
process-order-shipment | Action | Processes order for shipment creation |
Common troubleshooting
| Issue | Resolution |
|---|
| AWB creation fails | Verify courier API credentials. Check that the shipping address is complete. |
| Tracking updates not received | Ensure the tracking webhook URL is registered with the courier. |
| Label not printing | Check that print-awb returns a valid PDF URL. Verify browser popup settings. |