Confidencial

Documento de Especificación Técnica

Cliente : Walmart
Proyecto :
Descripción : Especificación técnica Interfaces
integración SAP
Número de Req. :
Número seguimiento(OT): 15725

Created: 15/09/2016 01:04:00 Page 1 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Título : Especificación técnica de interfaces para integración con SAP

Autor : Jorge Avalos
Fecha : 27/07/2016
Producto/Versión: Maximo 7.6
Base de datos :

Información del Cliente

Cliente:

Contacto: Teléfono:
Email:

Fecha Objetivo de Implementación:

Revisión y aprobación de la especificación técnica

Cliente: Fecha: Comentarios:

Solex Técnico Fecha: Comentarios:

Solex Funcional Fecha: Comentarios:

Aprobación final
Cliente: Fecha: Comentarios:

Solex Fecha: Comentarios:

Created: 15/09/2016 01:04:00 Page 2 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Historia Revisiones
Autor Fecha Descripción Página
Jorge Avalos Todas

Created: 15/09/2016 01:04:00 Page 3 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Tabla de Contenidos

1 REQUERIMIENTO FUNCIONAL.....................................................................................................5

2 PREGUNTAS/RESPUESTAS Y ACLARACIONES.........................................................................5

3 DEFINICIÓN PLAN DE PRUEBAS...................................................................................................5

4 ANÁLISIS DE LA SOLUCIÓN............................................................................................................6
4.1 MAESTRO DE REPUESTOS........................................................................................6
4.2 INVENTARIO DE REPUESTOS A (DEFINICIÓN DE INVENTARIO Y COSTOS)...............8
4.3 INVENTARIO DE REPUESTOS B (BALANCES).........................................................9
4.4 ENVÍO DE PLANIFICADOS (PEDIDO) DESDE MAXIMO A SAP.................................9
4.5 ENVÍO DE SOLICITUD DE AUTOSERVICIO DESDE MAXIMO A SAP......................11
4.6 ÓRDENES DE TRABAJO VÁLIDAS........................................................................ 12
4.7 COSTOS REALES DE LA ORDEN DE TRABAJO A (DESPACHO DE MATERIALES)....13
4.8 COSTOS REALES DE LA ORDEN DE TRABAJO B (RECEPCIÓN DE COMPRAS)........14
5 SUPUESTOS.........................................................................................................................................16

6 INSTRUCCIONES DE INSTALACIÓN...........................................................................................16

7 Test unitarios ejecutados/Plan de pruebas.............................................................................................16

Created: 15/09/2016 01:04:00 Page 4 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

1 Requerimiento Funcional
Realizar la especificación técnica de las distintas interfaces para la integración entre los sistemas
Maximo y SAP.

2 Preguntas/respuestas y aclaraciones.

3 Definición Plan de pruebas

A continuación se presenta el Plan de Pruebas definido para este requerimiento. Esta definición tiene
como objetivo garantizar el correcto funcionamiento de la implementación que se realizará, y deberá ser
revisado conjuntamente entre personal de Solex y el Cliente. De esta forma, a través de este Plan de
Pruebas, se revisará en conjunto y en detalle los resultados esperados por el Cliente lo que permitirá
definir claramente lo que se espera de este trabajo.

El cliente deberá revisar y complementar el plan de pruebas con las pruebas requeridas de acuerdo al
requerimiento y al alcance del proyecto.

Nª Descripción de la prueba y condición de aceptación.

Created: 15/09/2016 01:04:00 Page 5 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

4 Análisis de la Solución

A continuación se expone el detalle de las distintas interfaces para la integración entre Maximo y
SAP. En general, para decidir si una interfaz debe ser por tabla de base de datos o por web
service, podría considerarse la frecuencia y la cantidad de registros que se enviará por vez (si son
muchos podría optarse por tabla), si se requiere o no una respuesta o manejar posibles errores, e
incluso si el destino final es efectivamente una tabla, como puede ser el caso de las OT válidas.
En general, y cuando no se especifique, se propone usar web services para las interfaces.

4.1 Maestro de Repuestos (SAP a MAXIMO)

WSDL: http://<ip o nombre>:<puerto>/meaweb/wsdl/SAP_Item.wsdl

URL servicio: http://<ip o nombre>:<puerto>/meaweb/services/SAP_Item

La interfaz de actualización del maestro de repuestos permitirá a SAP mantener actualizado el

maestro de materiales en Maximo. Esto se refiere básicamente a la creación del repuesto con su
descripción en caso de que no exista.

Elemento Descripción Tipo

ITEMNUM Código de la parte o material. Alfanumérico, 30, solo
mayúsculas
DESCRIPTION Descripción de la parte o material. Alfanumérico, 130
DESCRIPTION_LONGDE Descripción detallada (opcional). Alfanumérico, 32.000
SCRIPTION
ISSUEUNIT Unidad de despacho del material. Alfanumérico, 16
STATUS Código de nuevo estado. Para borrar Alfanumérico, 16, solo
un material debe venir PENDOBS. mayúsculas
Sap no lleva estado.
STATUSDATE Fecha en que se cambió el estado Fecha y hora (datetime)
STATUSIFACE Debe venir en ‘1’ para cambios de Numérico, 1 ó 0.
estado.
NP_STATUSMEMO Razón de cambio de estado (opcional) Alfanumérico, 50
NP_STATUSROLLDOWN Debe venir en ‘1’ Numérico, 1 ó 0.

Dependiendo de cómo y en qué momentos se envíe la información por esta interfaz, podría ser de
tipo tabla de base de datos o web service. El usar tabla tiene sentido si por cada conexión
realizada a la base de datos se va a insertar una cantidad considerable de transacciones; si los
cambios en el inventario se van a enviar en tiempo real, en forma unitaria, tendría sentido usar
web service.

Created: 15/09/2016 01:04:00 Page 6 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Formato del código de material

Si el código de material de SAP contiene muchos ceros a la izquierda eventualmente podría

considerarse la eliminación de estos ceros por la interfaz para evitar que el dato se visualice
erróneamente en las pantallas de Maximo. Esto implica que la interfaz de salida de Maximo debe
volver a colocar los ceros para enviar a SAP.

Borrado de ítems

En Maximo, no es posible eliminar un material ya que su código puede estar en diversas órdenes
de trabajo aunque estas se encuentren en el historial. Sin embargo, es posible cambiar su estado
a PENDOBS (“Pendiente de convertirse en obsoleto”), con lo cual el material ya no se podrá
seguir planificando en órdenes de trabajo (ver imagen).

Cabe hacer la aclaración de que si se intenta cambiar el estado de un material (ya sea desde
Maximo o por integración), si el material está planificado en alguna orden de trabajo, Maximo
arrojará un error y el estado del material no se cambiará (ver imagen).

Created: 15/09/2016 01:04:00 Page 7 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Según la definición, el llamado al WS seguirá reintentándose hasta que, eventualmente, una vez
que todas las órdenes de trabajo que tengan planificado el material se hayan cerrado, recién ahí
podrá cambiarse el estado del material. De no mediar intervención manual, las OT que contengan
el material seguirán su curso normal y generarán reservas en SAP, en cuyo caso
presumiblemente las líneas con materiales borrados en SAP quedarán con error y no generarán
reserva.

4.2 Inventario de Repuestos A (definición de inventario y costos)

WSDL: http://<ip o nombre>:<puerto>/meaweb/wsdl/SAP_Inventory.wsdl

URL servicio: http://<ip o nombre>:<puerto>/meaweb/services/SAP_Inventory

La interfaz de actualización de inventario permitirá a SAP crear o actualizar un registro de

inventario en Maximo, es decir, la combinación repuesto – almacén. En el caso de la actualización,
solo se podrá cambiar el costo promedio del material en el almacén.

Elemento Descripción Tipo

SITEID Código de la Planta donde se encuentra Alfanumérico, 8, solo
el almacén. mayúsculas
ITEMNUM Código de la parte o material. Alfanumérico, 30, solo
mayúsculas
LOCATION Código del almacén en Maximo. Alfanumérico, 12, solo
mayúsculas
INVCOST.AVGCOST Costo de la parte o material en el Decimal 10, 2
almacén.

