Herramientas de usuario

Herramientas del sitio


atj:doc:documentacion_integracion_unayta

Diferencias

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

Enlace a la vista de comparación

Próxima revisión
Revisión previa
atj:doc:documentacion_integracion_unayta [2021/12/14 13:39] – creado juanmaatj:doc:documentacion_integracion_unayta [2022/01/14 14:27] (actual) – [Relación de maquinaria] juanma
Línea 16: Línea 16:
  
 ---- ----
-====== Datos del cliente ======+====== Relación de maquinaria ======
 === Procedimiento === === Procedimiento ===
-XATJ_NZK_DATOS_CLIENTE +XATJ_UNY_RELACION_MAQUINARIA
-=== Parámetros === +
-  - P_CIF_NIF VARCHAR(20)+
 === Resultados === === Resultados ===
-  - S_CODIGO VARCHAR(10), +  - S_NRO_SERIE VARCHAR(20), 
-  - S_RAZON_SOCIAL VARCHAR(60), +  - S_NOMBRE VARCHAR(60), 
-  - S_DIRECCION VARCHAR(60), +  - S_ESTADO VARCHAR(10), 
-  - S_COD_POSTAL VARCHAR(20), +  - S_TIMESTAMP TIMESTAMP
-  - S_POBLACION VARCHAR(60), +
-  - S_TELEFONO VARCHAR(60), +
-  - S_CORREO_E VARCHAR(254), +
-  - S_PORC_DTO_ALQ NUMERIC(17,5)+
 === Comportamiento === === Comportamiento ===
-Devuelve la información relativa al primer cliente que el sistema encuentre cuyo CIF/NIF coincida con el introducido como parámetro.+Devuelve la relación de todos los activos inventariados y su estado en el momento de la consulta. 
 + 
 +Ha te tomarse esta consulta como algo preliminar, pues de esta relación completa de activos habrá que extraer los que no están sujetos al alquiler en el ámbito de la explotación de la empresa. 
 + 
 +S_ESTADO podrá devolver dos valores: 
 +  * ALQUILADA: En el momento de la recogida la máquina se encuentra afecta a un contrato de alquiler. 
 +  * RECOGIDA: Maquinaria no afecta a un contrato de alquiler. Se incluyen máquinas averiadas, en revisión, etc.
  
-En caso de que no se encuentre ninguno, el parámetro S_RAZON_SOCIAL tendrá el valor <INEXISTENTE>.+S_TIMESTAMP devuelve la fecha y hora en el momento de iniciarse la consulta. Hay que tener en cuenta que el estado de la maquinaria es variable en el tiempo.
 === Ejemplo === === Ejemplo ===
 == Cuerpo del método post == == Cuerpo del método post ==
Línea 44: Línea 44:
   [   [
     {     {
-      "sql":"SELECT * FROM XATJ_NZK_DATOS_CLIENTE(:CifNif)"+      "sql":"SELECT * FROM XATJ_UNY_RELACION_MAQUINARIA ROWS 10"
-      "params": { "CifNif" : "B70180823"}+
     }     }
   ]   ]
 } }
 </code> </code>
 +En el ejemplo, la cláusula "ROWS 10" limita el resultado a los primeros 10 registros. En "producción", podría omitirse.
 == Resultado == == Resultado ==
 <code> <code>
