Cotizantes Lite Sandbox

El API cotizantes lite utiliza las siguientes credenciales para su uso.

• app_id: Es un código generado por Nubloq para la identificación de quién esté haciendo uso de la API.

Solicitud

Una vez se entregan las credenciales por parte de Nubloq, se pueden ejecutar las peticiones mediante llamados POST. Para ello, se usan los siguientes parámetros:

• URL de la petición: 'https://apim-prod-data.nubloq.app/v2/sandbox/cotizantesLite'

• Tipo de método: 'POST'

Respuestas

Las respuestas que se pueden obtener según sea el caso son las siguientes, todas son tipo JSON:

POST https://apim-prod-data.nubloq.app/v2/sandbox/cotizantesLite

Una vez se entregan las credenciales por parte de Nubloq, se pueden ejecutar las peticiones mediante llamados POST. Para ello, se usan los siguientes parámetros:

Headers

Name	Type	Description
app_id*	String	{app_id}
Authorization*	String	{token_type} {access_token}

Request Body

Name	Type	Description
tipo_documento*	String	CC
num_documento*	String	90000009

200: OK Esta respuesta se da cuando el usuario es encontrado en nuestros registros de manera exitosa

{
    "status": true,
    "message": null,
    "requestID": "2a6d32be-691a-442a-84bd-84760a78b56f",
    "tipoDocumento": "CC",
    "numeroDocumento": "90000009",
    "primerNombre": "NOMBRE 1",
    "segundoNombre": "NOMBRE 2",
    "primerApellido": "APELLIDO 1",
    "segundoApellido": "APELLIDO 2",
    "cotizantes": [
        {
            "periodoCotizacion": "202211",
            "tipoCotizante": "1",
            "descTipoCotizante": "Dependiente",
            "salarioBasico": "537335"
        },
        {
            "periodoCotizacion": "202211",
            "tipoCotizante": "3",
            "descTipoCotizante": "Pensionado del Regimen de Ahorro Individual con Solidaridad",
            "salarioBasico": "500000"
        }
    ]
}

400: Bad Request Esta respuesta se da cuando el cuerpo y los encabezados de la petición están mal formados

{
    "status": false,
    "requestID": null,
    "message": "Bad request"
}

401: Unauthorized Esta respuesta se da cuando falta el encabezado “Authorization” o tiene un valor no válido.

{
    "statusCode": 401,
    "message": "Unauthorized. Access token is missing or invalid."
}

403: Forbidden Esta respuesta se da cuando el usuario no está autorizado para consumir el servicio

{
    "status": false,
    "requestID": “9138c6a3-b9d5-4675-bcca-bee6ee8cae71”,
    "message": "Acceso no autorizado!."
}

404: Not Found Esta respuesta se da cuando el usuario no existe en nuestros registros.

{
    "status": false,
    "requestID": "9138c6a3-b9d5-4675-bcca-bee6ee8cae71",
    "message": "Usuario no encontrado."
}

500: Internal Server Error Esta respuesta se da cuando ocurre una excepción no controlada.

{
    "status": false,
    "requestID": "9138c6a3-b9d5-4675-bcca-bee6ee8cae71",
    "message": "Internal server error."
}

Para el campo “tipo_documento” los valores válidos son los siguientes (se debe ingresar el campo nomenclatura):

Nomenclatura	Tipo De Documento
CC	Cédula de Ciudadanía
PE	Permiso Especial
TI	Tarjeta De Identidad
SC	Salvoconducto De Permanencia
RC	Registros Civil
NI	Nit
PA	Pasaporte
CE	Cédula Extranjería
CD	Carné Diplomático
PT	Permiso por Protección Temporal

curl --location 'https://apim-prod-data.nubloq.app/v2/sandbox/cotizantesLite' \
--header 'app_id: {app_id}' \
--header 'Authorization: {token_type} {access_token}' \
--header 'Content-Type: application/json' \
--data '{     
    "tipo_documento": "CC",     
    "num_documento": "90000009"
} '

Nota: Se debe informar a Nubloq el listado de las direcciones IP que van a consumir el servicio, para así proceder a otorgar los permisos necesarios.