📖 Looking for karrio's legacy docs? Visit docs.karrio.io

Shipments Management

Community Edition
Core Feature

Every Karrio project comes with comprehensive shipment management capabilities, providing multi-carrier rate shopping, automated label generation, real-time tracking integration, and seamless order fulfillment workflows.

Shipment Management Dashboard

Rate comparison interface with carrier options and pricing

Core Features

Karrio’s shipment management system provides everything you need for modern shipping operations:

Live Rates & Service Selection

Compare shipping rates across multiple carriers in real-time to find the most cost-effective options for your customers.

  • Multi-Carrier Rate Shopping: Get quotes from FedEx, UPS, DHL, and others simultaneously
  • Real-time Pricing: Access current carrier rates including surcharges and fees
  • Delivery Estimates: Get accurate delivery time estimates for each service

Label Generation & Purchase

Create and purchase shipping labels with automatic carrier compliance and tracking integration.

  • Multi-Format Labels: Generate PDF, PNG, and ZPL labels for any printer
  • Automatic Compliance: Carrier-specific requirements handled automatically
  • Batch Processing: Generate multiple labels efficiently

International Shipments

Handle complex international shipping with automated customs documentation and compliance.

  • Customs Documentation: Automatic generation of commercial invoices and customs forms
  • Compliance Management: Ensure compliance with international trade regulations
  • Multi-Currency Support: Handle pricing in local currencies

Paperless Trade

Electronic customs documentation for international shipments with intelligent UPS and FedEx integration.

  • Smart Document Processing: UPS automatically selects optimal FormType based on document availability
  • Multiple Workflows: Support for pre-uploaded documents and inline document upload
  • Carrier Optimization: UPS uses API-generated invoices when no documents provided; FedEx supports ETD workflows

Quick Start

1. Get Live Rates

Start by comparing rates across multiple carriers:

1curl -X POST "https://api.karrio.io/v1/proxy/rates" \
2  -H "Authorization: Token YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "shipper": {
6      "postal_code": "10001",
7      "country_code": "US"
8    },
9    "recipient": {
10      "postal_code": "90210",
11      "country_code": "US"
12    },
13    "parcels": [{
14      "weight": 2.5,
15      "weight_unit": "LB"
16    }]
17  }'

2. Create Shipment with Label

Purchase a shipping label using the selected service:

1curl -X POST "https://api.karrio.io/v1/shipments" \
2  -H "Authorization: Token YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "service": "fedex_ground",
6    "shipper": {
7      "person_name": "John Doe",
8      "address_line1": "123 Main St",
9      "city": "New York",
10      "postal_code": "10001",
11      "country_code": "US"
12    },
13    "recipient": {
14      "person_name": "Jane Smith",
15      "address_line1": "456 Oak Ave",
16      "city": "Los Angeles",
17      "postal_code": "90210",
18      "country_code": "US"
19    },
20    "parcels": [{
21      "weight": 2.5,
22      "weight_unit": "LB"
23    }]
24  }'

Response:

1{
2  "id": "shp_1234567890",
3  "tracking_number": "1234567890123456",
4  "status": "purchased",
5  "label_url": "https://api.karrio.io/v1/documents/label_123.pdf",
6  "selected_rate": {
7    "carrier_name": "fedex",
8    "service": "fedex_ground",
9    "total_charge": 15.99,
10    "currency": "USD"
11  }
12}

3. Track Your Shipment

Shipments are automatically set up for tracking:

1curl -X GET "https://api.karrio.io/v1/shipments/shp_1234567890" \
2  -H "Authorization: Token YOUR_API_KEY"

Data Flow

Shipment Creation Workflow

Common Use Cases

E-commerce Integration

Perfect for online stores needing automated shipping:

  • Order Fulfillment: Automatically create shipments from orders
  • Multi-Warehouse: Route shipments from optimal warehouse locations
  • Rate Shopping: Compare carriers to minimize shipping costs
  • Customer Experience: Provide accurate delivery estimates

Enterprise Shipping

Designed for high-volume enterprise operations:

  • Batch Processing: Process hundreds of shipments simultaneously
  • Carrier Diversification: Distribute volume across multiple carriers
  • SLA Management: Route shipments based on delivery requirements
  • Cost Control: Implement shipping rules and budgets

International Commerce

Handle complex international shipping requirements:

  • Customs Documentation: Automatic customs forms and commercial invoices
  • Duty Calculation: Estimate landed costs for customers
  • Compliance: Validate items against carrier and country restrictions
  • Multi-Currency: Handle pricing in local currencies

Next Steps

Ready to start shipping with Karrio? Explore our detailed documentation:

  1. Live Rates - Learn rate shopping and service selection
  2. Label Generation - Master label creation and formats
  3. International Shipments - Handle customs and compliance
  4. Paperless Trade - Implement electronic documentation

Additional Resources

Need help? Join our community Discord or contact our support team.