# ARCLI > CLI de Node/TypeScript para emitir y previsualizar comprobantes ARCA (ex AFIP) desde > terminal: facturas, notas de crédito/débito (comunes y FCE), Recibo C, Factura de exportación E y sus notas, > en testing o producción. > Salida humana por defecto, `--json` para scripts/agentes. Repo: https://github.com/LcsGrz/arcli ## Reglas para agentes - Siempre explícitos `--json`, el entorno (`--testing` o `--produccion`) y `--previsualizar` o `--emitir`: así el resultado no depende de la config ni de un prompt. - Primero `--previsualizar`, y `--emitir` cuando la persona confirmó ese comprobante: **en producción emitir es irreversible** (tiene validez fiscal y solo se compensa con una nota de crédito); en testing no tiene validez fiscal. - **Se emitió si y solo si** `previsualizacion` es `false` y `cae` no es `null`. En la vista previa, `estado` es `previsualizacion`. - Reintentos: - Se puede reintentar igual: `TRANSIENT_ERROR`, `ARCA_LAST_VOUCHER_ERROR` (salvo un punto de venta no habilitado) y `UNEXPECTED_ERROR` de red. No se emitió nada. - No reintentar sin verificar antes: `EMISSION_UNCERTAIN` y `BATCH_EMISSION_ERROR` (ver "Salida de error"). - Corregir antes de reintentar: `INPUT_VALIDATION_ERROR`, `CONFIGURATION_ERROR`, `CERTIFICATE_*` y `*_NOT_AUTHORIZED`. Si el error habla del certificado, avisale a la persona: no se arregla reintentando. - Rechazo (exit `2`): corregir según `errores` y `sugerencias`. Con los mismos datos vuelve a fallar. - La vista previa de A, B y C no pide número ni CAE, pero puede salir a ARCA: con `--cuit` sin `--ir` (padrón) y en moneda extranjera sin `--cm` (cotización). La de `fe` sale siempre (tablas de WSFEX). Todas necesitan el certificado configurado. - Para saber si un punto de venta sirve sin emitir: `arcli ultimos fc --pv N --json` (solo lectura). Si no está habilitado, da `ARCA_LAST_VOUCHER_ERROR`. En testing, `estado` no lo puede confirmar. ## Exit codes | exit | cuándo | |---|---| | `0` | Aprobado, observado (tiene CAE) o vista previa. | | `2` | ARCA rechazó el comprobante (A, B, C o E); en un lote, al menos uno. Sale por stdout como respuesta válida: revisar `estado`, `resultado` y `errores` de cada uno. | | `1` | Cualquier error: JSON en stderr, mirar `codigo` (ver "Salida de error"). | ## Ejemplos (A, B, C y notas) ```bash arcli fc -m 15.000 --cs --cfinal --testing --previsualizar --json arcli fa -m 12.100 --cs --cuit 20201797064 --ir-ri --testing --previsualizar --json arcli fc -m 1.000 --cs --cfinal --mda USD --cm 1.050,50 --testing --previsualizar --json arcli ncc -m 500 --cs --cfinal --ac fc --apv 3 --ar 12 --acuit --testing --previsualizar --json arcli fc --cargar lote.json --testing --previsualizar --json ``` ## Instalación y setup mínimo Requiere Node.js 22.22.1 o superior. Para instalar o actualizar: `npm install -g arcli@latest` y verificar con `arcli --version`. Si te lo pide una persona que no usa la terminal, hacelo vos y después `arcli acceso-directo` deja un ícono para abrir el modo interactivo; no toques certificados ni config sin que te lo pida. ```bash npm install -g arcli arcli config establecer cuit <11 dígitos> arcli config establecer puntoVenta # Certificado, una de dos (recomendada: certificado generar + importar): arcli certificado generar --testing # sin certificado: arma clave y CSR; la persona lo sube a ARCA arcli certificado importar testing.crt # ... y carga el .crt que devuelve ARCA arcli config establecer cert.testing /ruta/al/certificado.crt # si ya tiene certificado y clave arcli config establecer key.testing /ruta/a/la/clave.key arcli config revisar # revisa la config localmente (no prueba el certificado contra ARCA: para eso, arcli estado) ``` `certificado generar` necesita a la persona: subir el CSR y bajar el `.crt` se hace en ARCA con su clave fiscal (ver "Otros comandos"). `importar` configura `cert.` y `key.`. Sin `cuit`, `cert.` o `key.` en la config, la facturación falla con `CONFIGURATION_ERROR`, y sin punto de venta (`puntoVenta` o `--pv`) con `INPUT_VALIDATION_ERROR`, en los dos casos antes de contactar ARCA. El entorno sale de `config.entorno` (`testing` por defecto); `--testing`/`--produccion` lo fijan. ## Salida humana Con la salida redirigida (pipe o archivo) no hay colores, así que `--json` se puede pasar directo a `jq`. `NO_COLOR` desactiva los colores, `FORCE_COLOR=1` los fuerza y `ARCLI_ASCII=1` dibuja los paneles y símbolos en ASCII puro. En terminales que los soportan, las rutas son links clickeables (`FORCE_HYPERLINK=0` los apaga; con la salida redirigida no hay). Ninguna cambia el contenido de `--json`; para parsear, usar siempre `--json`. `ARCLI_CONFIG_DIR=` usa otra carpeta de config (con sus tickets y certificados), por ejemplo para probar sin tocar la config real. ## Modo interactivo (no usar desde un agente) `arcli` sin argumentos en una TTY abre un asistente con prompts (`arcli interactivo` lo abre explícito). Sin TTY, `arcli` sin argumentos muestra la ayuda y `arcli interactivo` falla. `arcli interactivo` acepta solo `--testing`/`--produccion`: `--json` y `--bruto` se ignoran con un aviso. Un agente siempre tiene que usar los comandos con flags de abajo. ## Comandos de facturación (shortcut de 2-4 letras) ``` arcli --monto --cs|--cp|--csp --ir-|--iva-receptor [--cuit N|--cuil N|--dni N|--consumidor-final] [--emitir|--previsualizar] [--json] ``` Shortcuts (`family` = comando alternativo `arcli `, ej. `arcli factura c`): | shortcut | comprobante | family | requiere comprobante asociado | |---|---|---|---| | fa, fb, fc | Factura A/B/C | factura | no | | nca, ncb, ncc | Nota de crédito A/B/C | nota-credito | sí | | nda, ndb, ndc | Nota de débito A/B/C | nota-debito | sí | | fcea, fceb, fcec | Factura de crédito electrónica A/B/C | factura-credito-electronica | no | | ncea, nceb, ncec | Nota de crédito electrónica A/B/C | nota-credito-electronica | sí | | ndea, ndeb, ndec | Nota de débito electrónica A/B/C | nota-debito-electronica | sí | | rc | Recibo C (solo letra C) | recibo | no | | fe, nce, nde | Factura, Nota de crédito y Nota de débito de exportación E (WSFEX, ver abajo) | factura, nota-credito, nota-debito | nce y nde sí | ## Factura de exportación E (WSFEX) `arcli fe` (o `arcli factura e`, que hace lo mismo) emite la Factura de exportación E con el servicio `wsfex`. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI: lleva cliente y domicilio del exterior, país de destino, incoterm, ítems y permisos de embarque. `--cargar` acepta un solo objeto, no un array. ```bash arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 203 \ --actividad 620100 --item "001|Servicios de consultoría|1|1500|unidad" --previsualizar --json ``` - Requeridos: `-m, --monto `, `--cliente `, `--domicilio-cliente `, `--pais-destino ` (código de ARCA o nombre, ej. `203` o `Brasil`) y la actividad: `--actividad ` o la clave `exportacion.actividad`. No hay default: tiene que ser un código de la tabla de actividades de WSFEX, que no es la del padrón (ej. `620100`; `620900` no está). Si no está en la tabla es `INPUT_VALIDATION_ERROR` con las que empiezan igual. - `--item ` (repetible): `codigo|descripcion|cantidad|precio|unidad`; con 4 partes se omite el código y con 3 la unidad (por defecto `unidad`, código `7`). La suma de los ítems tiene que dar `--monto`: se valida antes de ir a ARCA. Sin `--item` va un renglón con `--descripcion`. - Opcionales: `--id-impositivo `, `--cuit-pais ` (sin flag sale del país de destino; si ARCA no publica un CUIT para ese país, el flag es obligatorio), `--tipo-expo <1|2|4>` (`2` servicios por defecto, `1` bienes, `4` otros). - `--incoterm `, `--incoterms-desc `, `--idioma ` (`1` español por defecto, `2` inglés, `3` portugués), `--forma-pago ` (por defecto `Transferencia Internacional`), `--permiso ` (repetible, solo con `--tipo-expo 1`; en la factura requiere `--permiso-existente`), `--permiso-existente`, `--id-solicitud ` (sin flag, el siguiente de WSFEX), `--punto-venta ` (`--pv`), `-f, --fecha `, `--fecha-pago `, `--moneda ` (`--mda`; por defecto `DOL`), `--cotizacion-moneda ` (`--cm`; sin flag, la de aduana que publica ARCA; la clave `cotizacion` de la config no aplica), `--misma-moneda` (manda `CanMisMonExt` en `S`: el pago se cancela en la misma moneda extranjera), `--observaciones `, `--obs-comerciales `, `--descripcion `, `--cargar `, `--exportar-pdf` (`--pdf`), `--sin-pdf`, `--previsualizar`, `--emitir`, `--json`, `--bruto`. - La fecha del comprobante no puede ser futura. WSFEX numera por punto de venta y tipo: sin `--numero `, ARCLI usa el siguiente al último de ARCA (también en la vista previa). - `fe` es estricto: un flag de A/B/C es opción desconocida. `factura ` acepta en A/B/C los flags de la E, y en la E los de A/B/C, y los saltea con un aviso en `avisos` (`factura a --incoterm`, `factura e --alicuota`). Las reglas de cada letra siguen valiendo: `factura c --alicuota` es error, como `fc --alicuota`. - Credenciales: usa `exportacion.cert.`/`exportacion.key.` si están configuradas y, si no, `cert.`/`key.`; el certificado tiene que estar autorizado a `wsfex` (si no, `WSFEX_SERVICE_NOT_AUTHORIZED`). Con la mitad del par configurada, el comando corta antes de ir a ARCA. - PDF: `factura-e_-.pdf`, con el diseño de exportación (divisa, destino, forma y fecha de pago, incoterm, leyenda de IVA exento). ### Notas de crédito y débito E `arcli nce` (`nota-credito e`, tipo 21) y `arcli nde` (`nota-debito e`, tipo 20) ajustan una E ya emitida. Mismos flags que `fe` más el asociado; cliente, domicilio, destino, CUIT del país, tipo de exportación, moneda, cotización, idioma, incoterm, forma de pago y actividad salen del asociado (consultado en ARCA con `FEXGetCMP`) si no vienen por flag. ```bash arcli nce -m 500 --ar 1 --apv 4 --previsualizar --json ``` - Asociado: `--ar ` (requerido), `--apv ` (`--asociado-punto-venta`; por defecto el de la nota), `--ac ` (por defecto `fe`) o `--at <19|20|21>`. `--acuit` solo puede ser el CUIT emisor; `--afecha` no se usa. En `--cargar`: `comprobanteAsociado` `{numero, puntoVenta, atajo|tipo}`. - No llevan `--fecha-pago`, `--misma-moneda` ni `--permiso-existente` (en `nce`/`nde` son opción desconocida; en el JSON, `INPUT_VALIDATION_ERROR`). En bienes, `--permiso` (o `permisos`) es opcional y va sin `--permiso-existente`: ARCA pide `Permiso_existente` vacío. - Antes de emitir valida: asociado existente y aprobado, nota no anterior al asociado, NC no mayor al total del asociado (misma moneda) y, en servicios (`tipoExpo` 2), mismo tipo, destino, moneda (o pesos) y cotización que el asociado; ND solo sobre factura, NC no sobre otra NC. - PDF: `nota-credito-e_-.pdf` / `nota-debito-e_-.pdf`. ## Flags principales (alias corto entre paréntesis) - `-m, --monto `: importe total (requerido). Montos en formato argentino: punto para miles, coma para decimales (`15000`, `15.000`, `1.500,50`). `1500.50` da error; máximo 2 decimales (la cotización, 6). Aplica a `--monto`, `--exento`, `--nogravado`, `--cm` y `--alicuota TASA:MONTO`. En JSON los montos son números, también con 2 decimales como máximo. Enteros (`--pv`, `--ar`, `--dia`…) solo con dígitos; `--cuit`/`--cuil`/`--acuit`/`--dni` aceptan guiones, y todo CUIT (también el de `padron`, `fce-obligado` y `config establecer cuit`) se valida con su dígito verificador. - Concepto: `--concepto ` (`productos`/`servicios`/`productos-servicios`) o atajos `--cs` `--cp` `--csp`. Uno solo, no combinar `--concepto` con un atajo. - IVA receptor: `--iva-receptor ` / `--ir ` (alias) o un atajo `--ir-ce|--ir-cf|--ir-il|--ir-ina|--ir-ms|--ir-mtip|--ir-pe|--ir-ri|--ir-rm|--ir-se|--ir-snc`. Usar exactamente una forma. Valores válidos: `cliente-del-exterior`, `consumidor-final`, `iva-liberado`, `iva-no-alcanzado`, `monotributista-social`, `monotributo-trabajador-independiente-promovido`, `proveedor-del-exterior`, `responsable-inscripto`, `responsable-monotributo`, `sujeto-exento`, `sujeto-no-categorizado`. El IVA receptor tiene que ser válido para la letra: `A` solo admite `responsable-inscripto`, `responsable-monotributo`, `monotributista-social` y `monotributo-trabajador-independiente-promovido`; `B` admite el resto; `C` admite todos. Letras `A` y `B` discriminan IVA a la alícuota de `--alicuota` (por defecto 21%, ver abajo). - IVA (solo letras A y B): `--alicuota general|reducida|incrementada|cero` o el número `0|2.5|5|10.5|21|27` (default `config.alicuota` o 21; la config no aplica a C). Varias alícuotas: repetir `--alicuota TASA:MONTO` con el monto IVA incluido de cada una (`--alicuota general:1210 --alicuota reducida:552,50`); `--monto` pasa a ser opcional y, si se pasa, tiene que coincidir con la suma. En JSON: `alicuotas: [{tasa, monto}]`. Además, `--exento ` y `--nogravado ` (sin guion). `--monto` es siempre el total; exento y no gravado se descuentan y el IVA se calcula sobre el resto. En letra C esos flags dan error. - Identidad del receptor: `--cuit ` / `--cuil ` / `--dni ` / `--consumidor-final` (alias `--cfinal`, documento 0; implica `--ir-cf`). Usar como máximo una. Desde $ 10.000.000 (total × cotización) no se puede usar `--consumidor-final`: identificar con `--dni`/`--cuit`/`--cuil` y `--ir-cf`. - Punto de venta: `--punto-venta ` (alias `--pv`). Si no se pasa, usa el default de config. - Moneda: `--moneda ` (alias `--mda`): código ISO o de ARCA, indistinto (`ARS`=`PES`, `USD`=`DOL`, `EUR`=`060`, `BRL`=`012`, `UYU`=`011`, `CLP`=`033`…; el ISO se traduce al de ARCA). Están todas las de `arcli parametros monedas` que tienen ISO; un código fuera de la tabla va tal cual y `--cotizacion-moneda ` (alias `--cm`). En moneda extranjera sin `--cm` se usa la cotización oficial de ARCA (con un aviso en `avisos`) y `--cm 1` es error; si el pago es en la misma moneda extranjera, usar `--misma-moneda` en lugar de `--cm` (consulta la cotización oficial a ARCA; la fecha del comprobante tiene que ser hoy). En pesos no pasar cotización distinta de 1. - Fechas: `-f, --fecha ` acepta formato argentino día-primero: `D`, `DD`, `D/M`, `DD/MM`, `D-M-YY`, `DD-MM-YYYY` (con `-` o `/`); sin mes usa el actual; sin año, el de la fecha más cercana a hoy (en enero, `1/12` es diciembre pasado). También `--servicio-desde`/`--sd` y `--servicio-hasta`/`--sh`. `-d, --dia ` está deprecado (avisa): fija solo el vencimiento en el próximo día `n`; usá `--vencimiento` o `--vto`. "Hoy" es siempre la fecha argentina, aunque el equipo esté en UTC. `--vencimiento ` (alias `--vto`) fija `FchVtoPago` aparte del período de servicio (servicios y facturas FCE; no en productos ni NC/ND FCE). Ventana de `--fecha` respecto de hoy: productos ±5 días, servicios ±10, FCE −5/+1; en productos y FCE una fecha futura tiene que caer en el mes actual. - Comprobante asociado (obligatorio en notas de crédito/débito): `--ac ` (una factura, ej. `fc`, o en notas C un recibo, `rc`), `--apv ` (punto de venta, alias `--asociado-punto-venta`), `--ar ` (número), `--acuit ` (CUIT del emisor del comprobante asociado, normalmente el tuyo; obligatorio en notas comunes), `--at ` (tipo ARCA, alternativa a `--ac`; no combinar ambos), `--afecha ` (fecha del asociado, opcional; en NC/ND FCE, si falta, se toma del asociado en ARCA). En notas comunes, en lugar del bloque `--ac` se puede usar un período: `--periodo-desde ` y `--periodo-hasta ` (alias `--pd`/`--ph`); no se combinan con `--ac`/`--at`, no aplican a FCE y el período no puede terminar después de la nota. En una NC (A, B, C o FCE), arcli consulta el asociado propio en ARCA antes de la vista previa (una vez por nota) y, si la NC supera su total en la misma moneda, da `INPUT_VALIDATION_ERROR` con `sugerencia` del `--monto` que la anula entera; en un lote, `BATCH_VALIDATION_ERROR`. - Crédito electrónico (FCE): las facturas `fcea/fceb/fcec` requieren `--cbu <22 dígitos>` (o `arcli config establecer cbu ...`); opcionales `--alias ` y `--transferencia sca|adc` (default `sca`). Las NC/ND FCE (`ncea`…`ndec`) toman la fecha del asociado de ARCA si falta `--afecha`, aceptan `--anulacion`, toman `--acuit` del CUIT emisor si se omite y no aceptan `--cbu`/`--alias`/`--transferencia`. Fuera de FCE esos flags dan error. - Padrón: al facturar con `--cuit` y sin `--ir`/`ivaReceptor`, se usa la condición IVA del padrón de ARCA antes que el `ivaReceptor` de la config; si el padrón no responde o no la informa, se usa la config con un aviso en `avisos`, y sin config es `INPUT_VALIDATION_ERROR`. Se desactiva con `arcli config establecer consultarPadron false`. Para no depender del padrón, pasá `--ir` explícito. - Régimen FCE al facturar: con `arcli config establecer verificarFce true`, cada factura con CUIT consulta si el receptor está obligado a recibir FCE y devuelve avisos en `avisos` (JSON) sin bloquear. - Ejecución: `--previsualizar` (solo arma y muestra la solicitud) vs `--emitir` (real contra ARCA), mutuamente excluyentes. `--produccion --emitir` emite de verdad sin confirmación adicional. Qué pasa sin ninguno de los dos: ver "Modo no interactivo". - Salida: `--json` (estructurada, para scripts/agentes — desactiva el aviso de nueva versión), `--bruto` (incluye la respuesta cruda de ARCA). `--bruto` solo existe en los comandos de facturación; en `padron`, `fce-obligado`, `ultimos`, `consultar`, `parametros` y `estado` se ignora con un aviso en stderr. En todos los comandos, sin `--json` decide la clave de config `json`. - `--cargar `: carga uno o un array de comprobantes desde un JSON en vez de flags (ver forma abajo). Los flags pisan lo que venga del archivo. - PDF: `--exportar-pdf` (alias `--pdf`) lo genera después de emitir y `--sin-pdf` no; sin flag decide la clave `pdf` (`preguntar` por defecto: con `--json` o sin TTY no genera). Solo para el PDF (ARCA no los recibe): `--descripcion `, `--condicion-venta ` (`--cv`; JSON `condicionVenta`), `--sin-condicion-venta`, `--receptor-nombre `, `--receptor-domicilio `. Antes de pedirlo: `arcli pdf instalar` (sin TTY nunca se descarga solo) y `emisor.razonSocial`, `emisor.domicilio` y `emisor.inicioActividades` en la config. Valores y detalle: https://github.com/LcsGrz/arcli/blob/main/docs/pdf.md. ## Modo no interactivo Sin `--emitir` ni `--previsualizar`, decide `"emitir"` del JSON de `--cargar` y, si no está, `config.emitir`. Si nada pide emitir y la sesión es interactiva (TTY), ARCLI muestra una vista previa y pregunta. **Con `--json`, o cuando stdin/stdout no son un TTY (scripts, agentes, CI), nunca pregunta**: no emite, salvo que el JSON de `--cargar` tenga `"emitir": true` (en un lote, cada elemento decide) o `config.emitir` sea `true`, y en esos casos emite sin confirmar. `--previsualizar` en el comando pisa lo que diga el archivo (en producción también, si `config.entorno` es `produccion`). ## Forma del JSON de `--cargar` (un objeto o un array de estos) ```json { "concepto": "servicios", "ivaReceptor": "consumidor-final", "tipoDocumento": "consumidor-final", "numeroDocumento": 0, "montoTotal": 1000, "puntoVenta": 3, "codigoMoneda": "ARS", "cotizacionMoneda": 1, "vencimientoPago": "10/11", "previsualizar": true, "pdf": true, "descripcion": "Servicios del mes", "condicionVenta": "contado", "receptorNombre": "Cliente SA", "receptorDomicilio": "Calle 1" } ``` `tipoDocumento` es `consumidor-final`, `cuit`, `cuil` o `dni`. Un lote es un array de comprobantes del tipo del comando (`arcli fc --cargar` son todos facturas C); `indice` empieza en 1, en las respuestas y en los errores del lote. Las claves son las de este ejemplo más `emitir`, `fechaComprobante`, `servicioDesde`, `servicioHasta` (fechas como en los flags; `dia` está deprecado, usá `vencimientoPago`), `alicuotaIva`, `alicuotas` (`[{tasa, monto}]`), `importeExento`, `importeNoGravado`, `mismaMoneda`, `vencimientoPago`, `condicionVenta`, `cbu`, `aliasCbu`, `transferencia` y, solo en notas, `comprobanteAsociado` (`{atajo|tipo, puntoVenta, numero, cuit, fecha}`), `periodoAsociado` (`{desde, hasta}`) y `anulacion`. Lista y equivalencia con los flags: https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md. Una clave desconocida (`montototal`, `vencimiento`, `moneda`) o un tipo incorrecto (`"puntoVenta": "3"`, `"emitir": "true"`, `null` salvo en `condicionVenta`) es `INPUT_VALIDATION_ERROR` (en un lote, `BATCH_VALIDATION_ERROR` con el índice): no se ignora. Números sin comillas. ## Forma de la respuesta (`--json`, sin `--bruto`) ```json { "atajo": "fa", "comprobante": "Factura A", "tipoArca": 1, "estado": "aprobado | observado | rechazado | previsualizacion", "resultado": "A | R | P | null", "cae": "string | null", "caeVencimiento": "YYYYMMDD | null", "entorno": "testing | produccion", "puntoVenta": 3, "errores": [{ "codigo": 10016, "mensaje": "texto de ARCA" }], "eventos": [{ "codigo": 1, "mensaje": "texto de ARCA" }], "deprecado": ["opcional: claves de esta respuesta que se sacan en la 3.0.0 y qué usar"], "observaciones": ["..."], "observacion": "string | null", "numero": "number (número emitido) | null (previsualización)", "avisos": ["texto: padrón, régimen FCE, certificado por vencer, flags salteados…"], "solicitud": { "...": "payload enviado a ARCA; si se emitió, con CbteDesde/CbteHasta" }, "previsualizacion": true, "sugerencias": ["texto en español sugiriendo cómo resolver errores comunes de ARCA"], "pdf": { "ruta": "/ruta/al/archivo.pdf" } } ``` En la E (`fe`, `nce`, `nde`) el objeto agrega `exportacion` (`cliente`, `comprobanteAsociado` —`null` en la factura; en las notas `{atajo, tipoArca, puntoVenta, numero, fecha, total}`—, `destino`, `domicilioCliente`, `incoterm`, `items`, `permisos`, `tipoExpo`), `numero` sale también en la vista previa y `solicitud` es el `Cmp` de WSFEX con los nombres de ARCA (`Dst_cmp`, `Moneda_Id`, `Items.Item`…). `pdf` aparece solo si se intentó generar el PDF. Si falló es `{ "error": { "codigo", "mensaje", "sugerencia" } }` (`PDF_PLUGIN_MISSING`, `PDF_PLUGIN_INSTALL_ERROR`, `PDF_ISSUER_INCOMPLETE`, `PDF_GENERATION_ERROR`) y el exit code sigue siendo `0`: el comprobante ya está emitido, **no reemitir para obtener el PDF**. Con `--cargar` y un array la salida es un array de estos objetos (con `indice`), aunque el array tenga un solo elemento; con un objeto o con flags, un objeto. Con `--bruto` se agrega `respuesta` con la respuesta cruda del SDK; el resto de los campos no cambia. `"estado": "rechazado"` es una respuesta válida, no un error (exit code `2`, ver "Exit codes"). `observado` es aprobado (tiene CAE). `previsualizacion` = vista previa: no se emitió nada. ## Salida de error Sin `--json` (ni `json=true` en la config): panel de texto en stderr. Con `--json` o `json=true`: JSON en stderr con la forma `{"codigo": "...", "detalles": {...} | [{mensaje, ruta}] | null, "error": "mensaje", "sugerencia": "..." | null}`. `detalles` es un array solo en los errores de validación de esquema. `codigo` es `CONFIGURATION_ERROR`, `INPUT_VALIDATION_ERROR`, `EMISSION_UNCERTAIN` (falló la llamada que emite, no el login ni el pedido del último número: puede haberse emitido igual; antes de reintentar, verificar con el `arcli ultimos --pv ` que viene en `sugerencia`), `TRANSIENT_ERROR` (WSAA o ARCA ocupados, en cualquier comando: esperar unos segundos y reintentar sin cambios; en facturación sale antes de emitir), `WSFE_SERVICE_NOT_AUTHORIZED` (facturación, `ultimos` o `consultar`: el certificado no está autorizado a facturar; no se emitió nada, avisale a la persona), `ARCA_LAST_VOUCHER_ERROR` (facturación o `ultimos`: ARCA rechazó el pedido del último número, por ejemplo con un punto de venta no habilitado; no se emitió nada), `CERTIFICATE_EXPIRED` (el certificado del entorno venció: se corta antes de ARCA, no se envió nada; `detalles.entorno` y `detalles.vencimiento`, la guía en `sugerencia`; también en `certificado importar` si el `.crt` ya venció), `UNEXPECTED_ERROR` (sin código propio: red, login en WSAA rechazado como `cms.cert.untrusted` o `LoginFault`, respuesta inesperada; en facturación sale antes de la llamada que emite, así que no se emitió nada. Si `error` habla del certificado, no reintentes), `VOUCHER_NOT_FOUND` (`consultar`), o en un lote (`--cargar` con un array, aunque tenga un solo elemento) `BATCH_VALIDATION_ERROR` (no se emitió ninguno; `detalles.comprobantes` lista cada `{indice, error}`) y `BATCH_EMISSION_ERROR` (se cortó a mitad: los resultados ya procesados salen antes por stdout; si viene `detalles.sinConfirmar`, verificar ese índice con `arcli ultimos` antes de reintentarlo; después reintentar `detalles.sinProcesar`, nunca los ya emitidos). En consultas: `TAXPAYER_NOT_FOUND` (`padron`), `PADRON_SERVICE_NOT_AUTHORIZED` (`padron`; al facturar no corta, usa la config con un aviso), `FCE_SERVICE_NOT_AUTHORIZED` y `FCE_OBLIGATION_ERROR` (`fce-obligado`; con `verificarFce` al facturar salen como aviso), `ARCA_UNAVAILABLE` (`estado`: cualquier falla, también de login; si `error` menciona `cms.cert` o `LoginFault`, es el certificado), `ARCA_PARAMETERS_ERROR` (`parametros `) y `ARCA_QUOTATION_ERROR` (`parametros cotizacion`, o facturar en moneda extranjera sin `--cm`, con o sin `--misma-moneda`; con `--cm` no consulta). En `fe`: `WSFEX_SERVICE_NOT_AUTHORIZED` y `ARCA_EXPORT_ERROR` (WSFEX rechazó una consulta previa: tabla, ID de solicitud o cotización; no se emitió nada). `EMISSION_UNCERTAIN` en `fe` trae `detalles.numero` y `detalles.idSolicitud`: reintentar con esos mismos `--numero` e `--id-solicitud`, nunca con otros (ARCA no autoriza dos veces el mismo número). Los errores de `arcli certificado` están en "Otros comandos". `PDF_PLUGIN_INSTALL_ERROR` sale de `arcli pdf instalar`. `sugerencia` está siempre: `null` si no hay nada que sugerir. Qué hacer con cada código: tabla "Códigos de error" de https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md. Los errores de uso (opción desconocida, valor faltante, comando inexistente) también salen en este JSON como `INPUT_VALIDATION_ERROR`, con el mensaje de commander en `error`. ## Comando `config` ```bash arcli config # ver config actual (agregar --json) arcli config revisar # revisa la config de los dos entornos localmente, sin ir a ARCA (agregar --json) arcli config ruta [--json] # path del archivo de config ({"ruta": ...}) arcli config establecer arcli config eliminar ``` Claves válidas: `cuit`, `cbu`, `aliasCbu` (solo facturas FCE), `verificarFce`, `consultarPadron` (por defecto `true`), `alicuota`, `puntoVenta`, `filasPorLista` (1 a 50, por defecto 15: filas de `ultimos` y de las listas del modo interactivo; `comprobantesPorLista` es su nombre viejo, deprecado: se lee y `config establecer` la guarda como `filasPorLista`, hasta la 3.0.0), `concepto`, `ivaReceptor`, `moneda`, `cotizacion` (deprecada: se saca en la 3.0.0; mejor `--cm` o la oficial), `entorno` (`testing`/`produccion`), `emitir`, `json`, `bruto` (booleanos: `true/false`, `si/no`, `1/0`), `cert.testing`, `cert.produccion`, `key.testing`, `key.produccion` (rutas a archivos PEM, se validan al guardar), `exportacion.cert.testing`, `exportacion.cert.produccion`, `exportacion.key.testing`, `exportacion.key.produccion` (credenciales propias de WSFEX para la factura de exportación; si faltan, se usan `cert.*`/`key.*`), `exportacion.actividad` (código de la tabla de actividades de WSFEX para la `E`; `--actividad` lo pisa), `ticketPath` (carpeta donde se cachea el ticket WSAA; por defecto una carpeta junto al archivo de config). Para el PDF: `pdf` (`siempre`/`preguntar`/`nunca`), `pdfCarpeta` (por defecto `~/arcli/comprobantes`; una subcarpeta por CUIT emisor, los de testing en `testing//`, y nunca se pisa un PDF existente: se suma `-2`, `-3`), `pdfNavegador` (ruta a Chrome/Chromium/Edge), `condicionVenta` (default de `--condicion-venta`; se omite por comprobante con `--sin-condicion-venta` o JSON `null`), `emisor.razonSocial`, `emisor.domicilio`, `emisor.inicioActividades` (fecha con año), `emisor.iibb`, `emisor.condicionIva`, `emisor.logo` (PNG o JPG). `config revisar` también avisa si un certificado ya venció o vence en menos de 30 días, y revisa el plugin de PDF (chequeo "Plugin de PDF": instalado, versión y navegador; si falta, solo avisa con `pdf=siempre`). Con `--json` devuelve `{ok, chequeos: [{categoria: "ok"|"warning"|"error", etiqueta, detalle}]}`; `ok: false` sale igual con exit code `0`. `arcli config --json` devuelve la config con las rutas enmascaradas (`cert`, `key`, `emisor` y `exportacion` como objetos). Si `filasPorLista` tiene valor, también trae `comprobantesPorLista` con el mismo (deprecada) y `deprecado`. Además, a menos de 30 días de vencer cualquiera de los certificados configurados (testing o producción, sin importar el entorno en uso), cada comando que va a ARCA avisa en stderr (nunca en stdout) y la facturación lo suma a `avisos` del JSON. ## Otros comandos - `arcli ultimos [--cantidad N] [--pv N] [--json]`: últimos comprobantes emitidos (de 1 a 50; por defecto `config.filasPorLista` o 15), del más nuevo al más viejo. `tipo` es el atajo (`fb`, `nca`, `rc`, `fe`, `nde`, `nce`…). La E sale con `cliente`, `destino`, `moneda`, `total` y `comprobanteAsociado` en lugar de receptor e importes. - `arcli consultar [--pv N] [--json]`: detalle de un comprobante emitido (CAE, vencimiento, importes, receptor). Si no existe, el error es `VOUCHER_NOT_FOUND`. Sirve para verificar después de emitir, también la E (`EMISSION_UNCERTAIN` de la E sugiere `arcli consultar fe `). - `arcli certificado generar [--testing|--produccion] [--alias ] [--reemplazar] [--json]`: crea la clave privada y el CSR para subir a ARCA en `certificados//` junto a la config (sin `openssl`). La clave queda pendiente: la activa sigue andando hasta importar. Con un pedido pendiente da `CERTIFICATE_REQUEST_PENDING`; `--reemplazar` lo descarta. El JSON trae `csr`, `pasos`, `rutaCsr` y `rutaClave`. Un agente nunca ve la clave fiscal: la persona sube el CSR y baja el `.crt` en ARCA. - `arcli certificado importar [--testing|--produccion] [--reemplazar] [--json]`: valida el `.crt` de ARCA (X.509, CUIT, vencimiento, que corresponda a la clave del pedido), deduce el entorno del emisor, lo guarda y configura `cert.`/`key.`. Devuelve `{alias, cuit, entorno, reemplazado, rutaCertificado, rutaClave, vence}`. Si ya había otro certificado configurado, sin TTY o con `--json` hace falta `--reemplazar` (si no, `CERTIFICATE_REPLACE_CONFIRMATION`). Otros errores: `CERTIFICATE_INVALID`, `CERTIFICATE_CUIT_MISMATCH`, `CERTIFICATE_EXPIRED`, `CERTIFICATE_ENVIRONMENT_UNKNOWN`, `CERTIFICATE_KEY_MISMATCH`. - `arcli padron [--json]`: consulta en ARCA (`ws_sr_constancia_inscripcion`) nombre, domicilio fiscal, `condicionIva` (`responsable-inscripto`, `responsable-monotributo`, `sujeto-exento` o `null` si no se puede deducir), impuestos y actividades. CUIT inexistente: error `TAXPAYER_NOT_FOUND`. - `arcli fce-obligado [--fecha ] [--json]`: consulta en ARCA (`wsfecred`) si el receptor está obligado a recibir FCE y desde qué monto. Requiere autorizar `wsfecred` en ARCA además de `wsfe`. - `arcli completado [instalar|desinstalar] [shell]`: autocompletado con Tab para personas; un agente no lo necesita. - `arcli acceso-directo [ruta] [--json]`: crea un ícono para abrir el modo interactivo con doble clic, en el escritorio o en la carpeta `ruta`, que tiene que existir: `{reemplazado, ruta, usaArcliInstalado}`. Es para personas; un agente no lo necesita. Si Windows no puede crearlo, da `DESKTOP_SHORTCUT_ERROR`. - `arcli pdf [estado|instalar|desinstalar] [--json]`: plugin que genera los PDFs. `arcli pdf instalar` lo descarga sin preguntar (sirve en scripts). - `arcli estado [--json]`: si ARCA responde y si el punto de venta configurado está habilitado: `{entorno, latenciaMs, listo, puntoVentaDetalle: {estado, numero, tipoEmision}, servidores: {aplicacion, baseDeDatos, autenticacion}}`, más `puntoVenta` (el mismo objeto, deprecado: en la 3.0.0 pasa a ser el número) y `deprecado`. `listo: true` = se puede emitir; `listo: false` sale igual con exit code `0`, así que hay que leer `listo`. En testing ARCA no informa puntos de venta (`puntoVentaDetalle.estado: "sin-datos"`). No acepta `--pv`: usa el de la config. Si ARCA no responde, o falla el login, error `ARCA_UNAVAILABLE`. - `arcli parametros [tabla] [--json]`: tablas de ARCA vigentes: `puntos-venta`, `comprobantes`, `documentos`, `alicuotas`, `iva-receptor`, `monedas`, `conceptos`, `opcionales`, `tributos`. Sin tabla: `{tablas: [{tabla, descripcion}]}`; con tabla: `{entorno, tabla, valores: [{id, descripcion, detalle, vigenteHasta}]}`. `arcli parametros cotizacion USD` da la cotización oficial (`{cotizacion, entorno, fecha, moneda}`, con `moneda` en código ARCA: `DOL`). - `arcli ejemplos`: comandos listos para copiar por cada tipo de comprobante. - `arcli ayuda` o `--ayuda`: ayuda contextual con ejemplos (nota: el flag estándar `--help` de commander está deshabilitado, usar `--ayuda` o el subcomando `ayuda`). ## Más detalle Los docs no vienen en el paquete de npm: están en GitHub y en https://arcli.com.ar/. Todo junto para leer de una vez: https://arcli.com.ar/llms-full.txt. Cada página del sitio también está en Markdown, con la ruta terminada en `.md` (por ejemplo `referencia/comandos.md`). - https://github.com/LcsGrz/arcli/blob/main/docs/cli-reference.md: referencia completa de comandos y flags. - https://github.com/LcsGrz/arcli/blob/main/docs/configuration.md: config persistente, claves soportadas, ticketPath. - https://github.com/LcsGrz/arcli/blob/main/docs/validation-rules.md y https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md: reglas de validación y formatos de entrada/salida, con el JSON de cada comando y los códigos de error. - https://github.com/LcsGrz/arcli/blob/main/docs/troubleshooting.md: errores comunes de ARCA y cómo resolverlos. - https://github.com/LcsGrz/arcli/blob/main/docs/pdf.md: PDF de comprobantes, plugin, carpeta y nombre del archivo. - https://github.com/LcsGrz/arcli/blob/main/docs/modo-interactivo.md: asistente interactivo (un agente no debe usarlo). - https://github.com/LcsGrz/arcli/blob/main/AGENTS.md: para agentes que van a modificar el código de este repo (no para usar el CLI).