Skip to content

v2.2.0

Choose a tag to compare

@LcsGrz LcsGrz released this 02 Nov 21:23
· 58 commits to main since this release
6ab2cfd

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 fe y arcli factura e: emiten o previsualizan la Factura de exportación E (tipo 19) con WSFEX. Obligatorios: --monto, --cliente, --domicilio-cliente, --pais-destino (código o nombre), --numero y la actividad. Opcionales: --id-impositivo, --cuit-pais, --tipo-expo (1 bienes, 2 servicios, 4 otros), --incoterm, --incoterms-desc, --idioma, --forma-pago, --permiso con --permiso-existente, --id-solicitud, --fecha-pago, --observaciones y --obs-comerciales. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI. fe va en la tabla de atajos de arcli --ayuda y en arcli ejemplos, y Tab completa la letra e en arcli factura.
  • --numero obligatorio en la E: WSFEX numera por punto de venta y tipo, pero @arcasdk/core todavía no permite consultar el último comprobante E. Pasá el siguiente al último que emitiste (1 si es el primero).
  • Actividad de la E: --actividad o la clave nueva exportacion.actividad (sección "Factura de exportación (E)" de arcli 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>: como factura comparte 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 en avisos del JSON (factura a --incoterm, factura e --alicuota). Los atajos (fa, fe…) siguen rechazándolos como opción desconocida.
  • --item con 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 --monto y se valida antes de autenticar en WSAA, porque WSFEX no lo controla.
  • --cargar para E: 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 servicio wsfex, para cuando el certificado general no está autorizado a exportación. Si no están las dos de un entorno, se usan cert.*/key.*; con la mitad del par configurada el comando corta antes de ir a ARCA. Se muestran en la sección Certificados de arcli config (también en el modo interactivo), se validan como PEM al guardarlas y arcli config revisar las revisa con el resto. Sin autorización a wsfex, el error es WSFEX_SERVICE_NOT_AUTHORIZED.
  • Defaults de la E: sin flags, la exportación sale de servicios (Tipo_expo 2), en dólares (Moneda_Id DOL), 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 pago Transferencia Internacional. Las claves moneda y cotizacion de 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 bloque exportacion con cliente, destino, domicilio, actividad, incoterm, items y permisos; solicitud es el Cmp de WSFEX, con los nombres de ARCA. Forma exacta en entrada y salida.
  • PDF de exportación: se guarda como factura-e_<pv>-<numero>.pdf con el diseño de exportación de @arcasdk/pdf y los mismos datos que la E de Comprobantes en línea: título FACTURA 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 leyenda IVA 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.cuit en el JSON, config establecer cuit y el modo interactivo aceptan 20-33333333-4 o 20333333334, y rechazan un CUIT mal tipeado antes de llegar a ARCA. Antes arcli padron 20-20179706-4 fallaba 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 y arcli ultimos cortan 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 --emitir en una terminal, ahora se cierra con Esc como un "no", igual que en el modo interactivo y en las preguntas del PDF.
  • numero en el JSON de facturación: el número que le tocó al comprobante emitido (null en una previsualización), y solicitud lo trae en CbteDesde/CbteHasta. El panel de texto muestra Nú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 con arcli 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 de parametros y 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 --ayuda pasa de unas 145 líneas a 57: los 18 atajos van en una tabla familia × letra y storybook (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 --version ahora 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 el error del JSON con --json; el codigo sigue siendo INPUT_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 de codigo, 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 ultimos mostraba que no había comprobantes. Ahora cortan con ARCA_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.sinProcesar de BATCH_EMISSION_ERROR, y reintentar solo esa lista lo perdía. Ahora figura. Si la emisión quedó sin confirmar, sigue en sinConfirmar y no en sinProcesar, como antes.
  • IIBB en el PDF: sin emisor.iibb, el PDF decía "Exento"; ahora muestra "-". Si sos exento, configuralo con arcli 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 3a guardaba 3, y arcli consultar fc 1e3 buscaba el 1000. Ahora dan error, igual que en el modo interactivo.
  • arcli pdf instalar colgado: con un proxy que no responde, npm o la descarga del navegador no terminaban nunca. Ahora se cortan a los 5 y 15 minutos con PDF_PLUGIN_INSTALL_ERROR.
  • montoTotal del JSON nunca se redondea: con más de 2 decimales se redondeaba en silencio antes de validar (1.005 se emitía por $1). Ahora da INPUT_VALIDATION_ERROR ("Use hasta 2 decimales"), igual que --monto y el resto de los importes.
  • consultarPadron false se respeta siempre: con un ivaReceptor en la config, facturar con --cuit igual 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 aliasCbu de 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