Skip to main content
POST
https://api.crbtrack.com
/
api
/
v1
/
orders
/
create
{
  "idempotencyKey": "order-2024-12-001",
  "sender": {
    "fullName": "John Smith",
    "phone": "+1 305-555-0123",
    "email": "[email protected]",
    "address": {
      "line1": "1234 Shipping Way",
      "city": "Miami",
      "state": "FL",
      "zipCode": "33101",
      "country": "US"
    }
  },
  "receiver": {
    "fullName": "María García",
    "phone": "+593 99 123 4567",
    "email": "[email protected]",
    "nationalId": "1234567890",
    "idType": "cedula",
    "address": {
      "line1": "Av. 9 de Octubre 123",
      "city": "Guayaquil",
      "province": "Guayas",
      "zipCode": "090101",
      "country": "EC",
      "deliveryInstructions": "Dejar en recepción"
    }
  },
  "parcelDetails": {
    "weightLbs": 2.5,
    "lengthCm": 30,
    "widthCm": 20,
    "heightCm": 15,
    "declaredValue": 149.99,
    "currency": "USD"
  },
  "customsInfo": {
    "description": "Electronics - Phone Accessories",
    "hsCode": "8517.62"
  },
  "products": [
    {
      "description": "Phone Case",
      "quantity": 2,
      "unitFobValue": 25.00,
      "sku": "CASE-001"
    },
    {
      "description": "Screen Protector",
      "quantity": 3,
      "unitFobValue": 33.33,
      "sku": "PROT-002"
    }
  ]
}
{
  "success": true,
  "parcel": {
    "id": "cl123abc456def",
    "trackingNumber": "CBECUSD123456789",
    "status": "LABEL_GENERATED",
    "labelUrl": "https://labels.crbtrack.com/CBECUSD123456789.pdf",
    "createdAt": "2024-12-21T10:30:00Z"
  }
}
Creates a new parcel order with sender and receiver information. Upon success, a tracking number is assigned and a shipping label is generated.

Request Body

idempotencyKey
string
required
Unique key (8-64 characters) to prevent duplicate orders. Use your order ID or a UUID.Requests with the same key within 24 hours return the original response.
trackingNumber
string
Optional custom tracking number (10-30 characters). If not provided, the system generates one automatically.
externalOrderId
string
Your internal order ID for reference (max 100 characters).
customerReference
string
Customer-facing reference number (max 100 characters).
sender
object
required
Sender (shipper) information.
receiver
object
required
Receiver (consignee) information.
parcelDetails
object
required
Package dimensions and value.
customsInfo
object
Customs declaration information.
products
array
Product line items (for checksum validation).

Response

success
boolean
Whether the request succeeded
parcel
object
The created parcel details
warnings
array
Optional validation warnings (request still succeeds)
{
  "idempotencyKey": "order-2024-12-001",
  "sender": {
    "fullName": "John Smith",
    "phone": "+1 305-555-0123",
    "email": "[email protected]",
    "address": {
      "line1": "1234 Shipping Way",
      "city": "Miami",
      "state": "FL",
      "zipCode": "33101",
      "country": "US"
    }
  },
  "receiver": {
    "fullName": "María García",
    "phone": "+593 99 123 4567",
    "email": "[email protected]",
    "nationalId": "1234567890",
    "idType": "cedula",
    "address": {
      "line1": "Av. 9 de Octubre 123",
      "city": "Guayaquil",
      "province": "Guayas",
      "zipCode": "090101",
      "country": "EC",
      "deliveryInstructions": "Dejar en recepción"
    }
  },
  "parcelDetails": {
    "weightLbs": 2.5,
    "lengthCm": 30,
    "widthCm": 20,
    "heightCm": 15,
    "declaredValue": 149.99,
    "currency": "USD"
  },
  "customsInfo": {
    "description": "Electronics - Phone Accessories",
    "hsCode": "8517.62"
  },
  "products": [
    {
      "description": "Phone Case",
      "quantity": 2,
      "unitFobValue": 25.00,
      "sku": "CASE-001"
    },
    {
      "description": "Screen Protector",
      "quantity": 3,
      "unitFobValue": 33.33,
      "sku": "PROT-002"
    }
  ]
}
{
  "success": true,
  "parcel": {
    "id": "cl123abc456def",
    "trackingNumber": "CBECUSD123456789",
    "status": "LABEL_GENERATED",
    "labelUrl": "https://labels.crbtrack.com/CBECUSD123456789.pdf",
    "createdAt": "2024-12-21T10:30:00Z"
  }
}

Country-Specific Requirements

  • National ID: Required (Cédula or RUC)
  • Postal Code: Must match province
  • Province: Required
  • National ID: RFC optional
  • State: Required
  • Postal Code: 5 digits required
  • National ID: Cédula required
  • City: Must be valid Colombian city