Web Service de ifactura

Transcripción

1 2018/01/26 10:43 1/23 Web Service de ifactura Web Service de ifactura Introducción Como proveedor autorizado de certificación con el número 68934, itimbre realiza la validación y certificación (timbrado) de Comprobantes Fiscales Digitales generados por Internet (CFDI) conforme a las especificaciones requeridas por el SAT a través de sus Servicios Web (Software como Servicio) de una manera rápida y segura. Adicionalmente el Web Service de ifactura le ofrece el servicio de generación y firmado de su XML. A través del Portal de itimbre usted podrá proporcionar su firma digital (CSD) para que itimbre se encargue de generar el sello del XML y así ahorrar la programación de esas funciones. Además de la certificación de sus comprobantes, ifactura le ofrece las siguientes funciones: Cancelación de CFDIs Búsqueda de sus Comprobantes. Respaldos automáticos. Acceso desde cualquier lugar a sus comprobantes y reportes. Acceso desde dispositivos móviles, consolas, SmartTvs, o cualquier gadget con navegador web. Generación automática de PDF. Envío automático de los CFDI al receptor. Generación de reportes de comprobantes generados. Entre otros. Web Service de ifactura La característica principal de la arquitectura del Web Service de itimbre es que utiliza JSON+REST en lugar del tradicional XML+SOAP. Por lo tanto es importante tener conocimientos del formato JSON para poder crear los mensajes que serán enviados al Web Service. Afortunadamente JSON es mucho más fácil de entender y de implementar. Registro El registro de las cuentas se detalla en Registro de cuentas en ifacura. Conexión Para realizar la conexión con el Web Service de ifactura es necesario proveer al menos los siguientes datos en el llamado: Cuenta: Es el nombre de la cuenta con la que cuenta en el servicio de facturación.

2 Last update: 2018/01/25 14:56 web-service-ifactura Usuario: El usuario registrado con los permisos suficientes para realizar la operación que se esta solicitando a través del método. Contraseña: Es la clave correspondiente al usuario con el que se está autentificando. Método: Es la función a realizar de acuerdo al catálogo de métodos soportados. Parámetros: Los parámetros son datos adicionales u opcionales que deben enviarse y dependen del método utilizado. Métodos soportados Método Parámetro a enviar Crear Nueva Factura nuevo_factura Crear Complemento Pago nueva_factura Convertir CFD en CFDI cfd2cfdi Crear Nuevo Recibo de Nómina nueva_factura Cancelar un CFDI cancelarcfdi Serialización y Envío Al realizar el llamado, las variables se deben serializar en formato JSON y almacenarse en una variable llamada q, la cual se debe enviar por HTTP. Dirección del Servicio: Métodos Crear Nuevo Factura Método: nueva_factura Método utilizado para generar un nuevo CFDI 3.3, de timbrado, el cual puede corresponder a cualquiera de los siguientes documentos: Factura, Recibo de Honorarios, Recibo de Arrendamiento, Recibo de Donativos, Nota de Cargo, Nota de Crédito, Nota de Devolución, Carta Porte. NOTA: Es necesario revisar el nuevo catalogo del cfdi SAT donde podra encontrar las claves correspondientes de la nueva facturacion electronica El llamado recibirá las siguientes validaciones: Printed on 2018/01/26 10:43

