Hito completado, factura emitida

curl -X POST https://app.beel.es/api/v1/invoices \
  -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "STANDARD",
    "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" },
    "lines": [
      {
        "description": "Monthly subscription",
        "quantity": 1,
        "unit_price": 29.00,
        "discount_percentage": 0
      }
    ]
  }'

Sandbox con prefijo beel_sk_test_. Idempotency-Key = milestone_id para evitar duplicados si la automatización se reintenta.

1. 1

   Defines hitos y precios en tu CRM

   Cada proyecto lleva sus hitos facturables (anticipo 30%, prototipo 30%, entrega 40%). Guardas el customer_id de BeeL. y el importe por hito en tu base de datos.

2. 2

   Tu equipo marca el hito como completado

   Cuando el entregable se cierra, el cambio dispara un webhook o una automatización (n8n, Make, Zapier) con los datos del hito — customer_id, importe, descripción.

3. 3

   La automatización llama a POST /invoices

   Tu sistema hace la llamada REST a BeeL. con el Idempotency-Key = milestone_id. BeeL. genera la factura, le asigna número y la registra en Verifactu.

   Node.js

   import { BeeL } from '@beel_es/sdk';
   
   const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! });
   
   // Create a draft invoice
   const invoice = await beel.invoices.create({
     type: 'STANDARD',
     recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' },
     lines: [
       { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 },
     ],
   });
   
   // Issue it to assign an invoice number and trigger VeriFactu
   const issued = await beel.invoices.issue(invoice.id);
   console.log(issued.invoice_number); // e.g. "A-2026/0001"

4. 4

   Cliente recibe PDF automáticamente

   BeeL. envía el PDF profesional con tu logo al email del cliente. El cliente lo contabiliza en segundos. Puedes incluir link de pago si usas Stripe o similar.

5. 5

   Tu CRM se actualiza con el invoice_id

   Guardas el invoice_id en tu CRM enlazado al hito para trazabilidad. Tu dashboard pasa de 'pendiente' a 'facturado' y alimenta tus reportes financieros.