Reglas de validación
Resumen rápido:
- primero ARCLI valida flags, tipos y combinaciones
- después aplica reglas de negocio del comprobante
- por último pueden aparecer restricciones o errores propios de ARCA
La idea de esta guía es separar esas tres capas para que sea más fácil entender dónde se rompió el flujo.
1. Validaciones del CLI
Sección titulada «1. Validaciones del CLI»Flags mutuamente excluyentes
Sección titulada «Flags mutuamente excluyentes»--testingy--produccion--emitiry--previsualizar--conceptoy cualquiera de--cs,--cp,--csp--iva-receptor,--iry cualquier--ir-*--acy--at--misma-moneday--cotizacion-moneda/--cm--condicion-venta/--cvy--sin-condicion-venta--exportar-pdfy--sin-pdf- en el JSON de
--cargar,"emitir": truey"previsualizar": truea la vez - combinaciones múltiples de identidad del receptor:
--cuit--cuil--dni--consumidor-final--cfinal
Tipos y formatos
Sección titulada «Tipos y formatos»--montodebe ser un número positivo--dia(deprecado: usá--vencimientoo--vto) debe ser un entero entre1y31. Fija solo el vencimiento: este mes si el día todavía no pasó y si no, el siguiente; si ese mes no tiene ese día (--dia 31en abril), da error. No se combina con--vencimiento/--vto--punto-venta,--pv,--at,--apv,--ardeben ser enteros positivos, escritos solo con dígitos (3ada error)--cuit,--cuil,--acuity--dniaceptan guiones y puntos (20-33333333-4), pero nada más. Lo mismo el CUIT dearcli padron,arcli fce-obligado,config establecer cuitycomprobanteAsociado.cuiten el JSON--atse valida igual que--ac: una NC A no puede asociar una factura B. Si en el JSON vienentipoyatajo, tienen que coincidir--cotizacion-moneday--cmdeben ser números positivos- Todo CUIT o CUIL debe tener 11 dígitos y un dígito verificador válido: un número mal tipeado da error antes de llegar a ARCA
--dnidebe tener 7 u 8 dígitos--condicion-venta/--cv(ycondicionVentaen el JSON o la config) acepta hasta 100 caracteres- En el JSON de
--cargar, una clave desconocida o un tipo incorrecto ("puntoVenta": "3") es error: ver claves desconocidas y tipos
Fechas aceptadas
Sección titulada «Fechas aceptadas»ARCLI interpreta las fechas en formato argentino (día primero), con mes y año opcionales:
DoDDD-MMoD/MMD-MM-YYoD/MM/YYD-MM-YYYYoD/MM/YYYY
Reglas de interpretación:
- “hoy” es siempre el día en Argentina, aunque el equipo esté en otra zona horaria (por ejemplo un servidor en UTC después de las 21 h)
- si omitís el año, ARCLI usa el de la fecha más cercana a hoy: el 5/1/2027,
1/12es el 1/12/2026; el 28/12/2026,10/1es el 10/1/2027. Para una fecha a más de seis meses, escribí el año - si omitís mes y año, ARCLI usa el mes y año actuales
- un año de 2 dígitos se interpreta como
20YY - no se pueden mezclar separadores dentro de la misma fecha (por ejemplo,
5-3/26no es válido)
Formatos como YYYY-MM-DD no son válidos.
Si el formato no coincide, ARCLI corta antes de armar el payload.
Emisión en producción
Sección titulada «Emisión en producción»ARCLI no tiene una regla aparte para producción: emite si --emitir lo pide o, sin --emitir ni --previsualizar, si lo pide "emitir" del JSON de --cargar o config.emitir. Con entorno produccion y emitir true en la config, un comando sin flags emite en producción sin preguntar. Si nada pide emitir, en una terminal se muestra la vista previa y se pregunta; con --json o sin terminal no se emite. Detalle en Emisión en producción.
2. Reglas de negocio
Sección titulada «2. Reglas de negocio»Punto de venta
Sección titulada «Punto de venta»- Puede venir por flags o por config.
- Si falta en ambos lugares, el flujo falla antes de emitir.
Concepto y fechas de servicio
Sección titulada «Concepto y fechas de servicio»productos
Sección titulada «productos»- no usa
--servicio-desde - no usa
--servicio-hasta - no usa
--vencimientoni--dia, salvo en facturas FCE
servicios y productos-servicios
Sección titulada «servicios y productos-servicios»- si informás una fecha de servicio, tenés que informar ambas
- la fecha de inicio no puede ser posterior a la de fin
Vencimiento de pago (FchVtoPago)
Sección titulada «Vencimiento de pago (FchVtoPago)»| Comprobante | ¿Se envía? | Default sin --vencimiento |
Mínimo |
|---|---|---|---|
| Servicios / productos y servicios | sí | el fin del servicio, o la fecha del comprobante si es posterior | fecha del comprobante (10036) |
Factura FCE (fcea, fceb, fcec), incluso de productos |
sí (10163) | la fecha del comprobante o hoy, la que sea posterior | la fecha del comprobante o hoy (10164) |
| NC/ND FCE | no (10175) | — | --vencimiento da error |
| Productos (no FCE) | no | — | --vencimiento da error |
--vencimiento permite separar el vencimiento del período facturado. Por ejemplo, un servicio de febrero facturado el 18/03 que vence el 10/04. --dia (deprecado) sigue las mismas reglas que --vencimiento.
Fecha del comprobante
Sección titulada «Fecha del comprobante»ARCA solo acepta una CbteFch cercana a la fecha de envío (errores 10016 y 10152). ARCLI lo valida antes de llamar al servicio:
| Comprobante | Desde | Hasta | Fecha futura |
|---|---|---|---|
| Productos | hoy − 5 días | hoy + 5 días | solo dentro del mes actual |
| Servicios / productos y servicios | hoy − 10 días | hoy + 10 días | sin restricción de mes |
| FCE (facturas y notas) | hoy − 5 días | hoy + 1 día | solo dentro del mes actual |
ARCA además exige que la fecha no sea anterior a la del último comprobante emitido para ese tipo y punto de venta. Esa regla no se valida localmente, porque depende de lo ya emitido.
Identidad del receptor
Sección titulada «Identidad del receptor»Consumidor final
Sección titulada «Consumidor final»Si usás consumidor final:
- el documento debe ser
0 - el IVA receptor debe ser
consumidor-final: con--consumidor-final(otipoDocumento: "consumidor-final"en el JSON) ARCLI ya lo asume y no hace falta--ir-cf, aunque la config tenga otroivaReceptor. Un IVA explícito distinto (--ir-rmcon--cfinal) es error - el total en pesos tiene que ser menor a
$ 10.000.000. Desde ese monto hay que identificarlo con--dni,--cuito--cuil(RG 5700/2025). En moneda extranjera se comparamonto × cotización.
CUIT, CUIL y DNI
Sección titulada «CUIT, CUIL y DNI»- si el tipo de documento no es
consumidor-final, ARCLI exigenumeroDocumento
IVA receptor
Sección titulada «IVA receptor»ARCLI exige una única fuente de IVA receptor:
--iva-receptor <tipo>--ir <tipo>- un solo
--ir-* --consumidor-final, que implicaconsumidor-final- o un default configurado
Además, la condición tiene que ser válida para la letra del comprobante. ARCLI aplica la misma tabla que devuelve ARCA en FEParamGetCondicionIvaReceptor (error 10243):
| Letra | IVA receptor admitido |
|---|---|
A |
responsable-inscripto, responsable-monotributo, monotributista-social, monotributo-trabajador-independiente-promovido |
B |
sujeto-exento, consumidor-final, sujeto-no-categorizado, proveedor-del-exterior, cliente-del-exterior, iva-liberado, iva-no-alcanzado |
C |
todas |
Si la combinación no es válida, el error sugiere la letra que corresponde. Ejemplo: fb con --ir-ri sugiere usar letra A.
Comprobantes asociados
Sección titulada «Comprobantes asociados»Aplica a:
nota-creditonota-debitonota-credito-electronicanota-debito-electronica
No aplica a:
facturafactura-credito-electronicarecibo(rc)
Para notas, ARCLI acepta un comprobante asociado o un período asociado (PeriodoAsoc), pero no ambos (10197).
Período asociado (--periodo-desde y --periodo-hasta):
- solo en notas comunes: en facturas (10198) y en notas FCE (10196) da error
- requiere las dos fechas
- desde ≤ hasta (10207), y ambas posteriores al 01/01/2006 (10206)
- hasta ≤ fecha de la nota (10208)
Comprobante asociado (si no se usa el período), que necesita:
--aco--at--apvo--asociado-punto-venta--ar--acuit, salvo en NC/ND FCE, donde se puede omitir y toma el CUIT emisor
Con período asociado no hace falta ninguno de estos flags, --acuit incluido.
Además:
- el asociado debe ser una factura o un Recibo C, no otra nota
- la letra debe coincidir
- la categoría electrónica debe coincidir
--afechaes opcional y no puede ser posterior a la fecha de la nota (10159). En NC/ND FCE ARCA la exige (10158): sin--afecha, ARCLI la toma del asociado en ARCA antes de la vista previa; si ARCA no lo tiene o no responde, es error- una nota de crédito no puede superar el total del asociado cuando van en la misma moneda. Se controla antes de la vista previa, con una consulta del asociado en ARCA (
FECompConsultar) por nota que se reusa al emitir, y es unINPUT_VALIDATION_ERRORcon la sugerencia del--montoque la anula entera. Solo se consulta un asociado del propio emisor; si ARCA no responde, la nota sigue con un aviso
Crédito electrónico (FCE)
Sección titulada «Crédito electrónico (FCE)»ARCLI arma Opcionales (los “Adicionales por R.G.”) según el comprobante:
| Comprobante | Opcionales |
Reglas |
|---|---|---|
Factura FCE (fcea, fceb, fcec) |
2101 CBU, 2102 alias (si se informa), 27 transferencia |
El CBU es obligatorio (10168) y tiene 22 dígitos (10165). El alias tiene de 6 a 20 caracteres (10166). La transferencia es SCA o ADC, por defecto SCA (10216). --anulacion da error (10171). |
NC/ND FCE (ncea…ndec) |
22 anulación: S con --anulacion, si no N |
Obligatorio (10173). --cbu, --alias y --transferencia dan error (10172). Sin --afecha, la fecha del asociado sale de ARCA (10158). El asociado tiene que ser del CUIT emisor (10155), así que --acuit se puede omitir. |
| Resto | ninguno | --cbu, --alias, --transferencia y --anulacion dan error (10169). |
Régimen FCE del receptor
Sección titulada «Régimen FCE del receptor»Con config.verificarFce en true, ARCLI consulta wsfecred (consultarMontoObligadoRecepcion) antes de la vista previa. La consulta corre en facturas comunes y FCE con --cuit del receptor, usando la fecha del comprobante. Los avisos posibles son:
| Comprobante | Receptor | Aviso |
|---|---|---|
fa, fb, fc |
obligado y monto (en pesos) ≥ mínimo | Corresponde fcea, fceb o fcec |
fcea, fceb, fcec |
no obligado | Corresponde fa, fb o fc |
fcea, fceb, fcec |
obligado, pero monto < mínimo | Corresponde fa, fb o fc |
Los avisos aparecen en la salida de texto (panel “Avisos”) y en el campo avisos del JSON. No frenan la emisión. Si la consulta falla, por ejemplo porque el certificado no tiene autorizado wsfecred, el motivo también llega como aviso.
config.cbu y config.aliasCbu solo se aplican a facturas FCE. ARCA además exige que el CBU esté registrado a nombre del emisor (10174), cosa que no se puede validar localmente.
Moneda y cotización
Sección titulada «Moneda y cotización»--moneda acepta el código ISO o el de ARCA de cualquier moneda de la tabla de ARCA (arcli parametros monedas) que tenga ISO: ARS → PES, USD → DOL, EUR → 060, UYU → 011… Un código que no está en la tabla se envía tal cual.
| Caso | MonCotiz |
CanMisMonExt |
Regla |
|---|---|---|---|
| Pesos | 1 |
no se envía | Una cotización distinta de 1 da error (ARCA 10039 y 10241). --misma-moneda da error. |
| Moneda extranjera, pago en pesos | --cm o la oficial |
N |
Sin --cm, ARCLI usa la oficial de ARCA y lo avisa. --cm 1 da error. ARCA la acepta entre el 2% y el 400% de la oficial (10119). |
Moneda extranjera, --misma-moneda |
la oficial de ARCA | S |
ARCLI la consulta antes de la vista previa porque ARCA exige el valor exacto (10038). La fecha del comprobante tiene que ser la de hoy: la cotización de un día pasado no se puede consultar y la de uno futuro todavía no existe. |
La clave cotizacion de la config (deprecada) se usa como default en moneda extranjera sin --misma-moneda ni --cm, con un aviso; si vale 1 o no está, se usa la oficial de ARCA.
Factura de exportación (E)
Sección titulada «Factura de exportación (E)»WSFEX tiene su propio contrato: las reglas de concepto, fecha de servicio, IVA receptor, IVA y comprobante asociado no corren para E, y tampoco se usan concepto, ivaReceptor, alicuota, cbu ni aliasCbu de la config.
| Regla | Detalle |
|---|---|
| Requeridos | --monto > 0, --cliente, --domicilio-cliente, --pais-destino, --numero y la actividad (--actividad o exportacion.actividad). Se validan antes de ir a ARCA |
| País de destino | Código (203) o nombre (Brasil), contra la tabla de WSFEX. Argentina (200) da error: para el mercado local van arcli factura a o arcli factura b |
| CUIT del país | --cuit-pais tiene que existir en la tabla de CUIT de países y ser del país de destino. Sin el flag se busca por país, prefiriendo la fila de persona jurídica; si la tabla no trae el país, pide el flag. La tabla nombra cada país con el tipo de entidad (BRASIL - Persona Jurídica), así que el sufijo, los acentos y las mayúsculas no cuentan, y cuando las dos tablas lo nombran distinto (CHINA y CHINA REP.POPULAR) solo se valida que el CUIT exista |
| Ítems | --item con 3 a 5 partes separadas por |: cantidad y precio mayores a 0, descripción obligatoria. La unidad es un código de ARCA o el nombre de la tabla de unidades, sin mayúsculas y con singular o plural (unidad o unidades); una unidad desconocida es error |
| Suma de ítems | Se redondea cada renglón a 2 decimales y la suma tiene que coincidir con --monto. Se valida antes de WSAA, no lo valida ARCA |
--tipo-expo |
1 bienes, 2 servicios (por defecto) o 4 otros |
| Actividad | Entero positivo, de --actividad o de exportacion.actividad; no hay default. El Cmp siempre lleva una Actividad (ARCA rechaza Actividades vacío con el error 2100). Se compara con la tabla de actividades de WSFEX (FEXGetPARAM_Actividades), que no es la del padrón: si el código no está, es error de validación con las actividades que empiezan igual, porque ARCA lo rechaza (error 2105) |
| Bloques vacíos | En la factura, Cmps_asoc y Opcionales no se envían: ARCA rechaza el bloque vacío (error 1820 el de Cmps_asoc) |
--incoterm |
Código de la tabla, sin importar mayúsculas. Si no pasás --incoterms-desc, la descripción sale de la tabla |
--idioma |
Código de la tabla; por defecto 1 (español) |
| Permisos | --permiso requiere --permiso-existente y --permiso-existente sin permisos es error. Se deduplican y solo aplican a --tipo-expo 1: en 2 (servicios) y 4 (otros) ARCA exige Permiso_existente vacío (error 1550), así que ARCLI manda el campo en "" y rechaza los permisos. Sin permisos el campo Permisos no se envía: ARCA lo rechaza (error 1720) cuando Permiso_existente es N |
| Numeración | WSFEX numera por punto de venta y tipo: sin --numero sale del último de ese tipo más uno (FEXGetLast_CMP). --numero, --id-solicitud y --punto-venta son enteros positivos (máximo 99.999.999); sin --id-solicitud sale del último de WSFEX más uno |
| Fecha | La del comprobante no puede ser futura; --fecha-pago por defecto es la del comprobante |
| Moneda | Por defecto DOL (dólares); --moneda acepta ARS/PES y el resto de la tabla de monedas de WSFEX (DOL, PES, 060…). La cotización que falta sale de FEXGetPARAM_MON_CON_COTIZACION, la cotización de aduana de WSFEX, pedida con la fecha del comprobante —por defecto hoy— en yyyymmdd (Fecha_CTZ). ARCA publica la del día una vez por día: hasta entonces se usa la última publicada y la vista previa avisa de qué día es. Para fijar otra, --cotizacion-moneda, que tiene que ser mayor a 1. En pesos la cotización es 1 y --misma-moneda no aplica |
| Defaults de config | Aplican puntoVenta y exportacion.actividad. moneda y cotizacion no: la exportación va en DOL salvo --moneda, con la cotización de aduana de ARCA salvo --cotizacion-moneda. Los de concepto, IVA, CBU y padrón tampoco |
Notas de crédito y débito de exportación (E)
Sección titulada «Notas de crédito y débito de exportación (E)»nce y nde siguen las reglas de la factura E, con estas diferencias. Todo se valida antes de emitir; lo que depende del asociado, después de consultarlo en ARCA (FEXGetCMP).
| Regla | Detalle |
|---|---|
| Asociado | --ar obligatorio. --ac (fe, nde, nce) o --at (19, 20, 21); por defecto una factura E. Si van los dos, tienen que coincidir |
| CUIT del asociado | Siempre el emisor: --acuit con otro CUIT es error (ARCA lo rechaza con el 2031) |
| Existencia | El asociado tiene que existir en ARCA y estar aprobado |
| Datos que hereda | Cliente, domicilio, ID impositivo, destino, CUIT del país, tipo de exportación, moneda, cotización (si la moneda es la misma), idioma, incoterm, forma de pago y actividad |
| Fecha | No puede ser anterior a la del asociado |
| Monto de la NC | No puede superar el total del asociado cuando van en la misma moneda |
Servicios (2) |
Mismo tipo de exportación (2049), destino (2050), moneda o pesos (2051) y cotización (2053) que el asociado. La ND solo ajusta una factura (2041, 2042); la NC no ajusta otra NC (2045) |
| No van | --fecha-pago (1673), --misma-moneda (1605) y --permiso-existente. Permiso_existente va vacío (1550); en bienes, --permiso es opcional y va sin él y Cmps_asoc lleva un solo asociado (1754) |
IVA automático
Sección titulada «IVA automático»ARCLI calcula IVA automáticamente en todos los comprobantes letra A y B, sea cual sea el IVA receptor. Los letra C no informan IVA.
El total se reparte así (ARCA 10048):
ImpTotal = ImpTotConc (--nogravado) + ImpOpEx (--exento) + ImpNeto + ImpIVAImpNetoeImpIVAsalen del resto del total con la alícuota de--alicuota, o la deconfig.alicuota, o21. Se redondean a 2 decimales.config.alicuotano se aplica a letraC.--exento+--nogravadono pueden superar el total. Si lo igualan, no hay neto gravado ni arrayIva.- Con neto mayor a cero siempre se envía el array
Iva, también al 0% (10070). - En letra
C,--alicuota,--exentoy--nogravadodan error, porque ARCA exige que esos importes sean cero.
| Alias | Número | Id ARCA |
|---|---|---|
cero |
0 |
3 |
| — | 2.5 |
9 |
| — | 5 |
8 |
reducida |
10.5 |
4 |
general |
21 |
5 |
incrementada |
27 |
6 |
--alicuota acepta el alias o el número, con coma o punto decimal y un % final (reducida, 10,5, 10.5, 10.5%).
Varias alícuotas en un comprobante
Sección titulada «Varias alícuotas en un comprobante»Repetí --alicuota TASA:MONTO, con el importe de cada alícuota IVA incluido, igual que --monto:
arcli fa --cs --cuit 30709965812 --ir-ri --alicuota general:1210 --alicuota reducida:552,50- Cada monto se parte en neto e IVA según su tasa, y se envía una entrada de
Ivapor alícuota. La suma de los netos esImpNeto(10061). --montopasa a ser opcional. Sin él, el total es la suma de las alícuotas más--exentoy--nogravado. Si lo pasás, tiene que coincidir exactamente con esa suma.- Si la misma alícuota aparece dos veces, se suman sus montos.
- No se puede mezclar
--alicuota TASAcon--alicuota TASA:MONTO, ni repetir--alicuota TASAsin monto. - En JSON:
"alicuotas": [{ "tasa": "general", "monto": 1210 }, { "tasa": "10.5", "monto": 552.5 }].
Recibo C
Sección titulada «Recibo C»El Recibo C (rc, tipo ARCA 15) usa las mismas validaciones y el mismo armado que la Factura C: letra C, sin IVA, sin comprobante asociado y sin FCE. Puede ser el asociado de una nota de crédito o débito C (--ac rc o --at 15). ARCA es quien acepta o rechaza el tipo según el punto de venta y la condición del emisor.
3. Restricciones y errores de ARCA
Sección titulada «3. Restricciones y errores de ARCA»Hay rechazos que ARCLI no puede anticipar: errores transitorios de WSAA (coe.alreadyAuthenticated, Transacción Activa), receptor igual al emisor, observaciones de padrón y fechas anteriores al último comprobante emitido. Ver Troubleshooting y Limitaciones.