Ir al contenido
Star104

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.

  • --testing y --produccion
  • --emitir y --previsualizar
  • --concepto y cualquiera de --cs, --cp, --csp
  • --iva-receptor, --ir y cualquier --ir-*
  • --ac y --at
  • --misma-moneda y --cotizacion-moneda / --cm
  • --condicion-venta / --cv y --sin-condicion-venta
  • --exportar-pdf y --sin-pdf
  • en el JSON de --cargar, "emitir": true y "previsualizar": true a la vez
  • combinaciones múltiples de identidad del receptor:
    • --cuit
    • --cuil
    • --dni
    • --consumidor-final
    • --cfinal
  • --monto debe ser un número positivo
  • --dia (deprecado: usá --vencimiento o --vto) debe ser un entero entre 1 y 31. 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 31 en abril), da error. No se combina con --vencimiento/--vto
  • --punto-venta, --pv, --at, --apv, --ar deben ser enteros positivos, escritos solo con dígitos (3a da error)
  • --cuit, --cuil, --acuit y --dni aceptan guiones y puntos (20-33333333-4), pero nada más. Lo mismo el CUIT de arcli padron, arcli fce-obligado, config establecer cuit y comprobanteAsociado.cuit en el JSON
  • --at se valida igual que --ac: una NC A no puede asociar una factura B. Si en el JSON vienen tipo y atajo, tienen que coincidir
  • --cotizacion-moneda y --cm deben 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
  • --dni debe tener 7 u 8 dígitos
  • --condicion-venta / --cv (y condicionVenta en 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

ARCLI interpreta las fechas en formato argentino (día primero), con mes y año opcionales:

  • D o DD
  • D-MM o D/MM
  • D-MM-YY o D/MM/YY
  • D-MM-YYYY o D/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/12 es el 1/12/2026; el 28/12/2026, 10/1 es 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/26 no es válido)

Formatos como YYYY-MM-DD no son válidos.

Si el formato no coincide, ARCLI corta antes de armar el payload.

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.

  • Puede venir por flags o por config.
  • Si falta en ambos lugares, el flujo falla antes de emitir.
  • no usa --servicio-desde
  • no usa --servicio-hasta
  • no usa --vencimiento ni --dia, salvo en facturas FCE
  • si informás una fecha de servicio, tenés que informar ambas
  • la fecha de inicio no puede ser posterior a la de fin
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.

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.

Si usás consumidor final:

  • el documento debe ser 0
  • el IVA receptor debe ser consumidor-final: con --consumidor-final (o tipoDocumento: "consumidor-final" en el JSON) ARCLI ya lo asume y no hace falta --ir-cf, aunque la config tenga otro ivaReceptor. Un IVA explícito distinto (--ir-rm con --cfinal) es error
  • el total en pesos tiene que ser menor a $ 10.000.000. Desde ese monto hay que identificarlo con --dni, --cuit o --cuil (RG 5700/2025). En moneda extranjera se compara monto × cotización.
  • si el tipo de documento no es consumidor-final, ARCLI exige numeroDocumento

ARCLI exige una única fuente de IVA receptor:

  • --iva-receptor <tipo>
  • --ir <tipo>
  • un solo --ir-*
  • --consumidor-final, que implica consumidor-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.

Aplica a:

  • nota-credito
  • nota-debito
  • nota-credito-electronica
  • nota-debito-electronica

No aplica a:

  • factura
  • factura-credito-electronica
  • recibo (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:

  • --ac o --at
  • --apv o --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
  • --afecha es 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 un INPUT_VALIDATION_ERROR con la sugerencia del --monto que la anula entera. Solo se consulta un asociado del propio emisor; si ARCA no responde, la nota sigue con un aviso

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

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

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)

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 + ImpIVA
  • ImpNeto e ImpIVA salen del resto del total con la alícuota de --alicuota, o la de config.alicuota, o 21. Se redondean a 2 decimales. config.alicuota no se aplica a letra C.
  • --exento + --nogravado no pueden superar el total. Si lo igualan, no hay neto gravado ni array Iva.
  • Con neto mayor a cero siempre se envía el array Iva, también al 0% (10070).
  • En letra C, --alicuota, --exento y --nogravado dan 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%).

Repetí --alicuota TASA:MONTO, con el importe de cada alícuota IVA incluido, igual que --monto:

Terminal
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 Iva por alícuota. La suma de los netos es ImpNeto (10061).
  • --monto pasa a ser opcional. Sin él, el total es la suma de las alícuotas más --exento y --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 TASA con --alicuota TASA:MONTO, ni repetir --alicuota TASA sin monto.
  • En JSON: "alicuotas": [{ "tasa": "general", "monto": 1210 }, { "tasa": "10.5", "monto": 552.5 }].

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.

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.

¿Te sirvió esta página?
Editar esta página en GitHub