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

# Primers passos

> API de YoFacturo i documentació per a desenvolupadors.

# Sobre YoFacturo

YoFacturo és una plataforma de facturació espanyola que permet a les organitzacions crear, emetre i gestionar factures conforme a la normativa fiscal espanyola, incloent-hi el sistema **VeriFactu** per a la sincronització de factures en temps real amb l'Agència Tributària (AEAT).

## Què pots fer amb l'API

L'API v1 de YoFacturo permet a sistemes externs i integracions:

* **Enviar lots de factures** — envia fins a 1.000 factures per sol·licitud per al seu processament i emissió asíncrons.
* **Consultar l'estat del lot** — consulta l'estat dels lots enviats i inspecciona el resultat del processament de cada factura individual.
* **Monitoritzar la sincronització amb VeriFactu** — comprova si cada factura ha estat sincronitzada amb el sistema fiscal VeriFactu d'Espanya.

## A qui va dirigida aquesta documentació?

Aquesta documentació va dirigida a **desenvolupadors** que integren sistemes de tercers (ERPs, eines de facturació, programari de comptabilitat) amb YoFacturo de manera programàtica mitjançant l'API REST.

Si ets usuari final de l'aplicació web de YoFacturo, visita [app.yofacturo.es](https://app.yofacturo.es).

## Conceptes clau

| Concepte                              | Descripció                                                                                                                                 |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Organització**                      | L'entitat facturadora a YoFacturo. Cada organització té una `api_key` per autenticar les sol·licituds a l'API.                             |
| **Lot de factures** (`invoice_batch`) | Un contenidor d'1–1.000 factures enviades en una única crida a l'API. Els lots es processen de manera asíncrona.                           |
| **Factura del lot** (`batch_invoice`) | Una factura individual dins d'un lot. Registra `processing_status` i `verifactu_state`.                                                    |
| **VeriFactu**                         | Sistema de verificació de factures en temps real d'Espanya, gestionat per l'AEAT. Les factures emeses s'envien automàticament a VeriFactu. |
| **Token de sessió**                   | Token Bearer de curta durada (24 h) obtingut en intercanviar la teva `api_key`. Necessari per a tots els endpoints protegits.              |

## Inici ràpid

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

  <Step title="Intercanvia-la per un token de sessió">
    ```bash theme={null}
    curl -X POST https://app.yofacturo.es/api/v1/auth/sessions \
      -H "Content-Type: application/json" \
      -d '{"api_key": "la_teva_api_key_aqui"}'
    ```
  </Step>

  <Step title="Envia un lot de factures">
    Utilitza el `session_token` del pas anterior com a Bearer token per cridar `POST /api/v1/invoice_batches`.
  </Step>
</Steps>