Icono de ges.com.es ges.com.es

Integraciones: API y webhooks

Si tu plan incluye acceso API (puedes comprobarlo en tu plan), puedes conectar GES con otras aplicaciones desde Integraciones. Esta sección está disponible solo para el rol Admin.

Tokens de API

En Tokens de API puedes generar tokens para integrar aplicaciones de terceros con tu cuenta (por ejemplo, tu propio ERP, una tienda online, o cualquier sistema que quieras que cree facturas en GES automáticamente).

Para cada token indicas:

  • Nombre: para identificar qué aplicación o integración lo usa.
  • Fecha de expiración (opcional): si quieres que el token deje de funcionar pasado un tiempo.

El token se muestra una única vez al crearlo — cópialo y guárdalo en un lugar seguro, porque GES no volverá a mostrártelo. Si sospechas que un token se ha visto comprometido, elimínalo desde esta misma página: dejará de funcionar de inmediato.

Con este token, un sistema externo puede, entre otras cosas, listar tus series, direcciones, formas de pago y clientes, y crear facturas directamente a través de la API, sin pasar por la interfaz de GES.

Webhooks

En Webhooks puedes configurar URLs para recibir notificaciones cuando tus facturas creadas mediante la API sean procesadas por la AEAT. Es decir: en lugar de tener que consultar tú el estado de cada factura, GES avisa automáticamente a tu sistema cuando ocurre alguno de estos eventos:

  • Factura pendiente en la AEAT: se ha enviado y está esperando respuesta.
  • Factura notificada a la AEAT: la AEAT la ha aceptado.
  • Factura rechazada por la AEAT: la AEAT la ha rechazado.
  • Error al enviar la factura a la AEAT: ha ocurrido un problema técnico en el envío.

Al crear un webhook indicas la URL de tu sistema que va a recibir la notificación y seleccionas a qué eventos te quieres suscribir. Cada webhook incluye un secreto que te permite verificar que la notificación viene realmente de GES.

Esta funcionalidad está pensada para equipos técnicos que integren GES con sus propios sistemas; si no vas a automatizar la creación de facturas desde fuera de GES, no necesitas configurar nada en esta sección.