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

Parámetros de la petición

Nombre Descripción Requerido
username Usuario del web service
password Contraseña del web service
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.

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

Respuesta 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

 

 

Zendesk Widget