Freight Forwarders

Streamline multi-modal logistics with CHRT’s comprehensive API

Freight forwarders coordinate complex shipments between shippers and multiple courier networks. CHRT’s API enables you to manage these multi-party logistics operations efficiently, from organization setup to real-time tracking.

Quick Start

  1. Create Account: Sign up at chrt.com
  2. Get API Access: Contact us to obtain your Bearer token
  3. Set Base URL: Use https://api.chrt.com for production

Core Workflows

Organization Management

Set up your freight forwarding organization and connect with shippers and couriers in your network.

Create Your Organization

1POST /oort/org_profiles/create

View in API Reference →

1{
2  "schema_version": 3,
3  "description": "Professional freight forwarding services specializing in medical logistics and time-critical shipments",
4  "email_address_primary": "operations@fastforwarder.com",
5  "phone_number_primary": "+1-555-0123"
6}

View Available Shippers

Find shippers looking for freight forwarding services:

1GET /oort/connections/connections_info_for_shippers

View in API Reference →

Returns shippers seeking courier partners in your service areas.

View Available Couriers

Find courier networks and their capabilities:

1GET /oort/connections/connections_info_for_couriers

View in API Reference →

Returns courier networks available for partnership and their service capabilities.

List Members of Organization

Manage team members and their roles within your organization:

1GET /orgs/members

View in API Reference →

Returns current organization members with their roles and permissions.

Example Response:

1[
2  {
3    "user_id": "user_abc123",
4    "role": "admin",
5    "role_name": "Administrator",
6    "first_name": "John",
7    "last_name": "Doe"
8  },
9  {
10    "user_id": "user_xyz789",
11    "role": "manager",
12    "role_name": "Operations Manager",
13    "first_name": "Sarah",
14    "last_name": "Smith"
15  }
16]

Order Management

Create and manage complex multi-modal shipments with comprehensive tracking and documentation.

Order Structure Overview

CHRT orders are built with a hierarchical structure optimized for freight forwarding:

  • Order: Top-level container with routing and dispatch information
  • Task Groups: Logical groupings of related operations (e.g., origin handling, transit, destination handling)
  • Tasks: Individual actions within each group (pickup, transfer, delivery, etc.)
  • Cargos: Physical items with detailed specifications
  • Milestones: Proof points and documentation requirements

Create Standard Orders

Basic Order Creation

1POST /oort/orders/create

View in API Reference →

Essential Order Components:

  1. Order Metadata - Basic order information and routing
  2. Task Groups - Organized sequences of operations
  3. Cargo Specifications - Detailed item descriptions and dimensions
  4. Dispatch Configuration - Transport type and courier assignment
  5. Notification Setup - Stakeholder communication preferences

Standard Order Example:

