Llama Gratis 01800 788 0195

Buscar Acuse Recepción

Proceso para Buscar Acuses de Recepción

Para realizar una búsqueda de algún(os) acuse(s) debe tener en cuenta que solo obtendrá los acuses que tengamos registrados en nuestras bases de datos, en caso de que se requiera el acuse de algún UUID que haya sido emitido por otro PAC no se podrá obtener el acuse usando nuestro servicio.

A continuación listamos las consideraciones para el uso del servicio:

  • Deberá considerar solo una de las opciones de búsqueda para obtener resultados concretos. Por lo que si se mezclan los filtros de UUID con las fechas regresará un error. Es recomendable realizar una búsqueda por un listado de UUID’s y no incluir el rango de fechas o en caso contrario solo realizar la búsqueda por rango de fechas y no incluir los UUID’s.
  • El servicio regresa como máximo hasta 500 acuses, así mismo el servicio permite realizar la búsqueda agregando hasta 500 uuids. Si omite los filtros de UUID y fechas por defecto el servicio regresa los últimos 500 acuses.
  • Los UUID’s que desea consultar deben cumplir con la expresión regular (se especifica más adelante en esta sección) que verifica el UUID sea correcto, en caso contrario recibirá un error con el UUID que no cumplió con esta regla.
  • Si un UUID que desea no se encuentra en nuestras bases de datos obtendrá un error que especifica que su UUID no fue encontrado.
  • Los parámetros fecha_timbrado_inicio y fecha_timbrado_fin deben cumplir con el formato “YYYY-MM-DD” o si desea agregar horario “YYYY-MM-DDTHH:MM:SS”. Si usa el formato de fecha sin horario el servicio tomará en cuenta por defecto desde la hora 00:00:00 de fecha_timbrado_inicio hasta las 23:59:59 de fecha_timbrado_fin. Por último estos parámetros deben coexistir.

 

Método Buscar_Acuse_Recepción

 

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

 

El servicio de “buscar_acuse_recepcion” se utiliza para obtener el acuse de recepción uno o varios comprobantes que ya fueron enviados al servicio de recepción del SAT. Se requiere de usuario y contraseña para utilizar el servicio.

 

Parámetros de la petición

 

Nombre Descripción Observaciones Requerido
username Usuario del webservice
password Contraseña del webservice
parametros_acuse
Es un parámetro definido para contener los diferentes filtros que desea usar. Si omite este parámetro el servicio regresará un error de estructura.
uuids Se manda un arreglo de uno o más UUIDs que se desean cancelar. Los UUIDs deben cumplir con la expresión regular de UUIDs. El valor del UUID debe ser válido, si no ingresa valor en la etiqueta se validará contra la expresión regular de UUID. Si ingresa un valor en UUID no debe registrar los parámetros de fechas. No
fecha_timbrado_inicio Fecha de timbrado inicial que desea consultar. La fecha debe cumplir con el formato YYYY-MM-DD o YYYY-MM-DDTHH:MM:SS Si ingresa valor en este parámetro debe agregar fecha_timbrado_fin y no registrar UUID. No
fecha_timbrado_fin Fecha de timbrado final que desea consultar. La fecha debe cumplir con el formato YYYY-MM-DD o YYYY-MM-DDTHH:MM:SS Si ingresa valor en este parámetro debe agregar fecha_timbrado_inicio y no registrar UUID. No

 

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 petición

 

A continuación mostramos un ejemplo de cómo debe ser construida 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:buscar_acuse_recepcion soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <username xsi:type="xsd:string">AAA010101000</username>
         <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password>
         <parametros_acuse xsi:type="urn:parametros_acuse">
            <uuids xsi:type="urn:uuid">
               <!--Zero or more repetitions:-->
               <uuid>EB6FB4BF-1264-4FBB-92BD-CEA01DE4820C</uuid>
            </uuids>
            <fecha_timbrado_inicio xsi:type="xsd:string">?</fecha_timbrado_inicio>
            <fecha_timbrado_fin xsi:type="xsd:string">?</fecha_timbrado_fin>
         </parametros_acuse>
      </urn:buscar_acuse_recepcion>
   </soapenv:Body>
</soapenv:Envelope>

Respuesta del servicio

 

Si hubo un error con alguno de los parámetros o en el servicio de buscar acuses, se le notificará por medio de un mensaje de error, de lo contrario recibirá la estructura “buscar_acuse_recepcion_result” compuesta de lo siguiente:

 

Parámetros de respuesta

 

