# subscription_required (/docs/errores/subscription_required)

Este acto real necesita una suscripción activa de esta empresa, y no la tiene.

|                    |                                                            |
| ------------------ | ---------------------------------------------------------- |
| **Código**         | `subscription_required`                                    |
| **Tipo**           | `invalid_request_error` — Entrada mal formada o incompleta |
| **HTTP**           | `402`                                                      |
| **¿Reintentable?** | No                                                         |

## Qué hacer [#qué-hacer]

La suscripción es **por empresa**: cada RUT que emite en real paga la suya. `error.details` trae la empresa (`empresa`, `empresa_rut`, `empresa_name`), el estado de su suscripción, el instante en que vence el período de gracia si había uno corriendo, la URL de pago apuntando a esa empresa, y un `next` que dice quién paga y cómo te enteras de que ya pagó. Las demás empresas de la cuenta siguen emitiendo. Se cobran CUATRO actos: la emisión, las notas de crédito, la solicitud de folios y el envío al receptor. La autorización de puesta en marcha NO — es una decisión, no una emisión, y es gratis por todas las puertas (#530). Las lecturas, las respuestas comerciales a documentos recibidos, las declaraciones de impuestos y todo el sandbox tampoco se cobran. La elegibilidad se evalúa primero, así que esto llega solo cuando la empresa por lo demás ya puede emitir.

> **Advertencia**
>
> Reintentar el mismo request va a fallar igual. Cambia el request, no la frecuencia.

## El sobre [#el-sobre]

```json
{
  "error": {
    "type": "invalid_request_error",
    "code": "subscription_required",
    "message": "…",
    "hint": "`error.details` carries the empresa, its RUT, the subscription status, the grace instant if one was running, the checkout URL for THAT empresa, and a `next` handoff naming who pays and how you learn it is done. The subscription is PER EMPRESA, so the other empresas on the same account are unaffected. FOUR acts are gated: emission, notas de crédito, folio requests and sends. The go-live authorization is NOT — it is a decision, not an emission, and it is free on every door (#530). Reads, commercial responses, tax filings and the whole sandbox are never gated either. Eligibility is evaluated first, so this arrives only when the empresa is otherwise able to emit.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/subscription_required",
    "request_id": "req_01K2R7Q9M4T2VB"
  }
}
```

Programa contra `code`, nunca contra `message` — la prosa se puede reescribir, el código no (§5.8).

`hint` y `retriable` llegan en la respuesta, con estos mismos valores: son función del `code` y salen del mismo diccionario que sirve `GET /v1/error_codes`, así que el sobre y el diccionario no pueden discrepar. `hint` va en inglés a propósito — el español de este código es esta ficha. Más en [El sobre de error](/docs/errores).

## También [#también]

- [Todos los códigos](/docs/errores/codigos): La tabla completa, agrupada por dónde te la vas a encontrar.

- [El sobre de error](/docs/errores): Los nueve tipos, el request_id y cómo manejarlos en la práctica.

La copia legible por máquina de esta ficha vive en `GET /v1/error_codes`, sin autenticación.