1{
2  "order_client_create": {
3    "schema_version": 1
4  },
5  "task_client_creates_bundle_groupings": [
6    [
7      {
8        "task_client_create": {
9          "schema_version": 1,
10          "action": "pickup",
11          "location": {
12            "type": "Feature",
13            "geometry": {
14              "type": "Point",
15              "coordinates": [-122.4194, 37.7749]
16            },
17            "properties": {
18              "address": "123 Medical Center Dr, San Francisco, CA"
19            }
20          },
21          "primary_point_of_contact_id": "contact_123",
22          "arrive_by": "2024-01-15T10:00:00Z",
23          "arrive_at": "2024-01-15T09:00:00Z",
24          "comments": "Medical equipment pickup - handle with care"
25        },
26        "milestone_client_creates": [
27          {
28            "schema_version": 1,
29            "type": "image",
30            "requestor_comments": "Proof of pickup required"
31          }
32        ],
33        "cargo_client_creates_uuids": ["cargo-uuid-1"],
34        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"]
35      },
36      {
37        "task_client_create": {
38          "schema_version": 1,
39          "action": "deliver",
40          "location": {
41            "type": "Feature",
42            "geometry": {
43              "type": "Point",
44              "coordinates": [-118.2437, 34.0522]
45            },
46            "properties": {
47              "address": "456 Hospital Way, Los Angeles, CA"
48            }
49          },
50          "primary_point_of_contact_id": "contact_789",
51          "arrive_by": "2024-01-15T18:00:00Z",
52          "arrive_at": "2024-01-15T17:00:00Z",
53          "comments": "Temperature-sensitive delivery"
54        },
55        "milestone_client_creates": [
56          {
57            "schema_version": 1,
58            "type": "signature",
59            "requestor_comments": "Delivery confirmation required"
60          }
61        ],
62        "cargo_client_creates_uuids": ["cargo-uuid-1"],
63        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"]
64      }
65    ]
66  ],
67  "cargo_client_creates_map": {
68    "cargo-uuid-1": {
69      "schema_version": 1,
70      "cargo_type": "medical_devices",
71      "quantity": 2,
72      "weight_pounds": 45.5,
73      "length_inches": 24,
74      "width_inches": 18,
75      "height_inches": 12
76    }
77  },
78  "order_created_by_type": "shipper",
79  "order_dispatch_type": "dtc",
80  "transport_type": "ground_only",
81  "shipper_org_id": "org_abc123",
82  "shipper_user_id": "user_xyz789",
83  "courier_org_id": "org_def456"
84}

Order Configuration Options

Dispatch Types:

  • dtc (Direct to Customer) - Direct delivery to end recipient
  • ff (Freight Forwarder) - Handoff to freight forwarder for further routing
  • self (Self-service) - Self-managed logistics

Transport Types:

  • ground_only - Road transportation only
  • passenger_flight - Commercial passenger flight
  • cargo_flight - Dedicated cargo flight
  • chartered_flight - Private chartered flight
  • onboard_courier - Courier accompanies cargo

Cargo Classification:

  • medical_devices - Medical equipment and devices
  • pharmaceuticals - Temperature-sensitive medications
  • lab_specimen - Lab samples requiring special handling
  • organ - Transplant organs with time-critical delivery
  • tissue - Biological tissue samples
  • blood - Blood products and components
  • perishable - Time-sensitive perishable goods
  • frozen - Frozen goods requiring temperature control
  • hazardous_materials - Materials requiring special permits
  • manufacturing_equipment - Industrial machinery
  • aircraft_parts - Aviation components requiring certified handling
  • electronics - Sensitive electronic devices
  • documents - Important legal or business documents
  • spare_parts - Replacement parts and components
  • chemicals - Chemical products requiring special handling

Task Actions for Freight Forwarding

Primary Actions:

  • pickup - Initial collection from origin location
  • deliver - Final delivery to destination
  • transfer - Handoff between carriers or modes
  • consolidate - Combine multiple shipments
  • tender - Hand over to another party
  • recover - Retrieve from temporary storage
  • hold - Temporarily store cargo
  • other - Custom action

Milestone Types for Documentation

Proof of Service:

  • image - Photo documentation
  • signature - Signature collection
  • barcode_scan - Barcode scanning
  • qr_code_scan - QR code scanning

Status Tracking:

  • user_action - Manual user action
  • detected_by_app - Automatic app detection
  • order_in_progress - Order status milestone
  • other - Custom milestone

Order Response and Tracking

Order Creation Response:

1{
2  "order_id": "order_123456789",
3  "order_short_id": "ORD-2024-001"
4}

Key Tracking Identifiers:

  • order_id - Unique system identifier
  • order_short_id - Human-readable reference
  • task_group_ids - Task group references
  • task_ids - Individual task references
  • milestone_ids - Milestone references

Multistop Orders & Flight Management

Handle complex multistop scenarios including air freight, NFO (Next Flight Out), and OBC (On-Board Courier) services with comprehensive tracking and documentation.

Air Freight Service Types

