Using Shipping Channels

This guide explains how to integrate with shipping providers using Shipping Channels.

What are Shipping Channels?

Shipping Channels are connections to different shipping providers (like DHL, DPD) that allow you to:

• Track parcels with consistent status updates
• Maintain unified access to multiple shipping providers
• Centralize shipping provider credentials

Available Shipping Providers

Shipping Channels currently supports the following providers:

Provider Code	Description	Documentation
ppl	PPL (Professional Parcel Logistic)	PPL Guide
dhl	DHL International	DHL Guide
dhl_pl	DHL Poland	DHL Poland Guide
dpd	DPD International	DPD Guide
dpd_pl	DPD Poland	DPD Poland Guide
gls	GLS International	GLS Guide
gls_pl	GLS Poland	GLS Poland Guide
spx	SPX (Shopee Express)	SPX Guide
mrw	MRW	MRW Guide
poste_italiane	Poste Italiane	Poste Italiane Guide
allegro	Allegro	Allegro Guide
baselinker	Baselinker	Baselinker Guide
onedelivery	OneDelivery	OneDelivery Guide

Creating a Shipping Channel

You can create shipping channels through the API or the dashboard. Each channel requires:

1. A unique name for identification
2. Provider selection (see Available Shipping Providers above)
3. Provider-specific credentials

Provider-Specific Settings

Each shipping provider requires different credential information. For detailed configuration options, see the provider-specific documentation in the Shipping Providers section.

All providers require authentication credentials (API keys, username/password, or OAuth tokens) and support optional settings for:

• Sandbox/test mode
• Default label format
• Default service types
• Cash on Delivery configuration

Validating Shipping Channels

After creating a channel, you must validate the credentials. This ensures:

1. All required credentials are provided
2. The credentials grant proper access
3. The provider's API can be reached successfully

The validation process will:

1. Check all credentials format
2. Attempt to connect to the provider's API
3. Update the channel status to active if successful

If validation fails, the channel status remains pending_validation with error details.

Shipping Channel Statuses

Shipping channels can have the following statuses:

Status	Description
pending_validation	Newly created, awaiting validation
active	Validated and working correctly
inactive	Manually disabled by the user
error	Failed validation or encountered an error

Using Shipping Channels

Once a shipping channel is validated and active, you can:

1. Create shipments with one or more parcels
2. Generate and download shipping labels
3. Create tracking parcels linked to the channel
4. Receive status updates automatically
5. Query tracking information through the API

For details on creating shipments, see the Shipments Guide.

Maintaining Shipping Channels

To ensure reliable service:

1. Monitor channel status via API or dashboard
2. Update credentials when they change or expire
3. Configure webhook notifications for channel status changes

Security Considerations

Shipping provider credentials are sensitive information. The API follows security best practices:

• API credentials are encrypted at rest
• Credential values are never exposed in API responses
• Access to shipping channels is restricted to their owners

Troubleshooting

Common issues with shipping channels include:

1. Invalid Credentials: Double-check all credential values
2. API Limits: Providers may enforce rate limits
3. Permissions: Ensure credentials have proper permissions
4. Network Issues: Check if provider API is accessible

When troubleshooting, utilize the validation endpoint to verify credentials and check the detailed error messages returned.