Especificación Nuevo Sistema de Timbrado

Transcripción

1

2 Especificación Nuevo Sistema de Timbrado Este documento abarca la especificación e información necesaria para poder llevar acabo la integración y consumo del nuevo servicio de timbrado. Este nuevo sistema se encuentra en una plataforma mucha más robusta por lo que proporciona tiempos de respuesta más rápidos para nuestros clientes. El proceso de integración es muy sencillo ya que la implementación no varía demasiado en comparación con nuestro servicio de timbrado anterior. La especificación del servicio web (wsdl) se puede encontrar en la siguiente dirección: La cual puede utilizar para crear el cliente que consumirá dicho servicio web. Dicho servicio recibe los siguientes parámetros: - usuario.- El usuario correspondiente a su cuenta de timbrado, para el caso del ambiente de pruebas se utilizará el usuario pruebas. - contrasena.- La contraseña asignada a la cuenta de timbrado, para el caso del ambiente de pruebas se utilizará la contraseña cfdi.- Deberá contener el cfdi a timbrar codificado en base64. Los valores que el servicio web proporciona como respuesta son los siguientes: - codigo.- El valor numérico del código de respuesta generado por la petición enviada. - mensaje.- El mensaje asociado al código de respuesta obtenido por la petición enviada. - timbre.- El contenido del archivo xml enviado, ya con el timbre fiscal asignado. - uuid.- El Folio fiscal asignado al comprobante enviado a timbrar. Los códigos y mensajes de respuesta que se presentan son los siguientes: Código Mensaje 200 Proceso Satisfactorio 301 XML mal formado 302 Sello mal formado o inválido 303 Sello no corresponde a emisor 304 Certificado revocado o caduco 305 La fecha de emisión no está dentro de la vigencia del CSD del emisor 306 El certificado no es de tipo CSD 307 El cfdi contiene un timbre previo 308 Certificado no expedido por el SAT 401 Fecha y hora de generación fuera de rango 402 RFC del emisor no se encuentra en el régimen de contribuyentes

3 403 La fecha de emisión no es posterior al 01 de Enero Usuario y/o contraseña inválidos 502 Usuario no autorizado 503 No hay timbres disponibles 504 Timbrado Previamente 500 Intente de nuevo más tarde En especial el código 504 Ya ha sido timbrado previamente se presenta cuando un cfdi ha sido enviado con anterioridad, por lo que el archivo no será procesado ni timbrado, pero de igual forma se regresará un timbre que es correspondiente al archivo timbrado por primera vez. Librerías de Integración Java Es necesario contar con las librerías de axis2 en el classpath para poder hacer uso del archivo jar. public static RespuestaTimbrado timbrar(string usuario, String contrasena, byte[] cfdi, String ambiente) throws XPDWebServiceException cfdi Arreglo de bytes con el contenido del archivo XML de la factura electrónica. Excepción XPDWebServiceException En dado caso de algún error de configuración del cliente o de conexión. public static RespuestaTimbrado timbrarstring(string usuario, String contrasena, String cfdi, String ambiente) throws XPDWebServiceException cfdi Cadena con el contenido del archivo XML de la factura electrónica. Excepción XPDWebServiceException En dado caso de algún error de configuración del cliente o de conexión.

4 public static RespuestaTimbrado timbrararchivo(string usuario, String contrasena, String rutacfdi, String ambiente) throws XPDWebServiceException cfdi Ruta del archivo XML de la factura electrónica. Excepción XPDWebServiceException En dado caso de algún error de configuración del cliente o de conexión..net Es necesario contar con el.net Framework 3.5 Public Shared Function timbrar(byval usuario As String, ByVal contrasena As String, ByVal cfdi As Byte(), ByVal ambiente As String) As RespuestaTimbrado cfdi Arreglo de bytes con el contenido del archivo XML de la factura electrónica. Public Shared Function timbrarstring(byval usuario As String, ByVal contrasena As String, ByVal cfdi As String, ByVal ambiente As String) As RespuestaTimbrado cfdi Cadena con el contenido del archivo XML de la factura electrónica. Public Shared Function timbrararchivo(byval usuario As String, ByVal contrasena As String, ByVal rutacfdi As String, ByVal ambiente As String) As RespuestaTimbrado

5 cfdi Ruta del archivo XML de la factura electrónica. VB6, FoxPro 6, Delphi 7, VC++ (COM) Es necesario contar con.net Framework 3.5 y registrar el dll utilizando el siguiente comando: "%WINDIR%\Microsoft.NET\Framework\v \regasm.exe" xpdwebservicecom.dll /tlb /nologo /codebase Public Function timbrar(byval usuario As String, ByVal contrasena As String, ByVal cfdi As Byte(), ByVal ambiente As String) As RespuestaTimbrado cfdi Arreglo de bytes con el contenido del archivo XML de la factura electrónica. Public Function timbrarstring(byval usuario As String, ByVal contrasena As String, ByVal cfdi As String, ByVal ambiente As String) As RespuestaTimbrado cfdi Cadena con el contenido del archivo XML de la factura electrónica. Public Function timbrararchivo(byval usuario As String, ByVal contrasena As String, ByVal rutacfdi As String, ByVal ambiente As String) As RespuestaTimbrado cfdi Ruta del archivo XML de la factura electrónica.

6 Ejecutable Es necesario contar con.net Framework 3.5 xpdtimbrarexe timbrarxml usuario contrasena rutacfdi rutatimbre tipoambiente archivosalida usuario: nombre de usuario especificado para acceso. contrasena: contraseña especificada para acceso. rutacfdi: ruta completa del archivo XML de la factura electrónica. rutatimbre: ruta completa donde se guardará el Timbre en formato XML. tipoambiente: ambiente de desarrollo, pruebas o produccion. archivosalida: ruta completa del archivo donde se guardara la salida del programa sea respuesta o error.