Service Classification:

  1. Standard Air Freight - Regular scheduled cargo service
  2. NFO (Next Flight Out) - Expedited service on next available flight
  3. OBC (On-Board Courier) - Dedicated courier accompanies shipment
  4. Chartered Flight - Private aircraft for exclusive use

NFO (Next Flight Out) Orders

Service Overview:

  • Time-critical shipments requiring immediate air transport
  • Priority handling and expedited processing
  • Real-time flight tracking and status updates
  • Ideal for: Medical emergencies, urgent parts, time-sensitive documents

NFO Order Configuration:

1{
2  "order_client_create": {
3    "schema_version": 1
4  },
5  "task_client_creates_bundle_groupings": [
6    [
7      {
8        "task_client_create": {
9          "schema_version": 1,
10          "action": "pickup",
11          "location": {
12            "type": "Feature",
13            "geometry": {
14              "type": "Point",
15              "coordinates": [-122.4194, 37.7749]
16            },
17            "properties": {
18              "address": "123 Medical Center Dr, San Francisco, CA"
19            }
20          },
21          "primary_point_of_contact_id": "contact_123",
22          "arrive_by": "2024-01-15T10:00:00Z",
23          "arrive_at": "2024-01-15T09:00:00Z",
24          "comments": "NFO pickup - urgent medical equipment"
25        },
26        "milestone_client_creates": [
27          {
28            "schema_version": 1,
29            "type": "image",
30            "requestor_comments": "Proof of pickup required"
31          }
32        ],
33        "cargo_client_creates_uuids": ["cargo-uuid-1"],
34        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"],
35        "flight_number": "UA123"
36      },
37      {
38        "task_client_create": {
39          "schema_version": 1,
40          "action": "transfer",
41          "location": {
42            "type": "Feature",
43            "geometry": {
44              "type": "Point",
45              "coordinates": [-122.4194, 37.7749]
46            },
47            "properties": {
48              "address": "SFO Airport, Terminal 1"
49            }
50          },
51          "primary_point_of_contact_id": "contact_456",
52          "arrive_by": "2024-01-15T11:30:00Z",
53          "arrive_at": "2024-01-15T11:00:00Z",
54          "comments": "Airport transfer for NFO flight UA123"
55        },
56        "milestone_client_creates": [
57          {
58            "schema_version": 1,
59            "type": "image",
60            "requestor_comments": "Airport handoff confirmation"
61          }
62        ],
63        "cargo_client_creates_uuids": ["cargo-uuid-1"],
64        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"],
65        "flight_number": "UA123"
66      },
67      {
68        "task_client_create": {
69          "schema_version": 1,
70          "action": "tender",
71          "location": {
72            "type": "Feature",
73            "geometry": {
74              "type": "Point",
75              "coordinates": [-118.2437, 34.0522]
76            },
77            "properties": {
78              "address": "LAX Airport, Terminal 2"
79            }
80          },
81          "primary_point_of_contact_id": "contact_789",
82          "arrive_by": "2024-01-15T13:30:00Z",
83          "arrive_at": "2024-01-15T13:00:00Z",
84          "comments": "Airport pickup from NFO flight UA123"
85        },
86        "milestone_client_creates": [
87          {
88            "schema_version": 1,
89            "type": "image",
90            "requestor_comments": "Airport pickup confirmation"
91          }
92        ],
93        "cargo_client_creates_uuids": ["cargo-uuid-1"],
94        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"],
95        "flight_number": "UA123"
96      },
97      {
98        "task_client_create": {
99          "schema_version": 1,
100          "action": "deliver",
101          "location": {
102            "type": "Feature",
103            "geometry": {
104              "type": "Point",
105              "coordinates": [-118.2437, 34.0522]
106            },
107            "properties": {
108              "address": "456 Hospital Way, Los Angeles, CA"
109            }
110          },
111          "primary_point_of_contact_id": "contact_012",
112          "arrive_by": "2024-01-15T15:00:00Z",
113          "arrive_at": "2024-01-15T14:30:00Z",
114          "comments": "Final delivery from NFO service"
115        },
116        "milestone_client_creates": [
117          {
118            "schema_version": 1,
119            "type": "signature",
120            "requestor_comments": "Delivery confirmation required"
121          }
122        ],
123        "cargo_client_creates_uuids": ["cargo-uuid-1"],
124        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"]
125      }
126    ]
127  ],
128  "cargo_client_creates_map": {
129    "cargo-uuid-1": {
130      "schema_version": 1,
131      "cargo_type": "medical_devices",
132      "quantity": 1,
133      "weight_pounds": 25.0,
134      "length_inches": 18,
135      "width_inches": 12,
136      "height_inches": 8
137    }
138  },
139  "order_created_by_type": "shipper",
140  "order_dispatch_type": "ff",
141  "transport_type": "passenger_flight",
142  "shipper_org_id": "org_abc123",
143  "shipper_user_id": "user_xyz789",
144  "courier_org_id": "org_def456"
145}

