Lotes

Agregar facturas a lote

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.

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

Path parameters

batchIdstring required

ID del lote

Headers

Idempotency-Keystring

Clave que elegís vos (recomendado: un UUID nuevo por cada factura o lote). Si reenviás la misma solicitud con la misma clave —por un timeout, un error de red o un 5xx— recibís la respuesta original (mismo batchId, header Idempotent-Replayed: true) en vez de una factura nueva. Para una factura distinta, o después de que ARCA rechazó la anterior en forma definitiva, usá una clave nueva. Entre 1 y 255 caracteres ASCII imprimibles; se guarda 7 días. En un lote, el ítem i queda identificado como <clave>:<i>.

Request body

cuitIdstring

ID del CUIT emisor. Alternativa a cuit

cuitstring

Número de CUIT emisor, con o sin guiones. Alternativa a cuitId

invoiceTypeinteger

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

ptoVtainteger

Punto de venta. Por defecto, el del CUIT (o 1)

concepto1 | 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)

docTipointeger

Tipo de documento del receptor (código de ARCA: 80 CUIT, 86 CUIL, 96 DNI, 99 consumidor final)

docNrointeger

Número de documento del receptor (0 para consumidor final)

condicionIVAReceptorId1 | 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.

monIdstring

Moneda (código de ARCA, por ejemplo PES o DOL)

monCotiznumber

Cotización de la moneda

descriptionstring

Descripción de la factura

clientNamestring

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

clientAddressstring

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

emailTostring[]

Direcciones a las que se manda el PDF de la factura apenas ARCA la autoriza. Mismos límites que POST /invoices/{invoiceId}/email

fchServDesdestring

Inicio del período facturado (servicios). Fecha en formato YYYYMMDD

fchServHastastring

Fin del período facturado (servicios). Fecha en formato YYYYMMDD

fchVtoPagostring

Vencimiento del pago (servicios). Fecha en formato YYYYMMDD

cbteFchstring

Fecha del comprobante. Fecha en formato YYYYMMDD. Por defecto, hoy

impNetonumber

Importe neto gravado

impTotalnumber

Importe total. Requerido si no enviás amount

impTotConcnumber

Importe neto no gravado

impOpExnumber

Importe exento

impTribnumber

Suma de los tributos

impIVAnumber

Suma del IVA

amountnumber

Importe total. Deprecado: usá impTotal

Example request

[
  {
    "cuit": "20-12345678-9",
    "invoiceType": 11,
    "ptoVta": 1,
    "cbteFch": "20260928",
    "impTotal": 1210
  }
]

Response

Facturas agregadas al lote exitosamente

batchboolean
messagestring
countinteger

Cantidad de facturas agregadas

status'processing'
batchIdstring
addedToExistingBatchboolean

Changes

No recorded changes to this operation across all 1 revision of this API.