> ## 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.

# Desarrolladores

> Genera llaves API y configura webhooks para integrar Yafacture con tus sistemas

## ¿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

<Frame caption="Vista del tablero principal">
  <img src="https://cdn.yafacture.com/docs/developers_1.png" alt="Tablero en Yafacture" />
</Frame>

### ¿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

<Steps>
  <Step title="Toca Crear token">
    Presiona el botón **Crear token** en la parte inferior de la pantalla.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Úsalo en tus solicitudes">
    Incluye el token en el encabezado de autorización de cada solicitud a la API de Yafacture.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

### 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

<Frame caption="Vista del tablero principal">
  <img src="https://cdn.yafacture.com/docs/developers_2.png" alt="Tablero en Yafacture" />
</Frame>

### ¿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

<Steps>
  <Step title="Toca Crear webhook">
    Presiona el botón **Crear webhook** en la parte inferior de la pantalla.
  </Step>

  <Step title="Ingresa la URL">
    Escribe la URL de tu servidor que recibirá los eventos (debe ser accesible desde Internet).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Guarda">
    Presiona **Guardar**. Yafacture comenzará a enviar eventos a tu URL de inmediato.
  </Step>
</Steps>

### Panel de detalle de webhook

Al tocar **›** en un webhook existente verás:

| Campo                 | Descripción                         |
| --------------------- | ----------------------------------- |
| **URL de webhook**    | La URL de destino configurada       |
| **Fecha de creación** | Cuándo se registró el webhook       |
| **Eventos suscritos** | Lista 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.

<Info>
  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.
</Info>

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Cuántas llaves API puedo crear?">
    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.
  </Accordion>

  <Accordion title="¿Cómo uso la llave API en mis solicitudes?">
    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.
  </Accordion>

  <Accordion title="¿Qué pasa si mi servidor de webhook no está disponible?">
    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.
  </Accordion>

  <Accordion title="¿Puedo tener varios webhooks apuntando a diferentes URLs?">
    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.).
  </Accordion>
</AccordionGroup>

***

<CardGroup cols={2}>
  <Card title="Documentación API" icon="book" href="/api-reference/introduccion">
    Consulta la referencia completa de la API REST de Yafacture con ejemplos de código.
  </Card>

  <Card title="Usuarios" icon="users" href="/ajustes/usuarios">
    Administra los usuarios de tu empresa y sus permisos de acceso.
  </Card>
</CardGroup>