Despachos
Requiere el permiso customs:read. Devuelve los despachos de tu empresa con los datos de la carátula y los ítems del .RET.
Listar despachos
GET /despachos · listado liviano y paginado, pensado para detectar qué cambió.
| Campo | Tipo | Descripción |
|---|---|---|
| updated_since | fecha ISO 8601 | Solo despachos modificados desde esa fecha, inclusive. |
| limit | entero | 1 a 100. Por defecto 50. |
| cursor | texto opaco | El nextCursor de la página anterior. |
curl -s -H "Authorization: Bearer $MGT_API_KEY" \ "https://mgt.marimpex.com.ar/api/v1/despachos?updated_since=2026-10-01T00:00:00Z&limit=2"
GEThttps://mgt.marimpex.com.ar/api/v1/despachos
Response · application/json200 OK
{
"data": [
{
"despacho": "26001IC04000001A",
"estado": "OFICIALIZADA",
"canal": "VERDE",
"fechaOficializacion": "2026-10-01",
"interno": "100",
"updatedAt": "2026-10-02T14:03:11.000Z",
"tieneRet": true
},
{
"despacho": "26001IC04000002B",
"estado": "PRESENTADA",
"canal": null,
"fechaOficializacion": null,
"interno": null,
"updatedAt": "2026-10-03T09:15:42.000Z",
"tieneRet": false
}
],
"nextCursor": "eyJ1IjoiMjAyNi0xMC0wM1QwOToxNTo0Mi4wMDBaIiwiZCI6IjI2MDAxSUMwNDAwMDAwMkIifQ"
}Campos de cada elemento de data
| Campo | Tipo | Descripción |
|---|---|---|
| despacho | string | Número de destinación. Es el identificador que se usa en el detalle. |
| estado | string | null | Último estado informado por ARCA (por ejemplo OFICIALIZADA). |
| canal | string | null | Canal de selectividad asignado, si ya lo hay. |
| fechaOficializacion | string | null | AAAA-MM-DD. |
| interno | string | null | Número interno de la operación en Marimpex. |
| updatedAt | string | ISO 8601. Última modificación de cualquier dato visible del despacho. Es la llave de la sincronización incremental. |
| tieneRet | boolean | false si todavía no se puede pedir el detalle (409 ret_not_available). |
Un despacho puede aparecer en el listado antes de tener el .RET. En ese caso
tieneRet es false.Detalle de un despacho
GET /despachos/{despacho} · el despacho completo. El número tiene entre 8 y 24 caracteres alfanuméricos.
curl -s -H "Authorization: Bearer $MGT_API_KEY" \ "https://mgt.marimpex.com.ar/api/v1/despachos/26001IC04000001A"
GEThttps://mgt.marimpex.com.ar/api/v1/despachos/26001IC04000001A
Response · application/json200 OK
{
"despacho": "26001IC04000001A",
"subregimen": "IC04",
"tipo": "importacion",
"estado": "OFICIALIZADA",
"canal": "VERDE",
"aduana": {
"codigo": "001",
"nombre": "BUENOS AIRES"
},
"fechaOficializacion": "2026-10-01",
"interno": "100",
"importador": {
"razonSocial": "EMPRESA EJEMPLO SA",
"cuit": "30-00000000-0",
"ivaInscripto": true
},
"despachante": {
"razonSocial": "DESPACHANTE EJEMPLO",
"cuit": "20-00000000-0"
},
"proveedor": "PROVEEDOR EJEMPLO CO",
"transporte": {
"medio": "MARITIMO",
"buque": "BUQUE EJEMPLO",
"bandera": "PANAMA",
"documentoTransporte": "HBL000000",
"fechaArribo": "2026-09-28",
"deposito": "000",
"pesoBrutoKg": 500,
"bultos": 10
},
"valores": {
"incoterm": "FOB",
"divisa": "DOLAR ESTADOUNIDENSE",
"divisaFlete": "DOLAR ESTADOUNIDENSE",
"divisaSeguro": "DOLAR ESTADOUNIDENSE",
"fob": 1000.5,
"flete": 100,
"seguro": 10,
"valorEnAduanaCif": 1110.5,
"monedaValorEnAduanaCif": "USD",
"cotizacion": 900
},
"items": [
{
"nro": "1",
"posicionSim": "7318.15.00.000A",
"descripcion": "TORNILLOS",
"paisOrigen": "CHINA",
"cantidad": 100,
"fobDolar": 1000.5,
"fobDivisa": 1000.5,
"fobDivisaCodigo": "DOLAR ESTADOUNIDENSE",
"valorEnAduanaCif": 1110.5,
"moneda": "USD",
"liquidacion": [
{
"concepto": "010",
"nombre": "Derechos de Importación",
"alicuota": 14,
"monto": 155.47,
"moneda": "USD"
}
]
}
],
"totales": {
"totalPagado": 155.47,
"totalGarantizado": null,
"moneda": "USD"
}
}Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| despacho | string | Número de destinación. |
| subregimen | string | null | Subrégimen que surge del número (por ejemplo IC04). |
| tipo | "importacion" | "exportacion" | null | Se deduce del subrégimen. |
| estado | string | null | Último estado informado. |
| canal | string | null | Canal de selectividad. |
| aduana | { codigo, nombre } | null | Aduana de oficialización. |
| fechaOficializacion | string | null | AAAA-MM-DD. |
| interno | string | null | Número interno de Marimpex. |
| importador | { razonSocial, cuit, ivaInscripto } | null | Tu propia empresa, tal como figura en la destinación. cuit e ivaInscripto pueden ser null. |
| despachante | { razonSocial, cuit } | Despachante de aduana que presentó la destinación. |
| proveedor | string | null | Vendedor o comprador del exterior. |
| transporte.medio | string | null | Medio de transporte (por ejemplo MARITIMO). |
| transporte.buque | string | null | Matrícula o nombre del medio de transporte. |
| transporte.bandera | string | null | País de la bandera. |
| transporte.documentoTransporte | string | null | Número de guía o documento de transporte. |
| transporte.fechaArribo | string | null | AAAA-MM-DD. |
| transporte.deposito | string | null | Código del depósito. |
| transporte.pesoBrutoKg | number | null | Peso bruto total, en kilos. |
| transporte.bultos | number | null | Cantidad de bultos. |
| valores.incoterm | string | null | Condición de venta. |
| valores.divisa | string | null | Divisa de valores.fob. |
| valores.divisaFlete | string | null | Divisa de valores.flete (puede ser distinta de la del FOB). |
| valores.divisaSeguro | string | null | Divisa de valores.seguro (puede ser distinta de la del FOB). |
| valores.fob | number | null | Valor FOB total, en valores.divisa. |
| valores.flete | number | null | Flete, en valores.divisaFlete. |
| valores.seguro | number | null | Seguro, en valores.divisaSeguro. |
| valores.valorEnAduanaCif | number | null | Valor en aduana (CIF) total, en dólares. Sale de la carátula o, si no está, de la suma de los ítems. Es null si el .RET no trae el dato en dólares. |
| valores.monedaValorEnAduanaCif | "USD" | Moneda de valores.valorEnAduanaCif. |
| valores.cotizacion | number | null | Pesos por dólar usados para los pagos. |
| items[] | array | Un elemento por ítem de la destinación (ver abajo). |
| totales.totalPagado | number | null | Total de tributos a pagar, en la moneda de totales.moneda (dólares). Para estimar los pesos, multiplicalo por valores.cotizacion; el pago real se hace en pesos al tipo de cambio del día. |
| totales.totalGarantizado | number | null | Total garantizado, en la moneda de totales.moneda. |
| totales.moneda | "USD" | Moneda de totalPagado y totalGarantizado. |
Campos de cada ítem
| Campo | Tipo | Descripción |
|---|---|---|
| nro | string | Número de ítem. |
| posicionSim | string | Posición arancelaria SIM (NCM con sufijo del sistema). |
| descripcion | string | null | Descripción de la mercadería. Puede ser null. |
| paisOrigen | string | null | País de origen. |
| cantidad | number | null | Cantidad declarada. |
| fobDolar | number | null | FOB del ítem, en dólares. Es null si el .RET no trae el dato en dólares: nunca se reemplaza por un valor en otra moneda. |
| fobDivisa | number | null | FOB del ítem en la divisa de la operación (fobDivisaCodigo). |
| fobDivisaCodigo | string | null | Divisa de fobDivisa (la misma de valores.divisa). |
| valorEnAduanaCif | number | null | Valor en aduana (CIF) del ítem, en dólares. Es null si el .RET no trae el dato en dólares. |
| moneda | "USD" | Moneda de fobDolar, valorEnAduanaCif y de cada monto de liquidacion. |
| liquidacion[] | array | Tributos del ítem, uno por concepto. |
| liquidacion[].concepto | string | Código del concepto (por ejemplo 010). |
| liquidacion[].nombre | string | Nombre del concepto (por ejemplo Derechos de Importación). |
| liquidacion[].alicuota | number | null | Alícuota en porcentaje (14 = 14%). |
| liquidacion[].monto | number | null | Monto del tributo, en la moneda de liquidacion[].moneda. Es alícuota x base imponible en dólares. |
| liquidacion[].moneda | "USD" | Moneda de liquidacion[].monto. |
Cosas a tener en cuenta
- Cada importe dice su moneda. Los montos de
liquidacion,totales,fobDolaryvalorEnAduanaCifestán en dólares.valores.fob,fleteyseguroestán cada uno en su divisa (divisa,divisaFlete,divisaSeguro), que pueden ser distintas. - Los pesos se pagan al tipo de cambio del día:
valores.cotizacionson pesos por dólar y sirve como referencia, no como importe a pagar. - Si el .RET no trae un dato en dólares, el campo viene
null. La API nunca lo reemplaza por un valor en otra moneda. - No se informan emails, conversaciones ni datos internos de Marimpex, solo lo que sale del .RET y el estado.
Errores propios de este endpoint
| HTTP | code | Cuándo pasa | Qué hacer |
|---|---|---|---|
| 400 | invalid_parameter | El número de despacho no tiene formato válido, o un parámetro del listado es inválido. | Corregí el valor. |
| 404 | not_found | El despacho no existe o no es de tu empresa (la respuesta es idéntica). | Verificá el número. |
| 409 | ret_not_available | El despacho existe pero todavía no tiene el .RET. Pasa antes de la oficialización. | Reintentá más tarde. Usá tieneRet del listado para saber cuándo. |