Apéndice A: Códigos de estado

Las solicitudes de API de servicio Web del Centro de servicio al usuario siempre devuelven una respuesta predeterminada. Se debe utilizar un estatus de respuesta para determinar si la solicitud se ha realizado correctamente o si se ha producido un fallo. La respuesta predeterminada se compone de un código de estatus y un mensaje de texto de estatus asociado.

El mensaje de estado es una descripción breve en inglés que se puede mostrar al usuario. Si muestra el mensaje de estatus, también debe mostrar el código de estatus.

Los clientes pueden reconocer los códigos de estado, no los mensajes de estado. Cuando una solicitud no se puede completar correctamente, devuelve el error real o un mensaje de error. Este comportamiento puede variar ligeramente de los mensajes que aparecen en este apéndice.

Algunos errores ocurren en determinadas llamadas, mientras que otros son errores más generales que pueden ocurrir en cualquier llamada. Por ejemplo, el código de estado 100 para un acceso denegado debido a credenciales no válidas.

0xx: código de estado correcto	Mensaje
000	Operación correcta: el servidor ha cumplido la petición correctamente; se han devuelto los resultados de la operación.
001	Operación correcta: el servidor ha cumplido la petición correctamente; no se ha devuelto ningún resultado.
1xx: código de estado de error de autorización	Mensaje
100	No autorizado: se ha denegado el acceso debido a credenciales no válidas.
101	Error de licencia: no dispone de una licencia apropiada para utilizar ningún servicio.
2xx: código de estado de error de acceso a operaciones	Mensaje
200	Error de invocación: no se ha encontrado la definición de operación para el servicio solicitado.
201	Error de invocación: se ha desactivado la operación del servicio solicitado.
3xx: código de estado de error de procesamiento previo de operaciones	Mensaje
300	Error de ejecución: se ha producido un error inesperado durante la transformación de datos de los parámetros de petición transmitidos durante la invocación del servicio Web: {0} .{1}
301	Error de ejecución: se ha producido un error inesperado durante la validación de datos de los parámetros de petición transmitidos durante la invocación del servicio Web: {0}.{1}
4xx: código de estado de error de ejecución de punto final	Mensaje
400	Error de ejecución: se ha producido una excepción no tratada en el punto final del servicio (proveedor) durante la ejecución del servicio solicitado.
401	Error de ejecución: el punto final del servicio (proveedor) ha capturado algunos errores durante la ejecución del servicio solicitado.
402	Error de ejecución: se ha producido un error inesperado al procesar la respuesta de servicio en el formato solicitado.
403	Error de ejecución: se ha producido un error inesperado mientras se procesaba el servicio solicitado.