# Errores

> Problem details (RFC 9457) con un code estable y el campo exacto a corregir.

URL: https://boelabs.com/en/docs/bazar/errores
Language: Español

Los errores siguen [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)
(`application/problem+json`), con un `code` estable para decidir qué hacer y, cuando aplica, el
campo exacto a corregir en `errors`:

```json
{
  "type": "/problems/validation-failed",
  "title": "Unprocessable Content",
  "status": 422,
  "code": "VALIDATION_FAILED",
  "detail": "The request does not match the API contract. See `errors` for each field.",
  "errors": [
    {
      "path": "currency",
      "message": "Set `currency` (USD or VES) to filter or sort by price; other currencies are converted at the official BCV rate."
    }
  ],
  "requestId": "821d2935-0359-4a69-945e-cfa0b69696f6"
}
```

| Status | `code`                         | Qué pasó                                                                                 |
| ------ | ------------------------------ | ---------------------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED`                 | La key es desconocida o está revocada.                                                   |
| 429    | `RATE_LIMITED`                 | Se agotó la cuota; reintenta después de `Retry-After` segundos.                          |
| 422    | `VALIDATION_FAILED`            | Algún parámetro no cumple el contrato; `errors` dice cuál y por qué.                     |
| 422    | `INVALID_CURSOR`               | El cursor es de otra búsqueda; repítela sin él.                                          |
| 422    | `INVALID_GTIN`                 | El código de barras no tiene un dígito verificador válido.                               |
| 422    | `NO_BARCODE`                   | El producto no tiene código de barras, así que no se puede comparar; búscalo por nombre. |
| 404    | `LISTING_NOT_FOUND`            | No hay producto con ese id, o su tienda ya no está activa.                               |
| 404    | `NO_OFFER`, `NO_OFFER_IN_CITY` | El producto no tiene ofertas, o no en esa ciudad (el mensaje lista las que tiene).       |
| 404    | `ROUTE_NOT_FOUND`              | La ruta no existe.                                                                       |
| 400    | `MALFORMED_BODY`               | El cuerpo de la petición no se pudo leer.                                                |
| 500    | `INTERNAL_ERROR`               | Falla de Bazar.                                                                          |

Cada respuesta trae `x-request-id`; puedes enviar el tuyo en esa cabecera. Al reportar un problema,
incluye ese id.