Consultations related to CFDI Cancelations

This service allows you to consult CFDI information on the SAT.

Content

General Features
- CFDI Status consultation in the SAT
- Fiscal folio consultations pending a cancelation response (receiver)
- Related CFDI consultations (receiver)
Requirements to consult information about a CFDI
- Location service
Method [ConsultaCFDIService]
- Request ConsultaEstadoCFDI
- Response ConsultaEstadoCFDI
SAT Response Codes for the Consultation Service about the status of a CFDI
Method [ConsultaPeticionesPendientes]
- Request PeticionesPendientes
- Response PeticionesPendientes
SAT Response Codes for the CFDI Consultation Service pending a cancelation response
Method [ConsultaUUIDRelacionados]
- Request ConsultaCFDIRelacionados
- Response ConsultaCFDIRelacionados
Method [ConsultaUUIDRelacionadosFirmada]: Consulta con firma de origen
- Request Firma de origen
- Response Firma de origen
SAT Response Codes for the consultation service of related CFDIs
Error Codes belonging to Sovos Mexico
Method [LotesCancelacion]: Id consultation of a cancelation batch
- Request of Consultation of Id for a cancelation batch
- Response of Consultation of Id for a cancelation batch

General Features

On the scheme of Consultation of Digital Fiscal Receipts through the internet (CFDI), the SAT keeps in its central database all the all the information about the full taxpayers’ registers. Because of this centralized model, the consultation of a CFDI consists of directly requesting to the SAT the information about the receipt. Except for the consultation about a status of a CFDI, the consultation methods focus on the Receivers of a CFDI and it is necessary to sign the web request to the SAT through the Digital Seal Certificate that the Receiver has (CSD). The consultations are made online through web services requests and the response time depend on the SAT systems.

The service to Consult a CFDI Status in the SAT responds with the following information:

The SAT can process a cancelation request when meeting the following:

A status code in the SAT indicating if the information from the receipt could be obtained.

An indicator that allows you to know if the receipt can be canceled and if so if it requires consent from the Receiver of the receipt or if it can be canceled without acceptance.

An indicator of the Receipt’s Status (valid or canceled) at the moment of the status request.

A cancelation status indicates if the receipt has any cancelation request pending answer from the Receiver.

Requirements to consult information about a CFDI

To use the web service of related consultations to CFDI cancelations, you will need:

A service contract with Sovos. If you don't have one, please send an email to sales-mexico@sovos.com
To generate an API key on your Sovos account, this is an identifier that authenticates the user on the platform web services. To generate an API key, check this article: Generating an API Key for web services.

For the consultations that requires a Digital Seal Certificate (CSD) for the signature requesting the consult in the SAT, you need a valid CSD and this must be loaded in the Sovos platform.

The CSD usually consists of 3 parts:

The certificate, which is a file with the extension .cer
The private key, which is a file with the extension .key
The password of the private key

To obtain a Digital Seal Certificate (CSD) of the SAT, please review the SAT site to generate a Request for a Digital Seal certificate to issue invoices.

Service Location

The URLs for each of the environments are:

Environment	WSDL Location
UAT	https://oat.reachcore.com/api/ws/6.0/pacservices/Consulta.svc/basic?wsdl
Production	https://go.reachcore.com/api/ws/6.0/pacServices/Consulta.svc/basic?wsdl

Method [`ConsultaEstadoCFDI`]

On this method of the Web Service, you can request a Consultation of a CFDI Status. To use this method, you will not need to sign the request with the CSD of the Receiver, you are just requesting information of the Receipt.

Status Consultation Request

Element	Use	Description
ApiKey	Required	Authentication Id generated in the Sovos Portal.
RfcEmisor	Required	Indicates the Issuance RFC to consult.
RfcReceptor	Required	Indicates the Receiver RFC to consult.
Total	Required	Indicates the Total amount of the Receipt to consult.
Uuid	Required	Indicates the UUID of Fiscal Folio of the Receipt to Consult.

