Consultas relacionadas a cancelaciones de CFDI

Este servicio permite consultar ante el SAT información de CFDI.

Contenido

Características generales

En el esquema de consulta de información de Comprobantes Fiscales Digitales por Internet (CFDI), el SAT responde a la consulta con información resguarda en su base de datos centralizada para el padrón completo de contribuyentes. Por lo tanto, debido a este modelo centralizado, la consulta de información de un CFDI consiste en solicitar directamente al SAT la información del Comprobante. Salvo la consulta de estado de un CFDI, los métodos de consulta están enfocados hacia los Receptores de un CFDI y es necesario firmar la solicitud web hacia el SAT por medio del Certificado de Sello Digital (CSD) que pertenece al Receptor. Las consultas se hacen en línea por medio de peticiones a servicios web y los tiempos de respuesta dependen de los sistemas del SAT.

El servicio para Consulta estado del CFDI en el SAT responde con la siguiente información:

  • Un código de estatus en el SAT, el cual indica si se pudo obtener información acerca del Comprobante solicitado.
  • Un indicador que permite saber si el Comprobante es cancelable, y si lo es: si requiere de aceptación por parte del Receptor del Comprobante o si se puede cancelar sin aceptación.
  • Un indicador de Estado del Comprobante (Vigente o Cancelado) al momento de hacer la solicitud de estado.
  • Un estado de la Cancelación, que indica si el Comprobante tiene alguna solicitud de cancelación pendiente de respuesta por parte del Receptor.
  • El servicio para Consulta de folios fiscales pendientes de respuesta de cancelación está enfocado hacia el Receptor de un Comprobante y se enfoca en mostrar la lista de Folios Fiscales (UUID) que un Emisor ha solicitado cancelar y que requieren de una respuesta por parte del Receptor para aceptar o rechazar la cancelación.

    El servicio para Consulta de CFDI Relacionados está enfocado hacia el Receptor de un Comprobante, para que pueda conocer las relaciones que tiene un Folio Fiscal con otros Comprobantes registrados en el SAT.

    Requisitos para consulta de información de un CFDI

    Para hacer uso del web service de Consultas relacionadas a cancelaciones de CFDI se necesita:

    • Contar con un contrato de servicios con Reachcore. En caso de no tener uno, por favor envía un correo a sales-mexico@sovos.com
    • Haber generado un API Key en tu cuenta Reachcore, ya que es el un identificador que te autentica en los Web Services de la plataforma. Para consultar como generar el API Key, consulta este artículo: Generar API Key para Web Services.

    Para las consultas que requieren del Certificado de Sello Digital (CSD) para la firma de petición de consulta en el SAT, se debe contar con un CSD vigente y cargado en la plataforma de Reachcore.

    El CSD generalmente consta de tres partes:

    • El Certificado, que es un archivo con extensión .cer
    • La llave privada, que es un archivo con extensión .key
    • y la contraseña de la llave privada.

    Para obtener un certificado de sello digital (CSD) del SAT, consultar los requisitos y el procedimiento en el portal del SAT: CÓMO TRAMITAR UN CERTIFICADO DE SELLO DIGITAL (CSD).

    Ubicación del servicio.

    Las URLs donde se encuentra la definición del Web Service (WSDL) para cada uno de los ambientes son:

    Ambiente Ubicación del WSDL del servicio
    Pruebas https://oat.reachcore.com/api/ws/6.0/pacservices/Consulta.svc/basic?wsdl
    Producción https://go.reachcore.com/api/ws/6.0/pacServices/Consulta.svc/basic?wsdl


    Método [ConsultaEstadoCFDI]

    En este método se podrá realizar la solicitud de Consulta de Estado de un CFDI. Este método no requiere de la firma de una petición con el CSD del Receptor, pero solicita información del Comprobante.

    Solicitud Consulta Estado

    Elemento Uso Descripción
    ApiKey Requerido Identificador de autenticación, que se genera en el portal de Reachcore.
    RfcEmisor Requerido Indica el RFC Emisor a consultar.
    RfcReceptor Requerido Indica el RFC Receptor a consultar.
    Total Requerido Indica el Total del Comprobante a consultar.
    Uuid Requerido Indica el UUID o Folio Fiscal del Comprobante a consultar.


    El servicio sólo proporciona información de Estado de un CFDI: no regresa información de Estado de CFDI de Retenciones e información de pagos.

    Estructura de solicitud:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
       <soapenv:Header>
          <cus:ApiKey>000...999</cus:ApiKey>
       </soapenv:Header>
       <soapenv:Body>
          <urn:ConsultaEstadoCFDIRequest>
             <urn:RfcEmisor>CALJ581101M37</urn:RfcEmisor>
             <urn:RfcReceptor>XAXX010101000</urn:RfcReceptor>
             <urn:Total>10000.00</urn:Total>
             <urn:Uuid>e99aff16-b7ef-4ea5-9c57-61c8d479b63f</urn:Uuid>
          </urn:ConsultaEstadoCFDIRequest>
       </soapenv:Body>
    </soapenv:Envelope>

    Respuesta Consulta Estado

    Elemento Descripción
    TransactionId Identificador de transacción dentro de reachcore. Si existen errores, se debe proporcionar este dato al equipo de Soporte Reachcore.
    Error Este nodo se regresa sólo cuando hay errores en la petición. La información que contiene este nodo es:
  • Code: código de error.
  • Message: Descripción del código de error.
  • Result La respuesta a la consulta de estado de un CfDI en el SAT.


    Ejemplo de respuesta:

    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaEstadoCFDIResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <TransactionId>0da4d3ca-81b6-452f-aef1-017fa2cfeb2e</TransactionId>
             <ConsultaResult>
                <a:CodigoEstatus>S - Comprobante obtenido satisfactoriamente.</a:CodigoEstatus>
                <a:EsCancelable>Cancelable con aceptación</a:EsCancelable>
                <a:Estado>Vigente</a:Estado>
                <a:EstatusCancelacion>En proceso</a:EstatusCancelacion>
             </ConsultaResult>
          </ConsultaEstadoCFDIResponse>
       </s:Body>
    </s:Envelope>

    Códigos de Respuesta del SAT para el Servicio de Consulta Estado de un CFDI

    Lista de mensajes posibles en elemento CodigoEstatus

    Mensaje Descripción
    S - Comprobante obtenido satisfactoriamente  
    N 601: La representación impresa proporcionada no es valida Este código de respuesta se presentará cuando en la petición de validación no se haya respetado el formato definido.
    N 602: Comprobante no encontrado  

    Lista de mensajes posibles en elemento EsCancelable

    Mensaje Descripción
    Cancelable sin aceptación El Comprobante puede ser cancelado sin necesidad de solicitar autorización al Receptor
    Cancelable con aceptación El Comprobante puede ser cancelado pero necesita autorización por parte del Receptor
    No cancelable El Comprobante no puede ser cancelado

    Lista de mensajes posibles en elemento Estado

    Mensaje Descripción
    Vigente El Comprobante se encuentra Vigente en el SAT
    Cancelado El Comprobante se encuentra Cancelado en el SAT
    No Encontrado El Comprobante no ha podido ser encontrado en la base del SAT

    Lista de mensajes posibles en elemento EstatusCancelacion

    Mensaje Descripción
    Cancelado sin aceptación El Comprobante se canceló sin que el Receptor emitiera una respuesta
    Cancelado con aceptación El Receptor del Comprobante aceptó la cancelación
    Plazo vencido Expiró el tiempo de espera para recibir respuesta por parte del Receptor
    En proceso Existen peticiones de cancelación en curso para el Comprobante consultado
    Solicitud rechazada El Receptor del Comprobante rechazó la cancelación

    Método [ConsultaPeticionesPendientes]

    En este método se podrá realizar la solicitud de consulta de CFDI Pendientes de respuesta de cancelación. Para poder utilizar este método, se requiere que el CSD del Receptor del CFDI se encuentre registrado en Reachcore para que de esta forma se pueda firmar la solicitud de cancelación.

    Solicitud Consulta Peticiones Pendientes

    Elemento Uso Descripción
    ApiKey Requerido Identificador de autenticación, que se genera en el portal de Reachcore.
    RfcReceptor Requerido Indica el RFC Receptor del Comprobante a consultar y se relaciona con el CSD con el que se llevará a cabo la firma electrónica de la solicitud de consulta.


    Estructura de solicitud:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
       <soapenv:Header>
          <cus:ApiKey>000...999</cus:ApiKey>
       </soapenv:Header>
       <soapenv:Body>
          <urn:PeticionesPendientesRequest>
             <urn:RfcReceptor>BAJF541014RB3</urn:RfcReceptor>
          </urn:PeticionesPendientesRequest>
       </soapenv:Body>
    </soapenv:Envelope>

    Respuesta de Consulta Peticiones Pendientes

    Elemento Descripción
    CodEstatus Indica el estado de la consulta
    UUID Indica los UUID de los Comprobantes pendientes de respuesta de cancelación que tenga el Receptor
    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <PeticionesPendientesResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <TransactionId>3562dc5c-e996-4cbf-8de4-6a2a36a18440</TransactionId>
             <ObtenerPeticionesPendientesResult CodEstatus="1100">
                <UUID>
                   <guid>dffd810e-503d-404c-ad49-37bcee68ecbd</guid>
                   <guid>cb349854-5aac-4d72-b796-cbab9b2bf760</guid>
                   <guid>bf546196-1778-4b79-af2e-4ee5e0b3d6df</guid>
                   <guid>a2c74a90-4bb2-480e-ac9e-1cb550b1563a</guid>
                   <guid>cc6bd9cc-43db-4560-8eec-5d9aad375faa</guid>
                   <guid>39140bd4-1d11-46db-8cfb-3c28234f9fcb</guid>
                   <guid>fcc02812-c1ad-42f2-a3e7-f06bb9f3d6c1</guid>
                   <guid>cb349854-5aac-4d72-b796-cbab9b2bf760</guid>
                   <guid>dffd810e-503d-404c-ad49-37bcee68ecbd</guid>
                   <guid>a2c74a90-4bb2-480e-ac9e-1cb550b1563a</guid>
                   <guid>cc6bd9cc-43db-4560-8eec-5d9aad375faa</guid>
                   <guid>bf546196-1778-4b79-af2e-4ee5e0b3d6df</guid>
                   <guid>39140bd4-1d11-46db-8cfb-3c28234f9fcb</guid>
                   <guid>fcc02812-c1ad-42f2-a3e7-f06bb9f3d6c1</guid>
                </UUID>
             </ObtenerPeticionesPendientesResult>
          </PeticionesPendientesResponse>
       </s:Body>
    </s:Envelope>

    Códigos de respuesta del Servicio del SAT para el método de ConsultaPeticionesPendientes

    Código Descripción del código Observaciones
    300 Usuario no valido Este código de error se regresa cuando la autentificación del usuario no fue exitosa.
    301 XML mal formado Este código de error se regresa cuando el request posee información invalida, ejemplo: un RFC de receptor no válido.
    1001 Se obtuvieron las peticiones del RFC Receptor de forma exitosa  
    1101 No existen peticiones pendientes para el RFC Receptor Este código se regresa cuando la consulta se realizó de manera exitosa, pero no se encontraron solicitudes de cancelación para el RFC receptor

    Método [ConsultaUUIDRelacionados]

    En este método se podrá realizar la solicitud de consulta de CFDI Relacionados a un folio fiscal. Para poder utilizar este método, se requiere que el CSD del Receptor del CFDI se encuentre registrado en Reachcore para que de esta forma se pueda firmar la solicitud de cancelación.

    Solicitud de Consulta CFDI Relacionados

    Elemento Uso Descripción
    ApiKey Requerido Identificador de autenticación, que se genera en el portal de Reachcore.
    Uuid Requerido Folio fiscal del Comprobante a consultar.
    El folio fiscal debe tener el formato de GUID válido, descrito por la siguiente expresión regular:
    [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:

    18982836-822c-417c-b235-1f596117fad8
    RfcReceptor Requerido Indica el RFC Receptor del Comprobante a consultar y se relaciona con el CSD con el que se llevará a cabo la firma electrónica de la solicitud de consulta.


    Ejemplo de solicitud:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
       <soapenv:Header>
          <cus:ApiKey>000...999</cus:ApiKey>
       </soapenv:Header>
       <soapenv:Body>
          <urn:ConsultaCFDIRelacionadosRequest>
             <urn:Uuid>BA72F298-1118-45F2-B73D-AE3700F5E003</urn:Uuid>
             <urn:RfcReceptor>LAN7008173R5</urn:RfcReceptor>
          </urn:ConsultaCFDIRelacionadosRequest>
       </soapenv:Body>
    </soapenv:Envelope>

    Respuesta Consulta CFDI Relacionados

    Elemento Descripción
    TransactionId Identificador de transacción dentro de reachcore. Si existen errores, se debe proporcionar este dato al equipo de Soporte Reachcore.
    Error Este nodo se regresa sólo cuando hay errores en la petición. La información que contiene este nodo es:
  • Code: código de error.
  • Message: Descripción del código de error.
  • Result La respuesta en formato XML generada por el SAT, la cual indica el resultado de la operación de la solicitud de consulta de CFDI relacionados.


    Ejemplo de respuesta:

    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaCFDIRelacionadosResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <TransactionId>77c46817-001b-4f46-b95c-c477859be32e</TransactionId>
             <CodEstatus>2000</CodEstatus>
             <UuidsRelacionadosPadres>
                <UuidPadre>
                   <Uuid>ba72f298-1118-45f2-b73d-ae3700f5e003</Uuid>
                   <RfcEmisor>AAA010101AAA</RfcEmisor>
                   <RfcReceptor>LAN7008173R5</RfcReceptor>
                </UuidPadre>
             </UuidsRelacionadosPadres>
             <UuidsRelacionadosHijos>
                <UuidRelacionado>
                   <Uuid>fc62c1dd-a063-449c-9b2a-0448862d349f</Uuid>
                   <RfcEmisor>AAA010101AAA</RfcEmisor>
                   <RfcReceptor>LAN7008173R5</RfcReceptor>
                </UuidRelacionado>
             </UuidsRelacionadosHijos>
          </ConsultaCFDIRelacionadosResponse>
       </s:Body>
    </s:Envelope>

    Método [ConsultaUUIDRelacionadosFirmada]: Consulta de CFDI Relacionado por medio de petición firmada de origen

    Este método se utiliza para solicitar la consulta de CFDI relacionados a un Folio Fiscal específico; sin embargo, a diferencia del método ConsultaCFDIRelacionados, cuando no es posible registrar el CSD del Receptor en Reachcore, el XML de la petición de consulta de CFDI relacionados firmada con el CSD del Receptor es enviada en la solicitud de este método, conforme a lo definido por el SAT para la solicitud de consulta. La respuesta de esta operación es idéntica a la del método ConsultaCFDIRelacionados: la respuesta de consulta dentro del SAT.

    Solicitud ConsultaCFDIRelacionadosFirmada

    Elemento Uso Descripción
    ApiKey Requerido Identificador de autenticación, que se genera en el portal de Reachcore.
    SolicitudFirmada Requerido XML con la solicitud de consulta conforme a la estructura especificada por el SAT, indicando:
  • Folio Fiscal del Comprobante a consultar
  • RFC del Receptor que consulta
  • RFC del PAC que envía la solicitud de consulta (el cual siempre debe ser ASE0201179X0)

  • Estos datos van firmados electrónicamente con la llave privada del Receptor. Para referencia de cómo llevar a cabo el firmado consulta el artículo: ¿Cómo firmar una solicitud de cancelación con la llave privada del emisor?


    Ejemplo de Solicitud:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
       <soapenv:Header>
          <cus:ApiKey>000...999</cus:ApiKey>
       </soapenv:Header>
       <soapenv:Body>
          <urn:ConsultaCFDIRelacionadosRequestFirmado>
             <urn:SolicitudFirmada><![CDATA[<PeticionConsultaRelacionados xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Uuid="ca2a3b53-f384-4977-9e0f-093ba5734528" RfcReceptor="LAN7008173R5" RfcPacEnviaSolicitud="ASE0201179X0" xmlns="http://cancelacfd.sat.gob.mx"><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" /><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" /></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /><DigestValue>NdQsgRqNObUvJVZ9anZVhQ0QwIs=</DigestValue></Reference></SignedInfo><SignatureValue>gf05Sf8tu9DjSdRr8JhjTYEEbdPeqdseV5akDQklAd/lrhPGrqiaLhj1tml9EjpzeeXTpc2Y1rubPGiPXngByly1nw/G/CB2zOHaCDG2xRV3mU+e2+d/c56yB+sKUtRV/FpYoI9NXCXgX7JskT/3ETGtNcjJXMOsXvQLOQRcQYAMqI9QYCiVqOG8TcMy4n91Tap8Q3mYLc48gP3FFK6NrxFnmFI3IVaorK2OspHjQ8PXArbMGNNvSP0lZpj/e4IgDA/J2q9GQMrmYF6TvsWEGPWeOs/DWnd/3wGnK6vmgn2eUJlFHPhMqBlcFWGGUmrQS/Dt8kt2QeAgLVMeEJjsHA==</SignatureValue><KeyInfo><X509Data><X509IssuerSerial><X509IssuerName>OID.1.2.840.113549.1.9.2=Responsable: ACDMA, OID.2.5.4.45=SAT970701NN3, L=Coyoacán, S=Distrito Federal, C=MX, PostalCode=06300, STREET="Av. Hidalgo 77, Col. Guerrero", E=asisnet@pruebas.sat.gob.mx, OU=Administración de Seguridad de la Información, O=Servicio de Administración Tributaria, CN=A.C. 2 de pruebas(4096)</X509IssuerName><X509SerialNumber>286524172099382162235533054548081509963388170549</X509SerialNumber></X509IssuerSerial><X509Certificate>MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp/38ULWto/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA/g7kzcU/1tcpFXF/rIy93APvkU72jwvkrnprzs+SnG81+/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9/T6MNZ+/LM2L/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw/ZH+P88RAt5em5/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7/w=</X509Certificate></X509Data></KeyInfo></Signature></PeticionConsultaRelacionados>]]></urn:SolicitudFirmada>
          </urn:ConsultaCFDIRelacionadosRequestFirmado>
       </soapenv:Body>
    </soapenv:Envelope>

    Respuesta ConsultaCFDIRelacionadosResponse

    Elemento Descripción
    TransactionId Identificador de transacción dentro de reachcore. Si existen errores, se debe proporcionar este dato al equipo de Soporte Reachcore.
    Error Este nodo se regresa sólo cuando hay errores en la petición. La información que contiene este nodo es:
  • Code: código de error.
  • Message: Descripción del código de error.
  • Result La respuesta en formato XML generada por el SAT, la cual indica el resultado de la operación de la solicitud de consulta de CFDI relacionados. Esta respuesta se entrega dentro de un elemento <![CDATA[...]]>.


    Ejemplo de Respuesta:

    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaCFDIRelacionadosResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <TransactionId>5926b0d2-6671-48f1-bc83-1486b0f9099c</TransactionId>
             <CodEstatus>2001</CodEstatus>
             <UuidsRelacionadosPadres>
                <UuidPadre>
                   <Uuid>ca2a3b53-f384-4977-9e0f-093ba5734528</Uuid>
                   <RfcEmisor>AAA010101AAA</RfcEmisor>
                   <RfcReceptor>LAN7008173R5</RfcReceptor>
                </UuidPadre>
             </UuidsRelacionadosPadres>
          </ConsultaCFDIRelacionadosResponse>
       </s:Body>
    </s:Envelope>

    Códigos de respuesta del Servicio del SAT para los métodos de ConsultaCFDIRelacionados

    Código Descripción del código Observaciones
    2000 Existen CFDI relacionados al folio fiscal Este código de respuesta se presentará cuando la petición de consulta encuentre documentos relacionados al UUID consultado.
    2001 No existen CFDI relacionados al folio fiscal Este código de respuesta se presentará cuando el UUID consultado no contenga documentos relacionados a él.
    2002 El folio fiscal no pertenece al Receptor Este código de respuesta se presentará cuando el RFC del receptor no corresponda al UUID consultado.
    1101 No existen peticiones para el RFC Receptor Este código se regresa cuando la consulta se realizó de manera exitosa, pero no se encontraron solicitudes de cancelación para el rfc receptor.

    Códigos de error propios de la plataforma Reachcore

    Código Descripción del código Observaciones
    100 API Key Requerida El elemento ApiKey esta vacío o contiene espacios.
    101 API Key no válida El API Key no existe en Reachcore.
    102 API Key no tiene privilegios La cuenta Reachcore no tiene activado el servicio de consulta de CFDI relacionados para un CFDI. Por favor contacta a Reachcore para solicitar informes de cómo activar esta funcionalidad.
    201 Solicitud requerida El elemento SolicitudFirmada esta vacío.
    202 Solicitud no es un XML válido No se puede leer como XML el contenido del elemento SolicitudFirmada.
    205 RFC Receptor no válido El RFC Receptor no cumple con la expresión regular.
    206 Namespace no valido No se está usando el namespace correcto para el nodo raíz.
    207 Prefijo no válido No se está usando el prefijo can para el namespace del comprobante.
    300 Autenticación no válida Este código de respuesta se presentará cuando la petición de consulta obtenga una autenticación no válida dentro del SAT
    301 Certificado no corresponde al RFC Receptor El RFC Receptor no es el mismo RFC del CSD.
    302 El certificado no es CSD El comprobante esta sellado con un certificado FIEL.
    303 Certificado no emitido por el SAT El CSD no está firmado por algún certificado raíz del SAT.
    304 Certificado no registrado en LCO El certificado del receptor no esta registrado en la Lista de Contribuyentes con Obligación (LCO) publicada por el SAT.
    305 Certificado de receptor no existente El número del certificado CSD no existe para ese RFC Receptor.
    306 Comprobante fuera de vigencia del certificado La fecha de expedición del comprobante está fuera del rango de vigencia del certificado.
    307 Certificado de receptor no vigente La fecha de expedición del comprobante está fuera del rango de vigencia del certificado.
    308 Certificado de receptor revocado El certificado está actualmente revocado en la LCO del SAT.
    999 Error interno del servicio. Error de la plataforma de Reachcore


    Método [LotesCancelacion]

    En este método se podrá realizar la solicitud de Consulta los identificadores de lote de cancelación que se generaron en un periodo específico. Este método permite obtener los identificadores de lote de cancelación que se entregan al depositar un archivo de lote de cancelación a través del SFTP o del portal de emisión de Reachcore.

    Solicitud de Consulta de Identificador de Lote de Cancelacion

    Elemento Uso Descripción
    ApiKey Requerido Identificador de autenticación, que se genera en el portal de Reachcore.
    TipoDocumento Requerido Especifica el tipo de lote de documentos enviados. Valores permitidos: cfdi o retenciones
    FechaInicial Requerido Fecha en formato yyyy-mm-dd donde inicia el periodo de consulta.
    FechaFinal Requerido Fecha en formato yyyy-mm-dd donde termina el periodo de consulta.


    El periodo de consulta no debe exceder de más de 6 meses a partir de la fecha de consulta, es decir: si la petición a este método se lleva a cabo el 30 de junio, no se podrán obtener resultados previos al 30 de enero.

    Estructura de solicitud:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
       <soapenv:Header>
          <cus:ApiKey>?</cus:ApiKey>
       </soapenv:Header>
       <soapenv:Body>
          <urn:ConsultaIdLoteCancelacionRequest>
             <urn:TipoDocumento>cfdi</urn:TipoDocumento>
             <urn:FechaInicial>2021-06-01</urn:FechaInicial>
             <urn:FechaFinal>2021-06-30</urn:FechaFinal>
          </urn:ConsultaIdLoteCancelacionRequest>
       </soapenv:Body>
    </soapenv:Envelope>

    Respuesta ConsultaIdLoteCancelacion

    Respuesta exitosa

    Elemento Descripción
    Lotes Agrupador de los distintos lotes de cancelación.
    Lote Elemento que contiene la información asociada al lote de cancelación.


    Atributos del nodo Lote
    Atributo Descripción
    Identificador ID del lote de cancelación
    Tipo Tipo de documentos a los que pertenece el lote (CFDI o Retenciones)
    Rfc RFC del Emisor al que pertenece el lote de cancelación. Para el caso de un lote de cancelación de Sector Primario, se regresa el valor PSECFDI
    Fecha Fecha en que se recibió el lote de cancelación
    Estatus Estado del lote de cancelación, puede ser En Proceso, Abortado, o Finalizado.
    Cancelados Una vez que se terminó de procesar el lote de cancelación, indica la cantidad de documentos cancelados.
    NoCancelados Una vez que se terminó de procesar el lote de cancelación, indica la cantidad de documentos que no pudieron ser cancelados.

    Ejemplo de respuesta para una consulta de CFDI:

    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <Lotes>
                <Lote Identificador="5d0cf1f5-1247-4c71-87e8-82a2ca110859" Tipo="CFDI" Rfc="PSECFDI" Fecha="2021-06-01T14:34:20" Estatus="Abortado" Cancelados="0" NoCancelados="0"/>
                <Lote Identificador="a09885ea-cd6f-47c6-85c6-999d95e19bb9" Tipo="CFDI" Rfc="EKU9003173C9" Fecha="2021-06-01T14:45:33" Estatus="Abortado" Cancelados="0" NoCancelados="0"/>
                <Lote Identificador="49866688-a986-4469-aef5-b39bab7a2235" Tipo="CFDI" Rfc="EKU9003173C9" Fecha="2021-06-01T19:28:16" Estatus="Finalizado" Cancelados="0" NoCancelados="1"/>
             </Lotes>
          </ConsultaIdLoteCancelacionResponse>
       </s:Body>
    </s:Envelope>

    Ejemplo de respuesta para una consulta de Retenciones:

    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <Lotes>
                <Lote Identificador="43a06c26-6567-4e34-b16c-0bc4fbbc7cb7" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T16:40:13" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
                <Lote Identificador="4323c330-4379-4f45-9d63-99b7483e3d7b" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:25:06" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
                <Lote Identificador="fa6422d3-134c-4d1d-ba3e-26462745599f" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:27:48" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
                <Lote Identificador="91bbe91d-4bc2-4d02-946f-06b9d6a3bd05" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:29:54" Estatus="Finalizado" Cancelados="7" NoCancelados="0"/>
                <Lote Identificador="84fa4c06-7dcc-4c05-88ba-7bc0494ef9dc" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:34:23" Estatus="Finalizado" Cancelados="10" NoCancelados="0"/>
                <Lote Identificador="90f3e8df-67ae-4b95-a223-3bf6cae29833" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-21T11:19:34" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
                <Lote Identificador="60644b9f-5af5-4068-8d4e-d4a7c96a111f" Tipo="Retenciones" Rfc="AAA010101AAA" Fecha="2021-04-26T20:44:45" Estatus="Finalizado" Cancelados="1" NoCancelados="0"/>
                <Lote Identificador="2720ac13-6c58-425d-8028-19edb870e510" Tipo="Retenciones" Rfc="XOJI740919U48" Fecha="2021-04-26T21:47:18" Estatus="Finalizado" Cancelados="1" NoCancelados="0"/>
             </Lotes>
          </ConsultaIdLoteCancelacionResponse>
       </s:Body>
    </s:Envelope>

    Respuesta con errores en la petición

    Elemento Descripción
    Error Agrupador de los distintos errores en la petición.
    Code Indica el tipo de error encontrado.
    Message Proporciona una descripción simple del motivo de error.


    Ejemplos de respuesta con errores:

    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <Error>
                <Code>TipoDocumento</Code>
                <Message>El tipo de documento es inválido.</Message>
             </Error>
          </ConsultaIdLoteCancelacionResponse>
       </s:Body>
    </s:Envelope>
    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <Error>
                <Code>Fecha</Code>
                <Message>La fecha inicial [2022-04-01] debe ser menor a la fecha final [2021-06-30].</Message>
             </Error>
          </ConsultaIdLoteCancelacionResponse>
       </s:Body>
    </s:Envelope>
    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
          <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
             <Error>
                <Code>Fecha</Code>
                <Message>La fecha inicial [2021-06-30] debe ser menor a la fecha final [2021-05-30].</Message>
             </Error>
          </ConsultaIdLoteCancelacionResponse>
       </s:Body>
    </s:Envelope>

    Para mayor información o aclaración de dudas relacionadas con esta guía, por favor envía un correo a MEX-soporte@sovos.com.


    Regresar