ANNUAL_PLAN_NOT_AVAILABLE
The annual plan is not available for this account. Activate without a billing period to subscribe to the monthly plan.
Category: Subscriptions
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/ANNUAL_PLAN_NOT_AVAILABLE",
"title": "ANNUAL_PLAN_NOT_AVAILABLE",
"detail": "The annual plan is not available for this account. Activate without a billing period to subscribe to the monthly plan.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "ANNUAL_PLAN_NOT_AVAILABLE",
"message": "The annual plan is not available for this account. Activate without a billing period to subscribe to the monthly plan.",
"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
BILLING_MANAGED_BY_PROVIDER
This account's subscription is managed by your provider; you cannot change it here.
CHECKOUT_URLS_REQUIRED
success_url and cancel_url are required to set up billing
CONTACT_SALES_REQUIRED
To add more than one NIF, talk to us: we will prepare a per-NIF price for you.
FEATURE_NOT_AVAILABLE
The '‹value›' feature is not available in your plan
NIF_LIMIT_REACHED
You have reached the maximum of ‹value› active NIFs in Live included in your agreement. Contact BeeL to increase it.
Keep exploring
ALTERNATIVE_ID_VAT_REQUIRES_EU_COUNTRY
An EU VAT number (NIF_IVA, type 02) is only valid for an EU member state other than Spain; received country: '‹value›'. Identify a customer from outside the EU with another type, such as OTHER_DOCUMENT or COUNTRY_ID. If it is the recipient of an invoice already issued, correct its data with an R4 corrective invoice
API_COMMUNICATION_ERROR
Error communicating with the VeriFactu API