Facturación

Requiere el permiso billing:read. Devuelve las facturas y notas de crédito de tu empresa que ya tienen CAE.

Qué comprobantes salen

Solo comprobantes ya emitidos, con CAE. Borradores y proformas no aparecen. Hay dos orígenes: aduana (honorarios y gastos de despacho) y flete (flete internacional).

Listar comprobantes

GET /facturas · facturas, facturas adicionales y notas de crédito, con su detalle completo.

CampoTipoDescripción
updated_sincefecha ISO 8601Solo lo modificado desde esa fecha, inclusive.
limitentero1 a 50. Por defecto 25. Cuenta documentos de origen, no comprobantes (ver Convenciones).
cursortexto opacoEl nextCursor de la página anterior.
origen"aduana" | "flete"Filtra por origen. Si lo usás junto con cursor, tiene que ser el mismo con que obtuviste ese cursor.
curl -s -H "Authorization: Bearer $MGT_API_KEY" \
  "https://mgt.marimpex.com.ar/api/v1/facturas?updated_since=2026-10-01T00:00:00Z&limit=2"
GEThttps://mgt.marimpex.com.ar/api/v1/facturas
Response · application/json200 OK
{
  "data": [
    {
      "id": "adu_26001IC04000001A",
      "origen": "aduana",
      "tipo": "factura",
      "comprobante": {
        "tipo": "FCA",
        "puntoVenta": 9,
        "numero": "0009-00000001",
        "cae": "70000000000001",
        "caeVencimiento": "2026-11-10",
        "fechaEmision": "2026-10-20T10:00:00.000Z"
      },
      "despacho": "26001IC04000001A",
      "booking": null,
      "moneda": "USD",
      "tipoDeCambio": null,
      "lineas": [
        {
          "descripcion": "Honorarios",
          "netoUsd": 100,
          "ivaPorcentaje": 21,
          "ivaUsd": 21,
          "totalUsd": 121
        }
      ],
      "totales": {
        "netoUsd": 100,
        "ivaUsd": 21,
        "totalUsd": 121
      },
      "comprobanteAsociado": null,
      "updatedAt": "2026-10-20T10:00:05.000Z"
    },
    {
      "id": "adu_26001IC04000001A_nc_0b6d3c1e-0000-4000-8000-000000000000",
      "origen": "aduana",
      "tipo": "nota_credito",
      "comprobante": {
        "tipo": "NCA",
        "puntoVenta": 9,
        "numero": "0009-00000002",
        "cae": "70000000000002",
        "caeVencimiento": "2026-11-12",
        "fechaEmision": "2026-10-22T10:00:00.000Z"
      },
      "despacho": "26001IC04000001A",
      "booking": null,
      "moneda": "USD",
      "tipoDeCambio": null,
      "lineas": [
        {
          "descripcion": "Descuento acordado",
          "netoUsd": 10,
          "ivaPorcentaje": 21,
          "ivaUsd": 2.1,
          "totalUsd": 12.1
        }
      ],
      "totales": {
        "netoUsd": 10,
        "ivaUsd": 2.1,
        "totalUsd": 12.1
      },
      "comprobanteAsociado": {
        "id": "adu_26001IC04000001A",
        "tipo": "FCA",
        "numero": "0009-00000001",
        "cae": "70000000000001",
        "fechaEmision": "2026-10-20T10:00:00.000Z"
      },
      "updatedAt": "2026-10-22T10:00:05.000Z"
    }
  ],
  "nextCursor": "eyJvIjoiYWR1YW5hIiwidSI6IjIwMjYtMTAtMjBUMTA6MDA6MDUuMDAwWiIsImlkIjoiMjYwMDFJQzA0MDAwMDAxQSJ9"
}

Una página puede venir vacía y tener más páginas

Seguí pidiendo páginas hasta que nextCursor sea null. Guardá el updatedAt máximo recién al terminar (ver Convenciones).

Detalle de un comprobante

GET /facturas/{id} · devuelve el mismo objeto que cada elemento del listado.

curl -s -H "Authorization: Bearer $MGT_API_KEY" \
  "https://mgt.marimpex.com.ar/api/v1/facturas/adu_26001IC04000001A"
GEThttps://mgt.marimpex.com.ar/api/v1/facturas/adu_26001IC04000001A
Response · application/json200 OK
{
  "id": "adu_26001IC04000001A",
  "origen": "aduana",
  "tipo": "factura",
  "comprobante": {
    "tipo": "FCA",
    "puntoVenta": 9,
    "numero": "0009-00000001",
    "cae": "70000000000001",
    "caeVencimiento": "2026-11-10",
    "fechaEmision": "2026-10-20T10:00:00.000Z"
  },
  "despacho": "26001IC04000001A",
  "booking": null,
  "moneda": "USD",
  "tipoDeCambio": null,
  "lineas": [
    {
      "descripcion": "Honorarios",
      "netoUsd": 100,
      "ivaPorcentaje": 21,
      "ivaUsd": 21,
      "totalUsd": 121
    }
  ],
  "totales": {
    "netoUsd": 100,
    "ivaUsd": 21,
    "totalUsd": 121
  },
  "comprobanteAsociado": null,
  "updatedAt": "2026-10-20T10:00:05.000Z"
}

Campos de InvoiceApiJson

CampoTipoDescripción
idstringIdentificador del comprobante: opaco y estable. Usalo tal cual en el detalle y el PDF; no lo armes ni lo interpretes.
origen"aduana" | "flete"De qué servicio sale el comprobante.
tipo"factura" | "nota_credito"Las facturas adicionales de un despacho también son tipo factura.
comprobante.tipostring | nullClase de comprobante: FCA, FCB, NCA o NCB. Null en comprobantes históricos sin letra guardada.
comprobante.puntoVentanumber | nullPunto de venta.
comprobante.numerostringNúmero, con el formato PPPP-NNNNNNNN.
comprobante.caestringCódigo de Autorización Electrónico.
comprobante.caeVencimientostring | nullVencimiento del CAE, AAAA-MM-DD.
comprobante.fechaEmisionstring | nullISO 8601.
despachostring | nullNúmero de despacho (origen aduana). Null en flete.
bookingstring | nullNúmero de booking (origen flete). Null en aduana.
moneda"USD" | "ARS"Moneda fiscal con la que se emitió el comprobante.
tipoDeCambionumber | nullSolo si moneda es ARS: el tipo de cambio fiscal con el que convertir a pesos. Si no, null.
lineasarray | nullDetalle del comprobante. Null en algunas facturas de aduana emitidas antes del 2026-10-19 (sin detalle disponible). Ver lineasOrigen.
lineas[].descripcionstringConcepto facturado.
lineas[].cantidadnumberSolo en flete.
lineas[].precioUnitarioUsdnumberSolo en flete: precio unitario final de venta.
lineas[].netoUsdnumberNeto, en dólares.
lineas[].ivaPorcentajenumberAlícuota de IVA (21 = 21%).
lineas[].ivaUsdnumberIVA, en dólares.
lineas[].totalUsdnumberTotal de la línea, en dólares.
lineasOrigen"emitidas" | "reconstruidas" | nullOrigen del detalle: 'emitidas' = líneas guardadas al emitir el comprobante; 'reconstruidas' = rearmadas desde el import del comprobante en Contabilium; null = el comprobante no tiene detalle por línea disponible (lineas y totales vienen null).
totales{ netoUsd, ivaUsd, totalUsd } | nullTotales en dólares. Null cuando lineas es null.
comprobanteAsociadoobjeto | nullSolo en notas de crédito: la factura que acreditan ({ id, tipo, numero, cae, fechaEmision }).
updatedAtstring | nullISO 8601. Llave de la sincronización incremental.

Cosas a tener en cuenta

  • Los importes de lineas y totales están siempre en dólares. moneda es la moneda fiscal con la que se emitió el comprobante. Si es ARS, multiplicá por tipoDeCambio (el tipo de cambio de la emisión) para obtener los pesos. Siempre trabajá con ambos campos juntos: el importe en dólares y la moneda fiscal.
  • Algunas facturas emitidas antes del 19 de octubre de 2026 no tienen detalle por línea: en ese caso lineas, totales y lineasOrigen vienen en null; el comprobante, el CAE y el PDF sí están disponibles.
  • En flete, los precios son los de venta final al cliente.
  • Para conciliar una nota de crédito, usá comprobanteAsociado.id: es el id de la factura que acredita.

PDF de un comprobante

GET /facturas/{id}/pdf · devuelve un enlace para descargar el PDF.

curl -s -H "Authorization: Bearer $MGT_API_KEY" \
  "https://mgt.marimpex.com.ar/api/v1/facturas/fle_BKG-2026-0001/pdf"
GEThttps://mgt.marimpex.com.ar/api/v1/facturas/fle_BKG-2026-0001/pdf
Response · application/json200 OK
{
  "url": "https://storage.googleapis.com/ejemplo/factura-0010-00000001.pdf?X-Goog-Signature=...",
  "expiraEn": "2026-11-01T15:10:00.000Z",
  "tipo": "firmada"
}
CampoTipoDescripción
urlstringEnlace de descarga.
tipo"firmada" | "enlace_publico"firmada: enlace temporal de Marimpex. enlace_publico: enlace del emisor del comprobante (ARCA o el sistema de facturación).
expiraEnstring | nullISO 8601. Los enlaces firmados duran 10 minutos: descargá enseguida. En enlace_publico es null: el enlace no vence por parte de Marimpex, así que tratalo como un dato sensible.

Pedí el PDF cuando lo necesites descargar y no guardes el enlace: pedí uno nuevo cada vez.

Errores propios de estos endpoints

HTTPcodeCuándo pasaQué hacer
400invalid_parameterlimit, updated_since, origen o cursor inválidos.Corregí el parámetro.
404not_foundEl id no existe, tiene formato inválido, no es de tu empresa o el comprobante todavía no está emitido (misma respuesta).Usá ids obtenidos del listado.
404pdf_not_availableEl comprobante existe pero no tiene PDF disponible.Reintentá más tarde.