diseño preliminar servicios oracle financials v2.0
TRANSCRIPT
VTR Globalcom S.A.
Definición servicios Oracle Financials para Nueva Declaración de Consumo de Materiales
Autor: Carolina Ferrada (SyS)
Fecha creación: 09 de Diciembre de 2010
Última modificación: 29 de Diciembre de 2010
Version: 1.0
Aprobaciones:
Control de Documento
Registro de Cambios1
Fecha Autor Versión
Referencia de Cambios
09-Dic-2010
Carolina Ferrada (SyS)
1 Sin Documento previo
Revisores
Nombre Cargo
Pablo Alvarez Jefe de Proyecto Informática
Distribución
No.Copia
Nombre Localización
1 Pablo Alvarez VTR
2 Christian Castillo VTR
3 César Mendoza VTR
4 Giovanna Millán VTR
5 Carolina Ferrada SyS
6 Héctor Morán SyS
document.docx ii
No.Copia
Nombre Localización
7 Gonzalo Serres Appmind
document.docx iii
Contenidos
Control de Documento................................................................................. ii
Introducción................................................................................................4
Diseño de Solución................................................................................4
1. Consulta de organizaciones directas y reversas de una empresa..........4
2. Consulta de organización directa y reversa de una bodega...................4
3. Consulta de información de un material................................................5
4. Consulta bodega Tango de una Organización........................................5
5. Consulta de subinventarios de una Organización..................................6
6. Consulta de Stock de un Material en una Bodega..................................6
7. Validaciones para rebaja de un listado de materiales............................7
8. Rebaja de un listado de materiales........................................................8
9. Reporte Consulta de Stock.....................................................................9
10. Reporte Resumen de transacciones bodega.......................................11
Tareas Abiertas y Cerradas.......................................................................13
Tareas Abiertas....................................................................................13
Tareas Cerradas..................................................................................13
document.docx iv
Introducción
El proyecto Nueva Declaración de Consumo – NDC reemplazará la actual página de ingreso de la declaración de consumo de los técnicos, por una nueva que sigue los estándares de arquitectura definidos por VTR.
En este contexto, se solicita a Oracle Financials, la creación de procedimientos almacenados que entreguen la información requerida.
Luego, se crearán web services que publicarán esta información para ser utilizada por el nuevo sistema.
Diseño de Solución
A continuación se describen los servicios, sus parámetros de entrada y salida.
1. Consulta de organizaciones directas y reversas de una empresa
Servicio que retorna un listado de organizaciones directas activas y su correspondiente reversa para una determinada empresa. En caso de que no se indique un código de empresa, el servicio deberá retornar la información de todas las empresas parametrizadas en Oracle Financials.
Entrada
Campo Tipo Descripción Observaciones
Código Rut Empresa
Alfanumérico de largo 12 4
Código de la EPSempresa
Opcional
Formato: XX.XXX.XXX-X sin ceros adelante, con puntos y guión
Salida
Campo Tipo Descripción Observaciones
Código Organización directa
Alfanumérico de largo 3
Código de la organización directa
Listado de organizaciones directas y reversas asociadas
Nombre Organización directa
Alfanumérico de largo 50
Nombre de la organización directa
Código Organización reversa
Alfanumérico de largo 3
Código de la organización reversa asociada a
Sólo en caso que exista
document.docx 5
la directa
Nombre Organización reversa
Alfanumérico de largo 3
Nombre de la organización reversa asociada a la directa
Sólo en caso que exista
Tablas Involucradas:
Mtl_parameters
Mtl_secondary_inventories
Org_organization_definitions
fnd_flex_value_sets
fnd_flex_values
fnd_flex_values_tl
2. Consulta de organización directa y reversa de una bodega
Servicio que retorna la organización directa y reversa de una bodega de Oracle Financials.
Entrada
Campo Tipo Descripción Observaciones
Código Bodega
Alfanumérico de largo 8
Código de la bodega
Código bodega tango? Sí
OK
Salida
Campo Tipo Descripción Observaciones
Código Organización directa
Alfanumérico de largo 3
Código de la organización directa
Listado de organizaciones directas y reversas asociadas
Nombre Organización directa
Alfanumérico de largo 50
Nombre de la organización directa
Código Organización reversa
Alfanumérico de largo 3
Código de la organización reversa asociada a la directa
Sólo cuando exista
Nombre Organización reversa
Alfanumérico de largo 3
Nombre de la organización reversa asociada a la directa
Sólo cuando exista
Tablas Involucradas:
Mtl_parameters
document.docx 6
Mtl_secondary_inventories
Org_organization_definitions
fnd_flex_value_sets
fnd_flex_values
fnd_flex_values_tl
3. Consulta de información de un material
Servicio que retorna la descripción de un material y su ítem inventory id.
Entrada
Campo Tipo Descripción Observaciones
Código material
Alfanumérico de largo 172
El largo del código es de 17
Código del material
Los códigos son del tipo
ID-123-1234-12345
Varchr(17) OK
Salida
Campo Tipo Descripción Observaciones
Item iInventory item id
Numérico Id del material en el inventario
Descripción Alfanumérico de 24050
Descripcion del material indicado en el código del material
El largo de la descripción es de 240, se debe truncar en 50? Dejémoslo en 240
OK
Tablas Involucradas:
Mtl_system_items_kfv
4. Consulta bodega Tango de una Organización
Servicio que retorna el código de la bodega Tango de una organización de Oracle Financials.
Entrada
Campo Tipo Descripción Observaciones
document.docx 7
Código Organización
Alfanumérico de largo 3
Código de la organización
Obligatorio
Salida
Campo Tipo Descripción Observaciones
Código Bodega
Alfanumérico de largo 8
Código de la bodega Tango
Se debe buscar el subinventario del nombre del contratista. Si no existe, se debe buscar el subinventario que tenga una bodega Tango asociada
Tablas Involucradas:
Mtl_secondary_inventories
[5.] Consulta de subinventarios de una Organización
Servicio que retorna desde Oracle Financials los subinventarios de una organización.
Entrada
Campo Tipo Descripción Observaciones
Organización
Alfanumérico de largo 34
Código de la organización
El largo del código de organización es de 3 OK
Salida
Campo Tipo Descripción Observaciones
Subinventario
Alfanumérico
Largo 10
Entrega los nombres de los subinventarios de la organización.
Es un listado.
Si la organización está en el modelo cronos, este listado serán los rut de los técnicos que pertenecen a esa organización.
Tablas Involucradas:
Mtl_secondary_inventories
Mtl_parameters
5.[6.] Consulta de Stock de un Material en una Bodega
document.docx 8
Servicio que permite obtener el stock disponible de un material en una bodega. Para ello, se deben descontar los materiales declarados que se encuentran en la Interfaz de Inventario y que aún no han sido procesados para rebajar de stock.
Entrada
Campo Tipo Descripción Observaciones
Código Bodega
Alfanumérico de largo 8
Código de la bodega del técnico
Código Tango de la Bodega
Código del MaterialInventory ítem id
Numérico Código Identificador del material
Es el id del ítem? Sí
OK
Salida
Campo Tipo Descripción Observaciones
Descripción de material
Alfanumérico de largo 24050
Nombre del material
El largo de la descripción es de 240, se trunca en 50? Dejémoslo en 240
Cantidad disponible de material
Numérico Cantidad disponible del material en la bodega
Tablas Involucradas:
Mtl_secondary_inventories
Mtl_onhand_quantities
Mtl_transactions_interface
6.[7.] Validaciones para rebaja de un listado de materiales
Servicio que valida en el Oracle Financials el stock y la determinación del flexfield contable para un listado de materiales que serán declarados para rebaja de stock.
Entrada
Campo Tipo Descripción Observaciones
Id declaración Number Listado de materiales
Número OT Number
Tipo Trabajo Varchar2
Código Zona Varchar2
document.docx 9
Código Localidad
Varhchar2
Rut Empresa Varchar2
Rut técnico Varchar2
Código Clase Vivienda
Varchar2
Código Tipo Vivienda
Varchar2
Código Bodega
Varchar2
Id materialInventory item id
Number
Cantidad a rebajar
Number
Línea declaración
Number
Fecha declaración
Date
Salida
Campo Tipo Descripción Observaciones
Id declaración
Number Listado de materiales
Número OT
linea declaracion
Number
Tipo Trabajo
Código Zona
Código Localidad
Rut Empresa
Rut técnico
Código Clase Vivienda
Código Tipo Vivienda
document.docx 10
Campo Tipo Descripción Observaciones
Código Bodega
Id material
Cantidad a rebajar
Number
Hay stock suficiente?
Y/N S/N
OK
Stock disponible
Number
Error? Y/N S/N
OK
Observaciones
Varchar2
Tablas:
Mtl_onhand_quantities
Mtl_transactions_interface
7.[8.] Rebaja de un listado de materiales
Servicio que realiza la inserción en la interfaz de inventario de un listado de materiales a rebajar. Antes de realizar la inserción en la interfaz se debe validar que todos los materiales del listado tengan stock suficiente y que es posible determinar el flexfield contable. En caso de que no se cumplan estas validaciones, no deben insertarse en la interfaz ninguno de los materiales del listado.
Entrada
Campo Tipo Descripción Observaciones
Id declaración Listado de materiales
Número OT
Tipo Trabajo
Código Zona
Código Localidad
Rut Empresa
Rut técnico
Código Clase Vivienda
document.docx 11
Código Tipo Vivienda
Código Bodega
Id materialInventory ítem id
Cantidad a rebajar
Línea declaración
Number
Fecha declaración
Date
Salida
Campo Tipo Descripción Observaciones
Id declaración
Listado de materiales
Linea declaracion
Número OT
Number
Tipo Trabajo
Código Zona
Código Localidad
Rut Empresa
Rut técnico
Código Clase Vivienda
Código Tipo Vivienda
Código Bodega
Id material
Cantidad a rebajar
Number
Hay stock suficiente?
Y/N S/N
document.docx 12
Campo Tipo Descripción Observaciones
ok
Stock disponible
Number
Error? Y/N S/N
ok
Observaciones
Varchar2
Tablas:
Mtl_onhand_quantities
Mtl_transactions_interface
8.[9.] Reporte Consulta de Stock
Para el caso de los técnicos que posean una bodega de Inventario, éstos deberán poder consultar el stock disponible de sus materiales.
Se deben recuperar todos los materiales, tanto seriados como no seriados, sin considerar el número de serie.
Esta información será obtenida desde el inventario de Oracle Financials, considerando la bodega directa.
Entrada
Campo Tipo Descripción Observaciones
Código Bodega
Alfanumérico de largo 8
Código de la bodega del técnico
Código Tango de la Bodega
Rut técnico Alfanumérico de largo 12
Rut del técnico El rut de técnico no debe tener mas de 10 char Formato: XX.XXX.XXX-X sin ceros adelante, con puntos y guión?
10828554-3 sin puntos y sin ceros
Código del MaterialInventory ítem id
Numérico Código Identificador del material
Es el id del ítem? Sí
ok
Salida
Campo Tipo Descripción Observaciones
Nombre EPS
Alfanumérico de largo 50
Nombre de la EPS
document.docx 13
Zona Alfanumérico de largo 50
Nombre de la Zona
Bodega Alfanumérico de largo 50
Nombre de la bodega
RUT Técnico Alfanumérico de largo 12
Rut del técnico Largo 10 máx
Formato: XX.XXX.XXX-X sin ceros adelante, con puntos y guión?
10828554-3 sin puntos y sin ceros
Categoría de inventario
Categoría de inventario
¿??
A que juego de categoría se refieren?
Hay varios cuáles son?
Olvida la pregunta, hay solo una en uso
Código material
Numérico Código del material
Descripción de material
Alfanumérico de largo 24050
Nombre del material
El largo es de 240 trunco a 50? Dejémoslo en 240
ok
Cantidad disponible de material
Numérico Cantidad disponible del material en la bodega
Debe descontar los materiales declarados que se encuentran en la Interfaz de Inventario y que aún no han sido procesados para rebajar de stock
Tablas Involucradas:
Mtl_parameters
Mtl_secondary_inventories
Mtl_onhand_quantities
Org_organization_definitions
Mtl_categories
Mtl_item_categories
Mtl_category_sets
Mtl_transactions_interface
document.docx 14
Mtl_system_items_kfv
Los roles que pueden ejecutar este reporte son los siguientes:
Técnico: puede ver solo la información de su bodega. En caso de no tener bodega propia, no verá el stock de la bodega de la EPS. Por lo tanto, los parámetros bodega y rut técnico estarán preseleccionados, pudiendo solo indicar si quiere ver el stock de un material en particular o de todos los materiales (dejando el parámetro vacío).
Supervisor VTR: puede ver solo la información de su bodega. En caso de no tener bodega propia, no verá el stock de la bodega de la EPS. Por lo tanto, los parámetros bodega y rut técnico estarán preseleccionados, pudiendo solo indicar si quiere ver el stock de un material en particular o de todos los materiales (dejando el parámetro vacío.
Administrador EPS: puede ver la información de su bodega (modelo actual) o de las bodegas de sus técnicos (modelo cronos).
Administrador VTR: puede ver la información de cualquier bodega.
Respecto a las bodegas, existen bodegas en Tango y en Oracle con distinta nomenclatura. Sin embargo, en Oracle existe la traducción de la bodega de Tango al código Oracle.
Los técnicos pueden tener bodega propia (modelo Cronos) o de su EPS (modelo actual).
Para determinar cuál es la bodega de un técnico, se le debe consultar a Tango, quien tiene dicha información en la tabla fdt_tecnicos.
Si el técnico no tiene bodega propia, entonces no podrá ver la información de stock de su bodega en este reporte, ya que ésta sería la de la EPS.
Si es un administrador EPS quien ejecuta el reporte, éste podrá ver la información de su bodega. Si la EPS se encuentra en el modelo Cronos, entonces se mostrará el stock de cada una de las bodegas de los técnicos pertenecientes a la organización del administrador de la EPS.
9.[10.] Reporte Resumen de transacciones bodega
Reporte que detalla los movimientos de entrada y salida de materiales en bodega.
document.docx 15
Debe poseer la misma lógica que el ejecutable VTR_INV_KARDEX existente en la eBSuite.
Este reporte en Oracle Financials trae el detalle por número de serie, el cual no es necesario en NDC.
Entrada
Campo Tipo Descripción Observaciones
Fecha inicio Fecha Fecha inicio rango consulta
Fecha fin Fecha Fecha fin rango consulta
La diferencia entre fecha fin y fecha inicio no excederá un mes
Código Bodega
Alfanumérico de largo 8
Código de la bodega
Es el código bodega tango?
Código Organización
Alfanumérico de largo 3 4
Código de la organización
Porque 4 si el largo es 3?OK
Código material
Numérico Código material Es el id del ítem?
Resumen Alfanumérico de largo 1
‘S’, ‘N’
Salida
Campo Tipo Descripción Observaciones
Bodega Alfanumérico de largo 50
Nombre de la bodega
Subinventario
Alfanumérico Subinventario de la bodega
Localizador Alfanumérico
Fecha Fecha Fecha de la transacción
Tipo transacción
Alfanumérico Tipo de la transacción
Código Alfanumérico Código del material
Descripción Alfanumérico de largo 50
Descripción
Unidad de medida
Alfanumérico Unidad de medida
Stock Inicial Numérico Stock inicial del material
Entradas Numérico Entradas del material a la bodega
document.docx 16
Campo Tipo Descripción Observaciones
Salidas Numérico Salidas del material desdes la bodega
Stock Final Numérico Stock disponible del material
Tablas:
Mtl_material_transactions
Mtl_ssytem_items_kfv
Mtl_secondary_inventories
Mtl_item_locations
Mtl_transaction_types
Los roles que pueden ejecutar este reporte son los siguientes:
Técnico: puede ver la información de transacciones de su bodega.
Supervisor VTR: puede ver la información de transacciones de su bodega.
Administrador EPS: puede ver la información de transacciones de las bodegas de sus técnicos.
Administrador VTR: puede ver la información de cualquier bodega.
document.docx 17
Tareas Abiertas y Cerradas
Tareas Abiertas
ID Tema Resolución Responsable Fecha límite Fecha impacto
Tareas Cerradas
ID Tema Resolución Responsable Fecha cierre Fecha impacto
document.docx 18