Inicio / Tecnología / Integraciones / API

Tecnología · API

Los datos de tus despachos de aduana, directo en tu sistema.

Si despachás con Marimpex, tu sistema lee la carátula, los ítems con su NCM, origen, FOB, CIF y los datos de la operación oficializada, y tus facturas y notas de crédito con CAE y PDF. Solo lectura, una clave por empresa, y tu sistema consulta cuando lo necesita.

Qué datos trae

Dos conjuntos de datos, de tu empresa y solo de tu empresa.

Lo que hoy copiás a mano del despacho y de la factura, tu sistema lo consulta y lo lee en JSON, sin transcribir.

API·01

Despachos de aduana

Incluye

  • Carátula: número de despacho, subrégimen, estado, canal, aduana y fecha de oficialización
  • Transporte y valores: documento de transporte, arribo, incoterm, FOB, flete, seguro y CIF
  • Cada ítem con su posición NCM, descripción, país de origen, cantidad, FOB y CIF
  • Los tributos de cada ítem, tal como figuran en el .ret: concepto, alícuota y monto
  • Un listado por fecha de modificación, para traer solo lo que cambió desde tu última consulta

API·02

Facturación

Incluye

  • Facturas y notas de crédito de aduana y de flete, con tipo, punto de venta, número, CAE y vencimiento del CAE
  • Neto, IVA y total, con el detalle por línea, en dólares y con la moneda y el tipo de cambio con que se emitió cada comprobante
  • El despacho o el booking de cada comprobante, y la factura que corrige cada nota de crédito
  • El PDF de cada comprobante, con un enlace para descargarlo

Un ejemplo

Un pedido, una respuesta en JSON.

El detalle de un despacho, recortado a un ítem. Los datos son de ejemplo.

Pedido

curl https://mgt.marimpex.com.ar/api/v1/despachos/26001IC04000001A \
  -H "Authorization: Bearer $MGT_API_KEY"

Respuesta · 200

{
  "despacho": "26001IC04000001A",
  "subregimen": "IC04",
  "estado": "OFICIALIZADA",
  "canal": "VERDE",
  "aduana": {
    "codigo": "001",
    "nombre": "BUENOS AIRES"
  },
  "fechaOficializacion": "2026-10-01",
  "items": [
    {
      "nro": "1",
      "posicionSim": "7318.15.00.000A",
      "descripcion": "TORNILLOS",
      "paisOrigen": "CHINA",
      "cantidad": 100,
      "fobDolar": 1000.5,
      "valorEnAduanaCif": 1110.5,
      "liquidacion": [
        {
          "concepto": "010",
          "nombre": "Derechos de Importación",
          "alicuota": 14,
          "monto": 155.47
        }
      ]
    }
  ]
}

Cómo funciona

Tres pasos, y el tercero lo hace tu sistema.

  1. 01

    Pedís acceso

    Un email a api@marimpex.com.ar con tu empresa y quién hace la integración.

  2. 02

    Marimpex emite tu clave

    Una clave por empresa, de solo lectura, que ve únicamente tus datos.

  3. 03

    Tu sistema consulta

    Cuando lo necesita, con la clave en cada pedido. Trae lo nuevo y lo que cambió.

Para quién

Para el que hoy carga el despacho a mano.

Sistemas del importador

Tu ERP lee el despacho y la factura sin que nadie los transcriba: NCM, valores y tributos entran como vienen del .ret.

Partner de ERP o consultora

Una API REST documentada, con OpenAPI, para conectar el sistema de tu cliente importador con sus despachos en Marimpex.

Administración y COMEX

Los tributos y las facturas de cada operación llegan al sistema contable con los mismos montos del despacho y de la factura.

Cómo trabaja

Cómo trabaja la API.

Mejor saberlo antes de planificar la integración.

  • Tu sistema pregunta, la API responde: no empuja datos ni manda avisos (no hay webhooks)
  • Devuelve lo que está registrado en Marimpex al momento de la consulta
  • Lee datos reales de tu empresa y no los modifica, así que probar no cambia nada
  • Solo lectura: no crea, no modifica y no borra
  • El seguimiento de contenedores y el costeo por ítem se ven en Seguimiento y en la Plataforma
  • La clave la emite Marimpex, a pedido

Lo que conviene saber

Un despacho aparece en el listado con el primer aviso de estado del sistema aduanero, normalmente cuando la destinación se oficializa. El detalle con ítems, valores y tributos sale del archivo de retorno del SIM (.ret), que llega junto con la oficialización. Hasta que ese archivo está disponible, la API responde que el detalle todavía no está listo.

Preguntas frecuentes

Lo que pregunta tu equipo de sistemas.

¿Tengo que despachar con Marimpex?

Sí. La API devuelve los despachos y las facturas que gestionamos para tu empresa. Si todavía no operás con nosotros, el primer paso es contarnos tu operación.

¿Qué datos puedo consultar?

Despachos: carátula, ítems con su NCM, país de origen, FOB, CIF y los tributos del .ret. Facturación: facturas y notas de crédito con su CAE y el PDF de cada comprobante. Siempre de tu empresa.

¿Cómo consigo una clave?

Escribís a api@marimpex.com.ar con el nombre de tu empresa y quién va a hacer la integración. Marimpex emite una clave por empresa. No hay alta en línea.

¿Los datos llegan solos a mi sistema?

No. Tu sistema consulta la API cuando lo necesita, por ejemplo una vez por día, y puede pedir solo lo que cambió desde la última consulta. La API no manda avisos automáticos (webhooks).

¿Hay entorno de pruebas?

No. La clave es de solo lectura y consulta los datos reales de tu empresa, así que probar no cambia nada. La referencia técnica trae ejemplos de cada respuesta.

¿Puedo modificar datos desde la API?

No. Es de solo lectura: no crea, no modifica y no borra nada. Un despacho o una factura se corrigen con nosotros, como siempre.

¿Es una API de ARCA?

No. Es la API de Marimpex: devuelve los datos de los despachos y las facturas que gestionamos para tu empresa. No da acceso al SIM ni a los servicios web de ARCA.

¿Funciona con mi ERP?

Si tu ERP o tu desarrollo puede hacer pedidos HTTPS y leer JSON, sí. No hace falta un conector especial. La especificación OpenAPI está para descargar y le ahorra trabajo a tu equipo de sistemas.

¿Puedo ver datos de otras empresas?

No. Cada clave ve solo los datos de su empresa.

Pedí tu clave.

Contanos tu empresa y qué sistema va a consultar. La referencia técnica está en mgt.marimpex.com.ar/integraciones/api.

Pedir accesoa api@marimpex.com.ar