PAC - Documentación Ca... » Consulta de CFDIs Rela...
Export

Consulta de CFDIs Relacionados

1 Introducción

El servicio de Consulta de CFDIs Relacionados está dirigido a los receptores que necesitan conocer qué comprobantes están vinculados a una factura específica (por ejemplo, pagos, sustituciones, notas, etc.). La petición debe enviarse mediante SOAP y el XML de la solicitud debe estar firmado con el Certificado de Sello Digital (CSD) del contribuyente que solicita la información.

Nota: Cada consulta consume un timbre del paquete contratado.

2 Estructura del Servicio

2.1 Estructura general de la petición

La petición se realiza mediante método POST y debe contener un sobre SOAP con el nodo ProcesarRespuesta incluyendo los atributos necesarios (RFC del PAC que envía la solicitud, RFC receptor, UUID del comprobante) y la firma digital (XML Signature) debidamente construida.

2.2 Parámetros requeridos

Endpoint

Método Ruta
POST https://timbrador.tralix.com:8081/cancela/relacionadosSoap/

Autenticación y Headers

Header Valor esperado
SOAPAction "http://cancelacfd.sat.gob.mx/ICfdiConsultaRelacionadosService/ProcesarRespuesta"
Content-Type text/xml; charset=utf-8
CustomerKey {CUSTOMER_KEY} (clave asignada al cliente)

Parámetros (dentro del cuerpo SOAP)

Parámetro Descripción
RfcPacEnviaSolicitud RFC del PAC que realiza la consulta.
RfcReceptor RFC del receptor (cliente de Tralix) al que se le emitió la factura. Debe estar asociado a un CustomerKey vigente.
Uuid UUID del comprobante del cual se desean obtener los CFDIs relacionados.
Signature Firma digital (XML Signature) del contenido, usando el CSD del contribuyente que solicita.
2.3 Ejemplo de petición
<soapenv:Envelope xmlns:can="http://cancelacfd.sat.gob.mx" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xd="http://www.w3.org/2000/09/xmldsig#">
  <soapenv:Header/>
  <soapenv:Body>
    <can:ProcesarRespuesta>
      <can:solicitud RfcPacEnviaSolicitud="DAL050601L35" RfcReceptor="CALJ581101M37" Uuid="BB5AA65E-45D2-4565-9FA3-E67A452CDFA2"> 
        <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>FzlrxAxnZ59ixR9kXOXtm9K44aI=</DigestValue>
            </Reference>
          </SignedInfo>
          <SignatureValue>RUVlQGKT/LqJyteqV3dqqpbWi/LkPduFci5CNduLm3Uoe7szOn3Txc0y1T8oHYxb9jSwGuYjU+lD
                  ORZ1jp7gWkKZxkQweTa87bj7qkXxS8vf3uUuoeMbDZ5sJY7aDxYvtqRYwOYuiQMDlMGdG1V2L23K
                  sHYAmpNnGPsm94A5cAc9Cz8IJANYxdnJDt6FYFUpRk/95lqkuKKU4ceAPNB5Gxtlhi9Gnjeiz2Xi
                  v/bI20hhdM2Fydic2KDyioTlZ3CHo6VKVq9/vM5VXgmSb3gd4cEWxK8jt9krsTbXQWLkYW0AQ8FH
                  85CmwJURtbETR61wD5+MQVi8VAEYo2UUbHDZTg==</SignatureValue>
          <KeyInfo>
            <X509Data>
              <X509IssuerSerial>
                <X509IssuerName>OID.1.2.840.113549.1.9.2=Responsable: ACDMA, OID.2.5.4.45=SAT970701NN3, L=Coyoacán, ST=Distrito Federal, C=MX, OID.2.5.4.17=06300, STREET=&quot;Av. Hidalgo 77, Col. Guerrero&quot;, EMAILADDRESS=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>286524172099382162235533054548081509963388170548</X509SerialNumber>
              </X509IssuerSerial>
              <X509Certificate>MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTQwDQYJKoZIhvcNAQELBQAwggFmMSAw
                        HgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRt
                        aW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1
                        cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMu
                        c2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNV
                        BBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UE
                        BwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3Bv
                        bnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTM5MzBaFw0yMDEwMjUyMTM5MzBaMIGxMSAwHgYDVQQD
                        ExdKVURJVEggUkFNSVJFWiBFU0NVREVSTzEgMB4GA1UEKRMXSlVESVRIIFJBTUlSRVogRVNDVURF
                        Uk8xIDAeBgNVBAoTF0pVRElUSCBSQU1JUkVaIEVTQ1VERVJPMRYwFAYDVQQtEw1DQUxKNTgxMTAx
                        TTM3MRswGQYDVQQFExJGVUFCNzcwMTE3TU1DTkxUMDQxFDASBgNVBAsUC1BydWViYV9DRkRJMIIB
                        IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAj9dxR0263ZLEYuLxz+OzMHfCezfcn4klwY0c
                        /lQVkXCPOJG7vkmQpk80vImd4YiMGJN9wKjnXVdH1eN5RWNk4PtT/JnkgNvIjrjg05AkZBHbkqGp
                        /s5MA7K1Ez+vLt4TwHgoxRB4SpeF/477UiM0HMWiK5KakKkjatL3QLG2S3RBxRv1phr2nCsX4iiO
                        zan591oz19ShDwO3HRkYo/0jtq8o1ZFr5ajpxnJR+DhXakcWok10O3LrpYkInn6CZtSEwFTWbMda
                        g1/sNwptIxQDHoKHUpHQNWdE1sj1vdOzcs6jIkX7afgFYKfArssGucdbNzwloOFh6p4miT5oRs4m
                        VwIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEA
                        pJPBXikqI0118ZA+0wMzqqQfifbhf5M3UDx+1UOUj0VPwTTi7JX6I3DwoFK2qzjGx8sOfcqUhETQ
                        jf5+ZLUI/ZRLqnT4lNWYXLFTf7KwBggYP89Pp3+wkfDxy+Ic8gh+Hr4MzRGPDiDU+M+t/5MGOVPL
                        hMLyyz+d/dl1a8M4kwAUdO1xyZemfdqcq6lLEgk5GbiA4NwGHYGjLdT/9xkZC3FVRccKy/MqesgI
                        SeTKmNGGNawvqJZ83rWCrMx2jlSfs6AUfjlbz+5rNnETSzImMOHIJMbMHvfbxzojOgWQmgsaiByS
                        3gpxUeH2sYNRLoJQ6BxVWdKgtrh4w1KKE07MxJytMyHNN1I4XlvcNDwqVDXelcedeswnjESz1OEV
                        2AaWXfZ6cLpNIfb6tnWxyITrKyygbjkRXsb15LGlLv2Q5fywTVjWtsQ2jDlrhRPW0bjIDohAaqNM
                        +6vTKjJvZmEZ6FJJsI838RYGyGkAm1fc+Hsy45PyJ1FakIdOWREJSrUQjh073Vl1qY+VY2RL7oKL
                        uG598YjcQrEK1zEDdAGmHoBtXuIDR6niaT6rurHhf4NHiXZAnWxyFI7UlLoQZ3ngefGniWRioqef
                        1K5bzTOg4mYPDAaECzlcZ6p6/Um95mOUHU44owbqZx8yUwRzZt83SbAKhzEsdwgXzF+FlS0Qxvo=</X509Certificate>
            </X509Data>
          </KeyInfo>
        </Signature>
      </can:solicitud>
    </can:ProcesarRespuesta>
  </soapenv:Body>