The service just provides information about a CFDI Status, does not return information of the Status of a CFDI of Retentions and Payment Information.

Structure Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
   <soapenv:Header>
      <cus:ApiKey>000...999</cus:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <urn:ConsultaEstadoCFDIRequest>
         <urn:RfcEmisor>CALJ581101M37</urn:RfcEmisor>
         <urn:RfcReceptor>XAXX010101000</urn:RfcReceptor>
         <urn:Total>10000.00</urn:Total>
         <urn:Uuid>e99aff16-b7ef-4ea5-9c57-61c8d479b63f</urn:Uuid>
      </urn:ConsultaEstadoCFDIRequest>
   </soapenv:Body>
</soapenv:Envelope>

Status Consultation Response

Element	Description
TransactionId	Sovos Transaction Id. If there’s any error, you should provide this to the Support team.
Error	This node is return just when there are errors in the request. The information within this node is: `Code`: error code. `Message`: Description of the error code.
Result	The response to an status consultation of a CFDI to the SAT.

Response Example:

<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">
      <ConsultaEstadoCFDIResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <TransactionId>0da4d3ca-81b6-452f-aef1-017fa2cfeb2e</TransactionId>
         <ConsultaResult>
            <a:CodigoEstatus>S - Comprobante obtenido satisfactoriamente.</a:CodigoEstatus>
            <a:EsCancelable>Cancelable con aceptación</a:EsCancelable>
            <a:Estado>Vigente</a:Estado>
            <a:EstatusCancelacion>En proceso</a:EstatusCancelacion>
         </ConsultaResult>
      </ConsultaEstadoCFDIResponse>
   </s:Body>
</s:Envelope>

SAT Response Codes to the service of Status Consultation of a CFDI

Possible messages in the element CodigoEstatus:

Message	Description
S - Comprobante obtenido satisfactoriamente	Receipt successfully obtained
N 601: La representación impresa proporcionada no es valida	The printed representation is not valid. You will get this response code when you didn't follow the standard format in the validation request.
N 602: Receipt not found

List of possible messages in the element EsCancelable

Message	Description
Cancelable sin aceptación	Cancelable with no acceptance. The receipt can be canceled without requesting authorization to the Receiver.
Cancelable con aceptación	Cancelable with acceptance. The receipt can be canceled but it needs authorization from the Receiver.
No cancelable	Non-cancelable. The receipt cannot be canceled.

List of possible messages in the element Estado

Message	Description
Vigente	Valid. The receipt is valid in the SAT.
Cancelado	Canceled. The receipt is Canceled in the SAT.
No Encontrado	Not found. The receipt cannot be found in the SAT database.

List of possible messages in the element EstatusCancelacion

Message	Description
Cancelado sin aceptación	Cancelable with no acceptance. The receipt was canceled without a response from the Receiver.
Cancelado con aceptación	Cancelable with acceptance. The Receiver of the receipt accepted the cancelation.
Plazo vencido	Overdue term. The deadline to get a response from the Receiver expired.
En proceso	In progress. There are cancelation requests in progress for the consulted receipt
Solicitud rechazada	Rejectedd. The Receiver of the voucher rejected the cancelation.

Method [`ConsultaPeticionesPendientes`]

Though this method you can perform the consultation of Pending Cancelation Response CFDIs. To use this method, you will require to have the Receiver's CSD registered in Sovos so you can sign the cancelation request.

Request Pending Requisition Consultation

Element	Use	Description
ApiKey	Required	Authentication Id generated on the Sovos portal.
RfcReceptor	Required	This indicates the Receiver's RFC of the receipt that you want to consult about and its link with the CSD that you will use to sign the electronic signature for the requisition.

Structure Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
   <soapenv:Header>
      <cus:ApiKey>000...999</cus:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <urn:PeticionesPendientesRequest>
         <urn:RfcReceptor>BAJF541014RB3</urn:RfcReceptor>
      </urn:PeticionesPendientesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response of Pending Requisition Consultation

