Repository navigation
v2.2.0
Trae la factura de exportación E (arcli fe) sobre WSFEX: items, país de destino, incoterm y permisos de embarque, con credenciales propias para wsfex, PDF con el diseño de exportación y modo interactivo. Es todo agregado: los comandos y flags de A, B, C y FCE siguen igual. Gracias a Manuel Aller, que la trajo en #67.
Además suma el autocompletado con Tab, el número del comprobante en el JSON, la validación del dígito verificador de todo CUIT y una ayuda más corta y en español, y corrige varios errores de la revisión del repo.
Dos cambios pueden afectar scripts: los mensajes ahora usan voseo y tildes (si comparás el texto de un error en lugar de codigo), y un montoTotal con más de 2 decimales en el JSON da error en lugar de redondearse. Ver "Cambiado" y "Corregido".
Agregado
arcli feyarcli factura e: emiten o previsualizan la Factura de exportaciónE(tipo 19) con WSFEX. Obligatorios:--monto,--cliente,--domicilio-cliente,--pais-destino(código o nombre),--numeroy la actividad. Opcionales:--id-impositivo,--cuit-pais,--tipo-expo(1bienes,2servicios,4otros),--incoterm,--incoterms-desc,--idioma,--forma-pago,--permisocon--permiso-existente,--id-solicitud,--fecha-pago,--observacionesy--obs-comerciales. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI.feva en la tabla de atajos dearcli --ayuday enarcli ejemplos, y Tab completa la letraeenarcli factura.--numeroobligatorio en laE: WSFEX numera por punto de venta y tipo, pero@arcasdk/coretodavía no permite consultar el último comprobante E. Pasá el siguiente al último que emitiste (1si es el primero).- Actividad de la
E:--actividado la clave nuevaexportacion.actividad(sección "Factura de exportación (E)" dearcli config), con un código de la tabla de actividades de WSFEX, que no es la del padrón. No hay default; un código que no está en la tabla es error de validación con los que empiezan igual. - Flags de otra letra en
arcli factura <letra>: comofacturacomparte el comando para A, B, C y E, los flags que no aplican a la letra elegida se saltean con un aviso en "Avisos" y enavisosdel JSON (factura a --incoterm,factura e --alicuota). Los atajos (fa,fe…) siguen rechazándolos como opción desconocida. --itemcon detalle real:codigo|descripcion|cantidad|precio|unidad, repetible; el código y la unidad son opcionales y la unidad puede ser el código de ARCA o su nombre. La suma de los items tiene que dar--montoy se valida antes de autenticar en WSAA, porque WSFEX no lo controla.--cargarparaE: un objeto, con claves propias (cliente,domicilioCliente,paisDestino,monto,numero,actividad,items,tipoExpo…). El lote no está soportado: un array es error de entrada.exportacion.cert.testing,exportacion.cert.produccion,exportacion.key.testing,exportacion.key.produccion: credenciales del serviciowsfex, para cuando el certificado general no está autorizado a exportación. Si no están las dos de un entorno, se usancert.*/key.*; con la mitad del par configurada el comando corta antes de ir a ARCA. Se muestran en la sección Certificados dearcli config(también en el modo interactivo), se validan como PEM al guardarlas yarcli config revisarlas revisa con el resto. Sin autorización awsfex, el error esWSFEX_SERVICE_NOT_AUTHORIZED.- Defaults de la
E: sin flags, la exportación sale de servicios (Tipo_expo2), en dólares (Moneda_IdDOL), con la cotización de aduana que publica ARCA (si la del día todavía no salió, la última, con un aviso) y con forma de pagoTransferencia Internacional. Las clavesmonedaycotizacionde la config no aplican a exportación. - Salida JSON de exportación: el mismo resumen que A, B y C (
atajo: "fe",tipoArca: 19,comprobante: "Factura de exportación E") más un bloqueexportacioncon cliente, destino, domicilio, actividad, incoterm, items y permisos;solicitudes elCmpde WSFEX, con los nombres de ARCA. Forma exacta en entrada y salida. - PDF de exportación: se guarda como
factura-e_<pv>-<numero>.pdfcon el diseño de exportación de@arcasdk/pdfy los mismos datos que la E de Comprobantes en línea: títuloFACTURA DE EXPORTACIÓN, items de WSFEX, país de destino, CUIT del país con su tipo de entidad, ID impositivo, divisa con su código ISO (USD - Dólar Estadounidense), forma y fecha de pago, incoterm y la leyendaIVA EXENTO OPERACIÓN DE EXPORTACIÓN, sin discriminar IVA. - Factura E en el modo interactivo: se elige en el mismo selector que A, B y C y tiene su propio asistente (cliente, país, tipo, monto, moneda, incoterm en bienes, pago, actividad y número), con vista previa, comando equivalente y PDF. Ver modo interactivo.
- CUIT con dígito verificador y con o sin guiones en todos lados:
arcli padron,arcli fce-obligado,--cuit,--cuil,--acuit,comprobanteAsociado.cuiten el JSON,config establecer cuity el modo interactivo aceptan20-33333333-4o20333333334, y rechazan un CUIT mal tipeado antes de llegar a ARCA. Antesarcli padron 20-20179706-4fallaba y nadie chequeaba el dígito verificador. - Error
ARCA_LAST_VOUCHER_ERROR: si ARCA rechaza el pedido del último número (por ejemplo, con un punto de venta no habilitado para web service), la facturación yarcli ultimoscortan ahí con el mensaje de ARCA y una sugerencia. No se emite nada. - Esc en las preguntas del CLI: "¿Querés emitir … ahora?", que aparece sin
--emitiren una terminal, ahora se cierra con Esc como un "no", igual que en el modo interactivo y en las preguntas del PDF. numeroen el JSON de facturación: el número que le tocó al comprobante emitido (nullen una previsualización), ysolicitudlo trae enCbteDesde/CbteHasta. El panel de texto muestraNúmero: 00003-00000125. Antes el número solo se veía con--bruto.- Autocompletado con Tab para bash, zsh y fish. Se instala con
arcli completado instalar, que agrega una línea al archivo de inicio del shell (~/.zshrc,~/.bashrc…), y se saca conarcli completado desinstalar; también desde el modo interactivo, en Configuración → Autocompletado. Completa comandos y atajos, flags, valores (--iva-receptor,--concepto,--alicuota,--moneda,--transferencia,--ac), claves de config y sus valores, tablas deparametrosy letras de las familias; donde va una ruta, archivos. No hay que reinstalarlo al actualizar arcli. Ver Autocompletado.
Cambiado
- Ayuda más corta y toda en español.
arcli --ayudapasa de unas 145 líneas a 57: los 18 atajos van en una tabla familia × letra ystorybook(herramienta de desarrollo) ya no aparece, aunque sigue funcionando. La ayuda de cada comprobante (arcli fc --ayuda) pasa de 177 a 79 líneas: muestra solo los flags que aplican a ese comprobante, menciona los alias en la opción principal (punto de venta (alias: --pv)) y ya no repite la tabla de parámetros. Los flags ocultos se siguen aceptando igual. "Usage", "Options",[options],<number>y la descripción de--versionahora están en español. - Errores de uso en español: opción o comando desconocido, valor faltante y argumentos de más (
opción desconocida '--montoo' (¿quisiste decir --monto?)). También en elerrordel JSON con--json; elcodigosigue siendoINPUT_VALIDATION_ERROR. - Voseo y tildes en toda la salida: mensajes, ayuda, modo interactivo y PDF ("Usá", "Revisá", "número", "configuración"). Los flags, claves de config, valores (
produccion,cotizacion) y claves JSON no cambian. Si un script compara el texto de un mensaje de error en lugar decodigo, puede necesitar un ajuste.
Corregido
- Punto de venta inválido: la facturación seguía con el número 1 y recién fallaba al emitir con un error confuso, y
arcli ultimosmostraba que no había comprobantes. Ahora cortan conARCA_LAST_VOUCHER_ERROR. - Lote cortado antes de emitir: si el lote se cortaba en el login o en el pedido del último número, el comprobante que falló no figuraba en
detalles.sinProcesardeBATCH_EMISSION_ERROR, y reintentar solo esa lista lo perdía. Ahora figura. Si la emisión quedó sin confirmar, sigue ensinConfirmary no ensinProcesar, como antes. - IIBB en el PDF: sin
emisor.iibb, el PDF decía "Exento"; ahora muestra "-". Si sos exento, configuralo conarcli config establecer emisor.iibb Exento. La configuración guiada del modo interactivo ahora lo pregunta junto a los otros datos del emisor. - Números con letras o notación científica:
config establecer puntoVenta 3aguardaba3, yarcli consultar fc 1e3buscaba el 1000. Ahora dan error, igual que en el modo interactivo. arcli pdf instalarcolgado: con un proxy que no responde, npm o la descarga del navegador no terminaban nunca. Ahora se cortan a los 5 y 15 minutos conPDF_PLUGIN_INSTALL_ERROR.montoTotaldel JSON nunca se redondea: con más de 2 decimales se redondeaba en silencio antes de validar (1.005se emitía por$1). Ahora daINPUT_VALIDATION_ERROR("Use hasta 2 decimales"), igual que--montoy el resto de los importes.consultarPadron falsese respeta siempre: con univaReceptoren la config, facturar con--cuitigual consultaba el padrón y su condición IVA pisaba la de la config.- Aviso falso en
avisos: "--descripcion, --receptor-nombre y --receptor-domicilio solo se usan en el PDF" salía sin haber pasado esos flags, cuando el nombre o el domicilio los había completado el padrón. - Modo interactivo: al generar el PDF, apretar Enter en el nombre o el domicilio del receptor borraba lo que había traído el padrón; ahora lo propone y Enter lo deja. En una FCE se informa el
aliasCbude la config, como con flags. Y si la config tiene una moneda extranjera, el comando equivalente de un comprobante en pesos lleva--moneda ARS, así al pegarlo hace lo mismo. - Leyendas obligatorias en el PDF: los comprobantes B ahora traen el bloque del Régimen de Transparencia Fiscal al Consumidor (Ley 27.743, RG 5614), con el IVA contenido, y los comprobantes A a un monotributista la leyenda de la RG 5003 sobre el crédito fiscal. Salen debajo del CAE. Ver PDF.
Documentación
- Nueva sección de la
Een referencia del CLI y en reglas de validación; credenciales de WSFEX en configuración; items, JSON y limitaciones (--numeroobligatorio, sin notas E, sin lote) en entrada y salida, PDF y limitaciones; el asistente de laEen modo interactivo y sus problemas comunes en troubleshooting.