</soapenv:Envelope>

RfcPacEnviaSolicitud= Es el RFC del PAC con el que esta realizando la solicitud (en este caso TLE011122SC2)

RfcReceptor= Es el RFC cliente de Tralix a quién se le emitió la factura (este RFC se debe encontrar dentro de un customer key vigente).

RfcEmisor= Es el RFC cliente de Tralix quién emitió la factura (este RFC se debe encontrar dentro de un customer key vigente).

Uuid= Este corresponde al comprobante del que se requieren conocer los comprobantes relacionados. 

2.4 Ejemplo de respuesta
<?xml version="1.0" encoding="UTF-8"?>
<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">
      <ProcesarRespuestaResponse xmlns="http://cancelacfd.sat.gob.mx">
         <ProcesarRespuestaResult>
            <UuidConsultado>[UUID_CONSULTADO]</UuidConsultado>
            <Resultado>WS Consulta CFDI relacionados RfcReceptor: [RFC_RECEPTOR] - folio físcal: [UUID_CONSULTADO] - Clave: 2000 - Se encontraron CFDI relacionados</Resultado>
            <UuidsRelacionadosPadres>
               <UuidPadre>
                  <Uuid>[UUID_PADRE]</Uuid>
                  <RfcEmisor>[RFC_EMISOR]</RfcEmisor>
                  <RfcReceptor>[RFC_RECEPTOR]</RfcReceptor>
               </UuidPadre>
            </UuidsRelacionadosPadres>
            <UuidsRelacionadosHijos/>
         </ProcesarRespuestaResult>
      </ProcesarRespuestaResponse>
   </s:Body>
</s:Envelope>
2.5 Códigos de respuesta

  • Si la petición es correcta indica que se encontraron CFDI relacionados.

3 Consideraciones Técnicas

  • El XML de la petición debe estar firmado usando XML Signature con el CSD correspondiente.

  • RfcReceptor y RfcEmisor deben estar asociados a un CustomerKey vigente en Tralix.

  • El Uuid es el folio fiscal del comprobante principal; la respuesta devuelve padres e hijos relacionados.

  • El servicio consume un timbre por cada consulta ejecutada.

  • Asegurarse de que la firma incluya correctamente los elementos <SignedInfo>, <SignatureValue> y <KeyInfo> con el certificado en base64.

  • Si se reciben errores internos (500), contactar soporte antes de reintentar.

4 Contacto y Soporte

  • Para soporte técnico o dudas sobre el uso del servicio, puede comunicarse con el área de soporte técnico de Tralix vía ticket.

 

No Comments
Back to top