Element	Description
CodEstatus	This indicates the consultation status
UUID	This indicates the UUID of the pending response receipts the Receiver has

<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">
      <PeticionesPendientesResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <TransactionId>3562dc5c-e996-4cbf-8de4-6a2a36a18440</TransactionId>
         <ObtenerPeticionesPendientesResult CodEstatus="1100">
            <UUID>
               <guid>dffd810e-503d-404c-ad49-37bcee68ecbd</guid>
               <guid>cb349854-5aac-4d72-b796-cbab9b2bf760</guid>
               <guid>bf546196-1778-4b79-af2e-4ee5e0b3d6df</guid>
               <guid>a2c74a90-4bb2-480e-ac9e-1cb550b1563a</guid>
               <guid>cc6bd9cc-43db-4560-8eec-5d9aad375faa</guid>
               <guid>39140bd4-1d11-46db-8cfb-3c28234f9fcb</guid>
               <guid>fcc02812-c1ad-42f2-a3e7-f06bb9f3d6c1</guid>
               <guid>cb349854-5aac-4d72-b796-cbab9b2bf760</guid>
               <guid>dffd810e-503d-404c-ad49-37bcee68ecbd</guid>
               <guid>a2c74a90-4bb2-480e-ac9e-1cb550b1563a</guid>
               <guid>cc6bd9cc-43db-4560-8eec-5d9aad375faa</guid>
               <guid>bf546196-1778-4b79-af2e-4ee5e0b3d6df</guid>
               <guid>39140bd4-1d11-46db-8cfb-3c28234f9fcb</guid>
               <guid>fcc02812-c1ad-42f2-a3e7-f06bb9f3d6c1</guid>
            </UUID>
         </ObtenerPeticionesPendientesResult>
      </PeticionesPendientesResponse>
   </s:Body>
</s:Envelope>

SAT Response Codes for the method of `ConsultaPeticionesPendientes`

Code	Description	Comments
300	User not valid	You get this error code when the user authentication was not successful.
301	XML wrong formatted	The request XML sent to the SAT is not properly formatted or has invalid information. Example: an RFC of the receiver that is not valid.
1001	The request from the Receiver’s RFC was successfully obtained
1101	There are no pending requests for the Receiver’s RFC	You get this code when the consultation was successful, but cancelations request for the Receiver’s RFC could not be found.

Method [`ConsultaUUIDRelacionados`]

Through this Method you can request a consultation of a CFDI linked to a fiscal folio. To use this method, you will require to have the Receiver’s CFDI registered in Sovos so you can sign the cancelation request.

Element	Use	Description
ApiKey	Required	Authentication Id generated on the Sovos portal.
Uuid	Required	Fiscal folio of the receipt you want to consult. The fiscall folio must have a valid GUID format, described by the following regular expression: `[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}` Example: `18982836-822c-417c-b235-1f596117fad8`
RfcReceptor	Required	This indicates the Receiver’s RFC of the receipt that you want to consult about and its link with the CSD that you will use to sign the electronic signature for the requisition.

Request Example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
   <soapenv:Header>
      <cus:ApiKey>000...999</cus:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <urn:ConsultaCFDIRelacionadosRequest>
         <urn:Uuid>BA72F298-1118-45F2-B73D-AE3700F5E003</urn:Uuid>
         <urn:RfcReceptor>LAN7008173R5</urn:RfcReceptor>
      </urn:ConsultaCFDIRelacionadosRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response of Related CFDIs Consultation

Element	Description
TransactionId	Sovos Transaction Id. If there’s any error, you should provide this to the Support team.
Error	You will obtain this node if there are errors in the request. The info in this node is: `Code`: Error code. `Message`: Description of the error code.
Result	The answer in XML format generated by the SAT, indicates the result of the consultation.

