Prestamos Callcenter
by integracionesvendemas

Prestamos Callcenter

Colección de APIS para integración a prestamos callcenter
APIS Financiera

Conjunto de APIS que se requieren construir por parte de las financieras para integrarse a la plataforma de prestamos callcenter. El ambiente para realizar la prueba se encuentra en la siguiente ruta: http://prestamosmixtos.us-east-1.elasticbeanstalk.com/

Los usuarios serán generados por el area de IT Vendemas previa solicitud al equipo de producto

Notificar Contrato
POST /producto/vendemas-call
Obtener Oferta GET
GET /evaluar/preaprobados/{codigoComercio}
Obtener Oferta POST
POST /evaluar/preaprobados
Notificar Contrato
POST /producto/vendemas-call

La ruta de este endpoint es {{host}}/producto/vendemas-call Esta endpoint permite notificar la creación de un contrato creado desde el canal callcenter hacia la entidad financiera con el objetivo que pueda registrarlo en su plataforma, además de realizar el desembolso y recaudos para este comercio

Request body

ObjNotificarContratoReq

Responses

200 OK
Body
ObjNotificarContratoResp
Obtener Oferta GET
GET /evaluar/preaprobados/{codigoComercio}

La ruta de este endpoint es {{host}}/evaluar/preaprobados/{codigoComercio} Esta endpoint permite consultar a la entidad financiera si el comercio preaprobado a evaluar tiene ofertas disponibles asociadas.

Path variables

codigoComercio
string required

Codigo del comercio a evalular

Responses

200 OK
Body
ObjObtenerOfertaResp
Obtener Oferta POST
POST /evaluar/preaprobados

La ruta de este endpoint es {{host}}/evaluar/preaprobados Esta endpoint permite consultar a la entidad financiera si el comercio preaprobado a evaluar tiene ofertas disponibles asociadas.

Request body

ObjObtenerOfertaReq

Responses

200 OK
Body
ObjObtenerOfertaResp
Estructuras de entrada y salida
ObjNotificarContratoReq

Estructura de petición que se envía a la entidad financiera para notificar el contrato creado

Object
Example: 
{
    "fecha": "2022-06-14",
    "hora": "19:14:21",
    "cliente": "ENTIDAD",
    "programa": "ENTIDAD_CALLCENTER",
    "usuarioCallcenter": "gerardo@callcenter.com",
    "idContrato": 2803
    "datos": {
        "comercio": {
            "codigoComercio": "842048335",
            "tokenComercio": "NQAvADQALwAyADAAMgAwADYAOgAwADAAIABQAE0ATQBPAE0ATwBfAFMAQgBfADIAMAAxADkAOAA0ADcANgA4ADQANAA0ADEAMgAwADIAMAAtADAANQAtADAANAAyADAAMgAwAC0AMAA2AC0AMAAzADIANAA0ADkALgA4ADYA"
        },
        "contrato": {
            "inicio": "2022-06-01",
            "fin": "2023-12-01",
            "limite": 6280,
            "monto": 3140,
            "datoAdicional1": "",
            "datoAdicional2": "",
            "tipo": "callcenter"
        },
        "oferta": {
            "plazo": "9 mes(es)",
            "cantidadCuotas": 9,
            "valorCuota": 430,
            "montoPrestamo": 3140,
            "idOriginalOferta": "ABC-123836",
            "vigenciaPoder": "0",
            "tea": 10.25,
            "tem": 4.25,
            "tcea": 32.5,
            "base": "APROBADO"
        },
        "datosAdicionales": {
            "rutaAudio": "s3://marketplacevmasqa/Digitech/audios/842048335_2022_06_14_pool_prestamos.WAV",
            "fechaNacimiento": "1993-02-02",
            "flag_negocio_domicilio": 1,
            "ubigeo_negocio": "150104",
            "direccion_negocio": "avenida antunez d emayolo 1247",
            "referencia_negocio": "Frente al minimarket openplaz",
            "ubigeo_domicilio": "150121",
            "direccion_domicilio": "av del mercurio norte 111",
            "referencia_domicilio": "Al costado del banco covida",
            "estadoCivil": "CA",
            "genero": "M",
            "nacionalidad": 187,
            "correo": "gpdavilag@pucp.pe",
            "telefono": "989166938",
            "profesion": 4
        }
    }
}
fecha
string

