Cómo configurar VERI*FACTU
Prepara la configuración fiscal VERI*FACTU desde la pestaña Facturación de los ajustes TPV de una ubicación española, usando Marea Gran Via como ejemplo y sin activar envíos reales durante la documentación.
En este artículo
VERI*FACTU se revisa dentro de los ajustes de Facturación TPV de la ubicación. No es un recurso separado: la configuración queda asociada a `tpv_settings.billing_config.verifactu` y se usa después en los flujos de factura.
En el runtime de documentación trabaja con Marea Gran Via, valida país y permisos, y evita autorizar la plataforma o preparar credenciales reales. Guardar la configuración no prueba la conexión con AEAT ni crea registros fiscales.
Antes de empezar
- Iniciar sesión en la aplicación con una cuenta autorizada.
- Trabajar dentro de Grupo Marea Demo y la ubicación Marea Gran Via.
- Usar una ubicación española; VERI*FACTU solo está disponible para `country_code` ES.
- Tener `tpv:view` para consultar la pantalla y `tpv:manage` para editar o guardar.
- Preparar solo valores sandbox o mock para documentación; no usar endpoint, certificado ni envío real de AEAT.
Instrucciones
- 1.
Abre Facturación TPV
Entra en la ruta `${APP_DEEPLINK_BASE}${ORG_ID}/${LOCATION_ID}/location/tpv?tab=billing`. La pantalla carga los ajustes TPV y abre la pestaña Facturación de Marea Gran Via.
- 2.
Comprueba país y permisos
Verifica que la ubicación es española y que los campos son editables. Con `tpv:view` la pantalla sirve para consulta; para guardar cambios hace falta `tpv:manage` en la ubicación.
- 3.
Localiza el bloque VERI*FACTU
En la UI actual puede aparecer como `Conectar con Hacienda`, con estado, modalidad, opción VERI*FACTU y autorización de plataforma. No pulses acciones de autorización real en el runtime de documentación.
- 4.
Define activación, modo y entorno
Activa VERI*FACTU solo cuando proceda y revisa `auto_submit`, `mode` y `environment` según el circuito previsto. `auto_submit` no envía nada al guardar; se usa después al emitir una factura.
- 5.
Completa la integración disponible
Si la build muestra campos técnicos, usa valores sandbox o mock para endpoint o proxy, certificados, timeout, headers y datos del sistema. Si esos campos no están visibles, no los sustituyas por una captura inventada.
- 6.
Guarda cambios
Pulsa Guardar cambios cuando la configuración sea coherente. La app envía el snapshot completo de ajustes TPV y conserva la configuración VERI*FACTU dentro de `billing_config`.
Validaciones y límites
- La integración solo se ofrece para ubicaciones españolas y el backend rechaza `billing_config.verifactu.enabled=true` fuera del allow list de país.
- El guardado exige `tpv:manage`; permisos de uso TPV o KDS no autorizan esta configuración.
- El payload debe ser JSON válido de `TPVSettings` y `billing_config` debe ser un objeto JSON.
- En modo `custom_xml` con VERI*FACTU activo, `endpoint_url` es obligatorio.
- En modo `aeat_soap` activo, si no hay endpoint proxy deben existir `client_cert_file_id` y `client_key_file_id`.
- `headers`, si se informa, debe ser un objeto JSON; `timeout_ms`, si se informa, debe ser numérico, finito y mayor que cero.
- El guardado no prueba conectividad, certificados ni respuesta externa de AEAT.
- La configuración no crea `verifactu_records`; esos registros pertenecen al flujo posterior de emisión o envío de factura.
- El mismo guardado puede fallar por validaciones generales de ajustes TPV, métodos de pago o dispositivos de salida.
Resultado esperado
La ubicación queda con la configuración VERI*FACTU preparada dentro de Facturación TPV, sin haber enviado datos reales ni probado conectividad externa.