Response Example:

<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">
      <ConsultaCFDIRelacionadosResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <TransactionId>77c46817-001b-4f46-b95c-c477859be32e</TransactionId>
         <CodEstatus>2000</CodEstatus>
         <UuidsRelacionadosPadres>
            <UuidPadre>
               <Uuid>ba72f298-1118-45f2-b73d-ae3700f5e003</Uuid>
               <RfcEmisor>AAA010101AAA</RfcEmisor>
               <RfcReceptor>LAN7008173R5</RfcReceptor>
            </UuidPadre>
         </UuidsRelacionadosPadres>
         <UuidsRelacionadosHijos>
            <UuidRelacionado>
               <Uuid>fc62c1dd-a063-449c-9b2a-0448862d349f</Uuid>
               <RfcEmisor>AAA010101AAA</RfcEmisor>
               <RfcReceptor>LAN7008173R5</RfcReceptor>
            </UuidRelacionado>
         </UuidsRelacionadosHijos>
      </ConsultaCFDIRelacionadosResponse>
   </s:Body>
</s:Envelope>

Method [`ConsultaUUIDrelacionadosFirmada`]: Consultation of related CFDIs through a request with a signature of origin

You will use this method to request the consultation of a CFDI related to a specific fiscal folio. The XML of the request must be signed with the Receiver’s CSD. This is in case you could not register the Receiver’s CSD in Sovos. The response of this operation is identical to the one in the method ConsultaCFDIRelacionados.

Request ConsultaCFDIRelacionadosFirmada

Element	Use	Description
ApiKey	Required	Authentication Id generated on the Sovos portal.
SolicitudFirmada	Required	XML with the consultation request according to SAT specifications: Fiscal Folio of the Receipt Receiver’s RFC PAC’s RFC (this should always be ASE0201179X0) This data must be signed electronically with the private key of the Receiver. You can check this article to see how to sign with the key: ¿How to sign a cancelation request with the private key of the issuer?

Request Example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
   <soapenv:Header>
      <cus:ApiKey>000...999</cus:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <urn:ConsultaCFDIRelacionadosRequestFirmado>
         <urn:SolicitudFirmada><![CDATA[<PeticionConsultaRelacionados xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Uuid="ca2a3b53-f384-4977-9e0f-093ba5734528" RfcReceptor="LAN7008173R5" RfcPacEnviaSolicitud="ASE0201179X0" xmlns="http://cancelacfd.sat.gob.mx"><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>NdQsgRqNObUvJVZ9anZVhQ0QwIs=</DigestValue></Reference></SignedInfo><SignatureValue>gf05Sf8tu9DjSdRr8JhjTYEEbdPeqdseV5akDQklAd/lrhPGrqiaLhj1tml9EjpzeeXTpc2Y1rubPGiPXngByly1nw/G/CB2zOHaCDG2xRV3mU+e2+d/c56yB+sKUtRV/FpYoI9NXCXgX7JskT/3ETGtNcjJXMOsXvQLOQRcQYAMqI9QYCiVqOG8TcMy4n91Tap8Q3mYLc48gP3FFK6NrxFnmFI3IVaorK2OspHjQ8PXArbMGNNvSP0lZpj/e4IgDA/J2q9GQMrmYF6TvsWEGPWeOs/DWnd/3wGnK6vmgn2eUJlFHPhMqBlcFWGGUmrQS/Dt8kt2QeAgLVMeEJjsHA==</SignatureValue><KeyInfo><X509Data><X509IssuerSerial><X509IssuerName>OID.1.2.840.113549.1.9.2=Responsable: ACDMA, OID.2.5.4.45=SAT970701NN3, L=Coyoacán, S=Distrito Federal, C=MX, PostalCode=06300, STREET="Av. Hidalgo 77, Col. Guerrero", E=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>286524172099382162235533054548081509963388170549</X509SerialNumber></X509IssuerSerial><X509Certificate>MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp/38ULWto/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA/g7kzcU/1tcpFXF/rIy93APvkU72jwvkrnprzs+SnG81+/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9/T6MNZ+/LM2L/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw/ZH+P88RAt5em5/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7/w=</X509Certificate></X509Data></KeyInfo></Signature></PeticionConsultaRelacionados>]]></urn:SolicitudFirmada>
      </urn:ConsultaCFDIRelacionadosRequestFirmado>
   </soapenv:Body>