OBC (On-Board Courier) Orders

Service Overview:

  • High-value, time-critical shipments with dedicated courier
  • Hand-carry service for maximum security
  • Continuous chain of custody throughout transit
  • Ideal for: High-value items, organs, sensitive documents, cash

OBC Order Configuration:

1{
2  "order_client_create": {
3    "schema_version": 1
4  },
5  "task_client_creates_bundle_groupings": [
6    [
7      {
8        "task_client_create": {
9          "schema_version": 1,
10          "action": "pickup",
11          "location": {
12            "type": "Feature",
13            "geometry": {
14              "type": "Point",
15              "coordinates": [-122.4194, 37.7749]
16            },
17            "properties": {
18              "address": "123 Medical Center Dr, San Francisco, CA"
19            }
20          },
21          "primary_point_of_contact_id": "contact_123",
22          "arrive_by": "2024-01-15T10:00:00Z",
23          "arrive_at": "2024-01-15T09:00:00Z",
24          "comments": "OBC pickup - dedicated courier service"
25        },
26        "milestone_client_creates": [
27          {
28            "schema_version": 1,
29            "type": "image",
30            "requestor_comments": "OBC pickup confirmation"
31          }
32        ],
33        "cargo_client_creates_uuids": ["cargo-uuid-1"],
34        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"],
35        "flight_number": "AA456"
36      },
37      {
38        "task_client_create": {
39          "schema_version": 1,
40          "action": "consolidate",
41          "location": {
42            "type": "Feature",
43            "geometry": {
44              "type": "Point",
45              "coordinates": [-122.4194, 37.7749]
46            },
47            "properties": {
48              "address": "SFO Airport, Terminal 1"
49            }
50          },
51          "primary_point_of_contact_id": "contact_456",
52          "arrive_by": "2024-01-15T11:30:00Z",
53          "arrive_at": "2024-01-15T11:00:00Z",
54          "comments": "OBC airport consolidation"
55        },
56        "milestone_client_creates": [
57          {
58            "schema_version": 1,
59            "type": "image",
60            "requestor_comments": "OBC airport handoff"
61          }
62        ],
63        "cargo_client_creates_uuids": ["cargo-uuid-1"],
64        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"],
65        "flight_number": "AA456"
66      },
67      {
68        "task_client_create": {
69          "schema_version": 1,
70          "action": "recover",
71          "location": {
72            "type": "Feature",
73            "geometry": {
74              "type": "Point",
75              "coordinates": [-118.2437, 34.0522]
76            },
77            "properties": {
78              "address": "LAX Airport, Terminal 2"
79            }
80          },
81          "primary_point_of_contact_id": "contact_789",
82          "arrive_by": "2024-01-15T13:30:00Z",
83          "arrive_at": "2024-01-15T13:00:00Z",
84          "comments": "OBC airport recovery"
85        },
86        "milestone_client_creates": [
87          {
88            "schema_version": 1,
89            "type": "image",
90            "requestor_comments": "OBC airport pickup"
91          }
92        ],
93        "cargo_client_creates_uuids": ["cargo-uuid-1"],
94        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"],
95        "flight_number": "AA456"
96      },
97      {
98        "task_client_create": {
99          "schema_version": 1,
100          "action": "deliver",
101          "location": {
102            "type": "Feature",
103            "geometry": {
104              "type": "Point",
105              "coordinates": [-118.2437, 34.0522]
106            },
107            "properties": {
108              "address": "456 Hospital Way, Los Angeles, CA"
109            }
110          },
111          "primary_point_of_contact_id": "contact_012",
112          "arrive_by": "2024-01-15T15:00:00Z",
113          "arrive_at": "2024-01-15T14:30:00Z",
114          "comments": "OBC final delivery"
115        },
116        "milestone_client_creates": [
117          {
118            "schema_version": 1,
119            "type": "signature",
120            "requestor_comments": "OBC delivery confirmation"
121          }
122        ],
123        "cargo_client_creates_uuids": ["cargo-uuid-1"],
124        "email_addresses": ["shipper@company.com", "forwarder@logistics.com"]
125      }
126    ]
127  ],
128  "cargo_client_creates_map": {
129    "cargo-uuid-1": {
130      "schema_version": 1,
131      "cargo_type": "organ",
132      "quantity": 1,
133      "weight_pounds": 5.0,
134      "length_inches": 12,
135      "width_inches": 8,
136      "height_inches": 6
137    }
138  },
139  "order_created_by_type": "shipper",
140  "order_dispatch_type": "ff",
141  "transport_type": "onboard_courier",
142  "shipper_org_id": "org_abc123",
143  "shipper_user_id": "user_xyz789",
144  "courier_org_id": "org_def456"
145}