Fecha de la petición

Example:
2022-06-14
hora
string

Hora de la petición

Example:
19:14:21
cliente
string

Código cliente de la entidad financiera

Example:
ENTIDAD
programa
string

Código programa de la entidad financiera

Example:
ENTIDAD_CALLCENTER
usuarioCallcenter
string

Usuario del callcenter quién realizo el contrato

Example:
gerardo@callcenter.com
datos
Object
comercio
Object
codigoComercio
string

Código del comercio del contrato creado

Example:
842048335
tokenComercio
string

Token de identificación unica del contrato creado

Example:
NQAvADQALwAyADAAMgAwADYAOgAwADAAIABQAE0ATQBPAE0ATwBfAFMAQgBfADIAMAAxADkAOAA0ADcANgA4ADQANAA0ADEAMgAwADIAMAAtADAANQAtADAANAAyADAAMgAwAC0AMAA2AC0AMAAzADIANAA0ADkALgA4ADYA
contrato
Object
inicio
string

Fecha de inicio del contrato

Example:
2022-06-01
fin
string

Fecha de fin del contrato

Example:
2023-12-01
limite
integer

Monto máximo de recaudo

Example:
6280
monto
integer

Monto de contrato

Example:
3140
datoAdicional1
string

Campo adicional 1

datoAdicional2
string

Campo adicional 2

tipo
string

tipo de contrato

Example:
callcenter
oferta
Object
plazo
string

Plazo del pago

Example:
9 mes(es)
cantidadCuotas
integer

Numero de cuotas

Example:
9
valorCuota
integer

Valor de la cuota

Example:
430
montoPrestamo
integer

Monto del prestamo ofrecido al cliente

Example:
3140
idOriginalOferta
string

código irignal de la oferta

Example:
ABC-123836
vigenciaPoder
integer
Enumeration:
1
0
tea
number

Tasa efectiva anual

Example:
10.25
tem
number

Tasa efectiva mensual

Example:
4.25
tcea
number

Tasa de Costo Efectivo Anual

Example:
32.5
base
string

Tipo de oferta

Enumeration:
APROBADO

Ofertas que vienen de la base de comercios que aceptaron TYC

PREAPROBADO

Ofertas que vienen de la base de comercios que no aceptaron TYC

datosAdicionales
Object
rutaAudio
string

Ruta de bucket AWS donde se almacenará el audio grabado del contrato creado

Example:
s3://marketplacevmasqa/Digitech/audios/842048335_2022_06_14_pool_prestamos.WAV
fechaNacimiento
string

Fecha de nacimiento del cliente

Example:
1993-02-02
flag_negocio_domicilio
integer

Valor que indica si el ubigeo, direccion y referencia entre

Enumeration:
1
0
ubigeo_negocio
string

Ubigeo del negocio

Example:
150104
direccion_negocio
string

Dirección del negocio

Example:
avenioda antunez d emayolo 1247
referencia_negocio
string

Referencia del negocio

Example:
al costado del restaurante don miguel
ubigeo_domicilio
string

Ubigeo del domcilio

Example:
150107
direccion_domicilio
string

Dirección del domicilio

Example:
avenida del mercurio norte 111
referencia_domicilio
string

Referencia del domicilio

Example:
al costado del banco mexicorp
estadoCivil
string

Tipo de estado civil

Enumeration:
SO

Soltero

CO

Conviviente

CA

Casado

VI

Viudo

DI

Divorciado

genero
string

Tipo de genero

Enumeration:
M

Masculino

F

Femenino

nacionalidad
integer

Tipo de nacionalidad

Enumeration:
187

