📖 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.

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

Shipment Management Dashboard

Rate comparison interface with carrier options and pricing

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.