Está en la página 1de 15

VTR Globalcom S.A.

Definicin servicios Oracle


Financials para Nueva Declaracin
de Consumo de Materiales



Autor: Carolina Ferrada (SyS)
Fecha creacin: 09 de Diciembre de 2010
ltima modificacin: 29 de Diciembre de 2010
Version: 1.0



Aprobaciones:



Document1Diseo Preliminar Servicios Tango v3.0.docx ii
Control de Documento

Registro de Cambios
31
Fecha Autor Versin Referencia de Cambios

09-Dic-2010 Carolina Ferrada (SyS) 1 Sin Documento previo





Revisores

Nombre Cargo

Pablo Alvarez Jefe de Proyecto Informtica





Distribucin

No.Copia Nombre Localizacin

1 Pablo Alvarez VTR
2 Christian Castillo VTR
3 Csar Mendoza VTR
4 Giovanna Milln VTR
5 Carolina Ferrada SyS
6 Hctor Morn SyS
7 Gonzalo Serres Appmind

Document1Diseo Preliminar Servicios Tango v3.0.docx iii
Contenidos
Control de Documento ...................................................................................................... ii
Introduccin ....................................................................................................................... 4
Diseo de Solucin ..................................................................................................... 4
1. Consulta de organizaciones directas y reversas de una empresa ............................. 4
2. Consulta de organizacin directa y reversa de una bodega .................................... 54
3. Consulta de informacin de un material ..................................................................... 5
4. Consulta bodega Tango de una Organizacin .......................................................... 65
5. Consulta de subinventarios de una Organizacin...................................................... 6
6. Consulta de Stock de un Material en una Bodega .................................................... 76
7. Validaciones para rebaja de un listado de materiales ................................................ 7
8. Rebaja de un listado de materiales ............................................................................. 98
9. Reporte Consulta de Stock ......................................................................................... 109
10. Reporte Resumen de transacciones bodega......................................................... 1211
Tareas Abiertas y Cerradas ......................................................................................... 1513
Tareas Abiertas ..................................................................................................... 1513
Tareas Cerradas .................................................................................................... 1513


Document1Diseo Preliminar Servicios Tango v3.0.docx 4
Introduccin
El proyecto Nueva Declaracin de Consumo NDC reemplazar la actual pgina de
ingreso de la declaracin de consumo de los tcnicos, por una nueva que sigue los
estndares de arquitectura definidos por VTR.
En este contexto, se solicita a Oracle Financials, la creacin de procedimientos
almacenados que entreguen la informacin requerida.
Luego, se crearn web services que publicarn esta informacin para ser utilizada
por el nuevo sistema.


Diseo de Solucin
A continuacin se describen los servicios, sus parmetros 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 cdigo de empresa, el servicio deber retornar la informacin de
todas las empresas parametrizadas en Oracle Financials.

Entrada
Campo Tipo Descripcin Observaciones
Cdigo Rut
Empresa
Alfanumrico
de largo 12 4
Cdigo de la
EPSempresa
Opcional
Formato: XX.XXX.XXX-X sin
ceros adelante, con puntos y
guin

Salida
Campo Tipo Descripcin Observaciones
Cdigo
Organizacin
directa
Alfanumrico
de largo 3
Cdigo de la
organizacin directa
Listado de organizaciones
directas y reversas asociadas
Nombre
Organizacin
directa
Alfanumrico
de largo 50
Nombre de la
organizacin directa

Cdigo
Organizacin
reversa
Alfanumrico
de largo 3
Cdigo de la
organizacin reversa
asociada a la directa
Slo en caso que exista
Nombre
Organizacin
reversa
Alfanumrico
de largo 3
Nombre de la
organizacin reversa
asociada a la directa
Slo en caso que exista
Tablas Involucradas:
Mtl_parameters
Mtl_secondary_inventories
Org_organization_definitions
fnd_flex_value_sets
Formatted: English (U.S.)
Formatted: Indent: Left: 2"
Formatted: Indent: Left: 2.24", First line:
0.44"
Formatted: Indent: Left: 2"
Formatted: English (U.S.)

Document1Diseo Preliminar Servicios Tango v3.0.docx 5
fnd_flex_values
fnd_flex_values_tl
2. Consulta de organizacin directa y reversa de una bodega