Línea 58: Línea 58:
             "estado": "OK",             "estado": "OK",
             "metaData": {             "metaData": {
-                "S_CODIGO": {+                "S_NRO_SERIE": {
                     "tipo": "ftString",                     "tipo": "ftString",
-                    "etiqueta": "Código"+                    "etiqueta": ""
                 },                 },
-                "S_RAZON_SOCIAL": {+                "S_NOMBRE": {
                     "tipo": "ftString",                     "tipo": "ftString",
-                    "etiqueta": "Razón social"+                    "etiqueta": ""
                 },                 },
-                "S_DIRECCION": {+                "S_ESTADO": {
                     "tipo": "ftString",                     "tipo": "ftString",
-                    "etiqueta": "Dirección"+                    "etiqueta": ""
                 },                 },
-                "S_COD_POSTAL": { +                "S_TIMESTAMP": { 
-                    "tipo": "ftString", +                    "tipo": "ftDateTime", 
-                    "etiqueta": "Códpostal"+                    "etiqueta": "
 +                } 
 +            }, 
 +            "datos":
 +                { 
 +                    "S_NRO_SERIE": "000272", 
 +                    "S_NOMBRE": "VIBRADOR ENAR ELE.TRIFAS.", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00"
                 },                 },
-                "S_POBLACION": {+                
 +                    "S_NRO_SERIE": "000273", 
 +                    "S_NOMBRE": "VIBRADOR ENAR ELEC. MONF", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "000458", 
 +                    "S_NOMBRE": "ROZADORA NEUMAC FR-07", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "001137", 
 +                    "S_NOMBRE": "TALADRO PERCUTOR MARCA HITACHI MODELO DV18DV", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "001143", 
 +                    "S_NOMBRE": "COMPRESOR ESTACIONARIO MARCA INGERSOLLRAND MODELO BD2-100P-1", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "000338", 
 +                    "S_NOMBRE": "MINIAMOLADORA MARCA HITACHI MODELO G12SR2", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "000683", 
 +                    "S_NOMBRE": "COMPRESOR INDUSTRIAL MARCA INGERSOLLRAND MODELO BD10/500F/3", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "001215", 
 +                    "S_NOMBRE": "SAI", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "001216", 
 +                    "S_NOMBRE": "SAI", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "001217", 
 +                    "S_NOMBRE": "SAI", 
 +                    "S_ESTADO": "RECOGIDA", 
 +                    "S_TIMESTAMP": "2021-12-14T14:57:49.780+02:00" 
 +                } 
 +            ] 
 +        } 
 +    ] 
 +}</code> 
 + 
 +---- 
 +====== Consulta de activos ====== 
 +=== Procedimiento === 
 +XATJ_UNY_RELACION_ACTIVOS 
 +=== Parámetros === 
 +  - P_NROS_SERIE VARCHAR(4096) 
 +=== Resultados === 
 +  - S_NRO_SERIE VARCHAR(20), 
 +  - S_NOMBRE VARCHAR(60), 
 +  - S_ITO VARCHAR(1) 
 +=== Comportamiento === 
 +  - El procedimiento recibe una lista de números de serie de maquinaria separados por una coma en el parámetro P_NROS_SERIE. 
 +  - Devuelve una lista compuesta de los siguientes campos: 
 +    - S_NRO_SERIE: el mismo que el recibido como parámetro. 
 +    - S_NOMBRE: el nombre correspondiente al número de serie obtenido, en su caso, de la ficha de "activo". En caso de que el número de serie no estuviera registrado en Smart, en este campo se devolverá el valor: INEXISTENTE 
 +    - S_ITO: En caso de que el producto asociado al activo figure en la colección "ITO", se devolverá el valor "S", y nada en cualquier otro caso. 
 + 
 + 
 + 
 +=== Ejemplo === 
 +== Cuerpo del método post == 
 +<code> 
 +
 +  "version"  : "1.2", 
 +  "metodo"   : "Raw", 
 +  "opciones" : { "metaData":true }, 
 +  "comandos"
 +  [ 
 +   { 
 +    "sql":"SELECT * FROM XATJ_UNY_RELACION_ACTIVOS(:P_NROS_SERIE)", 
 +    "params": { "P_NROS_SERIE" : "000001,012383,949343"
 +    }    
 +  ] 
 +
 +</code> 
 + 
 +== Resultado == 
 +<code> 
 +
 +    "version": "1.2", 
 +    "resultados":
 +        { 
 +            "estado": "OK", 
 +            "metaData":
 +                "S_NRO_SERIE": {
                     "tipo": "ftString",                     "tipo": "ftString",
-                    "etiqueta": "Población"+                    "etiqueta": ""
                 },                 },
-                "S_TELEFONO": {+                "S_NOMBRE": {
                     "tipo": "ftString",                     "tipo": "ftString",
-                    "etiqueta": "Teléfono"+                    "etiqueta": ""
                 },                 },
-                "S_CORREO_E": {+                "S_ITO": {
                     "tipo": "ftString",                     "tipo": "ftString",
-                    "etiqueta": "Correo electrónico"+                    "etiqueta": ""
                 }                 }
             },             },
             "datos": [             "datos": [
                 {                 {
-                    "S_CODIGO": "027893", +                    "S_NRO_SERIE": "000001", 
-                    "S_RAZON_SOCIAL": "CHF SOLUCIONES CERRAJERASS.L.", +                    "S_NOMBRE": "FRATASADORA MARCA ARTEL MODELO F90GE", 
-                    "S_DIRECCION": "LUGAR AGRA - NOVA S/N POUSADA", +                    "S_ITO": null 
-                    "S_COD_POSTAL": "15881", +                }, 
-                    "S_POBLACION": "BOQUEIXON", +                { 
-                    "S_TELEFONO": "628263544", +                    "S_NRO_SERIE": "012383", 
-                    "S_CORREO_E": "administracion@chfsolucionescerrajeras.es"+                    "S_NOMBRE": "MINIRETROEXCAVADORA MARCA TAKEUCHI MODELO TB015 CON CANOPI", 
 +                    "S_ITO": "S" 
 +                }, 
 +                { 
 +                    "S_NRO_SERIE": "949343", 
 +                    "S_NOMBRE": "INEXISTENTE"
 +                    "S_ITO": null
                 }                 }
             ]             ]
Línea 101: Línea 218:
     ]     ]
 } }
-</code> 
  
 +</code>
 ---- ----
 +
 +== Control de cambios del documento ==
 + --- //[[juanma@smartastur.com|Juanma]] 2022/01/14 14:26// Consulta de activos
 +
 + --- //[[juanma@smartastur.com|Juanma]] 2021/12/15 09:26// Documento inicial
 +
  
atj/doc/documentacion_integracion_unayta.1639485596.txt.gz · Última modificación: 2021/12/14 13:39 por juanma

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki