# empresa_required (/docs/errores/empresa_required)

El endpoint tiene alcance de empresa y no llegó el header `Facturia-Empresa`.

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

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

Manda el RUT canónico o el id `emp_…` en el header `Facturia-Empresa` (también va en `error.param`). No hay alternativa por query. Si `error.details` dice `reachable_empresas: 0` el header no es el problema: esta credencial todavía no alcanza ninguna empresa, y `error.details.next` es la llamada que crea una.

> **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": "empresa_required",
    "message": "…",
    "hint": "Send the canonical RUT or the `emp_…` id in the `Facturia-Empresa` header (also in `error.param`). There is no query parameter alternative. If `error.details` says `reachable_empresas: 0` the header is not the problem: this credential reaches no empresa yet, and `error.details.next` is the call that creates one.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/empresa_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.