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

Ambiente

Ruta

POST

Pruebas

https://pruebastfd.tralix.com:8081/cancela/relacionadosSoap/

POST

Productivo

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.