Flight Management Features

Task Actions for Flight Operations:

  • pickup - Initial collection from origin
  • transfer - Handoff at airport/terminal
  • consolidate - Combine shipments for flight
  • tender - Airport pickup from flight
  • recover - Retrieve from temporary storage
  • deliver - Final delivery to destination

Flight Information Management:

  • Include flight_number in task comments for tracking
  • Use arrive_by and arrive_at for flight timing
  • Set up milestone notifications for flight status updates
  • Configure real-time flight tracking alerts

Best Practices for Flight Management

1. Flight Tracking & Monitoring

  • Monitor flight status in real-time through API endpoints
  • Set up automated notifications for delays or cancellations
  • Have backup flight options ready for critical shipments
  • Track weather conditions and airport status

2. Documentation & Compliance

  • Ensure all customs documentation is complete and accurate
  • Verify cargo declarations and permits before departure
  • Maintain chain of custody records throughout transit
  • Prepare contingency documentation for delays

3. Timing Coordination

  • Allow sufficient buffer time for airport transfers (minimum 2-3 hours)
  • Coordinate with ground transportation at both origin and destination
  • Plan for customs clearance time at international destinations
  • Account for time zone differences in scheduling

4. Communication & Escalation

  • Keep all stakeholders informed of flight status changes
  • Provide real-time updates during transit via milestone notifications
  • Establish clear escalation procedures for exceptions and delays
  • Maintain contact information for all parties involved

5. Risk Management

  • Implement temperature monitoring for sensitive cargo
  • Set up insurance coverage for high-value shipments
  • Establish backup courier networks for critical routes
  • Monitor security requirements for sensitive destinations

Tracking & Monitoring

Monitor shipments across your entire network with comprehensive tracking data.

View All Orders (Basic)

1GET /oort/orders/list/by_shipper_org_id

View in API Reference →

Returns basic order information for quick overview.

View All Orders (Detailed)

1GET /oort/orders/list/by_shipper_org_id/full

View in API Reference →

Returns complete order details including:

  • Task groups and individual tasks
  • Milestone tracking with timestamps
  • Driver and vehicle information
  • Real-time location updates

