Método Recuperar_Comprobante
Enlaces al servicio
Pruebas: https://staging.ws.timbox.com.mx/timbrado_cfdi40/wsdl
Producción: https://sistema.timbox.com.mx/timbrado_cfdi40/wsdl
Consumo de créditos
Por cada Petición: No Aplica
Petición al servicio
El servicio “recuperar_comprobante” se utiliza para recuperar uno o varios comprobantes completos (xml) usando los UUIDs. El servicio sólo puede recuperar hasta 200 comprobantes por petición. Es requerido usuario y contraseña para utilizar el servicio.
Queremos solucionar tus dudas
ContáctanosParámetros de la petición
Nombre | Descripción | Requerido |
username | Usuario del web service | Sí |
password | Contraseña del web service | Sí |
uuids |
Arreglo de objetos que contiene un arreglo de UUID’s a recuperar. Los UUID’s deben cumplir con la expresión regular para poder realizar la búsqueda y se puede enviar un máximo de 200 UUID’s por petición, en caso de que no cumpla con las extensión regular se regresará un mensaje de error. |
Sí |
Regex de UUIDs:
/^[a-f0-9A-F]{8}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{12}$/
Ejemplo de la 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:recuperar_comprobante soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <username xsi:type="xsd:string">AAA010101000</username> <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password> <uuid xsi:type="urn:recuperar"> <!--Zero or more repetitions:--> <Comprobante xsi:type="urn:Comprobante"> <uuid xsi:type="xsd:string">C8C1DAB5-B652-4E67-991B-7E085C1F7849</uuid> </Comprobante> </uuid> </urn:recuperar_comprobante> </soapenv:Body> </soapenv:Envelope>
Queremos solucionar tus dudas
ContáctanosRespuesta del servicio
Si hubo un error con alguno de los parámetros o en el servicio de recuperación, se le notificará por medio de un error, de lo contrario recibirá la estructura “recuperar_comprobante_result”.
Parámetros de repuesta
Nombre | Descripción |
estatus | Estatus de la petición, es 200 si fue exitosa. |
cantidad | Cantidad de comprobantes que se recuperaron con los UUID’s especificados en la petición. |
comprobantes | Arreglo de objeto CFDI en formato xml. |
uuid | UUID del comprobante que se buscó |
xml | El xml correspondiente al UUID. Si no se encontró un xml con ese UUID se regresa el mensaje “No se encontró XML del uuid: UUID”. |
Ejemplo de repuesta 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:recuperar_comprobante_response> <recuperar_comprobante_result xsi:type="tns:recuperar_comprobante_result"> <estatus xsi:type="xsd:string">200</estatus> <cantidad xsi:type="xsd:string">1</cantidad> <comprobantes xsi:type="xsd:string"><?xml version="1.0" encoding="UTF-8"?> <Comprobantes type="array"> <CFDI> <uuid>C8C1DAB5-B652-4E67-991B-7E085C1F7849</uuid> <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" 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> </CFDI> </Comprobantes>]]></comprobantes> </recuperar_comprobante_result> </tns:recuperar_comprobante_response> </soap:Body> </soap:Envelope>
Códigos de error nivel petición
Código | Descripción |
RCS101 | Los datos de autentificación enviados son incorrectos |
RCS102 | El campo UUID’s está vacío |
RCS103 | No se pueden recuperar mas de 200 comprobantes por UUID |
RCS104 | El UUID no tiene una estructura válida |
RCS999 | Error de comunicación con el servicio de recuperación de comprobantes |