POST
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.
Para los ejemplos, se ha utilizado “Postman v8.0.4”
Ticket: #223382
XATJ_NZK_DATOS_CLIENTE
Devuelve la información relativa al primer cliente que el sistema encuentre cuyo CIF/NIF coincida con el introducido como parámetro.
En caso de que no se encuentre ninguno, el parámetro S_RAZON_SOCIAL tendrá el valor <INEXISTENTE>.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_DATOS_CLIENTE(:CifNif)", "params": { "CifNif" : "B70180823"} } ] }
{ "version": "1.2", "resultados": [ { "estado": "OK", "metaData": { "S_CODIGO": { "tipo": "ftString", "etiqueta": "Código" }, "S_RAZON_SOCIAL": { "tipo": "ftString", "etiqueta": "Razón social" }, "S_DIRECCION": { "tipo": "ftString", "etiqueta": "Dirección" }, "S_COD_POSTAL": { "tipo": "ftString", "etiqueta": "Cód. postal" }, "S_POBLACION": { "tipo": "ftString", "etiqueta": "Población" }, "S_TELEFONO": { "tipo": "ftString", "etiqueta": "Teléfono" }, "S_CORREO_E": { "tipo": "ftString", "etiqueta": "Correo electrónico" } }, "datos": [ { "S_CODIGO": "027893", "S_RAZON_SOCIAL": "CHF SOLUCIONES CERRAJERAS, S.L.", "S_DIRECCION": "LUGAR AGRA - NOVA S/N POUSADA", "S_COD_POSTAL": "15881", "S_POBLACION": "BOQUEIXON", "S_TELEFONO": "628263544", "S_CORREO_E": "administracion@chfsolucionescerrajeras.es" } ] } ] }
XATJ_NZK_OBRAS_CLIENTE
Devuelve una relación de las obras activas del cliente identificado mediante el parámetro P_CODIGO. Este identificativo puede ser el CIF/NIF o el código que devuelve el procedimiento XATJ_NZK_DATOS_CLIENTE.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_OBRAS_CLIENTE(:Codigo)", "params": { "Codigo" : "B70180823"} } ] }
{ "version": "1.2", "resultados": [ { "estado": "OK", "metaData": { "S_CODIGO": { "tipo": "ftString", "etiqueta": "Código" }, "S_DESCRIPCION": { "tipo": "ftString", "etiqueta": "Descripción" }, "S_DESCRIPCION2": { "tipo": "ftString", "etiqueta": "Descripción 2" }, "S_DESCRIPCION3": { "tipo": "ftString", "etiqueta": "Descripción 3" }, "S_DESCRIPCION4": { "tipo": "ftString", "etiqueta": "Descripción 4" }, "S_POBLACION": { "tipo": "ftString", "etiqueta": "Población" } }, "datos": [ { "S_CODIGO": "OB040472", "S_DESCRIPCION": "Sus instalaciones Boqueixon", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB040577", "S_DESCRIPCION": "Nave Bein Sport P. Ind. de Palas de Rei", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB040579", "S_DESCRIPCION": "P. Tambre", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB040597", "S_DESCRIPCION": "Lalín ", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB041369", "S_DESCRIPCION": "A Golada, Pontevedra", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB041649", "S_DESCRIPCION": "Avicola O Porto, Sobrado (A Coruña)", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB041990", "S_DESCRIPCION": "Candido, Lalín (Pontevedra)", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB042125", "S_DESCRIPCION": "Toques, A Coruña", "S_DESCRIPCION2": "SOLER", "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB042418", "S_DESCRIPCION": "Pepito, Toques, A Coruña", "S_DESCRIPCION2": "SOLER", "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB043062", "S_DESCRIPCION": "Cristina, Toques, A Coruña", "S_DESCRIPCION2": null, "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" }, { "S_CODIGO": "OB043201", "S_DESCRIPCION": "GASOLINERA A BÁSCULA ( MEICENDE )", "S_DESCRIPCION2": "Comisión: Soler Gabín", "S_DESCRIPCION3": null, "S_DESCRIPCION4": null, "S_POBLACION": "BOQUEIXON" } ] } ] }
XATJ_NZK_ESTADO_DEPOSITO
Presenta la información precisa para la elaboración del informe de “estado de depósitos” para el cliente con el identificativo facilitado en P_CODIGO. Este identificativo puede ser el CIF/NIF o el código que devuelve el procedimiento XATJ_NZK_DATOS_CLIENTE.
En los filtros para textos el símbolo de porcentaje actúa como comodín, al estilo del asterisco en la línea de comandos de los sistemas operativos más comunes.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_ESTADO_DEPOSITO(:Codigo) WHERE S_NOM_ARTICULO LIKE :nombreArticulo", "params": { "Codigo" : "027893", "nombreArticulo" : "%DUMPER%"} } ] }
Aplicamos la función UPPER a ambos lados del operador LIKE.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_ESTADO_DEPOSITO(:Codigo) WHERE UPPER(S_NOM_ARTICULO) LIKE UPPER(:nombreArticulo)", "params": { "Codigo" : "027893", "nombreArticulo" : "%dumPer%"} } ] }
En este caso, para el número de serie no es de utilidad el uso del comodín.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_ESTADO_DEPOSITO(:Codigo) WHERE S_NOM_ALMACEN LIKE :nombreObra AND S_NRO_SERIE=:nroSerie", "params": { "Codigo" : "027893", "nombreObra" : "%LA GRELA%", "nroSerie" : "000789"} } ] }
XATJ_NZK_CONTRATOS_CLIENTE2
Relación de los números de contrato emitidos a un cliente.
El parámetro P_VIVOS sirve para filtrar según se indica a continuación:
El P_CODIGO puede ser el CIF/NIF o el código que devuelve el procedimiento XATJ_NZK_DATOS_CLIENTE.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_CONTRATOS_CLIENTE2(:Codigo, :Vivos)", "params": { "Codigo" : "027893", "Vivos" : "S"} } ] }
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_CONTRATOS_CLIENTE2(:Codigo, :Vivos) ORDER BY S_FECHA DESC", "params": { "Codigo" : "027893"} } ] }
Para los filtros de fecha es preciso utilizar la función F_STRIPTIME para que de ella se elimine la información de hora.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_CONTRATOS_CLIENTE2(:Codigo, :Vivos) WHERE F_STRIPTIME(S_FECHA)=:fecha", "params": { "Codigo" : "027893", "fecha" : "7/5/2021"} } ] }
XATJ_NZK_DATOS_CONTRATO
En P_COD_CTO_ALQ se habrá de indicar alguno de los valores obtenidos de ATJ_NZK_CONTRATOS_CLIENTE2.S_COD_CTO_ALQ.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_DATOS_CONTRATO(:Contrato)", "params": { "Contrato" : "S19-002991"} } ] }
XATJ_NZK_DESCARGA_FACTURAS
Devuelve los datos fundamentales de las facturas del cliente, así como la URL local para proceder a su descarga o visualización.
{ "version" : "1.2", "metodo" : "Raw", "opciones" : { "metaData":true }, "comandos" : [ { "sql":"SELECT * FROM XATJ_NZK_DESCARGA_FACTURAS(:Codigo) ORDER BY S_FECHA_EMISION DESC", "params": { "Codigo" : "027893"} } ] }
XATJ_NZK_ALBARANES_CTO
Devuelve todos los albaranes confirmados correspondientes al contrato cuyo número se indica como parámetros.
Los tipos de albarán posibles para S_TIPO_ALBARAN son:
— Juanma 2021/07/12 12:16 Albaranes de un contrato
— Juanma 2021/06/04 17:07 Porcentajes de dto. alquiler para clientes y obras
— Juanma 2021/05/12 09:56 Mayúsculas y minúsculas
— Juanma 2021/05/12 08:40 Aplicación de filtros
— Juanma 2021/04/19 13:23 Descarga facturas
— Juanma 2021/04/19 12:41 Datos de un contrato
— Juanma 2021/04/19 12:22 Relación de contratos
— Juanma 2021/04/19 11:39 Estado de depósitos
— Juanma 2021/04/19 10:51 Obras de cliente
— Juanma 2021/04/19 10:17 Documento inicial. Datos de un cliente.