Create Order

Create a new fulfillment order in the Chronos system. The recipient's data will be validated for delivery coverage based on the selected package and warehouse.

POST/shipment/create

This endpoint allows you to create a new fulfillment order. You must include the Bearer token obtained previously in the request header.

Headers

Parameter	Type	Required	Description
`Authorization`	string	✅ Yes	Bearer token obtained from /token/generate endpoint
`Content-Type`	string	✅ Yes	Must be application/json
`Accept`	string	✅ Yes	Must be application/json

Body Parameters

Parameter	Type	Required	Description
`unique_order_number`	string	✅ Yes	Identification code provided by the seller (max: 50)
`shipping_service`	string	✅ Yes	Valid values: FEDEX, AFIMEX, UPS, USPS, VENCEDOR OR QUALITYPOST (max: 10)
`invoice`	string	❌ No	Invoice number for the order (max: 45)
`warehouse_id`	integer	✅ Yes	ID of the warehouse from which the order will be fulfilled (max: 10)
`cod`	boolean	✅ Yes	true for Cash on Delivery (COD), false for regular delivery
`consignee`	object	✅ Yes	Customer delivery information
`consignee.name`	string	✅ Yes	Customer's name (avoid accents and special characters) (max: 35)
`consignee.country`	string	✅ Yes	Customer's country (full name, e.g., 'Mexico') (max: 20)
`consignee.state`	string	✅ Yes	Customer's state (must not be abbreviated) (max: 35)
`consignee.municipality`	string	✅ Yes	Customer's municipality (max: 35)
`consignee.neighborhood`	string	✅ Yes	Customer's neighborhood (max: 35)
`consignee.street`	string	✅ Yes	Customer's street (max: 24)
`consignee.external_number`	string	✅ Yes	External number or 's/n' if not available (max: 5)
`consignee.internal_number`	string	❌ No	Internal number (max: 5)
`consignee.zipcode`	string	✅ Yes	5-digit zip code (can start with 0) (max: 5)
`consignee.email`	string	❌ No	Customer's email (format: name@domain.com) (max: 50)
`consignee.phone`	string	✅ Yes	10-digit phone number (max: 10)
`consignee.comments`	string	❌ No	Delivery instructions (avoid quotation marks) (max: 250)
`order_details`	array	✅ Yes	Array of products in the order
`order_details[].quantity`	integer	✅ Yes	Product quantity (max: 10)
`order_details[].sku`	string	✅ Yes	Product SKU (max: 35)
`order_details[].unit_price`	float	✅ Yes	Unit price (can be 0) (max: 5)
`total_price`	float	✅ Yes	Total order amount (recommended for insurance) (max: 5)

Examples

cURL
JavaScript
Python

curl -X POST https://apisandbox.eonwms.com/shipment/create \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "unique_order_number": "ORDER-12345",
  "shipping_service": "FEDEX",
  "invoice": "INV-001",
  "warehouse_id": "1",
  "cod": false,
  "consignee": {
    "name": "John Smith",
    "country": "Mexico",
    "state": "Ciudad de Mexico",
    "municipality": "Benito Juarez",
    "neighborhood": "Del Valle",
    "street": "Insurgentes Sur",
    "external_number": "123",
    "internal_number": "4B",
    "zipcode": "03100",
    "email": "john.smith@email.com",
    "phone": "5512345678",
    "comments": "Deliver to reception"
  },
  "order_details": [
    {
      "quantity": 2,
      "sku": "PROD-001",
      "unit_price": "299.99"
    },
    {
      "quantity": 1,
      "sku": "PROD-002",
      "unit_price": "149.99"
    }
  ],
  "total_price": "749.97"
}'

const orderData = {
unique_order_number: "ORDER-12345",
shipping_service: "FEDEX",
invoice: "INV-001",
warehouse_id: "1",
cod: false,
consignee: {
  name: "John Smith",
  country: "Mexico",
  state: "Ciudad de Mexico",
  municipality: "Benito Juarez",
  neighborhood: "Del Valle",
  street: "Insurgentes Sur",
  external_number: "123",
  internal_number: "4B",
  zipcode: "03100",
  email: "john.smith@email.com",
  phone: "5512345678",
  comments: "Deliver to reception"
},
order_details: [
  {
    quantity: 2,
    sku: "PROD-001",
    unit_price: "299.99"
  },
  {
    quantity: 1,
    sku: "PROD-002",
    unit_price: "149.99"
  }
],
total_price: "749.97"
};

