La API de Turboenvíos es una API REST que permite a los clientes cotizar y generar envíos de paquetes. Es necesario contar con un token de autenticación para poder utilizarla. Comunícate con el equipo de soporte para obtener más información.
Todas las peticiones a la API deben incluir un token de autenticación en la cabecera de la petición y especificar el tipo de contenido.
Esta operación se utiliza para obtener el costo de envío de un paquete proporcionando la información del origen, destino y dimensiones. Es necesario contar con una cotización para poder generar un envío. La cotización solo es válida en el día que se generó y solo puede ser utilizada una vez.
{
"origin": "64000",
"destination": "64000",
"weight": 1,
"length": 10,
"width": 20,
"height": 10,
"quantity": 3,
"insurePackage": true,
"satCategory": "53141600",
"packageValue": 150,
"packageType": "box"
}{
"origin": "66119",
"destination": "56337",
"originCountry": "MX",
"destinationCountry": "US",
"weight": 10,
"length": 10,
"width": 10,
"height": 10,
"packageType": "box"
}{
"quotations": [
{
"quotationId": "clsn08cqw0000maxbg761733a",
"costCents": 12700,
"costFormatted": "$127.00",
"currency": "MXN",
"provider": "FEDEX",
"service": "Fedex Express Saver",
"code": "FEDEX_EXPRESS_SAVER",
"description": "3-7 días"
},
{
"quotationId": "clsn0a5tq0000maxb9qtq0f2l",
"costCents": 15600,
"costFormatted": "$156.00",
"currency": "MXN",
"provider": "FEDEX",
"service": "Standard Overnight",
"code": "STANDARD_OVERNIGHT",
"description": "1-2 días"
}
]
}Esta operación se utiliza para generar un envío a partir de una cotización. Si la cotización se creó con quantity, el envío usará esa misma cantidad de paquetes.
{
"quotationId": "clsn0o5v70000maxb509v80dy",
"sender": {
"name": "Juan Pérez",
"phone": "8112345678",
"email": "juanperez@ejemplo.com",
"businessName": "Juan Pérez S.A. de C.V.",
"country": "MX",
"state": "Nuevo León",
"city": "Monterrey",
"neighborhood": "Santa María",
"street": "Blvd. Antonio L. Rodríguez",
"number": "1888",
"references": "Frente a la Coca Cola"
},
"recipient": {
"name": "María López",
"phone": "8112345678",
"email": "marialopez@ejemplo.com",
"businessName": "María López S.A. de C.V.",
"country": "MX",
"state": "Nuevo León",
"city": "Monterrey",
"neighborhood": "Obispado",
"street": "Av. Constitución",
"number": "2050 P. 38",
"references": "Letrero Hilton Garden Inn"
},
"package": {
"description": "Cargador",
"satCategory": "43211600",
"type": "envelope"
}
}{
"success": true,
"data": {
"orderId": "clsn19b1p0000maxb18vz7jov",
"amountPaidCents": 18500,
"trackingNumber": "1234567890",
"trackingUrl": "https://www.fedex.com/track?tracknumbers=1234567890",
"labelUrl": "https://app.turboenvios.mx/api/v1/shipment/clsn19b1p0000maxb18vz7jov/label",
"labelBase64": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAB..."
}
}Esta operación crea una solicitud de recolección para un envío existente. El orderId se obtiene de la respuesta al crear un envío.
{
"orderId": "clsn19b1p0000maxb18vz7jov",
"pickupDate": "2026-01-22",
"startTimeHour": 8,
"startTimeMinute": 0,
"endTimeHour": 18,
"endTimeMinute": 0,
"specialInstructions": "Tocar el timbre principal."
}{
"success": true,
"data": {
"pickupRequestId": "clsn1v2rm0000maxb1k5m3f8q",
"status": "pending"
}
}Obtén la información principal de una recolección existente.
{
"success": true,
"data": {
"id": "clsn1v2rm0000maxb1k5m3f8q",
"status": "pending",
"providerConfirmationId": null,
"pickupDateLocal": "2026-01-22",
"preferredStartTimeLocal": "08:00:00",
"preferredEndTimeLocal": "18:00:00",
"orderShipment": {
"externalTrackingId": "1234567890",
"shippingServiceCarrier": "DHL",
"shippingServiceName": "Express",
"latestTrackingStatus": "GUIA_CREADA"
}
}
}Utiliza este servicio para consultar el saldo disponible para la cuenta asociada a la API key.
{
"success": true,
"data": {
"credits": {
"cents": 12345,
"formatted": "$123.45"
}
}
}Este servicio se utiliza para rastrear un envío a partir de su número de rastreo/tracking. El servicio tiene un cache de 4 horas por lo que se recomienda no solicitar el mismo número de tracking más de una vez en un lapso de tiempo menor a 4 horas ya que no se garantiza que la información sea actual.
Los posibles valores para el status son:
| Status | Descripción |
|---|---|
| GUIA_CREADA | Guia Generada |
| RECOLECTADO | Recolectado |
| EN_TRANSITO | En Tránsito |
| INTENTO_DE_ENTREGA | Intento de Entrega |
| EN_OCURRE | En Ocurre |
| ENTREGADO | Entregado |
| INCIDENTE | Incidente |
| RETORNADO | Retornado |
| DESCONOCIDO | Estado Desconocido |
{
"orderId": "cma8ptth50000o3350xqmdmi1",
"trackingNumber": "1234567890",
"carrier": "DHL",
"latestStatus": {
"date": "2025-05-03 10:49:47",
"status": "ENTREGADO",
"carrierTrackingCode": "OK",
"carrierDescription": "Envío entregado"
},
"history": [
{
"date": "2025-05-02 14:53:15",
"status": "RECOLECTADO",
"carrierTrackingCode": "PU",
"carrierDescription": "Envío retirado/recolectado."
},
{
"date": "2025-05-02 21:05:10",
"status": "EN_TRANSITO",
"carrierTrackingCode": "PL",
"carrierDescription": "Procesado en MEXICO CITY-MEXICO"
},
{
"date": "2025-05-02 21:05:58",
"status": "EN_TRANSITO",
"carrierTrackingCode": "DF",
"carrierDescription": "El envío ha salido de un centro de DHL MEXICO CITY-MEXICO"
},
{
"date": "2025-05-02 21:41:13",
"status": "EN_TRANSITO",
"carrierTrackingCode": "AF",
"carrierDescription": "Llegada al centro de clasificación de DHL HANGARES-MEXICO"
},
{
"date": "2025-05-03 00:44:42",
"status": "EN_TRANSITO",
"carrierTrackingCode": "PL",
"carrierDescription": "Procesado en HANGARES-MEXICO"
},
{
"date": "2025-05-03 01:12:58",
"status": "EN_TRANSITO",
"carrierTrackingCode": "DF",
"carrierDescription": "El envío ha salido de un centro de DHL HANGARES-MEXICO"
},
{
"date": "2025-05-03 09:08:19",
"status": "EN_TRANSITO",
"carrierTrackingCode": "AR",
"carrierDescription": "Llegada al centro de entrega de DHL ACAPULCO-MEXICO"
},
{
"date": "2025-05-03 10:28:08",
"status": "EN_TRANSITO",
"carrierTrackingCode": "WC",
"carrierDescription": "El envío está en manos del courier para su entrega"
},
{
"date": "2025-05-03 10:49:47",
"status": "ENTREGADO",
"carrierTrackingCode": "OK",
"carrierDescription": "Envío entregado"
}
]
}