Versionado y Funcionamiento API Integracion para Terceros

A. Ajustes de contingencia — tripla CAE + NC/ND + CAEA

Los comprobantes que el gateway emitió por su cuenta y el BackOffice necesita para cerrar su Libro de IVA: el CAE original (duplicado), la NC/ND que lo anula, y el CAEA que es la venta real impresa. El neteo cierra (CAE + CAEA − NC = CAEA); el valor es de registro. Cada comprobante trae su detalle impositivo completo.

Auth: header X-Api-Key: <api-key> · ventana máx. 92 días.

Parámetros

Parámetro	Req.	Descripción
desde	sí	Inicio del período (YYYYMMDD).
hasta	sí	Fin del período (YYYYMMDD).
cuit	—	Filtra por comercio (con o sin guiones; se normaliza a dígitos).
nroSucursal	—	Filtra por sucursal.
ente	—	Filtra por id interno de EnteFacturador (compatibilidad).
formato	—	json (default) · libro-iva (registros ancho fijo RG 4597).

Ejemplo — request

curl -H "X-Api-Key: <api-key>" \
  "https://HOST/api/ajustes-contingencia?desde=20260901&hasta=20260930&cuit=30712434763"

Ejemplo — respuesta (json, un ajuste)

[
  {
    "ticket": { "suc": 1, "pos": 2, "nroTicket": "T-0001" },
    "caeOriginal": {
      "ptoVta": 559, "nro": 301882, "fecha": "20260901",
      "cae": "75130212345601", "tipoComprobante": 6, "importeTotal": 1234.56,
      "docTipo": 99, "docNro": 0, "condicionIvaReceptorId": 5,
      "impuestos": {
        "netoGravado": 1020.30, "noGravado": 0.0, "exento": 0.0,
        "iva": 214.26, "tributos": 0.0, "total": 1234.56,
        "ivaAlicuotas": [ { "id": 5, "baseImponible": 1020.30, "importe": 214.26 } ],
        "tributosDetalle": []
      }
    },
    "ncAnulacion": { "ptoVta": 559, "nro": 45, "fecha": "20260902", "cae": "75130298765401",
                     "tipoComprobante": 8, "importeTotal": 1234.56, "docTipo": 99, "docNro": 0,
                     "condicionIvaReceptorId": 5, "impuestos": { "…": "idem estructura" } },
    "caeaImpreso": { "ptoVta": 560, "nro": 12000, "caea": "26123456789012",
                     "fchTope": "20260910", "estadoInforme": "INFORMADO",
                     "impuestos": { "…": "idem estructura" } },
    "motivo": "doble facturación CAE+CAEA de contingencia",
    "crossPeriodo": false,
    "estado": "CERRADO"
  }
]

Ids AFIP: tipoComprobante 6=Fac B, 8=NC B (1/3=A, 11/13=C, 51/53=M) · alícuota IVA 3=0%, 4=10,5%, 5=21%, 6=27%, 8=5%, 9=2,5% · docTipo 80=CUIT, 96=DNI, 99=Cons.Final.

Opción ?formato=libro-iva

Mismos filtros; devuelve los registros de ancho fijo del Libro de IVA Digital (RG 4597):

curl -H "X-Api-Key: <api-key>" \
  "https://HOST/api/ajustes-contingencia?desde=20260901&hasta=20260930&formato=libro-iva"

→ { "ventasCbte":      [ "…registro de 266 caracteres por comprobante…" ],
    "ventasAlicuotas": [ "…registro de 62 caracteres por alícuota…" ] }

B. Libro de IVA completo — todos los comprobantes del período

A diferencia de (A), devuelve todos los comprobantes autorizados por AFIP (CAE online + CAEA offline + NC/ND), no solo la tripla de contingencia. Fuente: la tabla Trx (canal único).

Auth: header X-Api-Key: <api-key> · ventana máx. 366 días.

Parámetros

Parámetro	Req.	Descripción
desde	sí	Inicio del período (YYYYMMDD).
hasta	sí	Fin del período (YYYYMMDD).
cuit	—	Filtra por comercio (con o sin guiones).
nroSucursal	—	Filtra por sucursal.
ente	—	Filtra por id interno de EnteFacturador.
formato	—	Ver opciones abajo.

Opciones de formato

• arca (default) — JSON con las líneas de ancho fijo RG 4597 (ventasCbte 266 / ventasAlicuotas 62).
• json — un objeto estructurado por comprobante (ver ejemplo).
• csv — adjunto .zip con ventas_cbte.csv + ventas_alicuotas.csv.

Ejemplo — formato=json

curl -H "X-Api-Key: <api-key>" \
  "https://HOST/api/libro-iva?desde=20260901&hasta=20260930&formato=json"

→ [
    {
      "fecha": "20260901", "tipoComprobante": 6, "ptoVta": 559, "nroComprobante": 301882,
      "tipofacturacion": "CAE", "cae": "75130212345601", "caea": null,
      "docTipo": 99, "docNro": 0, "razonSocial": "Consumidor Final",
      "importeNeto": 1020.30, "importeNoGravado": 0.0, "importeExento": 0.0,
      "importeIva": 214.26, "importeTributos": 0.0, "importeTotal": 1234.56,
      "iva": [ { "id": 5, "baseImponible": 1020.30, "importe": 214.26 } ]
    }
  ]

Ejemplo — formato=csv (baja un .zip)

curl -H "X-Api-Key: <api-key>" -OJ \
  "https://HOST/api/libro-iva?desde=20260901&hasta=20260930&formato=csv"
# → libro-iva-20260901-20260930.zip  (ventas_cbte.csv + ventas_alicuotas.csv)

C. Descarga del Libro de IVA desde el cockpit

Mismo contenido que (B) pero con la auth normal del cockpit (sesión), sin la X-Api-Key. Siempre devuelve un archivo descargable. Es lo que usa el botón “Descargar” de la sección Libro de IVA (ventas).

Auth: sesión del cockpit (no requiere X-Api-Key ni el secret del ABM).

Parámetros

Iguales a (B): desde, hasta (req.), cuit, nroSucursal, ente, formato.

• arca / csv → descarga .zip.
• json → descarga .json.