CompanyActivations

Switch a company off

Switches the company off in the mode given by environment; the other mode is untouched.

  • Sealed, not deleted: the activation's history survives. After the switch-off takes effect the NIF can neither issue nor correct invoices in that mode until it is switched on again, and in Live that sealing is what releases the NIF for another account.

When it takes effect

  • In Live the switch-off is scheduled, not immediate: the cycle is paid up front, so the response carries an effective_at and the NIF keeps invoicing until then. Nothing is refunded. effective_at is the end of the current billing cycle, unless the NIF was switched on within that same cycle, in which case it is the end of the next one.
  • TEST, and PROD under an enterprise contract: immediate, and answer with no effective_at.

Repeats and permissions

  • Repeating the call: on a mode whose switch-off is already pending it returns the same date with already_scheduled: true; switching off a mode that was never on is a silent no-op.
  • Permission: switching off in Live requires being the billing subject of the account.
delete/v1/companies/{company_id}/activations

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/companies/{company_id}/activations
  • Auth: HTTP bearer

Query parameters

environment'TEST' | 'PROD' required

Mode a record lives in — its Test/Live twin. It decides where invoices, customers and quota are accounted.

For a company it also decides which AEAT its NIF is registered against: switching a company on in PROD is what registers it with the real AEAT, so aeat_environment is that same mode and uses this same enum.

Example:PROD

Mode to switch the NIF off in.

Response

Switch-off registered — scheduled in Live, immediate otherwise.

successboolean required

Example response

{
  "success": true,
  "data": {
    "environment": "PROD"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.