Invoices

Preview draft invoice PDF

Generates a PDF preview for a draft invoice and returns the binary content directly. **Requirements:** - Invoice must be in BORRADOR (draft) status - The PDF shows "BORRADOR" as the invoice number - No VeriFactu QR code is included **Behavior:** - PDF is generated on-the-fly (not stored) - Each request regenerates the PDF (reflects latest draft changes) - Response is `application/pdf` for direct browser preview

GET
/v1/invoices/{invoice_id}/pdf/preview

Authorization

AuthorizationBearer <token>

API Key authentication.

Format: Authorization: Bearer beel_sk_<key>

Scopes: API Keys use the same scopes as OAuth2 tokens. Each key is created with specific scopes that limit which endpoints it can access. The required scope for each endpoint is documented in the operation's security section under OAuth2.

Obtaining Keys: API Keys are managed from the BeeL dashboard

Security: API Keys are secret credentials. Do not share them or store them in source code

In: header

Path Parameters

invoice_idstring

Invoice ID (must be a draft)

Formatuuid

Response Body

application/pdf

application/json

application/json

application/json

application/json

curl -X GET "https://app.beel.es/api/v1/invoices/550e8400-e29b-41d4-a716-446655440000/pdf/preview"
"string"
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The provided data is not valid",
    "details": {
      "field": "specific error message"
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Mark invoice as sent POST

Marks an invoice as sent manually. **Use case:** When the invoice was sent via WhatsApp, paper, or any other channel outside of the email system. **Status change:** `ISSUED` → `SENT` **Records:** Sets `sent_at` timestamp for tracking. **Note:** Send `Content-Type: application/json` even when body is empty.

Reschedule invoice PATCH

Changes the scheduled date for a scheduled invoice. **Status:** Remains `SCHEDULED` The new date must be today or in the future.