Ir al contenido
Star104

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.

Cuando además de emitir querés el PDF con el QR de ARCA para mandarle al cliente.

  • datos del emisor en la config: emisor.razonSocial, emisor.domicilio y emisor.inicioActividades
  • el plugin de PDF (arcli pdf instalar, o aceptar la descarga la primera vez en una terminal)
Terminal
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:

Terminal
arcli config establecer pdf siempre
  • 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 de testing/)
  • con --json, la clave pdf con la ruta
  • faltan datos del emisor (PDF_ISSUER_INCOMPLETE): el comprobante se emite igual, sin PDF
  • falta el plugin con --json o en un script (PDF_PLUGIN_MISSING): instalalo antes con arcli pdf instalar
  • pasar --descripcion sin --emitir: en la vista previa no hay PDF

Detalle completo en PDF de comprobantes.

Terminal
# Una sola vez: datos del emisor que ARCA no guarda
arcli 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 PDF
arcli 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 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.

Terminal
arcli pdf # estado: instalado o no, versión, navegador
arcli pdf instalar # descargar el plugin
arcli 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 variable PUPPETEER_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 (ver arcli config ruta). arcli pdf desinstalar borra 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 carpeta node_modules común que ARCLI sabe cargar.
  • Cuándo se descarga solo: solo en una terminal interactiva, y siempre preguntando antes. Con --json o sin terminal (scripts, CI, agentes) nunca se descarga solo: el comprobante sale con el error PDF_PLUGIN_MISSING en pdf.error y hay que correr arcli pdf instalar antes.
  • Versión: ARCLI usa una versión fija del plugin, probada con ARCLI. Si cambia en una versión nueva de ARCLI, arcli pdf lo indica y arcli pdf instalar la actualiza.

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.

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.

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
Terminal
arcli config establecer pdf siempre

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

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.

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.

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.

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ÓN o NOTA 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 llama DOL) 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ÓN debajo 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 --cliente y --domicilio-cliente y ARCA los guarda. --receptor-nombre y --receptor-domicilio no existen en fe.

  • --descripcion es 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.condicionIva sin configurar sale como “Responsable Inscripto”, igual que en A y B.

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: 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.pdf o nota-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, -3 y así.
Terminal
arcli config establecer pdfCarpeta ~/Documentos/facturas

En la terminal, debajo del comprobante:

PDF guardado en /Users/vos/arcli/comprobantes/20123456786/factura-c_0003-00000125.pdf

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

  • 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 E sí 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).
¿Te sirvió esta página?
Editar esta página en GitHub