---
title: "Crear facturas"
method: POST
path: "/invoices"
tags: ["Facturas"]
---

# Crear facturas

`POST /invoices`

## Request

- Base URL: `https://www.facture.ar/api`
- URL: `https://www.facture.ar/api/invoices`
- Auth: API key in header `x-api-key`

Crea facturas electrónicas individuales o en lote. El sistema procesa las solicitudes de forma asíncrona a través de un sistema de colas. Mandá un header `Idempotency-Key` para poder reintentar sin duplicar facturas (ver la guía de idempotencia).

## Headers

- `Idempotency-Key` string

## Request body

- union
  - InvoiceRequest: Una factura. Todos los campos son opcionales salvo el importe: enviá impTotal (o amount, deprecado). Si no enviás cuitId ni cuit se usa el CUIT por defecto de la cuenta; lo que no envíes se completa con los valores por defecto del CUIT.
    - `cuitId` string: ID del CUIT emisor. Alternativa a cuit
    - `cuit` string: Número de CUIT emisor, con o sin guiones. Alternativa a cuitId
    - `invoiceType` integer: Tipo de comprobante (código de ARCA, por ejemplo 1 Factura A, 6 Factura B, 11 Factura C). Por defecto, el del CUIT; si no tiene, 11 para monotributistas y 6 para responsables inscriptos
    - `ptoVta` integer: Punto de venta. Por defecto, el del CUIT (o 1)
    - `concepto` 1 | 2 | 3: Concepto: 1 productos, 2 servicios, 3 productos y servicios. Por defecto, el del CUIT (o 2 para monotributistas y 1 para el resto)
    - `docTipo` integer: Tipo de documento del receptor (código de ARCA: 80 CUIT, 86 CUIL, 96 DNI, 99 consumidor final)
    - `docNro` integer: Número de documento del receptor (0 para consumidor final)
    - `condicionIVAReceptorId` 1 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 13 | 15 | 16: Condición frente al IVA del receptor (obligatoria para ARCA desde el 1/12/2026). Si no se envía: 5 (Consumidor Final) para receptores sin identificar o con DNI; para CUIT/CUIL se toma del padrón de ARCA, y si no se puede determinar la API responde 400. Debe corresponder a la clase del comprobante (A/M: 1, 6, 13, 16; B: 4, 5, 7, 8, 9, 10, 15; C: todas). Ver /es/guides/condicion-iva-receptor.
    - `monId` string: Moneda (código de ARCA, por ejemplo PES o DOL)
    - `monCotiz` number: Cotización de la moneda
    - `description` string: Descripción de la factura
    - `clientName` string: Nombre o razón social del receptor, impreso en la factura. Si el receptor tiene CUIT y no se envía, se toma del padrón de ARCA
    - `clientAddress` string: Domicilio del receptor, impreso en la factura
    - `condicionVenta` 'contado' | 'cuenta_corriente' | 'tarjeta_debito' | 'tarjeta_credito' | 'transferencia' | 'cheque' | 'otra': Condición de venta impresa en la factura (RG 1415, Anexo II, B). ARCA no la recibe
    - `emailTo` string[]: Direcciones a las que se manda el PDF de la factura apenas ARCA la autoriza. Mismos límites que POST /invoices/{invoiceId}/email
    - `fchServDesde` string: Inicio del período facturado (servicios). Fecha en formato YYYYMMDD
    - `fchServHasta` string: Fin del período facturado (servicios). Fecha en formato YYYYMMDD
    - `fchVtoPago` string: Vencimiento del pago (servicios). Fecha en formato YYYYMMDD
    - `cbteFch` string: Fecha del comprobante. Fecha en formato YYYYMMDD. Por defecto, hoy
    - `impNeto` number: Importe neto gravado
    - `impTotal` number: Importe total. Requerido si no enviás amount
    - `impTotConc` number: Importe neto no gravado
    - `impOpEx` number: Importe exento
    - `impTrib` number: Suma de los tributos
    - `impIVA` number: Suma del IVA
    - `amount` number: Importe total. Deprecado: usá impTotal
    - `cbtesAsoc` object[]: Comprobantes asociados (notas de crédito y débito)
      - `tipo` integer, required: Tipo de comprobante asociado
      - `ptoVta` integer, required: Punto de venta del comprobante asociado
      - `nro` integer, required: Número del comprobante asociado
      - `cuit` string: CUIT emisor del comprobante asociado
      - `cbteFch` string: Fecha del comprobante asociado. Fecha en formato YYYYMMDD
    - `tributos` object[]: Tributos (percepciones, impuestos internos, etc.)
      - `id` integer, required: Código del tributo (FEPARAMGETTIPOSTRIBUTOS)
      - `desc` string, required: Descripción del tributo
      - `baseImp` number, required: Base imponible
      - `alic` number, required: Alícuota en porcentaje
      - `importe` number, required: Importe del tributo
    - `iva` object[]: Alícuotas de IVA
      - `id` integer, required: Código de la alícuota (FEPARAMGETTIPOSIVA, por ejemplo 5 = 21%)
      - `baseImp` number, required: Base imponible
      - `importe` number, required: Importe de IVA
    - `opcionales` object[]: Datos opcionales de ARCA
      - `id` string, required: Código del opcional
      - `valor` string, required: Valor
    - `compradores` object[]: Compradores (operaciones con varios compradores)
      - `docTipo` integer, required: Tipo de documento del comprador
      - `docNro` integer, required: Número de documento del comprador
      - `porcentaje` number, required: Porcentaje de titularidad
    - `periodoAsoc` object: Período asociado (notas de crédito y débito)
      - `fchDesde` string, required: Desde. Fecha en formato YYYYMMDD
      - `fchHasta` string, required: Hasta. Fecha en formato YYYYMMDD
    - `actividades` object[]: Actividades del emisor
      - `id` integer, required: Código de actividad
    - `items` object[]: Ítems de la factura (se muestran en el PDF)
      - `description` string, required: Descripción del ítem
      - `quantity` number, required: Cantidad
      - `unitPrice` number, required: Precio unitario
      - `discount` number, required: Descuento en porcentaje
      - `ivaRate` number, required: Alícuota de IVA en porcentaje
      - `subtotal` number, required: Subtotal del ítem
  - InvoiceRequest[]
    - `cuitId` string: ID del CUIT emisor. Alternativa a cuit
    - `cuit` string: Número de CUIT emisor, con o sin guiones. Alternativa a cuitId
    - `invoiceType` integer: Tipo de comprobante (código de ARCA, por ejemplo 1 Factura A, 6 Factura B, 11 Factura C). Por defecto, el del CUIT; si no tiene, 11 para monotributistas y 6 para responsables inscriptos
    - `ptoVta` integer: Punto de venta. Por defecto, el del CUIT (o 1)
    - `concepto` 1 | 2 | 3: Concepto: 1 productos, 2 servicios, 3 productos y servicios. Por defecto, el del CUIT (o 2 para monotributistas y 1 para el resto)
    - `docTipo` integer: Tipo de documento del receptor (código de ARCA: 80 CUIT, 86 CUIL, 96 DNI, 99 consumidor final)
    - `docNro` integer: Número de documento del receptor (0 para consumidor final)
    - `condicionIVAReceptorId` 1 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 13 | 15 | 16: Condición frente al IVA del receptor (obligatoria para ARCA desde el 1/12/2026). Si no se envía: 5 (Consumidor Final) para receptores sin identificar o con DNI; para CUIT/CUIL se toma del padrón de ARCA, y si no se puede determinar la API responde 400. Debe corresponder a la clase del comprobante (A/M: 1, 6, 13, 16; B: 4, 5, 7, 8, 9, 10, 15; C: todas). Ver /es/guides/condicion-iva-receptor.
    - `monId` string: Moneda (código de ARCA, por ejemplo PES o DOL)
    - `monCotiz` number: Cotización de la moneda
    - `description` string: Descripción de la factura
    - `clientName` string: Nombre o razón social del receptor, impreso en la factura. Si el receptor tiene CUIT y no se envía, se toma del padrón de ARCA
    - `clientAddress` string: Domicilio del receptor, impreso en la factura
    - `condicionVenta` 'contado' | 'cuenta_corriente' | 'tarjeta_debito' | 'tarjeta_credito' | 'transferencia' | 'cheque' | 'otra': Condición de venta impresa en la factura (RG 1415, Anexo II, B). ARCA no la recibe
    - `emailTo` string[]: Direcciones a las que se manda el PDF de la factura apenas ARCA la autoriza. Mismos límites que POST /invoices/{invoiceId}/email
    - `fchServDesde` string: Inicio del período facturado (servicios). Fecha en formato YYYYMMDD
    - `fchServHasta` string: Fin del período facturado (servicios). Fecha en formato YYYYMMDD
    - `fchVtoPago` string: Vencimiento del pago (servicios). Fecha en formato YYYYMMDD
    - `cbteFch` string: Fecha del comprobante. Fecha en formato YYYYMMDD. Por defecto, hoy
    - `impNeto` number: Importe neto gravado
    - `impTotal` number: Importe total. Requerido si no enviás amount
    - `impTotConc` number: Importe neto no gravado
    - `impOpEx` number: Importe exento
    - `impTrib` number: Suma de los tributos
    - `impIVA` number: Suma del IVA
    - `amount` number: Importe total. Deprecado: usá impTotal
    - `cbtesAsoc` object[]: Comprobantes asociados (notas de crédito y débito)
      - `tipo` integer, required: Tipo de comprobante asociado
      - `ptoVta` integer, required: Punto de venta del comprobante asociado
      - `nro` integer, required: Número del comprobante asociado
      - `cuit` string: CUIT emisor del comprobante asociado
      - `cbteFch` string: Fecha del comprobante asociado. Fecha en formato YYYYMMDD
    - `tributos` object[]: Tributos (percepciones, impuestos internos, etc.)
      - `id` integer, required: Código del tributo (FEPARAMGETTIPOSTRIBUTOS)
      - `desc` string, required: Descripción del tributo
      - `baseImp` number, required: Base imponible
      - `alic` number, required: Alícuota en porcentaje
      - `importe` number, required: Importe del tributo
    - `iva` object[]: Alícuotas de IVA
      - `id` integer, required: Código de la alícuota (FEPARAMGETTIPOSIVA, por ejemplo 5 = 21%)
      - `baseImp` number, required: Base imponible
      - `importe` number, required: Importe de IVA
    - `opcionales` object[]: Datos opcionales de ARCA
      - `id` string, required: Código del opcional
      - `valor` string, required: Valor
    - `compradores` object[]: Compradores (operaciones con varios compradores)
      - `docTipo` integer, required: Tipo de documento del comprador
      - `docNro` integer, required: Número de documento del comprador
      - `porcentaje` number, required: Porcentaje de titularidad
    - `periodoAsoc` object: Período asociado (notas de crédito y débito)
      - `fchDesde` string, required: Desde. Fecha en formato YYYYMMDD
      - `fchHasta` string, required: Hasta. Fecha en formato YYYYMMDD
    - `actividades` object[]: Actividades del emisor
      - `id` integer, required: Código de actividad
    - `items` object[]: Ítems de la factura (se muestran en el PDF)
      - `description` string, required: Descripción del ítem
      - `quantity` number, required: Cantidad
      - `unitPrice` number, required: Precio unitario
      - `discount` number, required: Descuento en porcentaje
      - `ivaRate` number, required: Alícuota de IVA en porcentaje
      - `subtotal` number, required: Subtotal del ítem

