> ## Documentation Index
> Fetch the complete documentation index at: https://ayuda.oden.tax/llms.txt
> Use this file to discover all available pages before exploring further.

# Llaves de API en Oden Tax: crea, revoca y configura webhooks

> Crea llaves de API para integrar Oden Tax con tu sistema, selecciona el emisor con issuer_id en cada petición y configura webhooks para tus eventos.

Si quieres integrar Oden Tax con tu propio sistema, puedes crear llaves de API desde **Cuenta y suscripción > API**. Una llave te da acceso programático a toda la cuenta; cada petición elige el emisor con el parámetro `issuer_id`.

## Requisitos

Para crear llaves de API necesitas estar en el plan Pro. Si tu cuenta tiene un plan inferior, primero actualiza tu suscripción.

<Note>
  Si no ves la sección **API** en **Cuenta y suscripción**, es posible que tu plan actual no incluya acceso a la API. Actualiza tu plan en **Suscripción**.
</Note>

## Crear una llave de API

<Steps>
  <Step title="Ve a la sección API">
    En el panel web, navega a **Cuenta y suscripción > API**.
  </Step>

  <Step title="Inicia la creación">
    Haz clic en **Nueva llave**.
  </Step>

  <Step title="Ponle un nombre descriptivo">
    Usa un nombre que identifique el sistema que consumirá la llave, por ejemplo: `Sistema de ventas` o `ERP`.
  </Step>

  <Step title="Copia el token">
    Una vez creada, el token se muestra en pantalla. Cópialo ahora y guárdalo en un lugar seguro.
  </Step>

  <Step title="Guarda la configuración">
    Confirma y guarda. La llave ya está activa.
  </Step>
</Steps>

<Warning>
  El token solo se muestra una vez, en el momento de crearlo. Si lo pierdes, tendrás que revocar esa llave y crear una nueva.
</Warning>

## Alcance de la llave

Una sola llave cubre toda tu cuenta de Oden Tax, sin importar cuántos emisores tengas registrados. Para indicar qué emisor debe firmar cada CFDI, incluye el parámetro `issuer_id` en el cuerpo de cada petición.

```http theme={null}
POST https://api.oden.tax/v1/cfdi
Authorization: Bearer TU_API_KEY
Content-Type: application/json

{
  "issuer_id": "emi_abc123",
  ...
}
```

## Revocar una llave

Cuando una llave ya no debe usarse, puedes revocarla. La operación es de revocación, no de eliminación, de modo que queda registrada en el historial de auditoría de tu cuenta.

Para revocar una llave:

1. Ve a **Cuenta y suscripción > API**.
2. Localiza la llave en la lista.
3. Haz clic en **Revocar**.

La llave deja de funcionar de inmediato. Cualquier petición que la use después de revocarla recibirá un error de autenticación.

## Webhooks

Puedes configurar una URL para que Oden Tax te notifique en tiempo real cuando ocurran eventos de facturación, por ejemplo cuando se timbra o se cancela un CFDI. Configura tus webhooks en **Cuenta y suscripción > API > Webhooks**.

<Note>
  La referencia técnica completa de la API y los webhooks vive en [docs.oden.tax](https://docs.oden.tax). Esta guía cubre solo la configuración desde el panel.
</Note>