Obtaining constancia de situación fiscal

Intro

This API lets you get a CSF (Constancia de Situación Fiscal) within the SAT system.

Important points

Required parameters

To make the request it is necessary to provide two parameters in the request.

If you want to validate the RFC (Registro Federal de Contribuyentes) of the PF (Persona Física) or PM (Persona Moral), you can use this service to ensure that the RFC provided is correct.

Validations

The following validations are applied to the RFC parameter

• Must be 12 or 13 characters long, depending on the type to request
• Must comply with the format of a valid RFC

Response

You can find an examples of the different kinds of responses in the examples of the call.

CSF PDF File

You can also download the PDF file of the CSF and obtain the original file.

In order to obtain the file, you must look in the JSON response the structure called apiData->files->path

"apiData": [
    {
      "files": [
        {
          "path": "11/63dac04eb76d338acdc75b73/sat/csf/sandbox/64821d23824123766beac2be/AAAA010123AB1",
          "name": "AAAA010123AB1"
        }
      ]
    }
  ]

Once you have obtained the path, the Get File API must be called in order to obtain the PDF file.

Test the service (test cases)

We have included a query parameter in Sandbox to enable you to query the test cases that we created for running tests. To get a response, fill the testCaseId parameter with any of the following cases:

📘

Test your own test case

In case you want to test your own test case created in link, you can send in the testCaseId parameter the identifier of the test case you want to use.

For more information visit our knowledge center to know more about test cases

Possible Errors

Required field

You will get a 400 bad request error when the rfc parameter is not provided in the body request.

{
    "rfc": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
  	"password":"REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty"
}

Invalid format

You will get a 400 bad request error when the rfc parameter does not comply with the correct format

{
    "rfc": "FORMAT_ERROR; invalid rfc format"
}

Test case not found

if a test case parameter is not sent or a value other than those mentioned above is sent, the service will return the following error 400 bad request

{
    "testCase": "EMPTY_ERROR; test case not found"
}

Service Unavailable

If the SAT system is not available, this endpoint will retrieve the next response:

{
    "id": "64405bb85a7fcc51545aa79b",
    "createdAt": "2023-04-19T15:23:04.834748-06:00",
    "finishedAt": "0001-01-01T00:00:00Z",
    "duration": 0,
    "status": "SERVICE_ERROR",
    "errorMessage": "error service unavailable",
    "request": {
        "curp": "ABCD970724HYNNNL07"
    }
}