Smartwiki

Herramientas de usuario

Herramientas del sitio

Traza: • documentacion_integracion_iknovatio
alv:doc:documentacion_integracion_iknovatio

Tabla de Contenidos

Generalidades

Método

POST

Formato

http://#ip:#puerto/services/ismartwebdoc/?format=json

Puertos posibles

  1. 8000

Direcciones ip posibles

  1. local: 192.168.1.125
  2. wan: 86.109.112.43

Credenciales usuario

Estas credenciales no son precisas para la interfaz, pero se indican aquí para que el administrador de Smart pueda establecer restricciones o privilegios de acceso a tablas y procedimientos.

  1. Id: WEB
  2. Contraseña: alv2512

Otros

Para los ejemplos, se ha utilizado “Postman v9.19.0”

Datos de clientes

Procedimiento

XALV_IKV_CLIENTES

Resultados

  1. S_CLAVE VARCHAR(10),
  2. S_EMPRESA VARCHAR(60),
  3. S_TIPO_TERCERO VARCHAR(10),
  4. S_COD_TERCERO VARCHAR(60),
  5. S_RAZON_SOCIAL VARCHAR(60),
  6. S_DENOMINACION VARCHAR(60),
  7. S_COD_POSTAL VARCHAR(60),
  8. S_POBLACION VARCHAR(60),
  9. S_PROVINCIA VARCHAR(60),
  10. S_CIF_NIF VARCHAR(60),
  11. S_TELEFONO VARCHAR(60),
  12. S_CORREO_E VARCHAR(254)

Comportamiento

Devuelve los datos de todos los clientes activos.

Ejemplo

Cuerpo del método post
{
  "version"  : "1.2",
  "metodo"   : "Select",
  "opciones" : { "metaData":true },
  "params" : ["XALV_IKV_CLIENTES", []]
}
Resultado
{
    "version": "1.1",
    "result": [
        [
            "ALR",
            "ALVEMACO RENTACAR S.L",
            "CL",
            "000020",
            "CONTRATOS ALQUILER CONTADO",
            "CONTRATOS ALQUILER CONTADO",
            "",
            "",
            "",
            "",
            "",
            null
        ],
        [
            "ALR",
            "ALVEMACO RENTACAR S.L",
            "CL",
            "001037",
            "AYUNTAMIENTO TINEO",
            "AYUNTAMIENTO TINEO",
            "33870",
            "TINEO",
            "ASTURIAS",
            "P3307300H",
            "985800232",
            "manuelfg@tineo.es"
        ],
        [
            "ALR",
            "ALVEMACO RENTACAR S.L",
            "CL",
            "001600",
            "ALBA GARCIA, HIGINIO",
            "ALBA GARCIA, HIGINIO",
            "33690",
            "LUGO DE LLANERA",
            "ASTURIAS",
            "14773224W",
            "646 20 84 85",
            null
        ],
        [
            "ALR",
            "ALVEMACO RENTACAR S.L",
            "CL",
            "002114",
            "TABLEROS Y PUENTES,S.A.",
            "TAPUSA",
            "33202",
            "GIJON",
            "ASTURIAS",
            "A33615931",
            "985336611/653840799",
            null
        ],
        [
            "ALR",
            "ALVEMACO RENTACAR S.L",
            "CL",
            "001715",
            "PROCOIN,S.L.",
            "PROCOIN,S.L.",
            "33221",
            "LLANERA",
            "ASTURIAS",
            "B33046046",
            "985980808 / 985262113",
            null
        ],

  . . . .

Datos de documentos de entrega

Procedimiento

XALV_IKV_CONTRATOS

Parámetros

  1. P_CLIENTES VARCHAR(4096): Lista de códigos de clientes separados por comas.
  2. P_FEC_DESDE TIMESTAMP: Fecha desde, en formato dd-mm-aaaa
  3. P_FEC_HASTA TIMESTAMP: Fecha hasta, en formato dd-mm-aaaa
  4. P_NRO_CTO_PPAL VARCHAR(20): Número de documento principal

Los valores de los parámetros se rodean de dobles comillas.

Si algún parámetro ha de omitirse, se ha de poner el literal NULL en su lugar, sin las comillas.

Comportamiento

Devuelve los datos de los documentos de entrega que cumplen los criterios dados por los parámetros.

En los ejemplos se puede ver más claro esto.

Resultados

  1. S_DOCUMENTO_ENTREGA VARCHAR(10),
  2. S_TIPO_TERCERO VARCHAR(10),
  3. S_CODIGO_CLIENTE VARCHAR(10),
  4. S_RAZON_CLIENTE VARCHAR(60),
  5. S_DENOMINACION_CLIENTE VARCHAR(60),
  6. S_CODIGO_OBRA VARCHAR(10),
  7. S_DESCRIPCION_OBRA VARCHAR(60),
  8. S_DESCRIPCION_VEHICULO VARCHAR(60),
  9. S_OBSERVACIONES VARCHAR(254),
  10. S_REFERENCIA VARCHAR(20),
  11. S_MATRICULA VARCHAR(20),
  12. S_PRECIO_DIA NUMERIC(17,5),
  13. S_PRECIO_MES NUMERIC(17,5),
  14. S_FRANQUICIA NUMERIC(17,5),
  15. S_TODORIESGO VARCHAR(10),
  16. S_PRECIO_TODORIESGO NUMERIC(17,5),
  17. S_CODIGO_SEGURO VARCHAR(10),
  18. S_DIAS_ALQUILER INTEGER,
  19. S_PLAZO_CONTRATO VARCHAR(10),
  20. S_VENCIMIENTO TIMESTAMP,
  21. S_MAX_KMDIA NUMERIC(17,5),
  22. S_PRECIO_KMEXCESO NUMERIC(17,5),
  23. S_CONTRATO VARCHAR(20),
  24. S_DNI_ENTREGA VARCHAR(20),
  25. S_NOMBRE_ENTREGA VARCHAR(60),
  26. S_FECHA_ENTREGA TIMESTAMP,
  27. S_FECHA_INICIOCTO TIMESTAMP,
  28. S_KM_ENTREGA NUMERIC(17,5),
  29. S_IMPORTE_COMBUSTIBLE NUMERIC(17,5),
  30. S_NIVEL_COMBUSTIBLE VARCHAR(10),
  31. S_ACCESORIOS VARCHAR(4096): Lista de accesorios separados por coma.

Los parámetros se corresponden con la lista proporcionada por Jorge Santos.

Ejemplo 1

Todos los documentos de entrega del cliente número 005662 

{
  "version"  : "1.2",
  "metodo"   : "Select",
  "opciones" : { "metaData":true },
  "params" : ["XALV_IKV_CONTRATOS", ["005662", NULL, NULL, NULL]]
  
}

Ejemplo 2

Todos los documentos de entrega del mes de enero 

{
  "version"  : "1.2",
  "metodo"   : "Select",
  "opciones" : { "metaData":true },
  "params" : ["XALV_IKV_CONTRATOS", [NULL, "1-1-2023", "1-31-2023", NULL]]
  
}

Ejemplo 3

Los documentos de entrega del 13 de enero de los clientes 005662 y 011604 

{
  "version"  : "1.2",
  "metodo"   : "Select",
  "opciones" : { "metaData":true },
  "params" : ["XALV_IKV_CONTRATOS", ["005662,011604", "13-1-2023", "13-1-2023", NULL]]
  
}

Ejemplo 4

El documento de entrega correspondiente al contrato número 234989099 

{
  "version"  : "1.2",
  "metodo"   : "Select",
  "opciones" : { "metaData":true },
  "params" : ["XALV_IKV_CONTRATOS", [NULL, NULL, NULL, "234989099"]]
  
}

Datos de documentos de recogida

Procedimiento

XALV_IKV_RECOGIDAS

Parámetros

  1. P_CLIENTES VARCHAR(4096): Lista de códigos de clientes separados por comas.
  2. P_FEC_DESDE TIMESTAMP: Fecha desde, en formato dd-mm-aaaa
  3. P_FEC_HASTA TIMESTAMP: Fecha hasta, en formato dd-mm-aaaa
  4. P_NRO_CTO_PPAL VARCHAR(20): Número de documento principal

Los valores de los parámetros se rodean de dobles comillas.

Si algún parámetro ha de omitirse, se ha de poner el literal NULL en su lugar, sin las comillas.

Comportamiento

Una recogida tiene como identificativo el mismo que el del documento de entrega a él vinculado.

Este procedimiento devuelve los datos concernientes a la finalización del alquiler de los documentos de entrega.

Funciona de forma análoga al procedimiento XALV_IKV_CONTRATOS, con el que comparte gran parte de los datos. Así pues, el procedimiento XALV_IKV_RECOGIDAS presenta los mismos registros que XALV_IKV_CONTRATOS, exceptuando aquéllos para los que no exista “Fecha de recogida”.

El período de selección de fechas se realiza sobre “Fecha de recogida”.

Resultados

  1. S_DOCUMENTO_ENTREGA VARCHAR(10),
  2. S_TIPO_TERCERO VARCHAR(10),
  3. S_CODIGO_CLIENTE VARCHAR(10),
  4. S_RAZON_CLIENTE VARCHAR(60),
  5. S_DENOMINACION_CLIENTE VARCHAR(60),
  6. S_CODIGO_OBRA VARCHAR(10),
  7. S_DESCRIPCION_OBRA VARCHAR(60),
  8. S_DESCRIPCION_VEHICULO VARCHAR(60),
  9. S_OBSERVACIONES VARCHAR(254),
  10. S_REFERENCIA VARCHAR(20),
  11. S_MATRICULA VARCHAR(20),
  12. S_PRECIO_DIA NUMERIC(17,5),
  13. S_PRECIO_MES NUMERIC(17,5),
  14. S_FRANQUICIA NUMERIC(17,5),
  15. S_TODORIESGO VARCHAR(10),
  16. S_PRECIO_TODORIESGO NUMERIC(17,5),
  17. S_CODIGO_SEGURO VARCHAR(10),
  18. S_DIAS_ALQUILER INTEGER,
  19. S_PLAZO_CONTRATO VARCHAR(10),
  20. S_VENCIMIENTO TIMESTAMP,
  21. S_MAX_KMDIA NUMERIC(17,5),
  22. S_PRECIO_KMEXCESO NUMERIC(17,5),
  23. S_CONTRATO VARCHAR(20),
  24. S_DNI_RECOGIDA VARCHAR(20),
  25. S_NOMBRE_RECOGIDA VARCHAR(60),
  26. S_FECHA_RECOGIDA TIMESTAMP,
  27. S_FECHA_BAJA TIMESTAMP,
  28. S_KM_RECOGIDA NUMERIC(17,5),
  29. S_IMPORTE_RELLENO NUMERIC(17,5),
  30. S_NIVEL_COMBUSTIBLE VARCHAR(10): a la recogida, se entiende.
  31. S_ACCESORIOS VARCHAR(4096): Lista de accesorios separados por coma.

Tipos de accesorio

Dado que, según el documento de requerimientos facilitado por Jorge Santos, es preciso actualizar en Smart los accesorios para un documento de entrega, se facilita esta interfaz para proporcionar la lista de los que están registrados en la aplicación.

Procedimiento

XALV_IKV_TIPOS_ACCESORIO

Resultado

  1. S_ACCESORIO VARCHAR(10))

Actualizaciones de Smart

Los siguientes servicios permiten actualizar ciertos datos de los documentos de entrega registrados en Smart.

En todos los casos, si la actualización se realiza correctamente, el resultado será el texto “OK”.

Cambiar el DNI del conductor

Procedimiento para la entrega

XALV_IKV_DNI_ENTREGA

Procedimiento para la recogida

XALV_IKV_DNI_RECOGIDA

Parámetros

  1. P_DOCUMENTO_ENTREGA VARCHAR(10),
  2. P_DNI VARCHAR(20))

Resultado

  1. S_RESULTADO VARCHAR(60)

Ejemplo

{
  "version"  : "1.2",
  "metodo"   : "Select",
  "params" : ["XALV_IKV_DNI_ENTREGA", ["234989099", "B12345678"]]
}

Cambiar las fechas

Procedimiento para la fecha de entrega

XALV_IKV_FECHA_ENTREGA

Procedimiento para la fecha de recogida

XALV_IKV_FECHA_RECOGIDA

Procedimiento para la fecha de baja

XALV_IKV_FECHA_BAJA

Parámetros

  1. P_DOCUMENTO_ENTREGA VARCHAR(10),
  2. P_FECHA TIMESTAMP)

Resultado

  1. S_RESULTADO VARCHAR(60))

Ejemplo

{
  "version"  : "1.2",
  "metodo"   : "Select",
  "params" : ["XALV_IKV_FECHA_BAJA", ["234989099", "01-11-2022"]]
}

Cambiar kilómetros del vehículo

Procedimiento para los kilómetros de entrega

XALV_IKV_KM_ENTREGA

Procedimiento para los kilómetros de recogida

XALV_IKV_KM_RECOGIDA

Parámetros

  1. P_DOCUMENTO_ENTREGA VARCHAR(10),
  2. P_KM NUMERIC(17,5))

Resultado

  1. S_RESULTADO VARCHAR(60))

Cambiar el nivel de combustible

Procedimiento para le entrega

XALV_IKV_NIVEL_COMBUSTIBLE

Procedimiento para la recogida

XALV_IKV_NIVEL_COMBUSTIBLE_REC

Parámetros

  1. P_DOCUMENTO_ENTREGA VARCHAR(10),
  2. P_NIVEL VARCHAR(10))

Resultado

  1. S_RESULTADO VARCHAR(60))

Cambiar nombre del conductor

Procedimiento para la entrega

XALV_IKV_NOMBRE_ENTREGA

Procedimiento para la recogida

XALV_IKV_NOMBRE_RECOGIDA

Parámetros

  1. P_DOCUMENTO_ENTREGA VARCHAR(10),
  2. P_NOMBRE VARCHAR(20))

Resultado

  1. S_RESULTADO VARCHAR(60))

Registrar los accesorios

Procedimiento para la entrega

XALV_IKV_ACCESORIOS

Procedimiento para la recogida

XALV_IKV_ACCESORIOS_RECOGIDA

Parámetros

  1. P_DOCUMENTO_ENTREGA VARCHAR(10),
  2. P_LISTA_ACCESORIOS VARCHAR(4096): Lista de tipos de accesorio separados por comas. Ver la consulta de tipos de accesorio más arriba.

Resultado

  1. S_RESULTADO VARCHAR(10))

— Juanma 2023/06/05 10:33 Modificación de datos de recogida

— Juanma 2023/05/05 10:57 Datos de recogidas

— Juanma 2023/01/13 17:34 Implementación servicios

— Juanma 2022/09/21 10:02 Test ok ip global

— Juanma 2022/07/06 17:32

alv/doc/documentacion_integracion_iknovatio.txt · Última modificación: 2023/09/01 19:17 por stefan
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki