Comprobantes

Endpoints

Emitir un comprobante

POST /v1/invoices recibe los datos de la venta y los convierte en un comprobante electrónico autorizado por ARCA. Factura SDK asigna el número correlativo, obtiene el CAE y arma el comprobante impreso con los datos del emisor y del receptor.

El emisor se indica por su CUIT (issuer_cuit) y tiene que estar verificado. El comprobante sale por el punto de venta y con el certificado del emisor.

Headers

Ejemplo

Una Factura A de $12.100 entre responsables inscriptos:

const response = await fetch('https://app.afipsdk.com/api/v1/invoices', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <ACCESS_TOKEN>',
    'Content-Type': 'application/json',
    'Idempotency-Key': 'venta-0002'
  },
  body: JSON.stringify({
    issuer_cuit: '20111111112',
    invoice_type: 1,
    concept: 1,
    receiver: {
      doc_type: 80,
      doc_number: '30715000004',
      vat_condition: 1,
      name: 'Comercio del Centro S.R.L.',
      address: 'Av. Corrientes 1234, CABA'
    },
    amounts: {
      net: 10000,
      vat: 2100,
      total: 12100
    },
    vat_items: [
      { id: 5, base: 10000, amount: 2100 }
    ],
    items: [
      { description: 'Notebook 14', quantity: 1, unit_price: 10000, subtotal: 10000, vat_rate: 21 }
    ],
    sale_condition: 'Cuenta corriente'
  })
});

const invoice = await response.json();

Campos generales

Receptor

Objeto receiver.

Importes

Objeto amounts. Todos los importes van en la moneda del comprobante, con hasta dos decimales. El total tiene que ser igual a la suma de los otros cinco, con una tolerancia de medio centavo por el redondeo.

Alícuotas de IVA

Array vat_items, con una entrada por alícuota. Obligatorio en los comprobantes A y B con importe neto mayor a 0; no se manda en los comprobantes C. La suma de base tiene que ser igual a amounts.net y la suma de amount a amounts.vat.

Tributos

Array tribute_items. Obligatorio cuando amounts.tributes es mayor a 0; la suma de amount tiene que ser igual a ese importe.

Comprobantes asociados

Las notas de crédito y débito tienen que indicar qué ajustan: los comprobantes asociados o el período asociado. Se manda uno de los dos, no ambos.

Array associated_invoices, con los comprobantes del mismo emisor que se ajustan:

Objeto associated_period, cuando la nota ajusta un período:

Fechas del servicio

Objeto service_dates. Obligatorio con concept 2 o 3.

Ítems

Array items, de 1 a 200 líneas. Son el detalle impreso en el comprobante; ARCA no los recibe.

Ejemplos por tipo de comprobante

Hay una solicitud completa, con su respuesta y sus variantes (servicios, varias alícuotas, dólares, notas parciales, período asociado), para cada tipo:

• Factura A, Factura B y Factura C
• Nota de crédito A, Nota de crédito B y Nota de crédito C
• Nota de débito A, Nota de débito B y Nota de débito C

Respuesta

Por defecto la emisión es asíncrona: Factura SDK guarda el comprobante, lo pone en cola y responde 202 con el comprobante en queued. La autorización en ARCA ocurre en segundo plano y el resultado llega por webhook o lo consultás con GET /v1/invoices/:id. Mientras está queued podés cancelarlo.

Con sync: true Factura SDK emite el comprobante dentro de la solicitud y la respuesta es siempre final: 200 con el comprobante en approved, rejected o failed, nada sigue en segundo plano y no se envian los estados via webhook. Si ARCA no responde dentro del tiempo de la solicitud o algo ocurrió en la emisión del comprobante, el comprobante queda failed.

El comprobante tiene esta forma:

{
  "id": "7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f",
  "idempotency_key": "venta-0002",
  "verification": false,
  "status": "approved",
  "invoice_type": 1,
  "sales_point": 1,
  "number": 482,
  "invoice_date": "2026-10-14",
  "total_amount": 12100,
  "currency": "PES",
  "cae": "76412345678901",
  "cae_expiration": "2026-10-24",
  "payload": { "...": "los datos que mandaste, normalizados" },
  "observations": null,
  "errors": null,
  "last_error": null,
  "attempts": 1,
  "next_retry_at": null,
  "created_at": "2026-10-14T14:05:00.000Z",
  "updated_at": "2026-10-14T14:05:03.000Z",
  "processed_at": "2026-10-14T14:05:03.000Z",
  "pdf_url": "https://app.afipsdk.com/api/v1/invoices/7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f/pdf?token=kX3v9Qw2LmN8pR5tY7uZ1aB4cD6eF8gH0jK2lM4nO6p",
  "pdf_generated_at": null,
  "arca_request_url": "https://app.afipsdk.com/api/v1/invoices/7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f/arca-request?token=kX3v9Qw2LmN8pR5tY7uZ1aB4cD6eF8gH0jK2lM4nO6p",
  "arca_response_url": "https://app.afipsdk.com/api/v1/invoices/7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f/arca-response?token=kX3v9Qw2LmN8pR5tY7uZ1aB4cD6eF8gH0jK2lM4nO6p",
  "email_status": null,
  "email_sent_at": null,
  "issuer": {
    "id": "0f8f3c2a-5b1e-4c7d-9a2e-6d4b8e1f2a3c",
    "tax_id": "20111111112",
    "business_name": "Emisor de prueba",
    "vat_condition": 1
  }
}

Idempotencia

El header Idempotency-Key identifica la venta en tu sistema (el id del pedido, por ejemplo). Es opcional: si no lo mandás, Factura SDK genera una clave y cada solicitud crea un comprobante nuevo. Conviene mandarlo siempre, porque es lo que hace seguro reintentar: si la solicitud se corta por un timeout o una caída y no sabés si el comprobante se emitió, lo repetís con la misma clave y recibís el comprobante original en vez de emitir otro.

Estados

Un comprobante aprobado con observaciones es approved: no existe un estado aparte. Revisá observations si te interesa lo que marcó ARCA.

Cuando un comprobante queda en segundo plano, los fallos técnicos se reintentan solos con esperas crecientes (un minuto, dos, cuatro… hasta una hora entre intentos) durante 24 horas desde la creación, o desde que repetiste su Idempotency-Key si lo reencolaste; después el comprobante pasa a failed. Con sync: true no hay reintentos automáticos: vos decidís cuándo repetir la solicitud.

Cancelar un comprobante

POST /v1/invoices/:id/cancel cancela un comprobante que todavía está queued: pasa a cancelled, un estado final, y nunca se emite.

const response = await fetch('https://app.afipsdk.com/api/v1/invoices/<INVOICE_ID>/cancel', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <ACCESS_TOKEN>'
  }
});

const invoice = await response.json();

console.log(response.status, invoice.status);

Ambiente de pruebas

Con un access token de dev estás en sandbox: ningún comprobante llega a ARCA. Sirve para integrar y probar sin trámites y sin consumir el plan.

• El emisor se da de alta y se verifica igual que en producción, pero con un certificado simulado que no firma nada.
• Aplica las mismas reglas y los mismos campos que producción.

Con el campo sandbox.result forzás el resultado para probar cada camino de tu integración:

{
  "sandbox": { "result": "approved_with_observations" }
}

Consultar un comprobante

GET /v1/invoices/:id devuelve el comprobante con su estado actual.

const response = await fetch('https://app.afipsdk.com/api/v1/invoices/<INVOICE_ID>', {
  headers: {
    'Authorization': 'Bearer <ACCESS_TOKEN>'
  }
});

const invoice = await response.json();

Listar comprobantes

GET /v1/invoices lista los comprobantes del más nuevo al más viejo, con paginación por cursor. Incluye los comprobantes de verificación de los emisores, marcados con verification: true.

const params = new URLSearchParams({
  issuer_cuit: '20111111112',
  status: 'approved',
  limit: '50'
});

const response = await fetch(`https://app.afipsdk.com/api/v1/invoices?${params}`, {
  headers: {
    'Authorization': 'Bearer <ACCESS_TOKEN>'
  }
});

