Ir al contenido
Guía · API

API de facturación electrónica: emití facturas de ARCA desde tu sistema

Con la API de Mis comprobantes tu sistema, tu tienda online o tu ERP emite facturas electrónicas de ARCA sin pasar por la pantalla. Generás una clave en la sección «API», mandás cada factura con POST /v1/facturas (el receptor y los ítems) y consultás su estado, su número, su CAE y su PDF con GET /v1/facturas/{id}. La emisión es asíncrona: si ARCA está caído, la factura queda en cola y sale sola.

Cómo es la API

  • Autenticación con el header x-api-key. La clave se genera en la sección «API» y se muestra una sola vez.
  • POST /v1/facturas: el receptor (sus datos o consumidor final) y los ítems (descripción, cantidad, importe); opcional, el preset. Responde 201 con el id y el estado «en cola».
  • GET /v1/facturas/{id}: el estado, la letra, el punto de venta, el número, el CAE con su vencimiento, el total y el link al PDF.
  • Las mismas validaciones que la pantalla: la letra, el IVA y los datos del receptor se controlan igual.
  • Cada factura de la API cuenta en el cupo de tu plan, igual que las de la app.

Qué necesitás

  • CUIT activo y clave fiscal de ARCA.
  • Mis comprobantes con tu ARCA conectada una sola vez (punto de venta «Web Services» y autorizar a Icono; nunca te pedimos la clave fiscal).
  • Un sistema que pueda hacer pedidos HTTP (tu tienda, tu ERP, un script).

Cómo empezar

  1. 1

    Conectá ARCA

    En Mis comprobantes, una sola vez.

  2. 2

    Generá tu clave

    En «API»: copiala, porque se muestra una sola vez.

  3. 3

    Emití

    POST /v1/facturas con el header x-api-key, el receptor y los ítems.

  4. 4

    Consultá

    GET /v1/facturas/{id} hasta que el estado sea emitida: ahí tenés el CAE y el PDF.

¿Por qué asíncrona?

Porque ARCA a veces no responde. En vez de fallar, la factura queda en cola y el sistema reintenta solo; tu sistema consulta el estado con GET y nunca pierde una factura ni la emite dos veces.

¿Cuánto cuesta Mis comprobantes?

Se contrata por suscripción mensual según cuántas facturas emitís: el plan Inicial cuesta $10.000 por mes hasta 41 facturas y $242 por factura hasta 150. Si un mes te pasás, cada factura excedida se cobra en tu factura siguiente; nunca se frena una factura.

Precios →
Preguntas

Preguntas frecuentes

¿Qué datos mando para emitir?

El receptor (con sus datos o como consumidor final) y los ítems con descripción, cantidad e importe.

¿Cómo obtengo el PDF?

Con GET /v1/facturas/{id}: cuando está emitida trae el link al PDF y el CAE.

¿Qué pasa si ARCA está caído?

La factura queda en cola y sale sola; el estado te lo dice el GET.

¿La API tiene costo aparte?

No: cada factura cuenta en el cupo de tu plan, igual que las de la app.

¿Necesito certificado digital?

No: autorizás a Icono en ARCA una sola vez y no hay certificado que renovar.