</soapenv:Envelope>

Response ConsultaCFDIRelacionadosResponse

Element	Description
TransactionId	Sovos Transaction Id. If there’s any error, you should provide this to the Support team.
Error	You will obtain this node if there are errors in the request. The info in this node is: `Code`: Error code. `Message`: Description of the error code.
Result	The answer in XML format generated by the SAT, indicates the result of the consultation about the related CFDIs. This response is delivered inside an element `<![CDATA[...]]>`.

Response Example:

<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">
      <ConsultaCFDIRelacionadosResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <TransactionId>5926b0d2-6671-48f1-bc83-1486b0f9099c</TransactionId>
         <CodEstatus>2001</CodEstatus>
         <UuidsRelacionadosPadres>
            <UuidPadre>
               <Uuid>ca2a3b53-f384-4977-9e0f-093ba5734528</Uuid>
               <RfcEmisor>AAA010101AAA</RfcEmisor>
               <RfcReceptor>LAN7008173R5</RfcReceptor>
            </UuidPadre>
         </UuidsRelacionadosPadres>
      </ConsultaCFDIRelacionadosResponse>
   </s:Body>
</s:Envelope>

SAT Response Codes for the methods of `ConsultaCFDIRelacionados`

Code	Description	Comments
2000	User not valid	You get this error code when the consultation request founds documents related to the consulted UUID.
2001	No related CFDI found for the fiscal folio	You get this error code when the UUID consulted does not have any documents related.
2002	Fiscal folio does not belong the the Receiver	You get this error code when the Receiver’s RFC does not match the UUID consulted.
1101	There are no pending requests for the Receiver’s RFC	You get this code when the consultation was successful, but cancelations request for the Receiver’s RFC could not be found.

Error codes of the Sovos Reachcore Platform

Code	Description	Comments
100	API Key Required	The element APIKey is empty or have spaces.
101	API Key not valid	The APIKey does not exist in Sovos.
102	API Key does not have privileges	The Sovos account doesn’t have the consultation CFDI related to a CFDI service active. Contact Sovos to know how to activate this feature.
201	Required request	The element SolicitudFirmada is empty.
202	Request is not a valid XML	The content in the element SolicitudFirmada can’t be read.
205	Receiver’s RFC is not valid	The Receiver’s RFC does not fulfill the regular expression.
206	Namespace is not valid	You are not using the correct namespace for the root node.
207	Prefix not valid	You are not using the prefix can for the namespace in the receipt.
300	Authentication is not valid	You will get this response code when the consultation request has a not valid authentication in the SAT.
301	Certificate does not match the Receiver’s RFC	The Receiver’s RFC is not the same RFC from the CSD.
302	Certificate is not a CSD	The receipt is sealed with a FIEL certificate.
303	Certificate not issued by the SAT	The CSD is not signed by a SAT root certificate.
304	Certificate not registered in the LCO	The Receiver’s certificate is not registered in the List of Taxpayers with Obligations (CSD) published by the SAT.
305	Receiver’s certificate does not exist	The certificate number of the CSD does not exist for the Receiver’s RFC.
306	Receipt out of certificate validation	The issuance date in the receipt is out of range from the Certificate’s validation.
307	Receiver’s certificate is not valid	The issuance date in the receipt is out of range from the Certificate’s validation.
308	Receiver’s certificate has been revoked	The certificate is currently revoked from the SAT’s LCO.
999	Service internal error	Sovos Reachcore Platform Error.