Created: 15/09/2016 01:04:00 Page 8 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

4.3 Inventario de Repuestos B (balances)

WSDL: http://<ip o nombre>:<puerto>/meaweb/wsdl/SAP_InvBalances.wsdl

URL servicio: http://<ip o nombre>:<puerto>/meaweb/services/SAP_InvBalances

La interfaz de balances de inventario permitirá a SAP mantener actualizado en Maximo el balance

o cantidad existente para un código de material en un almacén.

Elemento Descripción Tipo

SITEID Código de la Planta donde se encuentra Alfanumérico, 8, solo
el almacén. mayúsculas
ITEMNUM Código de la parte o material. Alfanumérico, 30, solo
mayúsculas
LOCATION Código del almacén en Maximo. Alfanumérico, 12, solo
mayúsculas
BINNUM Código del estante. Alfanumérico, 8
CURBAL Balance actual de la parte o material en Decimal 15, 2
el almacén.

Inventario debe existir

La combinación material – almacén debe existir previamente en Maximo para poder actualizar el
balance; en caso contrario se arrojará un error. Dicha combinación puede crearse por Maximo o
bien desde SAP mediante la interfaz de inventario detallada en el punto anterior.

4.4 Envío de planificados (pedido) desde Maximo a SAP

Una vez que se planifican en Maximo los materiales y servicios para una orden de trabajo se
realiza un cambio de estado de la orden a APROBADA. Usualmente, este es el momento en que
Maximo puede enviar, ya sea invocando un web service de SAP o bien dejando el pedido en una
tabla a definir, el pedido completo de materiales y servicios relacionados a la OT que está siendo
aprobada.

Cualquiera sea el caso, los campos relevantes relacionados al pedido para enviar a SAP son:

Elemento Descripción Tipo

SITEID Código de la Planta de la OT. Alfanumérico, 8, solo
mayúsculas
WONUM Código de la orden de trabajo. Alfanumérico, 10, solo
mayúsculas

Created: 15/09/2016 01:04:00 Page 9 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

WPMATERIAL. Tipo de línea de material: Alfanumérico, 15, solo

LINETYPE mayúsculas.
-MATERIAL: solo descripción
-ITEM: código
WPMATERIAL. Código del material Alfanumérico, 30
ITEMNUM
WPMATERIAL. Descripción del material Alfanumérico, 100
DESCRIPTION
WPMATERIAL. Descripción detallada Alfanumérico, 32.000
DESCRIPTION_LONG
DECRIPTION
WPMATERIAL. Cantidad del material Decimal; 15,2.
ITEMQTY
WPMATERIAL. Código del almacén desde donde se Alfanumérico, 12, solo
LOCATION pide. mayúsculas
WPMATERIAL. Planta del almacén Alfanumérico, 8, solo
STORELOCSITE mayúsculas
WPMATERIAL. Costo unitario Decimal; 10,2.
UNITCOST
WPSERVICE. Tipo de línea de servicio: Alfanumérico, 15, solo
LINETYPE mayúsculas.
-SERVICE: solo descripción
-STDSERVICE: código
WPSERVICE. Código del servicio Alfanumérico, 30
ITEMNUM
WPSERVICE. Descripción del servicio Alfanumérico, 100
DESCRIPTION
WPSERVICE. Descripción detallada Alfanumérico, 32.000
DESCRIPTION_LONG
DESCRIPTION
WPSERVICE. Cantidad Decimal; 15,2.
ITEMQTY
WPSERVICE. Unidad de compra Alfanumérico, 16, solo
ORDERUNIT mayúsculas.
WPSERVICE. Código de persona que solicita el Alfanumérico, 30, solo
REQUESTBY servicio. mayúsculas.
WPSERVICE. Código del distribuidor del servicio. Alfanumérico, 12, solo
VENDOR mayúsculas.
WPSERVICE. Código de mano de obra o especialidad Alfanumérico, 10, solo
ISSUETO en Maximo a quien se debe despachar. mayúsculas.

Created: 15/09/2016 01:04:00 Page 10 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

4.5 Envío de Solicitud de Autoservicio desde Maximo a SAP