const response = await fetch('https://apisandbox.eonwms.com/shipment/create', {
method: 'POST',
headers: {
  'Authorization': 'Bearer YOUR_TOKEN',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
},
body: JSON.stringify(orderData)
});

const result = await response.json();

import requests

order_data = {
  "unique_order_number": "ORDER-12345",
  "shipping_service": "FEDEX",
  "invoice": "INV-001",
  "warehouse_id": "1",
  "cod": False,
  "consignee": {
      "name": "John Smith",
      "country": "Mexico",
      "state": "Ciudad de Mexico",
      "municipality": "Benito Juarez",
      "neighborhood": "Del Valle",
      "street": "Insurgentes Sur",
      "external_number": "123",
      "internal_number": "4B",
      "zipcode": "03100",
      "email": "john.smith@email.com",
      "phone": "5512345678",
      "comments": "Deliver to reception"
  },
  "order_details": [
      {
          "quantity": 2,
          "sku": "PROD-001",
          "unit_price": "299.99"
      },
      {
          "quantity": 1,
          "sku": "PROD-002",
          "unit_price": "149.99"
      }
  ],
  "total_price": "749.97"
}

response = requests.post(
  'https://apisandbox.eonwms.com/shipment/create',
  headers={
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json',
      'Accept': 'application/json'
  },
  json=order_data
)

result = response.json()

Responses

200Success - Order created

{
"status": "PLACED",
"message": "The order has been successfully created"
}

401Unauthorized - Invalid token

{
"v": "EON_V2.0",
"fault": {
  "arguments": {
    "Authorization": "invalid"
  },
  "type": "InvalidAuthorizationException",
  "message": "The request is unauthorized, the access token is invalid."
}
}

422Unprocessable Entity - Validation error

{
"fault": {
  "error": "validation_error",
  "error_description": "The shipping service is not available for this destination"
}
}

Important Notes

States

The following list shows the accepted values for the "State" parameter when creating orders for Mexico:

Aguascalientes
Baja California
Baja California Sur
Campeche
Coahuila
Colima
Chiapas
Chihuahua
Ciudad de Mexico
Durango
Guanajuato
Guerrero
Hidalgo
Jalisco
Mexico
Michoacan
Morelos
Nayarit
Nuevo Leon
Oaxaca
Puebla
Queretaro
Quintana Roo
San Luis Potosi
Sinaloa
Sonora
Tabasco
Tamaulipas
Tlaxcala
Veracruz
Yucatan
Zacatecas

Address Validation

Avoid accents and special characters in address fields
State names must not be abbreviated
Zip codes must be exactly 5 digits
External number is required (use 's/n' if not available)

Shipping Services

Available shipping services depend on your contract and warehouse location:

Mexico: FEDEX, YEGO, AFIMEX, TIUI, IHS, VENCEDOR
USA: FEDEX, UPS, USPS
International: JTEXPRESS

Contact support to enable additional carriers.

Order Status Flow

After creating an order, it will go through the following status flow:

PLACED - The order has been successfully registered and is waiting to be prepared.
READY - The products assigned to the order have been reserved from inventory and the order is being prepared for shipment.
FULFILLED - The products assigned to the order have been deducted from warehouse inventory.
SEND - The order has been picked up by the assigned carrier and is in transit to its destination.
DELIVERED - The order has been successfully delivered to the recipient.
RETURNED TO CHRONOS (Optional) - The delivery attempt was unsuccessful and the order has been returned to the origin warehouse.

*Between the SEND and DELIVERED/RETURNED TO CHRONOS statuses, different carriers assign a variety of statuses that are displayed in the history with the same value as obtained from the source, so the flow of an order in transit may vary with each case.

You can track the order status using the Get Order Status endpoint.