Documentação

Español

Português
English

Español

Português
English

Appearance

Gestionar NFEs ​

Requisitos previos de acceso

  • Permiso (módulo): viewNFEs (para ver el listado) O manageNFEs (para crear/editar)
  • Licencia/Feature: Ninguna.
  • Contenedor del menú: GENERAL → grupo Contabilidad

Qué es / cuándo usar ​

Esta pantalla administra las configuraciones de NFE (Nota Fiscal Electrónica de Servicio) por tipo de operación. Cada registro define cómo debe emitirse una factura cuando el usuario realiza determinado tipo de transacción (compra de token, aporte, tarifa de servicio, etc.): cuál es el código de servicio municipal, cuál es la descripción que figura en la factura y si la emisión está habilitada. Aquí no se emite la factura al cliente — aquí se define la plantilla fiscal que el emisor de NFE consulta al momento de generar la factura. Las facturas ya emitidas a los usuarios se encuentran en Facturas Emitidas.

Requisitos previos ​

  • Permiso: viewNFEs para ver; manageNFEs para crear/editar (permiso doble — enum CPM en el backend + módulo dinámico en la BD; ambos deben estar registrados para el rol del operador).
  • Licencia/Feature: Ninguna.
  • Dependencias de otras pantallas: la integración con el proveedor de NFE debe estar configurada para que la emisión realmente ocurra. Esta pantalla solo guarda los parámetros de emisión por tipo.

Paso a paso ​

  1. Acceda al menú Contabilidad → Gestionar NFEs.
  2. La tabla lista las configuraciones existentes, identificadas por el tipo de operación.
  3. Haga clic en el ícono editar (lápiz) para ajustar una configuración o en visualizar (ojo) para abrirla en modo lectura.
  4. En la pantalla de edición, complete Código del servicio en la ciudad y Descripción para la factura, y use el toggle Habilitado para activar/desactivar la emisión de ese tipo.
  5. Guarde. Un pie de pantalla (bottom-sheet) solicita confirmación antes de registrar los cambios.

Campos ​

CampoQué es¿Obligatorio?Efecto en el sistema/backend
TipoTipo de operación al que se aplica la configuración (se muestra en el listado)Sí (definido en la creación)Clave que vincula la configuración al tipo de transacción; graba type en la entidad NFEConfigurations. Es el identificador de la plantilla.
Código del servicio en la ciudadCódigo de servicio municipal (lista de servicios de la municipalidad) usado en la facturaSí (para emisión válida)Graba properties.cityServiceCode. Va en el campo de código de servicio de la NFS-e enviada al proveedor. Límite de 20 caracteres.
Descripción para la facturaTexto descriptivo del servicio que aparece en la facturaSí (para emisión válida)Graba properties.description. Compone la descripción del servicio en la factura. Límite de 20 caracteres.
HabilitadoActiva/desactiva la emisión automática para ese tipoNo (desactivado por defecto)Graba enabled. Cuando está desactivado, las transacciones de ese tipo no disparan la emisión de NFE, aunque los demás campos estén completos.

WARNING

El formulario solo habilita el botón Guardar cuando Código del servicio en la ciudad y Descripción están completos. Ambos tienen un límite de 20 caracteres — las descripciones largas deben resumirse.

Acciones y modales ​

  • Nuevo / Crear: abre el formulario en blanco. Al confirmar en el bottom-sheet, llama a createNFE. Si ya existe una configuración para ese tipo (violación de clave única), el sistema muestra el error "iniciales ya existentes" — elija otro tipo o edite el existente.
  • Editar: carga la configuración y guarda mediante saveNFE (PUT). Se muestra un bottom-sheet de confirmación antes de guardar.
  • Visualizar: modo solo lectura; el botón Editar dentro de la pantalla lleva al modo de edición.
  • Cancelar: si hay una edición/creación en curso, solicita confirmación para descartar los cambios antes de volver al listado.

Reglas de negocio / precauciones ​

Atención

  • El Tipo es la clave de la configuración. No es posible tener dos configuraciones para el mismo tipo — el backend lo rechaza por violación de clave única.
  • El toggle Habilitado es el interruptor principal de la emisión de ese tipo: desactivarlo suspende la generación de facturas sin eliminar la configuración.
  • Cumplimiento fiscal: el código de servicio y la descripción deben reflejar el servicio real prestado y el registro municipal de la empresa — campos incorrectos generan facturas inválidas ante la municipalidad.
  • Valores financieros: esta pantalla no gestiona valores; los montos de la factura provienen de la transacción que la originó.

Pantallas relacionadas ​