Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yafacture.com/llms.txt

Use this file to discover all available pages before exploring further.

​
¿Qué es Desarrolladores?

Desarrolladores es la sección donde gestionas la integración técnica de Yafacture con tus propios sistemas. Cuenta con dos pestañas: Llaves API para autenticar solicitudes a la API REST, y Webhooks para recibir notificaciones en tiempo real cuando ocurren eventos en tu cuenta.

​
Pestaña Llaves API

Tablero en Yafacture

​
¿Qué son las llaves API?

Las llaves API (tokens) son credenciales que permiten a tus aplicaciones autenticarse ante la API de Yafacture y ejecutar operaciones programáticamente: timbrar facturas, consultar clientes, mover fondos en la billetera, etc. Cada token tiene el formato yafacture_XXXXXXXX... y se muestra parcialmente enmascarado por seguridad.

​
Crear una llave API

1

Toca Crear token

Presiona el botón Crear token en la parte inferior de la pantalla.
2

Copia tu token

El token completo se muestra una sola vez al crearlo. Guárdalo en un lugar seguro antes de cerrar el diálogo — no podrás verlo completo de nuevo.
3

Úsalo en tus solicitudes

Incluye el token en el encabezado de autorización de cada solicitud a la API de Yafacture.
Trata tus llaves API como contraseñas. No las incluyas en código fuente público ni en repositorios. Si una llave se compromete, elimínala y genera una nueva.

​
Gestionar llaves existentes

Al tocar la flecha › junto a un token puedes ver su detalle y eliminarlo. La lista muestra todos los tokens activos de tu empresa.

​
Pestaña Webhooks

Tablero en Yafacture

​
¿Qué son los webhooks?

Los webhooks son URLs de tu sistema a las que Yafacture envía notificaciones HTTP en tiempo real cuando suceden eventos (crear una factura, actualizar un cliente, registrar un movimiento en la billetera, etc.). Elimina la necesidad de hacer polling a la API para detectar cambios.

​
Crear un webhook

1

Toca Crear webhook

Presiona el botón Crear webhook en la parte inferior de la pantalla.
2

Ingresa la URL

Escribe la URL de tu servidor que recibirá los eventos (debe ser accesible desde Internet).
3

Selecciona los eventos

Elige los módulos y acciones (Leer, Crear, Actualizar, Eliminar) para los que deseas recibir notificaciones. Solo recibirás eventos de los módulos que marques.
4

Guarda

Presiona Guardar. Yafacture comenzará a enviar eventos a tu URL de inmediato.

​
Panel de detalle de webhook

Al tocar › en un webhook existente verás:
CampoDescripción
URL de webhookLa URL de destino configurada
Fecha de creaciónCuándo se registró el webhook
Eventos suscritosLista de módulos y acciones activos
Desde este panel también puedes eliminar el webhook con el ícono de papelera, o modificar los eventos suscritos y guardar los cambios.
Los eventos disponibles para webhooks corresponden a los mismos módulos que los permisos de usuario: Billetera, Facturación, Clientes, Productos, Reportes y más.

​
Preguntas frecuentes

Puedes crear múltiples llaves, por ejemplo una por cada sistema o integración que uses. Esto te permite revocar el acceso de una integración específica sin afectar las demás.
Inclúyela en el encabezado HTTP de autenticación de cada solicitud. Consulta la documentación de la API en la pestaña Documentación API para ver ejemplos en curl, JavaScript, Python y otros lenguajes.
Yafacture intentará entregar el evento. Si tu servidor no responde, el evento puede perderse. Asegúrate de que tu URL de webhook esté siempre activa y responda con un código HTTP 2xx para confirmar la recepción.
Sí. Puedes registrar múltiples webhooks con diferentes URLs y diferentes conjuntos de eventos, útil para enrutar notificaciones a distintos servicios o entornos (producción, staging, etc.).

Documentación API

Consulta la referencia completa de la API REST de Yafacture con ejemplos de código.

Usuarios

Administra los usuarios de tu empresa y sus permisos de acceso.