> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/es/partner-api-overview/error-handling.md). # Manejo de errores Epsilon Retail Media Las API de socios siguen un enfoque estructurado y coherente para el manejo de errores. Esto garantiza que las respuestas de error sean predecibles, fáciles de analizar y útiles para la depuración. ## Estructura de la respuesta de error Cuando se produce un error, la API devuelve: * Un código de estado HTTP estándar. * Un cuerpo JSON estructurado con los campos code, message y detalles opcionales. * Una lista de violaciones a nivel de campo (si corresponde), lo que permite a los clientes solucionar varios problemas de una sola vez. ## Estrategias básicas para el manejo de errores Cuando te encuentres con un error, sigue estos pasos: 1. **Lee atentamente el mensaje de error**: la respuesta de error proporciona información específica sobre lo que salió mal y qué campo causó el problema. 2. **Revisa la página del extremo**: si no estás seguro de cómo proceder, revisa la página específica del extremo que estás utilizando. 3. **Ponte en contacto con el servicio de soporte**: si sigues experimentando problemas, puedes abrir un caso en nuestro Portal de soporte. Por favor, proporciona: * La llamada a la API exacta que estás realizando. * El minorista y el equipo específicos. * La entidad específica que estás creando/actualizando. * La respuesta de error completa que estás viendo. Esta información garantizará que nuestro equipo pueda ayudarte de manera eficiente y eficaz. ### Ejemplo de violación única ```json { "code": 3, "message": "Invalid argument(s) for product campaign creation", "details": [ { "@type": "type.googleapis.com/google.rpc.BadRequest", "fieldViolations": [ { "field": "maxBid", "description": "[maxBid] must be greater or equal [minBid]" } ] } ] } ``` ### Ejemplo de violaciones múltiples ```json { "code": 3, "message": "Invalid argument(s) for product campaign update", "details": [ { "@type": "type.googleapis.com/google.rpc.BadRequest", "fieldViolations": [ { "field": "strategy.fixedTenancy.catalogCosts", "description": "all catalog cost percentages for fixed tenancy must sum to 100%" }, { "field": "strategy.fixedTenancy.catalogCosts", "description": "fixed tenancy catalog cost [...] is duplicated in the list" } ] } ] } ``` ## Códigos de estado HTTP estándar | Código de estado HTTP | Significado | Cuándo ocurre | | ------------------------- | ------------------------------------------- | ----------------------------------------------- | | 200 OK | La solicitud se realizó correctamente | Llamada a la API correcta | | 204 No Content | Operación correcta, sin cuerpo de respuesta | Solicitud correcta sin carga útil de devolución | | 400 Bad Request | Entrada no válida | Solicitud mal formada o fallo de validación | | 401 Unauthorized | Token faltante o no válido | Token no proporcionado o caducado | | 403 Forbidden | Acceso denegado | Token válido pero carece de permiso | | 404 Not Found | Recurso no encontrado | Extremo o ID de recurso no válido | | 409 Conflict | Datos duplicados o en conflicto | El recurso ya existe o viola las restricciones | | 429 Too Many Requests | Límite de velocidad superado | Demasiadas solicitudes en poco tiempo | | 500 Internal Server Error | Problema en el lado del servidor | Error inesperado en el servidor | | 503 Service Unavailable | Interrupción temporal | El servicio está caído o en mantenimiento | ## Mapeo de códigos de error gRPC a HTTP | Código gRPC | Nombre gRPC | Código HTTP | Nombre HTTP | | ----------- | -------------------- | ----------- | --------------------- | | 0 | OK | 200 | OK | | 1 | CANCELLED | 499 | Client Closed Request | | 2 | UNKNOWN | 500 | Internal Server Error | | 3 | INVALID\_ARGUMENT | 400 | Bad Request | | 4 | DEADLINE\_EXCEEDED | 504 | GATEWAY\_TIMEOUT | | 5 | NOT\_FOUND | 404 | NOT\_FOUND | | 6 | ALREADY\_EXISTS | 409 | CONFLICT | | 7 | PERMISSION\_DENIED | 403 | FORBIDDEN | | 8 | RESOURCE\_EXHAUSTED | 429 | TOO\_MANY\_REQUESTS | | 9 | FAILED\_PRECONDITION | 400 | Bad Request | | 10 | ABORTED | 409 | CONFLICT | | 11 | OUT\_OF\_RANGE | 400 | Bad Request | | 12 | UNIMPLEMENTED | 501 | NOT\_IMPLEMENTED | | 13 | INTERNAL | 500 | Internal Server Error | | 14 | UNAVAILABLE | 503 | SERVICE\_UNAVAILABLE | | 15 | DATA\_LOSS | 500 | Internal Server Error | | 16 | UNAUTHENTICATED | 401 | UNAUTHORIZED | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/partner/es/partner-api-overview/error-handling.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.