List Shipments
GET
/api/shipments
idFinanJoining with Financial Documents
TripDocument.idFinan to match against FinancialDocument.id to retrievethe invoice and payment details for any shipment.
Shipment Status Reference
| Value | Label | Description |
|---|---|---|
| 1 | Cargado | Loaded — shipment in transit |
| 2 | Descargado | Unloaded — delivery completed |
| 3 | Por Facturar | Pending invoice generation |
| 4 | Facturado | Invoice issued |
| 5 | Pago Parcial | Partially paid |
| 6 | Pagado | Fully paid |
| 7 | Incidente | Incident reported |
| 9 | Cancelado | Cancelled |
Vehicle ID Format
vehicle field uses the format {unit_id}_{tow} where tow is 1 for thefirst tow and
2 for the second (double tow configurations).Product Volume Correction
valueLoadN and valueOffLoadN represent volumes corrected to 20°C standardtemperature, as required for hydrocarbon compliance (Control Volumétrico SAT).
Solicitud
Parámetros de consulta
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.dufrei.com/api/shipments?limit=undefined' \
--header 'x-api-key: <api-key>'Respuesta Ejemplo de Respuesta
200 - Hydrocarbon shipment with volume pricing
[
{
"_id": "699c7b6a884beedd97446875",
"idFinan": "1771848000000_6cfb1",
"client": "KGA150313LM0",
"company": "TEK170407IA0",
"driver": {
"name": "ERIK MOISES TUCUCH ROSENDO"
},
"origin": {
"id": "688",
"nif": "PME380607P35",
"address": {
"street": "Carretera Merida-Uman km 8.5 s/n",
"exNum": "S/N",
"state": "YUC",
"zip": "97150",
"local": "0097",
"region": "050",
"country": "MEX"
}
},
"destination": {
"id": "KemaGasES13354",
"nif": "KGA150313LM0",
"address": {
"street": "Avenida Chichen Itza",
"exNum": "Mz 19, Lote 3-03",
"state": "ROO",
"zip": "77530",
"local": "0259",
"region": "005",
"country": "MEX"
}
},
"shipments": [
{
"id": "0q2n00zkxa7v",
"shipment": "640632",
"date": 260223,
"loadDate": 1771862698,
"offloadDate": 1771899922,
"region": "MX",
"loadTemp": "20°C",
"status": 4,
"vehicle": "FZS3656_1",
"financial": {
"currency": "MXN",
"exchangeRate": 1,
"exchangeRateDate": 1771862698,
"pricingModel": "volume",
"famount": 26785.72,
"tamount": 0,
"price": 0,
"tarif": 0.6282271267
},
"product": [
{
"id": "32035",
"codeHM": "1203",
"code": "15101514",
"desc": "Gasolina regular menor a 91 octanos",
"weight": {
"valueLoad": 29845.9,
"valueOffLoad": 29845.9,
"unit": "KG"
},
"volume": {
"valueLoad": 42637,
"valueLoadN": 42637,
"valueOffLoad": 42637,
"valueOffLoadN": 42637,
"unit": "LTR"
}
}
]
}
]
}
]Modificado en 2026-02-24 05:17:23