3 2018/01/26 10:43 3/23 Web Service de ifactura Los datos enviados están completos. El método utilizado es correcto. Los datos enviados tienen un contenido y formato correspondiente al dato que se indica. Que los datos dependientes de bases de datos en el servidor sean correctos. Que los datos validados por el SAT se encuentren en un formato correcto. Llamado Para generar un recibo se deben mandar al servicio solamente los datos correspondientes a los Datos del Comprobante y Conceptos. Ejemplo de Llamado "conceptos": [ "ClaveProdServ": " ", "ClaveUnidad": "LTR", "Importe": "28.88", "Unidad": "LTS", "noidentificacion": "16", "Cantidad": "2", "descripcion": "DISEL", "ValorUnitario": "14.44", "Impuestos": "Traslados": [ "Base": "28.88", "Impuesto": "002", "TipoFactor": "Tasa", "TasaOCuota": "0.16", "Importe": "4.62", "Base": "2", "Impuesto": "003", "TipoFactor": "Cuota", "TasaOCuota": "0.3154", "Importe": "0.63" ], "ClaveProdServ": " ", "ClaveUnidad": "LTR", "Importe": "83.86", "Unidad": "LTS",

4 Last update: 2018/01/25 14:56 web-service-ifactura "noidentificacion": "2", "Cantidad": "5.51", "descripcion": "PREMIUM", "ValorUnitario": "15.22", "Impuestos": "Traslados": [ "Base": "83.86", "Impuesto": "002", "TipoFactor": "Tasa", "TasaOCuota": "0.16", "Importe": "13.42", "Base": "5.51", "Impuesto": "003", "TipoFactor": "Cuota", "TasaOCuota": "0.4637", "Importe": "2.55" ], "ClaveProdServ": " ", "ClaveUnidad": "LTR", "Importe": "84.12", "Unidad": "LTS", "noidentificacion": "1", "Cantidad": "6.19", "descripcion": "MAGNA", "ValorUnitario": "13.59", "Impuestos": "Traslados": [ "Base": "84.12", "Impuesto": "002", "TipoFactor": "Tasa", "TasaOCuota": "0.16", "Importe": "13.46", "Base": "6.19", "Impuesto": "003", "TipoFactor": "Cuota", "TasaOCuota": "0.38", "Importe": "2.35" ] Printed on 2018/01/26 10:43

5 2018/01/26 10:43 5/23 Web Service de ifactura ], "datos_factura": "FormaPago": "04", "TipoCambio": "1", "MetodoPago": "PUE", "RegimenFiscal": "601", "LugarExpedicion": "22010", "Moneda": "MXN", "TipoDeComprobante": "I", "CondicionesDePago": "Crédito", "no_sucursal": "1", "SubTotal": "196.86", "Version": "3.3", "Impuestos": "TotalImpuestosRetenidos": "0", "TotalImpuestosTrasladados": "37.03", "Traslados": [ "Impuesto": "002", "TipoFactor": "Tasa", "TasaOCuota": "0.16", "Importe": "31.5", "Impuesto": "003", "TipoFactor": "Cuota", "TasaOCuota": "0.3154", "Importe": "0.63", "Impuesto": "003", "TipoFactor": "Cuota", "TasaOCuota": "0.4637", "Importe": "2.55", "Impuesto": "003", "TipoFactor": "Cuota", "TasaOCuota": "0.38", "Importe": "2.35" ], "CfdiRelacionados": "TipoRelacion": "01", "CfdiRelacionado": "UUID": "0DDABF0D CCC-BF1C-6CE3C26A0696", "method": "nueva_factura",

6 Last update: 2018/01/25 14:56 web-service-ifactura "cliente": "id": "189", "UsoCFDI": "G01", "nombre": "NUEVA EMPRESA DE EJEMPLO", "rfc": "XAXX ", "correo": "cuenta": "demo", "user": "administrador", "password": "Administr4dor", "getpdf": true, "enviarfactura": false Respuesta SI el procesamiento resulta correcto se responderá a la solicitud con un objeto JSON consistente en lo siguiente: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene la respuesta, en el caso de ser correcta contiene los siguientes datos: retcode: Es el código de respuesta, el 1 significa correcto. data: Corresponde al folio del recibo que se le asignó en el servicio, este es el que se requiere para generar una factura por medio del servicio de Autofacturación. ok-recibo.json "result": "retcode": 1, "data": 8877 Si el procesamiento no es correcto, se responderá con un objeto con los siguientes datos: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: retcode: Es el código de respuesta, cualquier código diferente a 1 es incorrecto, se detalla en el Catálogo de Códigos de Respuesta. data: Consiste en una descripción del error dirigida al usuario. Printed on 2018/01/26 10:43

7 2018/01/26 10:43 7/23 Web Service de ifactura error-recibo.json "id_transaccion":0, "result": "retcode":10, "error":"la cuenta especificada no existe." Crear Complemento de Pago Método: nueva_factura Método utilizado para generar un nuevo CFDI 3.3, timbrado, con el complemento de pago Recibo de Pago, El llamado recibirá las siguientes validaciones: Los datos enviados están completos. El método utilizado es correcto. Los datos enviados tienen un contenido y formato correspondiente al dato que se indica. Que los datos dependientes de bases de datos en el servidor sean correctos. Que los datos validados por el SAT se encuentren en un formato correcto. Llamado Para generar una factura se debe enviar al servicio todos los bloques de datos; Datos del Comprobante, Datos del Cliente y Conceptos. Ejemplo "conceptos": [ "ClaveProdServ": " ", "ClaveUnidad": "ACT", "Importe": "0", "Cantidad": "1", "descripcion": "Pago", "ValorUnitario": "0" ], "datos_factura": "RegimenFiscal": "601", "LugarExpedicion": "22010", "Moneda": "XXX", "TipoDeComprobante": "P", "numero_de_pago": "1",

