SDKs para tu stack favorito

npm install @beel_es/sdk

Java y Python llegan pronto. TypeScript/Node.js ya está publicado en npm.

import { BeeL } from '@beel_es/sdk';

const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! });

// 1. Draft
const draft = await beel.invoices.create({
  type: 'STANDARD',
  recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' },
  lines: [
    { description: 'Consulting', quantity: 1, unit_price: 100, discount_percentage: 0 },
  ],
});

// 2. Issue (assigns number + triggers VeriFactu)
const issued = await beel.invoices.issue(draft.id);
console.log(issued.invoice_number); // "A-2026/0001"

import es.beel.sdk.BeeL;
import es.beel.sdk.generated.model.*;

BeeL beel = new BeeL(System.getenv("BEEL_API_KEY"));

// 1. Draft
Invoice draft = beel.invoices.create(
  new CreateInvoiceRequest()
    .type("STANDARD")
    .recipient(new Recipient().customerId("550e8400-e29b-41d4-a716-446655440000"))
    .addLinesItem(new CreateInvoiceRequestLinesInner()
      .description("Consulting")
      .quantity(1)
      .unitPrice(100.0)
      .discountPercentage(0))
);

// 2. Issue
Invoice issued = beel.invoices.issue(draft.getId());
System.out.println(issued.getInvoiceNumber());

import os
from beel import BeeL

beel = BeeL(api_key=os.environ["BEEL_API_KEY"])

# 1. Draft
draft = beel.invoices.create(
    type="STANDARD",
    recipient={"customer_id": "550e8400-e29b-41d4-a716-446655440000"},
    lines=[{
        "description": "Consulting",
        "quantity": 1,
        "unit_price": 100,
        "discount_percentage": 0,
    }],
)

# 2. Issue
issued = beel.invoices.issue(draft["id"])
print(issued["invoice_number"])

Los ejemplos usan beel_sk_test_ — copia y pega en tu sandbox sin riesgo.

1. 1

   Instala el SDK

   npm install @beel_es/sdk. Tipos TypeScript incluidos, zero dependencias pesadas.

   Node.js

   $ npm install @beel_es/sdk

2. 2

   Configura tu API key de test

   Usa una key con prefijo beel_sk_test_. Nada se envía a la AEAT en modo sandbox, puedes probar todo el flujo sin consecuencias.

   .env

   BEEL_API_KEY=beel_sk_test_a1b2c3d4e5f6g7h8

3. 3

   Crea tu primera factura

   Una llamada a invoices.create() te devuelve el borrador con id. Otra llamada a invoices.issue() la finaliza, asigna número y dispara Verifactu.

   Node.js

   import { BeeL } from '@beel_es/sdk';
   
   const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! });
   
   // 1. Draft
   const draft = await beel.invoices.create({
     type: 'STANDARD',
     recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' },
     lines: [
       { description: 'Consulting', quantity: 1, unit_price: 100, discount_percentage: 0 },
     ],
   });
   
   // 2. Issue (assigns number + triggers VeriFactu)
   const issued = await beel.invoices.issue(draft.id);
   console.log(issued.invoice_number); // "A-2026/0001"

4. 4

   Escucha los eventos

   Suscríbete al webhook verifactu.status.updated para saber cuándo la AEAT acepta tu factura en tiempo real. Firma HMAC verificada por el SDK.

Precios con facturación anual. Ahorra ≈ 20% frente al pago mensual. Al suscribirte aceptas los Términos y Condiciones, incluidas las condiciones de uso de la API.