Servicio que retorna la organizacin directa y reversa de una bodega de Oracle
Financials.

Entrada
Campo Tipo Descripcin Observaciones
Cdigo
Bodega
Alfanumrico
de largo 8
Cdigo de la bodega Cdigo bodega tango? S
OK

Salida
Campo Tipo Descripcin Observaciones
Cdigo
Organizacin
directa
Alfanumrico
de largo 3
Cdigo de la
organizacin directa
Listado de organizaciones
directas y reversas asociadas
Nombre
Organizacin
directa
Alfanumrico
de largo 50
Nombre de la
organizacin directa

Cdigo
Organizacin
reversa
Alfanumrico
de largo 3
Cdigo de la
organizacin reversa
asociada a la directa
Slo cuando exista
Nombre
Organizacin
reversa
Alfanumrico
de largo 3
Nombre de la
organizacin reversa
asociada a la directa
Slo cuando exista
Tablas Involucradas:
Mtl_parameters
Mtl_secondary_inventories
Org_organization_definitions
fnd_flex_value_sets
fnd_flex_values
fnd_flex_values_tl

3. Consulta de informacin de un material
Servicio que retorna la descripcin de un material y su tem inventory id.

Entrada
Campo Tipo Descripcin Observaciones
Cdigo
material
Alfanumrico
de largo 172
El largo del
cdigo es de 17
Cdigo del material Los cdigos son del tipo
ID-123-1234-12345
Varchr(17) OK

Salida
Campo Tipo Descripcin Observaciones
Formatted: English (U.S.)
Formatted: Indent: Left: 2.24", First line:
0.44"

Document1Diseo Preliminar Servicios Tango v3.0.docx 6
Campo Tipo Descripcin Observaciones
Item
iInventory
item id
Numrico Id del material en el
inventario

Descripcin Alfanumrico
de 24050
Descripcion del
material indicado en
el cdigo del material
El largo de la descripcin es
de 240, se debe truncar en
50? Dejmoslo en 240
OK
Tablas Involucradas:
Mtl_system_items_kfv

4. Consulta bodega Tango de una Organizacin
Servicio que retorna el cdigo de la bodega Tango de una organizacin de Oracle
Financials.

Entrada
Campo Tipo Descripcin Observaciones
Cdigo
Organizacin
Alfanumrico
de largo 3
Cdigo de la
organizacin
Obligatorio

Salida
Campo Tipo Descripcin Observaciones
Cdigo
Bodega
Alfanumrico
de largo 8
Cdigo 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 Organizacin
Servicio que retorna desde Oracle Financials los subinventarios de una
organizacin.

Entrada
Campo Tipo Descripcin Observaciones
Organizacin Alfanumrico
de largo 34
Cdigo de la
organizacin
El largo del cdigo de
organizacin es de 3 OK

Salida
Campo Tipo Descripcin Observaciones
Subinventario Alfanumrico
Largo 10
Entrega los nombres
de los subinventarios
de la organizacin.
Es un listado.
Si la organizacin est en el
modelo cronos, este listado
sern los rut de los tcnicos
Formatted: English (U.S.)
Formatted: English (U.S.)
Formatted: English (U.S.)

Document1Diseo Preliminar Servicios Tango v3.0.docx 7
Campo Tipo Descripcin Observaciones
que pertenecen a esa
organizacin.
Tablas Involucradas:
Mtl_secondary_inventories
Mtl_parameters
6. Consulta de Stock de un Material en una Bodega

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 an no han sido procesados para rebajar de stock.

Entrada
Campo Tipo Descripcin Observaciones
Cdigo Bodega Alfanumrico
de largo 8
Cdigo de la bodega
del tcnico
Cdigo Tango de la
Bodega
Cdigo del
MaterialInventory
tem id
Numrico Cdigo
Identificador del
material
Es el id del tem? S
OK

Salida
Campo Tipo Descripcin Observaciones
Descripcin de
material
Alfanumrico
de largo 24050
Nombre del material El largo de la descripcin es
de 240, se trunca en 50?
Dejmoslo en 240
Cantidad
disponible de
material
Numrico Cantidad disponible
del material en la
bodega

Tablas Involucradas:
Mtl_secondary_inventories
Mtl_onhand_quantities
Mtl_transactions_interface

