Listar, consultar, descargar el PDF y emitir comprobantes AFIP
Liminar/api/v1/invoicesscope: invoices:read| Nombre | Tipo | Obligatorio | Notas |
|---|---|---|---|
| page | number | no | default 1 |
| pageSize | number | no | default 20, tope 100 |
| clientId | string | no | N/D |
/api/v1/invoices/:idscope: invoices:read/api/v1/invoices/:id/pdfscope: invoices:readcurl https://tu-tenant.liminar.cloud/api/v1/invoices/inv_123/pdf \
-H "Authorization: Bearer lim_live_xxxxxxxx" \
-o factura.pdfDevuelve el PDF (Content-Type: application/pdf) del comprobante emitido.
/api/v1/invoicesscope: invoices:writeEmite el comprobante en una sola solicitud (crear y emitir contra AFIP); no existe un flujo de borrador editable vía API.
| Nombre | Tipo | Obligatorio | Notas |
|---|---|---|---|
| talonarioId | string | sí | punto de venta a usar |
| idempotencyKey | string | sí | evita emitir el mismo comprobante dos veces ante reintentos |
| clientId | string | no | N/D |
| items | array | sí | { code, description, deposit, amount, subtotal, iva, id? } por línea |
| tipoFactura | string | no | N/D |
| condicionVenta | string | no | N/D |
| currency | string | no | N/D |
| exchangeRate | number | no | N/D |
| observaciones | string | no | N/D |
| nroRemito | string | no | N/D |
| fce | object | no | { fceEnabled, cbu, transmisionOption } para factura de crédito electrónica |
| recipientEmail | string | no | N/D |
| emailCc | array<string> | no | N/D |
curl -X POST https://tu-tenant.liminar.cloud/api/v1/invoices \
-H "Authorization: Bearer lim_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"talonarioId": "tal_01J9...",
"idempotencyKey": "order-4821-invoice",
"clientId": "cli_01J9...",
"items": [
{ "code": "TOR-001", "description": "Tornillo M6x20", "deposit": "central", "amount": 100, "subtotal": 5000, "iva": 1050 }
]
}'{
"id": "inv_01J9...",
"numero": "0001-00001234",
"cae": "75123456789012",
"status": "emitida"
}missing_idempotency_key: falta el header idempotencyKey, obligatorio para evitar duplicadosnot_found: el talonarioId no existe o no pertenece al tenanttalonario_not_electronic: el talonario existe pero no está habilitado para factura electrónicainvoice_error: error al emitir contra AFIP; el mensaje incluye el detalle devueltoEl comprobante emitido aparece de inmediato en Archivo, con el mismo número y CAE que devuelve AFIP.