Llama Gratis 01800 788 0195

Consultar Documento Relacionado

Método Consultar_Documento_Relacionado

Petición al servicio

 

El servicio de “consultar_documento_relacionado” se utiliza para realizar la consulta al servicio del SAT para revisar si el documento a consultar tiene documentos relacionados.

Para realizar pruebas con este servicio, sera necesario utilizar los siguientes UUIDs para obtener una respuesta de documentos relacionados:

  • Documento Hija, es el primer comprobante y este no tiene nodo de documentos relacionados.

AAAA0101-AAAA-AA01-0101-AAAAAA010101

  • Documento Padre, documento al que se le agrega como relacionado el documento Hija.

BBBB0202-BBBB-BB02-0202-BBBBBB020202

  • Documento Abuelo, tercer documento al que se le relaciona el folio del CFDI identificado como Padre

CCCC0303-CCCC-CC03-0303-CCCCCC030303

 

Parámetros de la petición:

 

Nombre Descripción Requerido
username Usuario del webservice
password Contraseña del webservice
rfc_receptor El rfc que emitió el comprobante que desea cancelar.
uuid Se manda el UUID del comprobante que se desea consultar. El UUID debe cumplir con la expresión regular de UUIDs.
cert_pem El certificado, en formato pem, que corresponde al emisor del comprobante.
llave_pem La llave, en formato pem, que corresponde al emisor del comprobante.

 

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 al servicio

 

 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:consultar_documento_relacionado soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
 <username xsi:type="xsd:string">AAA010101000</username>
 <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password> 
 <uuid xsi:type="xsd:string">BBBB0202-BBBB-BB02-0202-BBBBBB020202</uuid>
 <rfc_receptor xsi:type="xsd:string">TME960709LR2</rfc_receptor>
 <cert_pem xsi:type="xsd:string">-----BEGIN CERTIFICATE-----
MIIFzDCCA7SgAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI3NjMwDQYJKoZIhvcNAQEL
BQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UE
CgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNV
BAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNp
w7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEm
MCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEM
BTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDES
MBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkq
hkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjEyMDU0MDFaFw0y
MDEwMjEyMDU0MDFaMIG4MRwwGgYDVQQDExNJTk1PQiBFRE1BIFNBIERFIENWMRww
GgYDVQQpExNJTk1PQiBFRE1BIFNBIERFIENWMRwwGgYDVQQKExNJTk1PQiBFRE1B
IFNBIERFIENWMSUwIwYDVQQtExxUTUU5NjA3MDlMUjIgLyBIRUdUNzYxMDAzNFMy
MR4wHAYDVQQFExUgLyBIRUdUNzYxMDAzTURGUk5OMDkxFTATBgNVBAsUDFBydWVi
YXNfQ0ZESTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJgqZ+ezJyeJ
XACMK8ehFp64ecAl8jfYKB4xMJy0RRb+qXKRewxtLojiTFECWdCx283tEkdHUj8b
LzsCfFAMnsP2G4CS2aE2/1LLCHoZpdImaasLX1YJL2bUzxKQKi+RlL63M49yyfvG
BjEgG7f6TMwVSUSbgDFpYAFHqx4LK+p2GVHuUUzoiIm8xRYaW1YPMa457be5W8ws
jw0nGRLfo8hRIjPHedkwtcqYPj57xsPXMfxWP45vOlW7GuLkMq/ECccHxJiPitiT
hcDFKlf/mAR0kaux9LTffvWilA2uQAlyVyNVjqfdpvDdq4ycTaoIMYKrv/9R31dQ
0AmdXT8cfbcCAwEAAaMdMBswDAYDVR0TAQH/BAIwADALBgNVHQ8EBAMCBsAwDQYJ
KoZIhvcNAQELBQADggIBAF5kwvyBUp7Ad99DktzEhrJwnMQyhA79sVc4Ns2SpLON
/cV244ZnG5hgXk2awKbHEiSj/ke7EhgEpGS818ERsj7eW/wRgugBZraVn48GOn6q
X0uV9EjwWEGK5uT6IDN25igeXxVJHP3hn40fX2BPqsaqRP49YMxcOWD7mhWRh2E6
BnoKYjgHVJbavUN6pjCBLmy4hKwfitbjqtUiiWOmBDvvmLFpEGXG8OXn2xladBUk
fC4sfgMBpVZVuEV7RqAgCSCZ2xo6UEyd4KKpTjbdp0Tj5gw+NmiovAZHwU/NPRoj
N95f/ibj7268LBr2DcO5rlmr7szwJ3dtwu86N7HkUxW3vo3qGHTVK2HRBArda9VN
4pEyIL0Qt46ci5rFYXB2cCWU8XAh8gaZnxJoNTSY4A4yMJG9UfM/2rHC+YvOouIZ
2kJZ2h+SwKOYGJOX749P/QeF4Z/L/ODs3E08bV7IQna1ZHmd6ydYhZVpheMgNoNn
IG6jdzfyuo8NZAIIW/JGmPTANPCwTSHqBY1lmnp/oZNrkxGWtGhbltRfBoFQfTqC
ZALm6fsVeQqHQ6a7W45FJ2RD1nltPSdniMo3Iz/t4eHCjFvM3aORvA9oJEPr5Zzz
BV2fQOXkyS8QdsSVb5ZmJG+FqZKKlsiaX6xhqK6gqTLyJN+7/yr9T/ZZ4M7VrRoL
-----END CERTIFICATE-----
</cert_pem>
 <llave_pem xsi:type="xsd:string">-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCYKmfnsycniVwA
jCvHoRaeuHnAJfI32CgeMTCctEUW/qlykXsMbS6I4kxRAlnQsdvN7RJHR1I/Gy87
AnxQDJ7D9huAktmhNv9Sywh6GaXSJmmrC19WCS9m1M8SkCovkZS+tzOPcsn7xgYx
IBu3+kzMFUlEm4AxaWABR6seCyvqdhlR7lFM6IiJvMUWGltWDzGuOe23uVvMLI8N
JxkS36PIUSIzx3nZMLXKmD4+e8bD1zH8Vj+ObzpVuxri5DKvxAnHB8SYj4rYk4XA
xSpX/5gEdJGrsfS03371opQNrkAJclcjVY6n3abw3auMnE2qCDGCq7//Ud9XUNAJ
nV0/HH23AgMBAAECggEAYxh6wnHxtdXGjLS8bi2CRatt3qzXqXaj6cWvGt5rgCYo
w+vqbpVMEOkPOlKFm1u5Acq6dKEF9wMFJzDfNGKDoqrMDleUU2E1tf1zb9D0JH/P
oQyu8aDZteYxVK1+S6xLakh0056127mCnsuCQbZH/UB/jqaWPZeaZjr+PXqZBv8O
NDMzomZaIKSUqwwiFi/vSunrrbGEkcCjrLK7mtHVNOx4HuuGSwixIUbBPefbR2Po
2fIATTKTIGlAzZrKaVWW3730ZNO4WJeKvahoHrLiiFz9pCWr4h+WOSWQDE3MNrCr
LVIusjciKZ6bNkYK15p0SmQNh1A8ZCC/xx2zo0pHgQKBgQDmF+QgS6cWdwuDqus3
weShruOaIpzgp01h2+g5sl93Wbh7hXKgAP3MUDbdd/j8ZZ0R1hL2ChWw0t9Ma/29
o+sTSs+m4kTRiNf4qq6VoWlIdQ8CpEIEdBp5RC/Oxd1vNHSV0POQSM1v27lzOgkG
Aaq16vTCtm8LcztFE9Mys7Om+QKBgQCpTFyVKful82n3SLnhfVAypkUPcjHqsIZf
KSVLdDCdQJGRKdKvMcr/4A+xRC1SdUPE5RUEIq7aQIRe27H2JjD3USXPGJCC0pah
ct9QxZajqIsw4CpodOiTuXBphaIfjGibSCE83pKQbRfoKIhtuVHxaizLBjNGvapS
JYzG368GLwKBgQDH4dFHTPElztyt0PjtQv6+hhMqfw8RCcVrUYH3PUE5iTN9+nuN
C89ugfBnjCU7/XnpWLK4EiKtrUJWPSn8aD16UO765m0qKVqUppFrYwD29NnJTbAb
9lBZMCbn1XN7e3IcA5zSpqvwlEwSEURtd105E5b0306v/7ZpV8OMtBdI4QKBgGF/
38XsAshk8f7+/EYXdEtnJFir7IF7njdJq/fTd3foyqyuSG6rH3zTHlZ5rBxT+m53
e+4Ax3BcPZ+fqNLY1dRpAHxPalJdU3CxhlivIn0oQNkqEGJOCe+hmVK8Kk0/ALOF
C9dRW1kf6ufCCCgg1UdSXW+jJ36zFlbu1y9lfRfzAoGALViSE59U7+pOk324H5yh
rAotmRzydr94AAkM7b4KWT6Lm9KNO9jhJlpcyHMOqT+yvDzNSBcpCMh+bCFwNUCh
oqM8++PNBZhYg8uRr236Z2dwQLE8W3uvlGVkmld/w1oSss/IVGIW9Fkzq+FmXst6
nG6Qen20YfqezK2yWdYNDnU=
-----END PRIVATE KEY-----
</llave_pem>
 </urn:consultar_documento_relacionado>
 </soapenv:Body>
