Companies error codes
Every public API error code emitted by Companies, with its HTTP status, its type and a page per code.
Error codes emitted by Companies. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
additional_nif_charge_failed | payment_required_error | 402 | The immediate charge for the additional tax ID was declined: the card was refused, it needs authentication, or the payment provider was unreachable. When the charge fails, the tax ID is not added or activated and no charge remains. |
additional_nif_not_in_plan | authorization_error | 403 | The account holds a live plan, but that plan does not include additional tax IDs: only Empresario and Enterprise (trials included) allow them. Nothing was charged and no change was written. |
additional_nif_plan_required | payment_required_error | 402 | The account has no live plan, so there is no subscription on which to charge the additional tax ID. Nothing was charged and no change was written. |
billing_managed_by_provider | authorization_error | 403 | This account's billing is paid by another account, so it cannot contract an additional tax ID on its own. Nothing was charged and no change was written. |
company_inactive | authorization_error | 403 | The company named by the {company} path segment is within the credential's scope, but it is deactivated and cannot be operated until it comes back. |
payment_method_required | payment_required_error | 402 | Adding or activating an additional tax ID charges its fee immediately, and the account operates in live mode with no payment method on file. Nothing was charged and no change was written. |
Related
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.