8 Last update: 2018/01/25 14:56 web-service-ifactura "cantidad_de_pagos": "1", "Version": "3.3", "method": "nueva_factura", "cliente": "id": "189", "UsoCFDI": "P01", "nombre": "NUEVA EMPRESA DE EJEMPLO", "rfc": "XAXX ", "Complementos": [ "Pagos": "Pago": [ "FechaPago": " T10:10:03", "FormaDePagoP": "01", "MonedaP": "MXN", "Monto": "5000", "DoctoRelacionado": [ "IdDocumento": "54EE66D7-63A A-0A76514AEEF5", "MonedaDR": "MXN", "MetodoDePagoDR": "PPD", "NumParcialidad": "1", "ImpSaldoAnt": "1", "ImpPagado": "1", "ImpSaldoInsoluto": "0" ] ] ], "cuenta": "demo", "user": "administrador", "password": "Administr4dor", "getpdf": true, "enviarfactura": false Respuesta SI el procesamiento resulta correcto se responderá a la solicitud con un objeto JSON consistente en lo siguiente: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: RFC: Es el RFC registrado en la cuenta, a nombre del cual se selló el comprobante. user: ID del usuario con el que se está autentificando en el servicio. retcode: Es el código de respuesta, el 1 significa correcto. UUID: Identificador único del CFDI. Printed on 2018/01/26 10:43

9 2018/01/26 10:43 9/23 Web Service de ifactura data: Contiene el XML completo, en caso de contener addenda en el request ya se encuentra incrustada. stampdate: Fecha del timbrado, fecha en la que se realizó la certificación del comprobante. acuse: Acuse de recepción del SAT, en caso de obtenerse inmediatamente se agrega, normalmente no sucede de esta manera. No es un elemento requerido. client_ del cliente, si no se indicó ninguno se toma del catálogo registrado en la cuenta, si no se encuentra tampoco ahí aparecerá solamente el nombre del cliente seguido de <>. pdfbase64: Contiene el PDF generado por la cuenta codificado en Base64, solamente se envía cuando se indica en el llamado. _result: Resultado del envío del correo. 1 para correcto y -1 para incorrecto. _error: Mensaje del servidor de correo cuando hay un error en el envío. ok-factura.json "result": "RFC": "XAXX ", "user": "23", "retcode": 1, "UUID": "D4F C5B-402A-A973-7BD84588BE40", "data": "<xml/>", "stampdate": " T10:00:00-07:00", "refid": "44536", "acuse": "acuse_sat=false", "client_ ": "NUEVA EMPRESA DE EJEMPLO<>", "pdfbase64": " === PDF EN BASE64 === " " _result": -1, " _error": "ERROR" Si el procesamiento no es correcto, se responderá con un objeto con los siguientes datos: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: retcode: Es el código de respuesta, cualquier código diferente a 1 es incorrecto, se detalla en el Catálogo de Códigos de Respuesta. error: Consiste en una descripción del error dirigida al usuario. error-factura.json "result": "retcode": 101, "error": "Error 301 al timbrar: 'XML mal formado - value

10 Last update: 2018/01/25 14:56 web-service-ifactura 'EEA9709DASD083R7' does not match regular expression facet '[A- Z,Ñ,&]3,4[0-9]2[0-1][0-9][0-3][0-9][A-Z,0-9]?[A-Z,0-9]?[0-9,A-Z]?' (ERROR)'" Convertir CFD a CFDI Método: cfd2cfdi Método para transformar un CFD a CFDI o para solamente agregar el complemento tfd:timbrefiscaldigital a un CFDI ya generado. El llamado recibirá las siguientes validaciones: Los datos enviados están completos. El método utilizado es correcto. Los datos enviados tienen un contenido y formato correspondiente al dato que se indica. Que los datos dependientes de bases de datos en el servidor sean correctos. Que los datos validados por el SAT se encuentren en un formato correcto. Se cumple con el estándar XML. Llamado Para generar un CFDI desde un CFD, o bien desde un CFDI v3.2 con o sin sellos, es necesario enviar los siguientes datos: Ejemplo de Llamado request-cfd2cfdi.json "method": "cfd2cfdi", "xml_version": "2.2", "xml_data": "<CFDv2.2/>", "cuenta": "demo", "user": "administrador", "password": "Administr4dor", "getpdf": true, "enviarfactura": false Existen las siguientes opciones para enviar al servicio: Printed on 2018/01/26 10:43

