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.