Si facturas por código, BeeL. es tu backend

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
      }
    ]
  }'

Ejemplos en sandbox con prefijo beel_sk_test_. Mismo código en producción cambiando la key.

1. 1

   CLI para facturar desde terminal

   Un script que lee un CSV o argumentos, valida localmente y emite facturas con curl o el SDK. Útil para importar datos o facturar lotes de trabajo completado.

   cURL

   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
         }
       ]
     }'

2. 2

   Cron job para facturación recurrente

   Un cron mensual que lee tus clientes recurrentes (retainers, SaaS) y emite facturas el día 1 de cada mes. Logs, alertas a Slack si falla y retries con idempotency-key.

3. 3

   GitHub Actions al mergear a main

   Workflow de CI que factura automáticamente cuando mergeas una PR etiquetada como 'billable'. Metadata del commit alimenta la descripción y el importe.

   GitHub Actions

   # .github/workflows/invoice-on-merge.yml
   name: Invoice on merge
   on:
     push:
       branches: [main]
   
   jobs:
     invoice:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - name: Issue BeeL invoice
           env:
             BEEL_API_KEY: ${{ secrets.BEEL_API_KEY }}
           run: |
             curl -X POST https://app.beel.es/api/v1/invoices \
               -H "Authorization: Bearer $BEEL_API_KEY" \
               -H "Content-Type: application/json" \
               -d @invoice.json

4. 4

   Webhook receiver para Stripe → BeeL.

   Un servidor Express/Fastify que recibe el webhook de Stripe, verifica la firma y llama a POST /invoices con Idempotency-Key = stripe_payment_id. Y lo mismo al revés con los webhooks de BeeL.

   Node.js

   import express from 'express';
   import { WebhookVerifier } from '@beel_es/sdk';
   
   const verifier = new WebhookVerifier(process.env.BEEL_WEBHOOK_SECRET!);
   
   app.post(
     '/webhooks/beel',
     express.raw({ type: 'application/json' }),
     (req, res) => {
       try {
         const event = verifier.verify(
           req.body.toString('utf8'),
           req.headers['beel-signature'] as string,
         );
   
         // event.type is one of:
         //   'invoice.emitted' | 'invoice.email.sent'
         //   'invoice.cancelled' | 'verifactu.status.updated'
         if (event.type === 'verifactu.status.updated') {
           console.log(event.data.new_status); // 'ACCEPTED' | 'REJECTED'
         }
   
         res.status(200).send('OK');
       } catch {
         res.status(400).send('Invalid signature');
       }
     },
   );

5. 5

   Dashboard interno con GET /invoices

   Frontend custom (React, Vue, Svelte) que consume /invoices con filtros por fecha y estado para mostrar facturación, pendientes y métricas sin salir de tu panel interno.

   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"