Llama Gratis 01800 788 0195

Recuperar Comprobante con Referencia

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

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. Es requerido el usuario y contraseña para utilizar el servicio.

 

Parámetros de la petición

 

Nombre Descripción Requerido
username Usuario del webservice
password Contraseña del webservice
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">525968</external_id>
         </external_ids>
      </urn:recuperar_comprobante_referencia>
   </soapenv:Body>
</soapenv:Envelope>

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:timbrar_cfdi_referencia_response>
         <timbrar_cfdi_referencia_result xsi:type="tns:timbrar_cfdi_referencia_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="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" Fecha="2018-10-24T10:03:26" FormaPago="01" LugarExpedicion="06300" MetodoPago="PUE" Moneda="MXN" NoCertificado="30001000000300023708" Sello="LtNB3KuDlnKluccVlIffQo7LvxZC2OiPPO3QdTHe95LoR8V1jGklAdZCSsOz7GeZ6LCNUZqbGrfH663aVKyN/ArUFMAoSpIoro1lmMHcXjnCDmOC6HDaQpZ6FJRkfLfXJdhIyA/aMAKQWMzMxEeZN7bKanf9fqD7xcQ0vCBlxuFQGQt7M9VaTBUfBKSSxggBc+ToqOB294pd0fQj5rexQTHFy9ulLV47H9i8xZ3uLKwvkatnD6un+OaSpA3G2b09H2p+Akwjxa1MIJfJIUIeW7SYPYBcrTvKVWU8ZBlczCqzgPmLVKq3qofbiJpMUW97+rOqyyCgzk7CV4h0PZjYPw==" 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="SENTIENT SA DE CV" RegimenFiscal="601" Rfc="AAA010101AAA"/>
  <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="0D597F01-0E2C-4F35-BC76-3D4D47970242" FechaTimbrado="2018-10-24T12:58:26" RfcProvCertif="IAD121214B34" SelloCFD="LtNB3KuDlnKluccVlIffQo7LvxZC2OiPPO3QdTHe95LoR8V1jGklAdZCSsOz7GeZ6LCNUZqbGrfH663aVKyN/ArUFMAoSpIoro1lmMHcXjnCDmOC6HDaQpZ6FJRkfLfXJdhIyA/aMAKQWMzMxEeZN7bKanf9fqD7xcQ0vCBlxuFQGQt7M9VaTBUfBKSSxggBc+ToqOB294pd0fQj5rexQTHFy9ulLV47H9i8xZ3uLKwvkatnD6un+OaSpA3G2b09H2p+Akwjxa1MIJfJIUIeW7SYPYBcrTvKVWU8ZBlczCqzgPmLVKq3qofbiJpMUW97+rOqyyCgzk7CV4h0PZjYPw==" NoCertificadoSAT="20001000000300022323" SelloSAT="DttmGssLOxZnqBCgCS7xY0V0yZ2KYCOCgCKLKvGp/FeNelYxCJTEF+LNA+ZDeVq1kjeCVVAJf5erCPpO4QmkIUHHsTVxMzjRm3+bq3rohtRTA2snzyPa36bgfDg2xLzjuxulC1AjkxTVf4wE6OqI45SthYetnFrtr3PKU74Z/3R1JtrlDAlI0hLgbG/B08BxkcCJoB0g5HzQb63s0KQS0rxZU7jUV+zWyty/daS8adGaH8Nsp4tZqz55Pm1c+9DF2MnKYnWUXihqfyQpIDx7T6oPI5oj56E+cCojaL6JZl+gCM03dQBtDftCtATfgk77xLoys3Ez5swfKnrsC9uTdA=="/>
  </cfdi:Complemento>
</cfdi:Comprobante>]]></xml>
         </timbrar_cfdi_referencia_result>
      </tns:timbrar_cfdi_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