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>

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.