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

# Primeros pasos

> API de YoFacturo y documentación para desarrolladores.

# Sobre YoFacturo

YoFacturo es una plataforma de facturación española que permite a las organizaciones crear, emitir y gestionar facturas conforme a la normativa fiscal española, incluyendo el sistema **VeriFactu** para la sincronización de facturas en tiempo real con la Agencia Tributaria (AEAT).

## Qué puedes hacer con la API

La API v1 de YoFacturo permite a sistemas externos e integraciones:

* **Enviar lotes de facturas** — envía hasta 1.000 facturas por solicitud para su procesamiento y emisión asíncrona.
* **Consultar el estado del lote** — consulta el estado de los lotes enviados e inspecciona el resultado del procesamiento de cada factura individual.
* **Monitorizar la sincronización con VeriFactu** — comprueba si cada factura ha sido sincronizada con el sistema fiscal VeriFactu de España.

## ¿A quién va dirigida esta documentación?

Esta documentación está dirigida a **desarrolladores** que integran sistemas de terceros (ERPs, herramientas de facturación, software de contabilidad) con YoFacturo de forma programática mediante la API REST.

Si eres usuario final de la aplicación web de YoFacturo, visita [app.yofacturo.es](https://app.yofacturo.es).

## Conceptos clave

| Concepto                               | Descripción                                                                                                                                        |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Organización**                       | La entidad facturadora en YoFacturo. Cada organización tiene una `api_key` para autenticar las solicitudes a la API.                               |
| **Lote de facturas** (`invoice_batch`) | Un contenedor de 1–1.000 facturas enviadas en una única llamada a la API. Los lotes se procesan de forma asíncrona.                                |
| **Factura del lote** (`batch_invoice`) | Una factura individual dentro de un lote. Registra `processing_status` y `verifactu_state`.                                                        |
| **VeriFactu**                          | Sistema de verificación de facturas en tiempo real de España, gestionado por la AEAT. Las facturas emitidas se envían automáticamente a VeriFactu. |
| **Token de sesión**                    | Token Bearer de corta duración (24 h) obtenido al intercambiar tu `api_key`. Requerido en todos los endpoints protegidos.                          |

## Inicio rápido

<Steps>
  <Step title="Obtén tu API key" />

  <Step title="Intercámbiala por un token de sesión">
    ```bash theme={null}
    curl -X POST https://app.yofacturo.es/api/v1/auth/sessions \
      -H "Content-Type: application/json" \
      -d '{"api_key": "tu_api_key_aqui"}'
    ```
  </Step>

  <Step title="Envía un lote de facturas">
    Usa el `session_token` del paso anterior como Bearer token para llamar a `POST /api/v1/invoice_batches`.
  </Step>
</Steps>