api-arca

api.tu-dominio.com

Facturación de ARCA,
por API.

Emití comprobantes con CAE real, onboardeá clientes con su Clave Fiscal y olvidate del portal. Multi-tenant, credenciales cifradas en reposo, una sola API REST.

Acceder con tu email Ver documentación

SOAP, X.509 y WSAA — de eso nos ocupamos nosotros.

POST/api/v1/invoices 200 Resultado A 
curl -X POST https://api.tu-dominio.com/api/v1/invoices \
  -H 'x-api-key: TU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{ "total": 12100,
        "tipoComprobante": 6,
        "condicionIvaReceptor": 5 }'
{
  "comprobante": 37,
  "cae": "86250296302175",
  "vencimiento": "2026-06-28",
  "resultado": "A"
}

Cuatro endpoints,
todo lo fiscal.

JSON adentro, JSON afuera. El SOAP, el XML y los certificados quedan de nuestro lado.

  • POST /api/v1/onboarding

    Onboordeá un tenant con su Clave Fiscal. Te devuelve la api-key.

  • POST /api/v1/invoices

    Emití un comprobante. Recibís CAE, vencimiento y resultado.

  • GET /api/v1/invoices/by-cae/{cae}/pdf

    Descargá el PDF legal con el QR oficial de AFIP (RG 4892) usando el CAE.

  • GET /api/v1/taxpayers/{cuit}

    Constancia de inscripción: razón social, condición IVA y domicilio.

De la API key a la factura, en tres llamadas.

  1. 01

    Onboordeás

    POST /api/v1/onboarding con la Clave Fiscal. Te devolvemos la api-key del tenant.

    curl -X POST https://api.tu-dominio.com/api/v1/onboarding \
  -H 'content-type: application/json' \
  -d '{ "cuit": "20111111112",
        "password": "••••••••",
        "alias": "miempresa" }'
    { "tenantId": "miempresa",
  "apiKey": "ark_live_8f3a92c1…",
  "cuit": "20111111112" }
  2. 02

    Facturás

    POST /api/v1/invoices con la api-key. Recibís comprobante, CAE y vencimiento.

    curl -X POST https://api.tu-dominio.com/api/v1/invoices \
  -H 'x-api-key: ark_live_8f3a92c1…' \
  -H 'content-type: application/json' \
  -d '{ "total": 12100,
        "tipoComprobante": 6,
        "condicionIvaReceptor": 5 }'
    { "comprobante": 37,
  "cae": "86250296302175",
  "vencimiento": "2026-06-28",
  "resultado": "A" }
  3. 03

    Entregás

    Emitís con detalle (POST /api/v1/invoices) y descargás el PDF legal por CAE.

    curl -X POST https://api.tu-dominio.com/api/v1/invoices \
  -H 'x-api-key: ark_live_8f3a92c1…' \
  -H 'content-type: application/json' \
  -d '{ "tipoComprobante": 11,
        "condicionIvaReceptor": 5,
        "issuer": { "razonSocial": "Mi Empresa S.A." },
        "receptor": { "razonSocial": "Consumidor Final" },
        "items": [
          { "descripcion": "Servicio",
            "cantidad": 1,
            "precioUnitario": 10000 }
        ] }'
    { "comprobante": 37,
  "cae": "86250296302175",
  "vencimiento": "2026-06-28",
  "resultado": "A" }

# GET /api/v1/invoices/by-cae/86250296302175/pdf

Construido para que le confíes lo fiscal.

Los datos que manejamos son plata y obligaciones tributarias reales. Esto es lo que hay debajo.

  • Validación de contrato

    Zod valida tu request antes de tocar ARCA. Los errores te llegan con status claro, no como observaciones crudas de AFIP.

  • Credenciales cifradas

    Las claves privadas viven cifradas con AES-256-GCM. Se filtra el disco y las claves siguen a salvo.

  • Status codes honestos

    200, 400, 401, 422. Cada error del cliente se distingue del error de ARCA, sin adivinar.

  • Multi-tenant

    Una api-key por empresa. Cada CUIT factura con sus credenciales, aislado del resto.

La parte difícil ya está hecha.

Accedé con tu email y emití tu primer comprobante con resultado A.

Acceder con tu email