11 2018/01/26 10:43 11/23 Web Service de ifactura CFD v2.2: Se trata de un CFD de acuerdo a las especificaciones del Anexo 20 para un CFD 2.2, no es necesario alterar nada en el XML para enviarlo al servicio. CFDv2.2.xml <?xml version="1.0" encoding="utf-8"?> <Comprobante xmlns=" xmlns:xsi=" xsi:schemalocation=" version="2.2" serie="a" folio=" " fecha=" t13:49:57" noaprobacion=" " anoaprobacion="2013" formadepago="pago en una Sola Exhibición" subtotal="45000" total="45000" metododepago="no se que" tipodecomprobante="ingreso" LugarExpedicion="Mexico.DF" Moneda="Pesos" nocertificado=" " certificado= "MIIE1DCCA7ygAwIBAgIUMDAwMDEwMDAwMDAzMDA1NjEwNzkwDQYJKoZIhvcNAQEFBQAwgg GKMTgwNgYDVQQDDC9BLkMuIGRlbCBTZXJ2aWNpbyBkZSBBZG1pbmlzdHJhY2nDs24gVHJpY nv0yxjpytevmc0ga1uecgwmu2vydmljaw8gzgugqwrtaw5pc3ryywnpw7nuifryawj1dgfy awexoda2bgnvbasml0fkbwluaxn0cmfjacozbibkzsbtzwd1cmlkywqgzgugbgegsw5mb3j tywnpw7numr8whqyjkozihvcnaqkbfhbhy29kc0bzyxquz29ilm14msywjaydvqqjdb1bdi 4gSGlkYWxnbyA3NywgQ29sLiBHdWVycmVybzEOMAwGA1UEEQwFMDYzMDAxCzAJBgNVBAYTA k1ymrkwfwydvqqidbbeaxn0cml0bybgzwrlcmfsmrqwegydvqqhdatddwf1ahtdqw1vyzev MBMGA1UELRMMU0FUOTcwNzAxTk4zMTUwMwYJKoZIhvcNAQkCDCZSZXNwb25zYWJsZTogQ2x hdwrpysbdb3zhcnj1ymlhcybpy2hvytaefw0xmza3mjuymji3mdfafw0xnza3mjuymji3md FaMIIBHzE0MDIGA1UEAxMrQkVOQ0hNQVJLIEVMRUNUUk9OSUNTIFRJSlVBTkEgUyBERSBST CBERSBDVjE0MDIGA1UEKRMrQkVOQ0hNQVJLIEVMRUNUUk9OSUNTIFRJSlVBTkEgUyBERSBS TCBERSBDVjE0MDIGA1UEChMrQkVOQ0hNQVJLIEVMRUNUUk9OSUNTIFRJSlVBTkEgUyBERSB STCBERSBDVjElMCMGA1UELRMcU01FMDUwNTA0QTQ3IC8gU0FVTDcxMTExNTdZNjEeMBwGA1 UEBRMVIC8gU0FVTDcxMTExNUhCQ0NSUzA0MTQwMgYDVQQLEytCZW5jaG1hcmsgRWxlY3Ryb 25pY3MgVGlqdWFuYSBTIGRlIFJMIGRlIENWMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB gqdi/m/cdqoohxgg33wyeenzmbhzioc/yahdigfw1ciekh1dobgb8gxaoy27baibrtjirgl apbj3co6cjb72xodbipnyukwjb8/mytkpdiunap2j+wm7we4c54mfitf8iacbwft0rmjnzu EOCul8/Lz6WjdV16DIe6UC90IxpvmTGQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdD wqeawigwdanbgkqhkig9w0baqufaaocaqeacxdq+mrjamxzxrtfhum8z4bc1j3fy41ucajb mkrzp63ihsop/tuktb64tr3kjujszy7vj40pptylnjj43fiazd1rc5atcqx8ilwdzmibgkr AEaTXfxnUrTs+DeFd6HkZb5HFQUEbynXyXnxz31XM9I9UeM1wrQdkTCJwUzNqqrOR4cKsNt f7xui3tv+r7hijnln6agjcheugb5cz7pgd93ul5kghf9yimqonqqtf12y7xztnxvthvybyh c3arbx29a7slckijxdqrw1r8gask6y4gvpyynjhghexlfaismsjn+6qd8xef6j8cbzxsi84 nkj1xn+fndmu+lzyldok1q==" sello= "gb/u+e7ki3ctckooprfheonkr9q8rshersoe5i8gwaesgrcquu6cncnvdgljhgceyisaud b14yznprsamb8++yz3rzj6xo1sbmd4q8xdfysc0u3kopg5atv6gap2yl9gwdnut0eqfzzvk KHgoFG/Pnz+pH3TqBbOAN4+p6Btjgc="> <Emisor rfc="xaxx " nombre="empresa de Prueba SA de CV"> <DomicilioFiscal calle="fuerza Aerea" noexterior="35" colonia="colonia" localidad="tijuana" municipio="tijuana" estado="baja California Norte" pais="mexico" codigopostal="22222"/> <ExpedidoEn localidad="tijuana" estado="baja California Norte"

