Audit NIP Buró de Crédito Persona Física

Intro

This API will help you audit and reconcile the Buró de crédito Personas Físicas queries that you make on your side with the NIP process Kiban Bureaus.

Important points

Request

🚧

Run this API only after running the query on your side.

Remember that if you want to use this API, you must execute it immediately after querying the Buró de Crédito Personas Físicas from your system.

We strongly recommend you to provide all the data fields in upper case, but is your decision if you use your own format.

The elements to send in the request are:

📘

Generate audit file

This API allows you to provide our system with the data needed to generate an audit. To obtain the audit file, we recommend you use our Generate audit file NIP Buró de Crédito Persona Física service.

Successful response

To know the fields of a successful response we suggest you look at our example called success in the response section.

In a successful response, you will only receive the requested information (as previously described) and a 200 HTTP code indicating that the request was successfully applied. Also, you will get an id corresponding to the resource created.

{
    "id": "64f8c939f8a6e2a1c57db671",
    "createdAt": "2023-09-06T12:47:21.306869-06:00",
    "finishedAt": "2023-09-06T12:47:21.819093-06:00",
    "duration": 512,
    "status": "SUCCESS",
    "request": {
        "primerNombre": "KIBAN",
        "segundoNombre": "CLOUD",
        "apellidoPaterno": "LINK",
        "apellidoMaterno": "AUDIT",
        "rfc": "KIBA070815CLO",
        "direccion": "AV PASEO DE LA REFORMA 403",
        "coloniaPoblacion": "CUAUHTEMOC",
        "ciudad": "CDMX",
        "estado": "CDMX",
        "numeroControlConsulta": 123
    }
}

Possible Errors

Required fields

If any of the required fields are not provided in the request body, a 400 bad request HTTP error code will be returned.

{
    "apellidoMaterno": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "apellidoPaterno": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "ciudad": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "coloniaPoblacion": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "direccion": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "estado": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "idNipValidation": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "numeroControlConsulta": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "numeroReferenciaOperador": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "primerNombre": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty",
    "rfc": "REQUIRED_FIELD_ERROR; EMPTY_ERROR; can't be empty"
}

Invalid format

If any of the required fields do not conform the specific format in the request body, a 400 bad request HTTP error code will be returned.

{
    "idNipValidation": "FORMAT_ERROR; invalid id string",
    "numeroControlConsulta": "FORMAT_ERROR; wrong type"
}

NIP not validated

If the NIP was not finalized (validated), you will receive an HTTP error with code 400.

{
    "idNipValidation": "CONFLICT_ERROR; nip record is not validated"
}

NIP already consumed

If you enter a NIP that has already been used, you will receive an HTTP error with code 400.

{
    "idNipValidation": "CONFLICT_ERROR; nip already consumed"
}

Not existing NIP

If you provide a NIP that does not exist, you will receive an error with a 400 HTTP code.

{
    "idNipValidation": "ERROR_NOT_FOUND"
}

Unknown Field

If you provide a parameter that does not match with the request body parameters, you will receive an error indicating the name of the invalid parameter, you will receive an error with a 400 HTTP code.

{
    "idNipValidationxx": "UNKNOWN_KEY"
}