Si hubieran materiales y/o servicios que faltara pedir para realizar una orden de trabajo, estos se
pueden solicitar a través de la aplicación ‘Crear solicitud’ en el módulo de ‘Autoservicio’ de
Maximo, la cual permite realizar un pedido contra una OT. Este pedido adicional también podría
enviarse a SAP.

Los campos relevantes para el envío de esta solicitud son:

Elemento Descripción Tipo

SITEID Código de la Planta de la OT. Alfanumérico, 8, solo
mayúsculas
WONUM Código de la orden de trabajo. Alfanumérico, 10, solo
mayúsculas
MRNUM Número de solicitud de escritorio. Alfanumérico, 8, solo
mayúsculas
REQUESTEDBY Código de persona que ha solicitado el Alfanumérico, 30, solo
material o servicio. mayúsculas
REQUESTEDFOR Código de persona para la que se ha Alfanumérico, 30, solo
solicitado el material o servicio. mayúsculas
MRLINE. Tipo de línea: parte, material, servicio o Alfanumérico, 15, solo
LINETYPE servicio estándar. mayúsculas.
MRLINE. Código del material o servicio. Alfanumérico, 30
ITEMNUM
MRLINE. Descripción del material o servicio. Alfanumérico, 100
DESCRIPTION
MRLINE. Descripción detallada Alfanumérico, 32.000
DESCRIPTION_LONG
DECRIPTION
MRLINE. Cantidad del material o servicio Decimal; 15,2.
QTY requerida.
MRLINE. Costo unitario Decimal; 10,2.
UNITCOST
MRLINE. Costo de línea Decimal; 10,2.
LINECOST
MRLINE. Unidad de compra Alfanumérico, 16, solo
ORDERUNIT mayúsculas.
MRLINE. Código del distribuidor del servicio. Alfanumérico, 12, solo
VENDOR mayúsculas.

NOTA: Las solicitudes de autoservicio que se generen en Argentina no viajarán a la interfaz de

SAP.

Created: 15/09/2016 01:04:00 Page 11 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

4.6 Órdenes de Trabajo Válidas

Para esta interfaz existen al menos dos posibilidades.

1. En un enfoque tipo ‘push’, Maximo puede dejar en una tabla, o invocar a un web service, cada
vez que una orden de trabajo pase a estado aprobado y de igual manera informar cuando una
OT pase a cerrada o completada para que SAP la quite de su lista.
Creo mejor esta opción 1

Por otro lado, en un enfoque tipo ‘pull’, el sistema SAP puede invocar un web service de consulta
que le traiga un listado de todas las OT válidas o bien preguntar por el estado de una en particular.

En este último caso, los campos mínimos para consultar a Maximo por una OT son:

Elemento Descripción Tipo

SITEID Código de la Planta de la OT. Alfanumérico, 8, solo
mayúsculas
WONUM Código de la orden de trabajo. Alfanumérico, 10, solo
mayúsculas

Created: 15/09/2016 01:04:00 Page 12 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

4.7 Costos Reales de la Orden de trabajo A (Despacho de materiales)

WSDL: http://<ip o nombre>:<puerto>/meaweb/wsdl/SAP_InvIssue.wsdl

URL servicio: http://<ip o nombre>:<puerto>/meaweb/services/SAP_InvIssue

Posible reserva de stock y luego, realizar movimiento

La interfaz de despacho de materiales desde bodega permitirá a SAP realizar despachos (y

devoluciones) de material desde el inventario contra una orden de trabajo y de esta forma cargar
el costo de dicho material en ella.

Elemento Descripción Tipo

ISSUETYPE Valores posibles: Alfanumérico, 20, solo
- ISSUE: indica un despacho de mayúsculas
material desde bodega.
- RETURN: indica una
devolución.
SITEID Código de la Planta de Maximo a que Alfanumérico, 8, solo
pertenece el almacén y la orden de mayúsculas
trabajo.
REFWO Código de la orden de trabajo. Alfanumérico, 10, solo
mayúsculas
STORELOC Código del almacén desde donde se Alfanumérico, 12, solo
despacha. mayúsculas
ITEMNUM Código de la parte o material Alfanumérico, 30, solo
despachado. mayúsculas
QUANTITY Cantidad despachada (o devuelta). Decimal, 15, 2
LINECOST Costo de la línea. Decimal, 10, 2
REQUESTNUM Número de la reserva enviada Alfanumérico, 20, solo
previamente a SAP al hacer el pedido. mayúsculas
ACTUALDATE Fecha del despacho Fecha y hora (datetime)
ISSUETO Persona a la que se despacha el Alfanumérico, 12, solo
material mayúsculas

