INVOICE_DRAFT_NOT_SENDABLE

When it happens

The invoice is not issued yet: a DRAFT or a SCHEDULED invoice. Only an issued invoice can be emailed.

How to fix it

Issue the invoice first, then send it. To send it as soon as it is issued, issue it with send_automatically: true.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

Returned by

The operations where this code is most likely. The list is not exhaustive.

• POST /v1/companies/{company_id}/invoices/{invoice_id}/send

Example response

When this error occurs, the API answers 400 Bad Request with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/INVOICE_DRAFT_NOT_SENDABLE",
  "title": "INVOICE_DRAFT_NOT_SENDABLE",
  "detail": "An invoice that is not issued yet (a draft or a scheduled invoice) cannot be sent by email. Issue it first.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "INVOICE_DRAFT_NOT_SENDABLE",
    "message": "An invoice that is not issued yet (a draft or a scheduled invoice) cannot be sent by email. Issue it first.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Other errors in this category

Keep exploring