subscription_required

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

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.

El sobre

{
  "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.

También

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