Consultations related to CFDI Cancelations

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

Content

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