PERU

correo
string

Correo del cliente

Example:
gpdavilag@pucp.pe
telefono
string

Número de telefono del cliente

Example:
989166938
profesion
integer

Profesion del cliente

Enumeration:
1

INGENIERO

show more
ObjNotificarContratoResp

Estructura que la entidad financiera responde al recibir la notificación del contrato

Object
Example: 
{
    "codeResponse": "00",
    "messageResponse": "success"
}
codeResponse
string

Código de respuesta

Enumeration:
00

Código de éxito

96

Código de error definido por la fintech

messageResponse
string

Mensaje de respuesta

Example:
success
ObjObtenerOfertaReq

Estructura que se envía a la entidad financiera para conocer si el comercio preaprobado tiene ofertas disponibles

Object
Example: 
{
    "codigoComercio":"844996798",
    "codigoComercioEncriptado":"748664992a67ed98fa"
}
codigoComercio
string

Codigo de comercio desencriptado preaprobado a evalular

Example:
844996798
codigoComercioEncriptado
string

Codigo de comercio encriptado preaprobado a evalular

Example:
748664992a67ed98fa
ObjObtenerOfertaResp

Estructura que la entidad financiera responde si presenta ofertas para el comercio preaprobado

Object
Example: 
{
   "fecha":"2022-08-23",
   "hora":"16:56:45",
   "cliente":"ENTIDAD",
   "programa":"ENTIDAD_CALLCENTER",
   "codigoRespuesta":"00",
   "mensajeRespuesta":"EXITO",
   "codigoComercio":"844996798",
   "preAprobados":[],
   "aprobados":[
      {
         "entidadId":"ENTIDAD",
         "programId":"ENTIDAD_CALLCENTER",
         "montoPrestamo":6560,
         "valorCuota":899.94,
         "idOriginalOferta":"1705070-37175",
         "cantidadCuotas":9,
         "fechaVigencia":"2022-08-31",
         "frecuenciaCobro":"Mensual",
         "tem":4.3662,
         "estado":"ACTIVO",
         "prioridad":1,
         "fechaCreacion":"2022-08-03T12:13:55.987394",
         "fechaInicio":"2022-08-03",
         "fechaFin":"2024-02-03",
         "tea":67,
         "montoTotalPagar":13120,
         "autenticacion":"[{\"pregunta\":\"¿Fecha Nacimiento (AAAA-MM-DD)?\",\"respuesta\":\"1991-08-23\"},{\"pregunta\":\"¿Nombre de Padre?\",\"respuesta\":\"ALDO\"},{\"pregunta\":\"¿Nombre de madre?\",\"respuesta\":\"SYILVIA\"},{\"pregunta\":\"¿Distrito de residencia?\",\"respuesta\":\"SANTIAGO DE SURCO\"}]",
         "plazo":9,
         "tcea":67
      },
      {
         "entidadId":"ENTIDAD",
         "programId":"ENTIDAD_CALLCENTER",
         "montoPrestamo":3780,
         "valorCuota":518.56,
         "idOriginalOferta":"1705070-37176",
         "cantidadCuotas":9,
         "fechaVigencia":"2022-08-31",
         "frecuenciaCobro":"Mensual",
         "tem":4.3662,
         "estado":"ACTIVO",
         "prioridad":1,
         "fechaCreacion":"2022-08-03T12:13:55.987394",
         "fechaInicio":"2022-08-03",
         "fechaFin":"2024-02-03",
         "tea":67,
         "montoTotalPagar":7560,
         "autenticacion":"[{\"pregunta\":\"¿Fecha Nacimiento (AAAA-MM-DD)?\",\"respuesta\":\"1991-08-23\"},{\"pregunta\":\"¿Nombre de Padre?\",\"respuesta\":\"ALDO\"},{\"pregunta\":\"¿Nombre de madre?\",\"respuesta\":\"SYILVIA\"},{\"pregunta\":\"¿Distrito de residencia?\",\"respuesta\":\"SANTIAGO DE SURCO\"}]",
         "plazo":9,
         "tcea":67
      },
      {
        "entidadId":"ENTIDAD",
         "programId":"ENTIDAD_CALLCENTER",
         "montoPrestamo":1000,
         "valorCuota":137.19,
         "idOriginalOferta":"1705070-37177",
         "cantidadCuotas":9,
         "fechaVigencia":"2022-08-31",
         "frecuenciaCobro":"Mensual",
         "tem":4.3662,
         "estado":"ACTIVO",
         "prioridad":1,
         "fechaCreacion":"2022-08-03T12:13:55.987394",
         "fechaInicio":"2022-08-03",
         "fechaFin":"2024-02-03",
         "tea":67,
         "montoTotalPagar":2000,
         "autenticacion":"[{\"pregunta\":\"¿Fecha Nacimiento (AAAA-MM-DD)?\",\"respuesta\":\"1991-08-23\"},{\"pregunta\":\"¿Nombre de Padre?\",\"respuesta\":\"ALDO\"},{\"pregunta\":\"¿Nombre de madre?\",\"respuesta\":\"SYILVIA\"},{\"pregunta\":\"¿Distrito de residencia?\",\"respuesta\":\"SANTIAGO DE SURCO\"}]",
         "plazo":9,
         "tcea":67
      }
   ]
}
fecha
string

