Saltar a contenido

Referencia

API REST

Credenciales de contratación vigente mediante HEADERS

usrws: Usuario de contratación de timbrado

pwdws: Password de contratación de timbrado

Cuerpo de la solicitud

Una petición al servicio de timbrado deberá llevar los siguientes elementos en la solicitud

Nombre Tipo Descripción
usrws Header Usuario asignado por Conroe Soluciones para conectarse por web service
pwdws Header Password del usuario asignado
tipo Header XML o TIMBRE; lo que se desea recibir de respuesta
host Nombre del servidor asignado por Conroe Soluciones; ej: "ws", "ws3, "pruebas", etc
cuerpo POST Data El XML sellado que representa el CFDI a timbra. Este deberá venir codificado en UTF8

Errores

Cuando existe un error en la validación o timbrado del CFDI, se genera un mensaje con el que se muestra un código indicando el error y su descripción.

Note

Los códigos de referencia son informados mediante el header codigo de la respuesta HTTP

Código Descripción
123 CSD no está en la Lista de Contribuyentes con Obligación (SCO)
140 El valor del atributo Version no es 4.0
301 XML mal formado o no cumple con la validación del XSD del SAT (algún campo invalido)
302 Sello mal formado o invalido; al verificar el sello contra el HASH generado por la cadena original no coinciden puede ser el problema de Cadena Original mal formada, mal generado el HASH de la cadena original o mal generado el sello del HASH
305 Sello no corresponde al emisor; el RFC del Certificado no es el mismo RFC del emisor 304
307 Fecha emisión del CFDI no está dentro de vigencia CSD emisor 306
308 Sello no corresponde al emisor: el RFC del Certificado no es el mismo RFC del Emisor 304
401 Fecha y hora de generación fuera de rango (72 horas) 402
404 Hora Posterior
500 Error interno en el servicio. (normalmente es que servicio de base de datos no está disponible)
501 Error interno SCD
700 Error en autorización del usuario (No aplica para Superusuario) 701
702 Combinación de usuario/contraseña inválida (No Aplica para Superusuario) 703
704 Usuario distinto del RFC emisor (No aplica para usuarios de tipo agencia o Superusuario)
801 Versión del comprobante en la fecha de emisión es invalida 802
803 RFC no tiene validez de obligaciones para emitir CFDIs 901
902 Solicitud contiene caracteres ilegales
903 Solicitud no contiene parámetros requeridos 904
905 Método de HTTPS no permitido 906
908 Content-Length no coincide con el tamaño de la solicitud recibida 909
910 No hay base de datos
921 Contiene Complemento bancario
923 Complemento Acreditamiento de IEPS no vigente.

Si se recibe el header código=000 y el header uuid, se puede determinar que el XML ha sido timbrado correctamente.

Errores de complementos

Para referencia de los errores de los diversos complementos existentes, consulte la matriz de errores específica del complemento en cuestión.