12 Last update: 2018/01/25 14:56 web-service-ifactura pais="mexico"/> <RegimenFiscal Regimen="Régimen General de Ley Personas Morales"/> </Emisor> <Receptor rfc="xexx " nombre="cliente SA"> <Domicilio calle="calle del Cliente" noexterior="1234" colonia="afueras" localidad="ciudad de México" estado="distrifo Federal" pais="méxico" codigopostal="00000"/> </Receptor> <Conceptos> <Concepto cantidad="1" unidad="n/a" noidentificacion="01" descripcion="servicio" valorunitario=" " importe=" "/> </Conceptos> <Impuestos totalimpuestostrasladados="0.00"> <Traslados> <Traslado impuesto="iva" tasa="0" importe="0.00"/> </Traslados> </Impuestos> </Comprobante> CFD v3.2 con Sellos: Es un CFDI 3.2 con todos los elementos requeridos, excepto por el complemento tfd:timbrefiscaldigital, el cual se agregará por el servicio. CFDv3.2.xml <?xml version="1.0" encoding="utf-8" standalone="no"?> <cfdi:comprobante xmlns:cfdi=" LugarExpedicion="Tijuana,Baja California Norte" Moneda="Pesos" certificado= "MIIEjDCCA3SgAwIBAgIUMDAwMDEwMDAwMDAyMDM0NjI5ODMwDQYJKoZIhvcNAQEFBQAwgg GVMTgwNgYDVQQDDC9BLkMuIGRlbCBTZXJ2aWNpbyBkZSBBZG1pbmlzdHJhY2nDs24gVHJpY nv0yxjpytevmc0ga1uecgwmu2vydmljaw8gzgugqwrtaw5pc3ryywnpw7nuifryawj1dgfy awexoda2bgnvbasml0fkbwluaxn0cmfjacozbibkzsbtzwd1cmlkywqgzgugbgegsw5mb3j tywnpw7numsewhwyjkozihvcnaqkbfhjhc2lzbmv0qhnhdc5nb2iubxgxjjakbgnvbakmhu F2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEB hmctvgxgtaxbgnvbagmeerpc3ryaxrviezlzgvyywwxfdasbgnvbacmc0n1yxvodmopbw9j MRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxPjA8BgkqhkiG9w0BCQIML1Jlc3BvbnNhYmxlOiB DZWNpbGlhIEd1aWxsZXJtaW5hIEdhcmPDrWEgR3VlcnJhMB4XDTEzMDQxNTE4MzM0MloXDT E3MDQxNTE4MzM0Mlowgc0xKjAoBgNVBAMTIU9MSVZFUiBYSUNPVEVOQ0FUTCBPTE1PUyBNQ VJUSU5FWjEqMCgGA1UEKRMhT0xJVkVSIFhJQ09URU5DQVRMIE9MTU9TIE1BUlRJTkVaMSow KAYDVQQKEyFPTElWRVIgWElDT1RFTkNBVEwgT0xNT1MgTUFSVElORVoxFjAUBgNVBC0TDU9 PTU84NTAyMTlCRjgxGzAZBgNVBAUTEk9PTU84NTAyMTlIREdMUkwwNTESMBAGA1UECxMJTk 8gQVBMSUNBMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDQEUod/knzrkEMFX/StAoV8 pyghj0b/onzimwvtmynuixmu3i8fhcw019fzxmu8j41wws67a4t4etdbnyb9kqactbj4/ww 7ckSGZu4B+BqoqrqeKZ5KSd8k5DHCoKnhNcAVqLt7rCJiT9M4qIsgHH+hP+wL7OHYRtOwWB H2ulFDwIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQ UFAAOCAQEARZ74t6jm4WbdvwiolqGPE3KSIx9TkGVxtTXMOVNTShCzFlETnIh2vM0YpvXt5 YCr0deireamg9PvKsRWc1k7sWgRnf700G5PYltzKFKtBTII0Fxqxd1Ib8vt+vmduT1kyE27 Printed on 2018/01/26 10:43

13 2018/01/26 10:43 13/23 Web Service de ifactura y5bhlah5u4klc64cml1vrxyybgm5f/3xhxrhjqnin5czqf3jqq9e4nmargiv4m3s8wkrqjx XKUW5mmMXiROW+0BNbivY7dd68zNnZUJydlcAS8t0Y4JKVEbsKDjwBUySKE3zM+hV9uvpmc ob9xxuwmt+36jiv0nuuhaqwsfrcawtfajbf57cp3monjhfo0nz69ayxodb0qajqk/t+g==" descuento="0.00" fecha=" t09:46:03" folio=" " formadepago="pago en una sola exhibición" metododepago="99" nocertificado=" " sello= "LaQqUcGySP2fwPBpA6pAk1nCOceNhpMwQoGKAW/njtFayrbr6d61R7Ezhmq3mXZRc0FVbf ufxsy3f2soc6yysub0tyhqxexsojiibdkduyi4li+xuivpo0qacfdrcjalnqyoeoughrkfr IwvVSUrOdNUUEKNYR/F91kf/JWtn10=" serie="a" subtotal=" " tipodecomprobante="ingreso" total=" " version="3.2" xmlns:xsi=" xsi:schemalocation=" <cfdi:emisor nombre="carlos Valentin Perez Nango" rfc="xaxx "> <cfdi:domiciliofiscal calle="calle 15" codigopostal="22400" colonia="libertad" estado="baja California" municipio="tijuana" noexterior="830" pais="méxico"/> <cfdi:expedidoen estado="baja California Norte" localidad="tijuana" pais="mexico"/> <cfdi:regimenfiscal Regimen="Rgimen General de Ley Personas Morales"/> </cfdi:emisor> <cfdi:receptor nombre="cliente SA" rfc="xexx "> <cfdi:domicilio calle="calle del Cliente" codigopostal="00000" colonia="afueras" estado="distrifo Federal" noexterior="1234" pais="mexico"/> </cfdi:receptor> <cfdi:conceptos> <cfdi:concepto cantidad="1.00" descripcion="servicio" importe=" " unidad="n/a" valorunitario=" "/> </cfdi:conceptos> <cfdi:impuestos totalimpuestosretenidos="0.00" totalimpuestostrasladados="0.00"> <cfdi:retenciones> <cfdi:retencion importe="0.00" impuesto="iva"/> <cfdi:retencion importe="0.00" impuesto="isr"/> </cfdi:retenciones> <cfdi:traslados> <cfdi:traslado importe="0.00" impuesto="iva" tasa="0.00"/> </cfdi:traslados> </cfdi:impuestos> </cfdi:comprobante> CFD v3.2 sin Sellos: Se trata de un CFD 3.2, con todos los elementos requerido excepto por Certificado, Sello y NoCertificado.

14 Last update: 2018/01/25 14:56 web-service-ifactura CFDv3.2-sin-Sello.xml <?xml version="1.0" encoding="utf-8" standalone="no"?> <cfdi:comprobante xmlns:cfdi=" LugarExpedicion="Tijuana, B.C." Moneda="MXN" NumCtaPago="1245" condicionesdepago="crédito" descuento="0.00" fecha=" T11:32:45" serie= "AL" folio=" " formadepago="pago en una sola exhibición" metododepago="03" nocertificado="" sello="" certificado="" subtotal="700.00" tipodecomprobante="ingreso" total="422.00" version="3.2" xmlns:xsi=" xsi:schemalocation=" <cfdi:emisor nombre="carlos Valentin Perez Nango" rfc="xaxx "> <cfdi:domiciliofiscal calle="calle 15" codigopostal="22400" colonia="libertad" estado="baja California" municipio="tijuana" noexterior="830" pais="méxico"/> <cfdi:regimenfiscal Regimen="Régimen General"/> </cfdi:emisor> <cfdi:receptor nombre="nueva EMPRESA DE EJEMPLO" rfc="eea r7"> <cfdi:domicilio calle="principal" codigopostal="22140" colonia="cacho" estado="baja CALIFORNIA" municipio="tijuana" noexterior="150" nointerior="b" pais="mexico"/> </cfdi:receptor> <cfdi:conceptos> <cfdi:concepto cantidad="10.00" descripcion="tomate saladette s/m" importe="200.00" noidentificacion="640130" unidad="kg" valorunitario="20.00"/> <cfdi:concepto cantidad="50.00" descripcion="cebolla Blanca pelada s/m" importe="500.00" noidentificacion="766115" unidad="kg" valorunitario="10.00"/> </cfdi:conceptos> <cfdi:impuestos totalimpuestosretenidos="300.00" totalimpuestostrasladados="22.00"> <cfdi:retenciones> <cfdi:retencion importe="100.00" impuesto="iva"/> <cfdi:retencion importe="200.00" impuesto="isr"/> </cfdi:retenciones> <cfdi:traslados> <cfdi:traslado importe="22.00" impuesto="iva" tasa="11.00"/> </cfdi:traslados> </cfdi:impuestos> </cfdi:comprobante> Respuesta SI el procesamiento resulta correcto se responderá a la solicitud con un objeto JSON consistente en lo Printed on 2018/01/26 10:43

15 2018/01/26 10:43 15/23 Web Service de ifactura siguiente: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: RFC: Es el RFC registrado en la cuenta, a nombre del cual se selló el comprobante. user: ID del usuario con el que se está autentificando en el servicio. retcode: Es el código de respuesta, el 1 significa correcto. UUID: Identificador único del CFDI. data: Contiene el XML completo, en caso de contener addenda en el request ya se encuentra incrustada. stampdate: Fecha del timbrado, fecha en la que se realizó la certificación del comprobante. acuse: Acuse de recepción del SAT, en caso de obtenerse inmediatamente se agrega, normalmente no sucede de esta manera. No es un elemento requerido. client_ del cliente, si no se indicó ninguno se toma del catálogo registrado en la cuenta, si no se encuentra tampoco ahí aparecerá solamente el nombre del cliente seguido de <>. pdfbase64: Contiene el PDF generado por la cuenta codificado en Base64, solamente se envía cuando se indica en el llamado. _result: Resultado del envío del correo. 1 para correcto y -1 para incorrecto. _error: Mensaje del servidor de correo cuando hay un error en el envío. ok-cfd2cfdi.json "result": "RFC": "XAXX ", "user": "23", "retcode": 1, "UUID": "D4F C5B-402A-A973-7BD84588BE40", "data": "<xml/>", "stampdate": " T10:00:00-07:00", "ip_addr": " ", "refid": "44536", "acuse": "acuse_sat=false", "client_ ": "NUEVA EMPRESA DE EJEMPLO<>", "pdfbase64": " === PDF EN BASE64 === " " _result": -1, " _error": "ERROR" Si el procesamiento no es correcto, se responderá con un objeto con los siguientes datos: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos:

