Método Recuperar_Comprobante_Referencia
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
Al igual que el servicio de “recuperar_comprobante”, el servicio de “recuperar_comprobante_referencia” puede ser utilizado para recuperar uno o varios comprobantes completos (XML) usando los ID’s de su aplicación, es importante mencionar que este parámetro external_id solo permite hasta 30 carácteres. El servicio sólo puede recuperar hasta 200 comprobantes por petición. Es requerido el 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í |
external_ids |
Se manda un arreglo de external_ids que a su vez es un arreglo de referencias para recuperar. |
Sí |
Ejemplo 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:recuperar_comprobante_referencia soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <username xsi:type="xsd:string">AAA010101000</username> <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password> <external_ids xsi:type="urn:external_id"> <!--Zero or more repetitions:--> <external_id xsi:type="xsd:string">252510</external_id> </external_ids> </urn:recuperar_comprobante_referencia> </soapenv:Body> </soapenv:Envelope>
Queremos solucionar tus dudas
ContactanosRespuesta del servicio
Si hubo un error con alguno de los parámetros o en el servicio de recuperar comprobante external_id, notificará por medio de un mensaje de error, de lo contrario recibirá la estructura “recuperar_comprobante_referencia_response”.
Parámetros de respuesta
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. |
external_id | external_id del comprobante que se buscó. |
xml | El xml correspondiente al UUID. En caso de que no se encuentre un comprobante con ese UUID se regresará el siguiente mensaje “No se encontró XML del uuid: UUID”. |
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:recuperar_comprobante_referencia_response> <recuperar_comprobante_referencia xsi:type="tns:recuperar_comprobante_referencia"> <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> <external-id>252510</external-id> <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-26T09:56:05" FormaPago="01" LugarExpedicion="06300" MetodoPago="PUE" Moneda="MXN" NoCertificado="30001000000400002332" Sello="E71BIKNDU9LREdlWwHY5Eho9pu5tBHWuPH54iDGEC5viJwh9b19uT7KpdG8A9BZ6dN8jjOo03y0GRVfMwgF+3cbyTpEbQDO7zN6sg/vj0iG6e4wI9X/zEZjbMrU0kRPpYrCD+yhHDv3jJ00R/DIpA26jwZ14ZCNZETUdtiy54AZbGRpUq/V69Ylwkl87xr+R/NGokL4C6Mzi2LqXuozUH8Dol+TArIkxh4Wgt9PM6/eUHWh0rIIoPsoTpcZtnQvcY/il5RsaGMA8Qc1UDKw8Mhl3woZ6qj6mnU/ETDcAHTEs9vktMCb4+vTPzgdVSt1Y3wJOZB4mM/bOvHSWPBKDrA==" 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="A4DE98DA-8443-4621-B522-D091A403F6AB" FechaTimbrado="2019-07-26T11:56:07" RfcProvCertif="IAD121214B34" SelloCFD="E71BIKNDU9LREdlWwHY5Eho9pu5tBHWuPH54iDGEC5viJwh9b19uT7KpdG8A9BZ6dN8jjOo03y0GRVfMwgF+3cbyTpEbQDO7zN6sg/vj0iG6e4wI9X/zEZjbMrU0kRPpYrCD+yhHDv3jJ00R/DIpA26jwZ14ZCNZETUdtiy54AZbGRpUq/V69Ylwkl87xr+R/NGokL4C6Mzi2LqXuozUH8Dol+TArIkxh4Wgt9PM6/eUHWh0rIIoPsoTpcZtnQvcY/il5RsaGMA8Qc1UDKw8Mhl3woZ6qj6mnU/ETDcAHTEs9vktMCb4+vTPzgdVSt1Y3wJOZB4mM/bOvHSWPBKDrA==" NoCertificadoSAT="20001000000300022323" SelloSAT="ceGBfUFcTF9y8na50oVwMO7YvxkleE94FUTTlu5EpPyOzK+lhMwhopb0yl1PKliph9aNI+5ONtrUz76b2hv9BuoDjTDutWVYvLOiyfF0A46mpEqduXcP5hdSgZSgmXtvzkZ5lYC3tBVgu3Cyh+oDbTGZQwiqarGRnzUqjcfaarKwGXphcAcuh6YJizVwo73MscrrHYsh6Ekx1bQEAQqK8B700xRghTqH4r4iVqgcJnxQlYAaPqpASbPd5ldNUeIM4e1oqplo78yJHrmYSqCmjhftGDE+vQ5t7N46cimYqgOWYPNMGaAmSDQgofopWrgtWvFomdpb1a1kLWG5MD8eLw=="/> </cfdi:Complemento> </cfdi:Comprobante> </xml> </CFDI> </Comprobantes>]]></comprobantes> </recuperar_comprobante_referencia> </tns:recuperar_comprobante_referencia_response> </soap:Body> </soap:Envelope>
Códigos de error nivel petición
Código |
Descripción |
RCR101 |
Los datos de autentificación enviados son incorrectos |
404 | Parametro external_id vacio |
RCR103 |
No se pueden recuperar más de 200 comprobantes por ID |
RCR104 |
El valor de external_id no es un valor válido |
RCR999 |
Error de comunicación con el servicio de recuperación de comprobantes con External_id |