Método Recuperar_Comprobante_Referencia

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: 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áctanos

Parámetros de la petición

Nombre

Descripción

Requerido

username

Usuario del web service

password

Contraseña del web service

external_ids

Similar al servicio de cancelación de comprobantes, se manda un arreglo de external_ids para recuperar.

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

Contactanos

Respuesta 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

RCR102

El campo uuids está vacío

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

Zendesk Widget