---
title: "Agregar facturas a lote"
method: PATCH
path: "/invoices/batches/{batchId}"
tags: ["Lotes"]
---

# Agregar facturas a lote

`PATCH /invoices/batches/{batchId}`

## Request

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

Agrega facturas adicionales a un lote existente que aún no ha sido completado. Con `Idempotency-Key`, reenviar el mismo agregado no suma las facturas dos veces, aunque el lote ya haya terminado.

## Path parameters

- `batchId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- InvoiceRequest[]: Facturas a agregar al lote
  - `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`

Facturas agregadas al lote exitosamente

- object
  - `batch` boolean
  - `message` string
  - `count` integer: Cantidad de facturas agregadas
  - `status` 'processing'
  - `batchId` string
  - `addedToExistingBatch` boolean

## Other responses

- `400`: Datos inválidos o lote ya completado
- `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)