Actualizar facturación TPV
Guarda la numeración de facturas y las plataformas fiscales operativas del TPV de Marea Gran Via. La pestaña Facturación gestiona series y VERI*FACTU; los datos fiscales del emisor se editan desde Información general y se sincronizan con TPV cuando el usuario también puede gestionarlo.
En este artículo
Usa esta guía cuando un responsable de TPV necesite ajustar cómo se numeran las facturas de una ubicación o dejar preparada una plataforma fiscal disponible para el país. En el demo ES, Marea Gran Via permite documentar VERI*FACTU como plataforma recomendada.
La ficha fiscal del emisor no se edita en la pestaña Facturación del TPV. Razón social, NIF/CIF, dirección y email viven en Información general > Facturación, y Antylogic los replica a la configuración TPV solo si el usuario también tiene permiso de gestión TPV.
Antes de empezar
- Sesión iniciada con Grupo Marea Demo y Marea Gran Via seleccionados.
- Permiso tpv:view o tpv:manage para abrir los ajustes TPV; permiso tpv:manage para guardar cambios.
- Permiso users:view o users:manage si se va a asignar una serie distinta por usuario.
- Permiso customer:manage para editar la ficha fiscal del emisor desde Información general > Facturación.
- Ubicación con country_code ES si se quiere mostrar VERI*FACTU como plataforma disponible.
Instrucciones
- 1.
Abrir Facturación TPV
Entra en location/tpv?tab=billing para Marea Gran Via. La pantalla carga la configuración actual o valores por defecto si todavía no existe una fila de tpv_settings.
- 2.
Revisar la ficha fiscal del emisor
Si necesitas cambiar razón social, NIF/CIF, dirección o email, abre location/general-info?tab=billing y guarda los datos de facturación de la ubicación. En el demo, la ficha se identifica como Marea Gran Via Demo SL.
- 3.
Elegir el modo de series
Selecciona Serie única para usar una sola serie de factura o Por usuario para que cada usuario aceptado de la ubicación pueda tener su propia serie.
- 4.
Asignar series por usuario
Cuando el modo sea Por usuario, revisa la tabla de usuarios y escribe la serie que debe aplicar cada persona. Una serie vacía elimina esa asignación del mapa por usuario.
- 5.
Vincular VERI*FACTU si aplica
En Plataformas de facturación, abre o añade VERI*FACTU. En ubicaciones ES el modal muestra estado, modalidad VERI*FACTU, envío a AEAT y autorización mediante plataforma.
- 6.
Guardar y confirmar
Pulsa Guardar cambios. Antylogic envía el snapshot de ajustes TPV, guarda billing_config, invalida la consulta y rehidrata la pantalla con la configuración persistida.
Validaciones y límites
- Sin tpv:manage, la pantalla puede ser de consulta pero no persiste cambios de facturación TPV.
- Si no existe tpv_settings, el primer guardado crea la configuración por upsert.
- billing_config.series se recorta al guardar; si queda vacío, se guarda A.
- billing_config.series_mode solo debe quedar como single o user.
- Si el usuario actual no puede ver usuarios, no se muestran filas para asignar series por usuario.
- La ficha fiscal exige al menos razón social o nombre comercial; si la sincronización TPV falla, la ficha fiscal queda guardada y se muestra un aviso.
- La configuración de plataformas fiscales debe ser un objeto JSON válido antes de construir el payload.
- VERI*FACTU y TicketBAI solo pueden quedar activos si están disponibles para el país de la ubicación; TicketBAI no debe documentarse como configurable desde la UI actual.
- El modal de plataforma fiscal solo cambia estado local; la persistencia ocurre al pulsar Guardar cambios.
- El endpoint compartido también valida campos no fiscales del snapshot TPV, como métodos de pago, dispositivos y modo de acceso de empleado.
Resultado esperado
La ubicación conserva una configuración tpv_settings.billing_config coherente para facturación: series actualizadas, mapa por usuario si aplica y plataformas fiscales guardadas. La ficha fiscal del emisor sigue mantenida desde Información general y queda sincronizada cuando el usuario tiene permiso para gestionar TPV.