DataProcess - Decisiones correctas! - Dataprocess - API

Requisitos y Autenticación

Requisitos:

- Para acceder a `este` servicio, es necesario contratar con un Plan de API. Si aún no estás inscrito en este plan, por favor ponte en contacto con nuestro equipo comercial.

Autenticación:

Es imprescindible autenticarse mediante el encabezado de autorización utilizando un token de API válido.

Para esto, accede a la plataforma con Usuario Administrador, y dirígete a la sección API, y seleccionamos la opción Generar.

Captura de pantalla 2024-03-31 a la(s) 11.48.40


Header de Autenticación:

El token se genera concatenando api_key y api_secret con dos puntos :.

Debe ingresar Token api_key:api_secret en el header Authorization de la solicitud.

Ejemplo:

Authorization Token f09167a3efe6012:a20cc5tf24343ad
curl --location 'https://dataprocess.com.ar/api/method/dataprocess.engine.api.politics' \
--header 'Authorization: Token f09167a3efe6012:a20cc5tf24343ad' \
--data ''

Endpoints

Políticas

Descripción: Obtiene una lista de todos las políticas

Endpoint: `/api/method/dataprocess.engine.api.politics`

Método: `GET`

Parámetros:

  • is_active: Opcional, permite filtrar por activo/inactivo. Valores permitidos: 1, 0

Ejemplo de Solicitud:

curl --location 'https://dataprocess.com.ar/api/method/dataprocess.engine.api.politics?is_active=1' \
--header 'Authorization: Token f09167a3efe6012:a20cc5tf24343ad'

Ejemplo de Respuesta:

Ejemplo devolviendo una sola política:

{
    "e61a2bdc7f": {
        "result": "pending",
        "name": "Politica Ejemplo",
        "webservice": "rol",
        "pending_variables": [
            {
                "edad": 35
            },
            {
                "nse": ""
            }
        ],
        "variables": {
            "nombre": "PEDRO GONZALES CATALAN",
            "edad": 35,
            "fallecido": false,
            "jubilado": false,
            "jubilado_beneficio": false,
            "pep": false,
            "estado_cuit": "ACTIVO",
            "letra": 3,
            "nse": "",
            "empleado_publico": false,
            "empleados": 0,
            "trabajador_casa_particular": false,
            "prestacion_desempleo": false,
            "plan_social": false,
            "prestacion_provincial": false,
            "prestacion_nacional": false,
            "asignacion_universal": false,
            "progresar": false,
            "sin_mora_meses": 45,
            "meses_desde_ultimo_trabajo_registrado": 131,
            "antiguedad_ultimo_trabajo_registrado": 4,
            "monto_entidades_ultima_informacion": 862000.0,
            "peor_situacion_ultima_informacion_6m": 1,
            "peor_situacion_ultima_informacion_12m": 1,
            "peor_situacion_ultima_informacion_24m": 1,
            "peor_situacion_historico_6m": 1,
            "peor_situacion_historico_12m": 1,
            "peor_situacion_historico_24m": 1,
            "dni": "33221443"
        }
    },
    "result": "success"
}

Ejemplo devolviendo más de una política:

{
    "6f8df4de41": {
        "result": "pending",
        "name": "Politica Ejemplo",
        "webservice": "credixsa",
        "pending_variables": [
            {
                "moroso_vigente": "N"
            }
        ],
        "variables": {
            "existencia_validada": "SI",
            "nombre_validado": "SI",
            "cant_atrasos_vigentes_leves": "0",
            "cant_atrasos_vigentes_moderados": "0",
            "cant_atrasos_vigentes_severos": "0",
            "cant_atrasos_vigentes_muyseveros": "0",
            "cant_atrasos_leves_3m": "0",
            "cant_atrasos_leves_6m": "0",
            "atrasos_leves_12m": "0",
            "atrasos_leves_24m": "0",
            "atrasos_moderados_3m": "0",
            "cant_atrasos_moderados_6m": "0",
            "cant_atrasos_moderados_12m": "0",
            "cant_atrasos_moderados_24m": "0",
            "moroso_vigente": "N",
            "moroso_no_vigente": "N",
            "cant_situaciones_1": "1",
            "cant_situaciones_2": "0",
            "cant_situaciones_3": "0",
            "cant_situaciones_4": "0",
            "cant_situaciones_5": "0",
            "cant_situaciones_6": "0",
            "cant_refinanciaciones_vigentes": "0",
            "cant_situciones_juridicas": "0",
            "monto_adeudado_situaciones_1": "862000",
            "monto_adeudado_situaciones_2": "0",
            "monto_adeudado_situaciones_3": "0",
            "monto_adeudado_situaciones_4": "0",
            "monto_adeudado_situaciones_5": "0",
            "monto_adeudado_situaciones_6": "0",
            "monto_adeudado_refinanciaciones": "0",
            "monto_adeudado_situaciones_juridicas": "0",
            "monto_sin_fondo_sin_pago_multa": "0",
            "alerta_morosidad_id_credixsa": "N",
            "cant_5_dias": "0",
            "cant_30_dias": "0",
            "cant_5_dias_rechazadas_otras_entidades": "0",
            "cant_30_dias_rechazadas_otras_entidades": "0",
            "cant_entidades_5_dias": "0",
            "cant_entidades_30_dias": "0",
            "alerta_fallecido": "N",
            "dni": "33722997"
        }
    },
    "e61a2bdc7f": {
        "result": "success",
        "name": "Politica Ejemplo",
        "webservice": "rol",
        "variables": {
            "nombre": "PEDRO GONZALES CATALAN",
            "edad": 35,
            "fallecido": false,
            "jubilado": false,
            "jubilado_beneficio": false,
            "pep": false,
            "estado_cuit": "ACTIVO",
            "letra": 3,
            "nse": "",
            "empleado_publico": false,
            "empleados": 0,
            "trabajador_casa_particular": false,
            "prestacion_desempleo": false,
            "plan_social": false,
            "prestacion_provincial": false,
            "prestacion_nacional": false,
            "asignacion_universal": false,
            "progresar": false,
            "sin_mora_meses": 45,
            "meses_desde_ultimo_trabajo_registrado": 131,
            "antiguedad_ultimo_trabajo_registrado": 4,
            "monto_entidades_ultima_informacion": 862000.0,
            "peor_situacion_ultima_informacion_6m": 1,
            "peor_situacion_ultima_informacion_12m": 1,
            "peor_situacion_ultima_informacion_24m": 1,
            "peor_situacion_historico_6m": 1,
            "peor_situacion_historico_12m": 1,
            "peor_situacion_historico_24m": 1,
            "dni": "33221443"
        }
    },
    "result": "success"
}

En pending_variables tenemos las variables dan lugar al estado Evaluar/Rechazar para su análisis.

En variables tenemos el total de las variables con sus resultados para su análisis.


Motor de Decisión

Descripción: Permite evaluar una persona con distintas políticas.

Endpoint: `/api/method/dataprocess.engine.api.engine`

Método: `POST`

Parámetros:

  • sex: requerido. (M, F)

  • first_name: requerido.

  • last_name: requerido.

  • dni: requerido.

  • credixsa: Nombre (politic_name) o Codigo (name) de la política de Credixsa.

  • rol: Nombre (politic_name) o Codigo (name) de la política de ROL.

  • veraz: Nombre (politic_name) o Codigo (name) de la política de Veraz.

Importante: no es requerido ingresar valor en los tres servicios (credixsa, rol, veraz) pero si es obligatorio elegir uno.


Ejemplo de Solicitud:

curl --location 'https://dataprocess.com.ar/api/method/dataprocess.engine.api.engine' \
--header 'Authorization: Token f09167a3efe6012:a20cc5tf24343ad' \
--header 'Content-Type: application/json' \
--data '{
    "first_name": "Juan",
    "last_name":  "Perez",
    "dni": "44322887",
    "sex": "M",
    "credixsa": null,
    "rol": "ed05aa8e2a",
    "veraz": null
}'

Ejemplo de Respuesta:

  • Código de cada politica evaluada con su resultado de evaluación.

  • result: resultado general de la consulta a la API.

Resultado Aprobado

{
    "ed05aa8e2a": "success",
    "result": "success"
}

Resultado Evaluar

{
    "ed05aa8e2a": "pending",
    "result": "success"
}

Resultado Rechazado

{
    "ed05aa8e2a": "failure",
    "result": "success"
}


Errores y Manejo de Excepciones

Las siguientes situaciones pueden ocurrir en Dataprocess al momento de realizar una consulta:

  • Demora en la respuesta:

  • Límite de consultas: En este caso llegó al límite de las consultas que tiene disponible en su plan.

  • Código de Error 404: No encontrado - Recurso/DNI solicitado no existe.

  • Código de Error 500: Servicio momentaneamente no disponible, el servidor puede estar teniendo un inconveniente o estar actualizandose.

  • Validaciones sobre los datos ingresados, por ejemplo:

{
    "success": false,
    "msg": "Politica Rol e61a2bdc7fe inválida"
}

Referencias y Recursos Adicionales

En caso de tener una consulta específica o inconveniente con la integración, tiene los siguientes canales de comunicación

Documentación completa: Enlace a la documentación completa de la API

Soporte técnico: [email protected]

Comercial: [email protected]

Edit Page New Page Revisions Page Settings

Previous Page

Left

Next Page

Right

On this page