16 Last update: 2018/01/25 14:56 web-service-ifactura retcode: Es el código de respuesta, cualquier código diferente a 1 es incorrecto, se detalla en el Catálogo de Códigos de Respuesta. error: Consiste en una descripción del error dirigida al usuario. error-cfd2cfdi.json "result": "retcode": -1, "error": "El folio ya existe." Nuevo Recibo de Nómina Método: nueva_factura Método para generar un cfdi 3.3 con el complemento de nomina 1.2 timbrado. El llamado recibirá las siguientes validaciones: Los datos enviados están completos. El método utilizado es correcto. Los datos enviados tienen un contenido y formato correspondiente al dato que se indica. Que los datos dependientes de bases de datos en el servidor sean correctos. Que los datos validados por el SAT se encuentren en un formato correcto. Llamado Para generar un Recibo de Nómina CFDI es necesario enviar los siguientes datos: Ejemplo de Llamado "conceptos": [ "Cantidad": "1", "ClaveUnidad": "ACT", "Descripcion": "Pago de nómina", "ClaveProdServ": " ", "ValorUnitario": " ", "Importe": " ", "Descuento": " " ], "datos_factura": "FormaPago": "99", Printed on 2018/01/26 10:43

17 2018/01/26 10:43 17/23 Web Service de ifactura "SubTotal": " ", "Descuento": " ", "Total": "3821.4", "MetodoPago": "PUE", "RegimenFiscal": "601", "LugarExpedicion": "32250", "Moneda": "MXN", "TipoDeComprobante": "N", "correo": "Version": "3.3", "method": "nueva_factura", "cliente": "id": "1", "UsoCFDI": "P01", "nombre": "EMPRESA DEMO NAMEX", "rfc": "WJU070709R29", "Complementos": [ "Nomina": "Version": "1.2", "TipoNomina": "O", "FechaPago": " ", "FechaInicialPago": " ", "FechaFinalPago": " ", "NumDiasPagados": "7.000", "TotalPercepciones": " ", "TotalDeducciones": " ", "Emisor": "RegistroPatronal": "A ", "Receptor": "UsoCFDI": "P01", "Rfc": "RILJ A1", "Nombre": "JESUS ABRAHAM RIVAS LOZANO", "Curp": "RILJ800712HCHVZS09", "NumSeguridadSocial": " ", "FechaInicioRelLaboral": " ", "Antigüedad": "P310W", "TipoContrato": "01", "Sindicalizado": "No", "TipoJornada": "01", "TipoRegimen": "02", "NumEmpleado": "50", "RiesgoPuesto": "5", "PeriodicidadPago": "02", "Banco": "012", "CuentaBancaria": " ", "SalarioBaseCotApor": "870.52", "SalarioDiarioIntegrado": "0", "ClaveEntFed": "CHH"

18 Last update: 2018/01/25 14:56 web-service-ifactura "Percepciones": "TotalSueldos": " ", "TotalSeparacionIndemnizacion": "0", "TotalGravado": "5691", "TotalExento": "809.35", "Percepcion": [ "TipoPercepcion": "001", "Clave": "Sueldos", "Concepto": "Percepcion Normal 45,00 H SB=813,00", "ImporteGravado": "4878", "ImporteExento": "0", "TipoPercepcion": "001", "Clave": "Sueldos", "Concepto": "Septimo Dia", "ImporteGravado": "813", "ImporteExento": "0", "TipoPercepcion": "005", "Clave": "FdoAhoPat", "Concepto": "Fdo Aho Aportacion Patronal", "ImporteGravado": "0", "ImporteExento": "728.35", "TipoPercepcion": "029", "Clave": "ValeDespen", "Concepto": "Vales de Despensa", "ImporteGravado": "0", "ImporteExento": "81" ], "Deducciones": "TotalOtrasDeducciones": " ", "TotalImpuestosRetenidos": "979.83", "Deduccion": [ "TipoDeduccion": "002", "Clave": "ISR", "Concepto": "ISR", "Importe": "979.83", "TipoDeduccion": "001", "Clave": "IMSS", "Concepto": "IMSS", "Importe": "162.38", Printed on 2018/01/26 10:43

19 2018/01/26 10:43 19/23 Web Service de ifactura "TipoDeduccion": "004", "Clave": "FdoAhoPat", "Concepto": "Fdo Aho Aportacion Patronal", "Importe": "728.35", "TipoDeduccion": "004", "Clave": "DedFdoAho", "Concepto": "Fdo Aho Empl Acum Empl= 32465,41 Empr= 32465,41", "Importe": "728.35", "TipoDeduccion": "004", "Clave": "CAFETERIA", "Concepto": "CAFETERIA", "Importe": "80.04" ] ], "cuenta": "demo", "user": "administrador", "password": "Administr4dor", "getpdf": true, "enviarfactura": false Respuesta SI el procesamiento resulta correcto se responderá a la solicitud con un objeto JSON consistente en lo siguiente: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: RFC: Es el RFC registrado en la cuenta, a nombre del cual se selló el comprobante. user: ID del usuario con el que se está autentificando en el servicio. retcode: Es el código de respuesta, el 1 significa correcto. UUID: Identificador único del CFDI. data: Contiene el XML completo, en caso de contener addenda en el request ya se encuentra incrustada. stampdate: Fecha del timbrado, fecha en la que se realizó la certificación del comprobante. acuse: Acuse de recepción del SAT, en caso de obtenerse inmediatamente se agrega, normalmente no sucede de esta manera. No es un elemento requerido. client_ del cliente, si no se indicó ninguno se toma del catálogo registrado en la