## Response `200`

Factura(s) aceptada(s) para procesamiento

- InvoiceResponse: Las facturas quedan encoladas en un lote; consultá su resultado con GET /invoices/batches/{batchId}.
  - `batch` boolean, required: false si se encoló una sola factura, true si fueron varias
  - `message` string, required: Mensaje de confirmación
  - `count` integer, required: Cantidad de facturas encoladas
  - `status` 'processing', required: Estado del lote
  - `batchId` string, required: ID del lote creado
  - `queueIdentifiers` string[], required: Colas en las que se encolaron las facturas (una por entorno, CUIT, punto de venta y tipo de comprobante)

## Other responses

- `400`: Datos de factura inválidos
- `403`: Límite de facturas del plan alcanzado
- `409`: Ya hay una solicitud en curso con este `Idempotency-Key` (code `IDEMPOTENCY_KEY_IN_PROGRESS`). Esperá unos segundos y reintentá con la misma clave para recibir su resultado.
- `422`: Este `Idempotency-Key` ya se usó con otra solicitud: otro cuerpo u otro endpoint (code `IDEMPOTENCY_KEY_REUSED`). Usá una clave nueva para una factura distinta.

---

[API](https://skmtc.dev/facture/apis/facturear-api.md) · [All operations](https://skmtc.dev/facture/apis/facturear-api/llms.txt) · [OpenAPI document](https://skmtc.dev/facture/apis/facturear-api/revisions/b572c5908978?raw)