Get Specific Order Details

1GET /oort/orders/{order_id_or_short_id}/full

View in API Reference →

Get comprehensive tracking data for customer updates and exception handling.

View Orders by Courier

1GET /oort/orders/list/by_courier_org_id

View in API Reference →

Monitor orders assigned to specific courier networks.

Task Management

Manage the execution of orders through task groups and milestones.

View Task Groups by Courier

1GET /oort/task_groups/list/by_courier_org_id

View in API Reference →

Get task groups with their tasks for a specific courier.

View Task Groups (Detailed)

1GET /oort/task_groups/list/by_courier_org_id/full

View in API Reference →

Get task groups with tasks, milestones, and cargo details.

Update Task Groups

1POST /oort/task_groups/update

View in API Reference →

Update task status and progress as shipments move through your network.

Milestone Tracking

Track progress and provide proof of delivery through milestones.

Update Milestones

1POST /oort/milestones/update

View in API Reference →

Update delivery progress with milestone types:

  • pickup_arrival - Driver arrives at pickup location
  • pickup_complete - Cargo loaded and secured
  • in_transit - En route to destination
  • delivery_arrival - Driver arrives at delivery location
  • delivery_complete - Cargo delivered successfully

Upload Proof of Delivery

1POST /oort/milestones/upload_image/{milestone_id}

View in API Reference →

Upload photos for:

  • Signature confirmations
  • Cargo condition documentation
  • Delivery location verification
  • Incident reports

Retrieve Delivery Documentation

1GET /oort/milestones/images

View in API Reference →

Access uploaded proof of delivery documentation.

Notification Management

Configure comprehensive notification preferences to keep all stakeholders informed with automated updates across multiple channels.

Notification Channels

CHRT supports four notification channels for maximum flexibility:

  • Email - Detailed notifications with documentation and tracking links
  • SMS - Urgent updates for time-critical events
  • Push - Real-time mobile notifications for immediate awareness
  • Phone Call - Voice notifications for critical exceptions

Task Actions for Notifications

Configure notifications for specific task actions:

Standard Actions:

  • pickup - Cargo pickup events
  • deliver - Delivery completion
  • transfer - Cargo handoffs between parties
  • consolidate - Shipment consolidation
  • tender - Cargo tendering to carriers
  • recover - Cargo recovery from storage
  • hold - Cargo placed on hold
  • other - Custom actions

Advanced Air Freight Actions (OBC/NFO):

  • Flight Operations - cargo_booked_with_airline, flight_checkin_completed
  • Airport Handling - courier_arrived_at_airport, courier_thru_security
  • Flight Tracking - courier_boarded_flight_1, flight_1_departed, flight_1_arrived
  • Customs & Recovery - courier_thru_customs, courier_recovered_cargo

Get Current Notification Preferences

1GET /oort/notification_preferences/by_org_id

View in API Reference →

Returns current notification configuration for your organization.

Configure Notification Preferences

1POST /oort/notification_preferences/create

View in API Reference →

Comprehensive Notification Configuration:

1{
2  "schema_version": 1,
3  "email_addresses": [
4    "operations@forwarder.com",
5    "dispatch@forwarder.com",
6    "customer@shipper.com"
7  ],
8  "sms_phone_numbers": [
9    "+1-555-0123",
10    "+1-555-0456"
11  ],
12  "voice_phone_numbers": [
13    "+1-555-0123"
14  ],
15  "preferences": {
16    "pickup": ["email", "sms"],
17    "deliver": ["email", "sms", "push"],
18    "transfer": ["email"],
19    "consolidate": ["email"],
20    "tender": ["email", "sms"],
21    "recover": ["email"],
22    "hold": ["email", "sms"],
23    "other": ["email"]
24  }
25}

Task-Level Notification Overrides

Specify notification recipients for individual tasks during order creation:

1{
2  "task_client_creates_bundle_groupings": [
3    [
4      {
5        "task_client_create": {
6          "action": "pickup",
7          "location": { /* location details */ },
8          "primary_point_of_contact_id": "contact_123",
9          "arrive_by": "2024-01-15T10:00:00Z",
10          "arrive_at": "2024-01-15T09:00:00Z",
11          "comments": "Urgent medical equipment pickup"
12        },
13        "email_addresses": [
14          "shipper@company.com",
15          "forwarder@logistics.com",
16          "emergency@hospital.com"
17        ],
18        "milestone_client_creates": [
19          {
20            "schema_version": 1,
21            "type": "image",
22            "requestor_comments": "Proof of pickup required"
23          }
24        ]
25      }
26    ]
27  ]
28}

Notification Best Practices

Channel Selection Strategy:

  • SMS - Use for urgent events (pickup, delivery, exceptions)
  • Email - Use for detailed updates and documentation
  • Push - Use for real-time mobile notifications
  • Voice - Use for critical exceptions requiring immediate attention

Configuration Recommendations:

  1. Multiple Recipients - Include backup contacts for redundancy
  2. Action-Specific Channels - Match urgency to notification method
  3. Task-Level Overrides - Use for specific stakeholders or urgent shipments
  4. Regular Updates - Keep contact information current as teams change

Example Configuration for Medical Logistics:

1{
2  "schema_version": 1,
3  "email_addresses": [
4    "logistics@medical.com",
5    "dispatch@forwarder.com",
6    "emergency@hospital.com"
7  ],
8  "sms_phone_numbers": [
9    "+1-555-0123",
10    "+1-555-0456"
11  ],
12  "voice_phone_numbers": [
13    "+1-555-0123"
14  ],
15  "preferences": {
16    "pickup": ["email", "sms"],
17    "deliver": ["email", "sms", "push"],
18    "transfer": ["email", "sms"],
19    "consolidate": ["email"],
20    "tender": ["email", "sms"],
21    "recover": ["email", "sms"],
22    "hold": ["email", "sms", "voice"],
23    "other": ["email"]
24  }
25}

Advanced Features

Multi-Modal Logistics

For complex routes involving multiple transport modes:

  1. Create order segments for each transport mode (ground, air, ocean)
  2. Use task groups to organize sequential operations and transfers
  3. Set up milestone notifications at critical transfer points
  4. Monitor each segment independently for optimal visibility
  5. Coordinate timing between different carriers and modes

Specialized Cargo Handling

Temperature-Controlled Shipments:

  • Use cargo_type: "pharmaceuticals" or "frozen"
  • Include temperature requirements in task comments
  • Set up milestone notifications for temperature alerts
  • Monitor cold chain compliance throughout transit

Hazardous Materials:

  • Use cargo_type: "hazardous_materials"
  • Ensure proper documentation and permits
  • Configure immediate notifications for incidents
  • Verify courier certifications for hazmat transport

High-Value Items:

  • Use detailed cargo descriptions and accurate dimensions
  • Set up frequent milestone updates for security
  • Configure multi-channel notifications for all parties
  • Consider insurance requirements and documentation

SDKs & Integration

Use our official SDKs for faster integration:

TypeScript:

$npm i -s @chrt-inc/typescript-sdk

See our SDK documentation for detailed examples and advanced configuration options.

Best Practices

  1. Always specify accurate cargo dimensions for proper capacity planning and cost optimization
  2. Use detailed contact information for each organization to ensure smooth communications
  3. Set up proactive notifications for all stakeholders to reduce inquiries and improve transparency
  4. Monitor order status regularly using full order endpoints for complete visibility
  5. Keep organization information updated as contacts and capabilities change
  6. Coordinate timing carefully for multi-modal shipments to avoid delays and additional costs
  7. Document special requirements clearly in task comments for proper handling
  8. Establish clear escalation procedures for exceptions and delays

Support

Need help with a specific integration? Contact our support team.