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.
| Campo | Tipo | Descripción |
|---|---|---|
| updated_since | fecha ISO 8601 | Solo lo modificado desde esa fecha, inclusive. |
| limit | entero | 1 a 50. Por defecto 25. Cuenta documentos de origen, no comprobantes (ver Convenciones). |
| cursor | texto opaco | El 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
| Campo | Tipo | Descripción |
|---|---|---|
| id | string | Identificador 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.tipo | string | null | Clase de comprobante: FCA, FCB, NCA o NCB. Null en comprobantes históricos sin letra guardada. |
| comprobante.puntoVenta | number | null | Punto de venta. |
| comprobante.numero | string | Número, con el formato PPPP-NNNNNNNN. |
| comprobante.cae | string | Código de Autorización Electrónico. |
| comprobante.caeVencimiento | string | null | Vencimiento del CAE, AAAA-MM-DD. |
| comprobante.fechaEmision | string | null | ISO 8601. |
| despacho | string | null | Número de despacho (origen aduana). Null en flete. |
| booking | string | null | Número de booking (origen flete). Null en aduana. |
| moneda | "USD" | "ARS" | Moneda fiscal con la que se emitió el comprobante. |
| tipoDeCambio | number | null | Solo si moneda es ARS: el tipo de cambio fiscal con el que convertir a pesos. Si no, null. |
| lineas | array | null | Detalle del comprobante. Null en algunas facturas de aduana emitidas antes del 2026-10-19 (sin detalle disponible). Ver lineasOrigen. |
| lineas[].descripcion | string | Concepto facturado. |
| lineas[].cantidad | number | Solo en flete. |
| lineas[].precioUnitarioUsd | number | Solo en flete: precio unitario final de venta. |
| lineas[].netoUsd | number | Neto, en dólares. |
| lineas[].ivaPorcentaje | number | Alícuota de IVA (21 = 21%). |
| lineas[].ivaUsd | number | IVA, en dólares. |
| lineas[].totalUsd | number | Total de la línea, en dólares. |
| lineasOrigen | "emitidas" | "reconstruidas" | null | Origen 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 } | null | Totales en dólares. Null cuando lineas es null. |
| comprobanteAsociado | objeto | null | Solo en notas de crédito: la factura que acreditan ({ id, tipo, numero, cae, fechaEmision }). |
| updatedAt | string | null | ISO 8601. Llave de la sincronización incremental. |
Cosas a tener en cuenta
- Los importes de
lineasytotalesestán siempre en dólares.monedaes la moneda fiscal con la que se emitió el comprobante. Si esARS, multiplicá portipoDeCambio(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,totalesylineasOrigenvienen ennull; 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 elidde 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"
}| Campo | Tipo | Descripción |
|---|---|---|
| url | string | Enlace 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). |
| expiraEn | string | null | ISO 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
| HTTP | code | Cuándo pasa | Qué hacer |
|---|---|---|---|
| 400 | invalid_parameter | limit, updated_since, origen o cursor inválidos. | Corregí el parámetro. |
| 404 | not_found | El 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. |
| 404 | pdf_not_available | El comprobante existe pero no tiene PDF disponible. | Reintentá más tarde. |