WsDex 2.

0 Gua de ejemplo de Integracin ECODEX

Contenido
WsDex WebService Versin 2.0.............................................................................................................................. 4 Nuevas funciones: ................................................................................................................................................. 4 Soy nuevo en Web Services ................................................................................................................................... 5 Firma Digital: ......................................................................................................................................................... 5 Servicios: ................................................................................................................................................................ 6 Servicio Seguridad: ................................................................................................................................................ 7 Token de Servicio:.............................................................................................................................................. 7 Token de transaccin de usuario:...................................................................................................................... 7 Token de alta de emisores................................................................................................................................. 9 Servicio Clientes:.................................................................................................................................................. 10 SolicitudRegistroCliente ...................................................................................................................................... 11 AsignacionTimbres .............................................................................................................................................. 12 Servicio Cancelacin: ........................................................................................................................................... 13 SolictudCancelaMultiple ...................................................................................................................................... 14 SolictudCancelaOtros .......................................................................................................................................... 15 RecuperaAcuseCancelacion................................................................................................................................. 17 Servicio Comprobante: ........................................................................................................................................ 18 Servicio Repositorio: ............................................................................................................................................ 20 Servicio Timbrar: ................................................................................................................................................. 25 Seguridad: ............................................................................................................................................................ 27 Manejo de excepciones: ...................................................................................................................................... 27 Kit de Pruebas ...................................................................................................................................................... 28 Direcciones (URLS) de WebService de pruebas............................................................................................... 29 Cdigos de Error enviados por SAT ................................................................................................................ 30 Complementos ................................................................................................................................................ 30 Validacin de pruebas ............................................................................................................................................. 30

LOCAL WSDL y otros Lenguajes ............................................................................................................................... 31 Herramientas web Services .................................................................................................................................... 31 Contacto .................................................................................................................................................................. 32 Tabla de control de cambios: .......................................................................................................................... 32

WsDex WebService Versin 2.0

Desde su salida al mercado, ECODEX se ha centrado en la integracin de empresas con un esquema de administracin de facturacin, que tiene la ventaja de ser modificado para ser conectado con nuestro servicio web (WebService) y obtener los sellos y timbres de comprobantes digitales (Comprobantes Fiscales Digitales CFDIs) siendo el servicio prestado por ECODEX que est autorizado como Proveedor Autorizado de Certificacin ante el SAT. Con su nueva versin, refrendamos nuestro compromiso de generar servicios de valor agregado para nuestros clientes con un servicio de calidad.

Nuevas funciones:
Escuchando a nuestros integradores, esta nueva versin contiene muchas mejoras que han sido planteadas a lo largo del tiempo por nuestros clientes. 1. Alta de emisores. Ahora se pueden dar de alta emisores de manera desatendida desde el web Service, evitando el paso de entrar al portal y pudindolo hacer desde una aplicacin del cliente que integre esta funcin. 2. Asignacin y recuperacin de timbres. El control de los timbres se realizaba nicamente desde el panel de control. Con esta nueva funcin, se podr tener una mayor flexibilidad para con el cliente final.

3. Cancelacin de mltiples comprobantes en una sola llamada. A veces el proceso de cancelar timbres uno a uno puede ser algo tedioso. Una llamada que pueda utilizarse para cancelar hasta 500 comprobantes en un solo envo puede ayudar a mejorar la experiencia del usuario. Esta funcin sustituye gradualmente a las funciones existentes de cancelacin, que se mantendrn por compatibilidad. 4. Cancelacin de comprobantes de otros PACs. En caso de que se desee migrar gradualmente de otro PAC a Ecodex, o bien, contratar nuestro servicio como respaldo, esta opcin permite cancelar comprobantes de esos otros proveedores de manera transparente. 5. Obtencin del acuse de cancelacin del SAT. Como apoyo a nuestros integradores que as lo requieran, los acuses de cancelacin se pueden obtener a partir de esta versin para los emisores que deseen una mayor certeza en sus operaciones.

Soy nuevo en Web Services