</soapenv:Envelope>

Respuesta del servicio

 

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

 

Parámetros de la respuesta:

 

Nombre Descripción
consultar_relacionados Información de los documentos relacionados al UUID consultado, dividos por UuidsRelacionadosPadres y UuidsRelacionadosHijos según corresponda.

Ejemplo de respuesta del servicio

 

A continuación mostramos la respuesta que regresa el servicio, en donde se mostraran los UUID’s que tenga documentos relacionados.

 

<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:consultar_documento_relacionado_response>
      <consultar_documento_relacionado_result xsi:type="tns:consultar_documento_relacionado_result">
        <resultado xsi:type="xsd:string">WS Consulta CFDI relacionados RfcReceptor: TME960709LR2 - folio físcal: BBBB0202-BBBB-BB02-0202-BBBBBB020202 - Clave: 2000 - Se encontraron CFDI relacionados</resultado>
          <relacionados_padres xsi:type="tns:relacionados_padres">
            <uuid_padre xsi:type="tns:uuid_padre">
              <uuid xsi:type="xsd:string">CCCC0303-CCCC-CC03-0303-CCCCCC030303</uuid>
              <rfc_emisor xsi:type="xsd:string">PZA000413788</rfc_emisor>
              <rfc_receptor xsi:type="xsd:string">TME960709LR2</rfc_receptor>
            </uuid_padre>
          </relacionados_padres>
          <relacionados_hijos xsi:type="tns:relacionados_hijos">
            <uuid_hijo xsi:type="tns:uuid_hijo">
              <uuid xsi:type="xsd:string">AAAA0101-AAAA-AA01-0101-AAAAAA010101</uuid>
              <rfc_emisor xsi:type="xsd:string">PZA000413788</rfc_emisor>
              <rfc_receptor xsi:type="xsd:string">TME960709LR2</rfc_receptor>
            </uuid_hijo>
          </relacionados_hijos>
       </consultar_documento_relacionado_result>
     </tns:consultar_documento_relacionado_response>
  </soap:Body>
</soap:Envelope>

 

Mensajes recibidos de la petición al servicio

 

Esta tabla muestra los códigos que obtendremos una vez realizada la petición de consulta cfdi relacionados.

 

Código Descripción 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 el.
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.