POST https://www.facture.ar/api/invoices

const facturas = [
  {
    cuitId: 'id-de-tu-cuit',
    invoiceType: 1,               // Factura A
    ptoVta: 1,
    concepto: 2,
    docTipo: 80,
    docNro: 30711111111,
    condicionIVAReceptorId: 1,    // IVA Responsable Inscripto
    clientName: 'Cliente Uno S.A.',
    cbteFch: '20260930',          // opcional, YYYYMMDD; si omitís, fecha del día al procesar
    fchServDesde: '20260901',
    fchServHasta: '20260930',
    fchVtoPago: '20261010',
    impNeto: 25000,
    impIVA: 5250,
    impTotal: 30250,
    iva: [{ id: 5, baseImp: 25000, importe: 5250 }],
    description: 'Suscripción Pro - Septiembre 2026',
    emailTo: ['facturacion@clienteuno.com.ar']  // opcional: se manda el PDF cuando ARCA la autoriza
  },
  {
    cuitId: 'id-de-tu-cuit',
    invoiceType: 6,               // Factura B
    ptoVta: 1,
    concepto: 2,
    docTipo: 99,                  // Consumidor final sin identificar
    docNro: 0,
    condicionIVAReceptorId: 5,    // Consumidor Final
    fchServDesde: '20260901',
    fchServHasta: '20260930',
    fchVtoPago: '20261010',
    impNeto: 8000,
    impIVA: 1680,
    impTotal: 9680,
    iva: [{ id: 5, baseImp: 8000, importe: 1680 }],
    description: 'Suscripción Basic - Septiembre 2026'
  }
  // ... más facturas (hasta 500 por request)
]