7. Validaciones para rebaja de un listado de materiales
Servicio que valida en el Oracle Financials el stock y la determinacin del
flexfield contable para un listado de materiales que sern declarados para rebaja
de stock.


Entrada
Campo Tipo Descripcin Observaciones
Id declaracin Number Listado de materiales
Nmero OT Number
Tipo Trabajo Varchar2
Cdigo Zona Varchar2
Cdigo Localidad Varhchar2
Formatted: English (U.S.)

Document1Diseo Preliminar Servicios Tango v3.0.docx 8
Rut Empresa Varchar2
Rut tcnico Varchar2
Cdigo Clase
Vivienda
Varchar2
Cdigo Tipo
Vivienda
Varchar2
Cdigo Bodega Varchar2
Id
materialInventory
item id
Number
Cantidad a
rebajar
Number
Lnea declaracin Number
Fecha declaracin Date

Salida
Campo Tipo Descripcin Observaciones
Id declaracin Number Listado de materiales
Nmero OT
linea
declaracion
Number
Tipo Trabajo
Cdigo Zona
Cdigo
Localidad

Rut Empresa
Rut tcnico
Cdigo Clase
Vivienda

Cdigo Tipo
Vivienda

Cdigo
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


Document1Diseo Preliminar Servicios Tango v3.0.docx 9
Tablas:
Mtl_onhand_quantities
Mtl_transactions_interface

8. Rebaja de un listado de materiales
Servicio que realiza la insercin en la interfaz de inventario de un listado de
materiales a rebajar. Antes de realizar la insercin 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 Descripcin Observaciones
Id declaracin Listado de materiales
Nmero OT
Tipo Trabajo
Cdigo Zona
Cdigo Localidad
Rut Empresa
Rut tcnico
Cdigo Clase
Vivienda

Cdigo Tipo
Vivienda

Cdigo Bodega
Id
materialInventory
tem id

Cantidad a
rebajar

Lnea declaracin Number
Fecha declaracin Date

Salida
Campo Tipo Descripcin Observaciones
Id declaracin Listado de materiales

Linea
declaracion
Nmero OT
Number
Tipo Trabajo
Cdigo Zona

Document1Diseo Preliminar Servicios Tango v3.0.docx 10
Campo Tipo Descripcin Observaciones
Cdigo
Localidad

Rut Empresa
Rut tcnico
Cdigo Clase
Vivienda

Cdigo Tipo
Vivienda

Cdigo
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

9. Reporte Consulta de Stock

Para el caso de los tcnicos que posean una bodega de Inventario, stos debern
poder consultar el stock disponible de sus materiales.
Se deben recuperar todos los materiales, tanto seriados como no seriados, sin
considerar el nmero de serie.
Esta informacin ser obtenida desde el inventario de Oracle Financials,
considerando la bodega directa.

Entrada
Campo Tipo Descripcin Observaciones
Cdigo Bodega Alfanumrico
de largo 8
Cdigo de la bodega
del tcnico
Cdigo Tango de la
Bodega
Rut tcnico Alfanumrico
de largo 12
Rut del tcnico El rut de tcnico no debe
tener mas de 10 char
Formato: XX.XXX.XXX-X
sin ceros adelante, con
puntos y guin?
10828554-3 sin puntos y sin
ceros

Document1Diseo Preliminar Servicios Tango v3.0.docx 11
Cdigo del
MaterialInventory
tem id
Numrico Cdigo
Identificador del
material
Es el id del tem? S
ok
Salida
Campo Tipo Descripcin Observaciones
Nombre EPS Alfanumrico
de largo 50
Nombre de la EPS
Zona Alfanumrico
de largo 50
Nombre de la Zona
Bodega Alfanumrico
de largo 50
Nombre de la bodega
RUT Tcnico Alfanumrico
de largo 12
Rut del tcnico Largo 10 mx
Formato: XX.XXX.XXX-X sin
ceros adelante, con puntos y
guin?
10828554-3 sin puntos y sin
ceros
Categora de
inventario
Categora de
inventario
??
A que juego de categora se
refieren?
Hay varios cules son?
Olvida la pregunta, hay solo
una en uso
Cdigo
material
Numrico Cdigo del material
Descripcin de
material
Alfanumrico
de largo 24050
Nombre del material El largo es de 240 trunco a
50? Dejmoslo en 240
ok
Cantidad
disponible de
material
Numrico Cantidad disponible
del material en la
bodega
Debe descontar los
materiales declarados que se
encuentran en la Interfaz de
Inventario y que an 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
Mtl_system_items_kfv


