Servicios API-BVQ (PICAVALCV) - V3

Av.
Amazonas 540 y Carrión

Edif. Londres, Piso.8
Telf.: (593 2) 3988-500
Quito - Ecuador
SERVICIOS API-BVQ
Diccionario de métodos, parámetros y resultados

Servicios Web de la BVQ
PICAVAL CASA DE VALORES S.A.
Versión [3.0]
CONFIDENCIAL
BOLSA DE VALORES DE QUITO
Servicios API-BVQ Versión [3.0]
Información del Documento

TÍTULO: SERVICIOS API-BVQ
SUBTÍTULO: Diccionario de métodos, parámetros y resultados Servicios web BVQ
VERSIÓN: [3.0]
ARCHIVO: Servicios API-BVQ (PICAVALCV)_V3.pdf
AUTOR: BOLSA DE VALORES DE QUITO
ESTADO: Definitivo
Lista de Cambios
VERSIÓN FECHA AUTOR DESCRIPCIÓN
1.0 2023-07-13 HRAC Documento Inicial (Ambiente TEST)
2.0 2023-10-04 HRAC Métodos vector de precios detallado y Emisiones calificación
3.0 2023-10-05 HRAC Método capitalización RV y Método máximos y mínimos
Firmas y Aprobaciones
ELABORADO POR: [Henrry Acosta]
[Analista Senior de Proyectos TI]
FECHA: [2023-10-05]
REVISADO POR: [Marcelo Aguilar]

[Gerente de Tecnología]
FECHA: [2023-10-05]
© BVQ CONFIDENCIAL Pág. 2 de 40

1. Servicios API-BVQ
ServiciosBvq: Capa sobre la cual esta creados los servicios de tipo REST en base a la
tecnología web api, los servicios se acceden a través de la siguiente URL más el método
solicitado.
http://10.10.1.6/ServiciosTEST/api/
▪ login/authenticate
▪ general/obtenerCatalogo
▪ general/obtenerActividadEconomica
▪ prevencion/obtenerListaComitente
▪ prevencion/obtenerInformacionComitente
▪ prevencion/gestionComitentePersonaNatural
▪ prevencion/gestionComitenteJuridica
▪ gestion/obtenerLibroOrdenes
▪ gestion/obtenerVectorPrecio
▪ gestion/obtenerMontosEmitidos
▪ gestion/ObtenerCapitalizacionRV
▪ gestion/ObtenerMaximosMinimos
2. Método: Autenticación
Método web que sirve para generar un token en función de las credenciales de
autenticación proporcionadas, este token servirá para poder consumir los métodos
anteriormente listados.
Syntax
http://10.10.1.6/ServiciosTEST/api/login/authenticate
2.1. Parámetros
Para el consumo de dicho servicio se debe enviar parámetros tipo JSON y como método de
invocación POST. Las credenciales asignadas para el cliente son las siguientes y el formato
del parámetro de envío es JSON.
{"Username":"picavaltest","Password":"P1c@v@+*"}
Consideraciones:
El tiempo de duración del token es de 24 horas, después de este tiempo se deberá generar
un nuevo token.
2.2. Return Value

Type: String
Como resultado este método devuelve una cadena de string correspondiente al token, el
mismo que se deberá utilizar para las futuras consultas a métodos subsiguientes, si el token
caducara se debería volver a consumir el servicio para obtener uno nuevo. Ejemplo de la
estructura del token:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiZnV0dXJvY3YiLCJyb2xlIjoiQUxMIiw
ibmJmIjoxNjIwMTQ4DFU4LCJleHAiOjE2MjAyMDI0NTgsImlhdCI6MTYyMDE0ODQ1OCwia
XNzIjoiaHR0cDovL2Z1dHVyb2N2LmJveDRkYXRhLmNvbSIsImF1ZCI6Imh0dHA6Ly9mdXR
1cm9jdi5ib3g0ZGF0YS5jb20ifQ.RaBAJx4ErJoae01J-WweLdoor2jZeG1bjJoDNlD_JeY"
3. Método: Obtener Catálogos
Método web que sirve para obtener los catálogos del sistema que se utilizan para la
creación de Personas Naturales y Personas Jurídicas, los catálogos disponibles son:
NOMBRE DEL CATÁLOGO CÓDIGO
▪ CAT_NOMBRE CAT_CODIGO
▪ TIPO IDENTIFICACION TIPO_IDENT
▪ DESCRIPCIONES POSICIONALES PRE_DESC_POSIC
▪ ESTADO CIVIL PRE_EST_CIV
▪ NACIONALIDAD PRE_NAC
▪ PAISES PAIS
▪ OCUPACIONES PRE_OCU
▪ CONCEPTOS DE INGRESOS PRE_CON_ING
▪ CONCEPTOS DE EGRESOS PRE_CON_EGR
▪ BANCOS PRE_BANK
▪ TIPOS DE CUENTA BANCARIA PRE_BANK_TYP
▪ PROVINCIA PRE_PROV
▪ CANTON PRE_CANT
▪ SEXO PRE_PER_SEX
▪ CIUDAD CIUDAD
▪ ESTADOS DE COMITENTE PER_EST_COMI
▪ DESCRIPCIONES POSICIONALES PRE_DESC_POSIC
▪ TIPO DE PERSONA JURÍDICA PRE_TIP_PER_JUR
▪ TIPO DE CUENTA COMITENTE PRE_TIP_CUE_COM
▪ TIPO EMAIL RETENCION CAT_TIPO_EMAIL_EFAC
▪ ORIGEN PATRIMONIO TIP_SOUR_PAT
▪ Descripción pasivo cliente DESC_PASIVO_CL
▪ BIENES INMUEBLES PRE_BIE_INM
▪ BIENES MUEBLES PRE_BIE_MUE
▪ CONCEPTOS DE INGRESOS PRE_CON_ING
▪ CONCEPTOS DE EGRESOS PRE_CON_EGR
▪ Origen pasivo cliente ORIGEN_PASIVO_CL
▪ TIPO DE CUENTA BANCARIA TIPO_CTA_BAN
▪ CATEGORIA COMITENTE SGN CV PRE_CTC_CAT
▪ EMISORES DE TARJETAS PRE_EMI_TAR
▪ PARENTESCO PRE_TIP_REL_PER
▪ CARGO CARGO
▪ TIPO DE PERSONA PRE_TIP_PER
Syntax

http://10.10.1.6/ServiciosTEST/api/general/obtenerCatalogo
3.1. Parameters
invocación POST.
{"Codigo":"PRE_BANK, PRE_CANT"}
En donde los valores de los parámetros es el código de los catálogos listados anteriormente
y que se encuentran disponibles. Los códigos para solicitar deben ir separados por (,).
3.2. Return Value

Type: JSON
Vector de Objetos en formato Json

{
"PRE_PER_SEX": [
{
"ITC_ID": 256,
"CAT_ID": 92,
"ITC_NOMBRE": "MASCULINO",
"ITC_CODIGO": "PRE_SEX_MAS",
"ITC_DESCRIPCION": "MASCULINO",
"ITC_VALOR": "MASCULINO",
"ITC_ESTADO": 21
},
{
"ITC_ID": 257,
"CAT_ID": 92,
"ITC_NOMBRE": "FEMENINO",
"ITC_CODIGO": "PRE_SEX_FEM",
"ITC_DESCRIPCION": "FEMENINO",
"ITC_VALOR": "FEMENINO",
"ITC_ESTADO": 21
}
]
}
3.3. Atributos del Objeto JSON

ITC_ID: ID principal del ítem del catálogo.
CAT_ID: Código interno de la tabla padre catálogo.
ITC_NOMBRE: Nombre del catálogo.
ITC_CODIGO: Código alfanumérico correspondiente al Ítem catálogo.
ITC_DESCRIPCION: Breve definición correspondiente al catálogo en cuestión.
ITC_VALOR: Se almacena el valor con el cual se va a trabajar dicho catálogo.
ITC_ESTADO: Estado en el que se encuentra el elemento 21 es Activo y 22 Inactivo.
4. Método: Obtener Actividad Económica
Método web que sirve para obtener un listado de las actividades económicas.
Syntax
http://10.10.1.6/ServiciosTEST/api/prevencion/obtenerActividadEconomica
4.1. Return Value

Type: JSON