OT en estado válido

La orden de trabajo contra la que se quiere despachar debe existir en Maximo y estar en un
estado válido para recibir cargos. Para consultar si una OT está en un estado válido para cargos
se dispone de una interfaz de consulta (ver el último punto).

Inventario debe existir

Se debe proporcionar un código de almacén válido en Maximo desde donde se despachará, y el

material debe existir como inventario en ese almacén y tener stock; de lo contrario se arrojará un
error.

Created: 15/09/2016 01:04:00 Page 13 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Devoluciones

La lógica de negocio de Maximo valida que no se devuelva más de lo que se ha despachado

previamente, en cuyo caso se arroja un error.

4.8 Costos Reales de la Orden de trabajo B (Recepción de compras)

WSDL: http://<ip o nombre>:<puerto>/meaweb/wsdl/SAP_Receipt.wsdl

URL servicio: http://<ip o nombre>:<puerto>/meaweb/services/SAP_Receipt

La interfaz de recepción de servicios permitirá a SAP recibir la compra de servicios estándar (que
tienen un código en Maximo) contra una orden de trabajo en Maximo.

Elemento Descripción Tipo

SITEID Código de la Planta de Maximo a la que Alfanumérico, 8, solo
pertenece la orden de trabajo contra la que mayúsculas
se quiere recibir.
REFWO Código de la orden de trabajo. [requerido] Alfanumérico, 10,
solo mayúsculas
ISSUETYPE Valores posibles: Alfanumérico, 20,
- RECEIPT: indica una recepción de solo mayúsculas
servicio.
- RETURN: devolución del servicio.

[opcional] Si no viene se asume recepción.

LINETYPE Debe venir: STDSERVICE; en caso contrario Alfanumérico, 15,
se asumirá este valor. solo mayúsculas
ITEMNUM Código del servicio a recibir. Alfanumérico, 30,
Revisar código genérico solo mayúsculas
DESCRIPTION Descripción del servicio a recibir o blanco; si Alfanumérico, 130
viene nulo se toma la descripción del servicio
existente en Maximo.
QTYTORECEIVE Cantidad a recibir [requerido]. Decimal, 15, 2
POLINECOST Costo de la línea [requerido]. Decimal, 10, 2
EXTERNALREFID ID de SAP para la línea recibida. [Requerido Alfanumérico, 10
para ISSUETYPE = ‘RECEIPT’].

Created: 15/09/2016 01:04:00 Page 14 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

Sólo servicios

Esta interfaz solo recibirá compras de servicios con o sin código en Maximo (descripción), dejando
fuera materiales de cargo directo.

OT en estado válido

La orden de trabajo contra la que se quiere recibir debe existir en Maximo y estar en un estado
válido para recibir cargos. Para consultar si una OT está en un estado válido para cargos se
dispone de una interfaz de consulta (ver el último punto).

Costo de línea

El costo de la línea que quedará en Maximo es el enviado por el Sistema Externo, mientras que el
costo unitario se calculará como el costo de línea dividido por la cantidad.

Devoluciones

Maximo valida que no se devuelva más de lo que se ha recibido previamente, y usa el costo
unitario de las recepciones previas para calcular el monto a devolver.

Created: 15/09/2016 01:04:00 Page 15 of 16 File: ET_15725_Interfaces_Integración_SAP

 Confidencial

Documento de Especificación Técnica

5 Supuestos

6 Instrucciones de Instalación

7 Test unitarios ejecutados/Plan de pruebas

Nª Instrucciones Resultado

Created: 15/09/2016 01:04:00 Page 16 of 16 File: ET_15725_Interfaces_Integración_SAP