Obtain CSF

Intro

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

Important points

Required parameters

The only two necessary parameters are requeride

rfc, indicate the RFC of the Persona Física or Persona Moral to request
password: Indicate the SAT CIEC password of the person to request.

Validations

The following validations are applied to the __ 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

Using this endpoint, 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 service must be called in order to generate the PDF file.

Test the service (test cases)

We included a query param in Sandbox environment, so you can query test cases that we created to run tests.
In order to obtain the response, please fill the query param with:

success: it sends back a successful response

Possible Errors

Required field

You will get a 400 bad request error when the curp 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 curp 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 CURP 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"
    }
}