Emitir factura

Emite una factura electrónica (tipo A, B o C) y devuelve el CAE asignado por ARCA.

Endpoint

POST /api/wsfe/facturas

Request

curl -X POST https://arca.api.com.ar/api/wsfe/facturas \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-uuid-1234" \
  -d '{
    "environment": "homologacion",
    "representada": "27111111118",
    "cbteTipo": 6,
    "ptoVta": 1,
    "docTipo": 80,
    "docNro": "30999888777",
    "concepto": 1,
    "condicionIvaReceptorId": 1,
    "email": "cliente@empresa.com",
    "items": [
      {
        "cantidad": 2,
        "descripcion": "Servicio de consultoría",
        "precioUnitario": 10000.00,
        "alicuotaIva": 21
      }
    ]
  }'

Parámetros

Ítems (items[])

El sistema calcula automáticamente ImpNeto, ImpIVA, ImpOpEx, ImpTotConc, ImpTotal y el desglose de IVA por alícuota. Para factura tipo C, no se discrimina IVA y tanto alicuotaIva como condicionIva son ignorados.

Ítems exentos y no gravados

Ante ARCA, exento no es una alícuota. Un ítem exento no lleva una línea de IVA al 0%: su importe va a ImpOpEx, fuera del neto gravado. Lo mismo con los no gravados, que van a ImpTotConc. Son tres cosas distintas:

Un ítem exento o no gravado no necesita alicuotaIva; si la mandás, se ignora.

{
  "items": [
    { "cantidad": 1, "descripcion": "Honorarios", "precioUnitario": 3235.28, "alicuotaIva": 21 },
    {
      "cantidad": 1,
      "descripcion": "Comisión de intermediación",
      "precioUnitario": 737.86,
      "condicionIva": "exento"
    }
  ]
}

En ese comprobante ImpNeto es 3235.28, ImpIVA es 679.41, ImpOpEx es 737.86 y el array Iva trae una sola entrada, la del 21%.

Punto de venta

ptoVta es opcional. Si lo omitís, lo resolvemos así, deteniéndonos en lo primero que aplique:

1. El punto de venta configurado para ese CUIT en el dashboard (Certificados → editar el CUIT).
2. Lo que ARCA informa como habilitado: si hay uno solo, ese.
3. El punto de venta 1.

La respuesta siempre incluye el ptoVta con el que se emitió, así que nunca quedás sin saber cuál se usó.

Si mandás el campo, tu valor gana siempre: no lo pisa el configurado ni la consulta a ARCA. Y no lo completamos con un 1 por default a propósito — es justo el número que en la mayoría de las cuentas no está habilitado para web services (ver el punto de venta no está habilitado).

Envío por email

Si mandás email y el comprobante resulta aprobado, se le envía al destinatario con el PDF adjunto, sin que hagas nada más. El envío ocurre después de la respuesta, así que no le suma latencia a la emisión, y su estado viaja en el campo email de la respuesta. Ver Envío por email.

Idempotencia

Podés enviar el header Idempotency-Key con cualquier string único (UUID, ID de tu sistema, etc.). Si reenviás la misma solicitud con la misma key, el sistema devuelve el comprobante ya emitido sin volver a llamar a ARCA y sin reenviar el email.

Idempotency-Key: pedido-uuid-1234

Recibos

El recibo se emite por este mismo endpoint: no tiene campos propios ni ruta aparte, sólo un cbteTipo distinto. Es el comprobante que usan, por ejemplo, los profesionales de la salud para documentar honorarios.

Cada recibo se arma igual que la factura de su letra: el 15 no discrimina IVA (los ítems van sin alicuotaIva, como en la Factura C) y el 4 y el 9 la discriminan como la Factura A y B. Tampoco lleva comprobantes asociados: un recibo vale por sí solo, no es una nota.

Lo único a tener en cuenta es la numeración: cada tipo de comprobante lleva su propia serie dentro del punto de venta. El primer recibo de un punto de venta que ya tiene 200 facturas sale igual con el número 1. Como en el resto de la API, el número lo asignamos nosotros consultando el último autorizado para ese (ptoVta, cbteTipo).

{
  "environment": "produccion",
  "representada": "20111111112",
  "cbteTipo": 15,
  "docTipo": 99,
  "docNro": "0",
  "concepto": 2,
  "condicionIvaReceptorId": 5,
  "fchServDesde": "20260901",
  "fchServHasta": "20260930",
  "fchVtoPago": "20260930",
  "items": [
    { "cantidad": 1, "descripcion": "Honorarios profesionales", "precioUnitario": 25000 }
  ]
}

Para dejar sin efecto un recibo se emite la nota de crédito de su letra (13 para un Recibo C), asociada al recibo: ver notas de crédito y débito.

Factura de Crédito Electrónica MiPyME

La FCE es una factura común con dos particularidades: sus propios códigos de comprobante y unos datos bancarios que el régimen exige informar. Se emite por el mismo endpoint, con el mismo body de siempre más el bloque fce.

Las notas del régimen se emiten por notas de crédito y débito y tienen requisitos distintos de los de la factura — no es el mismo bloque fce: ver Notas sobre una FCE.

El bloque fce en la factura

Lo traducimos internamente a las entradas del bloque Opcionales que espera ARCA, así que no necesitás conocer esa tabla. Si preferís mandarlas vos, opcionales sigue funcionando y tu valor gana: ante un mismo identificador prevalece el que escribiste a mano. Los identificadores vigentes se consultan con tipos-opcional.

curl -X POST https://arca.api.com.ar/api/wsfe/facturas \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "homologacion",
    "representada": "27111111118",
    "cbteTipo": 201,
    "ptoVta": 1,
    "docTipo": 80,
    "docNro": "30999888777",
    "concepto": 1,
    "condicionIvaReceptorId": 1,
    "fchVtoPago": "20260210",
    "fce": {
      "cbu": "0170099220000067797243",
      "aliasCbu": "mi.alias.cbu",
      "opcionTransferencia": "ADC"
    },
    "items": [
      {
        "cantidad": 10,
        "descripcion": "Provisión de insumos",
        "precioUnitario": 45000.00,
        "alicuotaIva": 21
      }
    ]
  }'

fchVtoPago es obligatorio, también con concepto: 1

En un comprobante común fchVtoPago sólo se exige con concepto 2 o 3 (servicios). En la factura de crédito electrónica se exige siempre, incluso facturando productos: es la fecha que dispara los plazos de aceptación y de transferencia del régimen. En sus notas, en cambio, ARCA lo prohíbe.

Emitir una factura MiPyME sin fce.cbu o sin fchVtoPago devuelve 400 antes de llamar a ARCA: no consume cuota ni avanza la numeración, así que corregís y reintentás sin costo.

Qué queda fuera de esta API

Tampoco validamos las condiciones de habilitación del régimen: si estás inscripto en el registro MiPyME, si el receptor es una empresa grande y si el monto supera el mínimo lo decide ARCA, no nosotros. Cuando algo de eso no se cumple, ARCA rechaza el comprobante y te devolvemos su mensaje tal cual, sin reinterpretarlo.

Emitir por referencia (clienteId / productoId)

Si guardaste el receptor en tu agenda de clientes o el ítem en tu catálogo de productos, podés referenciarlos en lugar de repetir sus datos en cada request:

El mismo request de arriba, con referencias:

curl -X POST https://arca.api.com.ar/api/wsfe/facturas \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "homologacion",
    "representada": "27111111118",
    "cbteTipo": 6,
    "ptoVta": 1,
    "concepto": 1,
    "clienteId": "8f1c2b3a-4d5e-6f70-8192-a3b4c5d6e7f8",
    "items": [
      { "productoId": "c3e5a7b9-1d2f-4068-8a9b-0c1d2e3f4a5b", "cantidad": 2 }
    ]
  }'

La respuesta es idéntica a la de la emisión escrita a mano: las referencias son una comodidad de escritura del request, no un modo distinto de emitir.

Podés mezclar libremente: un comprobante puede llevar clienteId con ítems escritos a mano, o un receptor explícito con ítems del catálogo, o cualquier combinación ítem por ítem.

El campo explícito siempre gana

La referencia es un default que completa lo que el request no trae, nunca un candado que pisa lo que escribiste. Si mandás los dos, vale el tuyo:

{
  "clienteId": "8f1c2b3a-4d5e-6f70-8192-a3b4c5d6e7f8",
  "email": "otra-direccion@empresa.com",
  "items": [
    {
      "productoId": "c3e5a7b9-1d2f-4068-8a9b-0c1d2e3f4a5b",
      "cantidad": 2,
      "precioUnitario": 8500
    }
  ]
}

Ese comprobante sale con el documento y la condición frente al IVA del cliente guardado, pero con el email del request; y con la descripción y la alícuota del producto, pero con el precio del request. Es la forma de aplicar un descuento puntual o mandar el comprobante a otra dirección sin tener que editar la agenda ni el catálogo.

El comprobante guarda valores, no punteros

Las referencias se resuelven en el momento de emitir. El comprobante persiste los datos resueltos, así que editar después el cliente o cambiar el precio del producto no altera nada de lo ya emitido —cosa que además sería ilegal: un comprobante con CAE es inmutable.

Dicho al revés: actualizar el catálogo es cómo subís precios hacia adelante, no cómo reescribís el pasado.

Errores de resolución

Una referencia que no se puede resolver devuelve 400, antes de llamar a ARCA: no consume cuota ni avanza la numeración, así que corregís y reintentás sin costo.

Los dos últimos ocurren porque el modelo guardado es más laxo que el de emisión: esos campos son opcionales al guardar y obligatorios al emitir. Nunca los inferimos. Un 21% supuesto o una condición frente al IVA adivinada producen un comprobante fiscalmente incorrecto con CAE, y eso no se puede deshacer; un 400 cuesta un reintento.

Se resuelven de cualquiera de las dos formas: completando el dato en el recurso guardado, o mandándolo explícito en el body.

Ver No pudimos resolver una referencia.

Respuesta exitosa

{
  "resultado": "A",
  "cae": "75050000000001",
  "caeFchVto": "20251225",
  "cbteNro": 42,
  "ptoVta": 1,
  "cbteTipo": 6,
  "observaciones": [],
  "errores": [],
  "pdfUrl": null,
  "email": { "to": "cliente@empresa.com", "status": "pending" }
}

El campo email sólo aparece si mandaste un destinatario. Su status en la respuesta de emisión es pending (el envío arranca recién después de responderte) o skipped en homologación, que nunca envía mails. El estado final se consulta después: ver Envío por email.

Comprobante rechazado

Si ARCA rechaza el comprobante devuelve HTTP 422:

{
  "resultado": "R",
  "cae": null,
  "caeFchVto": null,
  "cbteNro": null,
  "ptoVta": 1,
  "cbteTipo": 6,
  "observaciones": [
    { "code": 10048, "msg": "El importe no coincide con el calculado" }
  ],
  "errores": [],
  "pdfUrl": null
}

Un comprobante rechazado no consume cuota de tu plan: sólo se cuentan las facturas que obtuvieron CAE. Corregí lo que indica observaciones[].code y reintentá sin costo. Ver ARCA rechazó el comprobante.

Errores

Antes de reintentar una emisión, leé Reintentar sin duplicar el comprobante: un 502 no significa que el comprobante no se haya emitido.