const response = await fetch('https://www.facture.ar/api/invoices', {
  method: 'POST',
  headers: {
    'x-api-key': 'tu_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(facturas)
})

const lote = await response.json()
console.log('Batch ID:', lote.batchId)

{
  "batch": true,
  "message": "Lote de facturas encolado para procesamiento",
  "count": 2,
  "status": "processing",
  "batchId": "cmg1a2b3c0000xyz",
  "queueIdentifiers": ["..."]
}

PATCH https://www.facture.ar/api/invoices/batches/{batchId}

await fetch(`https://www.facture.ar/api/invoices/batches/${batchId}`, {
  method: 'PATCH',
  headers: {
    'x-api-key': 'tu_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(masFacturas)
})

GET https://www.facture.ar/api/invoices/batches/{batchId}

const batch = await fetch(`https://www.facture.ar/api/invoices/batches/${batchId}`, {
  headers: { 'x-api-key': 'tu_api_key' }
}).then(r => r.json())

console.log(`Total: ${batch.totalItems}`)
console.log(`Procesados: ${batch.processedItems}`)
console.log(`Exitosos: ${batch.successfulItems}`)
console.log(`Fallidos: ${batch.failedItems}`)

{
  "id": "cmg1a2b3c0000xyz",
  "status": "processing",
  "totalItems": 150,
  "processedItems": 87,
  "successfulItems": 85,
  "failedItems": 2,
  "environment": "production",
  "items": [
    {
      "id": "cmg1a2b3d0001xyz",
      "status": "completed",
      "requestBody": { "invoiceType": 1, "docNro": 30711111111, "impTotal": 30250 },
      "responseBody": {
        "success": true,
        "invoiceId": "cmg1a2b3e0002xyz",
        "voucherNumber": 42,
        "fecaesolicitarResult": {
          "FeDetResp": {
            "FECAEDetResponse": [
              { "Resultado": "A", "CAE": "76123456789012", "CAEFchVto": "20261010" }
            ]
          }
        }
      },
      "cuit": { "id": "id-de-tu-cuit", "number": "20123456789" }
    },
    {
      "id": "cmg1a2b3d0002xyz",
      "status": "error",
      "requestBody": { "invoiceType": 1, "docNro": 30722222222, "impTotal": 12100 },
      "responseBody": {
        "success": false,
        "errorMessages": ["..."]
      },
      "cuit": { "id": "id-de-tu-cuit", "number": "20123456789" }
    }
    // ...
  ]
}

POST https://www.facture.ar/api/invoices/batches/{batchId}/items/{itemId}/retry

await fetch(
  `https://www.facture.ar/api/invoices/batches/${batchId}/items/${itemId}/retry`,
  {
    method: 'POST',
    headers: { 'x-api-key': 'tu_api_key' }
  }
)

GET https://www.facture.ar/api/invoices/batches

const { batches, pagination } = await fetch('https://www.facture.ar/api/invoices/batches?page=1&limit=20', {
  headers: { 'x-api-key': 'tu_api_key' }
}).then(r => r.json())

const BASE_URL = 'https://www.facture.ar/api'
const CLASE_A = [1, 6, 13, 16]  // condiciones frente al IVA que reciben Factura A

function armarFactura(cliente, mes, cuitId) {
  const neto = cliente.montoPlan
  const iva = Math.round(neto * 0.21 * 100) / 100
  const conCuit = Boolean(cliente.cuit)
  // cliente.condicionIVAReceptorId: 1 RI, 4 Exento, 5 Consumidor Final, 6 Monotributo...
  const condicion = cliente.condicionIVAReceptorId ?? 5

  return {
    cuitId,
    invoiceType: conCuit && CLASE_A.includes(condicion) ? 1 : 6,  // A o B
    ptoVta: 1,
    concepto: 2,
    docTipo: conCuit ? 80 : 99,
    docNro: conCuit ? Number(cliente.cuit.replace(/-/g, '')) : 0,
    condicionIVAReceptorId: condicion,
    clientName: cliente.razonSocial,
    fchServDesde: mes.desde,       // 'YYYYMMDD'
    fchServHasta: mes.hasta,
    fchVtoPago: mes.vencimiento,
    impNeto: neto,
    impIVA: iva,
    impTotal: Math.round((neto + iva) * 100) / 100,
    iva: [{ id: 5, baseImp: neto, importe: iva }],
    description: `Suscripción ${cliente.plan} - ${mes.nombre}`
  }
}

async function facturacionMensual(clientes, mes) {
  const apiKey = process.env.FACTUREAR_API_KEY
  const cuitId = process.env.FACTUREAR_CUIT_ID
  const headers = { 'x-api-key': apiKey, 'Content-Type': 'application/json' }

  // 1. Crear un lote por cada bloque de hasta 500 facturas
  const CHUNK_SIZE = 500
  const batchIds = []
  for (let i = 0; i < clientes.length; i += CHUNK_SIZE) {
    const facturas = clientes.slice(i, i + CHUNK_SIZE).map(c => armarFactura(c, mes, cuitId))

    const res = await fetch(`${BASE_URL}/invoices`, {
      method: 'POST',
      headers,
      body: JSON.stringify(facturas)
    })
    const body = await res.json()
    if (!res.ok) throw new Error(`${body.error}: ${JSON.stringify(body.details)}`)

    batchIds.push(body.batchId)
    console.log(`Lote creado: ${body.batchId} (${body.count} facturas)`)
  }

  // 2. Polling hasta que cada lote termine
  const TERMINADO = ['completed', 'completed_with_errors', 'error']
  const resultados = []
  for (const batchId of batchIds) {
    let batch
    do {
      await new Promise(r => setTimeout(r, 5000))  // Esperar 5 segundos
      batch = await fetch(`${BASE_URL}/invoices/batches/${batchId}`, { headers }).then(r => r.json())
      console.log(`${batchId}: ${batch.processedItems}/${batch.totalItems}`)
    } while (!TERMINADO.includes(batch.status))

    console.log(`Exitosos: ${batch.successfulItems}, Fallidos: ${batch.failedItems}`)
    resultados.push(batch)
  }
  return resultados
}