Saltar al contenido principal
CRM retorna respuestas de error consistentes y estructuradas. Esto te ayuda a comprender rápidamente qué salió mal y cómo solucionarlo.

​
Formato de error

{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_message>"
}

​
Definiciones de campos

  • code – Un identificador estable y único para el error. Útil para manejo programático y solicitudes de soporte.
  • title – Un resumen corto y legible del problema.
  • message – Orientación detallada para ayudarte a resolver el error.
Esta estructura asegura que siempre obtengas retroalimentación accionable cuando algo no salga como se esperaba.

​
Errores del CRM

Los siguientes errores pueden ocurrir al interactuar con los endpoints del CRM. Cada error sigue nuestra estructura estándar, facilitando la depuración y respuesta a problemas de forma programática. Consulta la tabla a continuación para obtener una lista de códigos de error posibles, qué significan y cómo resolverlos.

​
400

CodeTitleMessage
CRM-0001Invalid Metadata NestingEl objeto metadata no puede contener valores anidados. Por favor asegúrate de que el valor no esté anidado e inténtalo de nuevo.
CRM-0002Metadata Key Length ExceededLa clave de metadata excede la longitud máxima permitida. Por favor usa una clave más corta.
CRM-0003Missing Fields in RequestA tu solicitud le faltan uno o más campos requeridos. Por favor consulta la documentación para asegurar que todos los campos necesarios estén incluidos en tu solicitud.
CRM-0004Invalid Field Type in RequestTu solicitud contiene uno o más campos con un tipo de dato inválido. Por favor consulta la documentación para verificar que todos los campos tengan el tipo correcto.
CRM-0005Invalid Path ParameterUno o más parámetros de ruta están en un formato incorrecto. Por favor verifica los siguientes parámetros y asegúrate de que cumplan con el formato requerido.
CRM-0007Unexpected Fields in the RequestEl cuerpo de la solicitud contiene más campos de los esperados. Por favor envía solo los campos permitidos según la documentación.
CRM-0009Pagination Limit ExceededEl límite de paginación excede el máximo permitido de elementos por página. Por favor verifica el límite e inténtalo de nuevo.
CRM-0011Invalid Sort OrderEl campo ‘sort_order’ debe ser ‘asc’ o ‘desc’. Por favor proporciona un orden de clasificación válido e inténtalo de nuevo.
CRM-0012Metadata Value Length ExceededEl valor de metadata excede la longitud máxima permitida. Por favor usa un valor más corto.
CRM-0013Account Already AssociatedUn accountId del ledger solo puede estar asociado con un único Account relacionado en el CRM.
CRM-0015Bad RequestEl servidor no pudo entender la solicitud debido a sintaxis mal formada. Por favor verifica los campos listados e inténtalo de nuevo.
CRM-0016Invalid Query ParameterUno o más parámetros de consulta están en un formato incorrecto. Por favor verifica los siguientes parámetros y asegúrate de que cumplan con el formato requerido.
CRM-0017Unable to Delete HolderEl holder no puede ser eliminado porque tiene uno o más Accounts asociados.
CRM-0018Missing Headers in RequestA tu solicitud le faltan uno o más parámetros de encabezado requeridos. Por favor consulta la documentación para asegurar que todos los parámetros de encabezado necesarios estén incluidos en tu solicitud.

​
404

CodeTitleMessage
CRM-0006Holder ID Not FoundEl ID de holder proporcionado no existe en nuestros registros. Por favor verifica el ID de holder e inténtalo de nuevo.
CRM-0008Account ID Not FoundEl ID de Account proporcionado no existe en nuestros registros. Por favor verifica el ID de Account e inténtalo de nuevo.

​
409

CodeTitleMessage
CRM-0010Document Association ErrorUn document solo puede estar asociado con un holder.

​
500

CodeTitleMessage
CRM-0014Internal Server ErrorEl servidor encontró un error inesperado. Por favor inténtalo de nuevo más tarde o contacta al soporte.