El modelo del cfdi ha representado un reto para la industria de desarrollo de software mexicana, pero ha sido una gran oportunidad de crecimiento. Los desarrolladores se han empapado de nuevo conocimiento y el entendimiento de web services les has permitido ampliar su uso ms all del cfdi. La mayora de los lenguajes ms utilizados tienen bastante soporte para su manejo. En el caso de este kit de integracin, se muestran ejemplos con algunos de los lenguajes ms populares en nuestro pas (C#, vb.net, java y php). Para el caso de sistemas de los que no se tenga cdigo fuente o cuya implementacin de web services sea muy costosa, algunos de nuestros integradores que han desarrollado soluciones para estas necesidades.

Firma Digital:
Nosotros proveemos el servicio de sellado y timbrado de comprobantes fiscales, lo que implica que sellamos el Certificado de Sello digital (CSD) utilizando el sello del cliente para despus Timbrarlo con el Certificado de sello digital (CSD) que el SAT ha provisto, certificando todos los comprobantes fiscales que son enviados a nuestro servicio web, despus de la validacin tcnica y legal correspondiente. El Sello Digital es una cadena de texto con una serie de caracteres. Esta Cadena se forma como resultado de encriptar la informacin de la Cadena Original del Comprobante, lo que hace que el comprobante sea infalsificable debido a que cualquier cambio en los datos, genera un sello diferente.

Servicios:
Una de las cualidades que nos distinguen del resto de Proveedores de Servicios Autorizados es el ofrecer a nuestros clientes la tecnologa para la integracin con nuestro servicio lo que se traducen en beneficios a corto plazo, lo que afecta la eficiencia de la operacin diaria. Nuestros Servicios estn enfocados en 2 perfiles de emisores, los que desean solo timbrar sus comprobantes fiscales (Solo Timbrar) y los que desean el sellado y timbrado de sus comprobantes (Sellar y Timbrar). Ambos perfiles usan en comn el servicio de Seguridad y Clientes, teniendo de diferencia los mtodos del servicio de Timbrado exclusivo para el perfil de Solo Timbrar. En esta versin se aadi el servicio Cancelaciones. En las siguientes secciones se describen cada Servicio con sus solicitudes.

Perfl: Sellar y Timbrar

Perfl: Solo Timbrar

Servicios Comunes:
Estos son los servicios que se implementan independientemente del perfil Timbrado o Sellado y Timbrado.

Servicio Seguridad:
Este mtodo brinda una forma confiable de controlar el acceso y duracin de la sesin, por medio del mtodo ObtenerToken. Esta llamada vlida la existencia del emisor en nuestro servicio y regresa un Token de Servicio.

Token de Servicio: Antes de comenzar el proceso de sellado y timbrado, la aplicacin que se conecta con ECODEX debe hacer una peticin a nuestro servicio web para solicitar un "token" (clave temporal) y pueda ser utilizado durante una sesin por un perodo de 10 minutos. Token de transaccin de usuario: El token de transaccin de usuario, es distinto al de Token de Servicio, es un funcin hash SHA1 que se calcula utilizando el servicio de token obtenidos de los servicios de seguridad y el ID integrador (que es secreta y nunca debe viajar a travs de la red), y sirve para comunicarse en las dems solicitudes. El token es una funcin hash SHA1 de una cadena con el identificador del integrador, adems del signo tubera o pipe, y el Token de Servicio vigente.

Formula:

SHA1( ID Integrador|Token de Servicio)

Ejemplo:

SHA1 (123|bba1a8454180f89603def4757f7a4bc03d67397b) = ab5935f20420a75fa03d981663ee2d94f1663211

Este servicio incluye un Kit de pruebas de llamadas, as como una consulta del estatus de nuestras aplicaciones, permitiendo conocer la disponibilidad de la aplicacin de servicio.

Este kit viene en distintos lenguajes de programacin, por ejemplo para el kit de pruebas con C# en la class Utilerias se puede cambiar los datos de RFC y el UUID de Integrador, para fines de pruebas.

As como un ejemplo de cmo se podra hacer la llamada a la solicitud de token de seguridad:

Token de alta de emisores El token de alta de emisores es un nuevo token diseado especficamente para este mtodo. Es un funcin hash SHA1 que se calcula utilizando el servicio de token obtenidos de los servicios de seguridad, el ID integrador y el ID de Alta de emisores. Al igual que token de transaccin, tambin es una funcin hash SHA1 de una cadena con el identificador del integrador, adems del signo tubera o pipe, el Token de Servicio vigente y el ID de alta de emisores. Formula:

SHA1( ID Integrador|ID alta de emisores| token de servicion )

Ejemplo:

SHA1 (123|123312|bba1a8454180f89603def4757f7a4bc03d67397b) = ab5935f20420a75fa03d981663ee2d94f1663211

Servicio Clientes:
Este servicio tiene los mtodos: EstatusCuenta: Este mtodo sirve para verificar el estatus de la cuenta de un cliente, regresando los datos de la cuenta, as como los timbres asignados y vigentes. Registrar: Este mtodo sirve para dar de alta a nuevos Emisores, regresando el RFC del Emisor que se dio de alta as como su estatus y clave para subir los certificados del mismo. AsignacionTimbres: Este mtodo sirve para asignar timbres a un cliente, regresando el saldo nuevo y saldo anterior del cliente a que se le asignaron los timbres. Para desasignar timbres, basta con poner la cantidad en negativo y se har el descuento en el saldo del emisor.

SolicitudRegistroCliente
Solicitud

RFC: El RFC del Emisor que ser dado de Alta. RazonSocial: Nombre o Razn social del emisor que ser dado de Alta. CorreoElectronico: Es el correo electrnico del emisor que ser dado de Alta. RfcIntegrador: Es el RFC del Integrador que est dando de Alta al emisor. Token: Es el token de alta de emisores. TransaccionID: Es el Identificador de la transaccin.

Respuesta

RFC: El RFC del Emisor que ser dado de Alta. Estatus: Nombre o Razn social del emisor que ser dado de Alta. ClaveCertificado: Es la clave de certificado para la generacin de la URL para subir el certificado del emisor. TransaccionID: Es el mismo Identificador de la transaccin original.

AsignacionTimbres
Solicitud

RFC: El RFC del Emisor al que se le harn la asignacin / desasignacin. TimbresAsignar: Valor entero con el nmero de timbres a asignar. Para desasignar el valor debe ser negativo y se har la transaccin si el usuario cuenta con suficientes folios. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin.

Respuesta

SaldoAnterior: Saldo del emisor antes de la asignacin. SaldoNuevo: Saldo del emisor despus de la asignacin. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin

Servicio Cancelacin:
Este servicio cuenta con 3 mtodos: CancelaMltiples: Mtodo para cancelar uno o ms comprobantes en una sola llamada. Sirve tanto para servicios de sella timbra como de solo timbrado. Gradualmente ir sustituyendo al resto de los mtodos de cancelacin. CancelaOtros: Mtodo para cancelar comprobantes de otros PACs. No realiza verificacin de la existencia de los comprobantes del emisor, as que es responsabilidad del emisor que existan. RecuperarAcuses: Obtiene los acuses de cancelacin del SAT de todos los mtodos de cancelacin existentes.

SolictudCancelaMultiple
Solicitud:

ListaCancelar: Permite agregar la lista de los UUID de los comprobantes que se manden a cancelar. Guid: Identificador asignado por nuestro servicio durante el proceso de Sellado y Timbrado. RFC: El RFC del Contribuyente. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin.

Respuesta:

ResultadoCancelacion: Resultado de la cancelacin contiene UUID y Estatus.

UUID: Identificador asignado por nuestro servicio durante el proceso de Sellado y Timbrado. Estatus: Estado de la factura si realizo con xito la cancelacin tendr en Estatus Cancelado. TransaccionID: El mismo identificador de transaccin de la solicitud.

SolictudCancelaOtros
Solicitud:

RFCEmisor: El RFC del Contribuyente. RFCReceptor: El RFC del Contribuyente a quien se emiti el comprobante. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin. UUID: Identificador asignado por el servicio durante el proceso de Sellado y Timbrado.

Respuesta:

Resultado:
UUID: Identificador asignado por nuestro servicio durante el proceso de Sellado y Timbrado. Estatus: Estado de la factura si realizo con xito la cancelacin tendr en Estatus Cancelado. TransaccionID: El mismo identificador de transaccin de la solicitud.

RecuperaAcuseCancelacion
Solicitud:

SolicitudAcuse RFC: El RFC del Contribuyente. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin. UUID: Identificador del comprobante que se desea obtener el acuse.

RespuestaAcuse
AcuseXML: Acuse de cancelacin del sat. Estatus: Estatus del comprobante TransaccionID: Es el Identificador de la transaccin.

NOTA: En el servicio de RecuperaAcuseCancelacion se podrn obtener acuses en los casos en que los Estatus ante el SAT sean 201 202. Si el tiempo transcurrido entre la emisin y la cancelacin es mayor a 3 horas, el acuse podr obtenerse de manera casi inmediata. Si el tiempo transcurrido entre la emisin y la cancelacin es menor a dos horas, el acuse tarda en promedio un poco ms de 2 horas en reflejarse en nuestros repositorios. Si el acuse es de un comprobante timbrado con otro pac, el tiempo puede incluso variar ms. Favor de tomar esto en cuenta para programar la recuperacin de los acuses despus de un lapso razonable despus de la emisin para evitar peticiones innecesarias y darles mejor servicio.

Servicio Comprobante:
Este servicio es para emisores con perfil de Sella-Timbra, y ofrece 2 solicitudes para realizar el sellado y timbrado de un comprobante. SolicitudSellaTimbraXML: Sella y timbra el Comprobante enviado en formato cadena XML. NOTA: En caso de que al enviar la solicitud de Sellar y Timbrar y se presente una situacin externa (falla de corriente/perdida de conexin) y NO reciba una respuesta de nuestro servicio, se podr enviar una solicitud de estatus del comprobante (SolicitudEstatusComprobante) para confirmar el estatus actual del comprobante. La cual se describe ms adelante en la seccin de Servicio de Repositorio.

Importante: acerca del Hash del sello. El sello del documento se genera a partir de los elementos definidos por el xslt dado por el SAT para la generacin del sello Digital para el Comprobante Fiscal Digital por internet (cfdi). Este sello es el resultado de un hash del tipo Sha1 sobre los elementos de la cadena original de acuerdo al anexo 20. Este sello sirve como identificador nico del documento, sin embargo, en algunos casos puede llegar a duplicarse si todos los elementos de un documento son iguales (emisor, receptor, conceptos, importe, total, complementos, hora de sellado, etc). Cuando esto suceda el web Service enviara una excepcin del tipo "Duplicidad de Hash" en el segundo documento. Para el servicio Sella-Timbra, basta con enviar el documento de nueva cuenta con un segundo de diferencia, ya que el servicio de sellado toma la hora propia y la sustituye en el documento, generando un sello diferente al del primer documento. En el caso del servicio de Solo Timbrado ser necesario volver a sellar el documento con una hora diferente al menos para que pueda ser timbrado correctamente. Es importante tomar en cuenta que para la generacin de este Hash NO se toma en cuenta el folio y la serie.

Servicio Repositorio:
Este servicio es exclusivo para el perfil Sellar-Timbrar, y contiene las siguientes solicitudes: CancelaComprobante: Permite la solicitud de la cancelacin de un Comprobante fiscal. Este mtodo ser sustituido por el mtodo de cancelacin masiva. EstatusComprobante: Permite saber el estado en que se encuentra un comprobante (Generada o Cancelada) ObtenerComprobante: Permite obtener la cadena comprobante XML del comprobante fiscal, de 2 maneras, ya sea por medio del UUID o por el ID de transaccin con que fue creada. ObtenerQR: Permite obtener la cadena para la generacin del QR de un comprobante fiscal. Para buscar por medio del parmetro de TransaccionOriginal siendo est el Id de la transaccin con que se envi la solicitud de SolicitudSellaTimbra, el valor del atributo UUID deber ser null

RFC: El RFC del Contribuyente. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin. TransaccionOriginal: Es el identificador de la transaccin con que se envi la solicitud de Sellar y Timbrar (SolicitudSellaTimbraXML), esta opcin puede ser usado 3 das despus de que el comprobante fue sellado y timbrado. UUID (Universally unique identifier): Identificador asignado por nuestro servicio durante el proceso de Sellado y Timbrado.

Respuesta:

UUID: Identificador asignado por el servicio del SAT durante el proceso de Sellado y Timbrado. Codigo: Es el cdigo del estado actual en que se encuentra el comprobante fiscal. Descripcion: Es una breve descripcin del estado actual. UltimaActualizacion: La fecha de la ltima modificacin realizada al comprobante. TransaccionID: El mismo identificador de transaccin de la solicitud.

 SolicitudObtenerComprobante

Solicitud:

Para enviar la solicitud solo con el UUID, el valor de la TransaccionOriginal deber ser 0.

Para buscar por medio del parmetro de TransaccionOriginal siendo est el Id de la transaccin con que se envi la solicitud de SolicitudSellaTimbra, el valor del atributo UUID deber ser null.

RFC: El RFC del Contribuyente. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin. TransaccionOriginal: Es el identificador de la transaccin con que se envi la solicitud de Sellar y Timbrar (SolicitudSellaTimbraXML), esta opcin puede ser usado 3 das despus de que el comprobante fue sellado y timbrado. UUID (Universally unique identifier): Identificador asignado por nuestro servicio durante el proceso de Sellado y Timbrado.

Respuesta: La respuesta a cualquiera de las 2 formas en que se envi (UUID o Transaccin Original) ser la cadena XML del comprobante encontrado.

CFDi: Es el comprobante en formato de cadena XML, procesado con el Sello y Timbre digital. Al ser enviado con CDATA (Character Data), se recibe en el mismo formato, "<! [CDATA [" y termina con "]]>". TransaccionID: El mismo identificador de la transaccin.

 SolicitudObtenerQR (QuickResponse code)

Solicitud:

RFC: El RFC del Contribuyente. Token: Es el token de transaccin del usuario. TransaccionID: Es el Identificador de la transaccin. UUID (Universally unique identifier): Identificador asignado por el servicio del SAT durante el proceso de Sellado y Timbrado. Respuesta:

Imagen: Este es el arreglo de bits de la imagen generada para el QR. TransaccionID: El mismo identificador de transaccin de la solicitud.

Servicio Timbrar:
En caso de no requerir el servicio de Sellado se ofrece la opcin de Solo Timbrar, el cual cuenta con sus propias solicitudes para realizar el timbrado, y para el manejo de los comprobantes que solo fueron timbrados por nosotros: TimbraXML: Permite realizar el timbrado a un CFD con un sello vlido, siempre y cuando no haya sido sellado en las ltimas 72 horas. CancelaTimbrado: Permite solicitar la cancelacin de un timbre a un CFDi que haya sido timbrado por nuestro servicio. EstatusTimbrado: Permite consultar el estado actual del timbre digital (Generado y Cancelado) ObtenerTimbrado: Permite recuperar la cadena XML del nodo del timbre digital de un comprobante por medio de su UUID o nmero de transaccin. ObtenerQRTimbrado: Permite obtener la cadena del QR generado para el timbrado de un comprobante.

 SolicitudTimbraXML Solicitud:

ComprobanteXML: El comprobante en una cadena XML, que contiene la informacin del Emisor, receptor y conceptos de venta. En algunos casos es necesario agregar el CDATA (Character Data) lo que est dentro de una seccin CDATA es ignorado por el intrprete. Una seccin CDATA empieza con "<! [CDATA [" y termina con "]]>". Esto dentro de la seccin DatosXML. RFC: El RFC de contribuyente. TransaccionID: El nmero identificador de la transaccin. Token: Es el token de Transaccin de Usuario.

Respuesta:

CFDi: Es el comprobante en formato de cadena XML, procesado con el Sello y Timbre digital. Al ser enviado con CDATA (Character Data), se recibe en el mismo formato, "<! [CDATA [" y termina con "]]>".. TransaccionID: El mismo nmero de transaccin de la solicitud.

Seguridad:
La comunicacin de los clientes con ECODEX es llevada a travs de canales seguros de comunicacin con servicios de encriptacin de datos utilizando SSL, asegurando que la informacin que viaja entre los dos puntos no puede ser conocida por un tercero. SSL proporciona autenticacin y privacidad de la informacin entre extremos sobre Internet mediante el uso de criptografa. Habitualmente, slo el servidor es autenticado (es decir, se garantiza su identidad) mientras que el cliente se mantiene sin autenticar. SSL implica una serie de fases bsicas: Negociar entre las partes el algoritmo que se usar en la comunicacin. Intercambio de claves pblicas y autenticacin basada en certificados digitales. Cifrado del trfico basado en cifrado simtrico.

Manejo de excepciones:
En la mayor parte de todos los mtodos, nuestros servicios manejan 3 tipos de excepciones FallaSesion: Por lo general indica la expiracin del token o el uso de uno malformado o que no corresponde al emisor del que se hace la operacin. FallaValidacion: Esta indica algn error en uno o ms datos enviados por el usuario. En el caso del timbrado se regresan los errores definidos por el SAT. En el caso del resto de los mtodos, FallaServicio: Excepciones no controladas o que puedan ser causadas por algn problema en el servidor. Se recomienda implementar un mtodo de reintentos en las llamadas.

Estos errores manejan mucha informacin que puede ayudar a encontrar errores en los mtodos del desarrollador, ya que principalmente las excepciones del tipo FallaValidacion, son muy descriptivas sobre lo que pasa en cada llamada. El manejo de otro tipo de excepciones, como timeouts queda del lado del usuario, implementando el manejo recomendado por su herramienta de programacin.

Kit de Pruebas
El objetivo del kit de Integracin Ecodex, es ofrecer una demostracin de la forma en que el WebService realiza el sellado y timbrado de los comprobantes. Proveemos los siguientes ejemplos: Ejemplo C#: Contiene el ejemplo en cdigo C# la solucin fue desarrollado utilizando: Microsoft Visual Studio 2010. Ejemplo Python: Contiene el ejemplo en python cortesa de Universo Libre Se estarn integrando paulatinamente los ejemplos de vb.net, java y php.

Emisor para casos de prueba:

RFC AAA010101AAA SUL010720JN8 Nmero de certificado 20001000000100005867 20001000000200000258 Clave de Integrador 2b3a8764-d586-4543-9b7e-82834443f219 2b3a8764-d586-4543-9b7e-82834443f219

Integrador para alta de emisores:

RFC BBB010101001 Clave de Integrador DF627BC3-A872-4806-BF37-DBD040CBAC7C

Direcciones (URLS) de WebService de pruebas Las direcciones de nuestros Servicio web (WebService) para pruebas son:

Para utilizar:
El servicio de seguridad ServicioSeguridad.svc: http://pruebas.ecodex.com.mx:2044/ServicioSeguridad.svc?wsdl

El servicio de Comprobantes ServicioComprobantes.svc: http://pruebas.ecodex.com.mx:2044/ServicioComprobantes.svc?wsdl El servicio de Repositorio ServicioRepositorio.svc: El servicio de Solo Timbrado ServicioTimbrado.svc: El servicio de Clientes ServicioClientes.svc: El servicio de Clientes ServicioCancelacion.svc: http://pruebas.ecodex.com.mx:2044/ServicioRepositorio.svc?wsdl http://pruebas.ecodex.com.mx:2044/ServicioTimbrado.svc?wsdl http://pruebas.ecodex.com.mx:2044/ServicioClientes.svc?wsdl http://pruebas.ecodex.com.mx:2044/ServicioCancelacion.svc?wsdl

Para pruebas de los web services SSL:

El servicio de seguridad ServicioSeguridad.svc: https://pruebas.ecodex.com.mx:2045/ServicioSeguridad.svc?wsdl

El servicio de Comprobantes ServicioComprobantes.svc: https://pruebas.ecodex.com.mx:2045/ServicioComprobantes.svc?wsdl El servicio de Repositorio ServicioRepositorio.svc: El servicio de Solo Timbrado ServicioTimbrado.svc: El servicio de Clientes ServicioClientes.svc: El servicio de Clientes ServicioCancelacion.svc: https://pruebas.ecodex.com.mx:2045/ServicioRepositorio.svc?wsdl https://pruebas.ecodex.com.mx:2045/ServicioTimbrado.svc?wsdl https://pruebas.ecodex.com.mx:2045/ServicioClientes.svc?wsdl http://pruebas.ecodex.com.mx:2044/ServicioCancelacion.svc?wsdl

Cdigos de Error enviados por SAT

La siguiente es una lista de errores que especifica el SAT no se deben presentar para lograr el sellado y timbrado exitoso de los comprobantes fiscales digitales, se pueden utilizar con los siguientes datos de Emisor a fin de probar tanto los certificados como los dems servicios web, se recomienda utilizar un solo RFC de Receptor para las pruebas que realicen para fines de poder brindar un mejor soporte.
Cdigo de error del SAT 301 302 303 304 305 306 307 308 401 402 403 Mensaje Original de SAT Que no cumpla con el estndar de XML (Conforme al W3C) y con la estructura XML (XSD y complementos aplicables). Que el sello del Emisor no sea vlido Que el CSD del Emisor no corresponda al RFC que viene como Emisor en el Comprobante. Que el CSD del Emisor haya sido revocado, utilizando la lista de LCO. Que la fecha de emisin est fuera de la vigencia del CSD del Emisor. Que la llave utilizada para sellar no corresponda a un CSD (ej. de FIEL). Que contenga un timbre previo. Que el CSD del Emisor no haya sido firmado por uno de los Certificados de Autoridad de SAT. Que el rango de la fecha de generacin sea mayor a 72 horas para la emisin del timbre. Que no exista el RFC del emisor conforme al rgimen autorizado (Lista de validacin de rgimen) LCO. Que la fecha de emisin sea anterior al 01 de Enero 2011.

Complementos Se incluye tambin dentro del kit, un comprobante con complementos de cada tipo para la validacin de elaboracin Certificados que soportamos ante el SAT de los siguientes casos, los cuales estn en la carpeta Complementos: Detallista. Divisas. Donatoria. EstadoDeCuentaCombustible. ImpuestosLocales.

Para mayor referencia de cada una consultar en la siguiente pgina oficial: http://www.sat.gob.mx/sitio_internet/e_sat/comprobantes_fiscales/15_9255.html

Validacin de pruebas
El sat proporciona un validador de forma y sintaxis en: https://www.consulta.sat.gob.mx/sicofi_web/moduloECFD_plus/ValidadorCFDI/Validador%20cfdi.html

Se recomienda implementar validaciones previas al timbrado de los errores ms comunes en las pruebas sobre los elementos que puedan ser ms susceptibles a capturas errneas de los usuarios (Rfcs, no de comprobantes, elementos opcionales, etc). Importante: ya que se libere en ambiente productivo, evite hacer pruebas de facturas por 1 peso. Nuestro servicio garantiza la entrega de comprobantes si se timbro correctamente.

LOCAL WSDL y otros Lenguajes

Para clientes en lenguajes que utilicen el Soap Toolkit e incluso en lenguajes de script como php, python, etc. Se recomienda que bajen el wsdl en modo local, as se evita 1 vuelta al servidor cada vez que se hace una peticin y el servicio se hace de un modo ms rpido. Los WSDL de pruebas se anexan en el kit de Integracin en la Carpeta WSDL. Los WSDL se enviarn a peticin del integrador al momento de adquirir sus timbres. Ligas con los problemas ms comunes. Conversin de bmp a .png en php http://www.phpro.org/examples/Convert-BMP-to-JPG.html Conversion de encode a utf 8 en Fox pro http://www.west-wind.com/presentations/foxunicode/foxunicode.asp#WhatProblem

Herramientas web Services

Soap UI: Herramienta libre para pruebas de web services. Altamente recomendado. CURL: Herramienta de lnea de comando que soporta transferencia de datos con sintaxis url.

Contacto
Contctenos para comenzar el proceso de implementacin y adquisicin de WebService WsDex para el servicio de Sellado y Timbrado para sus comprobantes fiscales digitales. Desarrollo Corporativo de Negocios en Tecnologa de la Informacin SA de CV Av. Lpez Mateos Sur 2077 Local Z-16, C.P. 44510 Guadalajara, Jal, Mxico. Telfono: (33) 30 30 7258 Lada nacional sin costo: 01800 777 8484 Skype: Soporte_ecodex Soporte_ecodex_2 contacto@ecodex.com.mx

Tabla de control de cambios: Version Changes V2.0 New Versin V2.0.1 Correcciones en base a los comentarios de Andrs Moreno sobre los ejemplos de cancelacin y alta de emisores.