[
{
"ACE_ID": 1,
"ACE_CODIGO": "001",
"ACE_DESCRIPCION": "Cultivo de banano café y cacao",
"ACE_DETALLE": false,
"ACE_DESC_OMOLOGADO": null
},
{
"ACE_ID": 2,
"ACE_CODIGO": "001001",
"ACE_DESCRIPCION": "Cultivo de banano, café y cacao",
"ACE_DETALLE": false,
"ACE_DESC_OMOLOGADO": null
},

ACE_ID: ID de registro
ACE_CODIGO: Código de actividad económica
ACE_DESCRIPCION: Descripción de actividad económica
ACE_DETALLE: Tipo de registro (true=grupo false=detalle)
ACE_DESC_OMOLOGADO: Campo reservado
5. Método: Obtener Lista Comitentes
Método web que sirve para obtener un listado de los comitentes registrados en el sistema.
Syntax
http://10.10.1.6/ServiciosTEST/api/prevencion/obtenerListaComitente
5.1. Parameters
invocación POST.
{"PAGINA":0}
En donde el valor del parámetro es el número de página que se necesita recuperar, en este
caso 0, recupera la primera paginación de 30 registros (parámetro de paginación Sicav).
Si se necesita consultar todos los registros debemos enviar en el parámetro -1, ejemplo:
{"PAGINA":-1}
5.2. Return Value

Type: JSON
{
"CLIENTES": [
{
"RowNumber": 1,
"PERSONA": "EJEMPLO",
"IDENTIFICACION": "110564487915",
"CTC_ESTADO": "Comitente Activo",
"CTC_CODIGO": "CTA_COM 00125",
"CTC_TIPO_CUENTA_NOMBRE": "Persona jurídica",

"CTC_TIPO_CUENTA": "PRE_TIP_CUE_JUR",
"CTC_ID": 629,
"ESTADO": 357,
"CTC_ESTADO_COD": "A"
},
{
"RowNumber": 2,
"PERSONA": "EJEMPLO",
"IDENTIFICACION": "110564487912",
"CTC_ESTADO": "Comitente Activo",
"CTC_TIPO_CUENTA_NOMBRE": "Persona jurídica",
"CTC_TIPO_CUENTA": "PRE_TIP_CUE_JUR",
"CTC_ID": 628,
"ESTADO": 357,
"CTC_ESTADO_COD": "A"
},

RowNumber: Número de registro
PERSONA: Razón social o nombre de la persona
IDENTIFICACION: RUC o Identificación del comitente
CTC_ESTADO: Estado del Cliente “Comitente Activo” o “Comitente Inactivo”
CTC_CODIGO: Cuenta comitente
CTC_TIPO_CUENTA_NOMBRE: Nombre tipo de cuenta “Persona jurídica” o “Natural individual”
CTC_TIPO_CUENTA: Código tipo de cuenta "PRE_TIP_CUE_JUR" o "PRE_TIP_CUE_NAT_IND"
CTC_ID: ID cuenta comitente
ESTADO: Código de estado de cuenta comitente (357=Comitente Activo 358=Comitente Inactivo)
CTC_ESTADO_COD: Abreviatura de estado cuenta comitente (A=Activo I=Inactivo)
6. Método: Obtener Comitentes por ID
Método web que sirve para obtener información general y detallada de un comitente.
Syntax
http://10.10.1.6/ServiciosTEST/api/prevencion/obtenerInformacionComitente
6.1. Parameters
invocación POST.
Persona Natural {"ID":637}

Persona Jurídica {"ID":639}
En donde el valor del parámetro es el ID del comitente a recuperar, referencia “CTC_ID” del
método obtenerListaComitente.
6.2. Return Value

Type: JSON
JSON – Persona Natural

{
"PERSONA_NATURAL": [
{

"PNA_ID": 1165,
"CTC_ID": null,
"PNA_DIRECCION_CORRESPONCIA": "JUNIN Y PEDRO CARBO",
"PNA_DIRECCION_DOMICILIO": "MIRTOS E HIGUERAS",
"PNA_DIRECCION_TRABAJO": "9 DE OCTUBRE Y PEDRO CARBO",
"PNA_ESTADO_CIVIL": 259,
"PNA_FECHA_NACIMIENTO": "1988-11-20T13:08:59",
"PNA_IDENTIFICACION": "0926806720",
"PNA_NACIONALIDAD": 1184,
"PNA_TIPO_IDENTIFICACION": 90,
"PNA_OCUPACION": 298,
"PNA_POLITICAMENTE": 0,
"PNA_PRIMER_APELLIDO": "VILLACIS",
"PNA_SEGUNDO_APELLIDO": "VARGAS",
"PNA_PRIMER_NOMBRE": "PATRICIO",
"PNA_SEGUNDO_NOMBRE": "EFRAIN",
"PNA_TELEFONO_DOMICILIO": "042883377",
"PNA_TELEFONO_OFICINA": "042992266",
"PNA_SEXO": 256,
"PNA_RELACION_DEPENDENCIA": 0,
"PNA_INSTITUCION_DEPENDENCIA": "",
"PNA_JURIDICA_FAX": "042333444",
"PNA_EMAIL": "[email protected]",
"PNA_TELEFONO_CELULAR": "042001155",
"PNA_ID_CONYUGE": null,
"PNA_RUC": null,
"PNA_LUGAR_TRABAJO": null,
"PNA_CIUDAD": 6,
"PNA_PROVINCIA": 1107,
"PNA_CANTON": 1116,
"PNA_OBSERVACIONES": "",
"PNA_IS_PEP": false,
"PNA_IS_BLACK_LIST": false,
"PNA_LIST_OFAC": "",
"PNA_PAIS_RESIDENCIA": 1184,
"PNA_FECHA_ULTIMA_ACT": "2021-05-06T13:54:11.07",
"PNA_ACTUALIZA_USR": 6,
"PNA_LUGAR_NATAL": 1184,
"PNA_NACIONALIDAD_MULTIPLE": 0,
"PNA_ID_CONTACTO": 1,
"PNA_SEPARA_BIENES": 0,
"CANTON_RESIDENCIA_DESCRIPCION": "GUAYAQUIL",
"NACIONALIDAD_DESCRIPCION": "ECUADOR",
"OCUPACION_DESCRIPCION": "INGENIERO",
"TIPO_IDENTIFICACION": "CEDULA",
"DESCRIPCION_ESTADO_CIVIL": "CASADO",
"DESCRIPCION_POSICIONAL": "INDEPENDIENTE",
"LUGAR_NATALICIO": "ECUADOR",
"GENERO": "MASCULINO",
"TIPO_IDENTIFICACION1": "CEDULA",
"PROVINCIA": "GUAYAS",
"CIUDAD": "GUAYAQUIL",
"PAIS_RESIDENCIA": "ECUADOR",
"PAIS_RESIDENCIA_CODIGO": "ECS"
}
],
"PERSONAPODER_PERSONA": [],
"PERSONA_NATURALCOLECTIVIDAD": [],
"CUENTA_COMITENTE": [
{
"CTC_ID": 637,
"RPL_ID": null,
"SUC_ID": 1,
"PNA_ID": 1165,
"COL_ID": null,
"CTC_ESTADO": 357,
"CTC_RECEPCION_DOCUMENTOS": false,
"CTC_TIPO_CUENTA": 249,
"CTC_TOTAL_MUEBLES": 0.0,
"CTC_TOTAL_INMUEBLES": 20000.0,
"CTC_TOTAL_EGRESOS": 1500.0,
"CTC_TOTAL_INGRESOS": 2000.0,
"CTC_ANTICIPO": true,
"CTC_DESCRIPCION_ACTIVIDAD": "S01082: INGENIERO",
"CTC_OBJETO_SOCIAL": null,
"CTC_DESCRIPCION_POSICIONAL": 804,

"CTC_PORCENTAJE_COMISION": 0.0,
"CTC_PORCENTAJE_ANTICIPATION": 0.0,
"PAL_ID": null,
"CTC_IS_PEP": false,
"CTC_IS_BLACK_LIST": false,
"CTC_FECHA_ULTIMA_ACT": "2021-05-06T13:29:39.303",
"CTC_ACTUALIZA_USR": 6,
"CTC_BLACK_LIST_AUT": null,
"CTC_TOTAL_PASIVO": 75000.0,
"ACE_CODIGO": "S01082",
"CTC_CATEGORIA": 4844,
"CTC_FECHA_ACT_FORMULARIO": null,
"CTC_RESPONSABLE_FORMULARIO": -1,
"CTC_OBSERVACIONES_FORMULARIO": "",
"CTC_APLICA_ACC_DESGLOSE": -1,
"CTC_FECHA_BALANCES_AUDITADOS": null,
"CTC_FECHA_DECLARACION_SRI": null,
"CTC_FECHA_CREACION": "2021-05-06T13:11:37.417",
"CTC_BOLSA_COTIZA": "",
"CTC_INSCRITO_EN_CPMV": false,
"CTC_TIPO_EMPRESA": "",
"CTC_BAJO_CONTROL_DE_SUPER_DE_BANCOS": false,
"CTC_TIPO_PRODUCTO": null,
"CTC_OBSERVACIONES_PEPS": null,
"CTC_OBSERVACIONES_VINCULANTE": null,
"CTC_AGENTE_RETENCION": false,
"CTC_CATEGORIA_NOMBRE": "Conservador CP Activo",
"CTC_DESCRIPCION_POSICIONAL_VALOR": "INDEPENDIENTE",
"CTC_IS_BLACK": false,
"CTC_LIST_PEP_BL": "",
"USR_ALIAS": "ADMIN",
"CTC_BLACK_LIST_AUT1": null
}
],
"PERSONA_JURIDICA": [],
"REPRESENTANTE_LEGAL": [],
"PERSONA_NATURALPERSONA_JURIDICA": [],
"PERSONA_NATURALREPRESENTANTE_LEGAL": [],
"COLECTIVIDAD": [],
"PERSONA_COLECTIVIDAD": [],
"PODER_PERSONA": [],
"CUENTA_BANCARIA": [
{
"CTB_ID": 23,
"CTC_ID": 637,
"CTB_BANCO": "BPRD",
"CTB_BANCO_VALOR": "BANCO PRODUBANCO",
"CTB_TIPO": "AHO",
"CTB_PAIS": "ECU",
"CTB_PAIS_VALOR": "593",
"CTB_CIUDAD_APERTURA": -1,
"CTB_NUMERO_CUENTA": "18053605016036",
"PAIS_APERTURA": "ECUADOR",
"CTB_NOMBRE": ""
},
{
"CTB_ID": 24,
"CTC_ID": 637,
"CTB_BANCO": "BGYE",
"CTB_BANCO_VALOR": "BANCO GUAYAQUIL",
"CTB_TIPO": "CTE",
"CTB_PAIS": "ECU",
"CTB_PAIS_VALOR": "593",
"CTB_CIUDAD_APERTURA": -1,
"CTB_NUMERO_CUENTA": "36200721258",
"PAIS_APERTURA": "ECUADOR",
"CTB_NOMBRE": ""
}
],
"TARJETA_CREDITO": [
{
"TJC_ID": 18,
"CTC_ID": 637,
"TJC_FECHA_VENCIMIENTO": "2023-05-06T00:00:00",
"TJC_NUMERO_TARJETA": "36082525251036",
"TJC_TIPO_TARJETA": "CRE",
"TJC_MIEMBRO_DESDE": "2019-05-06T00:00:00",

"TJC_EMISOR_TARJETA": "DIN"
},
{
"TJC_ID": 19,
"CTC_ID": 637,
"TJC_FECHA_VENCIMIENTO": "2022-05-06T00:00:00",
"TJC_NUMERO_TARJETA": "18056965698",
"TJC_TIPO_TARJETA": "DEB",
"TJC_MIEMBRO_DESDE": "2020-05-06T00:00:00",
"TJC_EMISOR_TARJETA": "VISA"
}
],
"INGRESO_EGRESO_CLIENTECTC_TOTAL_INGRESOS": [
{
"IEC_CONCEPTO": "ING_VAR",
"MON_ID": 1,
"IEC_VALOR": 2000.0,
"IEC_VALOR_MONEDA_LOCAL": 2000.0,
"CTC_ID": 637,
"IEC_ID": 41,
"IEC_TIPO": "I",
"SIMBOLO": "$",
"SIMBOL_MONL": "$",
"DESCRIPCION_CONCEPTO": "TOTAL INGRESOS"
}
],
"INGRESO_EGRESO_CLIENTECTC_TOTAL_EGRESOS": [
{
"IEC_CONCEPTO": "EGR_VARIOS",
"MON_ID": 1,
"IEC_VALOR": 1500.0,
"IEC_VALOR_MONEDA_LOCAL": 1500.0,
"CTC_ID": 637,
"IEC_ID": 42,
"IEC_TIPO": "E",
"SIMBOLO": "$",
"SIMBOL_MONL": "$",
"DESCRIPCION_CONCEPTO": "TOTAL EGRESOS"
}
],
"ACTIVO_CLIENTECTC_TOTAL_INMUEBLES": [
{
"ACC_DESCRIPCION": "TAC",
"ACC_ORIGEN_PATRIMONIO": "TRABAJO",
"MON_ID": 1,
"ACC_AVALUO": 20000.0,
"ACC_VALOR_MONEDA_LOCAL": 20000.0,
"CTC_ID": 637,
"ACC_ID": 34,
"ACC_TIPO_ACTIVO": "I",
"SIMBOLO": "$",
"SIMBOL_MONL": "$"
}
],
"ACTIVO_CLIENTECTC_TOTAL_MUEBLES": [],
"ACCIONISTA": [],
"PERSONA_NATURALCONYUGE": [],
"PERSONA_COLECTIVIDADCONYUGE": [],
"DOC_COMITENTE": [],
"PASIVO_CLIENTE_CTC_TOTAL_PASIVO": [
{
"PAS_DESCRIPCION": "TOT_PAS",
"PAS_ORIGEN": "ORG_PAS_BAN",
"MON_ID": 1,
"PAS_MONTO": 75000.0,
"PAS_VALOR_MONEDA_LOCAL": 75000.0,
"CTC_ID": 637,
"PAS_ID": 17,
"PAS_TIPO": " ",
"SIMBOLO": "$",
"SIMBOL_MONL": "$"
}
],
"COMITENTE_EMAIL": [
{
"CEM_ID": 141,

"CEM_PRINCIPAL": true,
"CEM_CONTACTO": "TEST",
"CEM_EMAIL": "[email protected]",
"CEM_ESTADO": "A",
"CEM_TIPO": 5038,
"CEM_TIPO_NOMBRE": "Todos"
},
{
"CEM_ID": 142,
"CEM_PRINCIPAL": false,
"CEM_CONTACTO": "TEST2",
"CEM_EMAIL": "[email protected]",
"CEM_ESTADO": "A",
"CEM_TIPO": 5038,
"CEM_TIPO_NOMBRE": "Todos"
}
],
"COMITENTE_NACIONALIDAD": [
{
"CTN_ID": 0,
"CTC_ID": 637,
"NAC_ID": 1343,
"CTN_FECHA_ACTUALIZACION": "2021-05-06T13:17:07",
"ITC_VALOR": "DOMINICA",
"CTN_ESTADO": "Q"
},
{
"CTN_ID": 1,
"CTC_ID": 637,
"NAC_ID": 1171,
"ITC_VALOR": "COSTA RICA",
"CTN_ESTADO": "Q"
},
{
"CTN_ID": 2,
"CTC_ID": 637,
"NAC_ID": 1343,
"CTN_ESTADO": "Q"
},
{
"CTN_ID": 3,
"CTC_ID": 637,
"NAC_ID": 1343,
"CTN_ESTADO": "Q"
}
],
"INFORMACION_CRS": [],
"PERSONA_NATURALPERSONA": [
{
"PNC_ID": 1,
"PNA_ID": 1165,
"PNC_PRIMER_APELLIDO": "RUALES",
"PNC_SEGUNDO_APELLIDO": "GAIBOR",
"PNC_PRIMER_NOMBRE": "JUAN",
"PNC_SEGUNDO_NOMBRE": "PABLO",
"PNC_DIRECCION": "MIRTOS E GUAYACANES",
"PNC_EMAIL": "[email protected]",
"PNC_TELEFONO": "02389486",
"PNC_PARENTESCO": 4896,
"PNC_FECHA_REGISTRO": "2021-05-06T13:20:50.277",
"USR_ID": 6,
"NOMBRE_COMPLETO": "RUALES GAIBOR JUAN PABLO",
"PNC_PARENTESCO_DESCRIPCION": "TIOS"
}
],
"COMITENTE_COMISIONISTA": [],
"PREGUNTAS_RESPUESTAS": [
{
"PCFG_ID": 1,
"PCFG_PREGUNTA": "¿Cuál es su objetivo al realizar esta inversión?",
"RCFG_ID": 1,
"RCFG_OPCION": "Especulación",

"checked": 0
},
{
"PCFG_ID": 1,
"RCFG_ID": 2,
"RCFG_OPCION": "Crecimiento Ingresos",
"checked": 0
},
{
"PCFG_ID": 1,
"RCFG_ID": 3,
"RCFG_OPCION": "Protección de Capital",
"checked": 0
},
{
"PCFG_ID": 2,
"PCFG_PREGUNTA": "¿Cuál es su edad?",
"RCFG_ID": 4,
"RCFG_OPCION": "Menos de 30 años",
"checked": 0
},
{
"PCFG_ID": 2,
"RCFG_ID": 5,
"RCFG_OPCION": "Entre 30 y 50 años",
"checked": 0
},
{
"PCFG_ID": 2,
"RCFG_ID": 6,
"RCFG_OPCION": "Más de 50 años",
"checked": 0
},
{
"PCFG_ID": 3,
"PCFG_PREGUNTA": "¿Por cuánto tiempo tiene la intención de mantener la in
versión?",
"RCFG_ID": 7,
"RCFG_OPCION": "Menos de un año",
"checked": 0
},
{
"PCFG_ID": 3,
versión?",
"RCFG_ID": 8,
"RCFG_OPCION": "Entre 1 año y 3 años",
"checked": 0
},
{
"PCFG_ID": 3,
versión?",
"RCFG_ID": 9,
"RCFG_OPCION": "Más de 3 años",
"checked": 0
},
{
"PCFG_ID": 4,
"PCFG_PREGUNTA": "¿Planea retirar su dinero?",
"RCFG_ID": 10,
"RCFG_OPCION": "No",
"checked": 0
},
{
"PCFG_ID": 4,
"RCFG_ID": 11,
"RCFG_OPCION": "Si, pero menos de 15 % de esta inversión",
"checked": 0
},
{
"PCFG_ID": 4,


"RCFG_ID": 12,
"RCFG_OPCION": "Si, y 15% o más de esta inversión",
"checked": 0
},
{
"PCFG_ID": 5,
"PCFG_PREGUNTA": "¿Cómo describiría sus futuros ingresos en los próximos
5 años?",
"RCFG_ID": 13,
"RCFG_OPCION": "Incrementándose",
"checked": 0
},
{
"PCFG_ID": 5,
5 años?",
"RCFG_ID": 14,
"RCFG_OPCION": "Manteniéndose",
"checked": 0
},
{
"PCFG_ID": 5,
5 años?",
"RCFG_ID": 15,
"RCFG_OPCION": "Decreciendo",
"checked": 0
},
{
"PCFG_ID": 6,
"PCFG_PREGUNTA": "¿Con respecto al monto de dinero que quiere invertir, q
ue porcentaje de sus bienes líquidos totales (excluyendo su casa y negocio) represent
a?",
"RCFG_ID": 16,
"RCFG_OPCION": "Menos de 50%",
"checked": 0
},
{
"PCFG_ID": 6,
a?",
"RCFG_ID": 17,
"RCFG_OPCION": "Entre 50% y 75%",
"checked": 0
},
{
"PCFG_ID": 6,
a?",
"RCFG_ID": 18,
"RCFG_OPCION": "Más del 75%",
"checked": 0
},
{
"PCFG_ID": 7,
"PCFG_PREGUNTA": "Uno debría tener fondos disponibles, de por lo menos 6
meses, de sus gastos en caso de una emergencia. ¿Aparte de lo que quiere invertir, ti
ene fondos de emergencia?",
"RCFG_ID": 19,
"RCFG_OPCION": "Si",
"checked": 0
},
{
"PCFG_ID": 7,
"PCFG_PREGUNTA": "Uno debría tener fondos disponibles, de por lo menos 6
meses, de sus gastos en caso de una emergencia. ¿Aparte de lo que quiere invertir, ti
ene fondos de emergencia?",
"RCFG_ID": 20,
"RCFG_OPCION": "No",
"checked": 0
},
{
"PCFG_ID": 8,

"PCFG_PREGUNTA": "¿A cuál de los siguientes criterios le daría Ud. Prefer

encia en sus inversiones?",
"RCFG_ID": 21,
"RCFG_OPCION": "Seguridad",
"checked": 0
},
{
"PCFG_ID": 8,
"RCFG_ID": 22,
"RCFG_OPCION": "Liquidez",
"checked": 0
},
{
"PCFG_ID": 8,
"RCFG_ID": 23,
"RCFG_OPCION": "Rentabilidad",
"checked": 0
},
{
"PCFG_ID": 9,
"PCFG_PREGUNTA": "Su experiencia en inversiones puede describirse mejor c
omo:",
"RCFG_ID": 24,
"RCFG_OPCION": "Limitada",
"checked": 0
},
{
"PCFG_ID": 9,
omo:",
"RCFG_ID": 25,
"RCFG_OPCION": "Buena",
"checked": 0
},
{
"PCFG_ID": 9,
omo:",
"RCFG_ID": 26,
"RCFG_OPCION": "Profesional",
"checked": 0
},
{
"PCFG_ID": 10,
"PCFG_PREGUNTA": "Años de Experiencia",
"RCFG_ID": 27,
"RCFG_OPCION": "Menor a un año",
"checked": 0
},
{
"PCFG_ID": 10,
"PCFG_PREGUNTA": "Años de Experiencia",
"RCFG_ID": 28,
"RCFG_OPCION": "Mayor a un año",
"checked": 0
}
],
"COMITENTE_PEP_PARENTESCO": []
}.
PERSONA_NATURAL: Contiene información detallada de la persona natural
PNA_ID: ID principal de persona natural

CTC_ID: ID cuenta comitente (null cuando es persona natural)
PNA_DIRECCION_CORRESPONCIA: Dirección de correspondencia persona natural
PNA_DIRECCION_DOMICILIO: Dirección de domicilio persona natural
PNA_DIRECCION_TRABAJO: Dirección de trabajo persona natural
PNA_ESTADO_CIVIL: Estado civil (Catálogo - ESTADO CIVIL “PRE_EST_CIV”)
PNA_FECHA_NACIMIENTO: Fecha de Nacimiento
PNA_IDENTIFICACION: Identificación de la persona

PNA_NACIONALIDAD: Nacionalidad (Catálogo – NACIONALIDAD “PRE_NAC”)

PNA_TIPO_IDENTIFICACION: Tipo de Identificación (Catálogo - TIPO IDENTIFICACION “TIPO_IDENT”)
PNA_OCUPACION: Ocupación (Catálogo – OCUPACIONES “PRE_OCU”)
PNA_POLITICAMENTE: Políticamente expuesta (0=No 1=Si)
PNA_PRIMER_APELLIDO: Primer apellido
PNA_SEGUNDO_APELLIDO: Segundo apellido
PNA_PRIMER_NOMBRE: Primer nombre
PNA_SEGUNDO_NOMBRE: Segundo nombre
PNA_TELEFONO_DOMICILIO: Teléfono domicilio
PNA_TELEFONO_OFICINA: Teléfono oficina
PNA_SEXO: Sexo (Catálogo – SEXO “PRE_PER_SEX”)
PNA_RELACION_DEPENDENCIA: Si tiene relación de dependencia (0=No 1=Si)
PNA_INSTITUCION_DEPENDENCIA: Institución de dependencia
PNA_JURIDICA_FAX: Número de fax
PNA_EMAIL: Correo electrónico
PNA_TELEFONO_CELULAR: Teléfono celular
PNA_ID_CONYUGE: ID del conyugue (ID relacionado a persona)
PNA_RUC: Ruc
PNA_LUGAR_TRABAJO: Lugar de trabajo
PNA_CIUDAD: Ciudad (Catálogo – CIUDAD “CIUDAD”)
PNA_PROVINCIA: Provincia (Catálogo – PROVINCIA “PRE_PROV”)
PNA_CANTON: Cantón (Catálogo – CANTON “PRE_CANT”)
PNA_OBSERVACIONES: Observaciones (campo libre)
PNA_IS_PEP: Políticamente expuesta (Si=true No=false)
PNA_IS_BLACK_LIST: Políticamente expuesta (Si=true No=false)
PNA_LIST_OFAC: Listas blancas (Si=true No=false)
PNA_PAIS_RESIDENCIA: País de residencia (Catálogo – PAIS “PAIS”)
PNA_FECHA_ULTIMA_ACT: Fecha de última actualización
PNA_ACTUALIZA_USR: ID usuario actualización (ID método Usuarios)
PNA_LUGAR_NATAL: Lugar de nacimiento (Catálogo – NACIONALIDAD “PRE_NAC”)
PNA_NACIONALIDAD_MULTIPLE: Nacionalidad múltiple (0=Si 1=No)
PNA_ID_CONTACTO: ID contacto (relacionar con ID persona natural)
PNA_SEPARA_BIENES: Separación de bienes (0=Si 1=No)
CANTON_RESIDENCIA_DESCRIPCION: Cantón de residencia (Catálogo “PRE_CANT”)
NACIONALIDAD_DESCRIPCION: Descripción nacionalidad
OCUPACION_DESCRIPCION: Descripción ocupación
TIPO_IDENTIFICACION: Tipo de identificación (Catálogo “TIPO_IDENT”)
DESCRIPCION_ESTADO_CIVIL: Descripción estado civil
DESCRIPCION_POSICIONAL: Descripción posicional
LUGAR_NATALICIO: Lugar de nacimiento (Catálogo “PRE_NAC”)
GENERO: Genero (Catálogo “PRE_PER_SEX”)
TIPO_IDENTIFICACION1: Tipo de identificación (Catálogo “TIPO_IDENT”)
PROVINCIA: Descripción provincia
CIUDAD: Descripción ciudad
PAIS_RESIDENCIA: Descripción país de residencia
PAIS_RESIDENCIA_CODIGO: Siglas país de residencia
PERSONAPODER_PERSONA: PN-no contiene información

PERSONA_NATURALCOLECTIVIDAD: PN-no contiene información
CUENTA_COMITENTE: Contiene información de la cuenta comitente (sección principal)

RPL_ID: ID representante legal (null cuando es PN)
SUC_ID: ID sucursal (1=sucursal principal)
PNA_ID: ID persona natural (relación con ID persona natural)
COL_ID: ID colectividad (null cuando es PN sin colectividad)
CTC_CODIGO: Código de cuenta comitente (autogenerado)
CTC_ESTADO: Estado de la cuenta comitente (Catálogo - ESTADOS DE COMITENTE “PER_EST_COMI”)
CTC_RECEPCION_DOCUMENTOS: Recepción de documentos (Si=true No=false)
CTC_TIPO_CUENTA: Tipo de cuenta (Catálogo - TIPO DE CUENTA COMITENTE “PRE_TIP_CUE_COM”)
CTC_TOTAL_MUEBLES: Total muebles (campo auto calculado)
CTC_TOTAL_INMUEBLES: Tota inmuebles (campo auto calculado)
CTC_TOTAL_EGRESOS: Total egresos (campo auto calculado)
CTC_TOTAL_INGRESOS: Total ingresos (campo auto calculado)
CTC_ANTICIPO: Requiere anticipo (Si=true No=false)
CTC_DESCRIPCION_ACTIVIDAD: Descripción actividad (referencia método actividades 227)
CTC_OBJETO_SOCIAL: Objeto Social
CTC_DESCRIPCION_POSICIONAL: Descripción posicional (Catálogo - DESCRIPCIONES POSICIONALES
“PRE_DESC_POSIC”)
CTC_PORCENTAJE_COMISION: Porcentaje comisión operador
CTC_PORCENTAJE_ANTICIPATION: Porcentaje comisión requerido
PAL_ID: ID Reservado (enviar null)
CTC_IS_PEP: Persona expuesta políticamente (Si=true No=false)
CTC_IS_BLACK_LIST: Se encuentra en listas negras (Si=true No=false)
CTC_FECHA_ULTIMA_ACT: Fecha de última actualización

CTC_ACTUALIZA_USR: Usuario de actualización (ID método de Usuarios)

CTC_BLACK_LIST_AUT: Listas autorizadas (campo autogenerado)
CTC_TOTAL_PASIVO: Total pasivos (campo auto calculado)
ACE_CODIGO: Código CIIU (Código de método Actividades Económicas 227)
CTC_CATEGORIA: Categoría (Catálogo - CATEGORIA COMITENTE SGN CV “PRE_CTC_CAT”)
CTC_FECHA_ACT_FORMULARIO: Fecha formulario (campo reservado)
CTC_RESPONSABLE_FORMULARIO: Responsable formulario (campo reservado)
CTC_OBSERVACIONES_FORMULARIO: Observaciones formulario (campo reservado)
CTC_APLICA_ACC_DESGLOSE: Aplica desglose (campo reservado)
CTC_FECHA_BALANCES_AUDITADOS: Fecha balance auditado (campo reservado)
CTC_FECHA_DECLARACION_SRI: Fecha declaración (campo reservado)
CTC_FECHA_CREACION: Fecha de creación
CTC_BOLSA_COTIZA: Cotiza bolsa (campo reservado)
CTC_INSCRITO_EN_CPMV: Inscrito CPMV (campo reservado)
CTC_TIPO_EMPRESA: Tipo de empresa (campo reservado)
CTC_BAJO_CONTROL_DE_SUPER_DE_BANCOS: Control super de bancos (campo reservado)
CTC_TIPO_PRODUCTO: Tipo de producto (campo reservado)
CTC_OBSERVACIONES_PEPS: Observación PEPS (campo reservado)
CTC_OBSERVACIONES_VINCULANTE: Observaciones Vinculante (campo reservado)
CTC_AGENTE_RETENCION: Agente retención (Si=true No=false)
CTC_CATEGORIA_NOMBRE: Nombre categoría (Catálogo - CATEGORIA COMITENTE SGN CV
“PRE_CTC_CAT”)
CTC_DESCRIPCION_POSICIONAL_VALOR: Descripción posicional (Texto)
CTC_IS_BLACK: Cliente listas negras (Si=true No=false)
CTC_LIST_PEP_BL: Cliente Pep (Si=true No=false)
USR_ALIAS: Alias usuario (Texto)
CTC_BLACK_LIST_AUT1: Listas negra (null - campo reservado)
PERSONA_JURIDICA: No genera información para Persona Natural

REPRESENTANTE_LEGAL: No genera información para Persona Natural
PERSONA_NATURALPERSONA_JURIDICA: No genera información para Persona Natural
PERSONA_NATURALREPRESENTANTE_LEGAL: No genera información para Persona Natural
COLECTIVIDAD: No genera información para Persona Natural
PERSONA_COLECTIVIDAD: No genera información para Persona Natural
PODER PERSONA: No genera información para Persona Natural
CUENTA_BANCARIA: Contiene información de las cuentas bancarias.
CTB_ID: ID cuenta bancaria

CTC_ID: ID Cuenta comitente
CTB_BANCO: Siglas banco
CTB_BANCO_VALOR: Nombre banco
CTB_TIPO: Tipo de cuenta (Catálogo - TIPO DE CUENTA BANCARIA “PRE_BANK_TYP”)
CTB_PAIS: Siglas país apertura
CTB_PAIS_VALOR: ID país apertura (Catálogo – PAIS “PAIS”)
CTB_CIUDAD_APERTURA: Ciudad apertura (campo reservado)
CTB_NUMERO_CUENTA: Número de cuenta
PAIS_APERTURA: Nombre del País
CTB_NOMBRE: Nombre cuenta (campo libre)
TARJETA_CREDITO: Contiene información de tarjetas de crédito.
TJC_ID: ID tarjeta de crédito,

TJC_FECHA_VENCIMIENTO: Fecha de vencimiento
TJC_NUMERO_TARJETA: Número de tarjeta
TJC_TIPO_TARJETA: Tipo tarjeta (CRE=Crédito AHO=Ahorros)
TJC_MIEMBRO_DESDE: Fecha miembro desde
TJC_EMISOR_TARJETA: Emisor tarjeta (Catálogo - EMISORES DE TARJETAS “PRE_EMI_TAR”)
INGRESO_EGRESO_CLIENTECTC_TOTAL_INGRESOS: Contiene información de los detalles de ingresos.
IEC_ID: ID del ingreso bancario

IEC_CONCEPTO: Siglas concepto (Catálogo - CONCEPTOS DE INGRESOS “PRE_CON_ING”)
MON_ID: ID Moneda (1=dólar)
IEC_VALOR: Valor del ingreso
IEC_VALOR_MONEDA_LOCAL: Valor del ingreso moneda local
IEC_TIPO: Tipo (I=Ingreso E=Egreso)
SIMBOLO: Símbolo moneda ($=dólar)
SIMBOL_MONL Símbolo moneda local ($=dólar)
DESCRIPCION_CONCEPTO: Siglas concepto (Catálogo - CONCEPTOS DE INGRESOS “PRE_CON_ING”)

INGRESO_EGRESO_CLIENTECTC_TOTAL_EGRESOS: Contiene información de los detalles de egresos.
IEC_ID: ID del ingreso bancario

IEC_CONCEPTO: Siglas concepto (Catálogo - CONCEPTOS DE EGRESOS “PRE_CON_EGR”)
DESCRIPCION_CONCEPTO: Siglas concepto (Catálogo - CONCEPTOS DE EGRESOS “PRE_CON_EGR”)
ACTIVO_CLIENTECTC_TOTAL_INMUEBLES: Contiene información de los detalles de activos inmuebles.
ACC_ID: ID del activo

ACC_DESCRIPCION: Descripción del activo
ACC_ORIGEN_PATRIMONIO: Origen del patrimonio
MON_ID: Moneda (1=dólar)
ACC_AVALUO: Valor del activo
ACC_VALOR_MONEDA_LOCAL: Valor del activo moneda local
ACC_TIPO_ACTIVO: Tipo de activo (I=inmuebles M=muebles)
ACTIVO_CLIENTECTC_TOTAL_MUEBLES: Contiene información de los detalles de activos muebles.

ACCIONISTA: No genera información para Persona Natural
PERSONA_NATURALCONYUGUE: No genera información para Persona Natural
PERSONA_COLECTIVIDADCONYUGUE: No genera información para Persona Natural
DOCUMENTOS COMITENTE: No genera información para Persona Natural
PASIVO_CLIENTE_CTC_TOTAL_PASIVO: Contiene información de los detalles de pasivos.
PAS_ID: ID del pasivo

PAS_DESCRIPCION: Descripción pasivo (Catálogo - Pasivo cliente “DESC_PASIVO_CL”)
PAS_ORIGEN: Código origen pasivo (Catálogo - Origen pasivo cliente “ORIGEN_PASIVO_CL”)
PAS_MONTO: Valor del pasivo
PAS_VALOR_MONEDA_LOCAL: Valor del pasivo moneda local
PAS_TIPO: Tipo pasivo
COMITENTE_EMAIL: Contiene información de los correos para facturación electrónica.
CEM_ID: ID de registro
CEM_PRINCIPAL: Es correo principal (0=No 1=Si)
CEM_CONTACTO: Descripción de contacto
CEM_EMAIL: Correo electrónico
CEM_ESTADO: Estado del registro (A=activo E=eliminado))
CEM_TIPO: Tipo de envío mail (Catálogo - TIPO EMAIL RETENCION “CAT_TIPO_EMAIL_EFAC”)
CEM_TIPO_NOMBRE: Descripción tipo de envío mail
COMITENTE NACIONALIDAD: Contiene información cuando el comitente tiene varias nacionalidades.
CTN_ID: ID registro múltiple nacionalidad

NAC_ID: ID Nacionalidad (Catálogo – NACIONALIDAD “PRE_NAC”)
CTN_FECHA_ACTUALIZACION: Fecha de actualización
ITC_VALOR: Nacionalidad (Catálogo – NACIONALIDAD “PRE_NAC”)
CTN_ESTADO: Estado nacionalidad
INFORMACION_CRS: Contiene información de CRS
PERSONA_NATURALPERSONA: Contiene información de PN.
PNC_ID: ID registro contacto

PNA_ID: ID principal de persona natural
PNC_PRIMER_APELLIDO: Primer apellido
PNC_SEGUNDO_APELLIDO: Segundo apellido
PNC_PRIMER_NOMBRE: Primer nombre
PNC_SEGUNDO_NOMBRE: Segundo nombre

PNC_DIRECCION: Dirección de domicilio persona natural

PNC_EMAIL: Email
PNC_TELEFONO: Teléfono
PNC_PARENTESCO: ID Parentesco (Catálogo – PARENTESCO “PRE_TIP_REL_PER”)
PNC_FECHA_REGISTRO: Fecha de registro
SR_ID: ID usuario (relacionado a método de usuarios)
NOMBRE_COMPLETO: Nombre completo de la persona
PNC_PARENTESCO_DESCRIPCION: Parentesco (Catálogo – PARENTESCO “PRE_TIP_REL_PER”)
PREGUNTAS_RESPUESTAS: Contiene información de preguntas de perfil del inversionista.
PCFG_ID: ID de registro
PCFG_PREGUNTA: Detalle de pregunta
RCFG_ID: ID de respuesta
RCFG_OPCION: Descripción de respuesta
checked: Estado de marcado (0=No 1=Si)
7. Método: Insertar / Actualizar Comitente Persona Natural
Método web que sirve para insertar y actualizar un comitente persona natural.
Syntax
http://10.10.1.6/ServiciosTEST/api/prevencion/gestionComitentePersonaNatural
7.1. Parameters
invocación POST.
Para insertar o modificar una persona natural, debemos completar los campos de la
estructura JSON de acuerdo con el siguiente ejemplo.
Para la inserción registros debemos enviar el valor de (-1) en los ID principales de cada
sección.
Para la actualización de registros debemos enviar el ID del objeto que necesitamos

modificar, a continuación, se listan los objetos para insertar o actualizar una Persona
Natural:
• objPersonaNatural (PNA_ID)
• objCuentaComitente (CTC_ID)
• objComitenteEmail (CEM_ID)
• objActivoCliente (ACC_ID)
• objPasivoCliente (PAS_ID)
• objIngresoEgresoCliente (IEC_ID)
• objCuentaBancaria (CTB_ID)
• objTarjetaComitente (TJC_ID)
• objDocumentoEntregado (DOE_ID)
{
"objPersonaNatural":{
"PNA_ID":-1,
"CTC_ID":-1,
"PNA_DIRECCION_CORRESPONCIA":"example",
"PNA_DIRECCION_DOMICILIO": "example",
"PNA_DIRECCION_TRABAJO": "example",

"PNA_ESTADO_CIVIL":259,
"PNA_FECHA_NACIMIENTO": "2000-01-01",
"PNA_NACIONALIDAD":2049,
"PNA_TIPO_IDENTIFICACION":90,
"PNA_OCUPACION":2693,
"PNA_POLITICAMENTE":true,
"PNA_PRIMER_APELLIDO":"Pepito",
"PNA_SEGUNDO_APELLIDO":"Segundo",
"PNA_PRIMER_NOMBRE":"Perez",
"PNA_SEGUNDO_NOMBRE":"Martinez",
"PNA_TELEFONO_DOMICILIO":"2541541",
"PNA_TELEFONO_OFICINA":"2541541",
"PNA_SEXO":256,
"PNA_RELACION_DEPENDENCIA":0,
"PNA_INSTITUCION_DEPENDENCIA":"EJEMPLO123",
"PNA_JURIDICA_FAX":"EJEMPLO",
"PNA_EMAIL":"[email protected]",
"PNA_TELEFONO_CELULAR":"1234567890",
"PNA_ID_CONYUGE":-1,
"PNA_RUC":"1900359769001",
"PNA_LUGAR_TRABAJO":"EJEMPLO",
"PNA_CIUDAD":2333,
"PNA_PROVINCIA":2222,
"PNA_CANTON":2557,
"PNA_OBSERVACIONES":"EMJEMPLO",
"PNA_IS_PEP":true,
"PNA_IS_BLACK_LIST":true,
"PNA_LIST_OFAC":"EJEMPLO",
"PNA_PAIS_RESIDENCIA":2049,
"PNA_FECHA_ULTIMA_ACT":"2021-04-05",
"PNA_ACTUALIZA_USR":6,
"PNA_LUGAR_NATAL":2049,
"PNA_NACIONALIDAD_MULTIPLE":false,
"PNA_ID_CONTACTO":null,
"PNA_SEPARA_BIENES":0
},
"objCuentaComitente":{
"CTC_ID”: -1,
"RPL_ID”: -1,
"SUC_ID":1,
"COL_ID”: -1,
"CTC_ESTADO”: -1,
"CTC_RECEPCION_DOCUMENTOS":0,
"CTC_TIPO_CUENTA”: -1,
"CTC_TOTAL_MUEBLES":0,
"CTC_TOTAL_INMUEBLES":0,
"CTC_TOTAL_EGRESOS":0,
"CTC_TOTAL_INGRESOS":0,
"CTC_ANTICIPO":1,
"CTC_DESCRIPCION_ACTIVIDAD":"JUBILADO",
"CTC_OBJETO_SOCIAL":"VENTAS AL POR MAYOR",
"CTC_DESCRIPCION_POSICIONAL":254,
"CTC_PORCENTAJE_COMISION":0,
"CTC_PORCENTAJE_ANTICIPATION":0,
"PAL_ID":1,
"CTC_IS_PEP":1,
"CTC_IS_BLACK_LIST":1,
"CTC_FECHA_ULTIMA_ACT":"2021-03-02 10:30:12.117",
"CTC_ACTUALIZA_USR":6,
"CTC_BLACK_LIST_AUT":null,
"CTC_TOTAL_PASIVO":12,
"ACE_CODIGO":"S01082",
"CTC_CATEGORIA":null,
"CTC_FECHA_ACT_FORMULARIO":"2021-03-02 10:50:12.117",
"CTC_RESPONSABLE_FORMULARIO":148,
"CTC_OBSERVACIONES_FORMULARIO":"OK DOCUMENTOS",

"CTC_APLICA_ACC_DESGLOSE":3967,
"CTC_FECHA_BALANCES_AUDITADOS":"2021-03-02 10:30:12.117",
"CTC_FECHA_DECLARACION_SRI":"2021-03-02 10:30:12.117",
"CTC_FECHA_CREACION":"2021-03-02 10:30:12.117",
"CTC_BOLSA_COTIZA":"",
"CTC_INSCRITO_EN_CPMV":0,
"CTC_TIPO_EMPRESA":"",
"CTC_BAJO_CONTROL_DE_SUPER_DE_BANCOS":0,
"CTC_TIPO_PRODUCTO":0,
"CTC_OBSERVACIONES_PEPS":"",
"CTC_OBSERVACIONES_VINCULANTE":"",
"CTC_AGENTE_RETENCION":0
},
"objComitenteEmail":[
{
"CEM_ID":-1,
"CTC_ID":-1,
"CEM_PRINCIPAL":0,
"CEM_CONTACTO":"EJEMPLOLOX",
"CEM_EMAIL":"[email protected]",
"CEM_ESTADO":"A",
"CEM_FECHA_REGISTRO":"2021-04-06",
"CEM_FECHA_ACTUALIZACION":"2021-04-06",
"CEM_TIPO":4015
}],
"objActivoCliente":[{
"ACC_ID":-1,
"CTC_ID":-1,
"ACC_AVALUO":15000,
"ACC_DESCRIPCION":3258,
"ACC_ORIGEN_PATRIMONIO":781,
"ACC_TIPO_ACTIVO":"I",
"MON_ID":1,
"ACC_VALOR_MONEDA_LOCAL":15000
},
{
"ACC_ID":-1,
"CTC_ID":-1,
"ACC_AVALUO":2000,
"ACC_TIPO_ACTIVO":"M",
"MON_ID":1,
}],
"objPasivoCliente":[{
"PAS_ID":-1,
"CTC_ID":-1,
"PAS_MONTO":3000,
"PAS_DESCRIPCION":3241,
"PAS_ORIGEN":3257,
"PAS_TIPO":"",
"MON_ID":1,
"PAS_VALOR_MONEDA_LOCAL":3000
}],
"objIngresoEgresoCliente":[{
"IEC_ID":-1,
"CTC_ID":-1,
"IEC_CONCEPTO":3274,
"IEC_VALOR":1000,
"IEC_TIPO":"I",
"MON_ID":1,
"IEC_VALOR_MONEDA_LOCAL":1000
},
{
"IEC_ID":-1,
"CTC_ID":-1,

"IEC_VALOR":500,
"IEC_TIPO":"E",
"MON_ID":1,
}],
"objCuentaBancaria":[{
"CTB_ID":-1,
"CTC_ID":-1,
"CTB_BANCO":3260,
"CTB_CIUDAD_APERTURA":-1,
"CTB_NUMERO_CUENTA":3085044404,
"CTB_TIPO":326,
"CTB_PAIS":335,
"CTB_NOMBRE":null
}],
"objTarjetaComitente":[{
"TJC_ID":-1,
"CTC_ID":-1,
"TJC_FECHA_VENCIMIENTO":"2021-09-05",
"TJC_NUMERO_TARJETA":"5422589005901153",
"TJC_TIPO_TARJETA":"343",
"TJC_MIEMBRO_DESDE":"2021-01-05",
"TJC_EMISOR_TARJETA":3266
}],
"objDocumentoEntregado":[{
"DOE_ID":-1,
"CDC_ID":-1,
"PNA_ID":-1,
"DOC_ID":4,
"DOE_ENTREGADO":true,
"DOE_ARCHIVO":[37,80,68,70,45,49,46,55,13,10,37,181,181,181,181,13],
"DOE_ARCHIVO_NOMBRE":"factura001.pdf",
"USR_ID":6,
"DOE_FECHA_EXPIRACION":"2021-09-05",
"DOE_OBSERVACION":"pruebas"
}]
}
Especificaciones de Parámetros
objPersonaNatural
PNA_ID: ID de la persona natural (-1 para crear o ID persona para editar)
CTC_ID: ID cuenta comitente (-1 para crear)
PNA_DIRECCION_CORRESPONCIA: Dirección de correspondencia
PNA_DIRECCION_DOMICILIO: Dirección de domicilio
PNA_DIRECCION_TRABAJO: Dirección de Trabajo
PNA_ESTADO_CIVIL: ID ítem del estado civil (Catálogo - ESTADO CIVIL “PRE_EST_CIV”)
PNA_FECHA_NACIMIENTO: Fecha de nacimiento
PNA_IDENTIFICACION: Identificación de la persona natural
PNA_TIPO_IDENTIFICACION: Tipo identificación (Catálogo - TIPO IDENTIFICACION “TIPO_IDENT”)
PNA_POLITICAMENTE: Es persona políticamente expuesta (Si=true No=false)
PNA_TELEFONO_DOMICILIO: Teléfono de domicilio
PNA_TELEFONO_OFICINA: Teléfono de oficina
PNA_SEXO: Tipo de sexo (Catálogo – SEXO “PRE_PER_SEX”)
PNA_RELACION_DEPENDENCIA: Relación de dependencia (0=No 1=Si)
PNA_JURIDICA_FAX: Número de FAX
PNA_EMAIL: Correo Electrónico
PNA_ID_CONYUGE: ID conyugue (-1 para crear o ID de conyugue para editar)
PNA_RUC: Ruc

PNA_LUGAR_TRABAJO: Descripción lugar de trabajo

PNA_CANTON: Canton (Catálogo – CANTON “PRE_CANT”)
PNA_OBSERVACIONES: Observación (campo libre)
PNA_ACTUALIZA_USR: ID usuario actualización
PNA_LUGAR_NATAL: Lugar de nacimiento
PNA_ID_CONTACTO: ID contacto (relacionado a persona natural)
PNA_SEPARA_BIENES: Tiene separación de bienes (Si=true No=false)
objCuentaComitente
CTC_ID: ID cuenta comitente (-1 para crear o ID cuenta comitente para editar)
RPL_ID: ID representante legal (-1 para crear)
SUC_ID: ID sucursal (1= Sucursal principal)
COL_ID: ID colectividad (-1 para crear)
CTC_CODIGO: Código cuenta comitente (autogenerado)
CTC_ESTADO: Estado de la cuenta (autogenerado)
CTC_RECEPCION_DOCUMENTOS Recepción de documentos (campo no activo enviar null)
CTC_TIPO_CUENTA: Tipo de cuenta (autogenerado)
CTC_TOTAL_MUEBLES: Total muebles (campo no activo)
CTC_TOTAL_INMUEBLES: Tota inmuebles (campo no activo)
CTC_TOTAL_EGRESOS: Total egresos (campo no activo)
CTC_TOTAL_INGRESOS: Total ingresos (campo no activo)
CTC_DESCRIPCION_ACTIVIDAD: Descripción actividad
CTC_OBJETO_SOCIAL: Objeto Social (Catálogo CIIU)
CTC_DESCRIPCION_POSICIONAL: Descripción posicional (Catálogo - DESCRIPCIONES POSICIONALES
“PRE_DESC_POSIC”)
PAL_ID: ID (enviar 1 por defecto)
CTC_ACTUALIZA_USR: Usuario actualización (enviar ID usuario que actualiza, crear usuario de servicio)
CTC_BLACK_LIST_AUT: Listas autorizadas (campo no activo)
CTC_TOTAL_PASIVO: Total pasivos (campo no activo)
ACE_CODIGO: código CIIU (relación con método de actividades económicas)
CTC_CATEGORIA: Categoría (campo reservado)
CTC_FECHA_CREACION: Fecha de última actualización
objComitenteEmail
CEM_ID: ID de registro (-1 para crear o ID de registro para editar)
CTC_ID: ID cuenta comitente (-1 para insertar registro y ID para realizar la actualización)
CEM_FECHA_REGISTRO: Fecha de registro
CEM_FECHA_ACTUALIZACION: Fecha de actualización

objActivoCliente
ACC_ID: ID del activo (-1 para crear o ID de registro para editar)
CTC_ID: ID Cuenta comitente (-1 para insertar registro y ID para realizar la actualización)
ACC_AVALUO: Monto del activo
ACC_DESCRIPCION: Descripción del activo (Catálogo - BIENES MUEBLES - BIENES INMUEBLES
“PRE_BIE_INM” - “PRE_BIE_MUE”)
ACC_ORIGEN_PATRIMONIO: Origen del patrimonio (Catálogo - ORIGEN PATRIMONIO “TIP_SOUR_PAT”)
ACC_VALOR_MONEDA_LOCAL: Monto del activo
objPasivoCliente
PAS_ID: ID pasivo (-1 para crear o ID de registro para editar)
PAS_MONTO: Monto del pasivo
PAS_DESCRIPCION: Descripción del pasivo (Catálogo - Descripción pasivo cliente “DESC_PASIVO_CL”)
PAS_ORIGEN: Origen del patrimonio (Catálogo - Origen pasivo cliente “ORIGEN_PASIVO_CL”)
PAS_TIPO: Tipo pasivo (campo libre)
PAS_VALOR_MONEDA_LOCAL: Monto pasivo
objIngresoEgresoCliente
IEC_ID: ID registro ingreso / egreso (valor asignado automáticamente)
IEC_CONCEPTO: Concepto (Catálogo - CONCEPTOS DE EGRESOS “PRE_CON_EGR”)
IEC_VALOR: Monto del ingreso o egreso
IEC_VALOR_MONEDA_LOCAL Monto del ingreso o egreso
objCuentaBancaria
CTB_ID: ID cuenta bancaria (-1 para crear o ID de registro para editar)
CTB_BANCO: ID banco (Catálogo – BANCOS “PRE_BANK”)
CTB_CIUDAD_APERTURA: ID ciudad apertura (Catálogo – CIUDAD “CIUDAD”)
CTB_TIPO: Tipo de cuenta (Catálogo - TIPO DE CUENTA BANCARIA “TIPO_CTA_BAN”)
CTB_PAIS: ID país apertura (Catálogo – PAIS “PAIS”)
objDocumentoEntregado
DOE_ID: ID registro documento (-1 para crear o ID de registro para editar)
CDC_ID: ID Cuenta comitente (-1 para insertar registro y ID para realizar la actualización)
PNA_ID: ID persona natural (enviar -1 por defecto)
DOC_ID: ID documento (ID de servicio de tipos de documentos)
DOE_ENTREGADO: Si el documento fue entregado (Si=true No=false)
DOE_ARCHIVO: Archivo adjunto (carga de archivo binario)
DOE_ARCHIVO_NOMBRE: Nombre del archivo cargado
USR_ID: ID usuario actualización (obtener de servicio de usuarios y empleados)
DOE_FECHA_EXPIRACION: Fecha de expiración
DOE_OBSERVACION: Observación
7.2. Return Value

Type: String
{
"CODE": "OK",
"MESSAGE": "630",
"EX": ""
}
El método devuelve el siguiente JSON:

▪ El campo MESSAGE con el ID del registro afectado.
▪ El campo CODE puede ser OK=Registro procesado correctamente y ERR=Registro no

procesado.
▪ El campo EX se detallará el detalle del error.
8. Método: Insertar / Actualizar Comitente Persona Jurídica
Método web que sirve para insertar y actualizar comitente persona jurídica.
Syntax
http:// 10.10.1.6/ServiciosTEST/api/prevencion/gestionComitenteJuridica
8.1. Parameters
invocación POST.
Para insertar o modificar una persona jurídica, debemos completar los campos de la
estructura JSON de acuerdo con el siguiente ejemplo.
Para la inserción registros debemos enviar el valor de (-1) en los ID principales de cada
sección.
Para la actualización de registros debemos enviar el ID del objeto que necesitamos

modificar, a continuación, se listan los objetos para insertar o actualizar una Persona
Jurídica:
• objPersonaJuridica (PRJ_ID)
• objRepresentanteLegal (RPL_ID)
• objRepresentanteLegalPN (PNA_ID)
• objCuentaComitente (CTC_ID)
• objComitenteEmail (CEM_ID)
• objActivoCliente (ACC_ID)
• objPasivoCliente (PAS_ID)
• objIngresoEgresoCliente (IEC_ID)
• objCuentaBancaria (CTB_ID)
• objTarjetaComitente (TJC_ID)
• objDocumentoEntregado (DOE_ID)
{
"objPersonaJuridica":{
"PRJ_ID": -1
"PRJ_CARGO": "REPRESENTANTE LEGAL",
"PRJ_DIRECCION":"AV LOS FARICEOS",
"PRJ_EMAIL": "[email protected]",
"PRJ_JURIDICA_FAX": "3982599",
"PRJ_FECHA_CONSTITUCION": "2021-04-08",
"PRJ_FECHA_INSCRIPCION": "2021-04-08",
"PRJ_NOMBRE_COMERCIAL": "EJEMPLO",
"PRJ_IDENTIFICACION": "110564487912",
"PRJ_RAZON_SOCIAL": "EJEMPLO",
"PRJ_ACTIVIDAD_ECONOMICA": "REGISTRO MERCANTIL 22",
"PRJ_TELEFONO_CONTACTO": "0987562459",
"PRJ_TELEFONO_CELULAR": "0987562459",

"PRJ_TIPO": 2905,
"PRJ_CIUDAD": 2417,
"PRJ_TELEFONO1": "2541541",
"PRJ_TELEFONO2": "2549874",
"PNA_ID": 0,
"PRJ_NACIONALIDAD": 2049,
"PRJ_PROVINCIA": 2222,
"PRJ_CANTON": 2559,
"PNA_ID_CONTACTO": 4,
"PRJ_OBSERVACIONES": "EJEMPLO",
"PRJ_IS_PEP": 0,
"PRJ_IS_BLACK_LIST": 0,
"PRJ_LIST_OFAC": "151568498489",
"PRJ_PAIS_RESIDENCIA":2049,
"PRJ_FECHA_ULTIMA_ACT": "2021-04-08",
"PRJ_ACTUALIZA_USR": 6
},
"objRepresentanteLegal":{
"RPL_ID": -1,
"CTC_ID": -1,
"PNA_ID": -1,
"PRJ_ID": -1,
"RPL_CARGO":"GERENTE ITE",
"RPL_FECHA_DESIGNACION":"2021-04-08",
"RPL_FECHA_INSCRIPCION":"2021-04-08",
"RPL_ES_REPRESENTANTE":1,
"PRJ_ID_REPRESENTANTE":0,
"RPL_VEN_NOMBRAMIENTO":"2021-04-08"
},
"objRepresentanteLegalPN":{
"PNA_ID": -1,
"CTC_ID": -1,
"PNA_DIRECCION_CORRESPONCIA":"example",
"PNA_DIRECCION_DOMICILIO": "example",
"PNA_DIRECCION_TRABAJO": "example",
"PNA_ESTADO_CIVIL":259,
"PNA_FECHA_NACIMIENTO": "2000-01-01",
"PNA_NACIONALIDAD":2049,
"PNA_TIPO_IDENTIFICACION":90,
"PNA_OCUPACION":2693,
"PNA_POLITICAMENTE":true,
"PNA_PRIMER_APELLIDO":"Pepito",
"PNA_SEGUNDO_APELLIDO":"Segundo",
"PNA_PRIMER_NOMBRE":"Perez",
"PNA_SEGUNDO_NOMBRE":"Martinez",
"PNA_TELEFONO_DOMICILIO":"2541541",
"PNA_TELEFONO_OFICINA":"2541541",
"PNA_SEXO":256,
"PNA_RELACION_DEPENDENCIA":0,
"PNA_INSTITUCION_DEPENDENCIA":"EJEMPLO123",
"PNA_JURIDICA_FAX":"EJEMPLO",
"PNA_EMAIL":"[email protected]",
"PNA_TELEFONO_CELULAR":"1234567890",
"PNA_ID_CONYUGE": -1,
"PNA_RUC":"1900359769001",
"PNA_LUGAR_TRABAJO":"EJEMPLO",
"PNA_CIUDAD":2333,
"PNA_PROVINCIA":2222,
"PNA_CANTON":2557,
"PNA_OBSERVACIONES":"EMJEMPLO",
"PNA_IS_PEP":true,
"PNA_IS_BLACK_LIST":true,
"PNA_LIST_OFAC":"EJEMPLO",
"PNA_PAIS_RESIDENCIA":2049,
"PNA_FECHA_ULTIMA_ACT":"2021-04-05",
"PNA_ACTUALIZA_USR":6,
"PNA_LUGAR_NATAL":2049,
"PNA_NACIONALIDAD_MULTIPLE":false,
"PNA_ID_CONTACTO":null,
"PNA_SEPARA_BIENES":0
},
"objCuentaComitente":{
"CTC_ID": -1,
"RPL_ID": -1,
"SUC_ID":1,

"COL_ID":0,
"CTC_CODIGO":"CTA_COM 00000",
"CTC_ESTADO":357,
"CTC_RECEPCION_DOCUMENTOS":0,
"CTC_TIPO_CUENTA":251,
"CTC_TOTAL_MUEBLES":0,
"CTC_TOTAL_INMUEBLES":0,
"CTC_TOTAL_EGRESOS":0,
"CTC_TOTAL_INGRESOS":0,
"CTC_ANTICIPO":1,
"CTC_DESCRIPCION_ACTIVIDAD":"JUBILADO",
"CTC_OBJETO_SOCIAL":"VENTAS AL POR MAYOR",
"CTC_DESCRIPCION_POSICIONAL":-1,
"CTC_PORCENTAJE_COMISION":0,
"CTC_PORCENTAJE_ANTICIPATION":0,
"PAL_ID":0,
"CTC_IS_PEP":0,
"CTC_IS_BLACK_LIST":0,
"CTC_FECHA_ULTIMA_ACT":"2021-03-02 10:30:12.117",
"CTC_ACTUALIZA_USR":6,
"CTC_BLACK_LIST_AUT":null,
"CTC_TOTAL_PASIVO":0,
"ACE_CODIGO":"S01082",
"CTC_CATEGORIA":null,
"CTC_FECHA_ACT_FORMULARIO":"2021-03-02 10:50:12.117",
"CTC_RESPONSABLE_FORMULARIO":148,
"CTC_OBSERVACIONES_FORMULARIO":"OK DOCUMENTOS",
"CTC_APLICA_ACC_DESGLOSE":-1,
"CTC_FECHA_BALANCES_AUDITADOS":"2021-03-02 10:30:12.117",
"CTC_FECHA_DECLARACION_SRI":"2021-03-02 10:30:12.117",
"CTC_FECHA_CREACION":"2021-03-02 10:30:12.117",
"CTC_BOLSA_COTIZA":null,
"CTC_INSCRITO_EN_CPMV":null,
"CTC_TIPO_EMPRESA":null,
"CTC_BAJO_CONTROL_DE_SUPER_DE_BANCOS":0,
"CTC_TIPO_PRODUCTO":0,
"CTC_OBSERVACIONES_PEPS":0,
"CTC_OBSERVACIONES_VINCULANTE":null,
"CTC_AGENTE_RETENCION":0
},
"objComitenteEmail":[
{
"CEM_ID": -1,
"CTC_ID": -1,
"CEM_PRINCIPAL":0,
"CEM_CONTACTO":"EJEMPLOLOX",
"CEM_EMAIL":"[email protected]",
"CEM_ESTADO":"A",
"CEM_FECHA_REGISTRO":"2021-04-06",
"CEM_FECHA_ACTUALIZACION":"2021-04-06",
"USR_ID":6,
"CEM_TIPO":4015
}],
"objActivoCliente":[{
"ACC_ID":-1,
"CTC_ID":-1,
"ACC_AVALUO":15000,
"ACC_TIPO_ACTIVO":"I",
"MON_ID":1,
},
{
"ACC_ID":-1,
"CTC_ID":-1,
"ACC_AVALUO":2000,
"ACC_TIPO_ACTIVO":"M",
"MON_ID":1,
}],
"objPasivoCliente":[{
"PAS_ID":-1,
"CTC_ID":-1,

"PAS_MONTO":3000,
"PAS_DESCRIPCION":3241,
"PAS_ORIGEN":3257,
"PAS_TIPO":"",
"MON_ID":1,
"PAS_VALOR_MONEDA_LOCAL":3000
}],
"objIngresoEgresoCliente":[{
"IEC_ID":-1,
"CTC_ID":-1,
"IEC_VALOR":1000,
"IEC_TIPO":"I",
"MON_ID":1,
},
{
"IEC_ID":-1,
"CTC_ID":-1,
"IEC_VALOR":500,
"IEC_TIPO":"E",
"MON_ID":1,
}],
"objCuentaBancaria":[{
"CTB_ID":-1,
"CTC_ID":-1,
"CTB_BANCO":3260,
"CTB_CIUDAD_APERTURA":-1,
"CTB_NUMERO_CUENTA":3085044404,
"CTB_TIPO":326,
"CTB_PAIS":335,
"CTB_NOMBRE":null
}],
"objTarjetaComitente":[{
"TJC_ID":-1,
"CTC_ID":-1,
"TJC_FECHA_VENCIMIENTO":"2021-09-05",
"TJC_NUMERO_TARJETA":"5422589005901153",
"TJC_TIPO_TARJETA":"343",
"TJC_MIEMBRO_DESDE":"2021-01-05",
"TJC_EMISOR_TARJETA":3266
}],
"objDocumentoEntregado":[{
"DOE_ID":-1,
"CDC_ID":-1,
"PNA_ID":-1,
"DOC_ID":4,
"DOE_ENTREGADO":true,
"DOE_ARCHIVO":[37,80,68,70,45,49,46,55,13,10,37,181,181,181,181,13],
"DOE_ARCHIVO_NOMBRE":"factura001.pdf",
"USR_ID":6,
"DOE_FECHA_EXPIRACION":"2021-09-05",
"DOE_OBSERVACION":"pruebas"
}]
}
Especificaciones de Parámetros
objPersonaJuridica
PRJ_ID: ID persona jurídica (-1 para crear o ID para actualizar el registro)
PRJ_CARGO: Descripción cargo
PRJ_DIRECCION: Dirección persona jurídica
PRJ_EMAIL: Correo electrónico
PRJ_JURIDICA_FAX: Fax
PRJ_FECHA_CONSTITUCION: Fecha constitución
PRJ_FECHA_INSCRIPCION: Fecha inscripción
PRJ_NOMBRE_COMERCIAL: Nombre comercial
PRJ_IDENTIFICACION: Identificación (RUC, documento exterior)
PRJ_RAZON_SOCIAL: Razón social
PRJ_ACTIVIDAD_ECONOMICA: Descripción actividad económica
PRJ_TELEFONO_CONTACTO: Teléfono de contacto

PRJ_TELEFONO_CELULAR: Teléfono celular

PRJ_TIPO: Tipo de persona (Catálogo - TIPO DE PERSONA JURÍDICA “PRE_TIP_PER_JUR”)
PRJ_CIUDAD: Ciudad (Catálogo – CIUDAD “CIUDAD”)
PRJ_TELEFONO1: Teléfono 1
PRJ_TELEFONO2: Teléfono 2
PNA_ID: ID Persona natural (retorna null)
PRJ_NACIONALIDAD: Nacionalidad (Catálogo – NACIONALIDAD “PRE_NAC”)
PRJ_PROVINCIA: Provincia (Catálogo – PROVINCIA “PRE_PROV”)
PRJ_CANTON: Cantón (Catálogo – CANTON “PRE_CANT”)
PNA_ID_CONTACTO: ID persona contacto (relacionado a persona natural)
PRJ_OBSERVACIONES: Observaciones (uso libre)
PRJ_IS_PEP: Persona expuesta políticamente (Si=true No=false)
PRJ_IS_BLACK_LIST: Listas Negras (Si=true No=false)
PRJ_LIST_OFAC: Listas OFAC (Si=true No=false)
PRJ_PAIS_RESIDENCIA: País residencia (Catálogo – PAIS “PAIS”)
PRJ_FECHA_ULTIMA_ACT: Fecha última actualización
PRJ_ACTUALIZA_USR: Usuario actualización
objRepresentanteLegal
RPL_ID: ID representante legal (-1 para crear o ID para actualizar registro)
CTC_ID: ID cuenta comitente (-1 para crear)
PNA_ID: ID persona natural (-1 para crear)
PRJ_ID: ID persona jurídica (-1 para crear)
RPL_CARGO: Descripción cargo
RPL_FECHA_DESIGNACION: Fecha designación representante legal
RPL_FECHA_INSCRIPCION: Fecha inscripción representante legal
RPL_ES_REPRESENTANTE: Es representante legal (Si=true No=false)
PRJ_ID_REPRESENTANTE: ID representante legal (retorna null)
RPL_VEN_NOMBRAMIENTO: Fecha nombramiento representante legal
objRepresentanteLegalPN
PNA_ID: ID principal de persona natural (-1 para crear o ID de registro para actualizar)
CTC_ID: ID cuenta comitente (null cuando es persona natural)
PNA_DIRECCION_CORRESPONCIA: Dirección de correspondencia persona natural
PNA_DIRECCION_DOMICILIO: Dirección de domicilio persona natural
PNA_DIRECCION_TRABAJO: Dirección de trabajo persona natural
PNA_ESTADO_CIVIL: Estado civil (Catálogo - ESTADO CIVIL “PRE_EST_CIV”)
PNA_FECHA_NACIMIENTO: Fecha de Nacimiento
PNA_IDENTIFICACION: Identificación de la persona
PNA_TIPO_IDENTIFICACION: Tipo Identificación (Catálogo - TIPO IDENTIFICACION “TIPO_IDENT”)
PNA_POLITICAMENTE: Políticamente expuesta (0=No 1=Si)
PNA_TELEFONO_DOMICILIO: Teléfono domicilio
PNA_TELEFONO_OFICINA: Teléfono oficina
PNA_SEXO: Sexo (Catálogo – SEXO “PRE_PER_SEX”)
PNA_RELACION_DEPENDENCIA: Si tiene relación de dependencia (0=No 1=Si)
PNA_JURIDICA_FAX: Número de fax
PNA_EMAIL: Correo electrónico
PNA_ID_CONYUGE: ID del conyugue (-1 para crear registro o ID para actualizar registro)
PNA_RUC: Ruc
PNA_LUGAR_TRABAJO: Lugar de trabajo
PNA_CANTON: Cantón (Catálogo – CANTON “PRE_CANT”)
PNA_OBSERVACIONES: Observaciones (campo libre)
PNA_ACTUALIZA_USR: ID usuario actualización (ID método Usuarios)
PNA_LUGAR_NATAL: Lugar de nacimiento (Catálogo – NACIONALIDAD “PRE_NAC”)
PNA_ID_CONTACTO: ID contacto (relacionar con ID persona natural)
PNA_SEPARA_BIENES: Separación de bienes (0=Si 1=No)

objCuentaComitente
CTC_ID: ID cuenta comitente (-1 para crear registro o ID para actualizar registro)
RPL_ID: ID representante legal (-1 para crear)
PNA_ID: ID persona natural (-1 para crear)
SUC_ID: ID sucursal (1=sucursal principal)
COL_ID: ID colectividad (null cuando es PN sin colectividad)
CTC_CODIGO: Código de cuenta comitente (autogenerado)
CTC_ESTADO: Estado cuenta comitente (Catálogo - ESTADOS DE COMITENTE “PER_EST_COMI”)
CTC_RECEPCION_DOCUMENTOS: Recepción de documentos (Si=true No=false)
CTC_TIPO_CUENTA: Tipo cuenta (Catálogo - TIPO CUENTA COMITENTE “PRE_TIP_CUE_COM”)
CTC_TOTAL_MUEBLES: Total muebles (campo auto calculado)
CTC_TOTAL_INMUEBLES: Tota inmuebles (campo auto calculado)
CTC_TOTAL_EGRESOS: Total egresos (campo auto calculado)
CTC_TOTAL_INGRESOS: Total ingresos (campo auto calculado)
CTC_DESCRIPCION_ACTIVIDAD: Descripción actividad (null)
CTC_OBJETO_SOCIAL: Descripción actividad (referencia método actividades 227)
CTC_DESCRIPCION_POSICIONAL: Descripción posicional (Catálogo - DESCRIPCIONES
POSICIONALES “PRE_DESC_POSIC”)
PAL_ID: ID Reservado (se recibe null)
CTC_ACTUALIZA_USR: Usuario de actualización (ID método de Usuarios)
CTC_BLACK_LIST_AUT: Listas autorizadas (campo autogenerado)
CTC_TOTAL_PASIVO: Total pasivos (campo auto calculado)
ACE_CODIGO: Código CIIU (Código de método Actividades Económicas)
CTC_CATEGORIA: Categoría (Catálogo - CATEGORIA COMITENTE SGN CV “PRE_CTC_CAT”)
CTC_FECHA_CREACION: Fecha de creación
objComitenteEmail
CEM_ID: ID de registro (-1 para crear registro o ID para actualizar)
CTC_ID: ID cuenta comitente (-1 para insertar registro y ID para realizar la actualización)
CEM_FECHA_REGISTRO: Fecha de Registro
CEM_FECHA_ACTUALIZACIÓN: Fecha de Actualización
CEM_TIPO_NOMBRE: Descripción tipo de envío mail
objActivoCliente
ACC_ID: ID del activo (-1 para crear registro o ID para actualizar)
ACC_AVALUO: Monto del activo
ACC_DESCRIPCION: Descripción del activo (Catálogo - BIENES MUEBLES - BIENES INMUEBLES
“PRE_BIE_INM” - “PRE_BIE_MUE”)
ACC_ORIGEN_PATRIMONIO: Origen patrimonio (Catálogo - PATRIMONIO “TIP_SOUR_PAT”)
ACC_VALOR_MONEDA_LOCAL: Monto del activo

objPasivoCliente
PAS_ID: ID del pasivo (-1 para crear registro o ID para actualizar)
PAS_MONTO: Valor del pasivo
PAS_DESCRIPCION: Descripción pasivo (Catálogo - Descripción pasivo cliente “DESC_PASIVO_CL”)
PAS_ORIGEN: Código origen pasivo (Catálogo - Origen pasivo cliente “ORIGEN_PASIVO_CL”)
PAS_TIPO: Tipo pasivo
PAS_VALOR_MONEDA_LOCAL: Valor del pasivo moneda local
objIngresoEgresoCliente
IEC_ID: ID del ingreso bancario (-1 para crear registro o ID para actualizar)
IEC_CONCEPTO: Siglas concepto (Catálogo - CONCEPTOS DE EGRESOS “PRE_CON_EGR”)
objCuentaBancaria
CTB_ID: ID cuenta bancaria (-1 para crear registro o ID para actualizar)
CTB_BANCO: Siglas banco
CTB_CIUDAD_APERTURA: Ciudad apertura (campo reservado)
CTB_TIPO: Tipo de cuenta (Catálogo - TIPO DE CUENTA BANCARIA – “TIPO_CTA_BAN”)
CTB_PAIS: Siglas país apertura
objTarjetaComitente
TJC_ID: ID tarjeta de crédito (-1 para crear registro o ID para actualizar)
TJC_FECHA_VENCIMIENTO: Fecha de vencimiento
TJC_NUMERO_TARJETA: Número de tarjeta
TJC_TIPO_TARJETA: Tipo tarjeta (CRE=Crédito AHO=Ahorros)
TJC_MIEMBRO_DESDE: Fecha miembro desde
TJC_EMISOR_TARJETA: Emisor tarjeta (Catálogo - EMISORES DE TARJETAS “PRE_EMI_TAR”)
objDocumentoEntregado
DOE_ID: ID registro documento (-1 para crear registro o ID para actualizar)
CDC_ID: ID Cuenta comitente (-1 para insertar registro y ID para realizar la actualización)
PNA_ID: ID persona natural (enviar -1 por defecto)
DOC_ID: ID documento (ID de servicio de tipos de documentos)
DOE_ENTREGADO: Si el documento fue entregado (Si=true No=false)
DOE_ARCHIVO: Archivo adjunto (carga de archivo binario)
DOE_ARCHIVO_NOMBRE: Nombre del archivo cargado
USR_ID: ID usuario actualización (obtener de servicio de usuarios y empleados)
DOE_FECHA_EXPIRACION: Fecha de expiración
DOE_OBSERVACION: Observación
8.2. Return Value

Type: String
{
"CODE": "OK",
"MESSAGE": "640",
"EX": ""
}
El método devuelve el siguiente JSON:
▪ El campo MESSAGE con el ID del registro afectado.

▪ El campo CODE puede ser OK=Registro procesado correctamente y ERR=Registro no

procesado.
▪ El campo EX se detallará el detalle del error.
9. Método: Obtener Libro de Ordenes
Método web que sirve para obtener información generar del libro de órdenes.
Syntax
http://10.10.1.6/ServiciosTEST/api/gestion/obtenerLibroOrdenes
Parameters Para el consumo de dicho servicio se debe enviar parámetros tipo JSON y
como método de invocación POST.
Si se desea obtener información de todos los comitentes por un rango de fecha se debe
enviar los siguientes parámetros:
{
"fechaInicio":"01/06/2021",
"fechaFin":"30/06/2021"
}
Si se desea obtener información de un solo comitente por un rango de fecha se debe enviar
los siguientes parámetros:
{
"fechaInicio":"01/01/2020",
"fechaFin":"01/12/2021",
"ctcId":"999"
}
9.1. Return Value

Type: JSON
{
"ORN_ID": 895,
"ORN_CODIGO": "ORD-FTR-000895",
"LIQ_NUMERO": "LIQ-FTR-000991",
"LIQ_NUMERO_BOLSA": "296010",
"HORA_ORDEN": "2021-08-31T08:35:07",
"HORA_CIERRE": "2021-08-31T17:54:05",
"ORN_FECHA_INICIO": "2021-08-31T08:35:07",
"FECHA_ORDEN": "31/08/2021",
"FECHA_OPERACION": "31/08/2021",
"LIQ_FECHA_BOLSA": "2021-08-31T17:54:05",
"CRE_CANTIDAD": null,
"LIQ_FECHA_VALOR": "2021-09-01T17:54:05",
"FECHA_VALOR": "01/09/2021",
"OPERACION": "Venta",
"TIPORENTA": "Renta Fija",
"EMISOR": "MINISTERIO DE FINANZAS",
"TIPO_EMISOR": "GOBIERNO CENTRAL",
"TITULO": "CERTIFICADO DE TESORERÍA",
"SBT_CODIGO": "CON_DSCTO",
"ORN_PLAZO": 5,

"TIV_TASA_INTERES": 0.0,
"TIV_FECHA_VENCIMIENTO": "2022-04-28T00:00:00",
"ORN_FECHA_REGISTRO": "2021-08-31T08:35:07",
"FECHA_VENCIMIENTO": "28/04/2022",
"DON_VALOR_NIMINAL": 254566.71,
"LIQ_PRECIO": 97.91122715,
"LIQ_VALOR_EFECTIVO": 249249.39,
"LIQ_VALOR_NOMINAL": 254566.71,
"LIQ_RENDIMIENTO": 3.21339,
"LIQ_COMISION_BOLSA": 74.77,
"LIQ_PORCENTAJE_COMISION_BOLSA": 0.04519,
"LIQ_COMISION_CASA": 74.77,
"LIQ_PORCENTAJE_COMISION_CASA": 0.04519,
"LIQ_TOT_COMISION": 149.54,
"TOT_OPERACION": 249103.97,
"LIQ_TOTAL_INTERES": 0.0,
"LIQ_PLAZO_VALOR": 5,
"OPERADOR": "CHICA MAZZINI ASTRID CAROLINA",
"OPERADORL": "CHICA MAZZINI ASTRID CAROLINA",
"DIAS_TRACURRIDOS": 1,
"ORN_CIUDAD": "GUAYAQUIL",
"DON_CANTIDAD": 254566.71,
"ESTADO": "Liquidado",
"ESTADO_ORDEN": "Ejecutada",
"TIV_CODIGO": "MDF-CT-280422-0001",
"CUPON": "No aplica",
"DON_ES_PRECIO_DE_MERCADO": false,
"DON_PRECIO_MINIMO": 97.91122715,
"DON_PRECIO_MAXIMO": 0.0,
"DON_PRECIO_DE_MERCADO": 0.0,
"DON_NOMTO_INVERTIR": 249249.39,
"ORDEN_VENCIMIENTO": "07/09/2021",
"MERCADO": "Bolsa de Valores de Guayaquil",
"SUC_NOMBRE": "SUCURSAL GUAYAQUIL",
"TIV_TIPO_BASE": 355,
"TIPO_BASE_VALOR": "360",
"ORN_FORMA_DE_PAGO": "{\\rtf1\\ansi\\ansicpg1252\\deff0\\deflang12298{\\f
onttbl{\\f0\\fnil\\fcharset0 Microsoft Sans Serif;}}\r\n\\viewkind4\\uc1\\pard\\f0\\f
s17\\par\r\n}",
"EMS_CODIGO_SIC": "0100001",
"TIV_CODIGO_TITULO_SIC": "0200867",
"TIV_TIPO_TITULO_GENERICO": " ",
"EMS_TIPO_EMISOR": "GOBIERNO CENTRAL",
"TIV_PLAZO": 215,
"LIQ_NUMERO_FACTURA": "001006000089816",
"FAC_NUMERO": "001-002-000000993",
"TIV_FECHA_EMISION": "04/05/2021",
"TIV_DIAS_PLAZO": 359,
"TIV_PRODUCTO": "ESP",
"COMITENTE": "BANCO GUAYAQUIL S.A.",
"LIQ_COMISION_CASA_IVA": 0.0,
"TIV_VALOR_NOMINAL": 0.0,
"LIQ_RET_BV": 2.06,
"LIQ_RET_CV": 2.056175,
"PLAZO_REMANENTE": 239,
"LIQ_SEG_MERCADO": "SECUNDARIO",
"ACP_NOMBRE": null,
"LIQ_TITULO_NUMERACION": "",
"ASESOR": null,
"POR_CODIGO": "INTERMEDIACIÓN",
"CAMARA": "DECEVALE",
"LIQ_CONTRAPARTE": "",
"TIV_CODIGO_VECTOR": null,
"TIV_NUMERO_RMV": null,
"TIV_CLASE": null,
"CALIFICACION": null,
"CALIFICADORA": null,
"FECHA_CALIFICACION": null,
"TIV_CODIGO_SIC": 980,
"TIV_CODIGO_GEN_SIC": 0,
"ems_codigo_sic2": 1,
"PRECIO_NETO": 97.854102761511911,
"TIPO_PERSONA": "Juridica",
"CTC_CIUDAD": "GUAYAQUIL",
"ORN_MOTIVO_ANULACION": null,
"OPERADORAN": "",

"CTC_DIRECCION": "PICHINCHA 105-107 Y FRANCISCO DE PAULA YCAZA",

"CTC_TELEFONO": "043730100",
"CATEGORIA": null,
"NOMBRE_CONTACTO": " "
}

ORN_ID: ID de la orden de negociación
ORN_CODIGO: Número de la orden de negociación (Secuencial)
LIQ_NUMERO: Número de liquidación interna de Casa
LIQ_NUMERO_BOLSA: Número de liquidación de bolsa
HORA_ORDEN: Hora de la orden de negociación
HORA_CIERRE: Hora de cierre de la operación
ORN_FECHA_INICIO: Fecha de inicio de la orden de negociación
FECHA_ORDEN: Fecha de la orden
FECHA_OPERACION: Fecha de la operación
LIQ_FECHA_BOLSA: Fecha liquidación de bolsa
CRE_CANTIDAD: Campo reservado (null)
LIQ_FECHA_VALOR: Fecha valor liquidación
FECHA_VALOR: Fecha valor
OPERACION: Tipo de operación “Venta” o “Compra”
TIPORENTA: Tipo de renta “Renta Fija” o “Renta Variable”
EMISOR: Nombre del emisor
TIPO_EMISOR: Tipo de emisor - categoría
TITULO: Nombre del título valor
SBT_CODIGO: Maneja descuento “CON_DSCTO” o “SIN_DSCTO”
ORN_PLAZO: Plazo de la orden
TIV_TASA_INTERES: Tasa de interés
TIV_FECHA_VENCIMIENTO: Fecha de vencimiento del título valor
ORN_FECHA_REGISTRO: Fecha de registro de la orden de negociación
FECHA_VENCIMIENTO: Fecha de vencimiento de la orden de negociación
DON_VALOR_NIMINAL: Valor nominal orden de negociación
LIQ_PRECIO: Precio
LIQ_VALOR_EFECTIVO: Valor efectivo
LIQ_VALOR_NOMINAL: Valor nominal liquidación
LIQ_RENDIMIENTO: Rendimiento
LIQ_COMISION_BOLSA: Valor comisión bolsa
LIQ_PORCENTAJE_COMISION_BOLSA: Porcentaje comisión bolsa
LIQ_COMISION_CASA: Valor comisión casa de valor
LIQ_PORCENTAJE_COMISION_CASA: Porcentaje comisión casa
LIQ_TOT_COMISION: Total comisiones
TOT_OPERACION: Valor total de la operación
LIQ_TOTAL_INTERES: Valor total intereses
LIQ_PLAZO_VALOR: Días valor
OPERADOR: Nombre del operador orden de negociación
OPERADORL: Nombre del operador liquidación
DIAS_TRACURRIDOS: Días transcurridos
ORN_CIUDAD: Ciudad de la orden de negociación
DON_CANTIDAD: Cantidad
ESTADO: Estado de la orden “Ejecutada”, “Parcialmente Ejecutada”
ESTADO_ORDEN: Estado de la orden “Liquidado”, “Ejecutado”, “Parcialmente Ejecutado”, “Caducado”,
“Abierto”, “Vigente”, “Anulada”
TIV_CODIGO: Código del título
CUPON: Maneja cupón “No aplica”, “SI”, “NO”
DON_ES_PRECIO_DE_MERCADO: Tipo de mercado (true=Primario y false=Secundario)
DON_PRECIO_MINIMO: Precio mínimo
DON_PRECIO_MAXIMO: Precio Máximo
DON_PRECIO_DE_MERCADO: Precio de mercado
DON_NOMTO_INVERTIR: Monto a invertir
ORDEN_VENCIMIENTO: Fecha vencimiento de la orden
MERCADO: Mercado “Bolsa de Valores Quito” o “Bolsa de Valores de Guayaquil”
SUC_NOMBRE: Sucursal “SUCURSAL QUITO” o “SUCURSAL GUAYAQUIL”
TIV_TIPO_BASE: Base numerador
TIPO_BASE_VALOR: Base denominador
ORN_FORMA_DE_PAGO: Forma de pago (Texto en formato rtf}
EMS_CODIGO_SIC: Código de emisor SIC
TIV_CODIGO_TITULO_SIC: Código título SIC
TIV_TIPO_TITULO_GENERICO: Título genérico o específico
EMS_TIPO_EMISOR: Tipo de emisor (Ejemplo: GOBIERNO CENTRAL)
TIV_PLAZO: Plazo del título valor
LIQ_NUMERO_FACTURA: Número de factura bolsa de valores
FAC_NUMERO: Número de factura casa de valores
TIV_FECHA_EMISION: Fecha de emisión del título valor
TIV_DIAS_PLAZO: Plazo total del título valor

TIV_PRODUCTO: tipo producto “ESP” o “GEN”

PNA_IDENTIFICACION: Identificación comitente PN o PJ
COMITENTE: Nombre del comitente
LIQ_COMISION_CASA_IVA: Comisión casa IVA
TIV_VALOR_NOMINAL: Valor nominal
LIQ_RET_BV: Valor retención bolsa
LIQ_RET_CV: Valor retención casa
PLAZO_REMANENTE: Plazo remanente
LIQ_SEG_MERCADO: Tipo de mercado “PRIMARIO” o “SECUNDARIO”
ACP_NOMBRE: Nombre del aceptante (reservado)
LIQ_TITULO_NUMERACION: Numeración del título valor
ASESOR: Nombre del asesor (reservado)
POR_CODIGO: Tipo de la negociación “INTERMEDIACIÓN”, “PORTAFOLIO PROPIO”, “PORTAFOLIO
ADMINISTRADO”, “PORTAFOLIO NO ADMINISTRADO”
CAMARA: Cámara de compensación “DECEVALE” 0 “DCV-BCE”
LIQ_CONTRAPARTE: Contraparte liquidación de compra o venta
TIV_CODIGO_VECTOR: Código vector de precios
TIV_NUMERO_RMV: Número de RMV
TIV_CLASE: Clase
CALIFICACION: Clasificación
CALIFICADORA: Calificadora
FECHA_CALIFICACION: Fecha de Calificación
TIV_CODIGO_SIC: Código de título SIC
TIV_CODIGO_GEN_SIC: Código genérico SIC
ems_codigo_sic2: Código emisor SIC2
PRECIO_NETO: Precio neto
TIPO_PERSONA: Tipo de persona “Natural” o “Jurídica”
CTC_CIUDAD: Ciudad de la negociación “QUITO” o “GUAYAQUIL”
ORN_MOTIVO_ANULACION: Motivo anulación de la orden, campo texto.
OPERADORAN: Campo reservado
CTC_DIRECCION: Dirección comitente
CTC_TELEFONO: Teléfono comitente
CATEGORIA: Categoría
NOMBRE_CONTACTO: Nombre del contacto
10. Método: Obtener Vector de Precios
Método web que sirve para obtener un listado del Vector de Precio, en base a un rango de
fecha.
Syntax
http://10.10.1.6/ServiciosTEST/api/gestion/obtenerVectorPrecio
10.1. Parameters
invocación POST.
{"fechaInicio":"17/07/2021","fechaFin":"17/07/2021"}
10.2. Return Value

Type: JSON
[
{
"rev_archivo": "REVALUACION",
"rev_fecha": "2021-07-16T00:00:00",
"rev_codigo": "045040100401270823",
"rev_precio": 0.93004389396206988,

"rev_fila_excel": 413,
"rev_fecha_emision": "2019-08-23T00:00:00",
"rev_fecha_vencimiento": "2027-08-23T00:00:00",
"rev_emisor": "MINISTERIO DE FINANZAS",
"rev_tasa_interes": 0.0593,
"rev_calificacion": null,
"rev_tipo_tasa": "TASA FIJA 5,93%",
"rev_plazo_remanente": 2197,
"rev_tasa_referencia": 0.10916427195678335,
"rev_margen": -0.027513894863016471,
"rev_tasa_descuento": 0.078646842792350125,
"rev_rendimiento_equivalente": 0.075946651924255981,
"rev_tipo_valor": "BE 04",
"rev_codigo_emisor": "045",
"rev_codigo_tipo": "04",
"rev_es_tit": 0,
"rev_duracion_efectiva_anual": 4.3433417730729378,
"rev_duracion_modificada_anual": 4.0266578464449951,
"rev_duracion_efectiva_semestral": 8.6866835461458756,
"rev_duracion_efectiva_diaria": 1563.6030383062575,
"rev_duracion_modificada_semestral": 8.05331569288999,
"rev_duracion_modificada_diaria": 1449.5968247201984,
"rev_convexidad": 6.3151312918311477,
"ruc": null
},
rev_archivo: Nombre de archivo

rev_fecha: Fecha vector de precio
rev_codigo: Código vector de precio
rev_precio: Precio del título a la fecha
rev_fila_excel: Fila de archivo Excel (código interno)
rev_fecha_emision: Fecha de emisión del título
rev_fecha_vencimiento: Fecha de vencimiento del título
rev_emisor: Nombre del emisor
rev_tasa_interes: Porcentaje tasa de interés
rev_calificacion: Calificación de riesgo del título
rev_tipo_tasa: Descripción tasa de interés
rev_plazo_remanente: Plazo remanente (en días)
rev_tasa_referencia: Tasa referencial
rev_margen: Margen
rev_tasa_descuento: Tasa de descuento
rev_rendimiento_equivalente: Rendimiento equivalente
rev_tipo_valor: Tipo valor
rev_codigo_emisor: Código del emisor
rev_codigo_tipo: Código del título
rev_es_tit: Es título
rev_duracion_efectiva_anual: Duración efectiva anual
rev_duracion_modificada_anual: Duración modificada anual
rev_duracion_efectiva_semestral: Duración efectiva semestral
rev_duracion_efectiva_diaria: Duración efectiva diaria
rev_duracion_modificada_semestral: Duración modificada semestral
rev_duracion_modificada_diaria: Duración modificada diaria
rev_convexidad: Convexidad
ruc: Ruc (Null campo reservado)
11. Método: Obtener Montos Emitidos
Método web que sirve para obtener registros de montos emitidos y colocados.
“Importante: sólo retorna información de títulos largo plazo”.
Syntax

http://10.10.1.6/ServiciosTEST/api/gestion/obtenerMontosEmitidos
11.1. Parameters
invocación POST.
Para el consumo del método no requiere parámetros.
{}
11.2. Return Value

Type: JSON
{
"NUMERO_DE_CLASES": 1,
"TIV_ID": "5297",
"TIPO_MERCADO": "PRIMARIO",
"TITULO": "PAPEL COMERCIAL",
"SIGLAS_TITULO": "PCO",
"EMISOR": "FISA FUNDICIONES INDUSTRIALES S.A.",
"NUMERO_PROGRAMA": 4,
"CLASE": "",
"TIV_SERIE": " ",
"MONTO_TOTAL": 5000000.0,
"MONTO_CLASE": 5000000.0,
"MONTO_DISPONIBLE": 1302018.0,
"COLOCADO": 3697982.0,
"COLOCADO_MACRO": 3697982.0,
"COLOCADO_MACRO_CON_VENCIMIENTOS": 3697982.0,
"TASA_CUPON": "0",
"MONTO_DISPONIBLE_MACRO": 1302018.0,
"RENDIMIENTO": "0",
"PLAZO": "720",
"FECHA_DE_VENCIMIENTO_DE_OFERTA_PUBLICA": "2021-12-07T00:00:00",
"FECHA_VENCIMIENTO": "",
"FECHA_CALIFICACION": "2021-07-30T00:00:00",
"CALIFICACION": "AAA-",
"CALIFICADORA": "CLASS INTERNATIONAL",
"ID_CALIFICADORA": "7",
"PERIODO_DE_CAPITAL": "AL VENCIMIENTO",
"PERIODO_DE_INTERES": "OTROS",
"FECHA_DE_EMISION_DE_OFERTA_PUBLICA": "2019-12-18T00:00:00",
"FECHA_EMISION": "",
"CASA_DE_VALORES_ESTRUCTURADORA": "PLUSBURSÁTIL CASA DE VALORES S.A.",
"RMV": "2019.G.02.002809",
"SPLIT": "NO",
"GARANTIA": "GENERAL"

TIV_ID: ID del título valor
NUMERO_DE_CLASES: Indica el número de clases que están agrupadas en este registro. Cuando la
emisión tiene un monto disponible por cada clase, este número es uno. Porque cada registro representa una
clase distinta. Pero si la emisión no tiene un monto disponible por clase, entonces todas las clases se

agrupan en un solo registro, entonces NUMERO_DE_CLASES tiene el número de clases que están
agrupadas en esta emisión.
TIV_ID: ID del título valor
TIPO_MERCADO: Tipo de mercado (PRIMARIO - SECUNDARIO)
TITULO: Descripción del título
SIGLAS_TITULO: Detalle de la clase
EMISOR: Descripción del emisor
NUMERO_PROGRAMA: Es el número asignado por la Superintendencia a esta emisión de obligaciones o de
papel comercial.
CLASE: Detalle de la clase
TIV_SERIE: En obligaciones este campo solo está lleno si se trata de un Split, cada Split tiene un número de
serie distinto, por ejemplo, CUPÓN 1, CUPÓN 2, etc. En titularizaciones este número se utiliza en lugar de la
clase. En otras palabras, lo que en obligaciones se llama “clase”: es decir un título con características
determinadas dentro de una emisión, en titularizaciones se llama “serie”.
MONTO_TOTAL: Monto Total
MONTO_CLASE: Monto de la Clase
MONTO_DISPONIBLE: Monto Disponible
COLOCADO: Describe el monto que ha sido negociado en mercado primario, solo para esta fila.
COLOCADO_MACRO: En el caso que existan varias clases en una emisión que estén separadas cada una
en su propia fila, entonces este campo indica el total colocado para toda la emisión.
COLOCADO_MACRO_CON_VENCIMIENTOS: Es lo mismo que COLOCADO_MACRO, pero descontando
el monto emitido de los Split que ya han vencido.
TASA_CUPON: Tasa Cupón
MONTO_DISPONIBLE_MACRO: Es el monto emitido para el registro actual menos el monto
COLOCADO_MACRO.
RENDIMIENTO: Rendimiento
PLAZO: Plazo del título valor
FECHA_DE_VENCIMIENTO_DE_OFERTA_PUBLICA: Fecha de vencimiento de la oferta pública
FECHA_VENCIMIENTO: Fecha de vencimiento
FECHA_CALIFICACION: Fecha de calificación
CALIFICACION: Calificación
CALIFICADORA: Calificadora
ID_CALIFICADORA: El o los IDs de las calificadoras, uno para cada clase que se encuentre agrupada en la
emisión.
PERIODO_DE_CAPITAL: Tipo de pago capital (MENSUAL – TRIMESTRAL – SEMESTRAL – ANUAL -
VENCIMIENTO)
PERIODO_DE_INTERES: Tipo de pago capital (MENSUAL – TRIMESTRAL – SEMESTRAL – ANUAL -
VENCIMIENTO)
FECHA_DE_EMISION_DE_OFERTA_PUBLICA: Fecha de emisión de la oferta pública
FECHA_EMISION: Fecha de emisión
CASA_DE_VALORES_ESTRUCTURADORA: Casa estructuradora
RMV: Registro del mercado de valores
SPLIT: Para cada clase que se encuentre agrupada en esta línea, indica si trata de un Split en cuyo caso
tienen un valor de “SI”, o si no es un Split en cuyo caso tiene un valor de “NO”.
GARANTÍA: Detalle de la Garantía
En la estructura JSON, contine campos de cabecera y detalle. Los campos que no están marcados pertenecen a
datos de la cabecera de la estructura JSON, y los campos marcados pertenecen a los detalles de la estructura JSON.
El campo NUMERO_DE_CLASES define cuantos detalles vienen en la estructura.
Los detalles se encuentran separados por comas (,) y siempre se encuentran ordenados en cada uno de los campos
de la estructura JSON respectivamente.
A continuación, se adjunta imagen de la estructura JSON.

12. Método: Obtener Capitalización RV
Método web que sirve para obtener un listado del Emisores con información de su
capitalización, en base a un rango de fecha.
Syntax
http://10.10.1.6/ServiciosTEST/api/gestion/ObtenerCapitalizacionRV
12.1. Parameters
invocación POST.
12.2. Return Value

Type: JSON
[
{
"FECHA_BOLETIN": "2023-01-01T00:00:00",
"CODIGO": "AMD",
"EMISOR": "Amazonas Banco ",

"PATRIMONIO": 26475390.29,
"CAPITALZIACIÓN": 21083923.0,
"UTILIDAD_REF_ACCION": 0.01,
"RELACION_PRECIO_UTILIDAD": 76.29,
"VALOR_LIBROS": 1.26
},
FECHA_BOLETIN: Fecha en la cual se elaboró el boletín

CODIGO: Código de cada emisor
EMISOR: Nombre del Emisor
PATRIMONIO: Patrimonio de la empresa
CAPITALZIACIÓN: Capitalización bursátil
UTILIDAD_REF_ACCION: EPS Earnings per share (Utilidad/Número de acciones circulantes)
RELACION_PRECIO_UTILIDAD: Cálculo P/E (Último precio de acciones/Utilidad referencial por acción)
VALOR_LIBROS: Valor en libros de la empresa
13. Método: Obtener Máximos y Mínimos
Método web que sirve para obtener un listado de las acciones con su respectiva información de
máximos y mínimos, en base a un rango de fecha.
Syntax
http://10.10.1.6/ServiciosTEST/api/gestion/ObtenerMaximosMinimos
13.1. Parameters
invocación POST.
13.2. Return Value

Type: JSON
[
{
"asi_prc_FechaCierre": "2023-01-04T00:00:00",
"asi_prc_CodigoEmisor": "21 ",
"asi_prc_Abreviatura": "PCD ",
"asi_prc_NombreEmisor": "PICHINCHA BANCO",
"asi_prc_PrecioCierreBVQ": 86.0,
"asi_prc_NumeroAccionesBVQ": 573,
"asi_prc_PrecioAperturaBVQ": 90.0,
"asi_prc_PrecioCierreBVG": 87.0,
"asi_prc_NumeroAccionesBVG": 45,
"asi_prc_Liquidez": "1",
"asi_prc_PrecioMaximo": 95.7,
"asi_prc_PrecioMinimo": 78.3,
"asi_prc_NumeroOperacion": "21,611",
"asi_prc_BolsaCierre": "0",
"asi_prc_ValNomAcc": 100.0,
"asi_prc_FechaCierreBVQ": "2022-12-15T00:00:00",

"asi_prc_FechaCierreBVG": "2022-11-16T00:00:00",
"asi_prc_CodTit": "19 ",
"asi_prc_Estado": "A"
},
asi_prc_Fecha: Fecha de negociación

asi_prc_FechaCierre: Fecha que registró precio de cierre
asi_prc_Abreviatura: Abreviatura de Emisor
asi_prc_NombreEmisor: Nombre del Emisor
asi_prc_PrecioCierreBVQ: Precio de cierre BVQ
asi_prc_NumeroAccionesBVQ: Número de acciones BVQ
asi_prc_PrecioAperturaBVQ: Precio de apertura BVQ
asi_prc_PrecioCierreBVG: Precio de cierre BVG
asi_prc_NumeroAccionesBVG: Número de acciones BVG
asi_prc_PrecioMaximo: Precio Máximo
asi_prc_PrecioMinimo: Precio Mínimos
asi_prc_BolsaCierre: Bolsa de Valores en la cual se generó el cierre
asi_prc_ValNomAcc: Valor Nominal de la acción
asi_prc_FechaCierreBVQ: Fecha de cierre BVQ
asi_prc_FechaCierreBVG: Fecha de cierre BVG
asi_prc_CodTit: Tipo de título
asi_prc_Estado: Líquidas, Medianamente líquidas y no líquidas

Servicios API-BVQ (PICAVALCV) - V3

Cargado por

Copyright:

Formatos disponibles

Servicios API-BVQ (PICAVALCV) - V3

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Servicios API-BVQ (PICAVALCV) - V3

Cargado por

Copyright:

Formatos disponibles

Av.

Amazonas 540 y Carrión

Diccionario de métodos, parámetros y resultados

PICAVAL CASA DE VALORES S.A.

Información del Documento

REVISADO POR: [Marcelo Aguilar]

© BVQ CONFIDENCIAL Pág. 2 de 40

2.2. Return Value

© BVQ CONFIDENCIAL Pág. 3 de 40

3. Método: Obtener Catálogos

NOMBRE DEL CATÁLOGO CÓDIGO

© BVQ CONFIDENCIAL Pág. 4 de 40

3.2. Return Value

Vector de Objetos en formato Json

3.3. Atributos del Objeto JSON

4. Método: Obtener Actividad Económica

4.1. Return Value

Vector de Objetos en formato Json

© BVQ CONFIDENCIAL Pág. 5 de 40

4.2. Atributos del Objeto JSON

5. Método: Obtener Lista Comitentes

5.2. Return Value

Vector de Objetos en formato Json

© BVQ CONFIDENCIAL Pág. 6 de 40

5.3. Atributos del Objeto JSON

6. Método: Obtener Comitentes por ID

Persona Natural {"ID":637}

6.2. Return Value

Vector de Objetos en formato Json

JSON – Persona Natural

© BVQ CONFIDENCIAL Pág. 7 de 40

© BVQ CONFIDENCIAL Pág. 8 de 40

© BVQ CONFIDENCIAL Pág. 9 de 40

© BVQ CONFIDENCIAL Pág. 10 de 40

© BVQ CONFIDENCIAL Pág. 11 de 40

© BVQ CONFIDENCIAL Pág. 12 de 40

"PCFG_PREGUNTA": "¿Planea retirar su dinero?",

© BVQ CONFIDENCIAL Pág. 13 de 40

"PCFG_PREGUNTA": "¿A cuál de los siguientes criterios le daría Ud. Prefer

PERSONA_NATURAL: Contiene información detallada de la persona natural

PNA_ID: ID principal de persona natural

© BVQ CONFIDENCIAL Pág. 14 de 40

PNA_NACIONALIDAD: Nacionalidad (Catálogo – NACIONALIDAD “PRE_NAC”)

PERSONAPODER_PERSONA: PN-no contiene información

CUENTA_COMITENTE: Contiene información de la cuenta comitente (sección principal)

CTC_ID: ID cuenta comitente

© BVQ CONFIDENCIAL Pág. 15 de 40

CTC_ACTUALIZA_USR: Usuario de actualización (ID método de Usuarios)

PERSONA_JURIDICA: No genera información para Persona Natural

CUENTA_BANCARIA: Contiene información de las cuentas bancarias.

CTB_ID: ID cuenta bancaria

TARJETA_CREDITO: Contiene información de tarjetas de crédito.

TJC_ID: ID tarjeta de crédito,

INGRESO_EGRESO_CLIENTECTC_TOTAL_INGRESOS: Contiene información de los detalles de ingresos.

IEC_ID: ID del ingreso bancario

© BVQ CONFIDENCIAL Pág. 16 de 40

INGRESO_EGRESO_CLIENTECTC_TOTAL_EGRESOS: Contiene información de los detalles de egresos.

IEC_ID: ID del ingreso bancario

ACTIVO_CLIENTECTC_TOTAL_INMUEBLES: Contiene información de los detalles de activos inmuebles.