Método Timbrar ZIP
Enlaces al servicio
Pruebas: https://staging.ws.timbox.com.mx/timbrado_cfdi33/wsdl
Producción: https://sistema.timbox.com.mx/timbrado_cfdi33/wsdl
Consumo de créditos
Por cada petición de timbrado exitoso: 1 crédito
Petición al servicio
El servicio de “timbrar_zip” se utiliza para realizar el timbrado de un comprobante, si dicho comprobante es válido se timbrará con éxito. Es requerido el usuario y contraseña para utilizar el servicio.
Parámetros de la petición
Nombre | Descripción | Requerido |
username | Usuario del web service | Sí |
password | Contraseña del web service | Sí |
zipbase64 | El zip del comprobante convertido a una cadena en base64 | Sí |
Queremos solucionar tus dudas
ContáctanosEjemplo de petición al servicio
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:WashOut"> <soapenv:Header/> <soapenv:Body> <urn:timbrar_zip soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <username xsi:type="xsd:string">AAA010101000</username> <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password> <zipbase64 xsi:type="xsd:string">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</zipbase64> </urn:timbrar_zip> </soapenv:Body> </soapenv:Envelope>
Respuesta del servicio
Si hubo un error con alguno de los parámetros o en el servicio de timbrar_zip, se notificará por medio de un mensaje de error, de lo contrario recibirá la estructura “timbrar_zip_result”.
Parámetros de respuesta
Nombre | Descripción |
xml | Campo que contiene el comprobante con el nodo TFD (Timbre Fiscal Digital). |
Ejemplo de respuesta del servicio
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:tns="urn:WashOut"> <soap:Body> <tns:timbrar_zip_response> <timbrar_zip_result xsi:type="tns:timbrar_zip_result"> <xml xsi:type="xsd:string"><?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" Certificado="MIIFljCCA36gAwIBAgIUMzAwMDEwMDAwMDA0MDAwMDIzMzIwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWRpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMTkwNTI5MTg0NDU3WhcNMjMwNTI5MTg0NDU3WjCBvTEgMB4GA1UEAxMXQ0VDSUxJQSBNSVJBTkRBIFNBTkNIRVoxIDAeBgNVBCkTF0NFQ0lMSUEgTUlSQU5EQSBTQU5DSEVaMSAwHgYDVQQKExdDRUNJTElBIE1JUkFOREEgU0FOQ0hFWjEWMBQGA1UELRMNTUlTQzQ5MTIxNEI4NjEbMBkGA1UEBRMSTUlTQzQ5MTIxNE1DQ1JOQzAxMSAwHgYDVQQLExdDRUNJTElBIE1JUkFOREEgU0FOQ0hFWjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJzAzSn5OeWoVfKCzpTudveHSAxa/cUNaooOUjrPJhWRsKKtYArZ67CDYZSbqbjIBwb3Dv6Agr1NHHbYT+h657rJOC3Zhmm4d4a05UoizZTDAtY5c3XAKpdKuJ2oggZuSR9H7mSQ1P3WfT5v3TRg6xgEQwmMdb7v3C0AK1PTOKtjhjmne9NqhzrEHe3nfiWqX6Jn8Xt+lrPAz9k40BOWJiPy9gMthAHPXgXYUMsmfFVYubcNXVIX+iElehL6j5Ain4/S+FBqqp0RvuEF6VfZiI5SuXlH69Rw7BwUcFjgv9hOmRc+vYeaasoqLmfF5Suk+6oEThvh2AO24yiq+1m3scUCAwEAAaMdMBswDAYDVR0TAQH/BAIwADALBgNVHQ8EBAMCBsAwDQYJKoZIhvcNAQELBQADggIBAJU0OG2EeLQWVVijpaOBFTyG3+KYCy+hJYyo6/hcUUCRFBAiNTb89tylUkRKpJ9p8digYLkeemmhOkP5UNnwpiy0nfgKDlNHX3BWWBC2X6vcHXF9fOMf1CxYaDMhpqzHI+rNe+7E9GX+Y55Butk1RXGNbrprDkF4HKpc8rj1CtlyvmUjJJ9iWCOyap8/k5NWn1LZA9WdB6JoA5DIX2M4GCkh67bHeNteog8W8DEtYAekkI7Ufe74EI5e3NB3xLO2EZrmula5WEOpEGuvLdi9pqiYzSSabFB/xf1papyZYvKkWWiw6OOEo5V2Z2EXd/sDAMWQhyJygHjUh2ajXQFfKI577omUQf346dlhJXi7PMk2N/26lvtJT5hYLyrbk5K9XiYBfJKkIedn9eoCZIxMH59J8ka2Q23rLnil1rw4l8kVZ9wAhGazeK4Nfzm38B81j6q38Gi7x5GaparrOr+bA5Brr2/e5mH8YGQXUPRNK4ag/N+KggnOH/fHZBH0mKSJZoLhsizGXahcazzuEjqENXF/C+0QG8vuimEtyyCFzx4JzzB5G1i+ZEhGMH7nkRSUf/8Rq8fN2u0SNYE5JEB4ipFaer2JGlRrzSMP5iNkCH2wxWphrMHRWqVqx97PpM45nE0JcukvObw72TaKFhohQ2U6yMb/fqqP5p7C1Z5af38H" Fecha="2019-07-25T08:57:15" FormaPago="01" LugarExpedicion="06300" MetodoPago="PUE" Moneda="MXN" NoCertificado="30001000000400002332" Sello="Wo6bLjPSIstphKqBRl2eYhE8KcmtZowNTNGhRWs0GHgyTEv/4AqjL5vQSu2qKoeUzhok2KreN/Iyq2JyT2vxFXNDKnV6a8YkJj8JGDg9azODbUaToWsOVNfrztvSTEHBAvaTBaIyAAxEBcSMXt243HmXmPauZ0TxZ2P/QslHqwucbJGqIYlHeeb+UOLDipbuHfwLQH1f6rJSmcFXtJreqO/9gZo8mEYXYYTCeFKYVcJOsncGY3DQuyc8cFvK3ckVhiOhdvwYaWLcAM9hqdL1I3gto+5eAcDA/stztG+QDiMU/WRbz3kLCPYpt+gN5PaW8JvKc2LWSlZi266jtxMBvw==" SubTotal="1510.00" TipoCambio="1" TipoDeComprobante="I" Total="1751.60" Version="3.3" xsi:schemaLocation="http://www.sat.gob.mx/cfd/3 http://www.sat.gob.mx/sitio_internet/cfd/3/cfdv33.xsd"> <cfdi:Emisor Nombre="CECILIA MIRANDA SANCHEZ" RegimenFiscal="605" Rfc="MISC491214B86"/> <cfdi:Receptor Nombre="IT SW Development Solutions de Mexico S de RL de CV" Rfc="IAD121214B34" UsoCFDI="P01"/> <cfdi:Conceptos> <cfdi:Concepto Cantidad="5" ClaveProdServ="10122100" ClaveUnidad="M74" Descripcion="prueba Catalogos Nuevos" Importe="1250.00" Unidad="Kilo" ValorUnitario="250.00"> <cfdi:Impuestos> <cfdi:Traslados> <cfdi:Traslado Base="1250.00" Importe="200.00" Impuesto="002" TasaOCuota="0.160000" TipoFactor="Tasa"/> </cfdi:Traslados> </cfdi:Impuestos> </cfdi:Concepto> <cfdi:Concepto Cantidad="1" ClaveProdServ="24111500" ClaveUnidad="KGM" Descripcion="traslucida 90x90 cm. cal. 200" Importe="22.00" Unidad="kg" ValorUnitario="22.00"> <cfdi:Impuestos> <cfdi:Traslados> <cfdi:Traslado Base="22.00" Importe="3.52" Impuesto="002" TasaOCuota="0.160000" TipoFactor="Tasa"/> </cfdi:Traslados> </cfdi:Impuestos> </cfdi:Concepto> <cfdi:Concepto Cantidad="10" ClaveProdServ="13101712" ClaveUnidad="KGM" Descripcion="POLIETILENO DE BAJA DENSIDAD" Importe="238.00" Unidad="KG" ValorUnitario="23.80"> <cfdi:Impuestos> <cfdi:Traslados> <cfdi:Traslado Base="238.00" Importe="38.08" Impuesto="002" TasaOCuota="0.160000" TipoFactor="Tasa"/> </cfdi:Traslados> </cfdi:Impuestos> </cfdi:Concepto> </cfdi:Conceptos> <cfdi:Impuestos TotalImpuestosTrasladados="241.60"> <cfdi:Traslados> <cfdi:Traslado Importe="241.60" Impuesto="002" TasaOCuota="0.160000" TipoFactor="Tasa"/> </cfdi:Traslados> </cfdi:Impuestos> <cfdi:Complemento> <tfd:TimbreFiscalDigital xmlns:tfd="http://www.sat.gob.mx/TimbreFiscalDigital" xsi:schemaLocation="http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd" Version="1.1" UUID="C8C1DAB5-B652-4E67-991B-7E085C1F7849" FechaTimbrado="2019-07-25T10:57:17" RfcProvCertif="IAD121214B34" SelloCFD="Wo6bLjPSIstphKqBRl2eYhE8KcmtZowNTNGhRWs0GHgyTEv/4AqjL5vQSu2qKoeUzhok2KreN/Iyq2JyT2vxFXNDKnV6a8YkJj8JGDg9azODbUaToWsOVNfrztvSTEHBAvaTBaIyAAxEBcSMXt243HmXmPauZ0TxZ2P/QslHqwucbJGqIYlHeeb+UOLDipbuHfwLQH1f6rJSmcFXtJreqO/9gZo8mEYXYYTCeFKYVcJOsncGY3DQuyc8cFvK3ckVhiOhdvwYaWLcAM9hqdL1I3gto+5eAcDA/stztG+QDiMU/WRbz3kLCPYpt+gN5PaW8JvKc2LWSlZi266jtxMBvw==" NoCertificadoSAT="20001000000300022323" SelloSAT="HBaxVIwKOeANrKSo9/hV994clbx23eQuNFcn0vpCZC+B98UzAUdiY5xleVS7IQpZjMJBiwPdr+g7NS0/A6r+h1eC83Nh2yawC1NckKKkongGTvVzPpj8frpB52kpw8kVGdzCH6L1Dot5V3sCVPex3wjSIlZdD3qyddpvFaL2SXRpH53LPZaVQ3BFnUaS9gC+dgImpQ0fpRKJeWbTrrIJR93eCeVUhHRPHI1aLuExnsFo3Kanv9AHX25fdIZSM27Tm1Pu51STrKulA/VuwGR9tTY9qmg+JqhDKKhQA79wlsQ79Hqzr8INHYhnURErpiFf97ob1DaHfegT3+0zm1gYkw=="/> </cfdi:Complemento> </cfdi:Comprobante>]]></xml> </timbrar_zip_result> </tns:timbrar_zip_response> </soap:Body> </soap:Envelope>
Queremos solucionar tus dudas
ContáctanosCódigos de error nivel petición
Código | Descripción |
101 | Los datos de autentificación enviados son incorrectos |
102 | Su plan ha caducado, favor de contratar uno nuevo plan |
103 | Se han agotado la cantidad de timbres, favor de contratar un nuevo plan |
* 104 | El valor del parámetro ‘external_id’ no es un valor válido (Error exclusivo del método timbrar_cfdi_referencia) |
200 | Resultado Exitoso |
* 111 | Por el momento solo se acepta 1 comprobante en el zip (Error exclusivo del método timbrar_zip) |
* 112 | Archivo zip corrupto, no se pudieron recuperar los comprobantes (Error exclusivo del método timbrar_zip) |
301 | El XML recibido no contiene una estructura válida |
302 | El parámetro ‘sxml’ no contiene información |
303 | El XML recibido contiene un carárter UNICODE inválido |
304 | El parámetro ‘sxml’ debe contener un valor válido |
305 | La codificación del XML no esta en UTF-8 |
307 | El CFDI ya contiene un timbre previo, revisar el nodo complemento |
308 | El XML recibido no contiene la declaración del namespace ‘xmlns:xsi’ del CFDI conforme al Anexo 20 |
309 | El XML recibido no contiene la declaración del namespace ‘xmlns:cfdi’ o de alguno de los complementos del CFDI conforme al Anexo 20 |
310 | El XML recibido no contiene la declaración del ‘xsi:schemaLocation’ del CFDI conforme al Anexo 20 |
999 | Error de comunicación con el servicio de timbrado. |
Queremos solucionar tus dudas
ContáctanosMatrices de error del SAT
Los códigos de error de las matrices de validación del CFDI y de cada complemento del SAT los puedes encontrar a continuación.
Código | Descripción |
CFDI33101 – CFDI33196 | Matriz de validaciones para el Comprobante Fiscal Digital por Internet versión 3.3
Descargar Matriz de Errores de: |
CCE145 – CCE218 | Matriz de validaciones para complemento Comercio Exterior 1.1
Descargar Matriz de Errores de: |
ECC121 – ECC125 | Matriz de validaciones para complemento Estado de Cuenta de Combustibles de Monederos Electrónicos 1.2.
Descargar Matriz de Errores de: |
GCEH101 – GCEH133 | Matriz de validaciones para el complemento de Gastos del Consorcio derivados de la Ejecución de un Contrato de Exploración o Extracción de Hidrocarburos 1.0.
Descargar Matriz de Errores de: |
IEEH101 – IEEH105 | Matriz de validaciones para complemento de Ingresos atribuibles a los Integrantes de un Consorcio derivados de la Contraprestación de un Contrato de Exploración o Extracción de Hidrocarburos 1.0
Descargar Matriz de Errores de: |
INE180 – INE188 | Matriz de validaciones para el CFDI versión 3.3 con complemento INE 1.1
Descargar Matriz de Errores de: |
NOM132 – NOM225 | Matriz de validaciones para complemento Nómina 1.2
Descargar Matriz de Errores de: |
CRP101 – CRP239 | Matriz de validaciones del Complemento para Recepción de Pagos
Descargar Matriz de Errores de: |