> ## Documentation Index
> Fetch the complete documentation index at: https://help.ship.uniuni.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manejo de errores

> Comprende el formato de respuesta y los códigos de error de la API de Socios

Todas las respuestas de la API de Socios utilizan un formato de envolvente consistente.

## Envolvente de respuesta

### Éxito

```json theme={null}
{
  "success": true,
  "message": "...",
  "data": {}
}
```

### Error

```json theme={null}
{
  "success": false,
  "message": "Error description",
  "errorCode": "ERROR_CODE"
}
```

| Campo       | Tipo    | Descripción                                                     |
| ----------- | ------- | --------------------------------------------------------------- |
| `success`   | boolean | `true` para éxito, `false` para error                           |
| `message`   | string  | Descripción del estado o error legible por humanos              |
| `data`      | object  | Payload de respuesta en caso de éxito                           |
| `errorCode` | string  | Código de error legible por máquina (presente en caso de error) |

## Códigos de estado HTTP

| Estado | Significado                                                |
| ------ | ---------------------------------------------------------- |
| `200`  | La solicitud fue exitosa                                   |
| `400`  | Solicitud incorrecta — parámetros inválidos o faltantes    |
| `401`  | No autorizado — token faltante, expirado o inválido        |
| `404`  | Recurso no encontrado (p. ej., el ID de rastreo no existe) |
| `500`  | Error interno del servidor                                 |