Emite tu primera factura

Estos son los pasos para emitir una factura y enviársela al cliente. Hazlos primero en el entorno de pruebas: ahí TicketBAI se simula y nada tiene validez.

Consulta tu empresa con GET /company/. En series están las series de facturación de la empresa; si quieres usar una concreta, la indicarás en serie al crear la factura.

Crea el cliente con POST /customers/, o busca uno que ya exista con GET /customers/?filter=texto. Guarda su id:

{
    "business_type": "company",
    "business_name": "Tech Solutions S.L.",
    "trade_name": "Tech Solutions",
    "cif": "B12345674",
    "address": "Calle Mayor 1",
    "postal_code": "48001",
    "town": "Bilbao",
    "region": "Bizkaia",
    "country_code": "ES",
    "email": "contacto@example.com"
}

Emite la factura con POST /invoices/. Con issued: true se emite (y, si la empresa está inscrita en TicketBAI, se envía a Hacienda en la misma petición); con issued: false se guarda como borrador:

{
    "customer": "ID_DEL_CLIENTE",
    "issued": true,
    "description": "Servicios de marketing de noviembre",
    "date": "2026-11-11",
    "invoice_lines": [
        {
            "quantity": 1,
            "concept": "Servicios de marketing",
            "unit_price": 100,
            "vat_rate": 0.21,
            "income_type": "7050000000"
        }
    ]
}

La respuesta es la factura emitida, con su id, su número (invoice_number) y sus totales. Si TicketBAI no la acepta, mira qué responde la API al emitir con TicketBAI.

Descarga el PDF con GET /invoices/:id/pdf. El PDF se prepara justo después de emitir la factura: si todavía no está, espera unos segundos y vuelve a pedirlo.
Envíala por email con POST /invoices/:id/email y el cuerpo {}: se envía al email del cliente, con el PDF adjunto. En el entorno de pruebas llega a tu correo, no al del cliente.