Nuevo Tim Bra Do

5
Puebla, México, 05 de julio de 2013 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: http://timbrado.expidetufactura.com.mx:8080/pruebas/TimbradoWS?wsdl 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 “123456”. - 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

Transcript of Nuevo Tim Bra Do

Page 1: Nuevo Tim Bra Do

Puebla, México, 05 de julio de 2013

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:

http://timbrado.expidetufactura.com.mx:8080/pruebas/TimbradoWS?wsdl

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 “123456”.

- 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

Page 2: Nuevo Tim Bra Do

Puebla, México, 05 de julio de 2013

403 La fecha de emisión no es posterior al 01 de Enero 2012

501 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

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Arreglo de bytes con el contenido del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

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

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Cadena con el contenido del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

Excepción XPDWebServiceException En dado caso de algún error de configuración del cliente o de

conexión.

Page 3: Nuevo Tim Bra Do

Puebla, México, 05 de julio de 2013

public static RespuestaTimbrado timbrarArchivo(String usuario, String

contrasena, String rutaCfdi, String ambiente) throws XPDWebServiceException

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Ruta del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

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

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Arreglo de bytes con el contenido del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

Public Shared Function timbrarString(ByVal usuario As String, ByVal contrasena As

String, ByVal cfdi As String, ByVal ambiente As String) As RespuestaTimbrado

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Cadena con el contenido del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

Public Shared Function timbrarArchivo(ByVal usuario As String, ByVal contrasena As

String, ByVal rutaCfdi As String, ByVal ambiente As String) As RespuestaTimbrado

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

Page 4: Nuevo Tim Bra Do

Puebla, México, 05 de julio de 2013

• cfdi Ruta del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

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\v2.0.50727\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

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Arreglo de bytes con el contenido del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

Public Function timbrarString(ByVal usuario As String, ByVal contrasena As String,

ByVal cfdi As String, ByVal ambiente As String) As RespuestaTimbrado

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Cadena con el contenido del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

Public Function timbrarArchivo(ByVal usuario As String, ByVal contrasena As String,

ByVal rutaCfdi As String, ByVal ambiente As String) As RespuestaTimbrado

Método para servicio de timbrado desde un archivo XML que representa un CFDI 3.2

• usuario Nombre de usuario único especificado para acceso.

• contrasena Contraseña especificada para acceso.

• cfdi Ruta del archivo XML de la factura electrónica.

• ambiente Tipo de ambiente de desarrollo, puede ser "pruebas" o "produccion".

Regresa un objeto que contiene un código de respuesta con un mensaje asociado, en caso de ser

satisfactorio. Así como el folio fiscal y el comprobante timbrado.

Page 5: Nuevo Tim Bra Do

Puebla, México, 05 de julio de 2013

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.