20 Last update: 2018/01/25 14:56 web-service-ifactura cuenta, si no se encuentra tampoco ahí aparecerá solamente el nombre del cliente seguido de <>. pdfbase64: Contiene el PDF generado por la cuenta codificado en Base64, solamente se envía cuando se indica en el llamado. _result: Resultado del envío del correo. 1 para correcto y -1 para incorrecto. _error: Mensaje del servidor de correo cuando hay un error en el envío. ok-nomina2cfdi.json "result": "RFC": "XAXX ", "user": "23", "retcode": 1, "UUID": "D4F C5B-402A-A973-7BD84588BE40", "data": "<xml/>", "stampdate": " T10:00:00-07:00", "ip_addr": " ", "refid": "44536", "acuse": "acuse_sat=false", "client_ ": "NUEVA EMPRESA DE EJEMPLO<>", "pdfbase64": " === PDF EN BASE64 === " " _result": -1, " _error": "ERROR" Si el procesamiento no es correcto, se responderá con un objeto con los siguientes datos: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: retcode: Es el código de respuesta, cualquier código diferente a 1 es incorrecto, se detalla en el Catálogo de Códigos de Respuesta. error: Consiste en una descripción del error dirigida al usuario. error-nomina2cfdi.json "result": "retcode": 101, "error": "Error 301 al timbrar: 'XML mal formado - value 'valorinvalido' not in enumeration (ERROR)'" Printed on 2018/01/26 10:43

21 2018/01/26 10:43 21/23 Web Service de ifactura Cancelar un CFDI Método: cancelarcfdi Método para cancelar un CFDI generado a través del webservice de ifactura. El llamado recibirá las siguientes validaciones: Los datos enviados están completos. El método utilizado es correcto. Los datos enviados tienen un contenido y formato correspondiente al dato que se indica. Que los datos dependientes de bases de datos en el servidor sean correctos. Que los datos validados por el SAT se encuentren en un formato correcto. Llamado Para cancelar un CFDI es necesario enviar los siguientes datos: Ejemplo de Llamado request-cancelarcfdi.json "method": "cancelarcfdi", "cancelaciones": [ "uuid": "344DEDAB-6AD3-4BC6-AD09-A30D6D925327", "serie": "A", "folio": "1756", "uuid": "B8A5D757-72DA-4B5A-AD5E-9F1E91ECF395", "serie": "A", "folio": "1757", "serie": "A", "folio": "99999", "esnomina": "SI" ], "cuenta": "demo", "user": "administrador", "password": "Administr4dor"

22 Last update: 2018/01/25 14:56 web-service-ifactura Respuesta SI el procesamiento resulta correcto se responderá a la solicitud con un objeto JSON consistente en lo siguiente: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: RFC: Es el RFC registrado en la cuenta, a nombre del cual se selló el comprobante. user: retcode: Es el código de respuesta, el 1 significa correcto. Si el procesamiento no es correcto, se responderá con un objeto con los siguientes datos: id_transacción: El número de la operación. Si se indicó en el llamado será este mismo, sino el valor por defecto es 0. result: Es un objeto que dentro contiene los detalles de la respuesta, en el caso de ser correcta contiene los siguientes datos: retcode: Es el código de respuesta, cualquier código diferente a 1 es incorrecto, se detalla en el Catálogo de Códigos de Respuesta. error: Consiste en una descripción del error dirigida al usuario. notfoundinternalfolios: Es un arreglo que contiene los CFDI no encontrados divididos por payrolls e invoices. error-cancelarcfdi.json "result": "retcode": -1, "error": "Respuesta no esperada al intentar enviar el CFDI al SAT.", "notfoundinternalfolios": "payrolls": [ "A99999" ] Catálogo de Datos Soportados El catálogo de datos soportados por el servicio se encuentra en el Catálogo de Datos Soportados. Printed on 2018/01/26 10:43

23 2018/01/26 10:43 23/23 Web Service de ifactura From: - itimbre Wiki Permanent link: Last update: 2018/01/25 14:56