Nombre Descripción
acuses
El acuse de recepción que regresa el SAT.
uuids_erroneos Información de los uuid’s que no son válidos o no cumplen con la expresión regular.
uuids_no_encontrados Información de los uuid’s que no fueron encontrados en BD.

 

Ejemplo de respuesta del servicio

 

A continuación mostramos la respuesta que regresa el servicio una vez realizada la petición.

<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:buscar_acuse_recepcion_response>
      <buscar_acuse_recepcion_result xsi:type="tns:buscar_acuse_recepcion_result">
        <acuses xsi:type="xsd:string"><acuse><?xml version="1.0" encoding="UTF-8"?>
        <AcuseRecepcion xmlns="http://recibecfdi.sat.gob.mx">
          <AcuseRecepcionCFDI UUID="EB6FB4BF-1264-4FBB-92BD-CEA01DE4820C" CodEstatus="Comprobante recibido satisfactoriamente" Fecha="2017-09-09T16:40:19.7601439" NoCertificadoSAT="20001000000300022323">
          <Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="SelloSAT">
          <SignedInfo>
          <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
          <SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#hmac-sha512"/>
          <Reference URI="">
          <Transforms>
          <Transform Algorithm="http://www.w3.org/TR/1999/REC-xpath-19991116">
          <XPath>not(ancestor-or-self::*[local-name()='Signature'])</XPath>
          </Transform>
          </Transforms>
          <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha512"/>
          <DigestValue>L57TILsxMeYL2arpFWDic/QT62qVNSBb7NpHXHg+Z89zVLAqUw6NqpW8Ig7Ik6o3mwva/xRwxbkH0rnfHLG5pg==</DigestValue>
          </Reference>
          </SignedInfo>
          <SignatureValue>F0m9K2bFfjKqhmZI5XxFcfkNTwdrG+xmGJFzAOWMVoCKtuq4i5rrjH0Frfcm8v5oVAhL7Mi4YW8gdY1NT8PEyQ==</SignatureValue>
          <KeyInfo>
          <KeyName>00001088888810000001</KeyName>
          <KeyValue>
          <RSAKeyValue>
          <Modulus>vAr6QLmcvW6auTg7a+Ogm0veNvqJ30rD3j0iSAHxGzGVrg1d0xl0Fj5l+JX9EivD+qhkSY7pfLnJoObLpQ3GGZZOOihJVS2tbJDmnn9TW8fKUOVg+jGhcnpCHaUPq/Poj8I2OVb3g7hiaREORm6tLtzOIjkOv9INXxIpRMx54cw46D5F1+0M7ECEVO8Jg+3yoI6OvDNBH+jABsj7SutmSnL1Tov/omIlSWausdbXqykcl10BLu2XiQAc6KLnl0+Ntzxoxk+dPUSdRyR7f3Vls6yUlK/+C/4FacbR+fszT0XIaJNWkHaTOoqz76Ax9XgTv9UuT67j7rdTVzTvAN363w==</Modulus>
          <Exponent>AQAB</Exponent>
          </RSAKeyValue>
          </KeyValue>
          </KeyInfo>
          </Signature>
          </AcuseRecepcionCFDI>
          </AcuseRecepcion>
        </acuse>]]></acuses>
        <uuids_erroneos xsi:type="tns:uuid"></uuids_erroneos>
        <uuids_no_encontrados xsi:type="tns:uuid"></uuids_no_encontrados>
      </buscar_acuse_recepcion_result>
    </tns:buscar_acuse_recepcion_response>
  </soap:Body>
</soap:Envelope>

 

Códigos de error nivel petición

Se en listan los diferentes códigos de error que el servicio puede regresar.

 

Código Descripción
ACR001 Los datos de autentificación enviados son incorrectos.
ACR1000 No se pueden recuperar más de 500 acuses en una sola petición.
ACR1001 No se debe omitir el campo fecha_timbrado_inicio si el campo fecha_timbrado_fin existe.
ACR1002 No se debe omitir el campo fecha_timbrado_fin si el campo fecha_timbrado_inicio existe.
ACR1003 El campo fecha_timbrado_inicio no cumple con el formato YYYY-MM-DD y/o YYYY-MM-DDTHH:MM:SS.
ACR1004 El campo fecha_timbrado_fin no cumple con el formato YYYY-MM-DD y/o YYYY-MM-DDTHH:MM:SS.
ACR1005 Favor de realizar la búsqueda por UUID o por fecha de timbrado.
ACR999 Error de comunicación con el servicio de búsqueda de acuses.