Versions Compared

Version Old Version 4 New Version Current
Changes made by

Fernando Peña

Fernando Peña

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por clienteinmobiliaria

Datos de salida 

Atributo

Tipo Dato

Descripción

hash

String

Key única por clienteinmobiliaria

name

String

Nombre corto inmobiliaria

hasPreEntrega

Int

Flag que indica si tiene activas las pre entregas

locale

String

Lenguaje inmobiliaria

rutInmobiliaria

String

Rut inmobiliaria

inmobiliariaName

String

Nombre completo inmobiliaria

apiPath

String

URL API

path

String

URL PVI

appPreEntregaInterna

Int

Flag que indica si tiene activas las pre entregas internas

appPreEntregaInmobiliaria

Int

Flag que indica si tiene activas las pre entregas inmobiliaria

appPreEntregaTercero

Int

Flag que indica si tiene activas las pre entregas a terceros

appEntregaPropietario

Int

Flag que indica si tiene activas las entregas a propietarios

appEntregaTercero

Int

Flag que indica si tiene activas las entregas a terceros

tieneCalificacionFalla

Int

Flag que indica si tiene activas las clasificaciones de falla

tienePruebaFuncionalidad

Int

Flag que indica si tiene activas las pruebas funcionales

appVersion

String

Versión App móvil

...

Code Block
languagejson
{

    "hash": "cHZpX3ZlbnRhcw",

    "name": "ventas",

    "hasPreEntrega": "1",

    "locale": "es_CL",

    "rutInmobiliaria": "17031301-1",

    "inmobiliariaName": "Inmobiliaria PLANOK",

    "apiPath": "https://www.pvi.cl/api/v2/",

    "path": "https://www.pvi.cl/ventas/img/logos_clientes/planoklogo.jpg",

    "appPreEntregaInterna": "1",

    "appPreEntregaInmobiliaria": "1",

    "appPreEntregaTercero": "1",

    "appEntregaPropietario": "1",

    "appEntregaTercero": "1",

    "tieneCalificacionFalla": "1",

    "tienePruebaFuncionalidad": "1",

    "appVersion": null "1.2.3"

}

 

POST /user/login

 

Servicio para realizar login en la api con credenciales de usuario, con este servicio se obtiene el token JWT para el consumo de los demás servicios

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

Usuariousuario

String

Requerido

Nombre del usuario

Passwordpassword

String

Requerido

Contraseña del usuario

Clientecliente_hash

String

Requerido

Hash del cliente entregada por el servicio GET /client

Datos de salida:

Atributo

Tipo Dato

Descripción

token

String

Token JWT generado para realizar las peticiones posteriores

userId

Int

Identificador único de usuario

userUsername

String

Nombre de usuario

userName

String

Nombre completo de usuario

userMail

String

Email usuario

Ejemplo:

Code Block
languagejson
{

    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VySWQiOiIxIiwidXNlclVzZXJuYW1lIjoicGxhbm9rIiwidXNlck5hbWUiOiJQT0sgLSBFSkVDVVRJVk8gUExBTk9LIiwiY29tcGFueUhhc2giOiJjSFpwWDNabGJuUmhjdyIsInVzZXJIYXNoIjoiTjJNeU1qSm1Zakk1TWpka09ESTRZV1l5TW1ZMU9USXhNelJsT0Rrek1qUTRNRFl6TjJNd1pBIn0.rqGigqLeVm1ollRU_nBMHdHNDvWxXlo7OL6wcy8L3Zs",

    "userId": "1",

    "userUsername": "planok",

    "userName": "POK - EJECUTIVO PLANOK",

    "userMail": "gpena@planok.com"

}

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por cliente

...

inmobiliaria

 Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único de proyecto

nombre

String

Nombre proyecto

direccion

String

Dirección proyecto

comuna

String

Comuna proyecto

cantidadEtapas

Int

Cantidad de etapas del proyecto

fechaCreacion

Datetime

Fecha de creación proyecto

fechaEdicion

Datetime

Fecha de edición proyecto

Ejemplo:

Code Block
languagejson
{

        "id": "47",

        "nombre": "LOS ALERCES",

        "direccion": "LA SERENA",

        "comuna": "PROVIDENCIA",

        "codigoProyecto": "LALERC",

        "cantidadEtapas": "1",

        "fechaCreacion": null,

        "fechaEdicion": "2021-01-25 13:11:06"

}

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por clienteinmobiliaria

ID ProyectoidProyecto

Int

Requerido

Identificados único del proyecto

...

proyecto

  Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único etapa

nombre

String

Nombre etapa

cantidadPropiedades

Int

Número de productos/propiedades etapa

fechaCreacion

Datetime

Fecha creación etapa

fechaEdicion

Datetime

Fecha modificación etapa

fechaRecepcionMunicipal

Date

Fecha recepción municipal etapa

Ejemplo:

Code Block
languagejson
{

         "id": "34",

         "nombre": "ETAPA A",

         "cantidadPropiedades": "6",

         "fechaCreacion": null,

         "fechaEdicion": "2021-01-06 17:28:33",

         "fechaRecepcionMunicipal": "2012-10-01"

 }

 

/GET productos

Servicio que entrega el listado de productos/propiedades de la inmobiliaria según filtro enviado

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por clienteinmobiliaria

idProyecto

Opcional

Identificador único proyecto

idEtapa

Opcional

Identificador único etapa

idPropiedad

Opcional

Identificador único producto/propiedad

idPropietario

Opcional

Identificador único propietario

estado

Opcional

Estado entrega (Entregada, NoEntregada)

 Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único producto/propiedad

idPropietario

Int

Identificador único propietario

nombre

String

Nombre producto/propiedad

tipoVivienda

String

Tipo de producto/propiedad

estacionamiento

String

Estacionamientos asociados

bodega

String

Bodegas asociadas

fechaCreacion

Datetime

Fecha de creación

fechaEdicion

Datetime

Fecha de edición

fechaEntrega

Date

Fecha de entrega

fechaConservadorBienesRaices

Date

Fecha de inscripción en conservador de bienes raíces

valorVentaUF

Float

Valor de venta producto/propiedad (Sólo si está habilitada configuración)

documentoActaEntrega

String

URL documento acta de entrega

 

Ejemplo:

Code Block
languagejson
{

        "id": "1494",

        "idPropietario": "1870",

        "nombre": "LOA - DEPTO. 201",

        "tipoVivienda": "DEPARTAMENTO",

        "estacionamiento": "",

        "bodega": "",

        "fechaCreacion": null,

        "fechaEdicion": null,

        "fechaEntrega": "0000-00-00",

        "fechaConservadorBienesRaices": "2012-10-01",

        "valorVentaUF": null,

        "documentoActaEntrega": ""

 }

 

/GET propietarios

Servicio que entrega el listado de propietarios de la inmobiliaria según filtro enviado

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por clienteinmobiliaria

idProyecto

Int

Opcional

Identificador único proyecto

idPropietario

Int

Opcional

Identificador único propietario

idEtapa

Int

Opcional

Identificador único etapa

idPropiedad

Int

Opcional

Identificador único producto/propiedad

 Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único de propietario

nombre

String

Nombre completo

rut

String

Rut

celular

String

Número celular

fonoCasa

String

Número casa

fonoOficina1

String

Número oficina principal

fonoOficina2

String

Número oficina secundario

email

String

Email

fechaCreacion

Datetime

Fecha de creación

fechaEdicion

Datetime

Fecha de edición

 

Ejemplo:

Code Block
languagejson
{

        "id": "31",

        "nombre": "SILVANO EVANGELISTA",

        "rut": "1",

        "celular": "-",

        "fonoCasa": "2725483",

        "fonoOficina1": "-",

        "fonoOficina2": "-",

        "email": "notificaciones_pvi@planok.com",

        "fechaCreacion": null,

        "fechaEdicion": "2020-05-15 20:05:19"

 }

 

/GET solicitudes

Servicio que entrega el listado de solicitudes de la inmobiliaria según filtro enviado

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por cliente

...

inmobiliaria

idSoliciud

Opcional

Identificador único solicitud

idPropietario

Opcional

Identificador único propietario

idEtapa

Opcional

Identificador único etapa

idPropiedad

Opcional

Identificador único producto/propiedad

folio

Opcional

Folio solicitud

fechaEdicionInicio

Opcional

Fecha inicio de edición

fechaEdicionFin

Opcional

Fecha fin de edición

estado

Opcional

Estado solicitud (Abierto, Cerrado o En Curso)

  Datos de salida:

Atributo

Tipo Dato

Descripción

id

Id

Identificador único solicitud

folio

String

Folio solicitud

idProducto

Id

Identificador único de producto/propiedad

medioIngreso

String

Medio de ingreso solicitud

tipoMedioIngreso

String

Categoría medio de ingreso

estado

String

Estado solicitud

fechaSolicitud

Date

Fecha real solicitud

fechaCierre

Date

Fecha real de cierre solicitud

fechaCreacion

Datetime

Fecha de creación

fechaEdicion

Datetime

Fecha de edición

Ejemplo:

Code Block
languagejson
{

        "id": "632",

        "folio": "486-000011",

        "idProducto": "3300",

        "medioIngreso": "TELEFONO",

        "tipoMedioIngreso": "POSTVENTA",

        "estado": "ABIERTO",

        "fechaSolicitud": "2017-06-22",

        "fechaCierre": null,

        "fechaCreacion": null,

        "fechaEdicion": null

 }

 

/POST solicitudes

Servicio que permite crear una nueva solicitud de posventa

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por clienteinmobiliaria

Folio ExternofolioExterno

String

Requerido

Folio o correlativo externo referente a la solicitud

ID ProductoidProducto

Int

Requerido

Identificador único del producto/propiedad

Medio IngresomedioIngreso

String

Requerido

Identificador único del Medio Ingreso

Fecha SolicitudfechaSolicitud

