Errores

Qué significa cada código de respuesta del servicio y qué hacer, con errores en JSON que dicen qué falta.

Los errores vienen en JSON y dicen qué falta. Es a propósito: usted tiene que poder arreglarlo sin llamarnos ni esperar a que alguien mire un registro.

• error dice qué falló.
• faltan es la lista de los datos obligatorios que no llegaron, en los tipos que los tienen.
• referencia es un código de 8 caracteres que traen los errores de nuestro lado: cítela al avisarnos.

Cuando algo sale mal

Código	Qué pasó	Qué hacer
401	Falta la cabecera authorization	Algo por el camino se la comió: un proxy, o un cliente HTTP que no la reenvía tras una redirección
401	Clave desconocida	La clave no existe o fue revocada
400	El tipo no existe	La respuesta trae la lista de tipos disponibles
400	Falta data, o el cuerpo no es JSON	Revisar el cuerpo de la petición
400	Faltan datos obligatorios del tipo (la colilla de nómina, el informe y los movimientos de inventario)	faltan dice cuáles
400	Se pidió cifrar en algo que no es una colilla, la colilla no trae tipoDocumento (CC o NIT) y numeroDocumento, o cifrar no es booleano	error dice qué falló; ver Colillas de nómina protegidas con contraseña
405	No es un POST	—
500	El documento no se pudo componer	Casi siempre es una etiqueta no admitida en un contrato. La respuesta trae una referencia de 8 caracteres: cítela al avisarnos y encontramos el caso sin que nos mande el cuerpo
503	No se pudo comprobar la clave, o el servicio no tiene claves configuradas	Es nuestro, no de su petición; avísenos citando la referencia si la respuesta la trae

Un plantilla que no existe también responde 400, con la lista de los que sí; ver Elegir el diseño.