const { data, next_cursor, total_count } = await response.json();

{
  "data": [
    { "id": "7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f", "status": "approved", "verification": false, "...": "..." }
  ],
  "next_cursor": "7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f",
  "total_count": 128
}

Para la página siguiente, repetí la solicitud con cursor igual a next_cursor, que es el id del último comprobante de la página. Cuando next_cursor es null, no hay más páginas. Si el CUIT de issuer_cuit no tiene emisor, la lista viene vacía.

PDF

Todo comprobante aprobado trae pdf_url: una URL pública y fija para toda la vida del comprobante, con un token propio de ese comprobante. No requiere autenticación: podés guardarla en tu sistema, ponerla en un email o mostrársela al cliente. Al abrirla muestra el PDF; con ?download=true lo descarga.

https://app.afipsdk.com/api/v1/invoices/7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f/pdf?token=kX3v9Qw2LmN8pR5tY7uZ1aB4cD6eF8gH0jK2lM4nO6p

Solicitud y respuesta de ARCA

Todo comprobante emitido trae arca_request_url y arca_response_url: la solicitud y la respuesta de la autorización tal como viajaron. Son URLs públicas y fijas, con el mismo token que pdf_url. Con ?download=true descargan el archivo en vez de mostrarlo.

https://app.afipsdk.com/api/v1/invoices/7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f/arca-request?token=kX3v9Qw2LmN8pR5tY7uZ1aB4cD6eF8gH0jK2lM4nO6p
https://app.afipsdk.com/api/v1/invoices/7c1d9e4b-2f3a-4b8c-9d0e-1a2b3c4d5e6f/arca-response?token=kX3v9Qw2LmN8pR5tY7uZ1aB4cD6eF8gH0jK2lM4nO6p

Son el XML SOAP de FECAESolicitar (o de FECompConsultar, cuando el comprobante se recuperó de un intento anterior que ARCA había autorizado), con las credenciales del ticket de acceso (Token y Sign) tachadas: con el archivo no se puede firmar nada. En sandbox son la solicitud y la respuesta simulados, en JSON.

Email al receptor

Si el comprobante tiene receiver.email, al aprobarse Factura SDK le manda al receptor un email con el PDF adjunto, una sola vez por comprobante. El resultado queda en email_status (sent o failed) y, si salió, email_sent_at.

Errores

Los errores de forma llegan en data_errors, con un mensaje por campo y sin message:

{
  "statusCode": 400,
  "data_errors": {
    "receiver": {
      "vat_condition": "El campo Condición frente al IVA del receptor es invalido"
    }
  }
}

Las reglas del comprobante llegan en errors:

{
  "message": "El comprobante no cumple las validaciones. Revise el detalle en errors.",
  "errors": [
    {
      "code": "amounts_mismatch",
      "message": "El total (12000) debe ser igual a net + vat + exempt + untaxed + tributes (12100)"
    }
  ]
}

Los problemas del emisor llegan con el motivo en message y la clave en data_errors.issuer_cuit:

{
  "message": "El emisor 20111111112 todavía no está verificado. Verificalo con POST /v1/issuers/0f8f3c2a-5b1e-4c7d-9a2e-6d4b8e1f2a3c/verify (o desde el dashboard) para empezar a emitir.",
  "data_errors": {
    "issuer_cuit": "El emisor no está verificado"
  }
}

El formato de cada código está en Errores y respuestas.

Catálogos

Tipos de comprobante

La clase del comprobante depende de la condición frente al IVA del emisor y del receptor, y Factura SDK la controla antes de emitir. Los A los emiten los responsables inscriptos a otros responsables inscriptos y a monotributistas, y exigen receptor con CUIT. Los B los emiten los responsables inscriptos a consumidores finales, exentos, no alcanzados y no categorizados. Los C los emiten los monotributistas, exentos, no alcanzados y no categorizados, a cualquier receptor, y no discriminan IVA.

Conceptos

Condiciones frente al IVA

Se usan en receiver.vat_condition y en el emisor.

Alícuotas de IVA

Se usan en vat_items.id.

Tipos de documento

Se usan en receiver.doc_type.

Monedas