Date

Requerido

Fecha de la solicitud

 Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único de solicitud creada

folio

String

Folio de la solicitud creada

fechaCreacion

Datetime

Fecha de creación

Ejemplo:

Code Block
languagejson
"SUCCESS": {

        "id": "1433",

        "folio": "486-000067",

        "fechaCreacion": "2021-02-01 19:13:14"

 }

 

/GET requerimientos

Servicio que entrega el listado de requerimientos de una solicitud o requerimiento

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por cliente

...

inmobiliaria

idSolicitud

Int

Opcional

Identificador único solicitud

idRequerimiento

Int

Opcional

Identificador único requerimiento

 Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único con el que se creó la solicitud

folio

String

Folio con el que se creó la solicitud

idSolicitud

Datetime

Fecha de creación

estado

String

Estado del requerimiento

idRecinto

Int

Identificador único recinto

idLugar

Int

Identificador único lugar

idItem

Int

Identificador único ítem

idProblema

Int

Identificador único problema

urgencia

Boolean

Urgencia del requerimiento

descripcion

String

Descripción del requerimiento

fechaInicioOrdenInspeccion

Datetime

Fecha de inicio orden de inspección

fechaTerminoOrdenInspeccion

Datetime

Fecha de fin orden de inspección

fechaDiagnostico

Datetime

Fecha del diagnóstico

fechaInicioOrdenTrabajo

Datetime

Fecha de inicio orden de trabajo

fechaTerminoOrdenTrabajo

Datetime

Fecha de fin orden de trabajo

fechaCierre

Date

Fecha de cierre requerimiento

fechaCreacion

Datetime

Fecha de creación

fechaEdicion

Datetime

Fecha de edición

imagenes

JSON

Imágenes/Fotos del requerimiento

 

Ejemplo:

Code Block
languagejson
{

        "id": "8",

        "folio": "PRU-000075/1",

        "idSolicitud": "7",

        "estado": "OT GENERADA",

        "idRecinto": "10018",

        "idLugar": "10058",

        "idItem": "10021",

        "idProblema": "10044",

        "urgencia": false,

        "descripcion": "anclaje quebrado",

        "fechaInicioOrdenInspeccion": "2012-11-07 9:45-",

        "fechaTerminoOrdenInspeccion": "2012-11-07 1:15",

        "fechaDiagnostico": null,

        "fechaInicioOrdenTrabajo": "2013-10-02",

        "fechaTerminoOrdenTrabajo": null,

        "fechaCierre": null,

        "fechaCreacion": "2012-11-05 17:02:04",

        "fechaEdicion": null,

        "imagenes": []

}

 

 

POST /requerimientos

Servicio que permite crear un nuevo requerimiento asociado a una solicitud de posventa previamente creada

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por clienteinmobiliaria

Folio ExternofolioExterno

String

Requerido

Folio o correlativo externo referente al requerimiento

ID SolicitudidSolicitud

Int

Requerido

Identificador único de la solicitud existente

ID RecintoidRecinto

Int

Requerido

Identificador único del recinto

ID LugaridLugar

Int

Requerido

Identificador único del lugar

ID ÍtemidÍtem

Int

Requerido

Identificador único del ítem

ID ProblemaidProblema

Int

Requerido

Identificador único del problema

urgencia

Boolean

Opcional

Urgencia de requerimiento (True,False)

descripcion

String

Opcional

Descripcion del requerimiento

 

 Datos de salida:

Atributo

Tipo Dato

Descripción

id

Int

Identificador único del requerimiento creado

folio

String

Folio del requerimiento creado

fechaCreacion

Datetime

Fecha de creación

Ejemplo:

Code Block
languagejson
"SUCCESS": {

        "id": "2918",

        "folio": "PRU-000075/2",

        "fechaCreacion": "2021-02-01 19:45:47"

 }

 

 

/GET documentos

 

Servicio que entrega el listado de documentos según filtro enviado

...

Atributo

Tipo Dato

Requerido/Opcional

Descripción

key

String

Requerido

Key única por cliente

...

inmobiliaria

idProyecto

Int

Opcional

Identificador único proyecto

idEtapa

Int

Opcional

Identificador único etapa

idProducto

Int

Opcional

Identificador único producto/propiedad

 

 Datos de salida:

Atributo

Tipo Dato

Descripción

idDocumento

Int

Identificador único documento

idProyecto

Int

Identificador único proyecto

idEtapa

Int

Identificador único etapa

idProducto

Int

Identificador único producto/propiedad

nombre

String

Nombre documento

url

String

URL descarga documento

contentType

String

Content type documento

extension

String

Extensión documento

 

Ejemplo:

Code Block
languagejson
{

        "idDocumento": "1",

        "idProyecto": "51",

        "idEtapa": "38",

        "idProducto": "1781",

        "nombre": "7. Credencial.png",

        "url": "https://www.pvi.cl/ventas/CLIENTES/ventas/upload/documentos/7. Credencial.png",

        "contentType": "image/png",

        "extension": "png"

}