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ó.

CampoTipoDescripción
updated_sincefecha ISO 8601Solo despachos modificados desde esa fecha, inclusive.
limitentero1 a 100. Por defecto 50.
cursortexto opacoEl 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

CampoTipoDescripción
despachostringNúmero de destinación. Es el identificador que se usa en el detalle.
estadostring | nullÚltimo estado informado por ARCA (por ejemplo OFICIALIZADA).
canalstring | nullCanal de selectividad asignado, si ya lo hay.
fechaOficializacionstring | nullAAAA-MM-DD.
internostring | nullNúmero interno de la operación en Marimpex.
updatedAtstringISO 8601. Última modificación de cualquier dato visible del despacho. Es la llave de la sincronización incremental.
tieneRetbooleanfalse 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

CampoTipoDescripción
despachostringNúmero de destinación.
subregimenstring | nullSubrégimen que surge del número (por ejemplo IC04).
tipo"importacion" | "exportacion" | nullSe deduce del subrégimen.
estadostring | nullÚltimo estado informado.
canalstring | nullCanal de selectividad.
aduana{ codigo, nombre } | nullAduana de oficialización.
fechaOficializacionstring | nullAAAA-MM-DD.
internostring | nullNúmero interno de Marimpex.
importador{ razonSocial, cuit, ivaInscripto } | nullTu 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.
proveedorstring | nullVendedor o comprador del exterior.
transporte.mediostring | nullMedio de transporte (por ejemplo MARITIMO).
transporte.buquestring | nullMatrícula o nombre del medio de transporte.
transporte.banderastring | nullPaís de la bandera.
transporte.documentoTransportestring | nullNúmero de guía o documento de transporte.
transporte.fechaArribostring | nullAAAA-MM-DD.
transporte.depositostring | nullCódigo del depósito.
transporte.pesoBrutoKgnumber | nullPeso bruto total, en kilos.
transporte.bultosnumber | nullCantidad de bultos.
valores.incotermstring | nullCondición de venta.
valores.divisastring | nullDivisa de valores.fob.
valores.divisaFletestring | nullDivisa de valores.flete (puede ser distinta de la del FOB).
valores.divisaSegurostring | nullDivisa de valores.seguro (puede ser distinta de la del FOB).
valores.fobnumber | nullValor FOB total, en valores.divisa.
valores.fletenumber | nullFlete, en valores.divisaFlete.
valores.seguronumber | nullSeguro, en valores.divisaSeguro.
valores.valorEnAduanaCifnumber | nullValor 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.cotizacionnumber | nullPesos por dólar usados para los pagos.
items[]arrayUn elemento por ítem de la destinación (ver abajo).
totales.totalPagadonumber | nullTotal 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.totalGarantizadonumber | nullTotal garantizado, en la moneda de totales.moneda.
totales.moneda"USD"Moneda de totalPagado y totalGarantizado.

Campos de cada ítem

CampoTipoDescripción
nrostringNúmero de ítem.
posicionSimstringPosición arancelaria SIM (NCM con sufijo del sistema).
descripcionstring | nullDescripción de la mercadería. Puede ser null.
paisOrigenstring | nullPaís de origen.
cantidadnumber | nullCantidad declarada.
fobDolarnumber | nullFOB 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.
fobDivisanumber | nullFOB del ítem en la divisa de la operación (fobDivisaCodigo).
fobDivisaCodigostring | nullDivisa de fobDivisa (la misma de valores.divisa).
valorEnAduanaCifnumber | nullValor 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[]arrayTributos del ítem, uno por concepto.
liquidacion[].conceptostringCódigo del concepto (por ejemplo 010).
liquidacion[].nombrestringNombre del concepto (por ejemplo Derechos de Importación).
liquidacion[].alicuotanumber | nullAlícuota en porcentaje (14 = 14%).
liquidacion[].montonumber | nullMonto 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, fobDolar y valorEnAduanaCif están en dólares. valores.fob, flete y seguro está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.cotizacion son 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

HTTPcodeCuándo pasaQué hacer
400invalid_parameterEl número de despacho no tiene formato válido, o un parámetro del listado es inválido.Corregí el valor.
404not_foundEl despacho no existe o no es de tu empresa (la respuesta es idéntica).Verificá el número.
409ret_not_availableEl 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.