Find the CFDI related to an invoice before canceling it, so you can check dependencies and avoid rejections.
View SDKs💡 Why check first? A CFDI with active related CFDI is marked as NO CANCELABLE (not cancelable) until all of them are canceled first.
URLs
Select your active environment. The copy buttons and the code examples below are built with the base URL you choose here.
🛠️ Sandbox:
https://services.test.sw.com.mx
🚀 Production:
https://services.sw.com.mx
🔗 Endpoint
Four ways to authenticate the same query. Pick the one that matches what you have on hand and its full reference is built below.
Query by authenticating with the issuer’s CSD. Works for your CFDI regardless of which PAC stamped them.
POST/relations/csd
Property
Usage
Description
Authorization
REQUIRED
Bearer {token} — your account token.
Content-Type
REQUIRED
application/json — the body is sent as JSON.
Property
Type
Usage
Description
uuid
string
REQUIRED
UUID of the CFDI.
password
string
REQUIRED
Certificate password.
rfc
string
REQUIRED
Issuer RFC.
b64Cer
string
REQUIRED
Issuer certificate in Base64.
b64Key
string
REQUIRED
Issuer private key in Base64.
Query with the taxpayer’s PFX file. It’s the equivalent alternative to CSD.
POST/relations/pfx
💡 Try our tool: PFX Certificate Generator
Property
Usage
Description
Authorization
REQUIRED
Bearer {token} — your account token.
Content-Type
REQUIRED
application/json — the body is sent as JSON.
Property
Type
Usage
Description
uuid
string
REQUIRED
UUID of the CFDI.
rfc
string
REQUIRED
Issuer RFC.
b64Pfx
string
REQUIRED
PFX file in Base64.
password
string
REQUIRED
PFX certificate password.
Query with just the RFC and the UUID. It’s the simplest option if your CFDI were stamped with SW.
POST/relations/{rfc}/{uuid}
💡 Requirement: your CSD must be registered in the ADT portal.
Property
Type
Usage
Description
rfc
string
REQUIRED
Issuer RFC.
uuid
string
REQUIRED
UUID of the CFDI.
Send a PeticionConsultaRelacionados request signed with your CSD (XML-DSig), without sharing your certificate or password.
POST/relations/xml
💡 Important: requires an XML already signed with XML-DSig. Validate it first in Sandbox with the SAT test CSD.
Property
Usage
Description
Authorization
REQUIRED
Bearer {token} — your account token.
Content-Type
REQUIRED
multipart/form-data — the XML is sent as a file in the form.
Property
Type
Usage
Description
xml
file
REQUIRED
Signed XML file (PeticionConsultaRelacionados).
Generate the
Signature from your PFX with the Sign XML tool. Before signing, the XML must look like this:To query as the issuer, use RfcEmisor and don’t include RfcReceptor.
To query as the receiver, use RfcReceptor and don’t include RfcEmisor.
Never send both attributes with a value at the same time.
RfcPacEnviaSolicitud can be empty ("").
<PeticionConsultaRelacionados
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
Uuid="{UUID}"
RfcEmisor="{RFC_EMISOR}"
RfcPacEnviaSolicitud=""
xmlns="http://cancelacfd.sat.gob.mx">
</PeticionConsultaRelacionados><?xml version="1.0" encoding="utf-8"?>
<PeticionConsultaRelacionados xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://cancelacfd.sat.gob.mx" Uuid="d003a391-8dc7-4a7d-a299-b3a6ed454959" RfcEmisor="EKU9003173C9" RfcPacEnviaSolicitud="">
<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>8k0KaHNKbuehoDgp/3PpoD2Pjx4=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>N+SZvazfOxk47CMPmQ0iVYkKEJU/hubpmdW71IJH8y6t…</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>MIIFsDCCA5igAwIBAgIUMzAwMDEwMDAwMDA1MDAwMDM0MTYw…</X509Certificate>
<X509IssuerSerial>
<X509IssuerName>CN=AC UAT, O=SERVICIO DE ADMINISTRACION TRIBUTARIA, OU=SAT-IES Authority, …</X509IssuerName>
<X509SerialNumber>3330303031303030303030353030303033343136</X509SerialNumber>
</X509IssuerSerial>
</X509Data>
</KeyInfo>
</Signature>
</PeticionConsultaRelacionados>
Request Example
💡 Note: These examples are based on the SW SDKs, but you can call the REST API directly from any language you prefer.
Response
Property
Type
Description
codStatus
string
Overall result code. Only in successful responses.
data
object | null
Details of the queried CFDI and its relations.
data.uuidConsultado
string
The UUID you queried.
data.resultado
string
Query result returned by the SAT web service.
data.uuidsRelacionadosPadres
array
CFDI that reference the queried one (uuid, rfcEmisor, rfcReceptor).
data.uuidsRelacionadosHijos
array
CFDI referenced by the queried one (uuid, rfcEmisor, rfcReceptor).
message
string
Descriptive message of the result.
status
string
"success" or "error".
Cause: A required parameter is missing or empty; for example, the certificate or key isn’t in Base64.
Solution: Send every required field with a value and check that the Base64 string is complete.
Property
Type
Description
message
string
Code returned when an error occurs.
messageDetail
string
More detailed error message, when available.
data
object | null
null when an error occurs.
status
string
"success" or "error".
Property
Type
Description
codStatus
string
Overall result code. Only in successful responses.
data
object | null
Details of the queried CFDI and its relations.
data.uuidConsultado
string
The UUID you queried.
data.resultado
string
Query result returned by the SAT web service.
data.uuidsRelacionadosPadres
array
CFDI that reference the queried one (uuid, rfcEmisor, rfcReceptor).
data.uuidsRelacionadosHijos
array
CFDI referenced by the queried one (uuid, rfcEmisor, rfcReceptor).
message
string
Descriptive message of the result.
status
string
"success" or "error".
Cause: A required parameter is missing or empty; for example, the certificate or key isn’t in Base64.
Solution: Send every required field with a value and check that the Base64 string is complete.
Property
Type
Description
message
string
Code returned when an error occurs.
messageDetail
string
More detailed error message, when available.
data
object | null
null when an error occurs.
status
string
"success" or "error".
Property
Type
Description
codStatus
string
Overall result code. Only in successful responses.
data
object | null
Details of the queried CFDI and its relations.
data.uuidConsultado
string
The UUID you queried.
data.resultado
string
Query result returned by the SAT web service.
data.uuidsRelacionadosPadres
array
CFDI that reference the queried one (uuid, rfcEmisor, rfcReceptor).
data.uuidsRelacionadosHijos
array
CFDI referenced by the queried one (uuid, rfcEmisor, rfcReceptor).
message
string
Descriptive message of the result.
status
string
"success" or "error".
Cause: The UUID doesn’t have the right format.
Solution: Send the full UUID: 36 characters, 32 hexadecimal digits and 4 hyphens.
Property
Type
Description
message
string
Code returned when an error occurs.
messageDetail
string
More detailed error message, when available.
data
object | null
null when an error occurs.
status
string
"success" or "error".
Property
Type
Description
codStatus
string
Result code: 2000 with related CFDI, 2001 without related CFDI.
data
object | null
Queried UUID and its relations (parents/children), if any.
message
string
Descriptive message of the result.
status
string
"success" or "error".
Property
Type
Description
codStatus
string
Result code: 2000 with related CFDI, 2001 without related CFDI.
data
object | null
Queried UUID and its relations (parents/children), if any.
message
string
Descriptive message of the result.
status
string
"success" or "error".
Cause: The XML is malformed or the signature isn’t valid.
Solution: Sign it again with Sign XML and make sure it has only RfcEmisor or RfcReceptor, not both.
Property
Type
Description
codStatus
string
Error code.
message
string
Descriptive error message.
status
string
"success" or "error".