Ir al contenido

API y webhooks

Actualizado:

Claves API con validez y lista de IP, webhooks y el feed BI en Configuración → Integraciones y API.

Abrir Configuración en Fiatto
En este artículo

Además de SSO/SCIM y la conexión contable, Fiatto ofrece una API REST, webhooks y un feed BI. Los administradores los gestionan en Configuración → Integraciones y API (/dashboard/settings/integraties).

Pasos

  1. Abre Configuración (menú de cuenta) → tarjeta Integraciones y API.
  2. Crea una clave en Claves de API: escribe un nombre, elige la Validez (30, 90 o 180 días o 1 año) y, si quieres, rellena Direcciones IP permitidas (una dirección o rango CIDR por línea). Pulsa Crear clave y cópiala enseguida: solo la ves una vez. En el sandbox la clave lleva _test_ en el nombre y solo funciona en el entorno de prácticas.
  3. Mantén los permisos al mínimo. Una clave API (scope api) funciona en /api/v1: leer y escribir solicitudes de compra, facturas de compra, contratos, proveedores y programas; leer y crear clientes y pedidos de venta; leer y presentar tickets jurídicos; solo lectura para facturas y contratos de venta, pedidos de compra, recepciones y pagos. Un pedido de venta creado por la API llega como borrador, con los mismos controles que en pantalla (como el límite de crédito) y una Idempotency-Key obligatoria. Los traspasos fijos entre módulos se leen como feed en /api/v1/handovers. El libro mayor (asientos y balance de comprobación) y el registro de auditoría para un SIEM se activan por separado en cada clave; solo un aprobador o contable puede conceder acceso al libro mayor. Una clave del Conector BI (Power BI / Excel) tiene el scope bi.read y solo funciona en el feed OData de solo lectura.
  4. Añade un endpoint en Webhooks, elige los eventos y envía un evento de prueba; las entregas fallidas aparecen en el registro de entregas. Rotar secreto crea un nuevo secreto de firma; el anterior sigue siendo válido 24 horas. Para cada endpoint eliges el Formato del mensaje: Fiatto (predeterminado) o CloudEvents 1.0 (el estándar abierto; un traspaso llega entonces igual que en el feed). La lista de eventos incluye también los traspasos (handover.*) y el ciclo de vida de los contratos, como contract.created, contract.status_changed, contract.renewed y contract.expired.

Consejos

  • No uses nunca claves API en un navegador o una app móvil. No se pueden prorrogar: crea una clave nueva, ponla en tu integración y revoca la antigua. Los administradores y quien la creó reciben un recordatorio 14 y 3 días antes; una clave sin uso durante 90 días se revoca automáticamente tras un aviso. Una lista de IP solo puede reducirse después (Restringir la lista de IP). En cada clave de API, de BI y de asistente ves cuándo y desde qué dirección se usó por última vez; si aún no tiene lista de IP, Restringir a esta dirección la limita a esa dirección con un clic.
  • Cada clave tiene por defecto un límite de 120 solicitudes por minuto; lee las cabeceras X-RateLimit-* para frenar antes de un 429. La política de versiones está en /api/v1/openapi.json y en las cabeceras Deprecation/Sunset: una versión se anuncia con al menos 12 meses de antelación.
  • Un SIEM puede suscribir un endpoint de webhook al evento de seguridad (inicios de sesión, verificación en dos pasos, cambios de roles y políticas, botón de emergencia, acceso de soporte).
  • En el sandbox, cada endpoint de webhook es un endpoint de prueba: cada entrega lleva la cabecera X-Fiatto-Environment: test (live en tu entorno real), y las claves API y los webhooks de prueba se conservan al vaciar el sandbox. Consulta practicar en el sandbox.
  • Todas las integraciones con su estado, las apps de terceros y el portal para desarrolladores están en Configuración → Integraciones y apps (marketplace) (/dashboard/settings/koppelingen). Conectar Claude o ChatGPT: asistentes de IA externos. Llevarte los datos sin API: exportación de datos.
¿Te resultó útil este artículo?
Ver todos los artículos de este tema

Buscar otra respuesta

Basta con una tarea, una función o una pregunta breve.