developers.facturacionmoderna.comDevelopers - Facturación Moderna

01-800-260-5000 E-mail: ventas@facturacionmoderna.com Solicitar cotización facebook twitter Introducción Documentación Complementos CFDI Retenciones Cliente Demo Cliente WS de prueba Contacto Teléfonos Conector de timbrado CtiFac -- Faqs Preguntas frecuentes Documentación para desarrolladores e integradores Inicio Documentación Introducción ¿Cómo funciona? Kit de implementación Método requestTimbrarCFDI Método requestCancelarCFDI Archivos soportados Ejemplos Retención Ejemplos CFDI versión 3.3 Ejemplos de conexión Códigos de error Cliente Web Service de pruebas Herramientas Generar archivos .pem Aplicar a modo producción Introducción La empresa Facturación Moderna S.A de C.V, es un Proveedor Autorizado de Certificación (PAC) con número de autorización: 58077 que ofrece los servicios de validación, emisión, resguardo y certificación de CFDI . Facturación Moderna cuenta con una API SOAP para el servicio de emisión/timbrado de CFDI. Opciones de timbrado Opción 1: Timbrado de CFDI a partir de un archivo de texto simple Opción 2: Timbrado de CFDI a partir de un archivo XML que siga el estándar CFDI propuesto por el SAT . Nota: La documentación aquí descrita aplica únicamente para conexiones por Web services. -- Servicios incluidos Al contratar con nosotros el servicio de timbrado, te proporcionamos lo siguiente: Portal de administración para alta y bloqueo de emisores, consulta de consumo de timbres. Soporte técnico por email, teléfono y chat. La asesoría excluye revisión de código para identificar problemas de lógica, manejo de clases o errores de sintaxis, propios del usuario. Certificación de CFDI con soporte para todos los Complementos (mediante estructura XML, para el caso de TXT al momento solo se tienen los de mayor uso, preguntar al área de soporte). Certificación de CFDI de retenciones y sus respectivos complementos. Almacenamiento por 3 meses (recuperación por petición SOAP) Cancelación por Web Service sin costo XML timbrado Generación de CBB en formato PNG para incluir en PDF Servicios adicionales Generación de la representación impresa del CFDI. Personalización de Representación impresa (Debe enviar bosquejo de diseño deseado para su respectiva cotización) Envío automático del CFDI al cliente final vía Email. (Servicio básico) Respaldo automático de tus comprobantes emitidos a un servidor FTP o cuenta de Dropbox (pago por RFC emisor) . Requerimientos adicionales o manejo de lógica del negocio. (Bajo análisis previo) ¿Comó funciona? El servicio de timbrado recibe una petición con el archivo a certificar codificado en Base64 y devuelve un objeto con el XML certificado. A continuación se presenta un diagrama del funcionamiento general de la solución: Insumos: Archivo de texto (layout) o XML que se quiere enviar a certificar en Base64 . Procesamiento: Proceso de validación del comprobante, certificación, envío y almacenamiento del mismo. Resultado: En caso de éxito el sistema devuelve archivo XML del CFDI con nodo TimbreFiscalDigital en formato de texto codificado en Base64 . Diagrama 1: Funcionamiento general. Kit de implementación Cliente genérico de pruebas ideal para validar tus archivos a certificar Cliente Web service de pruebas Nota: El cliente es solamente de referencia, sólo deberá ser utilizado para realizar pruebas de estructura y contenido de los archivos a timbrar (Layout o XML). En ambiente real no existe interfaz gráfica, todo debe ser enviado por peticiones SOAP Archivos de ayuda Certificado de sellos digital de pruebas (CSD) Archivos fuente para prueba XSD y XSLT para CFDI XSD y XSLT para CFDI de retenciones URL del servicio de timbrado. (Endpoint) https://t1demo.facturacionmoderna.com/timbrado/soap WSDL https://t1demo.facturacionmoderna.com/timbrado/wsdl Métodos requestTimbrarCFDI requestCancelarCFDI Estructuras de prueba TXT y XML de ejemplo Proyectos ejemplo de Conexión Ejemplos en diferentes lenguajes para conexión con nuestro Web Service Método requestTimbrarCFDI El método requestTimbrarCFDI es capaz de certificar cualquier archivo en formato XML o TXT (que cumpla con las estructuras soportadas por el servicio), el cual espera como parámetro un objeto de la siguiente forma: Propiedad Tipo Descripción Observaciones Descripción del objeto de petición UserPass String Contraseña de la conexión Para el ambiente de pruebas es: b9ec2afa3361a59af4b4d102d3f704eabdf097d4 UserID String Nombre del usuario de la conexión Para el ambiende de pruebas es: UsuarioPruebasWS emisorRFC String RFC del la empresa que emite el comprobante a certificar. Para el ambiente de pruebas el RFC del emisor deberá ser alguno de los siguientes: LAN7008173R5 MSE061107IA8 TCM970625MB1 Descargar Certificados de Prueba . text2CFDI String Archivo fuente a certificar (Layout o XML) codificado en Base64 Importante El nodo debe estar codificado en Base64. Puede realizar pruebas de estructura del archivo aquí. Si desea visualizar ejemplos de archivos fuente de clic aquí generarPDF (Opcional) Boolean True si se desea que el servicio retorne la representación impresa del CFDI en formato PDF. Al utilizar está propiedad, el método requestTimbrarCFDI retorna el archivo codificado en Base64 en el nodo pdf . generarCBB (Opcional) Boolean True si se desea que el servicio regrese un archivo PNG con el código de barras bidimensional (CBB). Al utilizar está propiedad, el método regresa el nodo png en lugar del nodo pdf Petición SOAP A continuación se muestra una petición al método en formato XML para consumir el método requestTimbrarCFDI con SOAP 1.2 <?xml version="1.0" encoding="UTF-8"?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1="https://t1demo.facturacionmoderna.com/timbrado/soap" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:enc="http://www.w3.org/2003/05/soap-encoding"> <env:Body> <ns1:requestTimbrarCFDI env:encodingStyle="http://www.w3.org/2003/05/soap-encoding"> <param0 xsi:type="enc:Struct"> <UserPass xsi:type="xsd:string">b9ec2afa3361a59af4b4d102d3f704eabdf097d4</UserPass> <UserID xsi:type="xsd:string">UsuarioPruebasWS</UserID> <emisorRFC xsi:type="xsd:string">RFC del emisor contenido en el archivo</emisorRFC> <text2CFDI xsi:type="xsd:string">Archivo codificado en Base64</text2CFDI> <generarTXT xsi:type="xsd:boolean">false</generarTXT> <generarPDF xsi:type="xsd:string">false</generarPDF> <generarCBB xsi:type="xsd:boolean">false</generarCBB> </param0> </ns1:requestTimbrarCFDI> </env:Body> </env:Envelope> Descripción del objeto de respuesta Una vez realizada la petición en caso de éxito nos devolverá un objeto con las siguientes propiedades Nodo Tipo Descripción Ejemplos de contenido xml String (Base64) Contiene el CFDI certificado en formato XML. (Codificado en Base64) × Ejemplo de archivo XML <?xml version="1.0" encoding="UTF-8"?> <cfdi:Comprobante xmlns:cfdi="http://www.sat.gob.mx/cfd/3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:schemaLocation="http://www.sat.gob.mx/cfd/3 http://www.sat.gob.mx/sitio_internet/cfd/3/cfdv32.xsd" version="3.2" fecha="2012-10-24T10:11:12" folio="1" serie="A" subTotal="100.00" descuento="0.00" total="116.00" Moneda="MXN" condicionesDePago="Contado" tipoDeComprobante="ingreso" noCertificado="20001000000100001703" certificado="MIIFLTCCBBWgAwIBAgIUMjAwMDEwMDAwMDAxMDAwMDE3MDMwDQYJKoZIhvcNAQEFBQAwggFvMRgwFgYDVQQDDA9BLkMuIGRlIHBydWViYXMxLzAtBgNVBAoMJlNlcnZpY2lvIGRlIEFkbWluaXN0cmFjacOzbiBUcmlidXRhcmlhMTgwNgYDVQQLDC9BZG1pbmlzdHJhY2nDs24gZGUgU2VndXJpZGFkIGRlIGxhIEluZm9ybWFjacOzbjEpMCcGCSqGSIb3DQEJARYaYXNpc25ldEBwcnVlYmFzLnNhdC5nb2IubXgxJjAkBgNVBAkMHUF2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEBhMCTVgxGTAXBgNVBAgMEERpc3RyaXRvIEZlZGVyYWwxEjAQBgNVBAcMCUNveW9hY8OhbjEVMBMGA1UELRMMU0FUOTcwNzAxTk4zMTIwMAYJKoZIhvcNAQkCDCNSZXNwb25zYWJsZTo...