PDF de comprobantes
ARCLI puede generar el PDF de cada comprobante que emitís, con el QR de ARCA. Es el archivo que le mandás al cliente.
Ejemplo: factura con PDF
Sección titulada «Ejemplo: factura con PDF»Cuándo usarlo
Sección titulada «Cuándo usarlo»Cuando además de emitir querés el PDF con el QR de ARCA para mandarle al cliente.
Requisitos
Sección titulada «Requisitos»- datos del emisor en la config:
emisor.razonSocial,emisor.domicilioyemisor.inicioActividades - el plugin de PDF (
arcli pdf instalar, o aceptar la descarga la primera vez en una terminal)
Comando
Sección titulada «Comando»arcli fc -m 150000 --cs --cfinal --emitir --exportar-pdf \ --descripcion "Servicios de septiembre" --condicion-venta contado --receptor-nombre "Cliente SA"Si siempre querés el PDF, guardalo en la config y no hace falta el flag:
arcli config establecer pdf siempreResultado esperado
Sección titulada «Resultado esperado»- el comprobante emitido, con su CAE
- debajo,
PDF guardado en ~/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf(una subcarpeta por CUIT; en testing, dentro detesting/) - con
--json, la clavepdfcon laruta
Errores comunes
Sección titulada «Errores comunes»- faltan datos del emisor (
PDF_ISSUER_INCOMPLETE): el comprobante se emite igual, sin PDF - falta el plugin con
--jsono en un script (PDF_PLUGIN_MISSING): instalalo antes conarcli pdf instalar - pasar
--descripcionsin--emitir: en la vista previa no hay PDF
Detalle completo en PDF de comprobantes.
Resumen
Sección titulada «Resumen»# Una sola vez: datos del emisor que ARCA no guardaarcli config establecer emisor.razonSocial "Tu Nombre o Empresa"arcli config establecer emisor.domicilio "Calle 123, Ciudad"arcli config establecer emisor.inicioActividades 1/03/2020
# Emitir y generar el PDFarcli fc -m 150000 --cs --cfinal --emitir --exportar-pdf --descripcion "Servicios de septiembre"La primera vez, ARCLI ofrece descargar el plugin de PDF. El archivo queda en ~/arcli/comprobantes/testing/20123456786/factura-c_0003-00000125.pdf (en producción, sin la carpeta testing/).
El plugin de PDF
Sección titulada «El plugin de PDF»El PDF lo arma @arcasdk/pdf, que usa un navegador sin ventana (Chrome) para dibujarlo. Como pesa bastante, no viene con ARCLI: se descarga recién cuando alguien lo necesita. Si nunca generás un PDF, ARCLI sigue pesando lo mismo.
arcli pdf # estado: instalado o no, versión, navegadorarcli pdf instalar # descargar el pluginarcli pdf desinstalar # borrar el plugin y el navegador descargado- Tamaño: unos 160 MB. Si no tenés Chrome, Chromium o Edge instalado, se descarga un navegador y se suman unos 200 MB.
- Navegador: ARCLI busca, en este orden, la config
pdfNavegador, la variablePUPPETEER_EXECUTABLE_PATH, un Chrome, Chromium o Edge instalado en el sistema y, por último, el navegador que descargó el plugin. - Dónde se instala: en
plugins/pdf/, junto al archivo de configuración (verarcli config ruta).arcli pdf desinstalarborra esa carpeta entera. - Con qué se instala: con
npm, aunque hayas instalado ARCLI con pnpm, Yarn o bun: npm viene con Node, y así el plugin queda en una carpetanode_modulescomún que ARCLI sabe cargar. - Cuándo se descarga solo: solo en una terminal interactiva, y siempre preguntando antes. Con
--jsono sin terminal (scripts, CI, agentes) nunca se descarga solo: el comprobante sale con el errorPDF_PLUGIN_MISSINGenpdf.errory hay que correrarcli pdf instalarantes. - Versión: ARCLI usa una versión fija del plugin, probada con ARCLI. Si cambia en una versión nueva de ARCLI,
arcli pdflo indica yarcli pdf instalarla actualiza.
Cuándo se genera
Sección titulada «Cuándo se genera»Los flags ganan siempre:
--exportar-pdf(alias--pdf): genera el PDF.--sin-pdf: no lo genera.
Sin flags, depende de si confirmás la emisión a mano.
Si confirmás antes de emitir
Sección titulada «Si confirmás antes de emitir»Sin --emitir ni --previsualizar (y sin emitir true en la config), en una terminal ARCLI muestra la vista previa y pregunta “¿Emitimos la factura C en testing?” con tres opciones, diga lo que diga la config pdf:
- Sí, emitir ahora: emite sin PDF.
- Sí, emitir y generar el PDF: emite y genera el PDF.
- No, dejar sin emitir.
Lo que elegís decide: después de emitir no se pregunta nada más del PDF. Con pdf siempre la opción marcada al empezar es Sí, emitir y generar el PDF; con preguntar o nunca, Sí, emitir ahora. Con --exportar-pdf o --sin-pdf el PDF ya está decidido y la pregunta solo ofrece Sí, emitir ahora y No, dejar sin emitir. Vale para todos los comprobantes y también en el modo interactivo.
Si se emite sin confirmar
Sección titulada «Si se emite sin confirmar»Con --emitir, con emitir true en la config, con --json o sin terminal, decide la config pdf:
pdf |
En una terminal | Con --json o sin terminal |
|---|---|---|
preguntar (por defecto) |
Pregunta después de emitir | No genera |
siempre |
Genera | Genera |
nunca |
No genera | No genera |
arcli config establecer pdf siempreNunca se genera un PDF de una vista previa (sin --emitir) ni de un comprobante rechazado, porque no tienen CAE. Un comprobante observado sí tiene CAE y sí lleva PDF.
En un lote (--cargar con un array) se genera un PDF por comprobante. La respuesta a “¿Emitimos?”, o a la pregunta del PDF después de emitir, vale para todo el lote. Cada ítem del JSON puede traer "pdf": true o "pdf": false, que le gana a esa respuesta.
Si el PDF falla, el comprobante ya está emitido
Sección titulada «Si el PDF falla, el comprobante ya está emitido»El PDF se arma después de emitir. Si algo falla (falta el plugin, faltan datos del emisor, el navegador no arranca), el comprobante igual queda emitido: se muestra con su CAE, seguido de un aviso con el error y cómo resolverlo. No lo vuelvas a emitir para obtener el PDF: quedaría duplicado en ARCA. El código de salida no cambia. En JSON, el error va en pdf.error.
Datos que ARCA no guarda
Sección titulada «Datos que ARCA no guarda»ARCA solo guarda números: no tiene el nombre del emisor, ni el del cliente, ni el detalle de lo que vendiste. Para el PDF hacen falta algunos datos más.
Del emisor (config)
Sección titulada «Del emisor (config)»| Clave | Obligatoria | Nota |
|---|---|---|
emisor.razonSocial |
sí | Nombre o razón social |
emisor.domicilio |
sí | Domicilio comercial |
emisor.inicioActividades |
sí | Fecha con año, por ejemplo 1/03/2020 |
emisor.iibb |
no | Número de Ingresos Brutos, o Exento. Si falta, sale “-” |
emisor.condicionIva |
no | Por defecto sale de la letra: A y B → responsable inscripto, C → responsable monotributo |
emisor.logo |
no | Ruta a una imagen PNG o JPG |
El CUIT es el de siempre (cuit). Si falta algún dato obligatorio, el PDF no se genera y el error PDF_ISSUER_INCOMPLETE lista los comandos para completarlos. En el modo interactivo se preguntan y se ofrece guardarlos.
Del comprobante (flags opcionales)
Sección titulada «Del comprobante (flags opcionales)»| Flag | En el JSON de --cargar |
Si no se pasa |
|---|---|---|
--descripcion <texto> |
descripcion |
“Según detalle” |
--condicion-venta <tipo> (--cv) |
condicionVenta |
condicionVenta de la config; sin ella, no se muestra |
--sin-condicion-venta |
condicionVenta: null |
Omite también el valor de la config |
--receptor-nombre <texto> |
receptorNombre |
“Consumidor Final” o - - |
--receptor-domicilio <texto> |
receptorDomicilio |
- - |
Al facturar con --cuit y sin --ir (con consultarPadron activo, como viene por defecto), el nombre y el domicilio del receptor que no pases salen del padrón de ARCA. Con --ir explícito no se consulta el padrón y valen los de la tabla.
Estos datos solo van en el PDF: ARCA no los recibe. Si los pasás y al final no se genera ningún PDF, ARCLI avisa que no quedaron en ningún lado.
La condición de venta es contado, tarjeta-debito, tarjeta-credito, cuenta-corriente, cheque, transferencia, otros-medios-electronicos u otra, que se imprimen con su nombre, o cualquier otro texto, que se imprime tal cual: así no se limitan automatizaciones ni valores que ARCA no cataloga. Para no pasarla siempre: arcli config establecer condicionVenta contado. Para omitir ese default en un comprobante, usá --sin-condicion-venta o "condicionVenta": null en el JSON. En el modo interactivo se elige de una lista con la de la config marcada.
Va en el renglón de la condición frente al IVA del receptor (“Cond. Venta: Contado”), seguida del vencimiento del pago si lo hay. Con la plantilla actual del plugin, el vencimiento solo se imprime junto a la condición de venta. --vencimiento viaja a ARCA en la solicitud; --condicion-venta, no.
El detalle del PDF tiene un renglón por alícuota de IVA con la descripción y su importe neto, o un solo renglón en las facturas C. Exento y no gravado van en renglones aparte.
El Recibo C usa la misma plantilla que la Factura C con el título RECIBO C, COD.15 y el QR con el tipo 15. No es el formato de recibo del portal de ARCA.
Factura de exportación (E)
Sección titulada «Factura de exportación (E)»La E usa el diseño de exportación de @arcasdk/pdf, con los mismos datos que la E de Comprobantes en línea, y no discrimina IVA. Imprime:
-
los ítems que viajaron a WSFEX (código, descripción con su unidad, cantidad, precio unitario y total);
-
el título
FACTURA DE EXPORTACIÓN,NOTA DE CRÉDITO DE EXPORTACIÓNoNOTA DE DÉBITO DE EXPORTACIÓN; -
en las notas, el comprobante asociado;
-
el cliente con su domicilio, el CUIT del país con su descripción de ARCA (
55000004242 (POLONIA - Persona Jurídica)) y el ID impositivo; -
la divisa con su código ISO y su nombre (
USD - Dólar Estadounidense; WSFEX la llamaDOL) y el destino del comprobante; -
una tabla con la forma de pago, la fecha de pago (las notas no la llevan) y el incoterm;
-
el tipo de cambio y el importe total en la moneda del comprobante;
-
la leyenda
IVA EXENTO OPERACIÓN DE EXPORTACIÓNdebajo de la condición frente al IVA del emisor; -
las observaciones comerciales y las observaciones, debajo del CAE;
-
el QR de ARCA, con el CUIT del país como documento del receptor.
-
El nombre y el domicilio del cliente no son datos solo del PDF: salen de
--clientey--domicilio-clientey ARCA los guarda.--receptor-nombrey--receptor-domiciliono existen enfe. -
--descripciones la descripción del renglón único que arma ARCLI cuando no pasás--item(por defecto “Según detalle”). Con ítems, los renglones son los--item. -
emisor.condicionIvasin configurar sale como “Responsable Inscripto”, igual que enAyB.
Leyendas obligatorias
Sección titulada «Leyendas obligatorias»ARCLI agrega al PDF las leyendas que pide la normativa y que la plantilla de @arcasdk/pdf no trae. Salen debajo del CAE, en la línea de “Observaciones”:
- Comprobantes B (RG 5614, Ley 27.743): “Régimen de Transparencia Fiscal al Consumidor (Ley 27.743)”, con el IVA Contenido del comprobante y Otros Impuestos Nacionales Indirectos en
$ 0,00(ARCLI no informa tributos). - Comprobantes A a un monotributista (RG 5003): “El crédito fiscal discriminado en el presente comprobante, sólo podrá ser computado a efectos del Régimen de Sostenimiento e Inclusión Fiscal para Pequeños Contribuyentes de la Ley Nº 27.618”. Aplica si la condición IVA del receptor es responsable monotributo, monotributista social o monotributo trabajador independiente promovido.
Las facturas C no llevan ninguna de las dos.
Carpeta y nombre del archivo
Sección titulada «Carpeta y nombre del archivo»- Carpeta: la config
pdfCarpeta. Por defecto es~/arcli/comprobantes, una ruta fija para que los PDFs no queden repartidos según desde dónde corriste el comando. - Una subcarpeta por CUIT emisor:
~/arcli/comprobantes/20123456786/. Así dos emisores con el mismo punto de venta y número no se pisan. - Testing: los PDFs de testing van a
testing/<CUIT>/y llevan al pie “COMPROBANTE DE PRUEBA - SIN VALIDEZ FISCAL”. - Nombre:
<tipo>-<letra>_<punto de venta>-<número>.pdf, con el punto de venta en 4 dígitos y el número en 8. Por ejemplo,factura-c_0003-00000125.pdf,nota-credito-a_0003-00000007.pdf,recibo-c_0003-00000003.pdf,factura-e_0003-00000012.pdfonota-credito-e_0004-00000001.pdf. - Nunca se pisa un PDF: si el archivo ya existe, el nuevo se guarda como
factura-c_0003-00000125-2.pdf,-3y así.
arcli config establecer pdfCarpeta ~/Documentos/facturasEn la terminal, debajo del comprobante:
PDF guardado en /Users/vos/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdfEn JSON, el resultado suma la clave pdf solo si se intentó generar el PDF:
{ "pdf": { "ruta": "/Users/vos/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf" } }{ "pdf": { "error": { "codigo": "PDF_PLUGIN_MISSING", "mensaje": "Para generar PDFs falta instalar el plugin de PDF.", "sugerencia": "Instalalo con `arcli pdf instalar`." } }}Códigos posibles: PDF_PLUGIN_MISSING, PDF_PLUGIN_INSTALL_ERROR, PDF_ISSUER_INCOMPLETE y PDF_GENERATION_ERROR. Ver Troubleshooting.
Qué no hace (todavía)
Sección titulada «Qué no hace (todavía)»- Regenerar el PDF de un comprobante ya emitido. La consulta de ARCA que usa el SDK no devuelve el detalle de IVA, los comprobantes asociados ni las fechas de servicio, así que el PDF saldría incompleto. Por ahora el PDF se genera al emitir.
- Ítems detallados en A, B y C (cantidad × precio unitario). La factura de exportación
Esí los imprime porque WSFEX los recibe y los devuelve en la respuesta. - Duplicado y triplicado, plantilla propia y envío por mail.
- Completar los datos del emisor desde el padrón de ARCA (los del receptor sí se completan; ver Del comprobante).