Los roles que pueden ejecutar este reporte son los siguientes:
Formatted: English (U.S.)

Document1Diseo Preliminar Servicios Tango v3.0.docx 12
Tcnico: puede ver solo la informacin de su bodega. En caso de no
tener bodega propia, no ver el stock de la bodega de la EPS. Por lo
tanto, los parmetros bodega y rut tcnico estarn preseleccionados,
pudiendo solo indicar si quiere ver el stock de un material en particular o
de todos los materiales (dejando el parmetro vaco).

Supervisor VTR: puede ver solo la informacin de su bodega. En caso
de no tener bodega propia, no ver el stock de la bodega de la EPS. Por
lo tanto, los parmetros bodega y rut tcnico estarn preseleccionados,
pudiendo solo indicar si quiere ver el stock de un material en particular o
de todos los materiales (dejando el parmetro vaco.

Administrador EPS: puede ver la informacin de su bodega (modelo
actual) o de las bodegas de sus tcnicos (modelo cronos).

Administrador VTR: puede ver la informacin de cualquier bodega.

Respecto a las bodegas, existen bodegas en Tango y en Oracle con distinta
nomenclatura. Sin embargo, en Oracle existe la traduccin de la bodega de Tango
al cdigo Oracle.
Los tcnicos pueden tener bodega propia (modelo Cronos) o de su EPS (modelo
actual).
Para determinar cul es la bodega de un tcnico, se le debe consultar a Tango,
quien tiene dicha informacin en la tabla fdt_tecnicos.
Si el tcnico no tiene bodega propia, entonces no podr ver la informacin de
stock de su bodega en este reporte, ya que sta sera la de la EPS.
Si es un administrador EPS quien ejecuta el reporte, ste podr ver la
informacin 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 tcnicos pertenecientes a
la organizacin del administrador de la EPS.

10. Reporte Resumen de transacciones bodega

Reporte que detalla los movimientos de entrada y salida de materiales en
bodega.
Debe poseer la misma lgica que el ejecutable VTR_INV_KARDEX existente en
la eBSuite.
Este reporte en Oracle Financials trae el detalle por nmero de serie, el cual no es
necesario en NDC.

Entrada
Campo Tipo Descripcin 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
Cdigo
Bodega
Alfanumrico
de largo 8
Cdigo de la bodega Es el cdigo bodega tango?

Document1Diseo Preliminar Servicios Tango v3.0.docx 13
Cdigo
Organizacin
Alfanumrico
de largo 3 4
Cdigo de la
organizacin
Porque 4 si el largo es 3?OK
Cdigo
material
Numrico Cdigo material Es el id del tem?
Resumen Alfanumrico
de largo 1
S, N

Salida
Campo Tipo Descripcin Observaciones
Bodega Alfanumrico
de largo 50
Nombre de la bodega
Subinventario Alfanumrico Subinventario de la
bodega

Localizador Alfanumrico
Fecha Fecha Fecha de la
transaccin

Tipo
transaccin
Alfanumrico Tipo de la transaccin
Cdigo Alfanumrico Cdigo del material
Descripcin Alfanumrico
de largo 50
Descripcin
Unidad de
medida
Alfanumrico Unidad de medida
Stock Inicial Numrico Stock inicial del
material

Entradas Numrico Entradas del material
a la bodega

Salidas Numrico Salidas del material
desdes la bodega

Stock Final Numrico 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:
Tcnico: puede ver la informacin de transacciones de su bodega.
Supervisor VTR: puede ver la informacin de transacciones de su
bodega.
Administrador EPS: puede ver la informacin de transacciones de las
bodegas de sus tcnicos.
Administrador VTR: puede ver la informacin de cualquier bodega.
Formatted: Indent: Left: 1.33", First line:
0.67"

Document1Diseo Preliminar Servicios Tango v3.0.docx 14


Document1Diseo Preliminar Servicios Tango v3.0.docx 15
Tareas Abiertas y Cerradas

Tareas Abiertas

ID Tema Resolucin Responsable Fecha lmite Fecha
impacto







Tareas Cerradas

ID Tema Resolucin Responsable Fecha cierre Fecha
impacto