Diferencias

Muestra las diferencias entre dos versiones de la página.

--- atj:doc:documentacion_integracion_neozink [2021/04/19 13:30] – [Relación de los contratos emitidos a un cliente] juanma
+++ atj:doc:documentacion_integracion_neozink [2021/07/12 12:17] (actual) – [Albaranes confirmados de un contrato] juanma
@@ Línea 14: / Línea 14: @@
 === Otros ===
 Para los ejemplos, se ha utilizado "Postman v8.0.4"
+Ticket: #223382
 ----
 ====== Datos del cliente ======
@@ Línea 27: / Línea 29: @@
   - S_POBLACION VARCHAR(60),
   - S_TELEFONO VARCHAR(60),
-  - S_CORREO_E VARCHAR(254)
+  - S_CORREO_E VARCHAR(254),
+  - S_PORC_DTO_ALQ NUMERIC(17,5)
 === Comportamiento ===
 Devuelve la información relativa al primer cliente que el sistema encuentre cuyo CIF/NIF coincida con el introducido como parámetro.
@@ Línea 113: / Línea 116: @@
   - S_DESCRIPCION3 VARCHAR(60),
   - S_DESCRIPCION4 VARCHAR(60),
-  - S_POBLACION VARCHAR(60)
+  - S_POBLACION VARCHAR(60),
+  - S_PORC_DTO_ALQ NUMERIC(17,5)
 === Comportamiento ===
 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.
@@ Línea 277: / Línea 281: @@
 === Comportamiento ===
 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.
+=== Ejemplos ===
+== Estado de depósitos filtrando por nombre de artículo ==
+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.
+<code>
+{
+  "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%"}
+    }
+  ]
+}
+</code>
+== Estado de depósitos filtrando por nombre de artículo sin distinguir mayúsculas y minúsculas ==
+Aplicamos la función UPPER a ambos lados del operador LIKE.
+<code>
+{
+  "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%"}
+    }
+  ]
+}
+</code>
+== Estado de depósitos para un número de serie y nombre de obra ==
+En este caso, para el número de serie no es de utilidad el uso del comodín.
+<code>
+{
+  "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"}
+    }
+  ]
+}
+</code>
 ----
@@ Línea 327: / Línea 385: @@
       "sql":"SELECT * FROM XATJ_NZK_CONTRATOS_CLIENTE2(:Codigo, :Vivos) ORDER BY S_FECHA DESC",
       "params": { "Codigo" : "027893"}
+    }
+  ]
+}
+</code>
+== Los contratos de una fecha  ==
+Para los filtros de fecha es preciso utilizar la función F_STRIPTIME para que de ella se elimine la información de hora.
+<code>
+{
+  "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"}
     }
   ]
@@ Línea 413: / Línea 488: @@
 ----
+====== Albaranes confirmados de un contrato ======
+=== Procedimiento ===
+XATJ_NZK_ALBARANES_CTO
+=== Parámetros ===
+  - P_NRO_CTO VARCHAR(10)
+=== Resultados ===
+  - S_NRO_ALBARAN VARCHAR(10),
+  - S_TIPO_ALBARAN VARCHAR(10)
+=== Comportamiento ===
+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:
+  - E: Albarán de entrega
+  - R: Albarán de recogida
+  - F: Albarán de alquiler. El albarán de alquiler es de uso interno y, en principio, no debería estar a disposición del cliente.
+----
 == Control de cambios del documento ==
+ --- //[[juanma@smartastur.com|Juanma]] 2021/07/12 12:16// Albaranes de un contrato
+ --- //[[juanma@smartastur.com|Juanma]] 2021/06/04 17:07// Porcentajes de dto. alquiler para clientes y obras
+ --- //[[juanma@smartastur.com|Juanma]] 2021/05/12 09:56// Mayúsculas y minúsculas
+ --- //[[juanma@smartastur.com|Juanma]] 2021/05/12 08:40// Aplicación de filtros
  --- //[[juanma@smartastur.com|Juanma]] 2021/04/19 13:23// Descarga facturas