Fecha de la petición

Example:
2022-08-23
hora
string

Hora de la petición

Example:
16:56:45
cliente
string

Código cliente de la entidad financiera

Example:
ENTIDAD
programa
string

Código programa de la entidad financiera

Example:
ENTIDAD_CALLCENTER
codigoRespuesta
string

Código de respuesta

Example:
00
mensajeRespuesta
string

Mensaje de respuesta

Example:
EXITO
codigoComercio
string

Código de comercio preaprobado

Example:
844996798
preAprobados
Array

Ofertas preaprobada

unknown
Example:
[]
aprobados
Array

Ofertas aprobadas disponibles para el comercio

Object
entidadId
string

Código cliente de la entidad financiera

Example:
ENTIDAD
programId
string

Código programa de la entidad financiera

Example:
ENTIDAD_CALLCENTER
montoPrestamo
integer

Monto de la oferta (Tambien usado para la creacion del contrato)

Example:
6560
valorCuota
number

Valor de la cuota

Example:
899.94
idOriginalOferta
string

id original de la oferta

Example:
1705070-37175
cantidadCuotas
integer

Numero de cuotas

Example:
9
fechaVigencia
string

Fecha de expiración de la oferta

Example:
2022-08-31
frecuenciaCobro
string

Frecuencia de cobro

Examples:
DiarioSemanalMensual
tem
number

Tasa efectiva mensual

Example:
4.3662
estado
string

Estado actual de la oferta

Example:
ACTIVO
prioridad
integer

Prioridad de la oferta

Example:
1
fechaCreacion
string

Fecha de creación de la oferta

Example:
2022-08-03 12:13:55
fechaInicio
string

Fecha inicio del contrato asociada a la oferta

Example:
2022-08-03
fechaFin
string

Fecha fin del contrato asociada a la oferta

Example:
2024-02-03
tea
integer

Tasa efectiva anual

Example:
67
montoTotalPagar
integer

Monto máximo a recaudar del contrato

Example:
13120
autenticacion
string

Arreglo de preguntas en string que permite verificar la autenticidad de la persona

Example:
[{"pregunta":"¿Fecha Nacimiento (AAAA-MM-DD)?","respuesta":"1991-08-23"},{"pregunta":"¿Nombre de Padre?","respuesta":"ALDO"},{"pregunta":"¿Nombre de madre?","respuesta":"SYILVIA"},{"pregunta":"¿Distrito de residencia?","respuesta":"SANTIAGO DE SURCO"}]
plazo
integer

Plazo total

Example:
9
tcea
integer

Tasa efectiva de costo anual

Example:
67
show more