Generate RFC PM

API to generate a Persona Moral RFC

Intro

This API is meant to generate an RFC with homoclave for Personas Morales. Kiban cloud use the algorithm provided by the SAT to generate the exact RFC.
In the answer the complete RFC with the homoclave will be included.

Important Points

Mandatory Fields

All the fields in the body are mandatory and kiban cloud performs validations on the information sent to detect special characters or incorrect formats.

fieldtyperequiredlengthDescription
razonSocialAlphabeticYesN/AName of the company.
fechaConstitucionDateYes10Company registration date with format yyyy-mm-dd

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:

NumIdNameDescription
166423072bb869119db3517b4Respuesta exitosaIndicates one successful response

📘

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

Successful response

Inside the response object you will only get the next field.

subfieldDescription
rfcWill contain the generated RFC.
{
    "id": "656007582bacd50889a58412",
    "createdAt": "2023-11-24T02:15:52.03976724Z",
    "finishedAt": "2023-11-24T02:15:52.039850907Z",
    "duration": 0,
    "status": "SUCCESS",
    "request": {
        "fechaConstitucion": "2013-11-06",
        "razonSocial": "INDUSTRIAS KIBAN"
    },
    "response": {
        "rfc": "NKO080220554"
    }
}

Listing the possible not success responses

Required fields

You will get a 400 bad request error when any of the required fields are not provided.

{
    "fechaConstitucion": "FORMAT_ERROR;  expected format: yyyy-mm-dd",
    "razonSocial": "EMPTY_ERROR; can't be empty"
}

Invalid Format

Some of the fields contain illegal characters or formatting, the service will return the a 400 bad request

{
    "fechaConstitucion": "FORMAT_ERROR;  expected format: yyyy-mm-dd"
}

Unauthorized

It means that the provided API is incorrect and that you are not authorized to access it. You will not receive a body, only a 401 HTTP code.

Language
Authorization
Header
Click Try It! to start a request and see the response here!