# metadata_too_large (/docs/errores/metadata_too_large)

`metadata` supera las 20 llaves o los 500 caracteres por valor.

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

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

La metadata nunca llega al SII; mantenla como referencia, no como carga útil.

> **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": "metadata_too_large",
    "message": "…",
    "hint": "Metadata never reaches the SII; keep it a reference, not a payload.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/metadata_too_large",
    "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.