Method [`LotesCancelacion`]

Through this method you can perform the Consultation of the Cancelation Batch Identifiers generated in a specific period. This method allows to obtain the cancelation batch identifiers that you get when you issue a cancelation batch file through an SFTP or through the issuance Sovos Portal.

Cancelation Batch Identifier Consultation Request

Element	Use	Description
ApiKey	Required	Authentication Id generated on the Sovos portal.
TipoDocumento	Required	This specifies the type of batch documents that was issued. Permitted valued: `cfdi` or `retenciones`
FechaInicial	Required	Date in format `yyyy-mm-dd` where the consultation period begins.
FechaFinal	Required	Date in format `yyyy-mm-dd` where the consultation period ends.

The consultation period cannot exceed 6 months from the consultation date of request. This means that if the request is issued on a June 30, you cannot obtain results previous to January 30.

Request Structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
   <soapenv:Header>
      <cus:ApiKey>?</cus:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <urn:ConsultaIdLoteCancelacionRequest>
         <urn:TipoDocumento>cfdi</urn:TipoDocumento>
         <urn:FechaInicial>2021-06-01</urn:FechaInicial>
         <urn:FechaFinal>2021-06-30</urn:FechaFinal>
      </urn:ConsultaIdLoteCancelacionRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response `ConsultaIdLoteCancelacion`

Successful Response

Element	Description
Lotes	This groups the different cancelation batches.
Lote	Element that contains the information related to the cancelation batch.

Attributes in the node `Lote`

Attribute	Description
Identificador	Identifier. Id of the cancelation batch.
Tipo	Type. Type of documents the batch belongs to (CFDI or Retentions).
Rfc	Issuer’s RFC who owns the cancelation batch. In the case of a Primary Sector cancelation batch, you will get the value `PSECFDI`.
Fecha	Date. Date that the cancelation batch was received.
Estatus	Status. Status of the cancelation batch, it can be `En Proceso` (In progress), `Abortado` (Aborted), or `Finalizado` (Finished).
Cancelados	Canceled. Once the cancelation batch is processed, this indicates the quantity of canceled documents.
NoCancelados	Non-canceled. Once the cancelation batch is processed, this indicates the quantity of documents that could not be canceled.

Example of a CFDI consultation response:

<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">
      <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <Lotes>
            <Lote Identificador="5d0cf1f5-1247-4c71-87e8-82a2ca110859" Tipo="CFDI" Rfc="PSECFDI" Fecha="2021-06-01T14:34:20" Estatus="Abortado" Cancelados="0" NoCancelados="0"/>
            <Lote Identificador="a09885ea-cd6f-47c6-85c6-999d95e19bb9" Tipo="CFDI" Rfc="EKU9003173C9" Fecha="2021-06-01T14:45:33" Estatus="Abortado" Cancelados="0" NoCancelados="0"/>
            <Lote Identificador="49866688-a986-4469-aef5-b39bab7a2235" Tipo="CFDI" Rfc="EKU9003173C9" Fecha="2021-06-01T19:28:16" Estatus="Finalizado" Cancelados="0" NoCancelados="1"/>
         </Lotes>
      </ConsultaIdLoteCancelacionResponse>
   </s:Body>
</s:Envelope>

Example of a Response for a Consultation about Retentions:

<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">
      <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <Lotes>
            <Lote Identificador="43a06c26-6567-4e34-b16c-0bc4fbbc7cb7" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T16:40:13" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
            <Lote Identificador="4323c330-4379-4f45-9d63-99b7483e3d7b" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:25:06" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
            <Lote Identificador="fa6422d3-134c-4d1d-ba3e-26462745599f" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:27:48" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
            <Lote Identificador="91bbe91d-4bc2-4d02-946f-06b9d6a3bd05" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:29:54" Estatus="Finalizado" Cancelados="7" NoCancelados="0"/>
            <Lote Identificador="84fa4c06-7dcc-4c05-88ba-7bc0494ef9dc" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:34:23" Estatus="Finalizado" Cancelados="10" NoCancelados="0"/>
            <Lote Identificador="90f3e8df-67ae-4b95-a223-3bf6cae29833" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-21T11:19:34" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
            <Lote Identificador="60644b9f-5af5-4068-8d4e-d4a7c96a111f" Tipo="Retenciones" Rfc="AAA010101AAA" Fecha="2021-04-26T20:44:45" Estatus="Finalizado" Cancelados="1" NoCancelados="0"/>
            <Lote Identificador="2720ac13-6c58-425d-8028-19edb870e510" Tipo="Retenciones" Rfc="XOJI740919U48" Fecha="2021-04-26T21:47:18" Estatus="Finalizado" Cancelados="1" NoCancelados="0"/>
         </Lotes>
      </ConsultaIdLoteCancelacionResponse>
   </s:Body>
</s:Envelope>

Response with errors in the request

Element	Description
Error	This groups the different errors in the request.
Code	This indicates the type of error found.
Message	This gives a simple description of the error.

Example of a response with errors:

<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">
      <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <Error>
            <Code>TipoDocumento</Code>
            <Message>El tipo de documento es inválido.</Message>
         </Error>
      </ConsultaIdLoteCancelacionResponse>
   </s:Body>
</s:Envelope>

<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">
      <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <Error>
            <Code>Fecha</Code>
            <Message>La fecha inicial [2022-04-01] debe ser menor a la fecha final [2021-06-30].</Message>
         </Error>
      </ConsultaIdLoteCancelacionResponse>
   </s:Body>
</s:Envelope>

<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">
      <ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
         <Error>
            <Code>Fecha</Code>
            <Message>La fecha inicial [2021-06-30] debe ser menor a la fecha final [2021-05-30].</Message>
         </Error>
      </ConsultaIdLoteCancelacionResponse>
   </s:Body>
</s:Envelope>

For more information or to clarify any doubt related to this guide, please send an email to MEX-soporte@sovos.com.

Regresar

Consultations related to CFDI Cancelations

Content

General Features

Requirements to consult information about a CFDI

Service Location

Method [ConsultaEstadoCFDI]

Status Consultation Request

Status Consultation Response

SAT Response Codes to the service of Status Consultation of a CFDI

Possible messages in the element CodigoEstatus:

List of possible messages in the element EsCancelable

List of possible messages in the element Estado

List of possible messages in the element EstatusCancelacion

Method [ConsultaPeticionesPendientes]

Request Pending Requisition Consultation

Response of Pending Requisition Consultation

SAT Response Codes for the method of ConsultaPeticionesPendientes

Method [ConsultaUUIDRelacionados]

Response of Related CFDIs Consultation

Method [ConsultaUUIDrelacionadosFirmada]: Consultation of related CFDIs through a request with a signature of origin

Request ConsultaCFDIRelacionadosFirmada

Response ConsultaCFDIRelacionadosResponse

SAT Response Codes for the methods of ConsultaCFDIRelacionados

Error codes of the Sovos Reachcore Platform

Method [LotesCancelacion]

Cancelation Batch Identifier Consultation Request

Response ConsultaIdLoteCancelacion

Successful Response

Attributes in the node Lote

Response with errors in the request

Method [`ConsultaEstadoCFDI`]

Method [`ConsultaPeticionesPendientes`]

SAT Response Codes for the method of `ConsultaPeticionesPendientes`

Method [`ConsultaUUIDRelacionados`]

Method [`ConsultaUUIDrelacionadosFirmada`]: Consultation of related CFDIs through a request with a signature of origin

SAT Response Codes for the methods of `ConsultaCFDIRelacionados`

Method [`LotesCancelacion`]

Response `ConsultaIdLoteCancelacion`

Attributes in the node `Lote`