Método Consultar_Documento_Relacionado

Enlaces al servicio

Pruebas: https://staging.ws.timbox.com.mx/cancelacion/wsdl

Producción: https://sistema.timbox.com.mx/cancelacion/wsdl

Consumo de créditos

Por cada petición: 1 crédito.

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:

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:

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ódigos de error a nivel petición

Los siguientes códigos de error se generarán a nivel general de la solicitud de cancelación: