Saltar al contenido principal
CRM devuelve respuestas de error consistentes y estructuradas. Esto le 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 único y estable para el error. Útil para el manejo programático y las solicitudes de soporte.
  • title – Un resumen breve y legible del problema.
  • message – Orientación detallada para ayudarle a resolver el error.
Esta estructura garantiza que siempre obtenga retroalimentación procesable cuando algo no sale como se esperaba.

​
Errores de CRM

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

​
400

CódigoTítuloMensajeTraducción
CRM-0001Invalid Metadata NestingThe metadata object cannot contain nested values. Please ensure that the value %v is not nested and try again.El objeto de metadatos no puede contener valores anidados. Por favor, asegúrese de que el valor %v no esté anidado e intente nuevamente.
CRM-0002Metadata Key Length ExceededThe metadata key %v exceeds the maximum allowed length of %v characters. Please use a shorter key.La clave de metadatos %v excede la longitud máxima permitida de %v caracteres. Por favor, use una clave más corta.
CRM-0003Missing Fields in RequestYour request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.Su solicitud carece de uno o más campos obligatorios. Por favor, consulte la documentación para asegurarse de que todos los campos necesarios estén incluidos en su solicitud.
CRM-0004Invalid Field TypeYour request contains one or more fields with an invalid data type. Please refer to the documentation to verify that all fields have the correct type.Su solicitud contiene uno o más campos con un tipo de dato inválido. Por favor, consulte la documentación para verificar que todos los campos tengan el tipo correcto.
CRM-0005Invalid Path ParameterOne or more path parameters are in an incorrect format. Please check the following parameters %v and ensure they meet the required format before trying again.Uno o más parámetros de ruta están en un formato incorrecto. Por favor, verifique los siguientes parámetros %v y asegúrese de que cumplan con el formato requerido antes de intentar nuevamente.
CRM-0007Unexpected Fields in the RequestThe request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.El cuerpo de la solicitud contiene más campos de los esperados. Por favor, envíe solo los campos permitidos según la documentación. Los campos inesperados se enumeran en el objeto fields.
CRM-0009Pagination Limit ExceededThe pagination limit exceeds the maximum allowed of %v items per page. Please verify the limit and try again.El límite de paginación excede el máximo permitido de %v elementos por página. Por favor, verifique el límite e intente nuevamente.
CRM-0011Invalid Sort OrderThe ‘sort_order’ field must be ‘asc’ or ‘desc’. Please provide a valid sort order and try again.El campo ‘sort_order’ debe ser ‘asc’ o ‘desc’. Por favor, proporcione un orden de clasificación válido e intente nuevamente.
CRM-0012Metadata Value Length ExceededThe metadata value %v exceeds the maximum allowed length of %v characters. Please use a shorter value.El valor de metadatos %v excede la longitud máxima permitida de %v caracteres. Por favor, use un valor más corto.
CRM-0015Bad RequestThe server could not understand the request due to malformed syntax. Please check the listed fields and try again.El servidor no pudo entender la solicitud debido a una sintaxis mal formada. Por favor, verifique los campos listados e intente nuevamente.
CRM-0016Invalid Query ParameterOne or more query parameters are in an incorrect format. Please check the following parameters ‘%v’ and ensure they meet the required format before trying again.Uno o más parámetros de consulta están en un formato incorrecto. Por favor, verifique los siguientes parámetros ‘%v’ y asegúrese de que cumplan con el formato requerido antes de intentar nuevamente.
CRM-0017Unable to Delete HolderThe holder cannot be deleted because it has one or more associated aliases.El titular no puede ser eliminado porque tiene uno o más alias asociados.
CRM-0018Missing Headers in RequestYour request is missing one or more required header params. Please refer to the documentation to ensure all necessary header params are included in your request.Su solicitud carece de uno o más parámetros de encabezado obligatorios. Por favor, consulte la documentación para asegurarse de que todos los parámetros de encabezado necesarios estén incluidos en su solicitud.
CRM-0019Invalid Metadata FormatThe metadata parameter format is invalid. Metadata must be provided in the ‘metadata.field=value’ format. Please check the documentation for correct usage.El formato del parámetro de metadatos es inválido. Los metadatos deben proporcionarse en el formato ‘metadata.field=value’. Por favor, consulte la documentación para el uso correcto.
CRM-0020Invalid Metadata KeyThe metadata key ‘%s’ contains invalid characters. Metadata keys must use only alphanumeric characters, underscores, and hyphens after the ‘metadata.’ prefix.La clave de metadatos ‘%s’ contiene caracteres inválidos. Las claves de metadatos deben usar solo caracteres alfanuméricos, guiones bajos y guiones después del prefijo ‘metadata.’.
CRM-0021Potentially Unsafe Metadata ValueThe metadata value ‘%s’ contains characters that could be used for database injection attacks. Please remove any MongoDB operators (like where,where, regex) from your query.El valor de metadatos ‘%s’ contiene caracteres que podrían usarse para ataques de inyección de base de datos. Por favor, elimine cualquier operador de MongoDB (como where,where, regex) de su consulta.
CRM-0022Invalid Header ValueOne or more headers have invalid values. Please check the following headers %v and ensure they contain valid UUIDs before trying again.Uno o más encabezados tienen valores inválidos. Por favor, verifique los siguientes encabezados %v y asegúrese de que contengan UUIDs válidos antes de intentar nuevamente.

​
404

CódigoTítuloMensajeTraducción
CRM-0006Holder ID Not FoundThe provided holder ID does not exist in our records. Please verify the holder ID and try again.El ID de titular proporcionado no existe en nuestros registros. Por favor, verifique el ID de titular e intente nuevamente.
CRM-0008Alias ID Not FoundThe provided alias ID does not exist in our records. Please verify the account ID and try again.El ID de alias proporcionado no existe en nuestros registros. Por favor, verifique el ID de cuenta e intente nuevamente.

​
409

CódigoTítuloMensajeTraducción
CRM-0010Document Association ErrorA document can only be associated with one holder.Un documento solo puede estar asociado con un titular.
CRM-0013Account Already AssociatedAn accountId from ledger can only be associated with a single related account on CRM.Un accountId del ledger solo puede estar asociado con una única cuenta relacionada en CRM.

​
500

CódigoTítuloMensajeTraducción
CRM-0014Internal Server ErrorThe server encountered an unexpected error. Please try again later or contact support.El servidor encontró un error inesperado. Por favor, intente nuevamente más tarde o contacte al soporte.