IBM Maximo Enterprise Adapter

Version 7.5

System Administrator Guide

(SAP Applications)

Note
Before using this information and the product it supports, read the information in Notices on page 307.

This edition applies to version 7, release 5, modification 0 of IBM Maximo Enterprise Adapter and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2007, 2011. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Chapter 1: Integration framework architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Integration framework overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Integration framework for data exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Publish channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Invocation channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Enterprise services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 External systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Data import and data export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Integration framework for operational management product integration . . . . . . . . . . . . . . . . . . . . . . . . . 9 Process management products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Logical management operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Integration modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Operational management products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Integration framework for user interface integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Launch entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Land in context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Chapter 2: SAP integration processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 SAP adapter components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Integration component requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 SAP integration processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Maximo enterprise SAP adapter interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Integration components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Overview of integration touch points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Scenario 1: material management and purchasing in SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Scenario 2: material management in Maximo Asset Management, purchasing in SAP . . . . . . . . . . 22 Scenario 3: material management and purchasing in Maximo Asset Management . . . . . . . . . . . . . 23 Maximo enterprise SAP adapter outbound and inbound processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Outbound processing from Maximo Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Inbound processing to Maximo Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 SAP system outbound and inbound processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Outbound processing from the SAP system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Inbound processing to SAP system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Chapter 3: Organizational structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 SAP organizational structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Maximo organizational structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Chapter 4: Interface controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Maximo enterprise SAP adapter interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Boolean Type Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 List type controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Copyright IBM Corp. 2007, 2011

Value type controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cross-reference type controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cross-reference control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multiplication control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creation and configuration of interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

39 39 39 39 39

Chapter 5: Customization with user exits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Chapter 6: Multiple language support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Multiple language support in SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 ZBC_SAPMXCONFIG table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Units of measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Descriptions and PO text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Multiple language support in the Maximo enterprise SAP adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Short and long descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Units of measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Status values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Configuration of the Maximo enterprise SAP adapter for multiple language support . . . . . . . . . . . 52 Chapter 7: Error handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 SAP to Maximo Asset Management errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 IDoc processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 PI message processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Maximo Asset Management to SAP errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 External error handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Internal error handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Batch input map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 ZBC_BAPIADMIN report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Configuring the ZBC_BAPIADMIN report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 ZBC_BAPI_XXXX process-specific tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Chapter 8: Integration transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Logistics module, materials management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Accounting module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Human resources module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Chapter 9: Configuring the Maximo Enterprise Adapter for SAP Applications . . . . . . . . . . . . . . . 63 Coordinating shared data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Configuration task overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Configuring Maximo Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Synchronizing GL components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 SAP cost objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Configuring the Maximo GL account format to match the Maximo Enterprise Adapter for SAP applications GL format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Configure interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Reconfiguring Maximo table columns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Configuring Maximo field lengths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Synchronizing units of measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 PR line units of measure conversion factor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Outbound Maximo PO/PR number prefixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Outbound Maximo WO number prefixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Outbound Maximo WO task ID prefixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Synchronizing currency codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Synchronizing item categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Synchronizing work order status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Enabling publish channel events listeners. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Configuring interface controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Configuring SAP Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 4
System Administrator Guide

Maintaining custom configuration tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Maintaining ZBC_INBPROGRAMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Maintaining ZBC_FILTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Filtering the data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Example 1: Send all purchase orders related to Maximo work orders or Maximo purchase requisitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Example 2: send all receipts related to purchase orders with Maximo work orders or Maximo purchase requisitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Example 3: send all issues related to Maximo work orders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Example 4: send material master data of material type spare part, if the data was created/ changed on the client level or in plant 0001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Example 5: send material master data of material type spare part, if the data was created or changed on the client level or in plant 0001 or in plant 0002. Send the changes of the client level on material only, if the material exists in plant 0001 or 0002 . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Maintaining ZBC_SAPMXCONFIG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Maintaining ZBC_RUNTIMES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Maintaining ZBC_DESTINATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Running reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Required reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Optional reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Configuring SAP PI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Chapter 10: Financial integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 General ledger components and chart of account integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Structure of SAP and Maximo financial data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 SAP cost objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Transfer of cost objects from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Batch report selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Batch report processing options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Configuration of Maximo accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 The SAPGLCOMP control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 The SAPGLCONCAT interface control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Default account configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Maximo general ledger configuration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Work order interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Journal interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Effectivity of GL components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 SAP adapter bulk load action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Cron task SAPMASTERDATAUPDATE action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Field added to COA and GLCOMP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Related Maximo object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 General ledger journal integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Configuration of journals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Chapter 11: Craft and labor integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Overview of craft and labor integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Configuration of skill levels and pay rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Craft integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Structure of SAP and Maximo craft data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Contents

Transfer of cost center and activity type data from SAP to Maximo Asset Management . . . . . . . . Batch report ZBCXIREPR170 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Effectivity of craft data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAP adapter bulk load action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cron task SAPMASTERDATAUPDATE action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fields added to CRAFT table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Labor integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of SAP and Maximo labor data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of personnel data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR150 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR150 processing options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IDOC processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Effectivity of labor data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related enterprise service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Labor time reporting integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of SAP and Maximo labor time data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of labor time data from SAP to Maximo Asset Management. . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR160 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR160 processing options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

122 122 123 123 123 125 125 125 126 126 126 127 127 127 128 128 128 129 129 129 129 129 130 130 131 132 132 133 133

Chapter 12: Purchasing integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Purchasing scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Purchasing and invoicing considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Structure of purchasing hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Status controls for outbound transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Purchasing line types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Item number mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Multiple distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Multiple distributions inbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Inbound purchase order line numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Multiple distributions outbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Outbound purchase order line numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Vendor integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Structure of vendor data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Creating Maximo company masters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Transferring vendor data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . . . . . . . . . 144 Batch report ZBCXIREPR007 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Batch Report ZBCXIREPR007 processing options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Process flow for send all vendors (Bulk Load) processing option . . . . . . . . . . . . . . . . . . . . . . . . 145 Process flow for send changed vendors (Incremental Update) processing option . . . . . . . . . . . 145 Process flow for send vendor immediately processing option . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 CREMAS IDOC method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Effectivity of vendor data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Maximo Enterprise Adapter for SAP bulk load action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Cron Task SAPMASTERDATAUPDATE action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Fields added to COMPANIES Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 6
System Administrator Guide

Related interface control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contract integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of contract data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Types of contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contract integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IDoc type EKSEKS01 filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contract authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creation of purchase orders from contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximo contract line status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase requisition integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of purchase requisition data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase requisition integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of purchase requisition numbers for outbound PRs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Field added to PR table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fields added to PRLINE table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase requisition status update integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase requisition considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reuse of closed PR lines in SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using multiple purchase order numbers per PR line in SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of PR status update data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR005 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR005 processing options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase order integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase order integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of purchase order numbers for outbound POs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of purchase order line numbers for inbound POs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fields added to PO table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fields added to POLINE table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase order ownership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of purchase order data from SAP to Maximo Asset Management. . . . . . . . . . . . . . . . . . . IDoc type EKSEKS01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Blanket contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipts for inbound GR non-valued PO line items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of purchase order revision data from SAP to Maximo Asset Management. . . . . . . . . . . . Transfer of purchase order data from Maximo Asset Management to SAP. . . . . . . . . . . . . . . . . . . Transfer of purchase order revision data from Maximo Asset Management to SAP. . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice and credit memo integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Control GL posting date behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents

148 149 149 150 151 151 152 152 152 152 153 153 153 153 154 155 156 156 157 157 158 159 159 159 160 160 160 160 160 162 162 162 163 163 163 163 164 165 165 165 166 167 168 169 169 169 169 169 170 170 170 171 171 171 172 173 173 173 7

Reverse invoice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inbound invoice considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice credit quantity values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Currency code handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoices referring to PO lines with goods receipts (GR) and invoice receipts (IR) . . . . . . . . . . Invoices inbound from MM logistics invoice verification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inbound MM invoice considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoices inbound from FI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inbound FI invoice considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transferring FI invoice data from SAP to Maximo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch Report ZBCXIREPR014 selection criteria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outbound invoices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outbound invoice integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAPAPTYPE value control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outbound invoice considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice credit quantity values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service line items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximo invoice number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoices outbound to MM logistics invoice verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outbound MM invoice considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of invoice verification from Maximo Asset Management to SAP . . . . . . . . . . . . . . . . Invoices outbound to FI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAPFIGLACCT value control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximo invoice number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice variance integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice variance integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inbound invoice variance considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoice credit quantity values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Currency code handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipts for PO or WO invoice variances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Service items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximo invoice site reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of invoice variance data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR014 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Domain integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fields added to MAXDOMAIN table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Material groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of material group data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . Batch report ZBCXIREPR008 selection criterion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purchase groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of purchase group data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . Batch Report ZBCXIREPR009 selection criterion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FI GL accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of FI GL account data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . Batch Report ZBCXIREPR011 Selection Criterion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

174 174 175 175 175 175 176 176 176 177 177 177 177 178 178 180 180 180 180 180 181 181 181 181 181 181 182 182 182 182 183 184 184 184 184 184 184 185 185 185 185 185 185 186 186 186 187 187 187 187 187 187 188 188 188 188

Chapter 13: Item and inventory integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 8

System Administrator Guide

Item and inventory integration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAP material master hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item and inventory integration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relationship between the SAP and Maximo Asset Management item and inventory hierarchies . . . . Units of measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt tolerances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Effectivity of item master data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR100 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IDOC Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inventory and inventory balances integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Integration of plant-level data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Integration of storage location-level data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Material cost valuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inventory vendor integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SAP and Maximo integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer of purchase info data from SAP to Maximo Asset Management . . . . . . . . . . . . . . . . . . . . IDOC processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR013 selection criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch report ZBCXIREPR013 processing options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipt tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Effectivity of inventory vendor data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximo Enterprise Adapter for SAP Bulk Load Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cron task SAPMASTERDATAUPDATE action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fields added to INVVENDOR table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Issues and receipts overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Movement types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IDOC processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receipts integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outbound receipts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inbound receipts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Issues integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Outbound issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inbound issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo enterprise service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

190 190 190 191 192 193 193 193 194 194 195 195 195 196 197 198 198 198 198 199 200 200 200 200 201 201 201 202 202 202 203 203 203 204 204 204 205 205 205 206 206 206 209 210 210 210 210 210 210 211 212 213 213 213 213

Chapter 14: Work orders and reservations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Work orders and reservations overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Contents

Configuration of accounting data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Work order integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure of work order numbers for outbound WOs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Field added to WORKORDER table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reservations integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related interface controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo publish channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Maximo object structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related SAP tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

216 216 217 217 218 218 219 219 219 220 221 221 221

Appendix A: SAP to Maximo Asset Management message mapping . . . . . . . . . . . . . . . . . . . . . . . . . 223 Contract message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 CO postings message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 Craft message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Domain message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 GL accounts message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 Inventory message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 Inventory balances message mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Inventory vendor message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Invoice message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 Issue message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Item message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Labor message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Labor hours mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 Purchase order message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Purchase requisition mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Receipt message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Vendor mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Appendix B: Maximo Asset Management to SAP message mapping . . . . . . . . . . . . . . . . . . . . . . . . . 243 GL posting message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 FI invoice message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 MM invoice message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Issue message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 Labor hours message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Purchase order message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Purchase requisition message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 Receipts message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 Reservation message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 Work order message mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 Appendix C: SAP ABAP Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 SAP ABAP reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 SAP function modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Function modules for the direction SAP to Maximo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 Function modules for the direction Maximo Asset Management to SAP . . . . . . . . . . . . . . . . . . . . . 254 Appendix D: SAP ABAP structures for IDOC transaction filtering . . . . . . . . . . . . . . . . . . . . . . . . . 257 ZBC_S2M_PurchaseOrder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 ZBC_S2M_MMINVOICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 ZBC_S2M_MATERIALMASTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 ZBC_S2M_LABORMASTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 ZBC_S2M_GOODSMOVEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 ZBC_S2M_CONTRACTAUTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 10
System Administrator Guide

ZBC_S2M_VENDORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 ZBC_S2M_INFORECORD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 Appendix E: BDC transaction codes and BAPI programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 Appendix F: Collaboration switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 Format of collaboration switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 Process control identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 System ID 1 and system ID 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 Process control value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 Default collaboration switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Retrieving a collaboration switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Viewing collaboration switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 Modifying a collaboration switch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 Adding a collaboration switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 Inventory collaboration switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 Invoice collaboration switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 Labor transaction collaboration switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 Purchase order collaboration switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 Purchase requisition collaboration switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Receipt collaboration switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 Work order collaboration switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Contents

11

12

System Administrator Guide

About This Publication

This describes how it can help you to use the IBM Maximo Enterprise Adapter for SAP Applications.

Intended Audience
This is for the following readers: Enterprise system users Implementation team members T Maximo Asset Management users T SAP users T System administrators
T T

Copyright IBM Corp. 2007, 2011

13

Intended Audience

14

System Administrator Guide

Integration framework architecture

Anyone involved in the implementation or day-to-day administration of the integration framework applications must be familiarized with the integration framework architecture. Familiarity with the architectural concepts is essential for using the application and implementing framework components.

Copyright IBM Corp. 2007, 2011

15

Integration framework overview

Integration framework overview

The integration framework facilitates bidirectional data exchange between Maximo Asset Management and external applications in real time or batch mode. Through the integration framework, you can exchange data synchronously and asynchronously by using a variety of communication protocols. The integration framework also provides features that support the integration with operational management products, such as IBM TivoliProvisioning Manager. You also can use a system application user interface to launch an external application user interface. Integration framework for data exchange Through the integration framework, you can send and receive XML messages between Maximo Asset Management and external applications. The integration framework provides the following capabilities:
T T

Build, transform, and customize message content Send and receive messages using multiple protocols, including:

Web services Hypertext Transfer Protocol (HTTP) Java Message Service (JMS)

T T T

Exchange data synchronously and asynchronously Exchange event-based messages Import and export messages in batch mode

The following integration framework components support data integration:

Component Object structures Services Channels External systems

Description Define message content. Receive data into Maximo Asset Management. Send data out of Maximo Asset Management. Define external applications and services that integrate with Maximo Asset Management. Modes that you use to communicate with external applications. Modes include Web services, HTTP, Enterprise bean (EJB), and flat files.

Endpoint

16

System Administrator Guide

Integration framework overview

Component Events

Description The business object events that you use to initiate data exchange. Events include data import, data export, and record status changes. Query message and receive data by the integration framework. System content that is configured to enable various integration components.

Web services Content

Operational management product integration

Operational management product integration facilitates the automation of information technology services, such as software deployment. A process management product calls an integration module which in turn communicates with the operational management product to perform a logical management operation. With this framework, you can automate logical management operation actions, such as software deployment. The process management product initiates the integration module to invoke the operational management product to perform automated actions. By using the integration framework, you can configure integration modules to support specific logical management operations and operational management products. You configure an endpoint and handler to identify the communication protocol (HTTP, Web service) that the integration module uses to invoke the operational management product. The integration module can map the service response so that it is returned to the process management product. The service response then can be processed in multiple ways. The service can open a response in a user interface application, or save the response data to the application database. You use the integration framework to integrate operational management products by using an assisted approach. The following integration framework components use operational management product integration: Component Logical management operations Description An application that you use to define the actions that the integration module supports for an operational management product, such as software deployment. An application that you use to define the configurations and the relationships to integration modules, logical management products, and operational management products.

Integration modules

Integration framework architecture

17

Integration framework for data exchange

Component Actions

Description You use actions to implement an automated or semi-automated invocation of integration modules and operational management products by a process management product. You can initiate actions from user interface applications, escalations, and workflows.

Integration framework for UI integration

The integration framework provides a mechanism for you to navigate from a system application user interface to an external application user interface. You can define the context to facilitate the navigation into the external application interface. The integration framework supports URL substitutions of any values of any system business object. For example, you can configure Maximo Asset Management to display a specific part number in an external application. You can use operational management product-specific features when you launch to an operational management product application user interface. Features include retrieving the registered host name of the operational management product and a configured item source token for the operational management product. Through the Launch in Context application, you can navigate to any external application other than the operational management product. You also can navigate to a system user interface from an external application (Land in Context).

Integration framework for data exchange

The integration framework consists of individual data exchange components and features.

Object structures
An object structure is the common data layer that the integration framework uses for all outbound and inbound application data processing. An object structure consists of one or more business objects that make up the content of an XML message. You can use the message content of a single object structure to support inbound and outbound messages. When you define multiple objects in the object structure, the objects must have a reference to a valid parent-child relationship within Maximo Asset Management. The object structure has a Java definition class that you can code to perform logic such as filtering for outbound messages. For inbound messages, you can use an object structure Java processing class to invoke specific business object logic that is beyond the normal integration framework insert, update, and delete processing.

18

System Administrator Guide

Integration framework for data exchange

The object structure is the building block of the integration framework that lets framework applications to perform the following functions:
T T T

Publish and query application data Add, update, and delete application data Import and export application data

You also can use the object structure as a service to support inbound message processing. You can invoke the object structure service as a Web service, as an enterprise bean, or by using HTTP. The object structure service supports system data updates, and queries that are started outside of Maximo Asset Management.

Publish channels
A publish channel is the pipeline for sending data asynchronously from Maximo Asset Management to an external system. Events that initiate publish channel processing are object events (insert, update, and delete), application-initiated calls, and data export. The content of a publish channel XML message is based on the associated object structure. When you trigger publish channel processing, the integration framework builds the XML message based on the object structure. Maximo Asset Management then moves the message through multiple processing layers before placing the message into a queue and releasing the initiator of the transaction. The publish channel can use the following processing layers:
T

Processing rules The integration framework provides a rule engine where you can filter and transform the XML message. You can implement rules in the Publish Channel application. User exit Represents a Java class that you can use to filter data, transform data, and implement business logic. You can use this class as part of an installation-customization. Data processing class Represents a Java class that you can use to filter, transform data, and implement business logic. Adapters for Oracle and SAP provide processing classes to support integration to these products. XSL map Represents an XSLT style sheet that you can use to transform data and perform mapping of the XML message to another format.

After Maximo Asset Management places the message into the queue, a polling thread (Maximo cron task) picks up the message and sends it to an external system through a configured endpoint. The endpoint identifies the protocol that Maximo uses to send data, such as HTTP or Web services. The endpoint also identifies the property values that are specific to that endpoint, such as URL, user name, and password.

Integration framework architecture

19

Integration framework for data exchange

Invocation channels
The Service Oriented Architecture (SOA) enables the use of external services to process data from multiple sources. Invocation channels support a generic service-oriented architecture capability by enabling Maximo Asset Management to call an external service synchronously. The invocation channel returns the response of the service back to the caller for subsequent processing. For example, you might want to use an external system to calculate the tax amount for a product that you want to purchase. You can configure an invocation channel to call the external tax service. The invocation channel then can save the value of the external tax amount in Maximo database. The initiation of an invocation channel is implemented by using an action class, which then calls an invocation channel. You can implement an action by using the following means:
T T T

A user interface control (within an application) Workflow routing Escalation

Maximo Asset Management execution of an invocation channel is synchronous, and a response can be returned from the external service to the caller. The content of an invocation channel data structure is based on the associated object structure. When the invocation channel processing starts, the integration framework builds the XML message based on the object structure. The message then moves through multiple processing layers before calling the external service. The invocation channel can use the following processing layers:
T

User exit Represents a Java class that you can use to filter data, transform data, and implement business logic. You can use this class as part of an installation-customization. Data processing class Represents a Java class that you can use to filter, transform data, and implement business logic. Adapters for Oracle and SAP provide processing classes to support integration to these products. XSL map Represents an XSLT style sheet that you can use to transform data and perform mapping of the XML message to another format.

After the message goes through the processing layers, the integration framework uses the configured endpoint to call the external service. The endpoint identifies the protocol Maximo Asset Management uses to send data, such as HTTP or a Web service. The endpoint also identifies the property values that are specific to that endpoint, such as URL, user name, and password. When the message is delivered to the endpoint, the response of the service is returned to the invocation channel. The response message can use similar processing layers that are available on the response portion of the invocation channel: user exit, process class, and XSL map. The response XML is mapped back to the response object structure, which can be the same or different from the object structure that initiated the message. The data mapped in the object structure is returned to the caller of the channel for subsequent processing. The
20
System Administrator Guide

Integration framework for data exchange

invocation channel can be configured to ignore the response that is returned from the external service and return no data to the caller of the channel.

Enterprise services
The enterprise service is a pipeline for querying system data and importing data into Maximo Asset Management from an external system. You can configure enterprise services to process data synchronously (without a queue) or asynchronously (with a queue). Enterprise services can use multiple protocols, such as Web services and HTTP. The enterprise service has data processing layers that transform data and apply business processing rules to data before it reaches Maximo objects. When the inbound message reaches the object structure layer, the XML message must be in the format of the object structure schema. Maximo Asset Management then can process the message successfully. The enterprise service can use the following processing layers:
T

Processing rules The integration framework provides a rule engine where you can filter and transform the XML message. User exit Represents a Java class that you can use to filter, transform data, and implement business logic. You can use this class as part of an installation-customization. Data processing class Represents a Java class that you can use to filter, transform data, and implement business logic. Adapters for Oracle and SAP provide processing classes to support integration to these products. XSL Map Represents an XSLT style sheet that you can use to transform data and perform mapping of the XML message to another format.

External systems
Any business application that sends data to Maximo Asset Management or receives data from Maximo Asset Management is an external system. External systems are an integral part of enterprise service and publish channel processing. You use and configure enterprise services and publish channels to exchange data with one or more external systems. Object structure services and invocation channels do not use external systems. You can use the External Systems application to perform the following functions:
T

Name the external applications or systems that exchange data with the integration framework Specify the protocol that the integration framework uses to send data to the external system Identify the publish channels and enterprise services that each system implements Create interface tables
21

Integration framework architecture

Integration framework for data exchange

To create an external system, you specify an endpoint, the queues, and the integration control values in the External System application. You can also define the following properties on the external system:
T

The endpoint that identifies how and where the integration framework exchanges data with Maximo Asset Management The Java Message Service (JMS) queues that Maximo Asset Management uses Whether the external system is ready to begin integration processing

Web services
External applications, Enterprise Service Bus, and Business Process Execution Language processes can use Web services to query or send transactions to the integration framework. The integration framework provides three types of services that you can deploy as a Web service:
T T

Object structure service Enterprise service T Standard service When you deploy Web services, Maximo Asset Management generates a schema and Web Services Description Language (WSDL) file that you can access with a URL. Optionally, a Universal Description Discovery and Integration (UDDI) registry can be updated for each deployed service. The integration framework supports the following Web services:
T

Object structure Web service - Object structure Web services are created from an object structure and do not provide a processing layer which is available to enterprise services. An object structure Web service supports five operations: create, delete, query, sync, and update. Enterprise Web service - Enterprise Web services are created from an enterprise service and provide exit processing and optional JMS support. The integration framework creates individual enterprise Web services for the operation that is defined in an enterprise service (one operation per service). The operations that are supported in an object structure service are also supported in an enterprise Web service. You can deploy an enterprise Web service to use a JMS queue (asynchronous process) or to bypass the JMS queue (synchronous process).

Standard Web service - Standard Web services are created from methods that are defined in application services. The methods must be annotated in the application service to be available for Web service implementation. The integration framework links input and output parameters of the methods to the Web Services Description Language operation parameters.

22

System Administrator Guide

Integration framework for operational management product integration

Data import and data export

With the integration framework, you can load data from either flat files, such as comma separated, or XML files. You can initiate the data load through an application user interface. You also can start a data load from a scheduled background process by using a system cron task. With the integration framework, you can export data in a batch mode. You can start a data export of the content that is associated with the publish channel from the application user interface. You can filter the content to limit the amount of data that is being exported. You can export data to a destination by using any of the available endpoints and handlers that the integration framework provides.

Content
The integration framework provides predefined content that facilitates your integration to external applications and services. The predefined content available for your use includes:
T

Over 40 predefined object structures that use many of the primary business objects within Maximo Asset Management. Object structures have one or more business objects and contain the relationships that are needed between business objects. Corresponding enterprise services and publish channels for the predefined object structures. One external system that is configured to use all the predefined enterprise services and publish channels. Eight predefined handlers that support different communication protocols, such as Web services and HTTP.

Integration framework for operational management product integration

The integration framework provides components and features that support the integration between Maximo Asset Management and the operational management products.

Process management products

Process management products, or system built applications, escalations, and workflows, use the integration framework to make calls to operational management products by using defined logical management operations and integration modules. Process management products can integrate with operational management products in an automated mode using integration modules. Process management products also can integrate with operational management products in an assisted mode by using launch in context.

Integration framework architecture

23

Integration framework for operational management product integration

Most process management products have mechanisms to automate tasks such as software deployment by using Maximo supported logical management operations and integration modules. The process management product provides an action class that initiates the call to an integration module, and subsequently the operational management product. The process management product then processes the response from the operational management product. Process management product processing can involve saving a value to Maximo database or displaying the response to you from a user interface, or both.

Action
A process management product can implement a custom action Java class to call an integration module. An action can be associated with a system application, a system workflow, or a system escalation. When you initiate the action, Maximo Asset Management runs the registered Java class, which can be coded to call an integration module. The integration module then calls the operational management product.

Logical management operations

A logical management operation, such as a software deployment, defines the action that the process management product takes on the operational management product. Typically, a process management product takes action against a configuration item, such as a server. Logical management product definitions act as the interface between the process management product and the integration module. The logical management operation allows the integration module and the process management product to be designed and implemented, independent of each other. A logical management product created by an integration module would identify the actions that the integration module supports for an operational management product. A logical management product created by a process management product identifies the actions the process management product needs the integration module to support. The logical management product record identifies the following properties:
T T

The name and description of the action that it supports Whether operational management processing is synchronous or asynchronous The input (source) and output (target) objects and fields that are required for the logical management product

Integration modules
The integration module provides a mechanism for a process management product, such as change or release, to invoke an external operational management product. The integration module provides the capability for a process management product to communicate with an operational management product for specific
24
System Administrator Guide

Integration framework for user interface integration

logical management operation actions. The integration module is the integration component that resides between the process management product and the operational management product. When invoked by a process management product, the integration module uses data that is passed by the process management product to assist in the invocation of the operational management product service. The integration module may also return the operational management product response data to the process management product. When installed, integration modules include the logical management operations that they support for an operational management product. Depending upon the level of complexity, you can implement an integration module as a Java class or an invocation channel.

Operational management products

Operational management products are external products that you can use to perform information technology services. IBM Tivoli Application Dependency Discovery Manager, Tivoli Provisioning Manager, and IBM Tivoli Configuration Manager are examples of operational management products. Operational management products provide services that external applications (integration modules) can invoke to initiate operational management product actions. Operational management product definitions are registered in Maximo Asset Management and can be loaded from the discovery engine using the Integration Composer. You can also load operational management product definitions by using the features of the integration framework, such as object structure services. The operational management product definitions include properties of the operational management product, such as a host name. The definitions also include configuration item relationships for those configuration items that are managed by the operational management product.

Integration framework for user interface integration

The integration framework provides components and features that support user interface-based integration between Maximo Asset Management applications and the external applications.

Launch entries
You create a launch entry record in the Launch in Context application. A launch entry defines the URL of an external application that you use to open an external application. Launch entries can have the following properties:
T

Specific business objects or multiple objects to identify the objects that can restrict the use of a launch entry to certain applications

Integration framework architecture

25

Integration framework for user interface integration

T T

Context by substituting object field values into the URL string An object classification value that controls the launch entry visibility in a user interface (only show the launch entry on the user interface based on the classification value of current data being processed in the user interface) Operational management product-specific features including the automatic substitution of operational management product host name, and the configuration item source token into the URL based on configuration item Maximo Asset Management processes in the user interface

Land in context
You can use the land in context to have an external application open a system application user interface and to pass context information as part of the URL string.

26

System Administrator Guide

SAP integration processing

The key features of the Maximo Enterprise Adapter for SAP Applications (Maximo enterprise SAP adapter) are summarized in the following list:
T

Manages the integration processing between Maximo Asset Management and SAP Provides a comprehensive set of predefined interfaces in Maximo Asset Management Provides a comprehensive set of predefined integration templates in the SAP NetWeaver Process Integration Enterprise Service Repository Provides custom SAP BAPI and ABAP programs for real time, batch, and userinitiated processing of outbound and inbound data Supports customization of the predefined integration objects Supports load and performance scalability using multiple queues and/or multiple queue consumers

T T

The installation of the Maximo enterprise SAP adapter customizes the Maximo Enterprise Adapter. This chapter describes additional components that the Maximo enterprise SAP adapter installs, and the outbound and inbound processing flows. Anyone involved in the implementation or day-to-day administration of the Maximo enterprise SAP adapter should read this chapter. Familiarity with the concepts in this chapter is essential for understanding the remaining documentation and using the application. This chapter includes the following primary sections:
T T T T T T

SAP adapter components Integration component requirements Integration components Overview of integration touch points Maximo enterprise SAP adapter outbound and inbound processing SAP system outbound and inbound processing

Copyright IBM Corp. 2007, 2011

27

SAP adapter components

SAP adapter components

The following software components work together to transfer data between Maximo Asset Management and SAP systems:
T T

Maximo enterprise SAP adapter objects in Maximo Asset Management Java programs T External exits T Customized SAP Applications ABAP programs and BAPIs T SAP NetWeaver Process Integration 7.1/7.0 or XI The Maximo enterprise SAP adapter tracks the events that cause data to be transferred between systems and the locations of data in each system. The adapter also manages the internal functions of Maximo Asset Management to ensure that transfers occur smoothly and consistently. The adapter contains the business rules that move data between Maximo Asset Management and SAP. It also contains sophisticated error-trapping logic to ensure that no data is lost as it moves through the interface.

Integration component requirements

The integration between Maximo Asset Management and SAP requires the installation or testing of the following components:
T T

Maximo Asset Management 7.5 SAP ERP 6.0 T SAP NetWeaver Process Integration (PI) 7.1/7.0 T Maximo SAP integration software for Maximo Asset Management 7.5

SAP integration processes

The SAP adapter installs the following enterprise services and publish channel processes:
T

Enterprise services Chart of accounts and GL components Labor Craft Time reporting Vendor Purchase requisition status update Purchase order Contract Inv Vendor Receipt Invoice Invoice variance Item Inventory Inventory Balances Material issue T Publish channels
28
System Administrator Guide

Integration component requirements

General ledger journal transaction Time reporting Purchase requisition Purchase order Receipt Invoice Material reservation Material issue Work order

Maximo enterprise SAP adapter interfaces

The Maximo enterprise SAP adapter installs the following interfaces in Maximo Asset Management. Maximo enterprise SAP adapter type SAP Applications enterprise services enterprise service name MXPC_FRSAP05 MXCRAFT_FRSAP05 MXDOMAIN_FRSAP05 MXGLACCT_FRSAP05 MXINVBAL_FRSAP05 MXINVENTORY_FRSAP05 MXINVOICE_FRSAP05 MXINVVENDOR_FRSAP05 MXINVISSUE_FRSAP05 MXITEM_FRSAP05 MXLABOR_FRSAP05 MXEMPACT_FRSAP05 MXPO_FRSAP05 MXPR_FRSAP05 MXRECEIPT_FRSAP05 MXVENDOR_FRSAP05 Description SAP Contract to Maximo SAP Craft to Maximo SAP Domain Data to Maximo SAP GL Accounts to Maximo SAP Inventory Balance to Maximo SAP Inventory to Maximo SAP MM Invoice to Maximo SAP Purchase Info Record to Maximo SAP Issue to Maximo SAP Item to Maximo SAP Labor to Maximo SAP Labor Time Reporting to Maximo SAP Purchase Order to Maximo SAP Purchase Requisition Status Change to Maximo SAP Receipt to Maximo SAP Vendor to Maximo

SAP integration processing

29

Integration components

Maximo enterprise SAP adapter type SAP Applications publish channels publish channels MXGLTXN_TOSAP05 MXINVOICE_TOSAP05 MXINVRES_TOSAP05 MXINISSUE_TOSAP05 MXEMPACT_TOSAP05 MXPO_TOSAP05 MXPR_TOSAP05 MXRECEIPT_TOSAP05 MXWODETAIL_TOSAP05 Description Maximo GL Transaction to SAP Maximo Invoice to SAP Maximo Reservation to SAP Maximo Issue to SAP Maximo Labor Time Reporting to SAP Maximo Purchase Order to SAP Maximo Purchase Requisition to SAP Maximo Receipt to SAP Maximo Work Order and Reservation to SAP

Integration components
The Maximo enterprise SAP adapter is a version of the Maximo External Adapter that includes components configured specifically for handling business transactions between Maximo Asset Management and an SAP Applications system. Some components are on the Maximo side of the integration; some are on the SAP side. This section describes the integration components in the following list:
T T T T T T T

Maximo Enterprise Adapter for SAP Applications SAP custom ABAP programs SAP ERP system ABAP Dictionary Objects SAP custom BAPIs (business APIs) SAP IDOCs (intermediate documents) SAP NetWeaver Process Integration (XI or PI) PI Integration Builder and Enterprise Service Repository templates

Integration component descriptions

Integration components Integration component Maximo Enterprise Adapter for SAP Applications Description The Maximo enterprise SAP adapter is located on the Maximo application server. It transfers data between Maximo Asset Management and the external system using business objects.

30

System Administrator Guide

Integration components

Integration component SAP custom ABAP (Advanced Business Application Programming) programs

Description ABAP is the programming language of SAP. The components of application programs that are responsible for data processing in the SAP system are ABAP programs. ABAP stands for Advanced Business Application Programming. ABAP contains a special set of commands called OPEN SQL. This allows you to read from and write to the database regardless of the database you are using. The database interface converts the OPEN SQL commands into commands of the relevant database. The ABAP Dictionary centrally describes and manages all the data definitions used in the ERP system. The ABAP Dictionary is completely integrated in the ABAP Workbench. All the other components of the Workbench can actively access the definitions stored in the ABAP Dictionary. The ABAP Dictionary supports the definition of userdefined types (data elements, structures and table types). You can also define the structure of database objects (tables, indexes and views). BAPIs are the standard SAP interfaces. They play an important role in the technical integration and in the exchange of business data between SAP components, and between SAP and non-SAP components. BAPIs enable you to integrate these components and are therefore an important part of developing integration scenarios where multiple components are connected to each other, either on a local network or on the Internet. BAPIs allow integration at the business level, not the technical level.

SAP ERP system ABAP Dictionary Objects

SAP custom BAPIs (Business Application Programming Interfaces)

SAP integration processing

31

Integration components

Integration component SAP IDOCs (intermediate documents)

Description IDOCs, or interface/electronic data interchange, is the interface SAP uses to exchange data for a business transaction with an external system like Maximo Asset Management. The IDOC interface consists of the definition of a data structure and a processing logic for the structure. The data structure is an IDOC, which is the exchange format that unites the communicating systems. The SAP NetWeaver Process Integration (PI) enables you to implement cross-system processes. It enables you to connect systems from different vendors (like Maximo Asset Management) in different versions and implemented in different programming languages (Java, ABAP, and so on) to each other. SAP PI is based on open architecture, uses open standards (in particular those from the XML and Java environments). SAP PI is based on general standards so as to enable external systems to be integrated. At the center of the infrastructure is an XML-based communication that uses HTTP. The application-specific contents are transferred in messages in userdefined XML schema from the sender to the receiver using the integration server. Every system that can exchange messages with the integration server can also exchange messages with all the other systems that are connected to the integration server.

SAP NetWeaver Process Integration (PI)

32

System Administrator Guide

Integration components

Integration component PI integration builder and enterprise service repository templates

Description The integration builder is the central development environment for the development of all design objects for the enterprise service repository. The integration builder provides you with an environment with which you can describe integration scenarios, integration processes, interfaces, and mappings independently of a system landscape. You can import RFCs, BAPIs, and IDocs into the enterprise service repository, and for external systems you have the option of loading message schemas in WSDL, XSD, or DTD into the enterprise service repository.

SAP integration processing

33

Overview of integration touch points

Overview of integration touch points

There are three different sets of primary integration touch points between Maximo Asset Management and SAP Applications. The set your integration uses is defined by the system which controls material management and purchasing for your company. This section refers to three different integration touch point configurations as Scenarios 1, 2, and 3. The integration points in the following three scenarios have been tested and are supported by IBM Corporation. You are not limited to using the integration components shown in these scenarios. You can implement the integration points available from the Maximo enterprise SAP adapter that meet your business requirements.

Scenario 1: material management and purchasing in SAP

This configuration assumes the following business integration parameters:
T

Purchase Requisition, Work, and Asset Management in Maximo Asset Management Centralized Purchasing, Material (ITEM), and Inventory in the SAP system General Ledger and Accounts Payable in the SAP system Labor Master from the SAP HR system to Maximo Asset Management Time Reporting: either SAP CA-TS to Maximo Asset Management, or Maximo Asset Management to SAP CO Activity Posting

T T T T

34

System Administrator Guide

Overview of integration touch points

The following diagram shows the touch points for data exchange for Scenario 1: Scenario 1: material management and purchasing in SAP

SAP integration processing

35

Overview of integration touch points

Scenario 2: material management in Maximo Asset Management, purchasing in SAP

This configuration assumes the following business integration parameters:
T

Purchase Requisition, Work and Asset Management, and centralized Inventory in Maximo Centralized Purchasing, General Ledger, and Accounts Payable in SAP system

The following diagram shows the touch points for data exchange for Scenario 2: Scenario 2: material management in Maximo Asset Management, purchasing in SAP

36

System Administrator Guide

Overview of integration touch points

Scenario 3: material management and purchasing in Maximo Asset Management

This configuration assumes the following business integration parameters:
T

Work and Asset Management, centralized Purchasing, and Inventory in Maximo Asset Management General Ledger and Accounts Payable in SAP system

The following diagram shows the touch points for data exchange for Scenario 3: Scenario 3: material management and purchasing in Maximo Asset Management

A dotted line in the Scenario 3 illustration indicates that the integration transaction is optional.

SAP integration processing

37

Maximo enterprise SAP adapter outbound and inbound processing

Maximo enterprise SAP adapter outbound and inbound processing

The Maximo enterprise SAP adapter handles the transfer of business data between Maximo Asset Management and SAP according to the configurations described in the previous section. This section describes the processing of transactions that originate in either Maximo Asset Management or SAP systems. When discussing the Maximo enterprise SAP adapter integration, transaction flows from Maximo Asset Management to SAP are referred to as outbound transactions; transaction flows from SAP to Maximo Asset Management are referred to as inbound transactions.

Outbound processing from Maximo Asset Management

The Maximo enterprise SAP adapter performs real time outbound integration processing, initiated via data entry in Maximo Asset Management. The outbound processing flow is shown in the following figure: Outbound processing flow from Maximo Asset Management to SAP

38

System Administrator Guide

Maximo enterprise SAP adapter outbound and inbound processing

The following prerequisites apply to outbound processing for the Maximo enterprise SAP adapter:
T

All applicable Maximo integration objects, integration points, interfaces, and external systems must be completely defined. The Maximo External System application must be configured with SAP as the end point. The Maximo outbound JMS queue must be configured. The following Maximo entities must be enabled:

T T

External system Applicable interfaces Applicable outbound event listeners The cron tasks that poll the outbound queues

For more information about configuration, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications.

SAP integration processing

39

Maximo enterprise SAP adapter outbound and inbound processing

Inbound processing to Maximo Asset Management

When SAP sends a message to Maximo Asset Management, it uses XML via the integration gateway using HTTP post. The inbound processing flow to Maximo Asset Management is shown in the following figure: Inbound processing flow from SAP to Maximo Asset Management

The Maximo enterprise SAP adapter supports processing of messages inbound to Maximo Asset Management through a sequential queue, a continuous queue, or a combination of the two. The sequential queue processes messages on a strict FIFO basis, while the continuous queue supports multi-threaded processing of transactions.

40

System Administrator Guide

SAP system outbound and inbound processing

The following prerequisites apply to inbound processing for the Maximo enterprise SAP adapter integration:
T

You must completely define all applicable Maximo integration objects, integration points, interfaces, and external systems. You must enable the following Maximo entities:

External system Applicable interfaces The cron task that polls the inbound sequential queue

For more information about configuration, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications.

SAP system outbound and inbound processing

When discussing the SAP system, transaction flows from SAP to Maximo Asset Management are referred to as outbound transactions; transaction flows from Maximo Asset Management to SAP are referred to as inbound transactions.

SAP integration processing

41

SAP system outbound and inbound processing

Outbound processing from the SAP system

SAP performs two types of outbound integration processing for handling by the SAP PI integration server and subsequently the Maximo enterprise SAP adapter:
T T

Batch Reports Intermediate Documents (IDocs) T BAPIs The outbound processing flow is shown in the following figure: SAP PI outbound flow to Maximo Asset Management

Batch report

A batch report is an executable ABAP program that implements reporting. It extracts data from SAP to be sent to Maximo Asset Management. An Intermediate Document (IDoc) is an SAP format for transferring the data for a business transaction. SAP uses IDocs to transfer data between SAP applications, and between SAP and external systems, in this case, the Maximo enterprise SAP adapter and Maximo Asset Management. An IDoc serves as a source document for all other documents created in the SAP system.

Intermediate document (IDoc)

42

System Administrator Guide

SAP system outbound and inbound processing

Inbound processing to SAP system

BDC BDC is a processing mode for a batch input session in SAP. The Maximo enterprise SAP adapter includes custom BDC programs for sending batch data from Maximo Asset Management to SAP. SAP uses Business Application Programming Interfaces, or BAPIs, to handle data sent inbound to SAP. A BAPI is a standardized programming interface that enables external applications, in this case, Maximo Asset Management, to access business process and data in an SAP system. The Maximo enterprise SAP adapter includes custom BAPIs for posting data from Maximo Asset Management to SAP.

Business application programming interfaces (BAPIs)

SAP integration processing

43

SAP system outbound and inbound processing

44

System Administrator Guide

Organizational structure

Before you can configure the integration between Maximo Asset Management and SAP, you must understand the relationships between organization levels in Maximo Asset Management and SAP. This chapter is directed to the system administrators, implementation team members, and SAP and Maximo consultants who configure the integration.

SAP organizational structure

For integration purposes, it is important to understand the cross-relationship between SAP and Maximo organizational levels. For example, a Maximo organization is like an SAP company code, a Maximo site corresponds to an SAP plant, and a Maximo storeroom is like an SAP storage location. The following table provides a brief description for each SAP organizational level. SAP organizational levels Level Client Description The highest level in the SAP system hierarchy, with separate master records and its own set of tables. Any specifications or data you enter at this level are valid for all company codes and for all other organizational structures. For example, a client can be a corporate group. The smallest organization unit for which a complete self-contained set of accounts can be drawn up for purposes of external reporting. An organizational unit serving to subdivide an enterprise according to the requirements of Purchasing. It procures materials and services, negotiates conditions of purchase with vendors, and is responsible for such transactions. An organizational unit serving to subdivide an enterprise according to production, procurement, maintenance, and materials planning aspects. It is a place where either materials are produced or goods and services provided.

Company code

Purchase organization

Plant

Copyright IBM Corp. 2007, 2011

45

SAP organizational structure

Level Storage location

Description An organizational unit allowing the differentiation of material stocks within a plant. All data referring to a particular storage location is stored at storage location level.

The following figure shows the hierarchy structure of SAP organizational levels. SAP hierarchical structure

46

System Administrator Guide

Maximo organizational structure

Maximo organizational structure

In Maximo Asset Management, an organization is a legal entity to which one or more sites belong. You define the chart of accounts and base currency at the organization level, and each site uses the values from the organization to which it belongs. You also define items, labor, purchase agreements, and vendors at the organization level. You define data such as equipment, inventory, purchase orders, and work orders at the site level, so that each site has its own set of equipment, inventory, and so on, that other sites cannot share or view. In Maximo Asset Management, you can have a multisite implementation that lets different company sites share data from a single database, while keeping their operations separate. Organization Within a multisite implementation, an organization is a major division or legal entity of a company, which contains one or more sites. For integration purposes, it is important for you to understand how Maximo Asset Management uses organizations:
T

Items sets let multiple organizations within a company view and choose from a common set of items. When you create an organization, you associate an item set to it. Company sets enable you to share information about companies between multiple organizations. You associate each organization with a company set. Organizations identify unique data sets. Any data that pertains to an organization has an organizational ID (ORGID). There can be many organizations within a single Maximo database. An organization identifies a unique chart of accounts, base currencies, and financial periods. Many sites can belong to the same organization. The organization identifies unique operating data within the system. The definition of companies (vendors), items, taxes, and item assembly structures are created for an organization. Purchase agreements are defined at the organizational level. A purchase order is created for a site, but can use agreements defined for the organization to which the site belongs.

T T T T

T T

Site

A site is a subdivision of an organization that can track inventory and other data separately from other sites. Sites generally share the same options for work orders, equipment, labor, and other types of data. Each site has its own set of equipment, locations, work orders, and job plans that it does not share with other sites. For integration purposes, it is important for you to understand how Maximo Asset Management uses sites:
T T

A site identifies a logical work location. For example, a plant or facility. A site belongs to only one organization.

Organizational structure

47

Maximo organizational structure

T

All transactions are carried out within a site (i.e., work orders, PRs, POs, Invoices, Issues, and Transfers). Assets and locations belong to a site. Assets and locations must be unique within a site.

T T

The following figure shows the hierarchy structure of Maximo organizational levels. Maximo hierarchical structure

48

System Administrator Guide

Maximo organizational structure

The following figure shows how the Maximo organizational levels map to the SAP organizational levels. Mapping Maximo Asset Management and SAP organizational structures

Organizational structure

49

Maximo organizational structure

50

System Administrator Guide

Interface controls

Interface controls let you configure the behavior of the integration processing according to the requirements of individual organizations and sites. This chapter is directed to the system administrators, implementation team members, and SAP and Maximo consultants who are responsible for configuring interface controls. This chapter contains the following sections:
T T

Maximo enterprise SAP adapter interface controls Creation and configuration of interface controls

Copyright IBM Corp. 2007, 2011

51

Maximo enterprise SAP adapter interface controls

Maximo enterprise SAP adapter interface controls

The Maximo interface controls contain values that the integration uses to perform such functions as translating Maximo values to SAP values and vice versa, providing default values for null columns, validating data values, and so on. The controls are defined within the SAP adapter and are used by Java processing code. If you create custom processing rules, the rules can reference the controls. Interface controls can be configured at the system, organization, or site level. Interface Control Levels Control Value System level Description A system-level value applies to all Maximo organizations and sites. If the control is not configured for organization- or site-level values, the integration processing uses the system default. If the control is configured for organization- or site-level values but none exists for a particular organization or site, the integration processing uses the system-level value. An organization-level value applies to all Maximo sites within an organization. If a control is configured for organization-level values but none exists for a particular organization, the integration processing uses the system-level value. A site-level value applies to a specific site within a Maximo organization. If a control is configured for site-level values but none exists for a particular site, the integration processing uses the organization-level value; if none exists, it uses the system-level value.

Organization level

Site level

Maximo Asset Management uses four types of interface controls:

T T

Boolean type controls Cross-reference type controls T List type controls T Value type controls

Boolean Type Controls

A Boolean type interface control specifies a value of 0 (false) or 1 (true).

List type controls

A list type interface control contains a list of values. You can enter multiple values for the control and optionally assign a Maximo domain to the control. Assigning a domain ensures the validation of values entered for that control, at any level. If a domain is not assigned, there is no validation of the values entered.

52

System Administrator Guide

Creation and configuration of interface controls

Value type controls

A value type interface control contains a single value. You can enter a single value for the control and optionally assign a Maximo domain to the control.

Cross-reference type controls

A cross-reference type control replaces one value with another. In an outbound interface, Maximo Asset Management converts a Maximo value to an external system value. In an inbound interface, Maximo Asset Management converts an external system value to a Maximo value. You can optionally assign a Maximo domain to a cross-reference control. If a domain is specified, any Maximo value specified for the control is validated against that domain. If a domain is not assigned, there is no validation of the values entered. In general, a processing error results if a one-to-many mapping exists between the Maximo and external values. A one-to-many mapping is valid if the crossreference control is defined as a multiplication control. A multiplication control is a cross-reference control that copies, or multiplies, an inbound message for multiple organizations or sites. It has one SAP value and multiple Maximo values. You identify the control as a multiplication control on the Inbound Integration Points subtab of the Interface tab, in the Interfaces application. The standard Maximo enterprise SAP adapter does not contain any multiplication controls, but you can define them for custom processing.

Cross-reference control
Maximo Asset Management sites correspond to business units of an external system, but the two systems use different values for these entities. A crossreference control can perform the translation between the two values. For example, a cross-reference control in an inbound interface can translate business unit EX001 to Maximo site MX001. In an outbound direction, the same control can translate MX001 to EX001.

Multiplication control
A multiplication control can update the company in every organization in the Maximo database.

Creation and configuration of interface controls

Unless you create an interface or modify the processing of an existing interface, you probably do not need to create new interface controls. Modifying control values at the external system level is generally sufficient to customize predefined interface processing. If you need to create a new control, you can do so via the Create Integration Controls dialog box in the enterprise services or publish channels application. The online help in that application s you through the process of creating a new control and associating it to the corresponding enterprise service or publish channel.
Interface controls

53

Creation and configuration of interface controls

Keep in mind the following points:

T T

Ensure that the control name is unique across all adapters that you install. You must manually associate the control to existing enterprise services or publish channels that will use it

You set the value of the predefined interface controls in the External Systems application. The table on the following page lists the interface controls installed by the SAP Applications adapter. The following columns are within the table: Interface Controls Column Name Control Name Description Type Description Name of the interface control. A brief description of the control. The type of control: B = Boolean L = List V = Value X = Cross-reference Domain If applicable, the name of the Maximo domain that contains the valid values for the control: N/A = Domains are not applicable to the control N = No domain Org/Site Indicates if the system-level control value can be overridden at the organization or site level: N = Neither O = Organization S = Site Default Values One or more predefined values of the control. If the control is a cross-reference type control, the value on the left is entered in the Maximo Value field when configuring the control, and the value on the right is entered in the External Value field.

54

System Administrator Guide

Creation and configuration of interface

Maximo enterprise SAP adapter interface controls Control name GLSOURCE Description Transaction type of Maximo journals that Maximo Asset Management does not send to SAP. Type L Domain GLSOURCE Org/ site S Default values INVOICETRANS INVTRANS LABTRANS MATRECTRANS MATUSETRANS SERVRECTRANS TOOLTRANS APPR

IVSEND

One or more statuses at which invoices are sent from Maximo Asset Management to SAP. Any Maximo status is a valid value.

IVSTATUS

POSEND

One or more statuses at which purchase orders are sent from Maximo Asset Management to SAP. Any Maximo status is a valid value.

POSTATUS

APPR

PRSEND

One or more statuses at which purchase requisitions are sent from Maximo Asset Management to SAP. Any Maximo status is a valid value.

PRSTATUS

APPR

SAPAAC

SAP account assignment category setting.

A = ASSET F = INTERNALORDER K = COSTCENTER L = ACTTYPE P = WBSELEMENT R = PROFITCENTER U = BUSAREA Z = GLACCOUNT 1 [true]

SAPAPOUT

Indicates if Maximo Asset Management sends FI or MM invoices to SAP.

N/A

Interface controls

55

Creation and configuration of interface controls

Control name SAPAPTYPE

Description SAP invoice (AP/accounts payable) type; specifies whether outbound invoices are posted to SAP FI or MM module. MM and FI are valid values.

Type V

Domain N

Org/ site N

Default values MM

SAPCALSTART SAPCONTRACTTYPE SAPFIGLACCT SAPGLCOMP

SAP calendar start date. Cross-reference Maximo contract type and SAP contract type. SAP general ledger account for FI invoices. SAP general ledger component settings. For more information, see Chapter 10, Financial integration

V X V X

N N N N

N N O N

01-01-1990 BLANKET = MK PRICE = WK [No default value] 0 = WORKTYPE 1 = AACFLAG 2 = ASSET 2 = COSTCENTER Null = ACTTYPE Null = BUSAREA Null = GLACCOUNT Null = INTERNALORDER Null = KOKRS Null = PROFITCENTER Null = WBSELEMENT 1 = CONCATGL AACFLAG = ASSET AACFLAG = COSTCENTER AACFLAG = WBSELEMENT Null = AACFLAG Null = ACTTYPE Null = BUSAREA Null = GLACCOUNT Null = INTERNALORDER Null = KOKRS Null = PROFITCENTER Null = WORKTYPE | = CONCATCHAR

SAPGLCONCAT

SAP general ledger concatenation settings. For more information, see Chapter 10, Financial integration

56

System Administrator Guide

Creation and configuration of interface

Control name SAPINVOICESITEID

Description Determines whether the SAP client uses centralized invoicing, or decentralized invoicing. The default is to use decentralized invoicing. With decentralized invoicing, if an SAP Invoice contains POs from different sites in an organization, Maximo Asset Management creates and stores an invoice for each site on the SAP invoice. To enable centralized invoicing, set this value to the site ID of the Maximo site where invoices are processed. See Invoice and credit memo integration in Chapter 12 for more information.

Type V

Domain

Org/ site O

Default values Null = use decentralized invoicing

SAPINVOICESTATUS SAPIOSTATUS

Determines the default status for reversed invoices received from SAP. Cross-reference Maximo work order status and SAP internal order status.

V X

IVSTATUS N

S N

APPR (default) or PENDREV APPR = 20 CAN = 91 CLOSE = 90 COMP = 40 INPRG = 30 WAPPR = 10 WMATL = 20 WSCH = 20 MAXI = M MINV = I

SAPIOTYPEPREF

Translate SAP internal order type to SAP internal order number prefix. This prefix is concatenated with the Maximo work order number on outbound transactions. List all internal order types that are used in Maximo Asset Management.

Interface controls

57

Creation and configuration of interface controls

Control name SAPITEMSETID

Description Cross-reference Maximo ITEMSETID value and SAP system ID/client. If both systems use the same value, leave both parameters blank.

Type X

Domain N

Org/ site N

Default values [No default value]

SAPLINETYPE SAPMATLTYPE

Cross-reference Maximo line type and SAP general ledger account for purchase orders. Cross-reference Maximo inventory category and SAP material type.

X X

N N

O N

SERVICE = DEFAULT The Maximo value for the following external values is STK: ERSA, FERT, FHMI, HALB, HAWA, HIBE, INTR, LEER, PIPE, PROC, ROH, UNBW, VERP, VKHM The Maximo value for the following external values is NS: CONT, DIEN, IBAU, KMAT, NLAG, PROD

SAPMAXBSNAME SAPMX5SITEPREFIX SAPNSTKROOM SAPORGID

Maximo business system name in SAP PI. Maximo Site ID prefix. Dummy Maximo storeroom location for non-stock items. Cross-reference Maximo organization ID and SAP company code ID. If both systems use the same value, leave both parameters blank.

V V V X

N N N N

N S S N

[No default value] [No default value] [No default value] [No default value]

SAPPOTYPE SAPPRTYPE

SAP purchase order document type. SAP purchase requisition document type.

V V

N N

N N

PO PR

58

System Administrator Guide

Creation and configuration of interface

Control name SAPPURCHSITEID SAPQOS

Description Cross-reference Maximo site and SAP purchasing organization. Indicates if the integration sends outbound interfaces to the sequential or continuous queue associated with the interface. The Maximo value is the name of an outbound interface. The external system value is one of the following: EO (continuous queue) EOIO (sequential queue) The integration sends all interfaces not referenced in this control to the continuous queue.

Type X X

Domain N N

Org/ site O N

Default values [No default value] [No default value]

SAPRSVOUT SAPRSVPRIORITY SAPSITEID SAPSTORERM

Indicates if Maximo Asset Management sends reservation transactions to SAP. Cross reference to convert Maximo hard/soft reservation to SAP reservation priority types Cross-reference Maximo site ID and SAP plant ID. Cross-reference Maximo storeroom and SAP storage location. If both systems use the same value, leave both parameters blank.

B X X X

N/A Y N N

N N N S

1 [true] [No default value]

Interface controls

59

Creation and configuration of interface controls

Control name SAPUNLIMITTOLERA NCE

Description SAP only allows receipt tolerances of up to 99.9%. If the Maximo PO Lines Receipt Tolerance is greater than 99.9%, set this control cause the POLINE.RECEIPTTOLERANCE to be null. If this control is false, an error message tells the user that the receipt tolerance exceeds 99.9% and that they need to specify a valid SAP value. Indicates if Maximo sends work order transactions to SAP. One or more statuses at which work orders are sent from Maximo Asset Management to SAP. Any Maximo status is a valid value.

Type B

Domain N

Org/ site O

Default values 1 (true)

SAPWOOUT WOSTART

B L

N/A WOSTATUS

N S

1 [true] APPR WMATL WSCH

60

System Administrator Guide

Customization with user exits

Every publish channel and enterprise service has corresponding Java user exit procedures where you can override or otherwise customize the predefined integration processing. This chapter is addressed to developers who customize the integration. You also can customize the integration via interface controls and processing rules. For more information, refer to the following documentation:
T T

Chapter 4: Interface controls Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center.

Java User exit procedures

The integration applies Java user exit procedures immediately before and after it executes the predefined processing for the corresponding interface. Use preprocessing and postprocessing methods within a user exit to indicate when the code is to be applied. Although you can give any name to a user exit procedure, consider using the following naming conventions. User exit naming conventions Direction of data transfer Inbound Outbound File naming convention MaxObjectStructureNameDirectionUser.class MoutObjectStructureNameDirectionUser.class

The SAP Applications adapter does not install any predefined user exit procedures. If you use the Maximo enterprise application archive (maximo.ear) file, you must build and deploy it manually after updating Java user exit procedures. For more information, refer to Administering Maximo Asset Management in the IBM Maximo Asset Management 7.5 Information Center. The Java ERP exit procedures reside in the following directory: rootdirectory\applications\maximo\businessobjects\classes\ psdi\iface\sap2005

Copyright IBM Corp. 2007, 2011

61

62

System Administrator Guide

Multiple language support

Both Maximo Asset Management and SAP support multiple languages. This chapter discusses the specific data that can be translated into multiple languages and the SAP and Maximo configuration needed to implement multi-language integration processing. This chapter is directed to system administrators, implementation team members, and SAP and Maximo consultants. It assumes that you have first read the information about multi-language processing in the Administering Maximo Asset Management in the IBM Maximo Asset Management 7.5 Information Center. This chapter contains the following sections:
T T

Multiple language support in SAP Multiple language support in the Maximo enterprise SAP adapter

Copyright IBM Corp. 2007, 2011

63

Multiple language support in SAP

Multiple language support in SAP

SAP can save the following data in multiple languages.
T T

Material unit of measure codes and descriptions Short and long descriptions T Purchase order (PO) text Language codes are written to the SPRAS field in related SAP database tables.

ZBC_SAPMXCONFIG table
The ZBC_SAPMXCONFIG table in SAP identifies the Maximo base language and additional languages that the integration recognizes. The required MXBASELANG variable in that table identifies the Maximo base language. The table can contain one MXBASELANG entry. The optional MXLANGUAGE variable identifies additional languages. The table can contain zero, one, or multiple MXLANGUAGE entries. The ABAP and IDOC programs use the ZBC_SAPMXCONFIG table to determine the languages in which to send descriptions and purchase order text to Maximo Asset Management. In SAP you work in the base language associated with your company code and employee profile. If the same data exists in multiple languages in SAP, the integration sends the data to Maximo Asset Management in each language that is included in the ZBC_SAPMXCONFIG table. Example If the SAP description of a material exists in English, French, and German, and those three languages are defined in MXBASELANG and MXLANGUAGE variables in the ZBC_SAPMXCONFIG table, the integration generates one inbound item interface containing the item description in three languages.

Units of measure
SAP can maintain units of measure in multiple languages. However, the integration sends unit of sure codes to Maximo Asset Management in the SAP base language (the MXBASELANG variable in the ZBC_SAPMXCONFIG table) only.

64

System Administrator Guide

Multiple language support in the Maximo enterprise SAP adapter

Descriptions and PO text

The integration can send short and long descriptions and PO text to Maximo Asset Management in the languages referenced by the MXBASELANG and MXLANGUAGE variables in the ZBC_SAPMXCONFIG table. If an SAP material master record contains a long description and PO text, the integration sends just the PO text, which it stores in the LONGDESCRIPTION table in Maximo Asset Management.

Multiple language support in the Maximo enterprise SAP adapter

When you log into Maximo Asset Management, you choose to use the Maximo base language or another language. Outbound transactions that you generate contain translatable values in the language in which you logged in. Within any Maximo application, you can enter language-specific values for the following columns:
T T

Short and long descriptions Unit of measure description and remarks T Status values Language codes are written to the TRANS_LANGCODE field in related integration interfaces. When Maximo Asset Management receives data from SAP in multiple languages, it writes all the instances of the data to the database. If necessary, you can customize the processing code to filter the records.

Short and long descriptions

Every Maximo database table that contains translatable columns has a corresponding table called L_TABLENAME, where TABLENAME is the name of the Maximo database table. The L_TABLENAME table stores the non-base language values for every translated column except long description. For example, the short description for an item, in a non-base language, is stored in the L_ITEM table. All long descriptions, in both the base language and translated languages, are stored in the LONGDESCRIPTION table. Example You log into Maximo Asset Management as a French user and update an item description in French. The outbound message generated by that activity will contain the item description in French. If the Maximo base language is English, the ITEM table contains the short description on the item in English; the L_ITEM table contains the short

Multiple language support

65

Multiple language support in the Maximo enterprise SAP adapter

description of the item in French; and the LONGDESCRIPTION table contains the long description of the item in English and French.

Units of measure
Maximo Asset Management can store unit of measure descriptions and remarks in multiple languages, in the MEASUREUNIT table.

Status values
You can translate the default Maximo status values that are used in interface controls to other languages. To do so, add the foreign language values in the following places:
T T

as an external value in the appropriate Maximo domain in place of the default Maximo value in the interface control

This option is available with the following controls:

T T

IVSEND POSEND T PRSEND T WOSART

Configuration of the Maximo enterprise SAP adapter for multiple language support
To include translated description values in outbound transactions, add the L_TABLENAME and LONGDESCRIPTION MBOs to the applicable integration objects. Some interfaces contain a column called TRANS_LANGCODE, which contains the language code for the translated columns within the transaction. This column exists in all predefined integration objects that have translatable columns. If you build new integration objects and you want to support translatable columns, add this field. as a user field, to the top-level MBO of the integration object. Many Maximo MBOs include a persistent column called LANGCODE. The Maximo user interface uses this column for text searching. The column is not related to the language of the transaction. Do not include it in integration objects that you create.

66

System Administrator Guide

Error handling

This chapter contains information on errors you can encounter when transferring data between Maximo Asset Management and SAP Applications. It describes strategies and procedures for error handling in SAP. For more information about how Maximo Asset Management handles errors, see Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center.

SAP to Maximo Asset Management errors

This section includes information on error handling for transactions you send from SAP to Maximo Asset Management.

IDoc processing
It is important that all IDocs created for the Maximo Enterprise SAP adapter are sent and processed correctly. To be sure that no IDocs remain unprocessed in the SAP system because of connection errors, schedule the report RSARFCEX at least daily. If you see any connection or performance errors, refer to the corresponding SAP Notes, or contact Support.

PI message processing
The Maximo Enterprise SAP adapter does not use integration-specific configurations or methods for PI message processing. It uses the global SAP NetWeaver Process Integration settings and procedures. The Runtime Workbench of the SAP NetWeaver Process Integration provides monitoring and error handling (reprocessing of messages). Use this tool in the following cases:
T T

To track the status of messages To find errors that have occurred and establish their causes T To restart messages, if the retry interval of the queues has passed T To set up Alert services for getting information about errors by E-mail, fax, text message, and so on

Copyright IBM Corp. 2007, 2011

67

Maximo Asset Management to SAP errors

For more information about PI message processing and error handling, see the corresponding SAP documentation about the SAP NetWeaver Process Integration.

Maximo Asset Management to SAP errors

Error handling on transactions sent from Maximo Asset Management to SAP can be done externally or internally depending on how you configure the SAP Application Server. Refer to Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center for additional configuration information.

External error handling

All SAP function modules return the table RETURN back to the calling proxy. In the case of an error, this table will contain the error message preventing the successful posting of the record. The proxy code loops over this table. If there is an error, RETURN TYPE=E, an exception with the error message of table RETURN is sent back to SAP PI. The message stays in the queue with the status Application Error. Required actions on this error must be done in SAP PI by either of the following methods:
T T

SAP PI Message Monitoring, supports the edit of payloads. A third-party product you use with PI for Monitoring and Error Handling.

Internal error handling

SAP internal error handling depends on the process mode of the transaction coming into SAP. This process mode is maintained in the ZBC_INBPROGRAMS table, in the BDCPR_MODE_ACT field.
T T

If the process mode is BDC, the function module creates a Batch-Input-Map. If the process mode is BAPI, the function module stores the record in tables. Use the program ZBC_BAPI_ADMIN to reprocess these errors.

For both process modes:

T

An E-mail is sent to the specified receivers containing all necessary information about the error. A record is written into the log table ZBC_MSIF. The RETURN table is manipulated to contain only a Success - Message (RETURN-TYPE=S).

T T

68

System Administrator Guide

Maximo Asset Management to SAP errors

Batch input map

A Batch-Input-Map contains the record of the inbound session. Use transaction code sm35 to review the map and correct faulty or insert missing data. At the end of the map, the transaction is posted in SAP.

ZBC_BAPIADMIN report
If the internal error handling process uses BAPIs to post the data into SAP, the record is written to certain tables in the case of an error. All processes write an entry into the table ZBC_BAPIADMIN containing information about the message, the index, and the error. The data itself is written to a process-specific table, referenced by the index value. For example, Work Order error data is written to ZBC_BAPI_WORKOR, Reservation error data is written to ZBC_BAPI_RESERV, and so on. These tables match the structures which were used to send the data into SAP. Use the report ZBC_BAPIADMIN to reprocess these records.

Configuring the ZBC_BAPIADMIN report

The first screen of this report is a selection screen, allowing a filtered view on entries in table ZBC_BAPIADMIN. The next screen shows all selected entries in ZBC_BAPI_ADMIN. Double-click on an entry to jump to the process-specific table, where you can change the data (except some key fields) and reprocess or delete the record. If you reprocess the record, the message in the header line gets updated in case a follow-on error occurs. If the record gets reprocessed successfully (or manually deleted), the record gets deleted from the tables and the program returns to the prior screen containing the message list.

ZBC_BAPI_XXXX process-specific tables

Every Process has a different table to store the messages that errored out. They match the structures that transfer the data (SAP-IR).

Error handling

69

Maximo Asset Management to SAP errors

ZBC_BAPI_XXXX process-specific tables Process GL Postings Invoices Issues Labor Hours Purchase Order Purchase Req Receipt Reservation Work Order Table ZBC_BAPI_GLINVOI ZBC_BAPI_INVOIC ZBC_BAPI_ISSUES ZBC_BAPI_LABHOUR ZBC_BAPI_PURCHO ZBC_BAPI_PURREQ ZBC_BAPI_RECEIP ZBC_BAPI_RESERV ZBC_BAPI_WORKOR Structure name ZBC_M2S_GLINVOICES ZBC_M2S_MMINVOICES ZBC_M2S_ISSUES ZBC_M2S_LABORHOURS ZBC_M2S_PURCHASEORDER ZBC_M2S_PURCHASEREQ ZBC_M2S_RECEIPTS ZBC_M2S_RESERVATIONS ZBC_M2S_WORKORDERS

70

System Administrator Guide

Integration transactions

This chapter describes SAP transaction codes used for the integration of the Maximo enterprise SAP adapter. The tables in this chapter show commonly used transaction codes for the modules and integration components included in the Maximo enterprise SAP adapter. Your implementation of the Maximo enterprise SAP adapter might not use all these possible integration points. They are provided here for your reference when setting up authorization groups for integration users. This chapter contains the following sections:
T T

Logistics module, materials management Accounting module T Human resources module

Copyright IBM Corp. 2007, 2011

71

Logistics module, materials management

Logistics module, materials management

The following table shows the SAP Logistics module, materials management transactions that are part of this integration. Bold print in the SAP materials management applications column indicates the level at which you perform the transaction. SAP Logistics module, materials management transactions SAP materials management applications Purchasing/Purchase Order (MM-PUR-PO) Old transaction code ME21N ME22N Purchasing/Purchase Requisition (MM-PUR-REQ) Purchasing/Outline Agreement (MM-PUR-OA) Contract ME31K ME32K Purchasing/Master Data Info Record (MM-PUR-VM) ME11 ME12 ME15 Purchasing/Master Data Vendor/Purchasing (LO-MD-BP) MK01 MK02 MK06 * * * Create Change (Current) Flag for Deletion * * * Create Change Flag for Deletion * * Create Change ME51N ME52N New transaction code * * Change * * Create Change Transaction code description Create Vendor/Supplying Plant Known

72

System Administrator Guide

Logistics module, materials management

SAP materials management applications Inventory Management/Goods Movement (MMIM) Goods Receipt/For Purchase Order Inventory Management/Goods Movement (MMIM) Goods Issue Inventory Management/Goods Movement (MMIM) Reservation

Old transaction code

New transaction code

Transaction code description

MIGO

GR for Purchase Order

MB1A

Goods Issues

MB21 MB22

* *

Create Change

Logistics Invoice Verification (MM-IV-LIV) Document Entry (Invoice) Material Master/Material (LO-MD-MM) Create (General) Change Flag for Deletion MM01 MM02 MM06 * * * Immediately Immediately Immediately MIRO * Enter Invoice

Transaction codes listed with an asterisk (*) do not have a new transaction code version.

Integration transactions

73

Accounting module

Accounting module
The following table shows the SAP Accounting module transactions that are part of this integration. Bold print in the SAP Accounting Module Applications column indicates the level at which you perform the transaction. SAP accounting module transactions SAP accounting module applications Financial Accounting General Ledger/Posting (FI-GL) Financial Accounting (FI) Vendors/Document Entry/Invoice Controlling/Cost Element Accounting (CO-OM-CEL) Master Data/Accrual Order (Internal Order) Controlling/Cost Element Accounting (CO-OM-CEL) Actual Postings/Activity Allocation (Post Labor Hours) Project System (PS) Project/Special Maintenance Functions/ Work Breakdown Structure (WBS) KB21N * Enter KO01 KO02 * * Create Change F-43 * Invoice - General FB01L * Enter General Posting for Ledger Group Old Transaction code New transaction code Transaction code description

CJ01 CJ02

* *

Create Change

Transaction codes listed with an asterisk (*) do not have a new transaction code version.

74

System Administrator Guide

Human resources module

Human resources module

The following table shows the SAP Human Resources module transactions that are part of this integration. Bold print in the SAP Human Resources Module Applications column indicates the level at which you perform the transaction. SAP human resources module transactions SAP human resources module application Personnel Management Administration/HR Master Data (PA-PA) Time Management Time Sheet/CATS Classic (CATS) CAT2 * Record Working Times PA30 * Maintain Old transaction code New transaction code Transaction code description

Transaction codes listed with an asterisk (*) do not have a new transaction code version.

Integration transactions

75

Human resources module

76

System Administrator Guide

Configuring the Maximo Enterprise Adapter for SAP Applications

The Maximo Enterprise Adapter for SAP Applications enables you to exchange and process data between Maximo Asset Management and SAP Applications. Integration does not change the basic functions of the two systems. Most of the data exchanges involve work orders, purchasing processes, inventory processes, and the general ledger. This chapter describes how to configure the Maximo enterprise SAP adapter. It includes the following sections:
T T

Coordinating shared data Configuration task overview T Configuring Maximo Asset Management T Configuring SAP Applications T Configuring SAP NetWeaver Process Integration (PI) 7.1/7.0

Copyright IBM Corp. 2007, 2011

77

Coordinating shared data

Coordinating shared data

When Maximo Asset Management and SAP share information, certain settings must be the same in both systems. Manually configure the following Maximo settings to match the corresponding settings in SAP. You only need to configure these settings once.
T T T T T T

financial calendars base currencies all currency codes units of measure and conversion factors user names GL account configuration

The integration does not automatically create Maximo company master records for inbound SAP vendors. Configure Maximo Asset Management to create a company master record for each new inbound vendor that has not previously existed in the Maximo database. To avoid errors when you bulk load inbound SAP vendor data, select the Automatically Add Companies to Company Master check box in the Maximo Sets application. During a bulk load of inbound vendor data, this setting will create Company Master records only for vendors new to Maximo Asset Management. If the two applications share data, determine how to make the settings compatible. For example, if SAP defines base currency in terms of the British Pound and Maximo Asset Management is configured to use the U.S. Dollar, determine which base currency to use. Make this base currency the consistent definition for both applications. If you pass journal entries from Maximo Asset Management to the SAP General Ledger (GL), define the components of your Maximo GL account keys to support SAP financial postings.

Configuration task overview

Perform the following tasks for configuring the exchange of data between your Maximo Asset Management and SAP Applications systems.
T

Configuring Maximo Asset Management Synchronizing GL components Reconfiguring Maximo table columns Configuring Maximo field lengths Synchronizing units of measure Synchronizing currency codes Synchronizing item categories Synchronizing Work Order status Configuring interface controls Configuring SAP Applications Maintaining configuration tables Scheduling reports Configuring SAP NetWeaver Process Integration (PI) 7.1/7.0

78

System Administrator Guide

Configuring Maximo Asset Management

Setting receiver determination for multiple Maximo systems (if your integration has more than one Maximo instance exchanging data with SAP)

Configuring Maximo Asset Management

This section provides information on how to configure the Maximo side of the integration. CAUTION If you need to maintain SAP cost objects in different Maximo GL account structures per organization (SAP company codes), you must coordinate with your Maximo system administrator to configure the Maximo GL account structures per organization (SAP company code) prior to your SAP integration.

Synchronizing GL components
The general ledger interface transfers new and updated cost objects from SAP to Maximo Asset Management, and optionally transfers account combinations from SAP to Maximo Asset Management. You initiate these actions through various ABAP programs. The GL structure for integration objects in Maximo Asset Management is composed of cost elements from SAP. You cannot store SAP cost objects in the Maximo database as Maximo GL Components the same way they are stored in SAP. SAP cost objects correspond to Maximo general ledger components. You define Maximo general ledger components at the Maximo system level. All organizations within the Maximo database share the general ledger components that you define.

SAP cost objects

SAP Cost accounting summarizes and posts cost objects by account assignment category (AAC). The integration processes the following SAP account assignment categories:

Configuring the Maximo Enterprise Adapter for SAP Applications

79

Configuring Maximo Asset Management

SAP account assignment categories AACFLAG Description Maximo Enterprise Adapter for SAP applications field COSTCENTER INTERNALORDER WBSELEMENT ASSET GLACCOUNT ACTTYPE BUSAREA PROFITCENTER

K F P A Z L U R

Cost center Internal order WBS element Asset GL account Labor activity type Business area Profit center

The following section describes how to configure Maximo Asset Management to allow SAP cost objects to synchronize with the Maximo GL account structure.

80

System Administrator Guide

Configuring Maximo Asset Management

Configuring the Maximo GL account format to match the Maximo Enterprise Adapter for SAP applications GL format
Maximo Asset Management allows you to maintain different general ledger (GL) account structures for different organizations in one Maximo database. The system-level GL account structure must be configured to accommodate the GL account structures of all organizations. Follow the instructions in this section to change the Maximo GL account structure to the match the Maximo Enterprise Adapter for SAP applications GL account structure.

1 In Maximo Asset Management, choose Go To > System Configuration >

Platform Configuration > Database Configuration.

2 Choose GL Account Configuration from the Select Action menu. 3 Create the following standard GL Account structure for the integration in
Maximo Asset Management: nnnnnn~n~nnnnnnnnnnnnnn where nnnnnn represents the length of the first GL component. n represents the length of the second GL component. nnnnnnnnnnnnnn represents the length of the third GL component. Remember to enter the screen separator as a tilde (~) for all segments except for the last one. You can use the tilde as the separator so that it does not conflict with any special characters in an SAP cost object. The following table lists the standard Maximo Enterprise Adapter for SAP applications GL account configuration requirements: Maximo Enterprise Adapter for SAP applications GL account configuration requirements GL Order 0 1 2 Screen Separator ~ ~

Component First component Second component Third component

Length 6 1 14

Type ALN ALN ALN

Reqd. Y Y Y

If you are using WBS Elements as cost objects, that component can be up to 25 characters in length. If your business requirements dictate otherwise, you do not have to use the standard GL account configuration. If you decide to modify the standard GL components, you are required to enter the first component. Additionally, if you decide to implement a non-standard GL configuration, you can contact IBM Corporation for assistance.

Configuring the Maximo Enterprise Adapter for SAP Applications

81

Configuring Maximo Asset Management

4 In the GL Account Configuration screen, click the arrow next to the COST
CENTER component to open the Details panel. Complete the following fields using the information in the preceding table, to build the Maximo Enterprise Adapter for SAP applications GL account format:
T T T T T T

Component (for example, enter WORKTYPE for Maximo internal order type) Length (for example, six characters) Type (for example, ALN or alphanumeric) Required (for example, enter check for Yes) Screen separator (enter ~) GL order (for example, 0 for first position)

5 Repeat Step 4 and replace existing Maximo component fields with the SAP
2nd and 3rd component field information from the preceding table. Organization-specific GL account structure The following steps describe configuring organization-specific G/L account structure.

1 In Maximo Asset Management, choose Go To > Financial > Chart of

Accounts.

2 Choose Add/Modify Account Structure from the Select Action menu. 3 Modify the GL account length for the specific organization.
For more information on reconfiguring the Maximo GL account structure to support the Maximo Enterprise Adapter for SAP applications GL accounts, see Chapter 10, Financial integration . Chapter 10, Financial integration includes a detailed example and information on concatenating cost elements,

Configure interface controls

You can use the Maximo Enterprise Adapter for SAP applications to synchronize SAP and Maximo GL components by using the SAPGLCOMP and SAPGLCONCAT interface controls. You specify the format of the Maximo account numbers through the values in SAPGLCOMP and SAPCLCONCAT. The format is based on the Maximo GL account structures per organization with a corresponding SAP company code. When formatting the controls, keep in mind the following:
T T

A Maximo account number can have any number of segments. Maximo Asset Management specifies a maximum length, rather than a fixed length, for general ledger components. If a component is smaller than the maximum length, Maximo Asset Management does not require any filler characters.

SAPGLCOMP

The SAPGLCOMP interface control specifies the elements that make up the Maximo GL account number, and the sequence in which those elements appear within the number. You build the account number from the following elements:
T T

SAP company code SAP controlling area T Maximo internal order type
82
System Administrator Guide

Configuring Maximo Asset Management

T T T T T T T T T

Cost type Cost center object Internal order object WBS element object Asset object GL account Labor activity type Business area Profit center

This control lets you specify which SAP cost elements to store in Maximo Asset Management as possible GL components. The Value field of the parameter contains the Maximo GL Order number, which controls the positioning of the component in the GL account format. You can build account numbers from the elements listed in the following table. If you do not use a cost element for a Maximo GL component, then set the Value field of the parameter to NULL. Also, for the CONCATGL parameter, the number represents a Boolean value (1 or 0); not a position within the account number. SAPGLCOMP interface control parameters External value parameter CONCATGL KOKRS WORKTYPE AACFLAG COSTCENTER ASSET WBSELEMENT INTERNALORDER GLACCOUNT ACTTYPE BUSAREA PROFITCENTER Maximo value 1 NULL 0 1 2 2 2 NULL NULL NULL NULL NULL

Description Concatenate SAP Controlling area Maximo Internal Order Type Cost Type Cost Center Object Asset Object WBS Element Object Internal Order Object GL Account Object Labor Activity Type Business Area Profit Center

The GL account number you build can contain any number of components. The GL Order number for a fourth component would be 3; the GL Order number for a fifth component would be 4, and so on. If multiple cost objects can appear in the same component within an account number, assign the same GL Order number to each of those cost objects. For example, if the cost object appears as the third component in some accounts and the asset appears in the third component in some accounts, enter 2 as the value for both COSTCENTER and ASSET.

Configuring the Maximo Enterprise Adapter for SAP Applications

83

Configuring Maximo Asset Management

SAPGLCONCAT

You can use the SAPGLCONCAT interface control to concatenate two cost objects in a single component within the Maximo account number. To concatenate two cost objects within a component of the Maximo GL account number, first enter a value of 1 (true) in the GLCONCATGL parameter of the SAPGLCOMP interface control. If you enter 1, also enter a special character to use as the separator between the concatenated values. You configure the separator using the CONCATCHAR parameter of the SAPGLCONCAT interface control. If you do not plan on concatenating two cost objects, then set the value of the CONCATCHAR parameter to NULL.

84

System Administrator Guide

Configuring Maximo Asset Management

The remaining parameters in the SAPGLCONCAT control are the same as the corresponding parameters in the SAPGLCOMP control as shown in the following table. SAPGLCONCAT interface control parameters External value parameter CONCATCHAR Maximo value | [pipe]

Description Concatenation Separator Character Default = | [pipe]

KOKRS WORKTYPE AACFLAG COSTCENTER ASSET WBSELEMENT INTERNALORDER GLACCOUNT ACTTYPE BUSAREA PROFITCENTER

SAP controlling area Maximo internal order type SAP cost type SAP cost center object SAP asset object SAP WBS element object SAP internal order object SAP GL account SAP labor activity type SAP business Area SAP profit center

NULL NULL NULL AACFLAG AACFLAG AACFLAG NULL NULL NULL NULL NULL

Enter the name of the element that you want to appear first in the concatenated value in the Maximo value column of the element that you want to appear second. For example, to concatenate cost type (AACFLAG) and cost center (COSTCENTER), enter the literal AACFLAG in the Maximo value column of the COSTCENTER parameter. The following example shows how to configure the SAPGLCONCAT control to concatenate cost type with the COSTCENTER, ASSET, and WBSELEMENT cost objects using the pipe character (|) as the separator. The third component will contain one of the following values
T T T

AACFLAG value |COSTCENTER value AACFLAG value | ASSET value AACFLAG value | WBSELEMENT value

The resulting account numbers will have one of the following formats:
T

WORKTYPE value~AACFLAG value~ AACFLAG value | COSTCENTER value WORKTYPE value~AACFLAG value~ AACFLAG value |ASSET value

Configuring the Maximo Enterprise Adapter for SAP Applications

85

Configuring Maximo Asset Management

T

WORKTYPE value~AACFLAG value~ AACFLAG value | WBSELEMENT value

Default Account Configuration

The default values in the SAPGLCOMP and SAPGLCONCAT controls generate Maximo account numbers with the following format: Position of component in account number 1 2 3

Component value WORKTYPE value AACFLAG value AACFLAG value | COSTCENTER value or AACFLAG value | ASSET value or AACFLAG value | WBSELEMENT value

The SAPGLCOMP control contains the following default values: * SAPGLCOMP interface control default values Parameter (external value) CONCATGL WORKTYPE AACFLAG COSTCENTER ASSET WBSELEMENT Maximo value 1 (Yes, concatenate) 0 1 2 2 2

The SAPGLCONCAT control contains the following default values: * SAPGLCONCAT interface control default values Parameter (external value) CONCATCHAR COSTCENTER ASSET WBSELEMENT Maximo value | (pipe) AACFLAG AACFLAG AACFLAG

*The value of the remaining parameters in the control is NULL.

86

System Administrator Guide

Configuring Maximo Asset Management

Reconfiguring Maximo table columns

Ensure that database columns corresponding to each field of data coming from SAP are defined in the Maximo database tables. Also reconfigure Maximo database columns to be compatible with the corresponding columns in SAP. If you do not, Maximo Asset Management cannot store the imported data. Compare the Maximo tables to the tables in your SAP applications. All columns containing data shared by Maximo Asset Management and your external applications must have the same:
T T

Column length Data type T NULL settings To reconfigure the Maximo table columns so they are compatible with the corresponding columns in the SAP system, use the Database Configuration application in Maximo Asset Management. For instructions on using the Database Configuration application, refer to Administering Maximo Asset Management in the IBM Maximo Asset Management 7.5 Information Center.

Configuring Maximo field lengths

The following table lists Maximo fields which you must modify for integrations between Maximo Asset Management and SAP. Certain Maximo fields are reserved by default for use with the SAP integration. In order to ensure that your configuration works correctly, do not use these reserved Maximo fields for any other purpose. Fields denoted in bold are SAP reserved fields. Maximo Fields that you must modify Object CRAFT PO INVOICE INVOICE CONTRACT MATRECTRANS MATUSETRANS SERVRECTRANS LABTRANS INVVENDOR Attribute CRAFT PONUM INVOICENUM EXTERNALREFID CONTRACTNUM EXTERNALREFID EXTERNALREFID EXTERNALREFID EXTERNALREFID EXTERNALREFID Length 10 10 10 50 10 50 50 50 50 50

Run CONFIGDB.BAT whenever you change Maximo field lengths. For instructions on running CONFIGDB.BAT, refer to Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center.

Configuring the Maximo Enterprise Adapter for SAP Applications

87

Configuring Maximo Asset Management

Synchronizing units of measure

Use the same units of measure in both Maximo Asset Management and SAP. For example, CAS is a unit of measure recognized by SAP, so define it in Maximo Asset Management also. The Add/Modify Units of Measure dialog box is a Select Action item available from more than one Maximo Asset Management application, like Purchase Requisitions. Use this dialog box to add new units of measure. Any units of measure that you add become available in Maximo Asset Management for use when ordering or issuing items. Use the following procedure to configure units of measure in Maximo Asset Management.

1 Open the Purchase Requisitions application in the Purchasing module. 2 From the Select Action drop down, select Add/Modify Units of Measure. 3 Add any units needed by SAP.

PR line units of measure conversion factor

If you interface an item from SAP to Maximo Asset Management (Item/Inventory replicated from SAP), then the SAP Units of Measure (UOM) and the Conversion Factor for that item must also be maintained in Maximo Asset Management. Add or update UOM and Conversion Factor values for SAP-owned items in SAP, as this data comes to Maximo Asset Management during the Item integration. If you create a PR in Maximo Asset Management for an SAP-owned item, and you enter a different Order UOM than the Issue UOM and there is no defined Conversion Factor relationship, then Maximo Asset Management sets the Conversion Factor to 1 by default. For example, assume you create a PR for an SAP stock item with an Issue UOM of EA and a quantity of 1. If you then change the Order UOM for the PR line to PAL and enter a Conversion Factor of 10, save and approve the PR in Maximo Asset Management, when you open the PR line in SAP, it has a value of 1 EA and not 10 EA. This behavior occurs because the integration, in this instance, uses the Maximo default UOM conversion factor of 1.

Outbound Maximo PO/PR number prefixes

Use the Autonumber Setup action in the Maximo Organizations application to add the following prefixes to the Maximo PONUM/PRNUM at the site level:
T T

SAP PR Document Number prefix SAP PO Document Number prefix T Maximo SITEID prefix The PONUM/PRNUM length must be ten characters to match the SAP PO/PR number length. The PONUM is equal to the SAP PO Document Number prefix plus the Maximo Site ID prefix. The PRNUM is equal to the SAP PR Document Number prefix plus the Maximo Site ID prefix. The standard Maximo Enterprise Adapter for SAP applications supports only one SAP PO/PR document type per integration. Create a Maximo PO and PR
88
System Administrator Guide

Configuring Maximo Asset Management

Document type in your SAP system and define the number ranges for these document types. Then store these values in the Maximo SAPPOTYPE and SAPPRTYPE value controls.

Outbound Maximo WO number prefixes

Add the following two prefixes to the outbound Maximo WONUM:

1 Use the Autonumber Setup action in the Maximo Organizations application to

add the Maximo SITEID prefix to the outbound Maximo WONUM at the site level:

2 Use the SAPIOTYPEPREF cross-reference control to add the appropriate SAP

Internal Order (IO) Document number prefix. The standard Maximo Enterprise Adapter for SAP applications supports two internal SAP document types: Maintenance and Investment. The Maximo Enterprise Adapter for SAP applications uses the SAPIOTYPEPREF cross reference control to add the SAP Internal Order (IO) Document Number to the Maximo work order number. The WONUM length must be ten characters to match the SAP WO number length. Make sure the added prefixes do not cause the total length of the WONUM to exceed ten characters.

Outbound Maximo WO task ID prefixes

If you use Task IDs in Maximo work orders, you need to add the Maximo Site ID prefix to the Task ID.

Synchronizing currency codes

The same currency code must be used in both systems. For example, USD (U.S. Dollar) is a currency recognized by both SAP and Maximo Asset Management. If USD is not your base currency and you want to define it as a second currency in Maximo Asset Management, use the following procedure:

1 Open the Currency Code application in the Financial module. 2 Add any currency codes needed by SAP that do not exist in Maximo Asset
Management.

Synchronizing item categories

You can enter the material types used in SAP and match them to the stock type values in Maximo Asset Management. This section is only applicable if the client supports the items/inventory integration. You can synchronize SAP material types and Maximo stock type values using the SAPMATLTYPE interface control. For more information, refer to the Configuring interface controls, Cross-Reference Controls section of this chapter.

Configuring the Maximo Enterprise Adapter for SAP Applications

89

Configuring Maximo Asset Management

Synchronizing work order status

You can enter the work order status used in SAP and match them to the work order status values in Maximo Asset Management. This section is only applicable if the client supports the work order integration. You can synchronize SAP and Maximo work order status values using the SAPIOSTATUS interface control. For more information, refer to the Configuring Interface Controls, CrossReference Controls section of this chapter.

Enabling publish channel events listeners

Enabling integration event listeners directs Maximo Asset Management to build and process related outbound interfaces when certain Maximo user actions occur. A user action in Maximo Asset Management (for example, the update of an item via the Maximo Item application) triggers the event listener. The event listener, in turn, triggers the processing of one or more related interfaces. By default, integration events are disabled. If you plan to send all outbound data through the data export feature, do not enable outbound event listeners. Integration Event listeners do not apply to inbound transactions. To enable an event listener, complete the following steps:

1 In the publish channels application, select the system that you want to update. 2 Select Enable/Disable Integration Events from the Select Action menu. 3 Click OK.

90

System Administrator Guide

Configuring Maximo Asset Management

Configuring interface controls

Configure SAP-specific integration controls to specify how your Maximo and SAP systems exchange data. Use the external systems application in the Integration module to configure interface controls. For more information on setting up integration controls or changing their default values, see Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center. To set up your Maximo Enterprise Adapter for SAP applications integration, configure the SAP controls listed in the following tables. Value controls Interface control SAPCALSTART SAPAPTYPE SAPINVOICESITEID SAPINVOICESTATUS SAPPRTYPE SAPPOTYPE SAPFIGLACCT SAPNSTKROOM SAPMAXBSNAME Description SAP Transaction Start Date SAP Invoice Type Centralized Invoicing Site Determines the default status for reversed invoices received from SAP. SAP PR Document Type SAP PO Document Prefix Type SAP GL Account for FI Invoices SAP Non-Stocked Room Maximo Business System Name in SAP PI Additional detail The default is 01-01-1990 The default is MM. The default is null (decentralized invoicing) APPR (default) or PENDREV The default is PR. The default is PO. Use ORG Override. Use Site Override [No default value]

Boolean controls Interface control SAPUNLIMITTOLERANCE SAPWOOUT SAPRSVOUT SAPAPOUT Description Allow Unlimited Receipt Tolerances for PO Line SAP Work Order Out Status SAP Reservation Out Status SAP Invoice Out Status Additional detail TRUE or FALSE TRUE or FALSE TRUE or FALSE TRUE or FALSE

Configuring the Maximo Enterprise Adapter for SAP Applications

91

Configuring Maximo Asset Management

List controls Interface control WOSTART PRSEND POSEND IVSEND GLSOURCE Description SAP Work Order Send Status SAP PR Send Status SAP PO Send Status SAP Invoice Send Status SAP GL Source List Additional detail APPR, WMATL, and WSCH APPR APPR APPR INVOICETRANS INVTRANS LABTRANS MATRECTRANS MATUSETRANS SERVRECTRANS TOOLTRANS

Cross-reference controls Interface control SAPORGID Description Maximo Organization to SAP Company Code Maximo Site to SAP Plant Additional detail For example, EAGLENA may be the Maximo value and 0001 the SAP value For example, BEDFORD may be the Maximo value and 0001 the SAP value For example, CENTRAL may be the Maximo value and 0001 the SAP value Maximo Material category (Stock or Non-Stock) to SAP Material Types (See SAPMATLTYPE table on page 79) See SAPGLCOMP table on page 68 See SAPGLCONCAT table on page 70 For example, ITEMSET1 may be the Maximo value and D47002 the SAP value For example, SERVICE or MATERIAL are Maximo values and DEFAULT and 400000 may be the SAP values See SAPIOTYPEPREF table on page 79 See SAPIOSTATUS table on page 79

SAPSITEID

SAPSTORERM

Maximo Storeroom to SAP Storage Location Maximo Category to SAP Material Type

SAPMATLTYPE

SAPGLCOMP SAPGLCONCAT SAPITEMSETID

SAP GL Component Settings SAP GL Concatenation Settings Maximo Item Set ID to SAP SystemID/Client Maximo LineType to SAP GL Account

SAPLINETYPE

SAPIOTYPEPREF SAPIOSTATUS

SAP Internal Order Type Prefix SAP Internal Order Status Translation

92

System Administrator Guide

Configuring Maximo Asset Management

Interface control SAPPURCHSITEID

Description Maximo Site to SAP Purchasing Organization Maximo hard/soft reservation to SAP reservation Requirement Urgency code SAP Account Assignment Category Settings SAP Contract Type Translation

Additional detail For example, BEDFORD could be a Maximo site value and 0001 an SAP purchasing org value For example, Maximo hard reservation could be the value of 01 for the SAP Reservation Requirement in SAP See SAP AAC table on page 66 For example, BLANKET could be a Maximo contract type value and MK an SAP value Specify the SAP QOS for outbound interfaces. Valid values for QOS can be EO (Exactly Once) for SAP PI continuous queue, or EOIO (Exactly Once in Order) for SAP PI sequential queue. If an interface name does not exist, that means outbound transactions will go to the continuous queue. If an outbound interface name exists (for example, MXPO_TOSAP05), then the external value represents the sequential queue name in SAP PI (for example, PI_PO_SEQ_Q)

SAPRSVPRIORITY

SAPAAC SAPCONTRACTTYPE

SAPQOS

Quality of Service (QOS) in SAP PI

SAPMATLTYPE cross-reference control Maximo value STK (stock) NS (nonstock)

SAP external value DEFAULT, FHMI, FERT, ERSA, HALB, HAWA, HIBE, INTR, LEER, PIPE, PROC, ROH, UNBW, VERPR, VKHM NLAG, CONT, DIEN, IBAU, KMAT, PROD, WETT

SAPIOTYPEPREF cross-reference control Maximo value MAXI MINV

SAP external value M (Prefix for SAP Maintenance Order Type) I (Prefix for SAP investment Order Type)

Configuring the Maximo Enterprise Adapter for SAP Applications

93

Configuring SAP Applications

SAPIOSTATUS cross-reference control Maximo value WAPPR WMATL WSCH APPR INPROG COMP CLOSE CANCEL SAP external value 10 20 20 20 30 40 90 91

Configuring SAP Applications

Complete the following configuration tasks in outbound SAP Applications for the integration between Maximo Asset Management and SAP.
T T

Maintain custom configuration tables Run reports

Maintaining custom configuration tables

This section discusses maintaining the following custom configuration tables:
T T

ZBC_INBPROGRAMS ZBC_FILTERS T ZBC_SAPMXCONFIG T ZBC_RUNTIMES T ZBC_DESTINATION To access and maintain the Maximo Enterprise Adapter for SAP Applications custom tables, use the SAP transaction code SM30. You can create special authorization groups for the Maximo Enterprise Adapter for SAP Applications tables and assign only certain users to these authorization groups. To display or query the Maximo Enterprise Adapter for SAP Applications custom tables, you can use the SAP transaction code SE16. However, to maintain the Maximo Enterprise Adapter for SAP Applications custom tables, you must use the SAP transaction code SM30.

94

System Administrator Guide

Configuring SAP Applications

These instructions are generic. Details specific to the integration custom tables follow this section.

1 Open the Maintain Table Views: Initial Screen for working with tables. You
can use transaction code SM30.

2 Enter the table name, for example, ZBC_FILTERS. Click Enter. The transport
file creates the table using default values. It shows all processes inbound into SAP. The Data Browser screen for that table opens.

3 Click Execute. The Change View screen opens. 4 To edit table fields, select the check box in leftmost column for a row in the
table, then click pencil icon. If you double click an entry row, the display mode opens. To change values, use edit mode.

5 Make changes, then save. The changes you save here will make changes to the
database.

Maintaining ZBC_INBPROGRAMS
This table controls SAP inbound program processing methods and error handling of inbound programs from Maximo Asset Management to SAP. For every process, specify the following modes:
T T

processing mode error handling mode

SAP has two inbound processing modes:

T T

BAPI (process by BAPI) BDC (process by Batch input)

but not all apply to each program. The Maximo Enterprise Adapter for SAP applications has two inbound error handling modes:
T

INT (Internal messaging system) - Integration server is notified that there are no errors, you must handle errors within the SAP system (this mode is the default). With this option you can also specify error notification to up to four SAP users E-mail addresses. To create E-mail or SAP user notification:

select recipient specify reception type: T B= SAP user for that client T U= internet address

To enable error message display on screen, select express.

Configuring the Maximo Enterprise Adapter for SAP Applications

95

Configuring SAP Applications

If you select INT error handling:

In the case of BDC processing, you will get batch input maps to reprocess the error. In the case of BAPI processing, you will need a program, ZBC_BAPIADMIN, provided with the integration, to reprocess errors.

EXT (External messaging system) - We send back a return code to the SAP PI server.

The following table shows the processing modes used by each program in this integration. Program processing modes IDENT MICFI MICMM MISU MPOI MPOU MPRI MRCV MRSVD MRSVI MSRVU MWI MWU MLPYI MICGL DESCRIPTION CREATE FI INVOICE CREATE MM INVOICE CREATE GOODS ISSUE CREATE PURCHASE ORDER UPDATE PURCHASE ORDER CREATE PURCHASE REQUISITION CREATE RECEIPT DELETE RESERVATION CREATE RESERVATION UPDATE RESERVATION CREATE WORKORDER UPATE WORKORDER CREATE LABOR HOURS CREATE GL POSTINGS Processing mode BDC / BAPI BAPI BDC / BAPI BDC / BAPI BDC / BAPI BDC / BAPI BDC / BAPI BDC BDC / BAPI BDC BDC / BAPI BDC BDC / BAPI BDC / BAPI

96

System Administrator Guide

Configuring SAP Applications

Maintaining ZBC_FILTERS
This table controls what data content from an SAP IDoc transaction is sent to Maximo Asset Management. It is where you set the rules for every receiver that defines the data sent to the Maximo ER structure. The filtering rule is an OR relationship, so you can set up operators, field values, and so on. The receiver must have the same name as the definition of the Maximo business system in the SAP PI system landscape directory and ZBC_DESTINATION This SAP IDOC transaction filtering table can be configured for the following possible objects: ZBC_FILTERS ZBC_FILTERS object MATMASTER PURCHORDER INVOICE GOODSMOV CONTRACT CONTRACTAU LABMASTER CREMASTER INFORECORD Description Material Master Purchase Order Invoice Goods Movement contract Contract Authorization Labor Master Vendor Master Data Purchasing information

This SAP IDOC transaction filtering table has the following fields: ZBC_FILTERS fields ZBC_FILTERS field MANDT RECEIVER OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE Value SAP Client value Maximo destination name MATMASTER (Material Master IDOC Object name) Condition sequence number for the IDOC object any field name from the Material Master Message table any SAP Relationship operator value to be checked against the operator

Configuring the Maximo Enterprise Adapter for SAP Applications

97

Configuring SAP Applications

RULENUMBER

The ABAP report handles the rulenumber as follows: If the same OBJECT uses the same RULENUMBER more than once, then ABAP handles them all as "AND" conditions [all are true]. If the same OBJECT has more than one RULENUMBER, then ABAP handles this as OR conditions. Before setting up this table, you should create a document defining all the rules for the data to send. This will make it easier to maintain the table and to ensure the consistency and logic of the definitions. You can add/change/delete entries of this table later on, but youll have to make sure that the sequence of the rules remains consistent. When maintaining this table later on, you can reduce the displayed data of this table by using selection criterias RECEIVER and OBJECT.

Filtering the data

To filter the data content of processes you can use any field of the following structures: Data content filters Purchase order Material Master Labor Master Invoice Goods Movements Contracts ZBC_S2M_PURCHASEORDER ZBC_S2M_MATERIALMASTER ZBC_S2M_LABORMASTER ZBC_S2M_MMINVOICE ZBC_S2M_GOODSMOVEMENT ZBC_S2M_PURCHASEORDER ZBC_S2M_CONTRACTAUTH For mapping information for these structures, see Appendix D, "SAP ABAP structures for IDOC transaction filtering."

The following examples will show you how to maintain the table and help you set up valid configuration possibilities.

98

System Administrator Guide

Configuring SAP Applications

Example 1: Send all purchase orders related to Maximo work orders or Maximo purchase requisitions
This example is based on the following assumptions:
T

Maximo work orders are identified by the number ranges starting with MA and MB. T Maximo purchase requisitions are identified by the number range starting with PR. This example describes how to set up the following syntax in the ZBC_FILTERS table:
Send Purchase Order, if Work order number (field AUFNR) = MA* OR Work order number (field AUFNR) = MB* OR Purchase requisition number (field BANFN) = PR*

Use the following procedures to set up this syntax.

1 In transaction se16 enter the table name ZBC_FILTERS and click the Create
Entries button.

2 Enter the values shown in the following table to set up the IDoc filtering for
work orders relating to Maximo purchase orders in the number range starting with MA. ZBC_FILTERS insert field RECEIVER OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE Value for example 1, rule 1 <your Maximo business system name> PURCHORDER 1 AUFNR = MA*

3 Save your entries. The status message Database record successfully created
appears on the bottom of your SAP Session window. The values you entered remain in the screen.

4 To define the next rule, complete the following steps: a Change the rule number to 2. b Change the field value to MB*. 5 Save your entries. The second rule for the work order prefix was created in the
table.

6 To define the next rule: a Change the rule number to 3.

Configuring the Maximo Enterprise Adapter for SAP Applications

99

Configuring SAP Applications

b Change the field name to BANFN (purchase requisition number). c Change the field value to PR*. 7 Save your entries. All rules to send Purchase Orders to Maximo Asset
Management are now defined. Table ZBC_FILTERS for object PURCHORDER now contains three entries. You should set up the filters for receipts and invoices with the same criteria as you did for purchase orders. This way youll make sure that all follow-on transactions, which are related to the purchase orders youll send, are transferred as well.

Example 2: send all receipts related to purchase orders with Maximo work orders or Maximo purchase requisitions
This example is based on the following assumptions:
T

Maximo Work Orders are identified by the number ranges starting with MA and MB. T Maximo Purchase Requisitions are identified by the number range starting with PR. T Issues and receipts use the structure ZBC_S2M_GOODSMOVEMENT to send data out of SAP. T Receipts are identified by the field IDENT having the value XRCVI (issues will have the value XISU). This example describes how to set up the following syntax in the ZBC_FILTERS table:
Send Receipts, if ( Identifier (field IDENT) = XRCVI AND OR

Work order number (field AUFNR) = MA*)

Identifier (field IDENT) = XRCVI

AND OR

Work order number (field AUFNR) = MB*)

Identifier (field IDENT) = XRCVI

AND

Purchase requisition number (field BANFN) = PR* )

Use the following procedures to set up this syntax.

1 In transaction se16 enter the table name ZBC_FILTERS and click the Create
Entries button. The Table ZBC_FILTERS Insert screen opens.

100

System Administrator Guide

Configuring SAP Applications

2 Enter the values shown in the following table to set up the IDoc filtering for
receipts relating to Maximo purchase orders. ZBC_FILTERS insert field RECEIVER Value for example 2, rule 1 <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 1 IDENT = XRCVI

3 Save your entries. 4 To define the next criteria within the same rule (AND condition). a Change the field name to AUFNR (work order number). b Enter the field value MA*. 5 Save your entries. This creates the first rule. 6 Repeat steps 2 through 5 to define rules 2 and then 3 to send receipts. a Use the following parameters for the first part of Rule 2.
ZBC_FILTERS insert field RECEIVER Value for example 2, rule 2, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 2 IDENT = XRCVI

b Save your entries. c Use the following parameters for the next part of Rule 2.
ZBC_FILTERS insert field RECEIVER Value for example 2, rule 2, second criteria <your Maximo business system name> in this example, MAXIMO_A

Configuring the Maximo Enterprise Adapter for SAP Applications

101

Configuring SAP Applications

ZBC_FILTERS insert field OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE

Value for example 2, rule 2, second criteria GOODSMOV 2 AUFNR = MB*

d Save your entries. This creates Rule 2. e Use the following parameters for the first part of Rule 3.
ZBC_FILTERS insert field RECEIVER Value for example 2, rule 3, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 3 IDENT = XRCVI

Save your entries.

g Use the following parameters for the next part of Rule 3.

ZBC_FILTERS insert field RECEIVER Value for example 2, rule 3, second criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 3 BANFN = PR*

h Save your entries. 7 Table ZBC_FILTERS for object GOODSMOV now contains six entries.

102

System Administrator Guide

Configuring SAP Applications

Example 3: send all issues related to Maximo work orders

This example is based on the following assumptions:
T

Maximo Work Orders are identified by the number ranges starting with MA and MB. T Issues are identified by the field IDENT having value XISU. This example describes how to set up the following syntax in the ZBC_FILTERS table:
Send Issues, if ( Identifier (field IDENT) = XISU AND OR

Work order number (field AUFNR) = MA*)

Identifier (field IDENT) = XISU

AND

Work order number (field AUFNR) = MB*)

Use the following procedures to set up this syntax.

1 In transaction se16 enter the table name ZBC_FILTERS and click the Create
Entries button. The Table ZBC_FILTERS Insert screen appears.

2 Enter the values shown in the following table to set up the IDoc filtering for
issues relating to Maximo work orders. ZBC_FILTERS insert field RECEIVER Value for example 3, rule 4, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 4 (1-3 for GOODSMOV are already used to define the receipt rules) IDENT = XISU

3 Save your entries.

Configuring the Maximo Enterprise Adapter for SAP Applications

103

Configuring SAP Applications

4 Use the following parameters to define the next criteria within the same rule
(AND condition). ZBC_FILTERS insert field RECEIVER Value for example 3, rule 4, second criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 4 AUFNR (work order number) = MA*

5 Save your entries. 6 Repeat these steps to create the next rule for sending issues. Use the following
parameters to create the next rule for sending issues. ZBC_FILTERS insert field RECEIVER Value for example 3, rule 5, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 5 IDENT = XISU

7 Save your entries. 8 Use the following parameters to create the next rule for sending issues.
ZBC_FILTERS insert field RECEIVER Value for example 3, rule 5, second criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE GOODSMOV 5 AUFNR (work order number) = MB*

104

System Administrator Guide

Configuring SAP Applications

9 Save your entries.

Now all rules are defined to send receipts to Maximo. Table ZBC_FILTERS for object GOODSMOV contains now 10 entries. Since the filter on work order numbers is similar for Receipts and Issues, you could simplify the rules of examples 2 and 3 to the following syntax:
Send Goods Movements (Issues and Receipts, if Work order number (field AUFNR) = MA*) OR

Work order number (field AUFNR) = MB*)

OR

Identifier (field IDENT) = XRCVI

AND

Purchase requisition number (field BANFN) = PR*)

This would reduce the count of rules from five to three and the count of rows for these filters from ten to four, without changing the declaration for the data to send.

Example 4: send material master data of material type spare part, if the data was created/changed on the client level or in plant 0001
This example is based on the following assumptions:
T T T

The material type is identified by the field MTART having the value ERSA. The plant is identified by the field WERKS having the value 0001. To send data that was changed on the client level, youll have to check for an initial WERKS.

This example describes how to set up the following syntax in the ZBC_FILTERS table:
Send Material Master, if ( Material Type (field MTART) = ERSA AND OR

Plant (field WERKS) is initial)

Material Type

(field MTART) = ERSA

AND OR

Plant (field WERKS) = 0001)

Use the following procedures to set up this syntax.

1 In transaction se16 enter the table name ZBC_FILTERS and click the Create
Entries button. The Table ZBC_FILTERS Insert screen appears.

Configuring the Maximo Enterprise Adapter for SAP Applications

105

Configuring SAP Applications

2 Enter the values shown in the following table to set up the IDoc filtering for
sending specific material master data to Maximo. ZBC_FILTERS insert field RECEIVER Value for example 4, rule 1, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE MATMASTER 1 MTART (Material Type) = ERSA

3 Save your entries. This creates the first rule. 4 To define the next criteria within the same rule (AND condition) use the
following parameters. ZBC_FILTERS insert field RECEIVER Value for example 4, rule 1, second criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE (leave this field blank) MATMASTER 1 WERKS (work order number) =

5 Save your entries. This completes the first rule. 6 Repeat steps 2 through 5 to create the 2nd rule for sending material master
data. Use the following parameters for the first part of Rule 2. ZBC_FILTERS insert field RECEIVER Value for example 4, rule 2, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR MATMASTER 2 MTART =

106

System Administrator Guide

Configuring SAP Applications

ZBC_FILTERS insert field FIELDVALUE

Value for example 4, rule 2, first criteria ERSA

7 Save your entries. 8 Use the following parameters for the second part of Rule 2.
ZBC_FILTERS insert field RECEIVER Value for example 4, rule 2, second criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE MATMASTER 2 WERKS = 0001

9 Save your entries.

Now all rules are defined to send material data to Maximo. Table ZBC_FILTERS for object MATMASTER now contains 4.

Example 5: send material master data of material type spare part, if the data was created or changed on the client level or in plant 0001 or in plant 0002. Send the changes of the client level on material only, if the material exists in plant 0001 or 0002
This rule covers the following business case: You do not want to send material information to Maximo if only the base view was created. Changes on the material base view should be sent only if the material was created within one of the plants you have integrated with Maximo. This example is based on the following assumptions:
T T

The material type is identified by the field MTART having the value ERSA. If the material is maintained in plant 0001 or 0002, the information is identified by the field MXPLNT having the value X.

The ABAP code is looking into table ZBC_SAPMXCONFIG for the variable MXPLANT. If the material was maintained in any of the plants found there, the field MXPLNT will get flagged with the value X. If you use this functionality, the table ZBC_SAPMXCONFIG must contain the plants you have integrated with Maximo.

Configuring the Maximo Enterprise Adapter for SAP Applications

107

Configuring SAP Applications

This example describes how to set up the following syntax in the ZBC_FILTERS table:
Send Material Master, if Material Type (field MTART) = ERSA MXPLANT) = X AND

Indicator (field

Use the following procedures to set up this syntax.

1 In transaction se16 enter the table name ZBC_FILTERS and click the Create
Entries button. The Table ZBC_FILTERS Insert screen appears.

2 Enter the values shown in the following table to set up the IDoc filtering as
described in the example 5 title. ZBC_FILTERS insert field RECEIVER Value for example 5, rule 1, first criteria <your Maximo business system name> in this example, MAXIMO_A OBJECT RULENUMBER FIELDNAME OPERATOR FIELDVALUE MATMASTER 1 MTART = ERSA

3 Save your entries. 4 Use the following parameters to define the next criteria within the same rule
(AND condition).

a Change the fieldname to MXPLANT (indicator if material exists in at least

one of the plants defined in ZBC_MXCONFIG).

b Change the field value to X. 5 Save your entries.

Now you have defined all the rules to send material data to Maximo. Table ZBC_FILTERS for object MATMASTER now contains two entries.

Maintaining ZBC_SAPMXCONFIG
This table stores the variables and values of Maximo data that the Maximo enterprise adapter for SAP needs during transactions inbound from SAP to Maximo. This table filters for Maximo PR numbers, so that only PR numbers recognized by Maximo Asset Management will go out from SAP to Maximo Asset Management.

108

System Administrator Guide

Configuring SAP Applications

System name must match the name of the receiver system in the XI SLD and ZBC_DESTINATION. You must set up this table manually. ZBC_SAPMXCONFIG table Varname APINVUPD BAPIME51N Description Send Inventory (price) update after Invoice Enter a value of X if you want to use the new SAP PR BAPI (BAPI_PR_CREATE) that supports additional data for the SAP Enjoy Purchase Requisition feature. Leave this field blank if you want to use the standard PR BAPI (BAPI_REQUISITION_CREATE). Required No No Dependencies None If you want to use the new SAP PR BAPI, you must apply the SAP Hotpackage SAPKH6005 in your SAP Applications system. None None Receiving systemdependant Per receiver Receiving systemdependant

GR_POLINE GR_SETCOST MXBASELANG MXLANGUAGE MXPLANT

MAXIMO to SAP Remove POLine distribution suffix MAXIMO to accept GR costs from SAP Maximo base language Additional base languages per receiver SAP plant codes for each plant integrated with Maximo. If an item is used in Maximo, the ZBC_FILTERS table looks at this field to see if the plant is one that is used in Maximo. Prefix that uniquely identifies an outbound PO as a Maximo PO number Prefix that uniquely identifies an outbound PR as a Maximo PR number Customers who upgraded from Release 5.x Maximo Enterprise Adapter for SAP R/3 4.7 must manually configure this column to store date of upgrade. Specify one queue name per receiver. If a queue name is specified here, all records for the receiving system are written into the specified queue. If no queue name is specified, PI uses multiple random queues. When messages are split, PI writes the resulting records to the same queue.

No No Yes No No

POPREFIX PRPREFIX MX5UPGDATE

No No No

None None None

SEQ_QUEUE

No

Receiving systemdependant

WOPARSETTL

Used for Work Order settling rules

No

Receiving systemdependant

Specify the base language of Maximo Asset Management. If you are using more than one Maximo instance, all instances of Maximo Asset Management must share the same base language.

Configuring the Maximo Enterprise Adapter for SAP Applications

109

Configuring SAP Applications

Then, other languages supported can be added later. Languages are per receiver system. All fields of this table are key fields. You cannot change any values after definition. To correct a definition, you will have to delete the corresponding row and to recreate it.

Maintaining ZBC_RUNTIMES
This table stores the last execution dates of the reports for SAP to Maximo Asset Management. The Maximo Enterprise Adapter for SAP Applications delivers this table with default values. Configure it to meet the requirements of your integration. Change only the CPUDT and PARAM columns: Change CPUDT, the last run date, to the actual date during installation or after transporting the table to a new environment. For example, after transporting it to a test system or production system. The PARAM column is customer-specific.
T

For report ZBCXIREPR007 (vendor download) the parameter column contains the value of the company code for which the report was executed. For report ZBCXIREPR013 (info record download) the parameter specifies the purchase organization for which the report was executed.

The DESTINATION column must be the SAP PI Business System name (also defined in ZBC_DESTINATION) for all rows. The destination is a logical name, not a physical location, and is used to differentiate the integration rows in this table from all other entries. If no table entry exists during the first execution of the report, the programs will create the entries in this table by themselves, if the checkbox Update table ZBC_RUNTIMES was marked. Nevertheless, the date of the program INVOICE needs to be set manually in each system youll install the link. If this parameter wasnt set to the actual date when implementing the interface, the functionality to send MM Invoices from SAP to Maximo Asset Management wont work properly.

Maintaining ZBC_DESTINATION
This table controls where SAP data is sent to Maximo Asset Management. To maintain this table, complete the following steps:

1 In the initial screen for this table, click the Create Entries button. The Insert
screen opens.

110

System Administrator Guide

Configuring SAP Applications

2 Enter the following parameters:

ZBC_DESTINATION parameters ZBC_DESTINATION Field RFCDEST DESCRIPTION Value <your Maximo business system name in XI> Description of your Maximo business system

3 Save your entries. 4 Repeat these steps if you use multiple Maximo systems.

Running reports
This section describes the reports you run for the integration between Maximo Asset Management and SAP. Some are required and some are optional.

Required reports
Scheduling the following reports as jobs is necessary to ensure the integration from SAP to Maximo Asset Management. Report RBDMIDOC Creating IDocs from change pointers When sending material or labor master data from SAP to Maximo Asset Management, every change creates a change pointer on the database. To create an IDoc, this report needs to get scheduled periodically. For more information please refer to Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center. Report RSARFCEX Execute RFC calls not yet executed IDocs get sent by RFC to the SAP PI system. If the SAP PI system is not able to receive the IDoc (for example, due connection errors), the IDocs will remain on the SAP Application Server. Depending on the settings within the RFCDestination, the Application Server will retry to send out the IDoc. Once the retry interval is over and the connection errors still remain, the IDoc will remain in the outbound queue without further actions. The report RSARFCEX will execute these outstanding IDocs and try to send them out. To ensure that all IDocs are sent, this report should get scheduled at least on a daily interval (if not done already for other IDoc-Integrations).

Optional reports
Scheduling the following reports as jobs ensures the proper integration from SAP to Maximo Asset Management.

Configuring the Maximo Enterprise Adapter for SAP Applications

111

Configuring SAP PI

Report RBDMOIND

Status conversion with Successful RFC execution IDocs getting sent to the RFC-Destination will have the status 03. This report verifies the successful sending of the IDocs (confirms the delivery to SAP PI) and changes the IDoc status to 12. This makes it easier to identify any connection errors and IDocs that remained in the system. Also, only IDocs of status 12 can get archived in SAP, so the conversion is necessary before doing archiving. Optimal frequency: daily.

Report ZBC_INVSENT_REORG

Reorganize table ZINVSENT To prevent the Sending of duplicates, the document numbers of invoices processed are stored in table ZINVSENT. This table should get reorganized from time to time to reduce the count of entries there. The report ZBC_INVSENT_REORG updates the rundate in table ZBC_RUNTIMES for module INVOICE and deletes obsolete entries from table ZINVSENT. Optimal frequency: weekly.

Configuring SAP PI
If you are integrating one SAP system with more than one instance of Maximo Asset Management, configure each instance of Maximo separately in PI. See Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center. Perform all the procedures in the chapter for each instance of Maximo Asset Management. After completing the configuration procedures, modify the receiver determination for Interfaces out of the SAP Application Server. The receiver for the message already gets provided out of the Application Server in the field SYSTEM. You can use this field to determine the business system that you want to receive the data.

112

System Administrator Guide

Financial integration

10

Maximo Asset Management and SAP can exchange the following types of financial data:
T

Enterprise services General ledger components / cost objects Charts of accounts T Publish channels General ledger journals This chapter is directed to system administrators, implementation team members, and SAP and Maximo consultants. It discusses factors that you need to be aware of when integrating Maximo Asset Management and SAP financial activity. It assumes that you are familiar with standard general ledger processing in Maximo Asset Management and SAP. This chapter contains the following sections:
T T

General ledger components and chart of account integration General ledger journal integration

Copyright IBM Corp. 2007, 2011

113

General ledger components and chart of account integration

General ledger components and chart of account integration

The general ledger interface transfers new and updated cost objects from SAP to Maximo Asset Management, and optionally transfers account combinations from SAP to Maximo Asset Management. You initiate these actions through various ABAP programs.

Structure of SAP and Maximo financial data

The SAP chart of accounts is defined at the client level and is assigned to one or more company codes. The Maximo chart of accounts is maintained at the Maximo organization level, which is equivalent to the SAP company code level. SAP cost objects correspond to Maximo general ledger components. Maximo Asset Management defines general ledger components system level and all organizations within the Maximo database share them.

SAP cost objects

SAP cost accounting summarizes and posts cost objects by account assignment category (AAC). The integration processes the following SAP account assignment categories: SAP account assignment categories processed by the integration AACFLAG K F P A Z L U R Description Cost center Internal order WBS element Asset GL account Labor activity type Business area Profit center SAP adapter field COSTCENTER IORDER WBSELEMENT ASSET GLACCOUNT ACTTYPE BUSAREA PROFITCENTER

114

System Administrator Guide

General ledger components and chart of account integration

Transfer of cost objects from SAP to Maximo Asset Management

SAP cost objects are sent to the Maximo GLCOMPONENTS (GLCOMP) and CHARTOFACCOUNTS (COA) tables by various ABAP reports. Each report generates general ledger components and, optionally, builds a chart of account in Maximo Asset Management. Whether you choose to build accounts determines which of two general ledger integration points the integration uses. General ledger ABAP reports ABAP program ZBCXIREPR001 ZBCXIREPR002 ZBCXIREPR003 ZBCXIREPR006 ZBCXIREPR012 Description Download Cost Centers Download Assets Download WBS Elements Download SAP Financial GL/Accounts Download Internal Orders

Batch report selection criteria

The SAP cost object batch reports have the following selection criteria. Numbers in the Reports column represent the last three characters of the ABAP program name (for example, 001 refers to ZBCXIREPR001). Cost object batch report selection criteria ABAP selection criteria Workorder Type Cost Object Type Company Code Build COA Combinations Reports All All All All Description Choose one work order type per each run of the batch report. Choose one cost object type per each run of the batch report. Choose one company code per each run of the batch report. To direct the integration to build accounts from the downloaded cost elements, select the Build COA combinations check box. To download cost elements without building accounts, clear the check box. Choose one language code per each run of the batch report. You can select zero, one, or a range of cost centers. If you select no cost centers, the report runs for all cost centers within the company.

Language Cost Center

001, 006 001

Financial integration

115

General ledger components and chart of account integration

ABAP selection criteria Asset

Reports 002

Description You can select zero, one, or a range of assets. If you select no assets, the report runs for all assets within the company. You can select zero, one, or a range of WBS elements. If you select no WBS elements, the report runs for all WBS elements within the company. You can select zero, one, or a range of GL accounts. If you select no GL accounts, the report runs for all GL accounts within the company. You can select zero, one, or a range of order types. If you select no order types, the report runs for all order types within the company. You can select zero, one, or a range of internal orders. If you select no orders, the report runs for all orders within the specified order types.

WBS Element

003

GL Account

006

Order Type

012

Order

012

Batch report processing options

The cost object batch reports have the following processing options: Batch report processing options ABAP process mode Bulk Load Applies to report ZBCXIREPR006 Send all <cost element> Applies to all GL reports other than ZBCXIREPR006 Send new <cost element> Applies to all GL reports other than ZBCXIREPTR006 Description Sends all active and inactive cost elements that meet the selection criteria. Sends all active and inactive cost elements that meet the selection criteria. Sends all active and inactive cost elements that meet the selection criteria, that have been created or updated since the report last ran. That date is recorded in the ZBC_RUNTIMES table.

116

System Administrator Guide

General ledger components and chart of account integration

Configuration of Maximo accounts

You specify the format of Maximo GL component order numbers through the values in the SAPGLCOMP and SAPCLCONCAT interface controls. Each external system uses one SAPGLCOMP control and one SAPGLCONCAT control. When formatting the controls, keep in mind the following points:
T T

A Maximo account number can have any number of segments. Maximo Asset Management specifies a maximum length, rather than a fixed length, for general ledger components, and does not required any filler characters if a component is smaller than the maximum length.

The SAPGLCOMP control

The SAPGLCOMP interface control specifies the elements that make up the account number, and the sequence in which those elements appear within the number. You build the Maximo account number from the following elements:
T T

SAP company code SAP controlling area T SAP internal order type T SAP account assignment category (AACFLAG) Cost center Internal order WBS element Asset GL account Labor activity type Business area Profit center If you interface Maximo work orders with SAP internal orders, you might need to include the Maximo work type (SAP IO document type) as part of the Maximo GL account. For more information, see Work order interfaces on page 108. Concatenating cost elements Any component can optionally be a concatenation of two values, typically a cost type and the corresponding cost object. Concatenation allows for sorting and differentiating between multiple types of cost objects with the same value. To concatenate two values within a component of the Maximo account number, enter 1 (true) in the SAPGLCONCAT parameter; otherwise, enter 0 (false). If you enter 1, you must then enter a special character, which will be used to separate the concatenated values, in the CONCATCHAR parameter of the SAPGLCONCAT interface control. Otherwise, set the value of the CONCATCHAR parameter to null.

Configuring the SAPGLCONCAT parameter

Financial integration

117

General ledger components and chart of account integration

Configuring the remaining parameters

For each remaining parameter in the SAPGLCOMP control, enter a sequence number (integer) that indicates the position of the corresponding element within the account number, or a null value, as follows: SAPGLCOMP account number sequence Sequence within account number* First component Second component Third component Not included Parameter value 0 1 2 NULL

* The account number can contain any number of components. The sequence number for a fourth component would be 3; the sequence number for a fifth component would be 4, and so on. If multiple cost objects can appear in the same component within an account number, assign the same integer to each of those cost objects. For example, if the cost object appears as the third component in some accounts and the asset appears in the third component in some accounts, enter 2 as the value for both COSTCENTER and ASSET. If you wish to concatenate two elements, enter a sequence number only for the element that you want to appear second within the concatenation. Specify the first element within the concatenation when you configure the SAPGLCONCAT control. Example To concatenate cost type (AACFLAG) and cost center (COSTCENTER), enter a sequence number for the COSTCENTER parameter only. In the preceding example, enter a sequence number for AACFLAG if AACFLAG also appears in another component within the account number, in addition to being concatenated with COSTCENTER. The following example of a SAPGLCOMP control shows the configuration for an account number with three components and no concatenation. The first component contains the Maximo internal order (work order) type and the second contains the SAP cost type. The third component contains the SAP cost center object, asset object, or project object, depending upon the type of account. The ABAP programs populate the third component with the appropriate cost object. External value parameter CONCATGL

Description Boolean value that indicates whether to concatenate two cost elements 0 = No 1 = Yes

Maximo Value 0

KOKRS

SAP controlling area

NULL

118

System Administrator Guide

General ledger components and chart of account integration

WORKTYPE AACFLAG COSTCENTER ASSET WBSELEMENT IORDER GLACCOUNT ACTTYPE BUSAREA PROFITCENTER

Maximo internal order type SAP cost type SAP cost center object SAP asset object SAP project object SAP internal order object SAP GL account SAP labor activity type SAP business area SAP profit center

0 1 2 2 2 NULL NULL NULL NULL NULL

The resulting account numbers have one of the following formats:

T T T

WORKTYPE value~AACFLAG value~COSTCENTER value WORKTYPE value~AACFLAG value~ASSET value WORKTYPE value~AACFLAG value~WBSELEMENT value

The SAPGLCONCAT interface control

In the preceding example, no concatenation takes place, because the value of the SAPCONCAT parameter is 0. This section explains how to configure the SAPGLCONCAT interface control to concatenate two cost objects in a single component within the Maximo account number. Configuring the CONCATCHAR parameter To concatenate two values within a component of the Maximo account number, enter a value of 1 (true) in the SAPGLCONCAT parameter; otherwise, enter 0. If you enter 1, you must enter a special character, which will be used to delimit the concatenated values, in the CONCATCHAR parameters of the SAPGLCONCAT interface control. Otherwise, set the set the value of the CONCATCHAR parameter to null. The remaining parameters in the SAPGLCONCAT control are the same as the corresponding parameters in the SAPGLCOMP control. Enter the name of the element that will appear first in the concatenated value in the Maximo value column of the element that will appear second. For example, to concatenate cost type (AACFLAG) and cost center (COSTCENTER), enter the literal AACFLAG in the Maximo value column of the COSTCENTER parameter. The following example shows how to configure the SAPGLCONCAT control to concatenate cost type with each cost object specified in the earlier example (COSTCENTER, ASSET, and WBSELEMENT), using the pipe character (|) as the separator. The third component will contain one of the following values
T T T

Configuring the remaining parameters

AACFLAG value |COSTCENTER value AACFLAG value | ASSET value AACFLAG value | WBSELEMENT value

Financial integration

119

General ledger components and chart of account integration

SAPGLCONCAT parameters External value parameter CONCATCHAR

Description Concatenation Separator Character Default =| [Pipe]

Maximo Value | [pipe]

KOKRS WORKTYPE AACFLAG COSTCENTER ASSET WBSELEMENT IORDER GLACCOUNT ACTTYPE BUSAREA PROFITCENTER

SAP controlling area Maximo internal order type SAP cost type SAP cost center object SAP asset object SAP WBS element object SAP internal order object SAP GL account SAP labor activity type SAP business area SAP profit center

NULL NULL NULL AACFLAG AACFLAG AACFLAG NULL NULL NULL NULL NULL

The resulting account numbers will have one of the following formats:
T

WORKTYPE value~AACFLAG value~ AACFLAG value | COSTCENTER value WORKTYPE value~AACFLAG value~ AACFLAG value |ASSET value WORKTYPE value~AACFLAG value~ AACFLAG value | WBSELEMENT value

120

System Administrator Guide

General ledger components and chart of account integration

Default account configuration

The default values in the SAPGLCOMP and SAPGLCONCAT controls will generate Maximo account numbers with the following format: Default account number format Position of component within account number 1 2 3 Component value WORKTYPE value AACFLAG value AACFLAG value | COSTCENTER value or AACFLAG value | ASSET value or AACFLAG value | WBSELEMENT value The SAPGLCOMP control contains the following default values: * Default SAPGLCOMP values Parameter (external value) CONCATGL Maximo value 1 Note: This number represents a Boolean value, not a position within the account number. WORKTYPE AACFLAG COSTCENTER ASSET 0 1 2 2

* The value of the remaining parameters in the control is Null.

Financial integration

121

General ledger components and chart of account integration

The SAPGLCONCAT control contains the following default values: * Default SAPGLCONCAT values Parameter (external value) CONCATCHAR COSTCENTER ASSET WBSELEMENT Maximo value | (pipe) AACFLAG AACFLAG AACFLAG

* The value of the remaining parameters in the control is Null. Maximo Asset Management always writes a delimiter to the database.

Maximo general ledger configuration requirements

This section addresses configuration requirements for accounts related to work orders and general ledger journals.

Work order interfaces

If you send Maximo work orders to SAP, include the SAP internal order (IO) type within the Maximo GL account. The following table describes how to do this, depending on whether Maximo Asset Management uses one or more SAP internal order document types. Interface control configuration for SAP IO types Number of SAP IO document types One

Interface control configuration Include the WORKTYPE parameter as part of the account number (that is, assign a sequence number/ integer to WORKTYPE in the SAPGLCOMP interface control). OR Assign a null value to the WORKTYPE parameter in the SAPGLCOMP interface control, and let the integration use the default internal order type in the SAPIOTYPEPREF interface control.

Multiple

Include the WORKTYPE parameter as part of the account number (that is, assign a sequence number/ integer to WORKTYPE in the SAPGLCOMP interface control).

Journal interfaces
If you send general ledger journals from Maximo Asset Management to SAP, configure the SAPGLCOMP interface control to provide SAP FI account, cost type, and cost object in each transaction.
122
System Administrator Guide

General ledger components and chart of account integration

If you send both Maximo work order interfaces and related journals to SAP, configure SAPGLCOMP to include the following cost elements in the account number:
T T

WORKTYPE GLACCOUNT T AACFLAG T Any of the following cost elements that are applicable: ASSET COSTCENTER IORDER WBSELEMENT
T

If you send work order-related journals to SAP but you do not send work order interfaces, configure SAPGLCOMP to include the following cost elements in the account number: T GLACCOUNT T AACFLAG T Any of the following cost elements that are applicable: ASSET COSTCENTER IORDER WBSELEMENT
T

Set WORKTYPE to null

In both cases, configure the SAPGLCONCAT to concatenate values in the GL account, if applicable.

Effectivity of GL components
Maximo Asset Management uses the mxe.int.updatecoafromglcomp system property to set the Maximo Chart of Accounts (COA) ACTIVEDATE and EXPIREDATE based on the Maximo GL Components Active flag. When SAP Cost Objects are synchronized to Maximo GL Components, the Maximo COA effective dates will be updated according to the mxe.int.updatecoafromglcomp property.

SAP adapter bulk load action

When you select the bulk load option, Bulk Load, of the ABAP programs ZBCXIREPR001, ZBCXIREPR002, ZBCXIREPR003, ZBCXIREPR006, or ZBCXIREPR012, the SAP adapter performs the following actions during the handling of the bulk load of chart of accounts or general ledger component data received from SAP:
T

Sets the value of the COA.SAP_UPDATE or GLCOMPONENT.SAP_UPDATE field to 1 (Active) for each SAP record included in the bulk load. Inserts the values for all Maximo Organizations associated with the incoming data into the Organization parameter of the Maximo cron task SAPMASTERDATAUPDATE. Sets the value of the Enabled parameter of the Maximo cron task SAPMASTERDATAUPDATE to 1.

Financial integration

123

General ledger components and chart of account integration

Cron task SAPMASTERDATAUPDATE action

The Maximo cron task SAPMASTERDATAUPDATE updates chart of accounts and GL component records in Maximo Asset Management to mark the SAP cost elements and GL components in the Maximo database that have been deleted and archived in SAP. When the cron task runs, it performs the following actions:
T

Resets the ACTIVE field to 0 for each record where the SAP_UPDATE field = 0 and the ACTIVE field = 1.

Whenever you run an SAP bulk load for one of the following:
T T

Chart of Accounts GL Components

You should next immediately run the SAPMASTERDATAUPDATE cron task. This process sets to inactive any Maximo records that correspond to bulkloaded SAP records that have been archived or deleted in SAP. See the previous section, SAP adapter bulk load action, for bulk load report names. If you are running more than one of these bulk loads, run the cron task after the last bulk load report is run. Do not run any change or update reports while the SAPMASTERDATAUPDATE cron task is running, or errors can occur. For more information about this Cron Task, see Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center.

Field added to COA and GLCOMP tables

When the SAP adapter is installed, it adds the following field to the Maximo COA and GLCOMP tables. New field in COA and GLCOMP tables New field in COA and GLCOMP SAP_UPDATE

Description Indicates whether the COA or GLCOMP record has been removed from the SAP system. 0 = COA or GLCOMPONENT record has been removed from SAP 1 = COA or GLCOMPONENT record is active in the SAP system

Type YORN

Len 1

Usage This field is updated during a run of the ABAP Batch Reports ZBCXIREPR001* ZBCXIREPR002* ZBCXIREPR003* ZBCXIREPR006* ZBCXIREPR012* * for the bulk load option only The SAP_UPDATE column in the Maximo COA and GLCOMP tables is for internal use.

124

System Administrator Guide

General ledger journal integration

Related interface controls

The general ledger integration uses the following enterprise service interface controls. General ledger-related interface controls Control SAPGLCOMP SAPGLCONCAT SAPORGID Description SAP GL component settings SAP GL concatenation settings Cross-references the Maximo organization ID and SAP company code ID

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Related Maximo enterprise service

The SAP adapter uses the following enterprise service for the GLCOMP and COA integration:
TMXGLACCT_FRSAP05

Related Maximo object structures

The SAP adapter uses the following object structures for the GLCOMP and COA integration:
T T

MXCOA MXGLCOMP

General ledger journal integration

The general ledger journal interface can transfer the following types of general ledger journal transactions from Maximo Asset Management to the SAP FI module:

Financial integration

125

General ledger journal integration

General ledger journal transaction types Transaction Inventory and inventory cost adjustment Invoices matched and approved in Maximo Asset Management Actual cost of labor usage on a work order Issue and transfer of material (including receipts of rotating items and transfers of purchase order line items that require inspection) Direct issue material receipts Service receipt Actual cost of tool usage on a work order Transaction type INVTRANS INVOICETRANS LABTRANS MATUSETRANS

MATRECTRANS SERVRECTRANS TOOLTRANS

Configuration of journals
For information about configuring account numbers in journal transactions, see Journal interfaces on page 108. In most cases, you configure the integration so that Maximo Asset Management sends to SAP either an actual transaction or the corresponding journal entry, but not both. For example, you configure the integration to send an inventory adjustment or a service receipt, but not both. To skip the generation of a journal transaction, you enter the transaction type in the GLSOURCE interface control. However, the standard invoice interface does not send tax information. Therefore, under certain conditions, the integration sends both the invoice interface and a TAX1 type invoice journal. The following factors determine whether the integration sends a TOTAL type invoice journal or a TAX1 type invoice journal:
T

The value of Pay Tax to Vendor? (on the Company tab in the Companies application) The value of Add Tax 1 Amount to Vendor Price (in the Tax Options dialog box in the Organizations application) The value of the SAPAPOUT interface control

The following tables show the type of invoice journal, if any, that the integration sends to SAP. Skipped means that the journal was generated but stopped; No transaction means that the integration processing does not generate an invoice journal. If this situation applies to your invoices, ensure that the GLSOURCE interface control does not include transaction type INVOICETRANS.

126

System Administrator Guide

General ledger journal integration

Invoice journal generated when SAPAPOUT value = Y Tax option Add tax 1 amount to vendor price For No items PO option Pay tax to vendor? value 0 1 For Issue on Receipt Items Only 0 1 For All items 0 1 TOTAL type invoice journal Skipped Skipped Skipped Skipped Skipped Skipped TAX1 type invoice journal (material) Sent to SAP Skipped Sent to SAP Skipped Sent to SAP No transaction TAX1 type invoice journal (service) Sent to SAP Skipped Skipped No transaction Sent to SAP No transaction

Invoice journal generated when SAPAPOUT value = N Tax Option Add tax 1 amount to vendor price For No items PO Option Pay tax to vendor? value 0 1 For Issue on Receipt Items Only 0 1 For All Items 0 1 TOTAL type invoice journal Skipped Skipped Skipped Skipped Skipped Skipped TAX1 type invoice journal (material) Sent to SAP Skipped Sent to SAP Skipped Sent to SAP No transaction TAX1 type invoice journal (service) Sent to SAP Skipped Skipped No transaction Sent to SAP No transaction

Filters
If the following conditions are met, the integration transfers journals from Maximo Asset Management to SAP:
T T

The transaction type is not included in the GLSOURCE interface control. The transaction date is greater than the value in the SAPCALSTART interface control. The GL debit and credit accounts are not null. The GL debit and credit accounts are fully specified. The GL debit and credit accounts are different. The transaction cost is not zero.
127

T T T T Financial integration

General ledger journal integration

T T

(Invoice journals) The vendor is not disabled. (Service receipt journals) the transaction status is COMP (complete).

Related interface controls

The general ledger journal integration uses the following publish channel interface controls. General ledger journal-related interface controls Control SAPAAC GLSOURCE SAPAPOUT SAPGLCOMP SAPCALSTART SAPGLCONCAT SAPMX5SITEPREFIX SAPORGID SAPSITEID SAPSTORERM SAPMAXBSNAME SAPQOS Description SAP Account Assignment Category Transaction type of Maximo journals that Maximo Asset Management does not send to SAP. Indicates if Maximo Asset Management sends FI or MM invoices to SAP. SAP GL component settings SAP calendar start date SAP GL concatenation settings Value control to hold the Maximo Site ID prefix. Cross-references the Maximo organization ID and SAP company code ID Cross-reference Maximo ID and SAP plant Cross-reference Maximo storeroom to SAP Maximo business system name in SAP NetWeaver Process Integration SAP quality of service

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Related Maximo publish channel

The SAP adapter user the following publish channel for the general ledger journal integration:
T

MXGLTXN_TOSAP05

Related Maximo object structure

The SAP adapter user the following object structure for the General Ledger Journal integration:
T

MXGLTXN
System Administrator Guide

128

General ledger journal integration

Related SAP tables

The Maximo Enterprise Adapter for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo to SAP. SAP tables related to general ledger journals Table ZBC_INBPROGRAMS Processing mode BDC BAPI Description Uses Z_BC_CREATE_GLPOSTING_BDC. Uses Z_BC_CREATE_GLPOSTING_BAPI.

For more information about configuration details for selecting journal input methods, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications.

Financial integration

129

General ledger journal integration

130

System Administrator Guide

Craft and labor integration

11
Direction Inbound Inbound Outbound, Inbound

Maximo Asset Management and SAP can exchange the following types of labor data:

Labor data exchange types

Integration point Craft Labor Labor time reporting

This chapter is directed to system administrators, implementation team members, and SAP and Maximo consultants. It discusses factors that you need to be aware of when integrating Maximo and SAP labor and craft activity. It assumes that you are familiar with standard labor and cost processing in Maximo Asset Management and SAP. This chapter contains the following sections:
T T

Overview of craft and labor integration Craft integration T Labor integration T Labor time reporting integration

Copyright IBM Corp. 2007, 2011

131

Overview of craft and labor integration

Overview of craft and labor integration

SAP maintains craft (cost center and activity type) and labor (personnel) data in multiple modules. The Controlling (CO) module maintains cost center, activity, and labor rates, and the Human Resources (HR) module maintains personnel data. Integrating craft and labor data between SAP and Maximo Asset Management is a two-step process, which you can perform in one of the following ways. You can use the SAP adapter for both steps, as follows:

1 Use the SAP adapter to send cost center and activity type data from SAP ERP
CO to Maximo Asset Management.

2 Use the SAP adapter to send personnel data from SAP HR to Maximo Asset
Management You can also use a combination of manual data entry and the SAP adapter, as follows:

1 Use the SAP adapter to send cost center and activity type data from the SAP
ERP system to Maximo Asset Management.

2 Use the SAP adapter to send personnel data from SAP HR to Maximo Asset
Management. You can also use a combination of manual data entry and the MEA for SAP Applications, as follows:

1 Use the MEA for SAP Applications to send cost center and activity type data
from the SAP ERP system to Maximo Asset Management.

2 Manually create personnel and pay rates for all combinations of craft and skill
level, in Maximo Asset Management.

Configuration of skill levels and pay rates

One way in which you can configure pay rates in Maximo Asset Management is through the use of premium pay codes, which are factors by which Maximo multiplies an employees base pay to calculate overtime pay. The following tables illustrate a configuration using premium pay codes.

132

System Administrator Guide

Overview of craft and labor integration

Craft rate Craft Electrician Skill level First class Rate 22.00

Premium pay codes Premium pay code OT1 OT2 OT3 OT4

Description More than eight regular hours per shift More than 40 regular hours per week Sunday hours Holiday hours

Rate 1.5 1.5 2.0 3.0

Rate type Multiplier Multiplier Multiplier Multiplier

Craft and labor integration

133

Related interface controls

The SAP adapter does not support the use of premium pay codes. Instead, configure activity codes in SAP, and skill levels in Maximo Asset Management, for every pay rate that applies to a combination of employee and craft. The following table shows how you can configure the same pay rates without using premium pay codes. Configuration of pay rates Craft Electrician Electrician Electrician Electrician Electrician Skill level First class RG First class OT1 First class OT2 First class OT3 First class OT4 Rate 22.00 33.00 33.00 44.00 66.00

Related interface controls

The labor, craft, and time sheet integrations use the following interface control.

Labor, craft, and time sheet-related interface control

Control SAPORGID SAPIOTYPEPREF SAPMX5SITEPREFIX SAPCALSTART SAPGLCOMP SAPGLCONCAT SAPSITEID SAPMAXBSNAME SAPQOS Description Cross Reference Maximo organization ID and SAP company code ID. Translate SAP internal order type to SAP internal order number prefix. Value control to hold the Maximo Site ID prefix. SAP calendar start date. SAP general ledger component settings. SAP general ledger component settings Cross-reference Maximo site ID and SAP plant ID Maximo Business System Name in SAP XI SAP Quality of Service

134

System Administrator Guide

For more information about interface controls, see Chapter 11, "Craft and labor integration," on page 133.

Craft integration
The craft interface transfers new, updated, and deleted cost center and activity type data from the SAP ERP CO module to Maximo Asset Management. You initiate this activity through an ABAP report. Note The craft integration is a prerequisite to the labor integration.

Structure of SAP and Maximo craft data

The SAP ERP CO system maintains cost center and activity type data at the company code level. The SAP cost center corresponds to the Maximo craft and SAP activity type corresponds to the Maximo skill level. The integration creates Maximo craft data at the organization level, in the following tables: Maximo craft data tables Maximo table CRAFT CRAFTSKILL CRAFTRATE Description Basic information about a craft (cost center) Basic information about a skill (activity type) Standard labor rates for combination of craft and skill

Craft and labor integration

135

Craft integration

The following diagram illustrates the integration object and the relationship among the Maximo tables updated during the craft integration. Structure of craft integration object in Maximo Asset Management

The integration verifies the skill against the Maximo SKILLLEVEL domain. If the skill does not exist in that domain, the integration adds it to the domain. If an SAP cost center is marked for deletion, the integration deletes the corresponding CRAFT, CRAFTSKILL, CRAFTRATE records from Maximo Asset Management. It also deletes the LABORCRAFTRATE record that the Labor integration creates. The integration always passes the labor rates for the current accounting period.

Transfer of cost center and activity type data from SAP to Maximo Asset Management
SAP cost center and activity type data is sent to Maximo Asset Management by ABAP batch report ZBCXIREPR170, "Download Cost Centers, Activities, and Prices to Craft in Maximo." Batch report ZBCXIREPR170 is the only method used by this integration to transfer craft data from SAP to Maximo Asset Management.

Batch report ZBCXIREPR170 selection criteria

Batch report ZBCXIREPR170 has the following selection criteria:

136

System Administrator Guide

Craft integration

ZBCXIREPR170 Selection criteria ZBCXIREPR170 Selection Criteria Company Code Description Choose one company code or a range of company codes per each run of the batch report. Choose one fiscal year per each run of the batch report. Choose one language per each run of the batch report. Choose zero, one, or a range of cost centers per each run of the batch report. If you do not choose a cost center, the report runs for all cost centers. Choose zero, one, or a range of activity types per each run of the batch report.

Fiscal Year Language Cost Center

Activity Type

Effectivity of craft data

The EXT_ACTIVE column in the Maximo CRAFT table indicates whether the craft is active (value 1) or no longer exists in SAP (value 0). The integration validates this column when transactions are sent from Maximo Asset Management to SAP.

SAP adapter bulk load action

When you select the bulk load option, Send all, of the ABAP program ZBCXIREPR170, the SAP adapter performs the following actions during the handling of the bulk load of craft data received from SAP:
T

Sets the value of the CRAFT.SAP_UPDATE field to 1 (Active) for each SAP Vendor record included in the bulk load. Inserts the values for all Maximo organizations associated with the incoming craft data into the Organization parameter of the Maximo cron task SAPMASTERDATAUPDATE. Sets the value of the Enabled parameter of the Maximo cron task SAPMASTERDATAUPDATE to 1.

Cron task SAPMASTERDATAUPDATE action

The Maximo cron task SAPMASTERDATAUPDATE updates craft records in Maximo Asset Management to mark the SAP activity type or cost center records in the Maximo database that have been deleted and archived in SAP. When the cron task runs, it performs the following actions:
T

Resets the EXT_ACTIVE field to 0 for each record where the SAP_UPDATE field = 0 and the EXT_ACTIVE field = 1.
137

Craft and labor integration

Craft integration

NOTE

Whenever you run the ZBCXIREPR170 bulk load program for craft records, next immediately run the SAPMASTERDATAUPDATE cron task. This process sets to inactive any Maximo records that correspond to bulk-loaded SAP records that have been archived or deleted in SAP. If you are running more than one of these bulk loads, run the cron task after the last bulk load report is run. Do not run any change or update reports while the SAPMASTERDATAUPDATE cron task is running, or errors may occur. For more information about this Cron Task, see Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center.

NOTE

138

System Administrator Guide

Craft integration

Fields added to CRAFT table

When the SAP adapter is installed, it adds the following fields to the Maximo CRAFT table. Fields added to craft table Field added to CRAFT table EXT_ACTIVE

Description Indicates whether the record is active in SAP. 0 = is not an active SAP activity type or cost center 1 = is an active SAP activity type or cost center

Type YORN

Len 1

Usage This field is mapped from SAP during a run of ABAP Batch Report ZBCXIREPR170. This field is updated during a run of Maximo cron task SAPMASTERDATAUPDATE.

SAP_UPDATE

Indicates whether the activity type or cost center record has been removed from the SAP system. 0 = activity type or cost center record has been removed from SAP 1 = activity type or cost center record is active in the SAP system

YORN

This field is updated during a run of the ABAP Batch Report ZBCXIREPR170*. * for the bulk load option only The SAP_UPDATE column in the Maximo CRAFT table is for internal use.

Related interface control

The craft integration uses the following enterprise service and interface control. Craft enterprise service interface control Control SAPORGID Description Cross Reference Maximo organization ID and SAP company code ID.

For more information about interface controls, see Chapter 11, "Craft and labor integration," on page 117.

Related Maximo enterprise service

The SAP adapter uses the following enterprise service for the craft integration:
T

MXCRAFT_FRSAP05

Craft and labor integration

139

Labor integration

Related Maximo object structures

The SAP adapter uses the following object structures for the craft integration:
T T

MXCRAFT MXDOMAIN

Labor integration
The labor interface transfers new and updated personnel data from SAP HR to Maximo Asset Management. You initiate this activity through an ABAP report or an IDOC. If you do not use the SAP HR system to maintain labor records, manually enter labor and craft rate information in Maximo Asset Management if you wish to use labor time reporting in Maximo Asset Management. You perform this action in the Labor application in the Maximo Resources module. The labor integration uses data in the CRAFTRATE record to populate the LABORCRAFT rate record; therefore, the craft integration is a prerequisite to labor and labor time integration.

Structure of SAP and Maximo labor data

The SAP HR module maintains personnel data. It can contain multiple records per employee, based on effective dates. Any updates to personnel information are made to the current active period of the personnel record. The integration creates Maximo labor data in the following tables. Maximo labor data tables Maximo table LABOR Description Labor information about an employee, such as status location and year to date hours worked. This record is maintained at the organization level in Maximo. General information about an employee such as name, address, and hire date. This record is maintained at the system level in Maximo. Rates and general ledger accounts applicable to the employee.

PERSON

LABORCRAFTRATE

140

System Administrator Guide

Labor integration

The following diagram illustrates the integration object and the relationship among the Maximo tables updated during the labor integration. Structure of labor integration object in Maximo Asset Management

The integration writes SAP personnel data to the LABOR and PERSON records in Maximo Asset Management. It uses the SAP personnel cost center to access the corresponding Maximo CRAFTRATE table, from which it derives the data necessary to populate the LABORCRAFTRATE table. If the CRAFTRATE table contains multiple records for a cost center, the integration creates a LABORCRAFTRATE record for each combination of craft and skill that applies to the employee.

Transfer of personnel data from SAP to Maximo Asset Management

SAP personnel data is sent to Maximo Asset Management by ABAP batch report ZBCXIREPR150, "Download Labors to Maximo."

Batch report ZBCXIREPR150 selection criteria

Batch report ZBCXIREPR150 has the following selection criteria: ZBCXIREPR150 Selection criteria ZBCXIREPR150 Selection criteria Company Code Personnel Number Description Choose one company code per each run of the batch report. Choose zero, one, or a range of personnel numbers per each run of the batch report. Choose one language per each run of the batch report. Choose zero, one, or a range of change dates per each run of the batch report.

Language Change Date

Batch report ZBCXIREPR150 processing options

Batch report ZBCXIREPR150 has the following processing options:

Craft and labor integration

141

Labor integration

ZBCXIREPR150 processing options ZBCXIREPR150 Processing Option Send all Labor Master records Description ABAP sends all active Labor Master records, including those that you might have blocked. It does not delete any Labor Master records in Maximo Asset Management. ABAP sends all active and inactive personnel that meet the selection criteria, that have changed since the last run of the ZBCXIREPR150 report. The ABAP report is executed as part of a scheduled job. Send labor master immediately ABAP sends all labor master records that meet the selection criteria. The ABAP report is executed immediately.

Send changed labor master

IDOC processing
You can also send IDOC personnel inserts and updates to Maximo Asset Management through the HRMD_AIDOC. You can use the object filter object in the ZBC_FILTER table to filter the personnel data that SAP sends to Maximo Asset Management.

Effectivity of labor data

SAP HR indicates an employees status (active or inactive) through a combination of status and effective dates. The integration provides Maximo Asset Management with the SAP status, but not the effective dates.

Related interface controls

The labor integration uses the following enterprise service interface control. Labor enterprise service interface control Control SAPORGID Description Cross Reference Maximo organization ID and SAP company code ID.

For more information about interface controls, see Chapter 11, "Craft and labor integration," on page 117.

142

System Administrator Guide

Labor time reporting integration

Related enterprise service

The SAP adapter uses the following enterprise service for the labor integration:
T

MXLABOR_FRSAP

Related Maximo object structure

The SAP adapter uses the following object structure for the labor integration:
T

MXLABOR

Labor time reporting integration

The SAP CA-TS (Cross Application Time System) and ERP CO modules maintain time sheets. The inbound labor time integration transfers approved time sheets from CA-TS or CO to Maximo Asset Management, and the outbound integration transfers approved labor time reporting from Maximo Asset Management to SAP ERP CO. NOTE The outbound integration does not send time reporting to SAP CA-TS. Before you can integrate labor time reporting between Maximo Asset Management and SAP, corresponding LABOR and LABORCRAFT records must exist in Maximo Asset Management. You can create these records manually or with the labor integration.

Structure of SAP and Maximo labor time data

SAP generates one time sheet for each combination of personnel ID, cost center, and activity type. If a time sheet is changed after it is approved, SAP CA-TS creates a new, active time sheet and uses start and finish dates to flag the previous time sheet as inactive. The time sheets must include a Maximo work order number. SAP does not send pay rates to Maximo Asset Management; rather, Maximo Asset Management uses the personnel ID, cost center, and activity type that it receives from SAP to retrieve the corresponding pay rate from the Maximo LABORCRAFTRATE table. If an SAP time sheet is changed after it is approved, the integration sends two records to Maximo Asset Management: the new time sheet and an adjustment to the previous time sheet. The adjustment contains a negative number of hours. Maximo Asset Management creates a LABTRANS record from each SAP labor time sheet that it receives. If the integration has sent an adjustment to a previous time sheet, Maximo Asset Management generates a LABTRANBS record with a transaction type of ADJUSTMENT.

Transfer of labor time data from SAP to Maximo Asset

Craft and labor integration

143

Labor time reporting integration

Management
SAP time sheet data is sent to Maximo Asset Management by ABAP batch report ZBCXIREPR160, "Download Time Sheets to Maximo." Batch report ZBCXIREPR160 is the only method used by this integration to transfer time sheet data from SAP to Maximo Asset Management.

Batch report ZBCXIREPR160 selection criteria

Batch report ZBCXIREPR160 has the following selection criteria: ZBCXIREPR160 Selection criteria ZBCXIREPR160 Selection Criteria Counter Personnel Nr Description Choose zero, one, or a range of time sheet transaction IDs. Choose zero, one, or a range of personnel numbers per each run of the batch report. Choose one language per each run of the batch report. Choose zero, one, or a range or work orders per run of the batch report. Choose zero, one, or a range of change dates per each run of the batch report.

Language Work Order Number Change Date

Batch report ZBCXIREPR160 also displays fields where you can select attendance codes for normal work time, overtime, and travel time. However, the integration supports only attendance codes 0800, 0801, and 0400.

Batch report ZBCXIREPR160 processing options

Batch report ZBCXIREPR160 has the following processing options: ZBCXIREPR160 processing options ZBCXIREPR160 processing option Send new time sheets Description ABAP sends all active, approved time sheets and adjustments that meet the selection criteria, that have been created since the last run of the ZBCXIREPR150 report. The ABAP report is executed as part of a scheduled job.

144

System Administrator Guide

Labor time reporting integration

ZBCXIREPR160 processing option Send time sheets by value

Description ABAP sends all active, approved time sheets and adjustments that meet the selection criteria, that have been created since the last run of the ZBCXIREPR150 report. The ABAP report is executed immediately.

Related interface controls

The time sheet integration uses the following enterprise service and publish channel interface controls. Time sheet-related enterprise service interface controls Control SAPORGID SAPIOTYPEPREF SAPMX5SITEPREFIX Description Cross Reference Maximo organization ID and SAP company code ID. Translate SAP internal order type to SAP internal order number prefix Value control to hold the Maximo Site ID prefix.

Time sheet-related publish channel interface controls Control SAPORGID SAPIOTYPEPREF SAPMX5SITEPREFIX SAPCALSTART SAPGLCOMP SAPGLCONCAT SAPSITEID SAPMAXBSNAME SAPQOS Description Cross Reference Maximo organization ID and SAP company code ID. Translate SAP internal order type to SAP internal order number prefix Value control to hold the Maximo Site ID prefix. SAP calendar start date SAP general ledger component settings SAP general ledger component settings Cross-reference Maximo site ID and SAP plant ID Maximo Business System Name in SAP PI SAP Quality of Service

Craft and labor integration

145

Labor time reporting integration

Related Maximo enterprise service

The SAP adapter uses the following enterprise service for the labor time reporting integration:
T

MXEMPACT_FRSAP05

Related Maximo publish channel

The SAP adapter uses the following publish channel for the labor time reporting integration:
T

MXEMPACT_TOSAP05

146

System Administrator Guide

Labor time reporting integration

Related Maximo object structure

The SAP adapter uses the following object structure for the labor time reporting integration:
T T

MXEMPACTIN MXEMPACTOUT

Related SAP tables

The Maximo Enterprise Adapter for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo to SAP. SAP Tables related to labor time Table ZBC_INBPROGRAMS Processing mode BDC BAPI Description Uses Z_BC_CREATE_LABORHOURS_BDC. Uses Z_BC_CREATE_LABORHOURS_BAPI.

For more information about configuration details for selecting labor time input methods, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications.

Craft and labor integration

147

Labor time reporting integration

148

System Administrator Guide

Purchasing integration

12

Maximo Asset Management and SAP can exchange the following types of purchasing data:
T

Enterprise services Purchase requisition Purchase order T Publish channels Vendor Contract Purchase requisition status update Purchase order Invoices Invoice Variances Domains This chapter is for system administrators, implementation team members, and SAP and Maximo consultants. It discusses factors that you must be aware of when integrating Maximo Asset Management and SAP purchasing activity. It assumes that you are familiar with standard purchasing processing in Maximo Asset Management and SAP. This chapter contains the following sections:
T T T T T T T T T T

Purchasing scenarios Purchasing and invoicing considerations Vendor integration Contract integration Purchase requisition integration Purchase requisition status update integration Purchase order integration Invoice and credit memo integration Invoice variance integration Domain integration

Copyright IBM Corp. 2007, 2011

149

Purchasing scenarios

Purchasing scenarios
This section provides a brief overview of the most common purchasing and invoicing scenarios between Maximo Asset Management and SAP. A shaded rectangle indicates the system in which you create the document. Purchasing and invoicing scenario 1 In this scenario, you conduct material management and purchasing functions in SAP Applications. Maximo Asset Management manages purchase requisitions. SAP manages centralized purchasing and invoicing. Purchasing and invoicing scenario 1

150

System Administrator Guide

Purchasing scenarios

Purchasing and invoicing scenario 2

In this scenario, material management and purchasing functions are conducted in Maximo Asset Management, accounting functions are conducted in SAP. Maximo Asset Management manages centralized purchasing. SAP manages general ledger and accounts payable. Purchasing and invoicing scenario 2

IBM Corporation has tested and supports the integration points in the preceding two scenarios. You are not limited to using the integration components shown in the preceding scenarios. You can implement the integration points available from the Maximo Enterprise Adapter for SAP that meet your business requirements.

Purchasing integration

151

Purchasing and invoicing considerations

Purchasing and invoicing considerations

This section describes features and functionality shared by the purchasing and invoicing integrations.

Structure of purchasing hierarchies

In SAP, the purchasing functions are handled by a different organizational structure than the purchasing functions in Maximo Asset Management. The default settings in the Maximo Enterprise Adapter for SAP map the relationships between the two systems for purchasing functions as shown in the following figure. Maximo Asset Management and SAP purchasing hierarchies

152

System Administrator Guide

Purchasing and invoicing considerations

Status controls for outbound transactions

A Maximo interface control associated with each purchasing and invoice interface specifies the statues at which the integration sends a document to SAP. The following table lists the interfaces and their corresponding controls: Purchasing and invoice interface controls Maximo Interface Purchase requisition Purchase order Invoice Maximo SEND Control PRSEND POSEND IVSEND

By default, the value of each control is APPR; that is, the integration sends the corresponding interface to SAP when the document status is APPR, or approved. If you modify the values in a control, include all synonyms for the statuses associated with the control.

Purchasing line types

Maximo Asset Management requires each PO line and contract line to have a defined line type. The Maximo Enterprise Adapter for SAP integrates purchasing data for only the following Maximo line types
T T

ITEM MATERIAL T SERVICE For purchase order or contract lines in the following Maximo transactions
T T

contracts purchase requisitions T purchase orders When an inbound purchasing transaction is for an item that does not refer to a Maximo PR line, the Maximo Enterprise Adapter for SAP derives the Maximo line type from the presence or absence of an item number and/or the value in the SAPLINETYPE cross-reference control. This integration does not support Maximo PO Line Types "Special Order" (SP ORDER) or "Standard Service" (STD SERVICE).

Item number mapping

On outbound purchasing documents, item numbers are not mapped from Maximo Asset Management to SAP if items are not SAP-owned items.

Purchasing integration

153

Purchasing and invoicing considerations

For more information about item number mapping, see the "Purchase Requisition Integration" and "Purchase Order Integration" sections of this chapter.

Multiple distributions
Multiple distributions of purchasing line costs are handled differently in Maximo Asset Management than they are in SAP. Distributions in Maximo Asset Management are handled in GL Accounts. In SAP, Account Assignment Category (AAC) cost objects handle distributions.

Multiple distributions inbound

Multiple distributions are supported for purchase orders inbound from SAP to Maximo Asset Management. The integration creates a separate PO line in Maximo Asset Management for each item distribution on an inbound purchase order. For example, if a PO from SAP has one line with an item with three distributions, then the resulting PO in Maximo has three PO lines.

Inbound purchase order line numbers

The adapter uses the PO line number field to hold ID information about the incoming SAP PO line number and SAP distribution line number. If the inbound PO item does not have multiple distribution, the integration adds the SAP line number and "01" to the POLINENUM. For more information, see "Structure of purchase order line numbers for inbound POs," on page 12-165.

Multiple distributions outbound

Multiple distributions are not supported in purchase requisitions or purchase orders outbound from Maximo Asset Management to SAP. Maximo multiple distribution uses only the GL account number to distribute the cost for a line. In SAP, multiple distribution occurs at the cost object (WO, Asset, WBS Element, Cost Center, and so on) not in GL accounts.

Outbound purchase order line numbers

The adapter uses the PO line number field to hold ID information about the SAP PO line number and SAP distribution line number. If the outbound PO item does not have multiple distribution, the integration adds the SAP line number and "01" to the POLINENUM. For more information, see "Structure of purchase order numbers for outbound POs," on page 12-165.

154

System Administrator Guide

Vendor integration

Vendor integration
The vendor interface transfers new and updated vendors from SAP to Maximo Asset Management. SAP maintains and updates vendor data. SAP Vendors are the equivalent of Maximo Companies. If you create a vendor in SAP, make all updates to that vendor in SAP. If you update the vendor in Maximo, the change does not appear in SAP.

Structure of vendor data

SAP vendor data consists of Basic data at the Client level, Accounting data at the Company Code level, and Purchasing data at the Purchase Organization level. Vendor data hierarchy (SAP)

Maximo vendor data consists of a vendor master at the set level and one or more vendor records at the organization level. An organization has only one vendor set, but a vendor set can belong to more than one organization. Maximo Asset Management refers to vendors as companies. Company structure (Maximo Asset Management)

The integration passes SAP vendor data to Maximo Asset Management according to the selection criteria you use when running the ZBCXIREPR007 ABAP report. Before using the integration, configure the relationship between company master sets and Maximo organizations. You perform this configuration in the Maximo Sets application.

Purchasing integration

155

Vendor integration

The SAP Vendor organization hierarchy is different than the Companies organization hierarchy in Maximo Asset Management. The following table shows organization mapping between the hierarchies. Vendor organization mapping between Maximo Asset Management and SAP Maximo COMPANIES.COMPANYSETID COMPANIES.ORGID SAPPURCHSITEID cross-reference control SAP System Client (MANDT) Company Code (BUKRS) Purchase Organization (EKORG)

156

System Administrator Guide

Vendor integration

The following figure shows the data mapping between the hierarchies. Maximo Enterprise Adapter for SAP vendor inbound integration

Creating Maximo company masters

The integration does not by default automatically create Maximo company masters. Configure Maximo Asset Management to create a company master for each new inbound vendor record that has not previously existed in the Maximo database. Select the Automatically Add Companies to Company Master check box in the Maximo Sets application. If you do not, errors occur. During a bulk load of inbound vendor data, this setting creates company master records only for vendors new to Maximo Asset Management.

Purchasing integration

157

Vendor integration

Although Maximo Asset Management allows a one-to-many relationship between company masters and company record, there is a one-to-one relationship for vendors added via the vendor integration.

Transferring vendor data from SAP to Maximo Asset Management

Use the ABAP Batch Report ZBCXIREPR007, Download Vendors to Maximo, to send SAP Vendor Master data to the Maximo COMPANIES table. Batch Report ZBCXIREPR007 is the only method that this integration uses to transfer Vendor Master data from SAP to Maximo Asset Management. Select the Maximo Company Code you want to send to Maximo Asset Management when you run the Batch Report ZBCXIREPR007, because ZBC_RUNTIMES does not store the company codes. If you want to send reports for more than one Maximo Company Code, run ZBCXIREPR007 multiple times, once for each Company Code for which you want a report.

Batch report ZBCXIREPR007 selection criteria

Batch Report ZBCXIREPR007 has three selection criteria: ZBCXIREPR007 Selection criteria ZBCXIREPR007 Selection criteria Company Code Purchase Organization Vendor number range Description Choose one Company Code per each run of the batch report. Choose one Purchase Organization per each run of the batch report. (Optional) Select a number range for the SAP Vendors to be sent to Maximo.

Batch Report ZBCXIREPR007 processing options

Batch Report ZBCXIREPR007 has three processing options: ZBCXIREPR007 Processing options ZBCXIREPR007 Processing option Send all Vendors Description ABAP sends all active Vendors, including those that you might have blocked. It does not delete any Vendors in Maximo. ABAP sends only Vendor data that has changed since the last run of the ZBCXIREPR007 report. ABAP sends all Vendor records that meet the selection criteria. SAP executes the ABAP report immediately.

Send changed Vendors

Send Vendors immediately

158

System Administrator Guide

Vendor integration

Process flow for send all vendors (Bulk Load) processing option
1 When you select Send all Vendors, ABAP program ZBCXIREPR007 selects all
active SAP vendors meeting the selection criteria, including those that might be blocked. This option is also known as a bulk load.

2 The Maximo Enterprise Adapter for SAP receives the Vendor data from SAP. 3 The Maximo Enterprise Adapter for SAP inserts the SAP Vendor data into the
Maximo Companies table.

Process flow for send changed vendors (Incremental Update) processing option
1 When you select Send changed Vendors, ABAP program ZBCXIREPR007
selects all changed SAP vendors meeting the selection criteria.

2 The Maximo Enterprise Adapter for SAP receives the Vendors from SAP that
have been changed or created since the last time the report was run.

3 The Maximo Enterprise Adapter for SAP inserts the changed SAP Vendor
data into Maximo Asset Management to update the relevant Companies records.

Process flow for send vendor immediately processing option

1 When you select Send Vendors immed, ABAP program ZBCXIREPR007
sends the selected Vendor records immediately to Maximo Asset Management.

2 The Maximo Enterprise Adapter for SAP receives the Vendors from SAP. 3 The Maximo Enterprise Adapter for SAP inserts the selected SAP vendor data
into the Maximo companies table.

CREMAS IDOC method

With CREMAS IDOC method, you can send SAP Vendor Master data to the Maximo Companies table in real time. The CREMAS IDOC method includes the RBDMIDOC program. The program is the standard SAP report that creates IDOCs from change pointers. When you create or update SAP vendors, SAP periodically runs a scheduled job of the RBDMIDOC program to analyze the change pointers. Change pointers are the SAP database tables that contain new or changed vendor records. If the scheduled job detects changes in the change pointers, it indicates for the RBDMIDOC program to create IDOCs for the affected vendors.

Effectivity of vendor data

The EXT_ACTIVE column in the Maximo COMPANIES table indicates whether the vendor is active (value 1) or no longer exists in SAP (value 0). The integration validates this column when transactions are sent from Maximo to SAP.

Purchasing integration

159

Vendor integration

Maximo Enterprise Adapter for SAP bulk load action

When you select the bulk load option, Send all Vendors, of the ABAP program ZBCXIREPR007, the Maximo Enterprise Adapter for SAP performs the following actions during the handling of the bulk load of vendor data received from SAP:
T

Sets the value of the COMPANIES.SAP_UPDATE field to 1 (Active) for each SAP vendor record included in the bulk load. Inserts the values for all Maximo Organizations associated with the incoming vendor data into the Organization parameter of the Maximo cron task SAPMASTERDATAUPDATE. Sets the value of the enabled parameter of the Maximo cron task SAPMASTERDATAUPDATE to 1.

Cron Task SAPMASTERDATAUPDATE action

The Maximo cron task SAPMASTERDATAUPDATE updates Company records in Maximo to mark the SAP vendors in the Maximo database that you have deleted and archived in SAP. When the cron task runs, it performs the following actions:
T

Resets the EXT_ACTIVE field to 0 for each record where the SAP_UPDATE field = 0 and the EXT_ACTIVE field = 1.

Whenever you run the ZBCXIREPR007 SAP bulk load program for vendor records, immediately afterwards run the SAPMASTERDATAUPDATE cron task. This process sets to inactive any Maximo records that correspond to bulkloaded SAP records that have been archived or deleted in SAP. If you are running more than one of these bulk loads, run the cron task after the last bulk load report is run. Do not run any change or update reports while the SAPMASTERDATAUPDATE cron task is running, or errors may occur. For more information about this Cron Task, refer to Integrating Data with External Applications in the IBM Maximo Asset Management 7.5 Information Center.

Fields added to COMPANIES Table

After you install the Maximo Enterprise Adapter for SAP, it adds the following fields to the Maximo COMPANIES table.

160

System Administrator Guide

Vendor integration

Fields added to companies table Field added to COMPANIES table EXT_ACTIVE

Description Indicates whether the company is an active SAP vendor. 0 = is not an active SAP vendor 1 = is an active SAP vendor

Type YORN

Len 1

Usage This field is mapped from SAP during a run of ABAP Batch Report ZBCXIREPR007. This field is updated during a run of Maximo cron task SAPMASTERDATAUPDATE.

SAP_UPDATE

Indicates whether the vendor record has been removed from the SAP system. 0 = vendor record has been removed from SAP 1 = vendor record is active in the SAP system

YORN

This field is updated during a run of the ABAP Batch Report ZBCXIREPR007*. * for the bulk load option only The SAP_UPDATE column in the Maximo COMPANIES table is for internal use.

Purchasing integration

161

Vendor integration

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the vendor integration:
T

MXVENDOR_FRSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the vendor integration. It enables vendors inbound.:
T

MXVENDOR

Related interface control

The Vendor integration uses the following Maximo interface control. Vendor-related enterprise service interface control Interface control SAPORGID Control type Cross-reference

For more information about interface controls, see Chapter 4, Interface controls.

162

System Administrator Guide

Contract integration

Contract integration
The contract interface transfers contracts from SAP to Maximo Asset Management. The Maximo Enterprise Adapter for SAP integration handles only contracts inbound from SAP to Maximo Asset Management. Contracts are transferred from SAP to Maximo Asset Management using IDoc type EKSEKS01.

Structure of contract data

In SAP, contract type and number ranges are defined at the Client level. Contract records are created at the Purchase Organization level. Any Plants within a Purchase Organization can use the same contract record to create a purchase order. Contract lines are created at the Purchase Organization or Plant levels. Contract structure (SAP)

Purchasing integration

163

Contract integration

In Maximo Asset Management, contracts are created at the Organization level (ORGID). When you create a contract, you authorize the sites that can reference and use the contract. Contract structure (Maximo Asset Management)

Types of contracts
The Maximo Enterprise Adapter for SAP handles contracts inbound from SAP to the Maximo Contracts application for only the following Maximo types of contracts:
T T

Blanket Price

A Maximo blanket contract is an agreement with a particular vendor to spend a pre-determined amount for materials or services for a defined period of time. A Maximo price contract is an agreement with a particular vendor to purchase items or services at agreed-upon prices for a defined period of time.

164

System Administrator Guide

Contract integration

The following table shows the mapping of SAP and Maximo contract types. Contract type mapping SAP contract document type Quantity (MK) Price (WK) Maximo contract type Blanket Pricing

Contract integration requirements

Before sending contracts from SAP to Maximo Asset Management, perform the following configurations in Maximo Asset Management:
T

Define SAP Company Codes to be used in the contract integration in the SAPORGID interface control. Define SAP Plants to be used in the contract integration in the SAPSITEID interface control. Define SAP contract document types to be mapped to Maximo Asset Management in the SAPCONTRACTTYPE interface control. Define Maximo line types to be used in the contract integration in the SAPLINETYPE interface control. DO NOT select the PO Option Allow the Generation of Special Order Items? checkbox in the Organizations application.

When contracts are revised in SAP the revisions are integrated into the original contracts in Maximo Asset Management. Do not create a new revision number for a contract in Maximo Asset Management because SAP can not recognize the new revision number. For specific configuration procedures and details, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications.

Filters
The integration transfers contracts from SAP to Maximo Asset Management when the following conditions are met.
T

An item number on an inbound contract line must exist already in Maximo Asset Management. The vendor for an item on an inbound contract line must exist already in Maximo Asset Management. The contract is of either SAP contract document type Price (WK) or Quantity (MK).

Contracts inbound to Maximo Asset Management include SAP contract line base data such as item number, description, quantity, and price. The integration does not support SAP line item cost objects and distribution functionalities.
Purchasing integration

165

Contract integration

IDoc type EKSEKS01 filtering

SAP Contracts are sent to Maximo Asset Management by the IDoc type EKSEKS01. The Maximo Enterprise Adapter for SAP allows the following Contract parameters:
T

A contract created by an SAP purchase organization can be used by any plant within that purchase organization. A contract created by an SAP purchase organization can be specific to one plant. A contract created by an SAP plant must contain contract lines referring only to that plant.

Contract authorization
Maximo contracts are created at the organization level. When you create a contract in Maximo Asset Management, authorize the Maximo sites that can use that contract. The authorized SITEIDs are at the contract header level. In SAP, contracts can be created at the Purchase Organization level and at the Plant level. A purchase organization can authorize all plants within that purchase organization to use the contract, or just one. A plant can create a contract that contains lines from only that plant, or can include lines from other plants. This integration does not support contracts created at the plant level (equivalent to Maximo site level, where contract lines are from more than one plant. The integration authorizes the plants (Maximo sites) that can use the inbound contract based on the filtering parameters described in the previous section, "IDOC Type EKSEKS01 Filtering."

Creation of purchase orders from contracts

A Maximo user can create a release purchase order from a contract that originated in SAP. The lines on the contract are read-only, and you can add data only on the contract header and in the terms and conditions. To be able to create a release PO against a blanket contract in Maximo Asset Management, select the Create Release? check box on the Properties tab of the Maximo Contracts application for the contract, after the contract is received from SAP.

Maximo contract line status

The contract line status can be changed in Maximo Asset Management. If a Maximo contract line status is changed from APPR to CAN, this contract line status cannot be changed back to APPR. If you use the line later, change the status to WAPPR, rather than CAN. If an SAP contract line is marked for deletion, the Maximo Enterprise Adapter for SAP changes the status to WAPPR.

166

System Administrator Guide

Purchase requisition integration

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the contract integration:
T

MXPC_FRSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the contract integration. it enables contracts inbound.
T

MXPC

Related interface controls

The contract integration uses the following enterprise service interface controls. Contract-related interface controls Interface control SAPORGID SAPSITEID SAPITEMSETID SAPCONTRACTTYPE SAPLINETYPE Control type Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference

Purchase requisition integration

The purchase requisition (PR) interface transfers purchase requisitions from Maximo Asset Management to SAP when the status of the purchase requisition matches a status in the PRSEND interface control. Configure the integration to send PRs to SAP by either the BDC or the BAPI input method.

Purchasing integration

167

Purchase requisition integration

Structure of purchase requisition data

In SAP, PR numbers are unique at the client level. PR types and number ranges are defined at the client level. PR records are created at the Purchase Organization level. PR lines are created by the Plants within Purchase Organizations. PR structure (SAP)

168

System Administrator Guide

Purchase requisition integration

In Maximo Asset Management, PRs are generated at the Site level (SITEID). PR structure (Maximo Asset Management)

Purchase requisition integration requirements

Before sending PRs from Maximo Asset Management to your SAP system, perform the following configurations in SAP:
T T

Define a Maximo PR document type and corresponding number ranges. Select either the batch (BDC) or old or new BAPI input method for sending Maximo PRs to SAP. SAP Material Purchasing and Accounting views must exist for each SAPowned item to be included on a PR.

Before sending PRs from Maximo Asset Management to your SAP system, perform the following configurations in Maximo Asset Management:
T T T T T T

Set up PR Autonumbering at the Maximo Site level. Enable the integration event for outbound purchase requisitions, MXPR. Add SAP PR Document Number prefix and Maximo SITEID prefix Define status values in the PRSEND interface control. Configure the SAP PR document type in the SAPPRTYPE interface control. Define SAP Company Codes to be used in the PR integration in the SAPORGID interface control.

Purchasing integration

169

Purchase requisition integration

T

Define SAP Plants to be used in the PR integration in the SAPSITEID interface control. Define SAP Storerooms to be used in the PR integration in the SAPSTORERM interface control. Define a UOM conversion factor for each SAP-owned item to be included on a PR. Set the default value for the SAP_GLACCT column and configure the value list for the Domain.

For specific configuration procedures and details, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications.

Structure of purchase requisition numbers for outbound PRs

In Maximo Asset Management, the PRNUM is unique per site, but more than one Maximo site can use the same PR number. Therefore, to differentiate PRs from multiple Maximo sites for PRs outbound from Maximo to SAP, the integration adds the Maximo SITEID prefix to the PRNUM to make the PRNUM unique per site and the Maximo PR numbers unique in the SAP system. If your integration does not use multiple Maximo sites, you do not need to add the site prefix. On PRs outbound from Maximo to an SAP system, the PRNUM is an autonumbered concatenation of the SAP PR Document Number prefix, the Maximo SITEID prefix, and the Maximo PR number. The SAP PR Document Number prefix determines the number range assigned to the PR in SAP. If your outbound PR number prefix is numeric, consisting of numbers rather than alphabetic characters, the SAP system adds leading zeros to the PR number to pad the number if it has fewer than ten alphanumeric characters. The integration removes the leading zeros when the transaction returns to Maximo from SAP as a PR status update or purchase order. If your outbound PRNUM does not begin with a number, then SAP does not add leading zeros to the PRNUM. The PRNUM length must be no more than ten characters to match the SAP PR number length. Make sure the added prefixes do not cause the total length of the PRNUM to exceed ten characters. For more information about configuring autonumbering , see "Outbound Maximo PO/PR number prefixes," on page 74.

Field added to PR table

When the Maximo Enterprise Adapter for SAP is installed, it adds a column to the Maximo PR table. If this column uses only one value, then you can set the default value for the column in the database during the implementation and do not need to display it on the PR screen. If this column uses more than one value, set the value list for the Domain for this column during implementation.

170

System Administrator Guide

Purchase requisition integration

The following table describes the column that the adapter adds to PR. Column added to PR table Column added to PR table SAP_UPG

Description Value of 1 indicates that you originally created the PR in Release 5.x. Maximo Enterprise Adapter for SAP R/3 4.7.

Type YORN

Len 1

Domain

Usage Outbound PRs only

Fields added to PRLINE table

When the Maximo Enterprise Adapter for SAP is installed, it adds three columns to the Maximo PRLINE table. If any column uses only one value, you can set the default values for the columns in the database during the implementation and do not need to display them on the PRLINE screen. If any column uses more than one value, set the value list for the Domain for the columns during implementation. The following table describes the columns that the adapter adds to PRLINE. Columns added to prline table Columns added to PRLINE table SAP_MATL_GRP Description Holds SAP Material Group value. Used when PR line type is SERVICE. SAP_PURCH_GRP Holds SAP Purchase Group value. Default values are from INVENTORY.SAP_PURCH_GRP for stock and non-stock item categories. SAP_GLACCT Holds SAP PR FI GL account value. Required in SAP if PRLINE Material Number is null. ALN 10 SAP_GLACCT ALN 3 SAP_PURCH_GRP Type ALN Length 9 Domain SAP_MATL_GRP

Filters
The integration transfers purchase requisitions from Maximo to SAP, for PR line items that are SAP-owned items, when the following conditions are met:
T T

The status of the PR is equal to a status in the PRSEND control. The date of the PR falls after the date in the SAPCALSTART control.
171

Purchasing integration

Purchase requisition integration

T T

All SAP-owned PRLINE items are active items in SAP Material Master. All SAP-owned PRLINE items have pre-existing SAP Purchasing and Accounting views. The Vendor for each PRLINE item is not disabled in SAP. PR line type is ITEM, MATERIAL, or SERVICE.

T T

When items on a PR being sent from Maximo to SAP are not SAP-owned, they are sent as miscellaneous type items, and the item numbers are not mapped to SAP.

Related interface controls

The Maximo Enterprise Adapter for SAP uses the following publish channel interface controls for the purchase requisition integration: Purchase requisition-related interface controls Interface control SAPORGID SAPSITEID SAPSTORERM SAPGLCOMP SAPGLCONCAT SAPCALSTART SAPIOTYPEPREF SAPMX5SITEPREFIX SAPPRTYPE SAPAAC PRSEND SAPMAXBSNAME SAPQOS SAPWOOUT Control type Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference Value Cross-reference Value Value Cross-reference List Value Cross-reference Indicates if Maximo sends work order transactions to SAP

For more information about interface controls, see Chapter 4, Interface controls.

172

System Administrator Guide

Purchase requisition integration

Related Maximo publish channel

The Maximo Enterprise Adapter for SAP uses the following publish channel for the purchase requisition integration:
T

MXPR_TOSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the Purchase requisition integration. It enables purchase requisitions outbound.
T

MXPR

Related SAP tables

The MEA for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo Asset Management to SAP. SAP Tables related to purchase requisitions Table ZBC_INBPROGRAMS Processing Mode BDC BAPI BAPI Description Uses Z_BC_CREATE_PURCHASEREQ_BDC. Uses Z_BC_CREATE_PURCHASEREQ_BAPI. Uses Z_BC_CREATE_PURCHASEREQ_N_BAPI.

The following table contains information on the SAPMXCONFIG table, as it relates to purchase requisitions. Configuration of ZBC_SAPMXCONFIG for purchase requisitions Table ZBC_SAPMXCONFIG Variable BAPIME51N Description To use the new SAP PR BAPI that supports additional data for the SAP Enjoy Purchase Requisition feature, enter a value of X for the BAPIME51N variable. To use the standard PR BAPI, leave this field blank.

Purchasing integration

173

Purchase requisition status update integration

Purchase requisition status update integration

Purchase requisitions are created in Maximo Asset Management and sent to SAP. After the PR is sent to SAP, the SAP system owns the PR. The Maximo Enterprise Adapter for SAP integration lets PR Status updates be sent to Maximo Asset Management based on status changes to the SAP PR lines.

Purchase requisition considerations

This section describes differences between how Maximo Asset Management and SAP handle purchase requisitions.

Reuse of closed PR lines in SAP

Maximo Asset Management can be configured to change the status of a PR to CLOSE automatically when all PR lines are copied to a purchase order. In Maximo Asset Management, after a PR is closed (status is changed to CLOSE), it cannot be reopened to reuse the PR lines. In SAP, you are allowed to open a closed PR to reuse PR lines. If you reuse a PR line item in SAP, and the corresponding Maximo PR status is CLOSE, the update from SAP to Maximo Asset Management causes an error. To prevent this error, do not select the Maximo PO option Close PR/RFQ When All PR/RFQ Lines Have Been Copied to POs or Contracts?. This option is in the Organizations application > Select Action menu > Purchasing Options > PO Options dialog box.

Using multiple purchase order numbers per PR line in SAP

Maximo Asset Management allows one PO and PO line number per each PR line. SAP allows multiple PO and PO line numbers per each PR line. If you create a PO for a partial quantity from an SAP PR Line, SAP sends a PR status update to Maximo for the originating Maximo PR. When subsequent POs are created for the same PR line in SAP, the Maximo Enterprise Adapter for SAP inserts the new PO data into Maximo without referencing the originating Maximo PR number or PR line number.

Transfer of PR status update data from SAP to Maximo Asset Management

SAP purchase requisition status update data is sent to Maximo Asset Management by ABAP Batch Report ZBCXIREPR005, "Download PR Status Updates to Maximo." This report sends only PR header data to Maximo Asset Management. It sends only PR status data, it does not send PR line data. The report sends PR status changes of either CANCEL or CLOSE. If your PR number prefix is numeric, consisting of numbers rather than alphabetic characters, the SAP system adds leading zeros to the PR number to pad the number if it has fewer than ten alphanumeric characters. The integration removes the leading zeros when the transaction returns to Maximo Asset Management from SAP as a PR status update or purchase order. If your outbound PRNUM

174

System Administrator Guide

Purchase requisition status update integration

does not begin with a number, then SAP does not add leading zeros to the PRNUM.

Purchasing integration

175

Purchase requisition status update integration

Batch report ZBCXIREPR005 selection criteria

Batch Report ZBCXIREPR005 has three selection criteria: ZBCXIREPR005 selection criteria ZBCXIREPR005 Selection Criteria Select PR number range Description Select the number range for the SAP PRs whose status value updates you want to send to Maximo. You can choose to send data for PR status values of CANCEL. You can choose to send data for PR status values of CLOSE.

Send PR Status CANCEL Send PR Status CLOSE

Batch report ZBCXIREPR005 processing options

Batch Report ZBCXIREPR005 has two processing options: ZBCXIREPR005 processing options ZBCXIREPR005 Processing option Send new Status Changes Description ABAP sends PR status data that has changed since the last run of the ZBCXIREPR005 report. ABAP sends PR status data that has changed for PRs within the selected date range.

Send Status Changes in range

Filters
The integration transfers purchase requisition status updates from SAP to Maximo Asset Management when any of the following conditions in the SAP system are met for Maximo integration items, depending on the selection criteria used at the run of ZBCXIREPR005:
T T T

All of the SAP PR Lines are marked for deletion or blocking. All of the SAP PR Lines are fully ordered. An SAP PR Line has been ordered and that PR Line is closed.

176

System Administrator Guide

Purchase order integration

Interface controls
The Maximo Enterprise Adapter for SAP uses the following interface controls for the purchase requisition status update integration: Purchase requisition status update-related interface controls Interface control SAPORGID SAPSITEID SAPMX5SITEPREFIX SAPPRTYPE Control type Cross-reference Cross-reference value value

For more information about interface controls, see Chapter 4, Interface controls.

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the purchase requisition status update integration:
T

MXPR_FRSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the purchase requisition status update integration. It enables purchase requisition status updates inbound.
T

MXPR

Purchase order integration

The Maximo Enterprise Adapter for SAP can be configured to handle purchase orders inbound to Maximo Asset Management or outbound from Maximo Asset Management. The interface you use, inbound or outbound, depends on the system that manages purchasing functions. Inbound purchase orders The inbound purchase order interface, MXPO_FRSAP05, transfers purchase orders from SAP to Maximo Asset Management when purchase order activity occurs in SAP. The basic PO inbound assumption is that purchasing and material management are done in the SAP system. Purchase orders are transferred from SAP to Maximo Asset Management using IDoc type EKSEKS01. The outbound purchase order interface, MXPO_TOSAP05, transfers purchase orders from Maximo Asset Management to SAP when the status of the Maximo purchase order is equal to a status in the POSEND interface control. The basic PO outbound assumption is that purchasing and material management are done in Maximo Asset Management.

Outbound purchase orders

Purchasing integration

177

Purchase order integration

Configure the integration to send POs to SAP by either the BDC or the BAPI input method.

Purchase order integration requirements

Before sending purchase orders between Maximo Asset Management and SAP, configure the sending and receiving systems as described in the following sections. Inbound and outbound POs Before sending POs between Maximo Asset Management and your SAP system, perform the following configurations in Maximo Asset Management:
T

Define SAP Company Codes to be used in the PO integration in the SAPORGID interface control. Define SAP Plants to be used in the PO integration in the SAPSITEID interface control. Define SAP Purchasing Organizations to be used in the PO integration in the SAPPURCHSITEID interface control. Define SAP Storerooms to be used in the PO integration in the SAPSTORERM interface control. DO NOT select the PO Option Allow the Generation of Special Order Items? checkbox in the Organizations application.

Outbound POs only

Before sending POs from Maximo Asset Management to SAP, perform the following configurations in Maximo:
T T T

Set up PO Autonumbering. For more information, see the next section. Enable the integration event for outbound purchase orders, MXPOOUT. Define SAP purchase order document type to be used in the PO integration in the SAPPOTYPE interface control. Define status values in the POSEND interface control. If outbound POs contain receipt tolerance greater than 99.9%, set the SAPUNLIMITTOLERANCE integration control to true. See Receipt tolerance on page 165. The Maximo default receipt tolerance (percentage or amount) for outbound PO line items is "unlimited". Set the PO Line items tolerance amount or percentage to 0 to override this behavior.

T T

Before sending POs from Maximo Asset Management to SAP, perform the following configurations in SAP:
T T

Define a Maximo PO document type and corresponding number ranges. Select either the batch (BDC) or BAPI input method for sending Maximo POs to SAP (for POs outbound).

178

System Administrator Guide

Purchase order integration

Structure of purchase order numbers for outbound POs

In Maximo Asset Management, the PONUM is unique per site, but more than one Maximo site can use the same PO number. Therefore, to differentiate POs from multiple Maximo sites, the integration adds the Maximo SITEID prefix to the PONUM to make the PONUM unique per site and the Maximo PO numbers unique in the SAP system. If your integration does not use multiple Maximo sites, you do not need to add the site prefix. On POs outbound from Maximo Asset Management to an SAP system, the PONUM is an autonumbered concatenation of SAP PO Document Number prefix, the Maximo SITEID prefix, and the Maximo PO number. The SAP PO Document Number prefix determines the number range assigned to the PO in SAP. If your outbound PO number prefix is numeric, consisting of numbers rather than alphabetic characters, the SAP system adds leading zeros to the PO number to pad the number if it has fewer than ten alphanumeric characters. The integration removes the leading zeros when the transaction returns to Maximo Asset Management from SAP. If your outbound PONUM does not begin with a number, then SAP does not add leading zeros to the PONUM. The PONUM length must be 10 characters to match the SAP PO number length. Make sure the added prefixes do not cause the total length of the PRNUM to exceed ten characters. For more information about configuring autonumbering, see "Outbound Maximo PO/PR number prefixes," on page 74.

Structure of purchase order line numbers for inbound POs

On POs inbound, the POLINENUM is a concatenation of the five-digit SAP PO line number, (EBELP), and the two-digit SAP distribution line number, (ZEKKN). The last two digits of a Maximo Enterprise Adapter for SAP integration purchase order line number represent the sequential number of the distributions in SAP. The default purchase order line number ends in "01," indicating there was no distribution. If a line item was distributed in SAP, the last two digits show the multiple distribution line number value accordingly, for example, "02" or "03."

Receipt tolerance
Maximo Asset Management adds columns to POLINE to provide a way to limit the quantity of goods or service that can be received, in excess of the amount or quantity specified on a purchase order. This limitation is accomplished by specifying a tolerance, which, if not exceeded, allows the overage to be received and paid for. The receipt tolerance can be specified as a percentage of items that can be received, over the amount specified on a PO, in the PO line quantity. You can also express a receipt tolerance as a quantity, to indicate the number of items that you can receive, over the total specified on the PO order quantity, or as a monetary amount that can be received over the total specified on the PO line cost. To support receipt tolerances, the following columns have been added to POLINE:
179

Purchasing integration

Purchase order integration

RECEIPTTOLERANCE - This column contains the receipt tolerance percentage, which specifies the percentage of items that can be received, over the number specified on the PO order quantity. T RECEIPTTOLAMT - This column contains the receipt tolerance amount, which specifies a limit on the monetary amount of received items, above the amount specified by the PO line cost. T RECEIPTTOLQTY - This column contains the receipt tolerance quantity, which specifies a limit on the quantity of items that can be received, above the quantity specified on the PO line quantity. If you specify a tolerance as a percentage, the corresponding value for the tolerance amount is calculated automatically. Similarly, if you specify an amount, the percentage is calculated for you. SAP only allows an over tolerance of up to 99.9 %. Maximo Asset Management allows over 99.9 %. If outbound POs contain receipt tolerance greater than 99.9%, set the SAPUNLIMITTOLERANCE integration control to true. SAP's over tolerance and unlimited tolerance will be used for the inbound PO which is coming from SAP to Maximo Asset Management.

Fields added to PO table

When the Maximo Enterprise Adapter for SAP is installed, it adds columns to the Maximo PO table. If these columns use only one value, then you can set the default values for the columns in the database during the implementation and do not need to display it on the PO screen. If these columns use more than one value, set the value list for the Domain for these columns during implementation. The following table describes the columns that the adapter adds to PO.

180

System Administrator Guide

Purchase order integration

Columns added to PO table Column added to PO table SAP_PURCH_GRP Description Holds SAP Purchase Group value. This column is not mapped from SAP. Default value is from PRLINE. SAP_PURCH_GRP. SAP_UPG Value of 1 indicates that you originally created the PO in release 5.x. Maximo Enterprise Adapter for SAP R/3 4.7. YOR N 1 Outbound POs only Type ALN Len 3 Domain SAP_PURCH_GRP Usage Outbound POs only

Fields added to POLINE table

When the Maximo Enterprise Adapter for SAP is installed, it adds three columns to the Maximo POLINE table. If any of these columns uses only one value, then you can set the default values for the columns in the database during the implementation and do not need to display them on the PRLINE screen. If any of these columns uses more than one value, set the value list for the Domain for these columns during implementation. The following table describes the columns that the adapter adds to POLINE.

Purchasing integration

181

Purchase order integration

Columns added to POLine table Columns added to POLINE table SAP_MATL_GRP Description Holds SAP Material Group value. This column is not mapped from SAP. Default value is from PRLINE.SAP_MATL_GRP SAP_GLACCT Holds SAP PR FI GL account value. This column is not mapped from SAP. Default value is from PRLINE.SAP_GLACCT. SAP_RECV_REQ Used for receipts required for service line item or distributed line item. 1 = receipts required 0 = receipts not required YORN 1 Inbound POs only ALN 10 SAP_GLACCT Outbound POs only Type ALN Len 9 Domain SAP_MATL_GRP Usage Outbound POs only

Filters
Inbound purchase orders The integration transfers purchase orders from SAP to Maximo Asset Management when the following conditions are met.
T T T

A Maximo PO type purchase order is completed in SAP. The vendor for the purchase order is not disabled in SAP. An inbound PO line must refer to a Maximo Purchase Requisition number or Maximo Work Order number. If a PO line does not refer to a Maximo PRLINE item, a valid POLINE LINETYPE for that item must exist in the Maximo SAPLINETYPE crossreference control. If a PO line item refers to a Maximo PR line item with a status of CLOSED, the adapter removes the PRNUM and PRLINENUM for the PO line item.

Outbound purchase orders

The integration transfers purchase orders from Maximo to SAP, when the following conditions are met:
T T T

The status of the PO is equal to a status in the POSEND control. The date of the PO falls after the date in the SAPCALSTART control. All SAP-owned POLINE items are active items in SAP Material Master, with valid SAP storage location or cost object values.

182

System Administrator Guide

Purchase order integration

T

All SAP-owned POLINE items have pre-existing SAP Purchasing and Accounting views. POLINE items with no item number are either Material or Service line types that use SAP cost objects The vendor for each POLINE item is not disabled in SAP.

When items on a PO being sent from Maximo to SAP are not SAP-owned, they are sent as miscellaneous type items, and the item numbers are not mapped to SAP.

Purchase order ownership

The integration defines an SAP-owned purchase order as one that is created and managed in SAP, and a Maximo-owned purchase order as one that is created and managed in Maximo Asset Management. The integration determines purchase order ownership by the value in the OWNERSYSID column of the Maximo PO. Purchase order ownership Owner of purchase order Maximo SAP OWNERSYSID value Null SAP1

Transfer of purchase order data from SAP to Maximo Asset Management

The following topics pertain to purchase orders inbound from SAP to Maximo Asset Management.

IDoc type EKSEKS01

The IDoc type EKSEKS01 sends SAP Purchase Orders to Maximo Asset Management.

Blanket contracts
Maximo Asset Management allows only one Blanket Contract per Purchase Order. Therefore, the integration supports only one blanket contract per purchase order.

Receipts for inbound GR non-valued PO line items

SAP does not create the Material Document, (MATRECTRANS/ SERVRECTRANS), for GR non-valued items, therefore no Receipts transaction comes from the SAP system to Maximo Asset Management. The Maximo Enterprise Adapter for SAP uses the POLINE.SAP_REC_REQ column to flag the transaction to indicate it is a non-valued item. The Maximo Enterprise Adapter for SAP checks this field during the Invoice interface to determine if a receipt must be created. For more information, see "Invoices inbound from MM logistics invoice verification," on page 12-176.
Purchasing integration

183

Purchase order integration

Transfer of purchase order revision data from SAP to Maximo Asset Management
The purchase inbound integration supports the purchase order revision feature. With this feature, you can send purchase order revision information from SAP to Maximo Asset Management. The purchase integration transfers sends purchase order revision data from SAP to Maximo Asset Management in the following way:
T

T T T

When you create a purchase order in SAP, the purchase integration sends the purchase order to Maximo Asset Management and the revision number is set to 0 in Maximo. Whenever you update the purchase order in SAP, the integration sends the updates to Maximo. Maximo creates a revision of the purchase order. When the integration sends a purchase order from SAP to Maximo Asset Management, the purchase order can have two status in Maximo: APPR (approved), which indicates that a purchase order was created and approved in SAP. REVISD (revised), which indicates that a purchase order was updated in SAP. Only one revision of a purchase order can be active at a time.

Transfer of purchase order data from Maximo Asset Management to SAP

The following statements pertain to purchase orders outbound from Maximo Asset Management to SAP.
T

Outbound purchase orders can contain purchase order lines from more than one Maximo site. Outbound purchase orders do not support multiple distributions. For more information, see "Multiple distributions outbound," on page 140. This integration does not support PO line types "Special Order" (SP ORDER) or "Standard Service" (STD SERVICE).

Transfer of purchase order revision data from Maximo Asset Management to SAP
Although the purchase outbound integration supports the purchase order revision feature, purchase order revision is not sent from Maximo Asset Management to the SAP system. SAP does not provide purchase order revision. When you create a purchase request, receipt, or invoice in SAP, Maximo Asset Management uses the most recent approved purchase order from SAP.

184

System Administrator Guide

Purchase order integration

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the purchase order integration:
T

MXPO_FRSAP05

Related Maximo publish channel

The Maximo Enterprise Adapter for SAP uses the following publish channel for the purchase order integration:
T

MXPO_TOSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the purchase order integration.
T

MXPO

Purchasing integration

185

Purchase order integration

Related interface controls

The Maximo Enterprise Adapter for SAP uses the following enterprise service and publish channel interface controls for the Purchase Order integration: Purchase order-related enterprise service interface control Interface control SAPORGID SAPSITEID SAPSTORERM SAPMX5SITEPREFIX SAPIOTYPEPREF SAPPURCHSITEID SAPLINETYPE SAPPOTYPE SAPITEMSETID Control type Cross-reference Cross-reference Cross-reference Value Cross-reference Cross-reference Cross-reference Value Cross-reference

Purchase order-related publish channel interface control Interface control SAPSTORERM SAPGLCOMP SAPGLCONCAT SAPIOTYPEPREF SAPPURCHSITEID SAPLINETYPE SAPAAC SAPCALSTART POSEND SAPQOS SAPWOOUT SAPMX5SITEPREFIX SAPORGID SAPPOTYPE SAPSITEID SAPMAXBSNAME SAPUNLIMITTOLERANCE Control type Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference Value List Cross-reference Boolean Value Cross-reference Value Cross-reference value Boolean

186

System Administrator Guide

Invoice and credit memo integration

Related SAP tables

The MEA for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo Asset Management to SAP. SAP tables related to purchase orders Table ZBC_INBPROGRAMS Processing mode BDC BAPI Description Uses Z_BC_CREATE_PURCHORDER_BDC. Uses Z_BC_CREATE_PURCHORDER_BAPI.

Invoice and credit memo integration

The invoice and credit memo integration transfers invoices between Maximo Asset Management and SAP Material Management Logistics Invoice Verification or SAP FI modules. You configure the integration to transfer invoices inbound to Maximo or outbound from Maximo depending on your business requirements. Inbound invoices The basic invoice inbound assumption is that purchasing and material management are done in the SAP system. The Maximo Enterprise Adapter for SAP has one enterprise service for inbound invoices that will handle MM invoices, FI invoices and invoice variances:
T

MXINVOICE_FRSAP05 transfers both invoices and credit memos from the SAP MM Logistics Invoice Verification module to Maximo using IDoc and batch type EKSEKS.

Outbound invoices

The basic invoice outbound assumption is that purchasing and material management are done in Maximo. Invoices are transferred from Maximo to SAP when the status of the Maximo invoice is equal to a status in the IVSEND interface control. The Maximo Enterprise Adapter for SAP has one interface for outbound invoices:
T

MXINVOICE_TOSAP05 transfers invoices from Maximo to the SAP MM Logistics Invoice Verification module using Z_BC_CREATE_MMINVOICE_BAPI, or, it transfers invoices from Maximo to the SAP FI module using the BDC method, Z_BC_CREATE_APINVOICE_BDC.

Control GL posting date behavior

Within Maximo Asset Management, an organization-level MAXVAR called UPDATEGLPSTDATE can be set to cause the vendor's invoice date to be copied to the general ledger posting date. To support this MAXVAR, a GLPOSTDATE column has been added to INVOICE records. The UPDATEGLPSTDATE setting does not affect inbound invoices from the MXINVOICE_FRSAP05 enterprise service; for inbound invoices, the SAP MM and FI posting dates are mapped to the Maximo INVOICE general ledger posting date.

Purchasing integration

187

Invoice and credit memo integration

Another organization-level MAXVAR, INVCEGLPSTDTVALSAV, allows you to choose to validate an invoice's general ledger posting date against the financial period that is open when the invoice is saved. If this MAXVAR is not set, the financial period validation takes place when the invoice is approved and paid.

Reverse invoice
Invoices, or credit and debit memos, can be reversed (cancelled) without having to return the goods or services listed on the original document. The reversal operation can be performed in either Maximo or SAP. Only approved or paid invoices, credit memos, or debit memos can be reversed. For reversed invoices from SAP, the SAPREVINVOICESTATUS integration control is used to specify the default status of a invoice that is reversed. When an approved invoice is reversed, the original invoice status changes to REVERSED. To support reverse invoice functions, the following columns have been added to INVOICE:
T

REVERSEINVOICENUM - contains the invoice number of the reversed document. T REVREASON - contains the reason that the invoice was reversed.

Invoice integration requirements

Before sending invoices between Maximo and SAP, configure the sending and receiving systems as described in the following sections. Inbound and outbound invoices Before sending invoices between Maximo and your SAP system, perform the following configurations in Maximo:
T

Define SAP Company Codes to be used in the Invoice integration in the SAPORGID interface control. Define SAP Plants to be used in the Invoice integration in the SAPSITEID interface control.

Outbound invoices only

Before sending invoices from Maximo Asset Management to SAP, perform the following configurations in Maximo:
T T T

Set up Invoice Autonumbering. Enable the integration event for outbound invoices, MXINVOICEOUT. Define the receiving SAP invoice module in the SAPAPTYPE interface control, either SAP MM Logistics Invoice Verification or SAP FI. If outbound invoices are to be sent to SAP FI, configure SAP GL account information in the Maximo SAPFIGLACCT value interface control.

Before sending Invoices from Maximo to SAP, perform the following configurations in SAP:

188

System Administrator Guide

Invoice and credit memo integration

T

Select either the batch (BDC) or BAPI input method for sending Maximo invoices to SAP (for invoices outbound)

Inbound invoice considerations

The following factors must be considered for all invoices sent from SAP to Maximo Asset Management.

Invoice credit quantity values

Maximo Asset Management uses a positive value for an invoice quantity when the invoice type is Invoice. Maximo Asset Management allows you to enter a negative value for an invoice quantity when the invoice type is credit. In an SAP system, invoice quantity is entered as a positive value when the invoice type is credit. The Maximo Enterprise Adapter for SAP converts the quantity value based on the invoice type.

Currency code handling

If the currency code of an invoice item is different from the SAP base currency code, then the Maximo Enterprise Adapter for SAP calculates the invoice unit cost with the exchange rate and sends the exchange rate to Maximo Asset Management with the invoice transaction.

Filtering
The integration transfers invoices from SAP to Maximo Asset Management when the following conditions are met:
T

For invoices referring to a purchase order, the PO number must exist in both SAP and Maximo Asset Management. For invoices referring to a work order, the WO number must exist in both SAP and Maximo Asset Management.

Purchasing integration

189

Invoice and credit memo integration

Invoices referring to PO lines with goods receipts (GR) and invoice receipts (IR)
If an SAP Invoice refers to a PO Line that is selected for Goods Receipts (GR) and Invoice Receipts (IR), send the Goods Receipts transaction to Maximo Asset Management before sending the Invoice. Otherwise, the Invoice transaction errors out in Maximo, because there is no corresponding Receipt in Maximo. SAP allows the creation of an Invoice without corresponding Goods Receipts having already taken place. However, Maximo requires the Goods Receipts transaction before it accepts the Invoice.

Invoices inbound from MM logistics invoice verification

The SAP MM Logistics Invoice Verification module sends invoices to Maximo Asset Management using Intermediate Document (IDoc) type EKSEKS.

Inbound MM invoice considerations

The following factors must be considered for invoices sent from the SAP MM Logistics Invoice Verification module to Maximo Asset Management. Required receipts Maximo Asset Management requires receipts when the Receipts Required field of a purchase order is set to yes, or when the Maximo POLINE.SAP_RECV_REQ field is set to yes. SAP may not require receipts for such transactions. If an invoice sent from SAP does not require a receipt, but Maximo does, then, based on the POLINE LINETYPE, the Maximo Enterprise Adapter for SAP creates a receipt in the following cases:
T

when the PO line item is a service with no receipt required (SERVRECTRANS) when the PO line is for a non-valuated item that has had multiple distributions in SAP (MATRECTRANS)

Invoice matching

Maximo Asset Management supports three-way matching of an invoice if the items are non-rotating and do not require inspection. Three-way matching is used when the Receipts Required field of a purchase order is set to Yes. If an invoice refers to a Maximo PO number, the Maximo Enterprise Adapter for SAP uses the PO line SITEID to look up the destination Maximo invoice site. For more information, see "Structure of purchase order numbers for outbound POs," on page 12-165. An MM invoice in SAP can contain purchase orders from multiple purchasing sites if the POs originated in Maximo Asset Management, or from multiple purchasing organizations if the POs originated in SAP. In Maximo Asset Management, an invoice can contain purchase orders whose PO lines are from multiple PO sites (PO.TOSITEIDs) if the PO sites are within the same organization. In this centralized invoicing scenario, the originating PO site ID (PO.SITEID) does not have to be the same as the invoice site ID (INVOICE.SITEID). To indicate whether you want to use centralized invoicing in Maximo, you set the SAPINVOICESITEID integration control. You can define this integration control at the system or organization level. By default, the SAPINVOICESITEID integration control is set to Null. This integration control setting indicates that the

Maximo invoice site reference

Multiple Maximo site destinations

190

System Administrator Guide

Invoice and credit memo integration

invoicing is decentralized in Maximo Asset Management. When SAPINVOICESITEID is set to Null, Maximo Enterprise Adapter for SAP uses the Maximo PO site ID as the invoice site ID. If your integration sends an invoice from SAP to Maximo Asset Management, and the invoice references PO lines from multiple Maximo originating PO site IDs, the integration splits the invoice into multiple invoices. When you specify an invoice site ID in the SAPINVOICESITEID integration control, the invoicing becomes centralized. If the invoice references PO lines from multiple Maximo originating PO site IDs, only one SAP invoice is saved in Maximo.

Invoices inbound from FI

The SAP FI accounting module sends financial invoice postings to Maximo by ABAP report ZBCXIREPR014. FI invoices are usually sent for Maximo-generated work orders.

Inbound FI invoice considerations

The following factors must be considered for invoices sent from the SAP FI module to Maximo Asset Management. Maximo work order numbers Maximo invoice site reference Invoices sent from the FI module in the SAP system to Maximo must refer to a Maximo Work Order. If an invoice refers to a Maximo WO number, the Maximo Enterprise Adapter for SAP uses the WO number prefix to look up the WO autokey for the SITEID for the invoice site.

Transferring FI invoice data from SAP to Maximo

ABAP Batch Report ZBCXIREPR014, "Download of CO Postings against Maximo Workorders," sends SAP FI invoice data to Maximo. You can run this report one or more times per day.

Batch Report ZBCXIREPR014 selection criteria

Batch Report ZBCXIREPR014 has three selection criteria:

Purchasing integration

191

Invoice and credit memo integration

ZBCXIREPR014 Selection Criteria ZBCXIREPR014 Selection Criteria Controlling Area Transaction Description Select your controlling area. Select Original CO business transaction ID RFBU (for FI Postings). Select one or a range of Maximo work order numbers.

Internal Order Number

Outbound invoices
The outbound invoice interface transfers invoices from Maximo Asset Management to SAP when the status of the invoice matches a status in the IVSEND interface control. You can send Maximo invoices to one of two different modules in an SAP system, MM Logistics Invoice Verification or FI. Outbound invoices can be sent to SAP for purchase orders that originated in Maximo and may or may not be replicated to the SAP system. You configure a Maximo Enterprise Adapter for SAP interface control, SAPAPTYPE, to send the invoice to the appropriate SAP destination module based on the following criteria:
T

If purchase orders originate in Maximo and are not replicated to SAP, send invoices to FI. If purchase orders originate in Maximo and are replicated to SAP, send invoices to MM Logistics Invoice Verification.

If purchase orders for service items without PO and POLINE numbers originate in Maximo and are replicated to SAP, and the SAPAPTYPE interface control is set to MM, the integration treats the transactions like finance invoices and send them to FI.

Outbound invoice integration requirements

Before sending invoices from Maximo Asset Management to your SAP system, perform the following configurations in SAP:
T

Select either the batch (BDC) or BAPI input method for sending Maximo Asset Management invoices to SAP.

MM invoices can use only BAPI or BDC FI invoices can use only BDC

Before sending invoices from Maximo Asset Management to your SAP system, perform the following configurations in Maximo:
T T

Set up Invoice Autonumbering at the Maximo Site level. Configure the SAP invoice type in the SAPAPTYPE interface control.
System Administrator Guide

192

Invoice and credit memo integration

T T

Define status values in the IVSEND interface control. Configure SAPAPOUT control for outbound tax journal transactions. For more information, see "Configuration of journals," on page 10-112. Ensure that the GLSOURCE interface control does NOT contain the value INVOICETRANS. For more information, see "Configuration of journals," on page 10-112. Configure the default FI GL account value in the SAPFIGLACCT value control. Define SAP Company Codes to be used in the invoice integration in the SAPORGID interface control. Define SAP Plants to be used in the invoice integration in the SAPSITEID interface control.

Purchasing integration

193

Invoice and credit memo integration

SAPAPTYPE value control

Use the SAPAPTYPE value control to identify which invoice module to send your Maximo Invoice to in the SAP system. SAPAPTYPE value control Integration scenario Purchasing (PO & Receipts) is done in Maximo and replicated to SAP. Purchasing (PO & Receipts) is done in Maximo, but not replicated to SAP. T PO is done in Maximo, but not replicated to SAP. However, Receipt is done in Maximo and sent as Receipt Journal from Maximo to SAP FI. SAP module MM Logistics Invoice Verification FI Invoice SAPAPTYPE MM* Requirement Invoice refers to PO number and PO line number

FI

* Maximo Asset Management lets you create an invoice line item without PO number and POLINE number for a service item during the creation of the invoice. If you use SAPAPTYPE MM and create the invoice line item as a service item that does not have a PO and POLINE number, then you should not merge with invoice line items that use PO and POLINE numbers.

Outbound invoice considerations

Note the following information for all invoices sent from Maximo Asset Management to SAP.

Invoice credit quantity values

Maximo Asset Management uses a positive value for an invoice quantity when the invoice type is Invoice. Maximo Asset Management allows you to enter a negative value for an invoice quantity when the invoice type is credit. In an SAP system, invoice quantity is entered as a positive value when the invoice type is credit. The Maximo Enterprise Adapter for SAP converts the quantity value based on the invoice type.

Service line items

If a Maximo service invoice line item has no PO number then this invoice must be interfaced to the SAP FI module. The Maximo Enterprise Adapter for SAP treats this transaction as an FI invoice type.

Maximo invoice number

Maximo adds a SITEID prefix value to the Invoice number using the Auto Seed functionality.

194

System Administrator Guide

Invoice and credit memo integration

Invoices outbound to MM logistics invoice verification

The basic MM Invoice outbound assumption is purchasing and receipts are done in Maximo and replicated to the SAP system. The outbound invoice integration is designed to integrate with the SAP MM Logistics Invoice Verification module using an invoice type of Invoice or Credit.

Outbound MM invoice considerations

The Maximo Enterprise Adapter for SAP MM Logistics Invoice Verification outbound integration is based on the following assumptions:
T

Maximo invoices that contain PO and PO line numbers are sent to the MM Logistics Invoice Verification module. Maximo allows the creation of a service invoice without PO and POLINE numbers. The service invoice without PO and POLINE numbers cannot be merged with an invoice with PO and POLINE numbers.

Transfer of invoice verification from Maximo Asset Management to SAP

The MM Invoice outbound data is transferred from Maximo Asset Management to SAP system using SAP R/ 3 BDC or BAPI methods.

Invoices outbound to FI
The FI Invoice outbound data is transferred from Maximo Asset Management to the SAP system by using the BDC method. The basic FI Invoice outbound assumption is purchasing and receipts are done in Maximo and not replicated to the SAP system. The outbound invoice integration is designed to integrate with the SAP FI module using an invoice type of Invoice or Credit.

SAPFIGLACCT value control

SAPFIGLACCT value control is used for the default SAP FI GL Account value. If Maximo Invoice GLDEBITACCT is null, then the adapter uses the SAPFIGLACCT value control for the GLDEBITACCT. This control is defined at the ORGID level.

Maximo invoice number

Maximo Asset Management adds the SITEID Prefix value to the Invoice number using the Auto Seed functionality.

Purchasing integration

195

Invoice and credit memo integration

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the invoice integration:
T

MXINVOICE_FRSAP05

Related Maximo publish channel

The Maximo Enterprise Adapter for SAP uses the following publish channel for the invoice integration:
T

MXINVOICE_TOSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the invoice integration.
T

MXINVOICE

Related interface controls

The Maximo Enterprise Adapter for SAP uses the following enterprise service and publish channel interface controls for the invoice integration. Invoice-related enterprise service interface controls Interface control SAPORGID SAPINVOICESTATUS SAPREVINVOICESTATUS SAPINVOICESITEID SAPSITEID SAPITEMSITEID SAPIOTYPEPREF SAPMX5SITEPREFIX Control type Cross-reference Value Value Value Cross-reference Cross-reference Cross-reference Value

196

System Administrator Guide

Invoice and credit memo integration

Invoice-related publish channels interface controls Interface control SAPORGID SAPSITEID SAPGLCOMP SAPGLCONCAT SAPAAC SAPIOTYPEPREF SAPWOOUT SAMX5SITEPREFIX SAPCALSTART SAPFIGLACCT SAPAPTYPE SAPMAXBSNAME SAPQOS IVSEND Control type Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference Cross-reference Boolean Value Value Value Value Value Cross-reference List

Related SAP tables

The MEA for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo Asset Management to SAP. SAP tables related to invoices Table ZBC_INBPROGRAMS Processing mode BAPI BAPI BDC Description Uses Z_BC_CREATE_MMINVOICE_BAPI. Uses Z_BC_CREATE_APINVOICE_BAPI. Uses Z_BC_CREATE_APINVOICE_BDC.

When you send financial invoices from SAP to Maximo Asset Management, you can use either the BAPI or the BDC processing mode.

Purchasing integration

197

Invoice variance integration

Invoice variance integration

The invoice variance integration transfers invoice variances from the MM Logistics Invoice Verification module to Maximo Asset Management. The Invoice Variance is a separate batch program that you schedule to run to synchronize the correct Invoices into Maximo Asset Management. The Invoice Variance is interfaced separately from the MM Invoice interface, because the Variance data are not available at the MM Invoice Interface time. Invoice variances are sent to Maximo Asset Management when price or quantity variances occur in invoices in SAP.

Invoice variance integration requirements

Before sending invoice variances inbound from SAP to Maximo Asset Management, perform the following configurations in Maximo:
T

Define SAP Company Codes to be used in the Invoice Variance integration in the SAPORGID interface control Define SAP Plants to be used in the Invoice Variance integration in the SAPSITEID interface control

Inbound invoice variance considerations

The following factors must be considered for all invoice variances sent from SAP to Maximo Asset Management.

Invoice credit quantity values

Maximo Asset Management uses a positive value for an invoice quantity when the invoice type is Invoice. Maximo Asset Management allows you to enter a negative value for an invoice quantity when the invoice type is credit. In an SAP system, invoice quantity is entered as a positive value when the invoice type is credit. The Maximo Enterprise Adapter for SAP converts the quantity value based on the invoice type.

Currency code handling

If the currency code of an invoice variance item is different than the SAP base currency code, then the Maximo Enterprise Adapter for SAP calculates the invoice unit cost with the exchange rate and sends the exchange rate to Maximo with the invoice variance transaction.

Receipts for PO or WO invoice variances

If an invoice variance transaction refers to a Maximo purchase order (PO) or work order (WO) number then the interface creates a MATRECTRANS receipt.

198

System Administrator Guide

Domain integration

Service items
There is no Invoice Variance for a Service Item. The MEA for SAP Applications creates Service Item Receipts in the Invoice interface using the Invoice Cost and Quantity. There are no price or quantity variances.

Maximo invoice site reference

If an invoice variance refers to a Maximo WO number, the Maximo Enterprise Adapter for SAP uses the WO number prefix to look up the WO autokey for the SITEID for the invoice variance site.

Filters
The integration transfers invoice variances from SAP to Maximo Asset Management when the following conditions are met:
T

For invoice variances referring to a purchase order, the PO number must exist in both SAP and Maximo Asset Management, and, if the PO refers to a PR number, the PR must exist in Maximo. For invoice variances referring to a work order, the WO number must exist in both SAP and Maximo.

Transfer of invoice variance data from SAP to Maximo Asset Management

The ABAP Batch Report ZBCXIREPR014, "Download of CO Postings against Maximo Workorders," sends SAP invoice variance data Maximo. You can run this report one or more times per day.

Batch report ZBCXIREPR014 selection criteria

Batch Report ZBCXIREPR014 has three selection criteria: ZBCXIREPR014 selection criteria ZBCXIREPR014 selection criteria Controlling Area Transaction Description Select your controlling area. Select Original CO business transaction ID RMRP (MM Incoming Invoice). Select one or a range of Maximo work order numbers.

Internal Order Number

Domain integration
Our standard Domain inbound interface transfers the following information from SAP to Maximo Asset Management:
Purchasing integration

199

Domain integration

SAP Material Groups SAP Purchase Groups T SAP FI GL Accounts

T

SAP ABAP reports update or insert these accounting values to the Maximo ALNDOMAIN table. These values populate value lists in the Purchase Requisition and Purchase Order applications in Maximo Asset Management. The domain integration uses the following ABAP reports:
T T

ZBCXIREPR008 for SAPMATLGRP (SAP material groups) ZBCXIREPR009 for SAPPURCHGRP (SAP purchase groups) T ZBCXIREPR011 for SAPGLACCOUNT (SAP FI GL accounts)

Fields added to MAXDOMAIN table

When the Maximo Enterprise Adapter for SAP is installed, it adds three columns to the Maximo MAXDOMAIN table. The following table describes the columns that the adapter adds to MAXDOMAIN. Columns added to Maxdomain table Columns Added to MAXDOMAIN Table SAP_MATL_GRP SAP_PURCH_GRP SAP_GLACCT

Description SAP Material Group values SAP Purchase Group values SAP FI GL account value

Type ALN ALN ALN

Lengt h 9 3 10

Material groups
SAP requires a material group value during PR/PO processing. When a Maximo PR or PO Line Type is not ITEM, a user must select the proper SAP material group before the outbound PR/PO record is saved in Maximo. The selected material group value is held in the SAP_MATL_GRP column of the Maximo PR Line or PO Line table. The integration derives the material group for an item from the SAP Material table.

Transfer of material group data from SAP to Maximo Asset Management

SAP material group data is sent to the Maximo ALNDOMAIN table by ABAP Batch Report ZBCXIREPR008, "Download Material Groups to Maximo."

200

System Administrator Guide

Domain integration

Batch report ZBCXIREPR008 selection criterion

Batch Report ZBCXIREPR008 has one selection criterion: ZBCXIREPR008 selection criterion ZBCXIREPR008 selection criterion Material Group Description Select range of material groups to be included.

Purchase groups
SAP requires a purchase group value during PR/PO processing. When a Maximo PR or PO Line Type is not ITEM, a user must select the proper SAP purchase group before the outbound PR/PO record is saved in Maximo. The selected purchase group value is held in the SAP_PURCH_GRP column of the Maximo PR Line or PO Line table.

Transfer of purchase group data from SAP to Maximo Asset Management

SAP purchase group data is sent to the Maximo ALNDOMAIN table by ABAP Batch Report ZBCXIREPR009, Download Purchasing Groups to Maximo.

Batch Report ZBCXIREPR009 selection criterion

Batch Report ZBCXIREPR009 has one selection criterion: ZBCXIREPR009 selection criterion ZBCXIREPR009 selection criterion Purchasing Group Description Select range of purchase groups to be included.

FI GL accounts
SAP requires an FI GL Account value during PR/PO processing. When a Maximo PR or PO Line Type is not ITEM, a user must select the proper SAP FI GL Account before the outbound PR/PO record is saved in Maximo. The selected FI GL Account value is held in the SAP_GLACCT column of the Maximo PR Line or PO Line table.

Transfer of FI GL account data from SAP to Maximo Asset Management

SAP FI GL Account data is sent to the Maximo ALNDOMAIN table by ABAP Batch Report ZBCXIREPR011, Download FI-G/L Accounts to Maximo Domain."

Purchasing integration

201

Domain integration

Batch Report ZBCXIREPR011 Selection Criterion

Batch Report ZBCXIREPR011 has one selection criterion: ZBCXIREPR011 selection criterion ZBCXIREPR011 Selection Criterion G/L Account Description Select range of GL accounts to be included.

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the domain integration:
T

MXDOMAIN_FRSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the domain integration:
T

MXDOMAIN

Related interface controls

The Maximo Enterprise Adapter for SAP uses the following enterprise service interface controls for the domain integration. Domain-related interface controls Interface control SAPORGID Control type Cross-reference

202

System Administrator Guide

Item and inventory integration

13

This chapter is directed to system administrators, implementation team members, and SAP and Maximo consultants. It discusses factors that to be aware of when you integrate Maximo and SAP item and inventory activity. It assumes that you are familiar with standard item and inventory processing in Maximo and material management in SAP. This chapter contains the following sections:
T T

Item and inventory integration overview Item integration T Inventory and inventory balances integration T Inventory vendor integration T Issues and receipts overview Material master data in SAP corresponds to item and inventory data in Maximo Asset Management. After you configure both products for the integration, they can exchange item and inventory data. Maximo Asset Management and SAP exchange the following types of item and inventory data:
T

Enterprise services (inbound direction) Items Inventory Inventory balances Inventory vendors Receipt Issues Returns T Publish channels (outbound direction) Receipt Issues Returns

Copyright IBM Corp. 2007, 2011

203

Item and inventory integration overview

Item and inventory integration overview

Material master data in SAP corresponds to item and inventory data in Maximo Asset Management. This section discusses the relationship between the SAP and Maximo non consignment item data and the ways in which you initiate the integration process.

SAP material master hierarchy

SAP creates multiple views of a material master record. The basic views display general data about the material, such as material number, description, and so on. The extended views display plant-level data, such as accounting, forecasting, and MRP information; and storage-level data, such as bin and shelf life information. The type and industry sector of a material determine the extended views that SAP creates for that material. SAP stores material master data in a three-level hierarchy, as shown in the following table. SAP material master data hierarchy levels Hierarchy level Client Data description General data about the material, such as material number, type, description, base unit of measure, and so on. Data specific to a material and plant combination Data specific to a material, plant, and storage location combination Corresponding views Basic Views

Plant Storage location

Extended Views Extended Views

Client, plant, and storage location level data exists for stock material, which is material that is maintained in inventory. Only client and plant level data exist for non-stock material, which is material that is not maintained in inventory. The SAP material type (MTART) field, which corresponds to the Maximo item CATEGORY field, identifies an item as a stock or non-stock material.

Item and inventory integration requirements

To use the item and inventory integration, perform the following configuration tasks:
T T

Configure the ZBC_SAPMXCONFIG table (language and plant codes) Configure the ZBC_FILTER table (parameters for filter master data) T Configure interface controls T In Maximo ensure Default Item Status is set to active at the ORGID, ITEMORGINFO, or INVENTORY level

204

System Administrator Guide

Relationship between the SAP and Maximo Asset Management item and inventory hierarchies

For more information about configuring the ZBC_SAPMXCONFIG and ZBC_FILTERS tables, see Chapter 9, Configuring the Maximo Enterprise Adapter for SAP Applications. The following table illustrates the views that apply to each level of the SAP material master hierarchy, for stock and non-stock parts. SAP material master data hierarchy Hierarchy Level Stock Material Client Plant Storage Location Basic view Extended view Extended view Available Views Non-Stock Material Basic view Extended View Not applicable

Relationship between the SAP and Maximo Asset Management item and inventory hierarchies
Maximo Asset Management stores material data at the ITEMSETID and SITEIDLOCATION levels. The ITEMSETID level contains general data about the item, while the SITEID-LOCATION level contains plant and storeroom specific data. The following table illustrates the relationship between the SAP and Maximo Asset Management item and inventory hierarchies. It lists the Maximo Asset Management tables that hold data at each level. It also provides examples of the SAP extended views whose data corresponds to the plant and storeroom level Maximo Asset Management tables.

Item and inventory integration

205

Units of measure

SAP and Maximo Asset Management item and inventory hierarchies SAP level Corresponding Maximo Asset Management level ITEMSETID Corresponding Maximo database tables ITEMORGINFO.ITEM Hold data from SAP Basic views INVENTORY Holds data from SAP MRP1, 2,3 and Purchasing views INVBALANCE Holds data from SAP MRP4 and Plant/Storeroom views

Client

Plant

SITEID

Storage Location

Location

Units of measure
Maximo Asset Management stores the issue and order units of measure of an item in the ITEM record and uses them as defaults in the INVENTORY records for the item. SAP uses three units of measure (UOM), while Maximo uses two.The following table shows how the integration maps SAP units of measure to Maximo. Units of measure mapping SAP UOM Base (MEINS) Order (BSTME) Description Unit in which a material is stocked Unit in which a material is purchased Maps to Maximo Asset Management Issue UOM Order UOM If SAP order UOM is null, map SAP UOM to Maximo order UOM Not mapped to Maximo Asset Management

Issue (AUSME)

Unit in which a material is issued from storage

If an SAP material master contains a factor for converting between base and order units of measure, the integration transfers that conversion factor to Maximo Asset Management. Although the conversion factor is used when creating or updating SAP plant-level data, the conversion factor is sent on the item interface, not the inventory interface. Quantities that the integration sends from SAP to Maximo Asset Management are in the SAP base unit of measure.

206

System Administrator Guide

Item integration

Related interface controls

The item and inventory integration uses the following interface controls: Item and Inventory-related interface controls Interface control SAPITEMSETID SAPMATLTYPE SAPNSTKROOM SAPORGID SAPSITEID SAPSTORERM Description Cross-reference Maximo ITEMSETID and SAP client ID Cross-reference SAP material type and Maximo inventory category. Dummy Maximo storeroom location for non-stock items Cross-reference SAP company code and Maximo ORGID Cross-reference Maximo site ID and SAP plant ID Cross-reference Maximo storeroom and SAP storage location

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Item integration
The creation or update of client-level material master data triggers an insert or update of the Maximo ITEM record and all INVENTORY locations associated with the item. SAP material master data is sent to Maximo by ABAP batch report ZBCXIREPR100, "Download Material Master Data to Maximo." You can also send IDOC material master inserts and updates to Maximo.

Item processing
The item CATEGORY is maintained in the Maximo organization level in ITEMORGINFO records. The column specifies whether an item is a stock item (STK), non-stocked item (NS), or a special order item (SP). Maximo uses a REORDER column in INVENTORY records to indicate whether a stock item is automatically reordered when storeroom supplies are depleted. The adapter continues to store SAP non-stock items as stock items in Maximo Asset Management by setting the CATEGORY to 'STK' and setting the REORDER flag to zero (0).

Item and inventory integration

207

Item integration

The SAP adapter uses a non-persistent column (SAP_MATERIAL_TYPE) to send the SAP material type (MTART) to Maximo Asset Management. The adapter uses the SAPNSTKROOM integration control to specify a dummy storeroom for nonstock items.

Receipt tolerances
Maximo Asset Management provides RECEIPTTOLERANCE columns on ITEM and ITEMORGINFO objects to support receipt tolerances for PO Lines. See Appendix A for the applicable mappings between SAP and Maximo ITEM messages.

Effectivity of item master data

The EXT_ACTIVE flag in the Maximo ITEM table indicates whether an item is active (value 1) or no longer exists in SAP (value 0). The integration validates this column when transactions are sent from Maximo Asset Management to SAP.

208

System Administrator Guide

Item integration

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the item integration:
T

MXITEM_FRSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the item integration:
T

MXITEM

Batch report ZBCXIREPR100 selection criteria

Batch report ZBCXIREPR100 has the following selection criteria. The report does not have any processing options; the download is a bulk load of all data that meets the selection criteria. ZBCXIREPR100 Selection criteria ZBCXIREPR100 Selection criteria Send Base View Send Extended View Material Number Description You can choose whether to send the base view, extended view, or both. You can choose zero, one, or a range of material numbers per each run of the batch report. If you do not choose a material master, the report runs for all material masters that meet the remaining selection criteria. You can choose to send all material masters within the specified plants and/or storerooms. You can choose zero, one, or a range of plants per each run of the batch report. If you do not choose a plant, the report runs for all material masters that meet the remaining selection criteria. You can choose zero, one, or a range of storerooms per each run of the batch report. If you do not choose a storeroom, the report runs for all material masters that meet the remaining selection criteria.

Send Items for given plants

Plant

Storeroom

Item and inventory integration

209

Item integration

IDOC Processing
You can send real-time material master updates to Maximo Asset Management through the IDOC MATMAS and the following function modules. Function modules for material master updates Function module name Z_BC_BAPI_MATERIAL_GET_DESC Z_BC_BAPI_MATERIAL_GET_DETAIL Description Get Material descriptions Get Material Detail informations

IDOCs for material master updates IDOC name Z_BC_B_BAPI_MATERIAL_GET_DESC Z_BC_B_BAPI_MATERIAL_GET_DETAIL Description Update material base data Update material extended data

You can use the ZBC_FILTERS table to filter the material master data that SAP sends to Maximo Asset Management. The following table shows the data that the IDOCs send to Maximo Asset Management when you create and update material master data in SAP at the client, plant, and storage location levels. IDOC data Hierarchy level Client SAP action Insert data Integration action Generates an item interface, to create a Maximo ITEM record. Generates item and inventory interfaces , to update Maximo ITEM record and all INVENTORY records for the item

Update data

210

System Administrator Guide

Item integration

Hierarchy level Plant

SAP action Insert data

Integration action Generates inventory interface, to create INVENTORY and INVCOST records For a stock item, this action occurs only if storage location extended views exist in SAP. Otherwise, the integration skips the transaction, because SAP cannot provide a storeroom location and Maximo cannot create an inventory record without a storeroom location. For a non-stock item, the integration uses the value in the SAPSTKROOM inventory control for the storeroom location.

Update data

Generates an inventory interface, to update all Maximo INVENTORY and INVCOST records, within the specified site For a stock item, generates an inventory balance interface, to create the Maximo INVBALANCE table, if plant level extended views in SAP. Not applicable to nonstock items.

Storage location

Insert data

Update data

For a stock item, generates an interface to update all Maximo INVBALANCE records with storeroom values for the item, within the specified site.

Related interface control

The item integration uses the following enterprise service interface controls:
211

Item and inventory integration

Inventory and inventory balances integration

Item-related interface controls Interface control SAPITEMSETID Description Cross-reference Maximo ITEMSETID and SAP client ID

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Inventory and inventory balances integration

The creation or update of plant-level material master data triggers an insert or update to the Maximo INVENTORY and INVCOST tables. The creation or update of storage location-level material master data triggers an insert or update to the Maximo INVBALANCE table.

Integration of plant-level data

For a stock item, an insert occurs only if storage location extended views exist in SAP. Otherwise, the integration skips the transaction, because SAP cannot provide a storeroom location and Maximo cannot create an inventory record without a storeroom location. When inserting a non-stock item, the integration uses the value in the SAPSTORERM inventory control for the storeroom location. An update to plant-level data generates an inventory interface, to update all Maximo INVENTORY and INVCOST records for the item, within the specified site. If the inbound transaction references a storeroom that does not exist in Maximo, an error occurs.

Integration of storage location-level data

For a stock item, an insert generates an inventory balance interface, to create a Maximo INVBALANCE record. An update generates an interface to update all Maximo INVBALANCE records with storeroom values for the item, within the specified site Storage location-level updates do not apply to non-stock items.

Material cost valuation

SAP maintains the standard, moving average, and previous costs of a material at the company code and plant levels. The following table describes the impact that changes to the standard cost of an item in SAP have on the INVCOST records of the item in Maximo.

212

System Administrator Guide

Inventory and inventory balances integration

Impact of SAP standard cost changes on INVCOST records Valuation level Company code level Effect of standard cost change on Maximo INVCOST Affects all INVCOST records for the item, for all plants within the organization code that corresponds to the SAP company code. Affects all INVCOST records for the item, within the site that corresponds to the SAP plant.

Plant level

The integration maps the SAP cost fields to the Maximo cost fields as follows: Cost field mapping SAP cost field source Moving average cost (VERPR) Standard cost (STPRS) previous cost (STPRV) Maximo cost field AVGCOST STDCOST LASTCOST

Receipt tolerance
Maximo Asset Management provides a RECEIPTTOLERANCE column on INVENTORY records to support receipt tolerances for PO Lines. See Appendix A for the applicable mappings between SAP and Maximo INVENTORY messages.

Item and inventory integration

213

Inventory vendor integration

Related interface controls

The item and inventory integration uses the following enterprise service interface controls: Inventory and balance-related interface controls Interface control SAPITEMSETID SAPMATLTYPE SAPNSTKROOM SAPORGID SAPSITEID SAPSTORERM Description Cross-reference Maximo ITEMSETID and SAP client ID Cross-reference SAP material type and Maximo inventory category. Dummy Maximo storeroom location for non-stock items Cross-reference SAP company code and Maximo ORGID Cross-reference Maximo site ID and SAP plant ID Cross-reference Maximo storeroom and SAP storage location

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Related Maximo enterprise services

The Maximo Enterprise Adapter for SAP uses the following enterprise services for the inventory and inventory balances integration:
T T

MXINVBAL_FRSAP05 MXINVENTORY_FRSAP05

Related Maximo object structures

The Maximo Enterprise Adapter for SAP uses the following object structures for the inventory and inventory balances integration:
T T

MXINVBAL MXINVENTORY

Inventory vendor integration

The inventory vendor interface transfers new, updated, and deleted standard purchase info data from the SAP Purchasing application to Maximo Asset Management. You initiate these actions through an ABAP program.

214

System Administrator Guide

Inventory vendor integration

SAP and Maximo integration

The SAP Purchase Info record consists of general data and purchase detail data that is used as default data for purchase orders. This data is stored at the following levels in SAP: Purchase Info data levels Level Client level Description General data Includes information about vendor, origins, unit of measure, and so on Purchase organization or plant level Purchasing detail data Includes information about prices, conditions, tolerance limits, last purchase order, and so on Purchase detail data created at the purchase organization level applies to all plants assigned to that purchase organization. During integration, the Maximo Enterprise Adapter for SAP generates an INVVENDOR record for every plant assigned to the purchase organization, that also exists in Maximo. The Maximo Enterprise Adapter for SAP generates a single transaction for detail data created at the plant level. General data and detail data are included in the same message. All purchase info record is written to an INVVENDOR record at the Maximo site level. The Maximo vendor and stock material item numbers must exist in Maximo, or an error occurs.

Transfer of purchase info data from SAP to Maximo Asset Management

SAP purchase info data is sent to the Maximo INVVENDOR table by ABAP batch report ZBCXIREPR013, "Download Purchasing Info records to Maximo.

IDOC processing
You can send real-time purchase info record updates to Maximo Asset Management through the IDOC INFREC01 and the following function module. Function modules for purchase info data IDOC name Z_BC_BAPI_INFOREC_GET_DETAIL Description Get Purchasing Inforecords

You can use ZBC_FILTERS table to filter the purchase info records data that SAP sends to Maximo.

Item and inventory integration

215

Inventory vendor integration

Batch report ZBCXIREPR013 selection criteria

Batch report ZBCXIREPR013 has the following selection criteria: ZBCXIREPR013 Selection criteria ZBCXIREPR013 Selection criteria Company Code Purchase Organization Range of Plants Range of Info records Description Choose one company code per each run of the batch report Choose one purchase organization per each run of the batch report Select a number range for the SAP Vendors to be sent to Maximo

Batch report ZBCXIREPR013 processing options

Batch Report ZBCXIREPR013 has the following processing options: ZBCXIREPR013 Processing options ZBCXIREPR013 Processing option Send all info records Description ABAP sends all purchase info records that meet the selection criteria SAP executes the ABAP report as part of a scheduled job. Send new info records ABAP sends all purchase info records that you have created or updated since the last run of the ZBCXIREPR013 report ABAP sends all purchase info records that meet the selection criteria. SAP executes the ABAP report immediately.

Send Info Records immediately

Receipt tolerance
Maximo Asset Management provides a RECEIPTTOLERANCE column on INVVENDOR records to support receipt tolerances for PO Lines. See Appendix A for the applicable mappings between SAP and Maximo INVVENDOR messages.

216

System Administrator Guide

Inventory vendor integration

Effectivity of inventory vendor data

The EXT_ACTIVE column in the INVVENDOR table indicates whether the vendor is active (value 1) or no longer exists in SAP (value 0). The integration validates this column when transactions are sent from Maximo Asset Management to SAP.

Maximo Enterprise Adapter for SAP Bulk Load Action

When you select the bulk load option, Send all info records, of the ABAP program ZBCXIREPR013, the Maximo Enterprise Adapter for SAP performs the following actions during the handling of the bulk load of purchase info record data received from SAP:
T

Sets the value of the INVVENDOR.SAP_UPDATE field to 1 (Active) for each SAP inventory vendor record included in the bulk load. Inserts the values for all Maximo Organizations associated with the incoming inventory vendor data into the Organization parameter of the Maximo cron task SAPMASTERDATAUPDATE. Sets the value of the Enabled parameter of the Maximo cron task SAPMASTERDATAUPDATE to 1.

Cron task SAPMASTERDATAUPDATE action

The Maximo cron task SAPMASTERDATAUPDATE updates INVVENDOR records in Maximo to mark the SAP vendors in the Maximo database that have been deleted and archived in SAP. When the cron task runs, it performs the following actions:
T

Resets the EXT_ACTIVE field to 0 for each record where the SAP_UPDATE field = 0 and the EXT_ACTIVE field = 1.

Whenever you run the ZBCXIREPR013 SAP bulk load program for inventory vendor records, you should next immediately run the SAPMASTERDATAUPDATE cron task. This process sets to "inactive" any Maximo records that correspond to bulk-loaded SAP records that have been archived or deleted in SAP. If you are running more than one of these bulk loads, run the cron task after the last bulk load report is run. Do not run any change or update reports while the SAPMASTERDATAUPDATE cron task is running, or errors may occur. For more information about this Cron Task, refer to the IBM Maximo Enterprise Adapter Integration.

Item and inventory integration

217

Inventory vendor integration

Fields added to INVVENDOR table

When the Maximo Enterprise Adapter for SAP is installed, it adds the following fields to the Maximo INVVENDOR table. Fields added to INVVENDOR table Field added to INVVENDOR table EXT_ACTIVE Description Indicates whether the company is an active SAP vendor. 0 = is not an active SAP vendor 1 = is an active SAP vendor SAP_UPDATE Indicates whether the vendor record has been removed from the SAP system. 0 = vendor record has been removed from SAP 1 = vendor record is active in the SAP system YORN 1 This field is updated during a run of Maximo cron task SAPMASTERDATAUPDATE. This field is updated during a run of the ABAP Batch Report ZBCXIREPR013*. * for the bulk load option only The SAP_UPDATE column in the Maximo INVVENDOR table is for internal use. Type YORN Length 1 Usage This field is mapped from SAP during a run of ABAP Batch Report ZBCXIREPR013.

Related interface controls

The inventory vendor integration uses the following enterprise service interface controls: Inventory vendor-related interface controls Interface control SAPITEMSETID SAPORGID SAPSITEID Description Cross-reference Maximo ITEMSETID value and SAP system ID/client Cross-reference Maximo organization ID and SAP company code ID Cross-reference Maximo site ID and SAP plant ID

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the inventory vendor integration:
T

MXINVVENDOR_FRSAP05

218

System Administrator Guide

Issues and receipts overview

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the inventory vendor integration:
T

MXINVVENDOR

Issues and receipts overview

The Maximo Enterprise Adapter for SAP can send real-time goods issues (inventory movement category GI) and goods receipts (movement category GR) from SAP to Maximo, and real-time receipts from Maximo to SAP.

Movement types
The integration supports the following movement types for issues and receipts. Issues and receipts movement types Integration Outbound Receipts Movement type 101 102 Inbound receipts 101 102 121 122 123 124 561 562 701 702 Description Receipt for PO Reverse receipt for PO Receipt for PO Reverse receipt for PO Receipt subsequent adjustment Return to vendor Reverse return to vendor Receipt return blocked stock Entry of first balance Reverse entry of first balance Receipt of physical inventory Issue of physical inventory

Item and inventory integration

219

Issues and receipts overview

Integration Outbound Issues

Movement type 201 202 221 222 241 242 261 262

Description Issue for cost center Reverse issue for cost center Issue for WBS Reverse issue for WBS Issue for asset Reverse issue for asset Issue for internal order Reverse issue for internal order Issue for internal order Reverse issue for internal order

Inbound Issues

261 262

IDOC processing
You can send real-time inventory movement updates to Maximo through the IDOC INVCON and the following function module. Function module for inventory movement data IDOC name Z_BC_BAPI_MATMOVE_GET_DETAIL Description Get inventory movement updates

You can use the ZBC_FILTER table to filter the issues and receipts that SAP sends to Maximo.

Receipts integration
The integration can transfer purchasing receipts against SAP-generated POs that exist in Maximo and Maximo-generated POs that exist in SAP. The Maximo Enterprise Adapter for SAP uses the line type of the related purchase order line to determine the transaction type of the interface as follows: Determining transaction type Purchase order line type ITEM or MATERIAL SERVICE or STDSRV Receipt type Material Service Transaction type MATRECTRANS SERVRECTRANS

Outbound receipts
The outbound receipt integration sends receipts or returns from Maximo to SAP when the status of the transaction is COMP (complete).

220

System Administrator Guide

Issues and receipts overview

The receipt must contain the number of a purchase order that exists in Maximo and SAP. If the OWNERSYSID of the ITEM record is not the same as the EXTERNALSYSNAME of the PO record, the integration treats the receipt as a service receipt and writes null values to the material number and storeroom fields of the outbound interface. Material receipts The Maximo Enterprise Adapter for SAP generates an outbound material receipt transaction when the status of the receipt is COMP (complete). When the status changes to COMP depends on whether the receipt is for a rotating item and whether the item requires inspection. If the receipt is for a rotating item, the outbound interface contains a null material number. The following table shows when the status of a material receipts changes to COMP and the Maximo Enterprise Adapter for SAP sends the outbound transactions: Material receipts status changes Inspection required No Rotating item No

Status changes to complete When you save a receipt ISSUETYPE = RECEIPT Receipt quantity = quantity received

No

Yes

After you receive items and you serialize all the items that you received ISSUETYPE = RECEIPT Receipt quantity = quantity received

Yes

No

After items received and inspected ISSUETYPE = TRANSFER Receipt quantity = quantity accepted If you reject any received items, Maximo generates a second transaction. ISSUETYPE = RETURN Receipt quantity = quantity rejected

Yes

Yes

After items received, inspected, and serialized: ISSUETYPE = TRANSFER Receipt quantity = quantity accepted If you reject any received items, Maximo generates a second transaction. ISSUETYPE = RETURN Receipt quantity = quantity rejected

Item and inventory integration

221

Issues and receipts overview

Service receipts

The Maximo Enterprise Adapter for SAP generates an outbound service receipt transaction when the status of the receipt is COMP (complete). When the status changes to COMP depends on whether the received item requires inspection. The following table shows when the status changes to COMP and the Maximo Enterprise Adapter for SAP sends the transaction to SAP: Outbound service receipts Inspection required? No

Integration action The integration generates a transaction when receipt is saved. ISSUETYPE = RECEIPT Receipt quantity = quantity received

Yes

Generates transaction after you receive and inspect items ISSUETYPE = RECEIPT Receipt quantity = quantity received If you reject any received items, the integration generates a second transaction. ISSUETYPE = RETURN Receipt quantity = quantity rejected

SAP Cost elements

If the REFWO field is null and the GLDEBITACCT for the PO line is not null, the Maximo Enterprise Adapter for SAP uses the values in the SAPGLCONCAT and SAPGLCONFIG interface controls to retrieve the SAP account assignment category (AAC), cost object, and business area from the GLDEBITACCT field. If the REFWO field is not null, the Maximo Enterprise Adapter for SAP may use the values in the CONCATGL and SAPGLCONFIG interface controls to retrieve the SAP internal order type from the GLDEBITACCT field. If the integration uses a single internal order type, the Maximo Enterprise Adapter for SAP retrieves that type from the SAPIOTYPEPREF control. The Maximo Enterprise Adapter for SAP assigns a movement type as follows: Movement types Receipt quantity Greater than 0 Less than 0 Movement type (BWART) 101 102

222

System Administrator Guide

Issues and receipts overview

Related interface controls

The receipts integration uses the following enterprise service and publish channel interface controls: Receipts-related enterprise service interface controls Control SAPCALSTART SAPMX5SITEPREFIX SAPORGID SAPSITEID SAPSTORERM SAPMAXBSNAME Description SAP calendar start date Value control to hold the Maximo Site ID prefix. Cross-reference Maximo organization ID and SAP company code ID Cross-reference Maximo site ID and SAP plant ID Cross-reference Maximo storeroom and SAP storage location Maximo Business System Name in SAP PI

Receipts-related publish channel interface controls Control SAPCALSTART SAPMX5SITEPREFIX SAPORGID SAPSITEID SAPSTORERM SAPMAXBSNAME SAPPOTYPE SAPQOS SAPUNLIMITTOLERAN CE Description SAP calendar start date Value control to hold the Maximo Site ID prefix. Cross-reference Maximo organization ID and SAP company code ID Cross-reference Maximo site ID and SAP plant ID Cross-reference Maximo storeroom and SAP storage location Maximo Business System Name in SAP PI SAP purchase order document type SAP Quality of Service Enforces the SAP limitation where the tolerance percentage cannot exceed 99.9%

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Inbound receipts
The inbound receipt integration sends receipts from SAP to Maximo when a receipt is created or updated in SAP and inspection, if necessary, is complete. The inbound receipts interface is designed for SAP stock materials that are used in Maximo. The PO number must be generated in SAP and the material must reside in a storage location in an SAP plant. The integration concatenates the value of the SAPIOTYPEPREF control and the Maximo work order or reservation number when it generates the receipt
Item and inventory integration

223

Issues and receipts overview

interface. The integration strips off the prefix before saving the number in Maximo. Items requiring inspection If the received material requires inspection, the inspection must take place n SAP. The integration sends only the final goods receipt transaction to Maximo. For a non-serialized item or a service receipt, Maximo generates a transfer transaction to move the item to the storeroom or direct issue entity specified on the PO line.

Related Maximo enterprise service

Maximo Enterprise Adapter for SAP Applications uses the following enterprise service for the Receipts integration:
T

MXRECEIPT_FRSAP05

Related Maximo publish channel

Maximo Enterprise Adapter for SAP Applications uses the following publish channel for the Receipts integration:
T

MXRECEIPT_TOSAP05

Related Maximo object structure

The Maximo Enterprise Adapter for SAP uses the following object structure for the receipts integration:
T

MXRECEIPT

Related SAP tables

The MEA for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo to SAP. SAP Tables related to receipts Table ZBC_INBPROGRAMS Processing mode BDC BAPI Description Uses Z_BC_CREATE_GRECEIPTS_BDC. Uses Z_BC_CREATE_GRECEIPTS_BAPI.

Issues integration
The integration can transfer issues from Maximo to SAP and from SAP to Maximo.

Outbound issues
The outbound issues integration sends issues for stock items (CATEGORY = STK) from Maximo to SAP when the status of the transaction is COMP (complete).

224

System Administrator Guide

Issues and receipts overview

The issue transaction must use the SAP material number, and a booking view must exist in SAP for that material. The value of the SAPWOOUT interface control must be 1. Goods issues require a Maximo work order or reservation number. If the issue references a reservation, that reservation must exist in SAP. The integration concatenates the value of the SAPIOTYPEPREF control and the Maximo work order or reservation number when it generates the issue interface. If the REFWO field is not null, the outbound integration processing sets the account assignment category to F. If the REWFO field is null, the outbound integration processing uses the SAPGLCOMP and SAPGLCONCAT interface controls and the GLDEBITACCT (for issues) or GLCREDITACCT (for returns) values to determine the account assignment category, cost object, and business area The Maximo Enterprise Adapter for SAP assigns a movement type as follows: Movement types AAC A Quantity Greater than 0 Less than 0 F Greater than 0 Less than 0 K Greater than 0 Less than 0 P Greater than 0 Less than 0 Movement type 241 242 261 262 201 202 221 222

Inbound issues
The outbound issues integration sends an issue transaction to Maximo when a goods issue is created or updated in SAP. The issue must be for a stock material that resides in a storage location in an SAP plant. The integration sends line cost, unit costs, and loaded costs to Maximo in the SAP base currency. SAP concatenates the value of the SAPIOTYPEPREF control and the Maximo work order or reservation number when it generates the issue interface. The integration strips off the prefix before saving the number in Maximo.

Item and inventory integration

225

Issues and receipts overview

Related interface controls

The issues integration uses the following enterprise service and publish channel interface controls: Issues-related enterprise service interface controls Interface control SAPIOTYPEPREF SAPMX5SITEPREFIX SAPITEMSETID SAPORGID SAPSITEID SAPSTORERM Description Translate SAP internal order type to SAP internal order number prefix Value control to hold the Maximo Site ID prefix. Cross-reference Maximo ITEMSETID value and SAP system ID/client Cross-reference Maximo organization ID and SAP company code ID Cross-reference Maximo site ID and SAP plant ID Cross-reference Maximo storeroom and SAP storage location

Issues-related publish channel interface controls Interface control SAPIOTYPEPREF SAPAAC SAPCALSTART SAPGLCOMP SAPGLCONCAT SAPMX5SITEPREFIX SAPORGID SAPSITEID SAPSTORERM SAPWOOUT SAPMAXBSNAME SAPQOS Description Translate SAP internal order type to SAP internal order number prefix SAP account assignment category setting SAP calendar start date SAP general ledger component settings SAP general ledger concatenation settings Value control to hold the Maximo Site ID prefix. Cross-reference Maximo organization ID and SAP company code ID Cross-reference Maximo site ID and SAP plant ID Cross-reference Maximo storeroom and SAP storage location Indicates if Maximo sends work order transactions to SAP Maximo Business System Name in SAP PI SAP Quality of Service

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

226

System Administrator Guide

Issues and receipts overview

Related Maximo enterprise service

The Maximo Enterprise Adapter for SAP uses the following enterprise service for the issues integration:
T

MXINVISSUE_FRSAP05

Related Maximo publish channel

The Maximo Enterprise Adapter for SAP uses the following publish channel for the issues integration:
T

MXINVISSUE_TOSAP05

Related Maximo object structures

The Maximo Enterprise Adapter for SAP uses the following object structures for the issues integration:
T

MXISSUE

Related SAP tables

The MEA for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo Asset Management to SAP. SAP tables related to issues Table ZBC_INBPROGRAMS Processing mode BDC BAPI Description Z_BC_CREATE_GOODISSUE_BDC Z_BC_CREATE_GOODISSUE_BAPI

Item and inventory integration

227

Issues and receipts overview

228

System Administrator Guide

Work orders and reservations

14

Maximo Asset Management and SAP can exchange the following types of work order and reservations publish channels data:
T T

Work orders Reservations

This chapter is directed to system administrators, implementation team members, and SAP and Maximo consultants. It discusses factors that you must be aware of when integrating Maximo Asset Management and SAP reservations and work orders. It assumes that you are familiar with standard work order processing in Maximo Asset Management and internal order processing in SAP. This chapter contains the following sections:
T T

Work orders and reservations overview Work order integration T Reservations integration

Copyright IBM Corp. 2007, 2011

229

Work orders and reservations overview

Work orders and reservations overview

The SAP adapter can send work orders and reservations, separately or together, from Maximo Asset Management to SAP. It sends work orders to the SAP Controlling (CO) module, and reservations to the Inventory Management (IM) module. You can send a work order to SAP with or without a reservation. If a reservation references a work order, that work order must exist in SAP. The SAP adapter provides three integration points that generate work order or reservation interfaces; interface control values determine which integration point is used. Work order and reservations interface control values Interface control values SAPRSVOUT = Y SAPWOOUT = Y SAPRSVOUT = N SAPWOOUT = Y SAPRSVOUT = Y SAPWOOUT = N Object structure MXWODETAILOUT MXINVRESOUT MXWODETAILOUT MXINVRESOUT Generated interfaces Work order and reservation Work order Reservation

Configuration of accounting data

For both work orders and reservations, the integration determines the internal order type from the SAPIOTYPEPREF interface control and it prefixes the work order number with that value. It uses the values in the CONCATGL and SAPCONFIG interface controls to determine the SAP account assignment category (AAC), cost object, and business area. For details, see Chapter 10, "Financial integration," on page 99.

Work order integration

The integration can send work orders, work order status changes, and work order deletions to SAP. The status of the work order controls the type of data that is sent to SAP. The first time that the status of a work order changes to a value in the WOSTART control, the integration sends the full work order to SAP. Depending on the value in the SAPRSVOUT control, it may also send a reservation. Depending on the values in the WOSTART control, subsequent changes to the status of the work order may result in the SAP adapter sending a status change or a deletion to SAP. If new items are added to the work order, the integration generates additional reservations, if the value of the SAPRSVOUT control is 1 (true). The integration creates the internal order at the company code level in SAP.

230

System Administrator Guide

Work order integration

Structure of work order numbers for outbound WOs

In Maximo Asset Management, the work order number (WONUM) is unique per site, but more than one Maximo site can use the same WONUM. If you implement autonumber functionality in the Maximo Organizations application for work orders to differentiate WONUMs from multiple Maximo sites, Maximo adds the Maximo SITEID prefix to the WONUM to make the WONUM unique per site and the Maximo WONUMs unique in the SAP system. If your integration does not use multiple Maximo sites, you do not need to add the site prefix. On WONUMs outbound from Maximo to an SAP system, the WONUM is a concatenation of SAP Internal Order (IO) Document Number prefix, the Maximo SITEID prefix, and the Maximo WONUM. The SAP IO Document Number prefix determines the number range assigned to the WO in SAP. If your outbound WONUM prefix is numeric, consisting of numbers rather than alphabetic characters, the SAP system adds leading zeros to the WONUM to pad the number if it has fewer than ten alphanumeric characters. The integration removes the leading zeros when the transaction returns to Maximo from SAP. If your outbound WONUM does not begin with a number, then SAP does not add leading zeros to the WONUM. For more information about configuring autonumbering for outbound work orders, see "Outbound Maximo WO number prefixes," on page 75.

Field added to WORKORDER table

When the SAP adapter is installed, it adds a column to the Maximo WORKORDER table. If this column uses only one value, then you can set the default value for the column in the database during the implementation and do not need to display it on the WORKORDER screen. If this column uses more than one value, set the value list for the Domain for this column during implementation. The following table describes the column that the adapter adds to WORKORDER. Column added to WORKORDER table Column added to WORKORDER table SAP_UPG

Description Value of 1 indicates that you originally created the work order in release 5.x. Maximo enterprise adapter for SAP R/3 4.7.

Type YORN

Len 1

Domain

Usage Outbound work orders only

Work orders and reservations

231

Work order integration

Related interface controls

The work order integrations use the following publish channel interface controls: Work order interface controls Control SAPAAC SAPGLCOMP SAPGLCONCAT SAPIOSTATUS SAPIOTYPEPREF SAPMX5SITEPREFIX SAPORGID SAPRSVOUT SAPSITEID SAPSTORERM SAPWOOUT WOSTART SAPMAXBSNAME SAPQOS SAPRSVPRIORITY Description SAP account assignment category setting SAP general ledger component settings SAP general ledger concatenation settings Cross Reference Maximo work order status and SAP internal order status Translate SAP internal order type to SAP internal order number prefix Value control to hold the Maximo Site ID prefix. Cross Reference Maximo organization ID and SAP company code ID Indicates if Maximo sends reservation transactions to SAP Cross Reference Maximo site ID and SAP plant ID Cross Reference Maximo storeroom and SAP storage location Indicates if Maximo sends work order transactions to SAP Statuses at which the integration sends work orders from Maximo to SAP Maximo Business System Name in SAP NetWeaver Process Integration 7.1/7.0 SAP Quality of Service Cross Reference Maximo Hard/Soft reservation to SAP Reservation Requirement Urgency code

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Related Maximo publish channel

The SAP adapter uses the following publish channel for the work order integration:
T

MXWODETAIL_TOSAP05

232

System Administrator Guide

Reservations integration

Related Maximo object structures

The SAP adapter uses the following object structures for the work order integration:
T T

MXWODETAIL MXWO

Related SAP tables

The MEA for SAP Applications uses the tables listed in this section only for outbound transactions from Maximo Asset Management to SAP. SAP tables related to work orders Table ZBC_INBPROGRAMS Processing mode BDC BDC BAPI Description Uses Z_BC_CREATE_WORKORDER_BDC. Uses Z_BC_UPDATE_WORKORDER_BDC. Uses Z_BC_CREATE_WORKORDER_BAPI.

Reservations integration
The SAP adapter can send reservations for stock items and direct issue items from Maximo Asset Management to the SAP Inventory Management (IM) module. A reservation can reference a Maximo work order or a cost object. If it references a work order, the work order must exist in SAP. If the work order does not already exist, you can configure the interface controls to send the work order to SAP along with the reservation. For more information, see "Work orders and reservations overview," on page 216. Items referenced in reservations transactions must meet the following criteria:
T T

Is owned by SAP. Exists in SAP. T Is active (EXT_ACTIVE in the ITEM table = 1). T A booking view for the material exists in SAP. T The value of the SAPWOOUT control = 1. The Maximo enterprise adapter assigns a movement type to the reservation as follows:

Work orders and reservations

233

Reservations integration

Movement types RESERVEDQTY quantity Greater than 0 Less than 0 F Greater than 0 Less than 0 K Greater than 0 Less than 0 P Greater than 0 Less than 0 Movement type 241 242 261 262 201 202 221 222

AAC A

Description Issue for asset Reverse issue for asset Issue for internal order Reverse issue for internal order Issue for cost center Reverse issue for cost center Issue for project Reverse issue for project

Related interface controls

The reservations integrations use the following publish channel interface controls:

234

System Administrator Guide

Reservations integration

Reservations-related interface controls Control SAPAAC SAPGLCOMP SAPGLCONCAT SAPIOTYPEPREF SAPMX5SITEPREFIX SAPORGID SAPRSVOUT SAPSITEID SAPSTORERM SAPWOOUT SAPMAXBSNAME SAPQOS SAPRSVPRIORITY Description SAP account assignment category setting SAP general ledger component settings SAP general ledger concatenation settings Translate SAP internal order type to SAP internal order number prefix Value control to hold the Maximo Site ID prefix. Cross Reference Maximo organization ID and SAP company code ID Indicates if Maximo sends reservation transactions to SAP Cross Reference Maximo site ID and SAP plant ID Cross Reference Maximo storeroom and SAP storage location Indicates if Maximo sends work order transactions to SAP Maximo Business System Name in SAP NetWeaver Process Integration 7.1/7.0 SAP Quality of Service Cross Reference Maximo Hard/Soft reservation to SAP Reservation Requirement Urgency code

For more information about interface controls, see Chapter 4, "Interface controls," on page 37.

Related Maximo publish channel

The Maximo enterprise SAP adapter uses the following publish for the Reservations integration:
T

MXINVRES_TOSAP05

Related Maximo object structures

The SAP adapter uses the following object structures for the Reservations integration:
T

MXINVRES

Related SAP tables

The SAP adaptor uses the tables listed in this section only for outbound transactions from Maximo to SAP.
Work orders and reservations

235

Reservations integration

SAP tables related to reservations Table ZBC_INBPROGRAMS Processing mode BDC BDC BDC BAPI Description Uses Z_BC_CREATE_RESERVATION_BDC. Uses Z_BC_UPDATE_RESERVATION_BDC. Uses Z_BC_DELETE_RESERVATION_BDC Z_BC_CREATE_RESERVATION_BAPI

236

System Administrator Guide

SAP to Maximo Asset Management message mapping

The mapping tables include the following message types:
T T T T T T T T T T T T T T T T T

The tables in this appendix show how fields from SAP source messages map to fields in Maximo target messages.

Contract (msg_T_SAP_CONTRACT to SyncMXPC) CO Postings (msg_T_SAP_COPOSTINGS to SyncMXINVOICE) Craft (msg_T_SAP_ACTIVITY to SyncMXCRAFT) Domain (msg_T_SAP_DOMAIN toSyncMXDOMAIN) GL Accounts (msg_T_SAP_GLACCOUNTS to msg_T_MX7_GLACCOUNTS) Inventory (msg_T_SAP_ITEMS to SyncMXINVENTORY) Inventory Balances (msg_T_SAP_ITEMS to SyncMXINVBAL) Inventory Vendor (msg_T_SAP_INFORECORD to SyncMXINVVENDOR) Invoice (msg_T_SAP_MMINV_S2M to SyncMXINVOICE) Issue (msg_T_SAP_GM to SyncMXISSUE) Items (msg_T_SAP_ITEMS to SyncMXITEM) Labor (msg_T_SAP_LM to SyncMXLABOR) Labor Hours (msg_T_SAP_LH_S2M to SyncMXEMPACT) Purchase Order (msg_T_SAP_PO_S2M to SyncMXPO) Purchase Requisition (msg_T_SAP_PR_S2M to SyncMXPR) Receipt (msg_T_SAP_GM to SyncMXRECEIPT) Vendors (msg_T_SAP_VENDORS to SyncMXVENDOR)

Contract message mapping

This table shows how fields in the SAP Contract source message map to the Maximo target message.

Copyright IBM Corp. 2007, 2011

237

Contract message mapping

Contract message mapping Field in SAP source message (msg_T_SAP_CONTRACT) EBELN BSART LIFNR WAERS WKURS KTWRT KDATB KDATE BUKRS UNIQPL SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem Mapped field in Maximo target message (SyncMXPC) CONTRACTNUM CONTRACTTYPE VENDOR CURRENCYCODE EXCHANGERATE MAXVOL STARTDATE ENDDATE ORGID SAP_UNIQUE_LEVEL OWNERSYSID SENDERSYSID SOURCESYSID BUYAHEAD REVISIONUM EBELP ERNAM MATNR MENGE MEINS AEDAT_IT LOEKZ SAKTO NETPR SenderBusinessSystem TXZ01 CONTRACTLINE.CONTRACTLINENUM CONTRACTLINE.ENTERBY CONTRACTLINE.ITEMNUM CONTRACTLINE.ORDERQTY CONTRACTLINE.ORDERUNIT CONTRACTLINE.ENTERDATE CONTRACTLINE.LINESTATUS CONTRACTLINE.SAP GLACCOUNT CONTRACTLINE.UNITCOST CONTRACTLINE.ITEMSETID CONTRACTLINE.DESCRIPTION CONTRACTLINE.LINETYPE LIFNR BUKRS WERKS CONTRACTAUTH.VENDOR CONTRACTAUTH.AUTHORGID CONTRACTAUTH.AUTHSITEID CONTRACTPURCH.CHGQTYONUSE 1 if ContractType=Blanket IC: SAPLINETYPE External system name WAPPR else APPR External system name External system name External system name 1 0 Additional mappings in external exit

238

System Administrator Guide

CO postings message mapping

Field in SAP source message (msg_T_SAP_CONTRACT)

Mapped field in Maximo target message (SyncMXPC) CONTRACTPURCH.CHGPRICEONUSE CONTRACTPURCH.CREATERREL

Additional mappings in external exit 1 if ContractType=Blanket 1

CO postings message mapping

This table shows how fields in the SAP CO postings source message map to the Maximo target message. CO postings message mapping Field in SAP source message (msg_T_SAP_COPOSTINGS) REFBN BUDAT BUDAT BUKRS LIFNR TWAER KURSF IDENT REFBN+BUKRS_GJAHR+REFBZ SenderBusinesSystem SenderBusinesSystem SenderBusinesSystem AWREF_REV BUKRS+AWORG_REV+AWREF_ REV BUKRS REFBZ MENGE WERKS REFBN+BUKRS_GJAHR+REFBZ DMBTR EBELN Mapped field in Maximo target message (syncMXINVOICE) INVOICENUM ENTERDATE INVOICEDATE ORGID VENDOR CURRENCYCODE EXCHANGERATE SAP_APTYPE EXTERNALREFID SOURCESYSID OWNERSYSID SENDERSYSID ORIGININVOICENUM REVREASON INVOICELINE.ORGID INVOICELINE.INVOICELINENUM INVOICELINE.INVOICEQTY INVOICELINE.SAP_SITEID INVOICELINE_SAP_EXTERNALREFID INVOICELINE.PRICEVAR INVOICELINE.PONUM External system name External system name External system name Additional mappings in external exit

SAP to Maximo Asset Management message mapping

239

Craft message mapping

Field in SAP source message (msg_T_SAP_COPOSTINGS) EBELP MX5PO SGTXT

Mapped field in Maximo target message (syncMXINVOICE) INVOICELINE.POLINENUM INVOICELINE.SAP_MX5PO INVOICELINE.DESCRIPTION

Additional mappings in external exit

Craft message mapping

This table shows how fields in the SAP craft source message map to the Maximo target message. Craft message mapping Field in SAP source message (msg_T_SAP_ACTIVITY) KOSTL BUKRS TXT_KOSTL Y SAP_UPDATE BULKLOAD SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem LSTAR TXT_LSTAR PRICE_FIX 0 Mapped field in Maximo target message (SyncMXCRAFT) CRAFT ORGID DESCRIPTION EXT_ACTIVE SAP_UPDATE SAP_BULKLOAD SOURCESYSID OWNERSYSID SENDERSYSID CRAFTSKILL.SKILLLEVEL CRAFTSKILL.DESCRIPTION CRAFTSKILL.STANDARDRATE CRAFTSKILL.RANK External system name External system name External system name Additional mappings in external exit

240

System Administrator Guide

Domain message mapping

Domain message mapping

This table shows how fields in the SAP domain source message map to the Maximo target message. Domain message mapping Field in SAP source message (msg_T_SAP_DOMAIN) IDENT IDENT IDENT ALN ALN VALUE KTEXT BUKRS WERKS Mapped field in Maximo target message (SyncMXDOMAIN) DOMAINID DESCRIPTION LENGTH DOMAINTYPE MAXTYPE ALNDOMAIN.VALUE ALNDOMAIN.DESCRIPTION ALNDOMAIN.ORGID ALNDOMAIN.SITEID Additional mappings in external exit

SAP to Maximo Asset Management message mapping

241

GL accounts message mapping

GL accounts message mapping

This table shows how fields in the SAP GL accounts source message map to the Maximo target message. GL accounts message mapping Field in SAP source message (msg_T_SAP_GLACCOUNTS) COACOMBINE BUKRS KOKRS WORKTYPE ACCFLAG COSTCENTER ASSET WBSELEMENT INTERNALORDER GLACCOUNT ACTTYPE BUSAREA PROFITCENTER TXT_BUKRS TXT_KOKRS TXT_WORKTYPE TXT_ACCFLAG TXT_COSTCENTER TXT_ASSET TXT_WBSELEMENT TXT_INTERNALORDER TXT_GLACCOUNT TXT_ACTTYPE TXT_BUSAREA TXT_PROFITCENTER ACTIVE ACT_BUKRS ACT_KOKRS Mapped field in Maximo target message (msg_T_MX7_GLACCOUNTS) COACOMBINE BUKRS KOKRS WORKTYPE ACCFLAG COSTCENTER ASSET WBSELEMENT INTERNALORDER GLACCOUNT ACTYPE BUSAREA PROFITCENTER TXT_BUKRS TXT_KOKRS TXT_WORKTYPE TXT_ACCFLAG TXT_COSTCENTER TXT_ASSET TXT_WBSELEMENT TXT_INTERNALORDER TXT_GLACCOUNT TXT_ACTTYPE TXT_BUSAREA TXT_PROFITCENTER ACTIVE ACT_BUKRS ACT_KOKRS Additional mappings in external exit

242

System Administrator Guide

GL accounts message mapping

Field in SAP source message (msg_T_SAP_GLACCOUNTS) ACT_WORKTYPE ACT_ACCFLAG ACT_COSTCENTER ACT_ASSET ACT_WBSELEMENT ACT_GLACCOUNT ACT_ACTYPE ACT_BUSAREA ACT_PROFITCENTER BULKLOAD SAP_UPDATE

Mapped field in Maximo target message (msg_T_MX7_GLACCOUNTS) ACT_WORKTYPE ACT_ACCFLAG ACT_COSTCENTER ACT_ASSET ACT_WBSELEMENT ACT_GLACCOUNT ACT_ACTYPE ACT_BUSAREA ACT_PROFITCENTER BULKLOAD SAP_UPDATE

Additional mappings in external exit

SAP to Maximo Asset Management message mapping

243

Inventory message mapping

Inventory message mapping

This table shows how fields in the SAP inventory source message map to the Maximo target message. Inventory message mapping Field in SAP source message (msg_T_SAP_ITEMS) MATNR BUKRS WERKS LGORT MTART BSTME MEINS PLIFZ MINBE EISBE BSTMI MABST PSTAT EKGRP MAABC LGBST VPRSV UEBTO UEBTK SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem Mapped field in Maximo target message (SyncMXINVENTORY) ITEMNUM ORGID SITEID LOCATION SAP_MATERIAL_TYPE ORDERUNIT ISSUEUNIT DELIVERYTIME MINLEVEL SSTOCK ORDERQTY MAXLEVEL SAP_MATLVIEWS SAP_PURCH_GRP ABCTYPE REORDERa COSTTYPE RECEIPTTOLERANCE RECEIPTOLORANCEb SOURCESYSID OWNERSYSID SENDERSYSID ITEMSETID STATUS VERPR STPRS STPRV BUKRS INVCOST.AVGCOST INVCOST.STDCOST INVCOST.LASTCOST INVCOST.ORGID External system name ACTIVE Additional mappings in external exit

244

System Administrator Guide

Inventory balances message mapping

a.When the SAP_MATERIALTYPE is associated with a storeroom in SAP, the INVENTORY.REORDER flag is set to true; when the SAP_MATERIALTYPE is not associated with a storeroom in SAP, the INVENTORY.REORDER flag is set to false. b.If the SAP delivery tolerance is unlimited, RECEIPTTOLERANCE is set to null.

Inventory balances message mapping

This table shows how fields in the SAP inventory balances source message map to the Maximo target message. Inventory balances message mapping Field in SAP source message (msg_T_SAP_ITEMS) MATNR BUKRS WERKS LGORT LGPBE LABST LABST Mapped field in Maximo target message (SyncMXINVBAL) ITEMNUM ORGID SITEID LOCATION BINNUM PHYSCNT CURBAL PHYSCNTDATE SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SOURCESYSID OWNERSYSID SENDERSYSID ITEMSETID Current date External system name External system name External system name External system name Additional mappings in external exit

Inventory vendor message mapping

This table shows how fields in the SAP inventory vendor source message map to the Maximo target message. Inventory vendor message mapping Field in SAP source message (msg_T_SAP_INFORECORD) MATNR BUKRS WERKS Mapped field in Maximo target message (SyncMXINVVENDOR) ITEMNUM ORGID SITEID Additional mappings in external exit

SAP to Maximo Asset Management message mapping

245

Invoice message mapping

Field in SAP source message (msg_T_SAP_INFORECORD) LIFNR MFRNR IDNLF MWSKZ 0 NETPR DATLB APLFZ ACTIVE WAERS INFNR+EKORG+WERKS RELIF MEINS ACTIVE SAP_UPDATE BULKLOAD UEBTO UEBTK SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem

Mapped field in Maximo target message (SyncMXINVVENDOR) VENDOR MANUFACTURER CATALOGCODE TAXICODE BIDPRICE LASTCOST LASTDATE PROMDELIVERYTIME ACTIVE CURRENCYCODE EXTERNALREFID ISDEFAULT ORDERUNIT EXT_ACTIVE SAP_UPDATE SAP_BULKLOAD RECEIPTTOLERANCE RECEIPTTOLERANCEa ITEMSETID SOURCESYSID OWNERSYSID

Additional mappings in external exit

External system name External system name External system name External system name

SenderBusinessSystem SENDERSYSID a.If the SAP delivery tolerance is unlimited, RECEIPTTOLERANCE is set to null.

Invoice message mapping

This table shows how fields in the SAP invoice source message map to the Maximo target message. Invoice message mapping Field in SAP source message (msg_T_SAP_MMINV_S2M) BELNR BUDAT
246

Mapped field in Maximo target message (SyncMXINVOICE) INVOICENUM GLPOSTDATE

Additional mappings in external exit

System Administrator Guide

Invoice message mapping

Field in SAP source message (msg_T_SAP_MMINV_S2M) BLDAT LIFNR WAERS KURSF BUKRS MM VGART STBLG BUKRS+STJAH+STBLG SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem

Mapped field in Maximo target message (SyncMXINVOICE) INVOICEDATE VENDOR CURRENCYCODE EXCHANGERATE ORGID SAP_APTYPE DOCUMENTTYPE ORIGININVOICENUM REVREASON SOURCESYSID OWNERSYSID SENDERSYSID STATUSDATE ENTERDATE STATUS SITEID PONUM

Additional mappings in external exit

External system name External system name External system name System date and time System date and time ENTERID POLINESITEID INVOICELINE.PONU M

BUKRS BUZEI+ZEKKN EBELN EBELP+ZEKKN ERFMG ERFME TXBHW WERKS MATNR BUKRS+GJAHR+BELNR+BUZEI+ ZEKKN MX5PO GRCOST

INVOICELINE.ORGID INVOICELINE.INVOICELINENUM INVOICELINE.PONUM INVOICELINE.POLINENUM INVOICELINE.INVOICEQTY INVOICELINE.INVOICEUNIT INVOICELINE.LINECOST INVOICELINE.SAP_SITEID INVOICELINE.ITEMNUM INVOICELINE.SAP_EXTERNALREFID INVOICELINE.SAP_MX5PO INVOICELINE.EXT_RCV_COST

SAP to Maximo Asset Management message mapping

247

Issue message mapping

Issue message mapping

This table shows how fields in the SAP issue source message map to the Maximo target message. Issue message mapping Field in SAP source message (msg_T_SAP_GM) BUKRS-MJAHR-MBLINR-ZEILE BUDAT USNAM MATNR ERFMG DMBTR WAERS KURSF WERKS LGORT AUFNR SGTXT WEMPF SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem ITYPE BUKRS Mapped field in Maximo target message (SyncMXINISSUE) EXTERNALREFID TRANSDATE ENTERBY ITEMNUM QUANTITY LINECOST CURRENCYCODE EXCHANGERATE SITEID STORELOC WONUM REQUESTNUM ISSUETO ITEMSETID SOURCESYSID OWNERSYSID SENDERSYSID ISSUETYPE ORGID UNITCOST LINECOST/ QUANTITY External system name External system name External system name External system name Additional mappings in external exit

Item message mapping

This table shows how fields in the SAP item source message map to the Maximo target message.

248

System Administrator Guide

Labor message mapping

Item message mapping Field in SAP source message (msg_T_SAP_ITEMS) MATNR LVORM SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem BSTME MEINS UMREZ/UMREN MAKTX SPRAS LOVRM Mapped field in Maximo target message (SyncMXITEM) ITEMNUM EXT_ACTIVE SOURCESYSID OWNERSYSID SENDERSYSID ITEMSETID ORDERUNIT ISSUEUNIT CONVERSION DESCRIPTION TRANS_LANGCODE EXT_ACTIVE STATUS TEXT_L.item.SPRAS TEXT_L.item.KTEXT TEXT_L.item.LTEXT UEBTO UEBTK STK L.DESC.ITEM.TRANS_LANGCODE L.DESC.ITEM.DESCRIPTION L.DESC.ITEM.DESCRIPTION_LONGDESCRI PTION RECEIPTTOLERANCE RECEIPTTOLERANCEa ITEMORGINFO.CATEGORY ACTIVE External system name External system name External system name External system name CONVERSION.FROM MEASUREUNIT CONVERSION.TOME ASUREUNIT CONVERSION.CONV ERSION Additional mappings in external exit

UEBTO ITEMORGINFO.RECEIPTTOLERANCE a.If the SAP delivery tolerance is unlimited, RECEIPTTOLERANCE is set to null.

Labor message mapping

This table shows how fields in the SAP labor source message map to the Maximo target message.

SAP to Maximo Asset Management message mapping

249

Labor message mapping

Labor message mapping Field in SAP source message (msg_T_SAP_LM) PERNR BUKRS STATUS SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem KOSTL LSTAR Mapped field in Maximo target message (SyncMXLABOR) LABORCODE ORGID STATUS SOURCESYSID OWNERSYSID SENDERSYSID LABORCRAFTRATE.CRAFT LABORCRAFTRATE.SKILLLEVEL LABORCRAFTRATE.INHERIT LABORCRAFTRATE.DEFAULTCRAFT LIFNR CNAME VORNA NACHN TITEL GBDAT BEGDA STRAS ORT01 STATE LANDI PSTLZ SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem LABORCRAFTRATE.VENDOR PERSON.DISPLAYNAME PERSON.FIRSTNAME PERSON.LASTNAME PERSON.TITLE PERSON.BIRTHDATE PERSON.HIREDATE PERSON.ADDRESSLINE1 PERSON.CITY PERSON.STATEPROVINCE PERSON.COUNTRY PERSON.POSTALCODE PERSON.SOURCESYSID PERSON.OWNERSYSID PERSON.SENDERSYSID External system name External system name External system name 1 0 Additional mappings in external exit

250

System Administrator Guide

Labor hours mapping

Labor hours mapping

This table shows how fields in the SAP labor hours source message map to the Maximo target message. Labor hours message mapping Field in SAP source message (msg_T_SAP_LH_S2M) WORKDATE WORKDATE WORKDATE PERNR SKOSTL CHOURS_NOR ERNAM ERSDA BEGUZ ENDUZ TRANSTYPE BUKRS WERKS RAUFNR LSTAR COUNTER SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem Mapped field in Maximo target message (SyncMXEMPACT) TRANSDATE STARTDATE FINISHDATE LABORCODE CRAFT REGULARHRS ENTERBY ENTERDATE STARTTIME FINISHTIME TRANSTYPE ORGID SITEID REFWO SKILLLEVEL EXTERNALREFID SOURCESYSID OWNERSYSID SENDERSYSID PAYRATE LINECOST External system name External system name External system name LABORCRAFTRATE Mbo.RATE LABORCRAFTRATE Mbo.RATE * REGULARHRS Additional mappings in external exit

SAP to Maximo Asset Management message mapping

251

Purchase order message mapping

Purchase order message mapping

This table shows how fields in the SAP purchase order source message map to the Maximo target message. Purchase order message mapping Field in SAP source message (msg_T_SAP_PO_S2M) EBELN LIFNR WAERS WKURS EKORKG BUKRS BEDAT KONNR SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem MX5PO Mapped field in Maximo target message (SynicMXPO) PONUM VENDOR CURRENCYCODE EXCHANGERATE SAP_PURCH_ORG ORGID ORDERDATE CONTRACTREFNUM SOURCESYSID OWNERSYSID SENDERSYSID SAP_MX5PO POTYPE EBELP+ZEKKN EINDT MATNR MENGE MEINS TXZ01 AUFNR BANFN BNFPO WERKS LGORT NETPR LOEKZ WEPOS+WEUNB SAKTO POLINE.POLINENUM POLINE.VENDELIVERYDATE POLINE.ITEMNUM POLINE.ORDERQTY POLINE.ORDERUNIT POLINE.DESCRIPTION POLINE.REFWO POLINE.PRNUM POLINE.PRLINENUM POLINE.TOSITEID POLINE.STORELOC POLINE.UNITCOST POLINE.SAP_POLINE_ACTIVE POLINE.SAP_RECV_REQ POLINE.SAP_GLACCT REL or STD External system name External system name External system name Additional mappings in external exit

252

System Administrator Guide

Purchase requisition mapping

Field in SAP source message (msg_T_SAP_PO_S2M) SenderBusinessSystem ERNAM WEPOS KTPNR UEBTO UEBTK

Mapped field in Maximo target message (SynicMXPO) POLINE.ITEMSETID POLINE.ENTERBY POLINE.RECEIPTREQD POLINE.CONTREFLINEID POLINE.RECEIPTTOLERANCE POLINE.RECEIPTTOLERANCEa POLINE.BUYAHEAD POLINE.LINETYPE POLINE.CONTRACTREFID POLINE.CONTRACTREFREV POLINE.CONTREFLINEID

Additional mappings in external exit

0 IC:SAPLINETYPE Contract Mbo. CONTRACTID Contract Mbo. CONTRACTREFREV Contract Mbo. CONTRACTLINEID

a.If the SAP delivery tolerance is unlimited, RECEIPTTOLERANCE is set to null.

Purchase requisition mapping

This table shows how fields in the SAP purchase requisition source message map to the Maximo target message. Purchase requisition message mapping Field in SAP source message (msg_T_SAP_PR_S2M) BANFN STATUS SDATE BUKRS WERKS Mapped field in Maximo target message (SyncMXPR) PRNUM STATUS STATUSDATE ORGID SITEID STATUSIFACE 1 Additional mappings in external exit

SAP to Maximo Asset Management message mapping

253

Receipt message mapping

Receipt message mapping

This table shows how fields in the SAP receipt source message map to the Maximo target message. Receipt message mapping Field in SAP source message (msg_T_SAP_GM) BUKRS+MJAHR+MBLINR+ZEILE BUDAT EBELN EBELP+ZEKKN MATNR ERFMG ERFME ERFMG ERFMG ERFMG WAERS KURSF WERKS LGORT SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem AUFNR ITYPE BUKRS Mapped field in Maximo target message (SyncMXRECEIPT) EXTERNALREFID TRANSDATE PONUM POLINENUM ITEMNUM QUANTITY RECEIVEDUNIT RECEIPTQUANTITY ACCEPTEDQUANTITY QTYTORECEIVE CURRENCYCODE EXCHANGERATE SITEID TOSTORELOC ITEMSETID SOURCESYSID OWNERSYSID SENDERSYSID REFWO ISSUETYPE ORGID REJECTQUANTITY SAP_CREATEREC MX5PO GRCOST BUKRS+SJAHR+SMBLN+SMBLP SAP_MX5PO EXT_RCV_COST ORGRCVEXTERNALREFID External system name External system name External system name External system name Additional mappings in external exit

254

System Administrator Guide

Vendor mapping

Vendor mapping
This table shows how fields in the SAP vendor source message map to the Maximo target message. Vendor message mapping Field in SAP source message (msg_T_SAP_VENDORS) BULKLOAD LIFNR V NAME1 STRAS ORT01 REGIO PSTLZ TELF1 INCO2 INCO1 ZTERM TELFX WAERS LFURL BANKL + BANKN BUKRS SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem SenderBusinessSystem ACTIVE CONTACT.CNAME CONTACT.POSIT CONTACT.PHONE CONTACT.TELFX CONTACT.EMAIL Mapped field in Maximo target message (SyncMXVENDOR) SAP_BULKLOAD COMPANY TYPE NAME ADRESS1 ADRESS2 ADRESS3 ADRESS4 PHONE FOB FREIGHTTERMS PAYMENTTERMS FAX CURRENCYCODE HOMEPAGE BANKNUM ORGID OWNERSYSID SENDERSYSID COMPANYSETID SOURCESYSID EXT_ACTIVE COMPCONTACT.CONTACT COMPYCONTACT.POSITION COMPCONTACT.VOICEPHONE COMPCONTACT.FAXPHONE COMPCONTACT.EMAIL COMPCONTACT.ORGID External system name External system name External system name External system name Additional mappings in external exit

SAP to Maximo Asset Management message mapping

255

Vendor mapping

Field in SAP source message (msg_T_SAP_VENDORS)

Mapped field in Maximo target message (SyncMXVENDOR) COMPCONTACT. SOURCESYSID COMPCONTACT.OWNERSYSID COMPCONTACT.SENDERSYSID

Additional mappings in external exit External system name External system name External system name

SAP_UPDATE

SAP_UPDATE

256

System Administrator Guide

Maximo Asset Management to SAP message mapping

The mapping tables include the following message types:
T T T T T T T T T T

The tables in this appendix show how fields from Maximo source messages map to fields in SAP target messages.

GL posting (PublishMXGLTXN to msg_T_SAP_GLINVOICE) FI invoice (PublishMXINVOICE to msg_T_SAP_GLINVOICE) MM invoice (PublishMXINVOICE to msg_T_SAP_MMINV_M2S) Issue (PublishMXINISSUE to msg_T_SAP_ISSUE) Labor hours (PublishMXEMPACT to msg_T_SAP_LH_M2S) Purchase order (PublishMXPO to msg_T_SAP_PO_M2S) Purchase requisition (PublishMXPR to msg_T_SAP_PR_M2S) Receipts (PublishMXRECEIPT to msg_T_SAP_RECEIPTS) Reservation (PublishMXINVRES to msg_T_SAP_RESERVATION) Work order (PublishMXWODETAIL to msg_T_SAP_WO)

GL posting message mapping

The following table shows how fields in the GL source message map to the SAP target message. Field in Maximo source message (PublishMXGLTXN) MICGL ACTUALDATE TRANSDATE ORGID CURRENCYCODE SAP_GLACCOUNT_DB Mapped field in sap target message (msg_T_SAP_GLINVOICE) MIDENT MBUDAT MBLDAT MBUKRS MWAERS MNEWKO

Copyright IBM Corp. 2007, 2011

257

FI invoice message mapping

Field in Maximo source message (PublishMXGLTXN) SAP_GLACCOUNT_CR LINECOST LINECOST SAP_COSTOBJ_DB SAP_COSTOBJ_DB SAP_COSTOBJ_DB SAP_COSTOBJ_CR SAP_COSTOBJ_CR SAP_COSTOBJ_CR SAP_AAC_DB SAP_AAC_CR SOURCEMBO SOURCEMBO

Mapped field in sap target message (msg_T_SAP_GLINVOICE) MNEWKO1 MWRBTR MWRBTR1 MKOSTL MAUFNR MPSPNR MKOSTL1 MAUFNR1 MPSPNR1 MKNTTP MKNTTP1 MGLVOR MBLART

FI invoice message mapping

The following table shows how fields in the FI source message map to the SAP target message. Field in Maximo source message (PublishMXINVOICE) MICFI INVOICENUM INVOICEDATE ORGID CURRENCYCODE EXCHANGERATE DOCUMENTTYPE TOTALTAX1 VENDOR TOTALCOST TOTALCOST(+/-) GLPOSTDATE Mapped field in SAP target message (msg_T_SAP_GLINVOICE) MIDENT MINVNR MBLDAT MBUKRS MWAERS MKURSF MRECHN MWMWST MLIFNR MWRBTR1 MBLART MBUDAT

258

System Administrator Guide

MM invoice message mapping

Field in Maximo source message (PublishMXINVOICE) RFBU DESCRIPTION INVOICELINE.INVOICELINENUM INVOICELINE.TAX1CODE INVOICELINE.DESCRIPTION INVOICELINE.INVOICECOST.SAP_AAC INVOICELINE.INVOICECOST.SAP_COSTOBJ INVOICELINE.REFWO INVOICELINE.INVOICECOST.SAP_COSTOBJ INVOICELINE.INVOICECOST.SAP_GLACCT INVOICELINE.INVOICECOST.LINECOST

Mapped field in SAP target message (msg_T_SAP_GLINVOICE) MGLVOR MBKTXT MINVPO MMWSKZ MSGTXT MKNTTP MKOSTL MAUFNR MPSPNR MNEWKO MWRBTR

MM invoice message mapping

The following table shows how fields in the MM message map to the SAP target message. Field in Maximo source message (PublishMXINVOICE) MICMM INVOICENUM INVOICEDATE ORGID GLPOSTDATE CURRENCYCODE EXCHANGERATE INVOICENUM VENDOR DOCUMENTTYPE TOTALTAX1, INCLUSIVE1 TOTALCOST INVOICELINE.PONUM INVOICELINE.POLINENUM Mapped field in SAP Target Message (msg_T_SAP_MMINV_M2S) MIDENT MXBLNR MBLDAT MBUKRS MBUDAT MWAERS MKURSF MXBLNR MKONTO MRECHN MWMWST1 MWRBTR MEBELN MEBELP

Maximo Asset Management to SAP message mapping

259

Issue message mapping

Field in Maximo source message (PublishMXINVOICE) INVOICELINE.TAX1CODE INVOICELINE.DESCRIPTION INVOICELINE.LINECOST INVOICELINE.INVOICEQTY INVOICELINE.INVOICEUNIT

Mapped field in SAP Target Message (msg_T_SAP_MMINV_M2S) MMWSKZ1 MSGTXT MWRBTX MMENGE MBSTME

Issue message mapping

The following table shows how fields in the issue source message map to the SAP target message. Field in Maximo source message (PublishMXINVISSUE) MISU ACTUALDATE TRANSDATE SITEID STORELOC SAP_COSTOBJ SAP_COSTOBJ SAP_COSTOBJ ISSUETO ITEMNUM QUANTITY REQUESTNUM WONUM SAP_AAC Mapped field in SAP target message (msg_T_SAP_ISSUE) MIDENT MBLDAT MBUDAT MWERKS MLGORT MKOSTL MPS_PSP_PNR MANLN1 MWEMPF MMATNR MERFMG MSGTXT MAUFNR MFLAG

260

System Administrator Guide

Labor hours message mapping

Labor hours message mapping

The following table shows how fields in the labor hours source message map to the SAP target message. Field in Maximo source message (PublishMXEMPACT) MLPY1 ORGID ENTERDATE TRANSDATE CRAFT SKILLLEVEL REGULARHRS REFWO Mapped field in SAP target message (msg_T_SAP_LH_M2S) MIDENT MBUKRS MBLDAT MBUDAT MSKOST MLSTAR MLVBSU MEAUFN

Purchase order message mapping

The following table shows how fields in the purchase order source message map to the SAP target message. Field in Maximo source message (PublishMXPO) ACTION SAP_POTYPE SAP_PURCH_ORG PONUM VENDOR CHANGEBY SITEID CURRENCYCODE STATUS ORDERDATE POLINE.ITEMNUM POLINE.DESCRIPTION POLINE.SAP_PURCH_GRP POLINE.SAP_AAC Mapped field in SAP target message (msg_T_SAP_PO_M2S) MIDENT MBSART MEKORG MBSTNR MLIFNR MAFNAM MEKORG MWAERS MSTATUS MBEDAT MEMATN MTXZ01 MEKGRP MKNTTP

Maximo Asset Management to SAP message mapping

261

Purchase order message mapping

Field in Maximo source message (PublishMXPO) POLINE.ORDERUNIT POLINE.RECEIPTTOLERANCEa POLINE.RECEIPTTOLERANCE POLINE.SAP_MATL_GRP POLINE.TOSITEID POLINE.STORELOC POLINE.ORDERQTY POLINE.REQDELIVERYDATE POLINE.UNITCOST POLINE.UNITCOST POLINE.SAP_COST_OBJ POLINE.SAP_COST_OBJ POLINE.SAP_COST_OBJ POLINE.SAP_GLACCT POLINE.SHIPTO POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.DESCRIPTION_LONGDESCRIPTION POLINE.CATALOGCODE POLINE.REFWO POLINE.POLINENUM

Mapped field in SAP target message (msg_T_SAP_PO_M2S) MMEINS MUEBTK MUEBTO MMATKL MWERKS MLGORT MMENGE MEEIND MNETPR MPREIS MKOSTL MANLN1 MPSPNR MSAKTO MABLAD MTEXT1 MTEXT2 MTEXT3 MTEXT4 MTEXT5 MTEXT6 MTEXT7 MTEXT8 MTEXT9 MTEXT10 MIDNLF MAUFNR MBSTPO

POLINE.RECEIPTRQD MWEPOS a.If POLINE.RECEIPTTOLEANCE is null, the SAP PO line is marked Unlimited % (UEBTK); otherwise it is marked Over % (UEBTO).

262

System Administrator Guide

Purchase requisition message mapping

Purchase requisition message mapping

The following table shows how fields in the purchase requisition source message map to the SAP target message. Field in Maximo source message (PublishMXPR) MPRI SAP_PRTYPE PRNUM SITEID VENDOR REQUESTEDBY CURRENCYCODE DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION PRLINE.PRLINENUM PRLINE.PRLINENUM PRLINE.ITEMNUM PRLINE.DESCRIPTION PRLINE.SAP_PURCH_GRP PRLINE.SAP_AAC PRLINE.ORDERUNIT PRLINE.SAP_MATL_GRP PRLINE.STORELOC PRLINE.ORDERQTY PRLINE.REQDELIVERYDATE PRLINE.REFWO Mapped field in SAP target message (msg_T_SAP_PR_M2S) MIDENT MBSART MBANFN MWERKS MLIFNR MAFNAM MWAERS MHTEXT1 MHTEXT2 MHTEXT3 MHTEXT4 MHTEXT5 MHTEXT6 MHTEXT7 MHTEXT8 MHTEXT9 MHTEXT10 MBNFPO MBNFPO MMATNR MTXZ01 MEKGRP MKNTTP MMEINS MMATKL MLGORT MMENGE MEEIND MAUFNR

Maximo Asset Management to SAP message mapping

263

Receipts message mapping

Field in Maximo source message (PublishMXPR) PRLINE.UNITCOST PRLINE.SAP_COSTOBJ PRLINE.SAP_COSTOBJ PRLINE.SAP_COSTOBJ PRLINE.SAP_GLACCT PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.DESCRIPTION_LONGDESCRIPTION PRLINE.RECEIPTREQD

Mapped field in SAP target message (msg_T_SAP_PR_M2S) MPREIS MKOSTL MANLN1 MPSPNR MSAKTO MTEXT1 MTEXT2 MTEXT3 MTEXT4 MTEXT5 MTEXT6 MTEXT7 MTEXT8 MTEXT9 MTEXT10 MWEPOS

Receipts message mapping

The following table shows how fields in the receipts source message map to the SAP target message. Field in Maximo source message (PublishMXRECEIPT) MRCVI TRANSDATE TRANSDATE PONUM POLINENUM SITEID TOSORELOC RECEIPTQUANTITY RECEIVDUNIT Mapped field in SAP target message (msg_T_SAP_RECEIPTS) MIDENT MBLDAT MBUDAT MEBELN MEBELP MWERKS MLGORT MERFMG MERFME

264

System Administrator Guide

Reservation message mapping

Field in Maximo source message (PublishMXRECEIPT) SAP_CREATEREC ITEMNUM MATRECTRANSID SERVRECTRANSID RECEIPTREF

Mapped field in SAP target message (msg_T_SAP_RECEIPTS) MAUTOREV MMATNR MXTRANSID MXTRANSID MXTRANSREFID

Reservation message mapping

The following table shows how fields in the reservation source message map to the SAP target message. Field in Maximo source message (PublishMXINVRES) Action WONUM REQUIREDDATE STORELOCSITEID ISSUETO ITEMNUM LOCATION RESERVEDQTY REQUESTNUM SAP_AAC SAP_COSTOBJ SAP_COSTOBJ SAP_COSTOBJ X RESTYPE converted by SAPRSVPRIORITY cross reference control Mapped field in SAP target message (msg_T_SAP_RERVATION) MIDENT MAUFNR MRSDAT MWERKS MWEMPF MMATNR MLGORT MERFMG MSGTXT MFLAG MKOSTL MANLN1 MPSPNR MXWAOK MPRIO_URG

Maximo Asset Management to SAP message mapping

265

Work order message mapping

Work order message mapping

The following table shows how fields in the work order source message map to the SAP target message. Field in Maximo source message (PublishMXWODETAIL) Action WONUM STATUS DESCRIPTION ORGID SITEID SCHEDSTART SCHEDFINISH DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION DESCRIPTION_LONGDESCRIPTION SAP_IOTYPE SAP_AAC SAP_COSTOBJ SAP_COSTOBJ SAP_COSTOBJ SAP_COSTOBJ PER PARENT Mapped field in SAP target message (msg_T_SAP_WO) MIDENT MAUFNR MASTNR MKTEXT MBUKRS MWERKS MPDAT1 MPDAT2 MTEXT1 MTEXT2 MTEXT3 MTEXT4 MTEXT5 MTEXT6 MTEXT7 MTEXT8 MTEXT9 MTEXT10 MAUART MFLAG MKOSTL MANLN1 MPS_PSP_PN MAUFNR2 MPERBZ MANFAUFNR

266

System Administrator Guide

SAP ABAP Programs

This appendix lists SAP ABAP programs and function modules.

SAP ABAP reports

The following table lists SAP ABAP reports and their descriptions.
ABAP report name Description

ZBC_BAPIADMIN ZBC_INVSENT_REORG ZBCXIREPR001 ZBCXIREPR002 ZBCXIREPR003 ZBCXIREPR005 ZBCXIREPR006 ZBCXIREPR007 ZBCXIREPR008 ZBCXIREPR009 ZBCXIREPR011 ZBCXIREPR012 ZBCXIREPR013 ZBCXIREPR014 ZBCXIREPR100 ZBCXIREPR150 ZBCXIREPR160 ZBCXIREPR170

Maximo to SAP BAPICall Administration Reorganize table ZBC_INVSENT Download Cost Centers to Maximo Download Assets to Maximo Download WBS-Elements to Maximo Download PR Status Update to Maximo Download FI-G/L Accounts to Maximo GL Account Download Vendor Master to Maximo Download Material Groups to Maximo Download Purchasing Groups to Maximo Download FI-G/L Accounts to Maximo to Maximo Domain Download Internal Order to Maximo Download Purchasing Info Records to Maximo Download of CO Posting against Maximo Work Orders (Invoice Variance) Download Material Master data to Maximo Download Time Sheets to Maximo Download Labor Time Sheets to Maximo Download Cost Centers, Activities, and Prices to Maximo Craft

Copyright IBM Corp. 2007, 2011

267

SAP function modules

SAP function modules

The following tables show SAP Applications function modules that the Maximo Enterprise Adapter for SAP Applications uses.

Function modules for the direction SAP to Maximo

The following table lists SAP function modules that SAP uses to filter data with the table ZBC_FILTERS, when sending transactions to Maximo.
Interface Function module name Description

Contracts inbound MM Invoices inbound Labor inbound Items inbound Items, Inventories, Inventory Balances inbound Issues, Receipts inbound Purchase Orders inbound

Z_BC_BAPI_CONTRACT_GET_DETAIL Z_BC_BAPI_INVOICE_GET_DETAIL Z_BC_BAPI_LABOR_GET_DETAIL Z_BC_BAPI_MATERIAL_GET_DESC Z_BC_BAPI_MATERIAL_GET_DETAIL Z_BC_BAPI_MATMOVE_GET_DETAIL Z_BC_BAPI_PO_GET_DETAIL Z_BC_BAPI_MESSAGEFILTER Z_BC_BAPI_VENDOR_GET_DETAIL Z_BC_BAPI_INFOREC_GET_DETAIL

Gets Contract details data Gets MM Invoice details data Gets Labor details data from SAP HR Gets all descriptions for Material information Gets Material details data Gets Goods Receipts details data Gets PO details data Filters the data to be sent out from SAP Get Vendor Detail data Get Info record details

Vendors Inbound Purchase info Records

Function modules for the direction Maximo Asset Management to SAP

The following table lists SAP function modules that SAP uses to filter data with the table ZBC_FILTERS, when receiving transactions from Maximo Asset Management. Interface Journal Entries outbound Issues outbound FI Invoices outbound BDC function module Z_BC_CREATE_GLPOSTING_BDC Z_BC_CREATE_GOODISSUE_BDC Z_BC_CREATE_APINVOICE_BDC BAPI function module Z_BC_CREATE_GLPOSTING_BAPI Z_BC_CREATE_GOODISSUE_BAPI Z_BC_CREATE_APINVOICE_BAPI

268

System Administrator Guide

SAP function modules

Interface MM Invoices outbound Labor Time Reporting outbound to SAP CO Purchase Orders outbound Purchase Order Updates outbound Purchase Requisitions outbound Receipts outbound Reservations outbound Work Orders/ Reservations outbound

BDC function module

BAPI function module Z_BC_CREATE_MMINVOICE_BAPI

Z_BC_CREATE_LABORHOURS_BDC

Z_BC_CREATE_LABORHOURS_BAPI

Z_BC_CREATE_PURCHORDER_BDC Z_BC_UPDATE_PURCHORDER_BDC Z_BC_CREATE_PURCHASEREQ_BDC

Z_BC_CREATE_PURCHORDER_BAPI Z_BC_UPDATE_PURCHORDER_BAPI Z_BC_CREATE_PURCHASEREQ_BAPI Z_BC_CREATE_PURCHASEREQ_N_BAPI

Z_BC_CREATE_GRECEIPTS_BDC Z_BC_CREATE_RESERVATION_BDC Z_BC_DELETE_RESERVATION_BDC Z_BC_UPDATE_RESERVATION_BDC Z_BC_CREATE_WORKORDER_BDC Z_BC_UPDATE_WORKORDER_BDC

Z_BC_CREATE_GRECEIPTS_BAPI Z_BC_CREATE_RESERVATION_BAPI

Z_BC_CREATE_WORKORDER_BAPI

SAP ABAP Programs

269

SAP function modules

270

System Administrator Guide

SAP ABAP structures for IDOC transaction filtering

D
Description MAXIMO - link: transaction identifier Purchase requisition number Item number of purchase requisition Purchasing document number Item delivery date Account number of vendor or creditor Purchasing organization Purchase order quantity Order unit Item number of purchasing document Material number Plant Storage location Net price Purchase order date Short text Number of PO account assignment Order number Goods receipt indicator

This appendix includes the SAP ABAP structures used for the filtering table, ZBC_FILTERS. This appendix does not include all SAP ABAP structures.

ZBC_S2M_PurchaseOrder
The following table lists the fields that can be used to filter purchase order data. Field IDENT BANFN BNFPO EBELN EINDT LIFNR EKORG MENGE MEINS EBELP MATNR WERKS LGORT NETPR BEDAT TXZ01 ZEKKN AUFNR WEPOS Comptype ZIDENT BANFN BNFPO EBELN EINDT LIFNR EKORG BSTMG BSTME EBELP MATNR WERKS_D LGORT_D NETPR BEDAT TXZ01 BEKKN AUFNR WEPOS Datatype CHAR CHAR NUMC CHAR DATS CHAR CHAR QUAN UNIT NUMC CHAR CHAR CHAR CURR DATS CHAR NUMC CHAR CHAR Length 5 10 5 10 8 10 4 13 3 5 18 4 4 11 8 40 2 12 1 Dec 0 0 0 0 0 0 0 3 0 0 0 0 0 2 0 0 0 0 0

Copyright IBM Corp. 2007, 2011

271

ZBC_S2M_PurchaseOrder

Field WEUNB EXNUM WAERS WKURS LOEKZ SAKTO BEDNR KNTTP MATKL EKGRP KOSTL POSID ABLAD WEMPF AEDAT_IT ERNAM INCO1 ZTERM AEDAT_HD LABNR WEBRE KONNR KDATB KDATE BUKRS BSART KTPNR KT_BSART UNIQPL KTWRT

Comptype WEUNB EXNUM WAERS EDI5402_A LOEKZ SAKTO BEDNR KNTTP MATKL EKGRP KOSTL POSID ABLAD WEMPF AEDAT ERNAM INCO1 DZTERM AEDAT LABNR WEBRE KONNR KDATB KDATE BUKRS BSART KTPNR BSART CHAR1 KTWRT

Datatype CHAR CHAR CUKY CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS CHAR CHAR CHAR DATS CHAR CHAR CHAR DATS DATS CHAR CHAR NUMC CHAR CHAR CURR

Length 1 10 5 12 1 10 10 1 9 3 10 2 25 12 8 12 3 4 8 20 1 10 8 8 4 4 5 4 1 15

Dec 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 2

Description "Goods receipt, non-valuated" Number of foreign trade data in MM and SD documents Currency Exchange rate Asset class marked for deletion Cost element Requirement tracking number Account assignment category Material group Purchasing group Cost center Relative day in period Unloading point Goods recipient/ship-to party Date of last change Name of person who created the object Incoterms (part 1) Terms of payment key Date of last change Order acknowledgment number Indicator: GR-based invoice verification Number of principal purchase agreement Start of validity period End of validity period Company code Order type (purchasing) Item number of principal purchase agreement Order type (purchasing) Single-character flag Cumulative planned value

272

System Administrator Guide

ZBC_S2M_MMINVOICE

Field KT_BSART UNIQPL KTWRT MAXIMOPO MX5PO MWSKZ UNTTO UEBTO UEBTK

Comptype BSART CHAR1 KTWRT1 CHAR1 CHAR1 MWSKZ UNTTO UEBTO UEBTK

Datatype CHAR CHAR CURR CHAR CHAR CHAR DEC DEC CHAR

Length 4 1 15 1 1 2 3 3 1

Dec 0 0 2 0 0 0 1 1 0

Description Order type (purchasing) Single-character indicator Cumulative planned value Single-character indicator Single-character indicator Sales tax code Underdelivery Tolerance Limit Overdelivery Tolerance Limit Unlimited Overdelivery Allowed

ZBC_S2M_MMINVOICE
The following table lists the fields that can be used to filter invoice data. Field IDENT AUFNR WRBTR BUDAT WAERS BELNR BUZEI EBELN EBELP TXBHW ERFMG ERFME ZEKKN SHKZG MATNR CompType ZIDENT AUFNR WRBTR BUDAT WAERS BELNR_D BUZEI EBELN EBELP EDI5004_G ERFMG ERFME DZEKKN SHKZG MATNR DataType CHAR CHAR CURR DATS CUKY CHAR NUMC CHAR NUMC CHAR QUAN UNIT NUMC CHAR CHAR Length 5 12 13 8 5 10 3 10 5 18 13 3 2 1 18 Dec 0 0 2 0 0 0 0 0 0 0 3 0 0 0 0 Description MAXIMO - link : transaction identifier Order number Amount in document currency Posting date in the document Currency Accounting document number Number of line item within accounting document Purchasing document number Item number of purchasing document Net invoice value Quantity in unit of entry Unit of entry Sequential number of account assignment Debit/credit indicator Material number

SAP ABAP structures for IDOC transaction filtering

273

ZBC_S2M_MMINVOICE

Field WERKS BANFN LIFNR SAKTO BUZID COBL_NR BUKRS KURSF GJAHR MAXIMOPO MX5PO MWSKZ1 WMWST1 RMWWR GRCOST BLDAT

CompType WERKS_D BANFN LIFNR SAKTO BUZID COBL_NR BUKRS EDI5402_A GJAHR CHAR1 CHAR1 MWSKZ WMWST RMWWR CHAR1 BLDAT

DataType CHAR CHAR CHAR CHAR CHAR NUMC CHAR CHAR NUMC CHAR CHAR CHAR CURR CURR CHAR DATS

Length 4 10 10 10 1 4 4 12 4 1 1 2 13 13 1 8

Dec 0 0 0 0 0 0 0 0 0 0 0 0 2 2 0 0

Description Plant Purchase requisition number Account number of vendor or creditor Cost element Identification of the line item Four character sequential number for coding block Company code Exchange rate Fiscal year Single-character indicator Single-character indicator Sale tax code Tax amount in document currency Gross invoice amount in document currency Single-character indicator Document Date in Document

VORGANG

MRM_VORGAN G DZLSPR

CHAR

List field: transaction/event

ZLSPR

CHAR

Payment Block Key

VGART

VGART

CHAR

Transaction/Event Type

STBLG

RE_STBLG

CHAR

10

Reversal document number

STJAH

RE_STJAH

NUMC

Fiscal year of reversal document

274

System Administrator Guide

ZBC_S2M_MATERIALMASTER

ZBC_S2M_MATERIALMASTER
The following table lists the fields that can be used to filter material master data. Field IDENT MATNR ERSDA ERNAM LAEDA AENAM LVORM MTART MBRSH MATKL BISMT MEINS BSTME ZEINR ZEIAR ZEIVR ZEIFO AESZN BLATT BLANZ GROES WRKST NORMT BRGEW CompType ZIDENT MATNR ERSDA ERNAM LAEDA AENAM LVORM MTART MBRSH MATKL BISMT MEINS BSTME DZEINR DZEIAR DZEIVR DZEIFO AESZN BLATT BLANZ GROES WRKST NORMT BRGEW DataType CHAR CHAR DATS CHAR DATS CHAR CHAR CHAR CHAR CHAR CHAR UNIT UNIT CHAR CHAR CHAR CHAR CHAR CHAR NUMC CHAR CHAR CHAR QUAN Length 5 18 8 12 8 12 1 4 1 9 18 3 3 22 3 2 4 6 3 3 32 48 18 13 Dec 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 Description MAXIMO - link : transaction identifier Material number Creation date Name of person who created the object Date of last change Name of person who changed object Deletion indicator Material type Industry sector Material group Old material number Base unit of measure Order unit Document number (without document management system) Document type (without document management system) Document version (without document management system) Page format of document (without document management system) Document change number (without document management system) Page number of document (without document management system) Number of sheets (without document management system) Size/dimensions Basic material Industry standard description (such as ANSI or ISO) Gross weight

SAP ABAP structures for IDOC transaction filtering

275

ZBC_S2M_MATERIALMASTER

Field NTGEW GEWEI VOLUM VOLEH STOFF SPART EAN11 LAENG BREIT HOEHE MEABM CADKZ DATAB LIQDT ATTYP MHDHB SPRAS MAKTX WERKS LVORM_WER KS MAABC AUSME PLIFZ WEBAZ BESKZ SOBSL MINBE EISBE BSTMI BSTMA BSTFE

CompType NTGEW GEWEI VOLUM VOLEH STOFF SPART EAN11 LAENG BREIT HOEHE MEABM CADKZ DATAB LIQDT ATTYP MHDHB SPRAS MAKTX WERKS_D LVORM MAABC AUSME PLIFZ WEBAZ BESKZ SOBSL MINBE EISBE BSTMI LAENG BSTFE

DataType QUAN UNIT QUAN UNIT CHAR CHAR CHAR QUAN QUAN QUAN UNIT CHAR DATS DATS CHAR DEC LANG CHAR CHAR CHAR CHAR UNIT DEC DEC CHAR CHAR QUAN QUAN QUAN QUAN QUAN

Length 13 3 13 3 18 2 18 13 13 13 3 1 8 8 2 4 1 40 4 1 1 3 3 3 1 2 13 13 13 13 13

Dec 3 0 3 0 0 0 0 3 3 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3

Description Net weight Weight unit Volume Volume unit Hazardous material number Division International article number (EAN/ UPC) Length Width Height Unit of dimension for length/width/ height CAD indicator Valid-From date Deletion date Material category Total shelf life Language key Material description Plant Deletion indicator ABC indicator Unit of issue Planned delivery time in days Goods receipt processing time in days Procurement type Special procurement type Reorder point Safety stock Minimum lot size Length Fixed lot size

276

System Administrator Guide

ZBC_S2M_MATERIALMASTER

Field BSTRF MABST KZAUS AUSDT NFMAT MAXLZ LZEIH WZEIT LIZYK BWSCL HERKL HERKR MTVER PRCTR XMCNG EKGRP QSSYS LGORT LVORM_LGO RT LFGJA LFMON SPERR LABST UMLME INSME EINME SPEME VMLAB VMUML LSOBS

CompType BSTRF MABST KZAUS AUSDT NFMAT MAXLZ LZEIH WZEIT LIZYK BWSCL HERKL HERKR MTVER PRCTR XMCNG EKGRP QSSYS LGORT_D LVORM LFGJA LFMON SPERR LABST UMLME INSME EINME SPEME VMLAB VMUML LSOBS

DataType QUAN QUAN CHAR DATS CHAR DEC UNIT DEC CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR NUMC NUMC CHAR QUAN QUAN QUAN QUAN QUAN QUAN QUAN CHAR

Length 13 13 1 8 18 5 3 3 4 1 3 3 4 10 1 3 4 4 1 4 2 1 13 13 13 13 13 13 13 2

Dec 3 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 0

Description Rounding value for purchase order quantity Maximum stock level Discontinuation indicator Effective-out date Follow-up material Maximum storage period Unit for maximum storage period Total replenishment lead time (in workdays) Delivery cycle Source of supply Country of origin of the material Region of origin of material (nonpreferential origin) Export/import material group Profit center Negative stocks allowed in plant Purchasing group Target QM system for vendor Storage location Deletion indicator Fiscal year of current period Current period (posting period) Physical inventory blocking indicator Valuated stock with unrestricted use Stock in transfer (plant to plant) Stock in quality inspection Total stock of all restricted batches Blocked stock Valuated unrestricted-use stock in previous period Stock in transfer in previous period Special procurement type at storage location level
277

SAP ABAP structures for IDOC transaction filtering

ZBC_S2M_MATERIALMASTER

Field LMINB LGPBE DLINL PRCTL BWTAR LBKUM SALK3 VPRSV VERPR STPRS PEINH BKLAS SALKV LFGJA_MBEW LFMON_MBE W STPRV LAEPR ZKPRS ZKDAT ZPLPR UMREZ UMREN UMREN1 UMREZ1 PSTAT KLABS LABOR EKWSL

CompType LMINB LGPBE DLINL PRCTR BWTAR_D LBKUM SALK3 VPRSV VERPR STPRS PEINH BKLAS SALKV LFGJA LFMON STPRV LAEPR CHAR1 CHAR1 CHAR1 UMREZ UMREN UMREN UMREZ PSTAT_D KLABS LABOR EKWSL

DataType QUAN CHAR DATS CHAR CHAR QUAN CURR CHAR CURR CURR DEC CHAR CURR NUMC NUMC CURR DATS CHAR CHAR CHAR DEC DEC DEC DEC CHAR QUAN CHAR CHAR

Length 13 10 8 10 10 13 13 1 11 11 5 4 13 4 2 11 8 1 1 1 5 5 5 5 15 13 3 4

Dec 3 0 0 0 0 3 2 0 2 2 0 0 2 0 0 2 0 0 0 0 0 0 0 0 0 3 0 0

Description Reorder point for storage location MRP Storage bin Date of last posted count for unrestricted-use stock Profit center Valuation type Total valuated stock Value of total valuated stock Price control indicator Moving average price or periodic unit price Standard price Price unit Valuation class Value based on moving average price (only with price ctrl S) Fiscal year of current period Current period (posting period) Previous price Date of the last price change Single-character flag Single-character flag Single-character flag Numerator for conversion to base units of measure Denominator for conversion to base units of measure Denominator for conversion to base units of measure Numerator for conversion to base units of measure Maintenance status Unrestricted-use consignment stock Laboratory/design office Purchasing value key

278

System Administrator Guide

ZBC_S2M_LABORMASTER

Field KZKRI MMSTA DISMM LIFNR IDNLF LGOBE BUKRS MXPLNT BULKLOAD MSTAE LGBST UNTTO UEBTO UEBTK

CompType KZKRI MMSTA DISMM LIFNR IDNLF LGOBE BUKRS BOOLEAN CHAR1 MSTAE LGBST UNTTO UEBTO UEBTK

DataType CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DEC DEC CHAR

Length 1 2 2 10 35 16 4 1 1 2 1 3 3 1

Dec 0 0 0 0 0 0 0 0 0 0 0 1 1 0

Description Indicator: critical part Plant-specific material status MRP type Account number of vendor or creditor Material number used by vendor Description of storage location Company code "boolean variable (X=true, -=false, space=unknown)" Single-character flag Cross-plant material status Storage location./batch stock Underdelivery Tolerance Limit Overdelivery Tolerance Limit Unlimited Overdelivery Allowed

ZBC_S2M_LABORMASTER
The following table lists the fields that can be used to filter labor master data. Field IDENT PERNR INITS NACHN NAME2 NACH2 VORNA CNAME TITEL TITL2 NAMZU CompType ZIDENT PERSNO INITS PAD_NACHN PAD_NAME2 PAD_NACH2 PAD_VORNA PAD_CNAME TITEL TITL2 NAMZU DataType CHAR NUMC CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR Length 5 8 10 40 40 40 40 80 15 15 15 Dec 0 0 0 0 0 0 0 0 0 0 0 Description MAXIMO - link : transaction identifier Personnel number Initials Last name Name at birth Second name First name Complete name Title Second title Other title
279

SAP ABAP structures for IDOC transaction filtering

ZBC_S2M_LABORMASTER

Field VORSW VORS2 RUFNM MIDNM GESCH GBDAT GBLND GBDEP GBORT NATIO BEGDA BUKRS WERKS PERSG PERSK VDSK1 GSBER BTRTL JUPER ABKRS ANSVH KOSTL ORGEH PLANS STELL MSTBR STRAS ORT01 ORT02 PSTLZ LAND1 TELNR STATE

CompType VORSW VORS2 PAD_RUFNM PAD_MIDNM GESCH GBDAT GBLND GBDEP PAD_GBORT NATIO BEGDA BUKRS WERKS_D PERSG PERSK VDSK1 GSBER BTRTL JUPER ABKRS ANSVH KOSTL ORGEH PLANS STELL MSTBR PAD_STRAS PAD_ORT01 PAD_ORT02 PSTLZ_HR LAND1 TELNR REGIO

DataType CHAR CHAR CHAR CHAR CHAR DATS CHAR CHAR CHAR CHAR DATS CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR NUMC NUMC NUMC CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR

Length 15 15 40 40 1 8 3 3 40 15 8 4 4 1 2 14 4 4 4 2 2 10 8 8 8 8 60 40 40 10 3 14 3

Dec 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description Name prefix Second name prefix Known as Middle name Gender key Date of birth Country of birth State Birthplace Nationality Start date Company code Plant Employee group Employee subgroup Organizational key Business area Personnel subarea Legal Person Payroll area Work contract Cost center Organizational unit Position Job Supervisor area Street and house number City District Postal code Country key Telephone number "Region (State, Province, County)"

280

System Administrator Guide

ZBC_S2M_LABORMASTER

Field SCHKZ ZTERF EMPCT MOSTD WOSTD ARBST WKWDY JRSTD TEILK TRFAR TRFGB TRFGR TRFST BSGRD DIVGV LGA01 BET01 LGA02 BET02 QCODE QTEXT USRID_PHON USRID_MAIL USRID_PAGR LSTAR LIFNR STATUS

CompType SCHKN PT_ZTERF EMPCT MOSTD WOSTD ARBST WKWDY JRSTD TEILK TRFAR TRFGB TRFGR TRFST BSGRD DIVGV LGART PAD_AMT7S LGART PAD_AMT7S QUALI_D CHAR40 CHAR50 CHAR50 CHAR50 LSTAR LIFNR CHAR1

DataType CHAR NUMC DEC DEC DEC CHAR DEC DEC CHAR CHAR CHAR CHAR CHAR DEC DEC CHAR CURR CHAR CURR NUMC CHAR CHAR CHAR CHAR CHAR CHAR CHAR

Length 8 1 5 5 5 4 5 7 1 2 2 8 2 5 5 4 13 4 13 8 40 50 50 50 6 10 1

Dec 0 0 2 2 2 0 2 2 0 0 0 0 0 2 2 0 2 0 2 0 0 0 0 0 0 0 0

Description Work schedule rule Employee time management status Employment percentage Monthly hours Hours per week Daily work hours Weekly workdays Annual working hours Checkbox for part-time employee Pay scale type Pay scale area Pay scale group Pay scale level Capacity utilization level Hours worked per payroll period Wage type Wage type amount for payments Wage type Wage type amount for payments Qualification key Character field of length 40 Comment Comment Comment Activity type Account number of vendor or creditor Single-character flag

SAP ABAP structures for IDOC transaction filtering

281

ZBC_S2M_GOODSMOVEMENT

ZBC_S2M_GOODSMOVEMENT
The following table lists the fields that can be used to filter goods movement data. Field IDENT MBLNR BUDAT BWART MATNR WERKS LGORT ERFMG ERFME MENGE MEINS DMBTR WAERS SOBKZ EBELN EBELP ZEKKN WEUNB WEMPF KOSTL SAKTO ABLAD SGTXT USNAM BLDAT FRBNR AUFNR ZEILE CompType ZIDENT MBLNR BUDAT BWART MATNR WERKS_D LGORT_D ERFMG ERFME MENGE_D MEINS DMBTR WAERS SOBKZ EBELN EBELP BEKKN WEUNB WEMPF KOSTL SAKTO ABLAD SGTXT USNAM BLDAT FRBNR AUFNR MBLPO DataType CHAR CHAR DATS CHAR CHAR CHAR CHAR QUAN UNIT QUAN UNIT CURR CUKY CHAR CHAR NUMC NUMC CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS CHAR CHAR NUMC Length 5 10 8 3 18 4 4 13 3 13 3 13 5 1 10 5 2 1 12 10 10 25 50 12 8 16 12 4 Dec 0 0 0 0 0 0 0 3 0 3 0 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Description MAXIMO - link : transaction identifier Number of material document Posting date in the document Movement type (inventory management) Material number Plant Storage location Quantity in unit of entry Unit of entry Quantity Base unit of measure Amount in local currency Currency Special stock indicator Purchasing document number Item number of purchasing document Number of PO account assignment "Goods receipt, non-valuated" Goods recipient/ship-to party Cost center Cost element Unloading point Item text User name Document date in document Number of bill of lading at time of goods receipt Order number Item in material document

282

System Administrator Guide

ZBC_S2M_CONTRACTAUTH

Field BANFN UMWRK UMLGO MJAHR BUKRS KURSF ITYPE MAXIMOPO MX5PO GRCOST SJAHR SMBLN SMBLP LIFNR

CompType BANFN UMWRK UMLGO MJAHR BUKRS EDI5402_A CHAR8 CHAR1 CHAR1 CHAR1 MJAHR MBLNR MBLPO LIFNR

DataType CHAR CHAR CHAR NUMC CHAR CHAR CHAR CHAR CHAR CHAR NUMC CHAR NUMC CHAR

Length 10 4 4 4 4 12 8 1 1 1 4 10 4 10

Dec 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description Purchase requisition number Receiving plant/issuing plant Receiving/issuing storage location Material document year Company code Exchange rate Maximo issue type value Single-character indicator Single-character indicator Single-character indicator Material Document Year Number of Material Document Item in Material Document Account Number of Vendor

ZBC_S2M_CONTRACTAUTH
The following table lists the fields that can be used to filter contracts data. Field IDENT BUKRS WERKS CompType ZIDENT BUKRS WERKS DataType CHAR CHAR CHAR Length 5 4 4 Dec 0 0 0 Description MAXIMO - link : transaction identifier Company code Plant

ZBC_S2M_VENDORS
The following table lists the fields that can be used to filter vendor data. Field
IDENT WAERS

CompType
ZIDENT CURR_5

DataType
CHAR CHAR

Length
5 5

Dec
0 0

Description
MAXIMO - Link : Transaction Identifier Currency Key

SAP ABAP structures for IDOC transaction filtering

283

ZBC_S2M_VENDORS

Field
MANDT LIFNR LAND1 NAME1 NAME2 NAME3 NAME4 ORT01 ORT02 PFACH PSTL2 PSTLZ REGIO SORTL STRAS ADRNR MCOD1 MCOD2 MCOD3 ANRED BAHNS BBBNR BBSNR BEGRU BRSCH BUBKZ DATLT DTAMS DTAWS ERDAT ERNAM ESRNR KONZS KTOKK

CompType
SF_MANDT LIFNR LAND1_GP NAME1_GP NAME2_GP NAME3_GP NAME4_GP ORT01_GP ORT02_GP PFACH PSTL2 PSTLZ REGIO SORTL STRAS_GP ADRNR MCDK1 MCDK2 MCDK3 ANRED BAHNS BBBNR BBSNR BEGRU BRSCH BUBKZ DATLT DTAMS DTAWS ERDAT_RF ERNAM_RF ESRNR KONZS KTOKK

DataType
CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR NUMC NUMC CHAR CHAR NUMC CHAR CHAR CHAR DATS CHAR CHAR CHAR CHAR

Length
3 10 3 35 35 35 35 35 35 10 10 10 3 10 35 10 25 25 25 15 25 7 5 4 4 1 14 1 2 8 12 11 10 4

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
Internal client Account Number of Vendor or Creditor Country Key Name 1 Name 2 Name 3 Name 4 City District PO Box P.O. Box Postal Code Postal Code Region (State Sort field House number and street Address Search term for matchcode search Search term for matchcode search Search term for matchcode search Title Train station International location number (part 1) International location number (Part 2) Authorization Group Industry key Check digit for the international location number Data communication line no. Report key for data medium exchange Instruction key for data medium exchange Date on which the Record Was Created Name of Person who Created the Object POR subscriber number Group key Vendor account group

284

System Administrator Guide

ZBC_S2M_VENDORS

Field
KUNNR LNRZA LOEVM SPERR SPERM SPRAS STCD1 STCD2 STKZA STKZU TELBX TELF1 TELF2 TELFX TELTX TELX1 XCPDK XZEMP VBUND FISKN STCEG STKZN SPERQ GBORT GBDAT SEXKZ KRAUS REVDB QSSYS KTOCK

CompType
KUNNR LNRZA LOEVM_X SPERB_X SPERM_X LAISO STCD1 STCD2 STKZA STKZU TELBX TELF1 TELF2 TELFX TELTX TELX1 XCPDK XZEMP RASSC FISKN_K STCEG STKZN QSPERRFKT GBORT_Q GBDAT_Q SEXKZ KRAUS_CM REVDB_CM QSSYS_IST KTOCK

DataType
CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS CHAR CHAR DATS CHAR CHAR

Length
10 10 1 1 1 2 16 11 1 1 15 16 16 31 30 30 1 1 6 10 20 1 2 25 8 1 11 8 4 4

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
Customer Number 1 Account Number of the Alternative Payee Central Deletion Flag for Master Record Central posting block Centrally imposed purchasing block Language according to ISO 639 Tax Number 1 Tax Number 2 Indicator: Business Partner Subject to Equalization Tax? Liable for VAT Telebox number First telephone number Second telephone number Fax Number Teletex number Telex number Indicator: Is the account a one-time account? Indicator: Alternative payee in document allowed ? Company ID of Trading Partner Account number of the master record with fiscal address VAT registration number Natural Person Function That Will Be Blocked Place of birth of the person subject to withholding tax Date of birth of the person subject to withholding tax Key for the Sex of the Person Subject to Withholding Tax Credit information number Last review (external) Vendors QM system Reference Account Group for One-Time Account (Vendor)

SAP ABAP structures for IDOC transaction filtering

285

ZBC_S2M_VENDORS

Field
PFORT WERKS LTSNA WERKR PLKAL DUEFL TXJCD SPERZ SCACD SFRGR LZONE XLFZA DLGRP FITYP STCDT REGSS ACTSS STCD3 STCD4 IPISP TAXBS PROFS STGDL EMNFR LFURL J_1KFREPRE J_1KFTBUS J_1KFTIND CONFS UPDAT UPTIM NODEL 286

CompType
PFORT_GP WERKS_D LTSNA WERKR FABKL DUEFL_BKPF TXJCD SPERZ SCACD SFRGR LZONE XLFZA DLGRP J_1AFITP_D J_1ATOID J_1AREGSS J_1AACTSS STCD3 STCD4 J_1BINDEQU TAXBS PROFS STGDL EMNFR URL REPRES GESTYP INDTYP CONFS_X UPDAT_RF UPTIM_RF NODEL_X

DataType
CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR NUMC CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS TIMS CHAR

Length
35 4 1 1 2 1 15 1 4 4 10 1 4 2 2 1 3 18 18 1 1 30 2 10 132 10 30 30 1 8 6 1

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
PO Box city Plant Indicator: vendor sub-range relevant Indicator: plant level relevant Factory calendar key Status of Data Transfer into Subsequent Release Jurisdiction for Tax Calculation - Tax Jurisdiction Code Payment Block Standard carrier access code Forwarding agent freight group Transportation zone to or from which the goods are delivered Indicator: Alternative payee using account number Service agent procedure group Tax type Tax Number Type Registered for Social Insurance Activity Code for Social Insurance Tax Number 3 Tax Number 4 Tax Split Tax Base in Percentage Profession Shipment: statistics group External manufacturer code name or number Uniform resource locator Name of Representative Type of Business Type of Industry Status of Change Authorization (Central) Date on Which the Changes Were Confirmed Time of Last Change Confirmation Central deletion block for master record
System Administrator Guide

ZBC_S2M_VENDORS

Field
QSSYSDAT PODKZB BUKRS SPERR_B LOEVM_B ZUAWA AKONT VZSKZ ZWELS XVERR ZAHLS ZTERM EIKTO ZSABE KVERM FDGRV BUSAB LNRZE LNRZB ZINDT ZINRT DATLZ XDEZV WEBTR KULTG REPRF TOGRU HBKID XPORE QSZNR

CompType
QQSSYSDAT PODKZB CHAR4 SPERB_B LOEVM_B DZUAWA AKONT VZSKZ DZWELS XVERR_LFB1 DZAHLS DZTERM EIKTO_K DZSABE_K KVERM FDGRV BUSAB LNRZE LNRZB DZINDT DZINRT DATLZ XDEZV CHAR16 CHAR3 REPRF TOGRU HBKID XPORE QSZNR

DataType
DATS CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS NUMC DATS CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR

Length
8 1 4 1 1 3 10 2 10 1 1 4 12 15 30 10 2 10 10 8 2 8 1 16 3 1 4 5 1 10

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
Validity date of certification Vendor indicator relevant for proof of delivery Not More Closely Defined Area Posting block for company code Deletion Flag for Master Record (Company Code Level) Key for sorting according to assignment numbers Reconciliation Account in General Ledger Interest calculation indicator List of the Payment Methods to be Considered Indicator: Clearing between customer and vendor? Block key for payment Terms of payment key Our account number with the vendor Clerk at vendor Memo Planning group Accounting clerk Head office account number Account number of the alternative payee Key date of the last interest calculation Interest calculation frequency in months Date of the last interest calculation run Indicator: Local processing? Field of length 16 3-Byte field Check Flag for Double Invoices or Credit Memos Tolerance group for the business partner/ G/L account Short key for a house bank Indicator: Pay all items separately ? Certificate Number of the Withholding Tax Exemption

SAP ABAP structures for IDOC transaction filtering

287

ZBC_S2M_VENDORS

Field
QSZDT QSSKZ BLNKZ MINDK ALTKN ZGRUP MGRUP UZAWE QSREC QSBGR QLAND XEDIP FRGRP TOGRR TLFXS INTAD XLFZB GUZTE GRICD GRIDT XAUSZ CERDT GMVKZK LFABC VERKF TELF1_M MINBW ZTERM_M INCO1 INCO2 WEBRE

CompType
QSZDT QSSKZ BLNKZ MINDK ALTKN DZGRUP MGRUP UZAWE QSREC QSBGR QLAND XEDIP FRGRP TOGRR TLFXS INTAD XLFZB GUZTE J_1AGICD_D J_1ADTYP_D XAUSZ CERDT GMVKZK LFABC EVERK TELFE CHAR16 DZTERM INCO1 INCO2 WEBRE

DataType
DATS CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR

Length
8 2 2 3 10 2 2 2 2 1 3 1 4 4 31 130 1 4 2 2 1 8 1 1 30 16 16 4 3 28 1

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
Validity Date for Withholding Tax Exemption Certificate Withholding Tax Code Subsidy indicator for determining the reduction rates Minority Indicators Previous Master Record Number Key for Payment Grouping Key for dunning notice grouping Payment method supplement Vendor Recipient Type Authority for Exemption from Withholding Tax Withholding Tax Country Key Indicator: Send Payment Advices by EDI Release Approval Group Tolerance group; Invoice Verification Accounting clerks fax number at the customer/vendor Internet address of partner company clerk Indicator: Alternative payee using account number Payment Terms Key for Credit Memos Activity Code for Gross Income Tax Distribution Type for Employment Tax Indicator for periodic account statements Certification date Indicator means that the vendor is in execution ABC indicator Responsible salesperson at vendors office Vendors telephone number Field of length 16 Terms of payment key Incoterms (part 1) Incoterms (part 2) Indicator: GR-based invoice verification

288

System Administrator Guide

ZBC_S2M_VENDORS

Field
KZABS KALSK KZAUT EXPVZ ZOLLA MEPRF EKGRP XERSY PLIFZ MRPPP LFRHY LIBES LIPRE LISER PRFRE NRGEW BOIND BLIND KZRET SKRIT BSTAE RDPRF MEGRU VENSL BOPNR XERSR EIKTO_M ABUEB PAPRF

CompType
KZABS KALSK KZAUT EXPVZ DZOLLS MEPRF EKGRP XERSY CHAR3 MRPPP_W LFRHY LIBES LIPRE LISER PRFRE_LH NRGEW BOIND BLIND KZRET SKRIT BSTAE RDPRF MEGRU CHAR4 BOPNR XERSR EIKTO_M ABUEB WVMI_PAPRF

DataType
CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR

Length
1 2 1 1 6 1 3 1 3 3 3 1 2 1 1 1 1 1 1 1 4 4 4 4 4 1 12 4 4

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
Order acknowledgment requirement Group for calculation schema (vendor) Automatic generation of purchase order allowed Mode of Transport for Foreign Trade Customs office: Office of exit for foreign trade Pricing date category (controls date of price determination) Purchasing Group Evaluated Receipt Settlement (ERS) 3-Byte field Planning calendar Planning cycle Order entry by vendor Price marking Rack-jobbing: vendor Indicator: relev. to price determination (vend. hierarchy) Indicator whether discount in kind granted Indicator: index compilation for subseq. settlement active Indicator: Doc. index compilation active for purchase orders Indicates whether vendor is returns vendor Vendor sort criterion for materials Confirmation control key Rounding profile Unit of measure group Not More Closely Defined Area Restriction Profile for PO-Based Load Building Automatic evaluated receipt settlement for return items Our account number with the vendor Release creation profile Profile for transferring material data via IDoc PROACT

SAP ABAP structures for IDOC transaction filtering

289

ZBC_S2M_INFORECORD

Field
AGREL XNBWY VSBED LEBRE BOLRE UMSAE BANKS BANKL BANKN BKONT BVTYP KOINH MABER MAHNA MANSP MADAT MAHNS LFRMA GMVDT HLIFNR TLFNS BULKLOAD SAP_UPDATE ACTIVE

CompType
AGREL XNBWY VSBED LEBRE BOLRE UMSAE BANKS BANKK BANKN BKONT BVTYP KOINH_FI MABER MAHNA MANSP MADAT MAHNS_D LFRMA GMVDT HLIFNR_LH TLFNS CHAR1 CHAR1 CHAR1

DataType
CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DATS NUMC CHAR DATS CHAR CHAR CHAR CHAR CHAR

Length
1 1 2 1 1 1 3 15 18 2 4 60 2 4 1 8 1 10 8 10 30 1 1 1

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Description
Indicator: Relevant for agency business Revaluation allowed Shipping conditions Indicator for service-based invoice verification Indicator: vendor subject to subseq. settlement accounting Comparison/agreement of business volumes necessary Bank country key Bank Key Bank Account Number Bank Control Key Partner bank type Account Holder Name Dunning Area Dunning procedure Dunning block Last dunned on Dunning level Account number of the dunning recipient Date of the legal dunning proceedings Vendor number of higher-level vendor hierarchy Accounting clerks telephone number at business partner Single-character flag Single-character flag Single-character flag

ZBC_S2M_INFORECORD
The following table lists the fields that can be used to filter info record data. Field
IDENT INFNR

CompType
ZIDENT INFNR

DataType
CHAR CHAR

Length
5 10

Dec
0 0

Description
MAXIMO - Link : Transaction Identifier Number of purchasing info record

290

System Administrator Guide

ZBC_S2M_INFORECORD

Field
MATNR MATKL LIFNR TXZ01 SORTL MEINS UMREZ UMREN IDNLF VERKF TELF1 MAHN1 MAHN2 MAHN3 URZNR URZDT URZLA URZTP URZZT LMEIN REGIO VABME LTSNR LTSSF WGLIF RUECK LIFAB LIFBI KOLIF ANZPU PUNEI RELIF

CompType
MATNR MATKL ELIFN EINATX SORTI BSTME UMBSZ UMBSN IDNLF VERKF TELF0 MAHN1 MAHN2 MAHN3 URZNR URZDT ULAND URZTP URZZT MEINS REGIO VABME LTSNR LTSSF WGLIF W_RUECKNV LIFAB LIFBI KOLIF ANZPU PUNEI RELIF

DataType
CHAR CHAR CHAR CHAR CHAR UNIT DEC DEC CHAR CHAR CHAR DEC DEC DEC CHAR DATS CHAR CHAR CHAR UNIT CHAR CHAR CHAR NUMC CHAR CHAR DATS DATS CHAR QUAN UNIT CHAR

Length
18 9 10 40 10 3 5 5 35 30 16 3 3 3 10 8 3 1 16 3 3 1 6 5 18 2 8 8 10 13 3 1

Dec
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 0 0

Description
Material Number Material Group Account Number of the Vendor Short text for purchasing info record Sort string for non-stock info records Order unit Numerator for Conversion of Order Unit to Base Unit Denominator for Conversion of Order Unit to Base Unit Material Number used by Vendor Salesperson responsible in the event of queries Vendors telephone number Number of days for first reminder/urging letter (expediter) Number of days for second reminder/ urging letter (expediter) Number of days for third reminder/urging letter (expediter) Certificate number Certificate of origin valid until Certificate of origin: Country of issue Certificate category Number Base Unit of Measure Region (State Variable order unit active Vendor Sub-Range Sort sequence number Vendor material group Return agreement Available (deliverable) from Available (deliverable) until Prior vendor Number of points Points unit Regular vendor 291

SAP ABAP structures for IDOC transaction filtering

ZBC_S2M_INFORECORD

Field
MFRNR EKORG ESOKZ WERKS EKGRP WAERS BONUS MGBON MINBM NORBM APLFZ UEBTO UEBTK UNTTO ANGNR ANGDT ANFNR ANFPS ABSKZ AMODV AMODB AMOBM AMOBW AMOAM AMOAW AMORS BSTYP EBELN EBELP DATLB NETPR PEINH BPRME PRDAT

CompType
MFRNR1 EKORG ESOKZ EWERK BKGRP WAERS WRBON MGBON MINBM NORBM PLIFZ UEBTO UEBTK UNTTO ANGNR ANGDT ANFNR ANFPS ABSKZ AMODV AMODB AMOBM AMOBW AMOAM AMOAW AMORS BSTYP EBELN EBELP DATLB IPREI PEINH BBPRM PRGBI

DataType
CHAR CHAR CHAR CHAR CHAR CUKY CHAR CHAR QUAN QUAN DEC DEC CHAR DEC CHAR DATS CHAR NUMC CHAR DATS DATS QUAN CURR QUAN CURR CHAR CHAR CHAR NUMC DATS CURR DEC UNIT DATS

Length
10 4 1 4 3 5 1 1 13 13 3 3 1 3 10 8 10 5 1 8 8 15 15 15 15 1 1 10 5 8 11 5 3 8

Dec
0 0 0 0 0 0 0 0 3 3 0 1 0 1 0 0 0 0 0 0 0 3 2 3 2 0 0 0 0 0 2 0 0 0

Description
Manufacturer Purchasing Organization Purchasing info record category Plant Purchasing group Currency Key Indicator: Volume-based rebate Indicator: Quantity-based volume rebate Minimum purchase order quantity Standard purchase order quantity Planned delivery time in days Overdelivery tolerance limit Indicator: Unlimited overdelivery allowed Underdelivery tolerance limit Quotation number Quotation validity date RFQ number Item number of RFQ Rejection indicator Amortization period from Amortization period to Amortized planned quantity Amortized planned value Amortized actual quantity Amortized actual value Indicator: Amortization reset Purchasing document category Purchasing Document Number Item Number of Purchasing Document Date of last PO or sched. agreement document in info record Net price in purchasing info record Price Unit Order Price Unit (Purchasing) Price valid until

292

System Administrator Guide

ZBC_S2M_INFORECORD

Field
BPUMZ BPUMN MTXNO WEBRE EFFPR EKKOL SKTOF KZABS MWSKZ BWTAR EBONU EVERS EXPRF BSTAE MEPRF INCO1 INCO2 XERSN EBON2 EBON3 EBONF MHDRZ VERID BSTMA RDPRF MEGRU J_1BNBM IPRKZ BULKLOAD BUKRS ACTIVE

CompType
BPUMZ BPUMN MTXNO WEBRE EFFPR EKKOG ESKTOF KZABS MWSKZ BWTAR_D EBONU EVERS EXPRF BSTAE MEPRF INCO1 INCO2 XERSN EBON2 EBON3 EBONF MHDRZ VERID MAXBM RDPRF MEGRU J_1BNBMCO1 DATTP CHAR1 BUKRS CHAR1

DataType
DEC DEC CHAR CHAR CURR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR CHAR DEC CHAR QUAN CHAR CHAR CHAR CHAR CHAR CHAR CHAR

Length
5 5 1 1 11 4 1 1 2 10 2 2 8 4 1 3 28 1 2 2 1 4 4 13 4 4 16 1 1 4 1

Dec
0 0 0 0 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 0 0 0 0 0 0 0

Description
Numerator for conversion of order price unit into order unit Denominator for conv. of order price unit into order unit Material master record PO text not relevant Indicator: GR-based invoice verification Effective price in purchasing info record Condition group with vendor No cash discount granted on this item Order acknowledgment requirement Tax on sales/purchases code Valuation Type Settlement group 1 (Purchasing) Shipping instructions Export/Import Procedure for Foreign Trade Confirmation control key Pricing date category (controls date of price determination) Incoterms (part 1) Incoterms (part 2) No evaluated receipt settlement (ERS) Settlement group 2 (rebate settlement Settlement group 3 (rebate settlement Item not relevant to subseq. (period-end rebate) settlement Minimum remaining shelf life Production Version Maximum order quantity Rounding profile Unit of measure group Brazilian NCM Code Period indicator for shelf life expiration date Single-character flag Company Code Single-character flag

SAP ABAP structures for IDOC transaction filtering

293

ZBC_S2M_INFORECORD

Field
SAP_UPDATE

CompType
CHAR1

DataType
CHAR

Length
1

Dec
0

Description
Single-character flag

294

System Administrator Guide

BDC transaction codes and BAPI programs

This appendix lists SAP Applications transaction codes and BAPI programs the integration uses per Maximo interface when sending transactions from Maximo to SAP. This integration supports BDC process modes (that use transaction codes), and also supports BAPI calls. You select BDC or BAPI process modes in the ZBC_INBPROGRAMS table. The integration calls the transaction codes and the BAPI programs shown in the following table. Transaction codes and BAPI programs
Maximo interface SAP transaction code BAPI program

Create workorder Update workorder Create reservation Update reservation Delete reservation Create purchase request Create purchase order Update purchase order Create goods receipt Create goods issue Create FI invoice Create MM invoice Create GL posting Create labor hours CO Create purchase request

KO01 KO02 MB21 MB22 MB22 ME51 ME21 ME22 MB01 MB1A F-43 * FB01 KB21 ME51N

BAPI_INTERNALORDER_CREATE

BAPI_RESERVATION_CREATE1

BAPI_REQUISITION_CREATE BAPI_PO_CREATE1 BAPI_PO_CHANGE BAPI_GOODSMVT_CREATE BAPI_GOODSMVT_CREATE BAPI_ACC_INVOICE_RECEIPT_POST BAPI_INCOMINGINVOICE_CREATE BAPI_ACC_DOCUMENT_POST BAPI_ACC_ACTIVITY_ALLOC_POST BAPI_PR_CREATE

* There is no transaction code for this interface.

Copyright IBM Corp. 2007, 2011

295

296

System Administrator Guide

Collaboration switches

Collaboration switches have been designed from an inbound integration point of view to provide users with a way to better manage data-synchronization between Maximo and external systems using the concept of ownership. These switches provide the ability to control subprocesses within specific Maximo application functionality based on ownership of different data objects within a transaction. Most master data and document integration objects in Maximo have an OWNERSYSID attribute present in the primary MBO of the integration object. By default, Maximo's inbound integration processing does not specify any value in this field, and processing of inbound interfaces proceeds as per standard Maximo functionality. This appendix contains details on the available collaboration switches and their effect on standard Maximo processing.

Format of collaboration switches

Collaboration switches provide a flexible, user-defined way to control the processing of some inbound transactions, by letting Maximo bypass the default processing for certain types of transactions. The collaboration switches reside in the Maximo MXCOLLAB table. Each collaboration switch contains four elements, three of which combine to create a unique key. The following table lists these elements. An asterisk (*) indicates the elements that comprise the key. Element Process control identification* System ID 1* System ID 2* Process control value Corresponding MXCOLLAB field PCidentification OWNER1SYSID OWNER2SYSID PCVALUE

Copyright IBM Corp. 2007, 2011

297

Format of collaboration switches

Process control identification

The process control identification identifies a business process in a Maximo application, such as the validation of an invoice match, the creation of a blanket PO release, or the update of a physical inventory count. The prefix of the process control identification indicates the application to which it applies: Prefix of process control identification INV ITM IV LT PO PR WO Corresponding application Invoice Item Inventory Labor Purchase order Purchase requisition Work order

For example, the IVRC, IVRCY, and IVWO collaboration switches are all related to inventory processing. For a complete listing of the collaboration switches by application, see the tables at the end of this appendix.

System ID 1 and system ID 2

System ID 1 and system ID 2 identify your Maximo system and/or an external system. The values in these fields vary, depending on the transaction and the objects in the transaction. In general, system ID 1 identifies the system (Maximo or external) that created the object, and system ID 2 identifies the system that created the record being referenced or updated.

Process control value

The process control value specifies whether the Maximo business components should bypass default processing for the type of transaction indicated by the process control identification, system ID 1, and the system ID 2. The process control value can be 0 (false) or 1 (true). These values have the following meanings: 0 1 Perform default processing Bypass default Maximo processing

298

System Administrator Guide

Default collaboration switches

Default collaboration switches

Maximo creates three default collaboration switches, with different combinations of system identification values, for each process control identification. Authorized users can create additional switches as needed. The default switches use various combinations of the following values in the System ID 1 and System ID 2 fields. System identification value THISMX EXT Meaning The Maximo system identified in MAXVARS.MXSYSID* Any system other than the one identified in MAXVARS.MXSYSID

* The collaboration switches do not use the actual value in MXSYSID. Authorized users can update only the process control value in the default collaboration switches. CAUTION Deleting a default collaboration switch or modifying any field other than the process control value can result in system failure.

Retrieving a collaboration switch

Each process control identification has at least three related collaboration switches (the defaults and any that the user adds). Maximo uses the following logic to determine which system identification values to set when retrieving a collaboration switch from the MXCOLLAB table:

1 Maximo uses the rules for deriving the system ID 1 and system ID 2 values for
the process control identification in question. Example: For process control identification PRDEL, system ID 1 is the literal THISMX and system ID 2 is the system that owns the PR.

2 If the value in system ID 1 is now blank, null, or equal to the value in the
MXSYSID row of the Maximo MAXVARS table, Maximo uses THISMX for system ID 1.

3 If the value in system ID 2 is now blank, null, or is equal to the value in the
MXSYSID row of the Maximo MAXVARS table, and the process control identification is not PRPAB, Maximo uses THISMX for system ID 2.

4 If the process control identification is PRPAB, the value in system ID 2 will be

null after step 1, and Maximo uses the literal EXT for System ID 2 (if the blanket PO does not exist).

Collaboration switches

299

Viewing collaboration switches

5 If both System ID 1 and System ID 2 now equal THISMX, Maximo performs

the default Maximo processing (that is, it acts as if it retrieved an MXCOLLAB record with a process control value of 0). If both System ID 1 and System ID 2 equal THISMX, ignore the remaining steps.

6 Maximo tries to find a record with the modified key in the MXCOLLAB table.
If the record exists, Maximo uses the records process control value to determine whether or not to bypass Maximo processing. If the record exists, ignore the remaining steps.

7 If the record does not exist, Maximo modifies the key as follows:
If System ID 1 now equals THISMX and System ID 2 does not equal THISMX, Maximo uses EXT as the System ID 2 value. If System ID 1 value does not equal THISMX and System ID 2 equals THISMX, Maximo uses EXT as the System ID 1 value.

8 Maximo tries to find a record with the modified key in the MXCOLLAB table.
If the record exists, Maximo uses the records process control value to determine whether or not to bypass Maximo processing. If the record exists, ignore the remaining step.

9 Maximo uses EXT for both System ID 1 and System ID 2. 10 Maximo finds the record with the modified key in the MXCOLLAB table.
This record always exists, because every process control value has a default collaboration switch with both system IDs equal to EXT.

11 Maximo uses the records process control value to determine whether or not to
bypass Maximo processing.

Viewing collaboration switches

You can use any database tool to display the values in the MXCOLLAB table. You can also create a report with the report writing tools available in Maximo. To display the collaboration switches for a single process control identification, use the following SQL query:
select from where order by pcid, owner1sysid, owner2sysid, pcvalue mxcollab pcid = PCID pcid, owner1sysid, owner2sysid;

300

System Administrator Guide

Modifying a collaboration switch

To display all collaboration switches, use the following SQL query:

select pcid, owner1sysid, owner2sysid, pcvalue from mxcollab order by pcid, owner1sysid, owner2sysid;

To display a short description of the process control IDs, use the following SQL query:
select * from mxcollabref order by pcid;

Modifying a collaboration switch

Authorized users can use any database tool to modify the process control value of a collaboration switch. CAUTION Do not change the value of PCID, OWNER1SYSID, or OWNER2SYSID on existing collaboration switches. To change the process control value in a collaboration switch, use the following SQL statement:
update mxcollab set pcvalue where pcid and owner1sysid and owner2sysid

= PCVALUE = PCID = OWNER1SYSID = OWNER2SYSID;

NOTE

The values in the MXCOLLAB table are case-sensitive.

Adding a collaboration switch

Authorized users can add new collaboration switches to the MXCOLLAB table. New switches must use an existing process control identification, but they can use new system identifications. NOTE Only the default collaboration switches can use the values THISMX and EXT in the system identification fields. To add a collaboration switch, use the following SQL statement:
insert into mxcollab (pcid, owner1sysid, owner2sysid, pcvalue) values (PCID, OWNER1SYSID, OWNER2SYSID, PCVALUE);

Example You use the Maximo integration integrate Maximo with SAP and other systems. When SAP issues Maximo-owned inventory, you want Maximo to accept the issue and update inventory balances and costs. However, when other systems issue Maximo-owned inventory, you want to accept the issue, but you do not want to update inventory balances or costs.

Collaboration switches

301

Adding a collaboration switch

Before you modify the MXCOLLAB table to reflect these conditions, the INV collaboration switches have the following values: Process control identification INV INV INV System ID 1 THISMX EXT EXT System ID 2 EXT THISMX EXT Process control value 1 0 1

To accomplish the task, complete the following steps:

1 Change the value of the INV/ EXT/ THISMX collaboration switch to 1 to

bypass normal update processing. To update the collaboration switch, use the following SQL statement:
update mxcollab set pcvalue where pcid and owner1sysid and owner2sysid

= 1 = INV = EXT = THISMX;

2 Select a system identification to represent SAP.

This example uses SAP as the system identification.

3 Add a new collaboration switchINV/SAP/THISMXto the MXCOLLAB

table. The single SQL statement following step 5 performs the processing for steps 3, 4, and 5.

4 Set the new collaboration switchs process control value to 0.

This value directs Maximo to perform the normal balance and cost updates when it receives issues from SAP.

5 Set the OWNERSYSidentification attribute on the inbound transaction to the

system identification you chose in step 2in this case, SAP. NOTE If OWNERSYSID is blank, the value in the DEFEXTSYS interface control is used. To perform the processing described in steps 3, 4 and 5, use the following SQL statement:
insert into mxcollab (pcid, owner1sysid, owner2sysid, pcvalue) values (INV, SAP, THISMX, 0);

302

System Administrator Guide

Adding a collaboration switch

After you perform this procedure, the INV collaboration switches will have the following values: Process control identification INV INV INV INV Example By setting the value of the ISUIN interface control to 1, you tell Maximo to accept issue transactions from an external system. The INV collaboration switch controls the update of inventory balance and cost related to issues. You can adjust the setting of this switch, if necessary, so that Maximo bypasses that update process. The INV/EXT/THISMX collaboration switch controls the processing of inventory (Process Control ID = INV) that is issued in the external system (System ID 1 = EXT) and owned by Maximo (System ID 2 = THISMX). If the value of the INV/EXT/THISMX collaboration switch were 0, Maximo would update the inventory balance and cost. This is the default processing. If the value of the INV/EXT/THISMX collaboration switch were 1, Maximo would bypass the default processing and not update the inventory balance and cost. In this example, ISUIN accepts any issues into Maximo. The INV/EXT/THISMX collaboration switch then tells the inventory business component how to process a specific type of issue. System ID 1 THISMX EXT EXT SAP System ID 2 EXT THISMX EXT THISMX Process control value 1 1 1 0

Collaboration switches

303

Inventory collaboration switches

Inventory collaboration switches

Process Control identification INV Description Value and action Derivation of System ID 1 INVTRANS or MATUSETRANS Derivation of System ID 2 INVENTORY

Update inventory Used when creating issues, returns, or miscellaneous receipts or adjustments. Inventory must exist in this system.

0 1

Update inventory Do not update inventory

INVDEL

Delete inventory Used when deleting externally owned inventory Caution: If value is 1, the item-storeroom will still exist on related open PRs, POs, RFQs, work orders, and so on. This might result in problems receiving/approving these lines.

Delete item if it passes normal Maximo validations. Delete inventory without any validations and delete INVBALANCES record for the item

THISMX

INVENTORY

INVISS

Enter item issues Used when issuing material

0 1 0 1 0

Allow material issues for the inventory Do not allow material issues for the inventory Allow material returns Do not allow issue returns for the material Update work order actual material cost, equipment INVCOST Do not update work order actual material cost, equipment INVCOST

MATUSETRANS

INVENTORY

INVISSR

Enter item issue returns Used when returning material

MATUSETRANS

INVENTORY

INVISSWO

Update work order actual cost, equipment INVCOSTs Used when processing issues or returns. Meant to handle Maximo to Maximo cases where these updates will be done separately.

MATUSETRANS

WORKORDER

304

System Administrator Guide

Inventory collaboration switches

Process Control identification INVPHY

Description

Value and action

Derivation of System ID 1 INVTRANS

Derivation of System ID 2 INVENTORY

Enter external physical counts Used when creating physical counts

0 1 0

Allow physical count for the inventory Do not allow physical count for the inventory Update INVBALANCES in the From storeroom Do not update INVBALANCES in the From storeroom Delete item if it passes normal Maximo validations Delete item without any validation. Also delete INVENTORY, INVBALANCES, and INVVENDOR records for the item

INVTR

Update the From storeroom on a transfer or the receipt of internal PO Used when creating transfers or creating a receipt for an internal POs

MATRECTRANS

1 0

LOCATIONS (storeroom for transfer; vendor for internal PO) ITEM

ITMDEL

Delete items Used when deleting items that this system does not own Caution: If value is 1, the item will still exist on related open PRs, POs, RFQs, work orders, and so on. This might result in problems receiving/approving these lines.

THISMX

Collaboration switches

305

Invoice collaboration switches

Invoice collaboration switches

Process Control identification IVILC Description Value and Action Derivation of System ID 1 INVOICE Derivation of System ID 2 INVENTORY

Update inventory last cost Used when approving invoices

0 1 0 1 0 1

Update inventory last cost Do not update inventory last cost Update inventory average cost Do not update inventory average cost Validate match Do not validate any match provided

IVINV

Update inventory average cost Used when approving invoices

INVOICE

INVENTORY

IVMATCH

Use and validate invoice match Used when approving invoices If set to 1, also set IVPO to 1

THISMX

INVOICE

IVPO

Update POs and receipts Used when approving invoices

0 1 0

Update PO status and receipts Do not update PO status or receipts Prorate the difference between the header and the line total Do not prorate the difference between the header and line total Generate a service receipts for the invoice lines that do not have a PO reference Do not generate a service receipt for the invoice lines that do not have a PO reference

INVOICE

PO

IVPRO

Check and prorate differences between invoice headers and lines Used when approving invoices

THISMX

INVOICE

1 0

IVRC

Create service receipts for invoice lines without a PO reference Used when approving invoices that contain a line without a PO reference

THISMX

INVOICE

306

System Administrator Guide

Invoice collaboration switches

Process Control identification IVRCY

Description

Value and Action

Derivation of System ID 1 INVOICE

Derivation of System ID 2 PO

Create service receipts for invoice lines with a PO reference and RECEIPTREQD = N Used when approving invoices containing a line with a PO reference, when the corresponding POLINE is a service and RECEIPTREQD = N

Generate a service receipt for the invoice line Do not generate a service receipt for the invoice line

IVTOL

Perform invoice tolerance checking validation Used when approving invoices

0 1

Perform all tolerance checks on invoice Do not perform tolerance checks on invoice Update vendor last cost Do not update vendor last cost Update work order Do not update work order

THISMX

INVOICE

IVVLC

Update vendor last cost Used when approving invoices

0 1 0 1

INVOICE

INVVENDOR

IVWO

Update work orders Used when approving invoice

INVOICE

WORKORDER

Collaboration switches

307

Labor transaction collaboration switches

Labor transaction collaboration switches

Process Control identification LTSRC Description Value and Action Derivation of System ID 1 LABTRANS Derivation of System ID 2 PO

Generate service receipts for POs Used when creating labor transactions or changing status. PO must exist in this system

Allow setting value of LABTRANS.GENAPPRSERVRECEIPT to Y; configurable in Maximo Setup application Leave value of LABTRANS.GENAPPRSERVRECEIPT as N

308

System Administrator Guide

Purchase order collaboration switches

Purchase order collaboration switches

Process control identification PODEL Description Value and action Derivation of System ID 1 THISMX Derivation of System ID 2 PO

Delete POs Used when deleting POs. Use only when deleting then subsequently re-adding a PO due to changes in the PO. If any PRLINES contain a reference to the PO, clear them. If necessary, reopen the PR. When the PO is re-added, the PRLINEs will be established again.

0 1

Do not delete PO Delete PO and PRLINEs; do not delete POSTATUS

POINV

Do not allow unreferenced external inventory for internal POs Used when adding or updating PO lines and changing the status of internal POs

If the item-vendor combination not in INVENTORY table, error If item-vendor combination not found in INVENTORY table (where PO.VENDOR = LOCATIONS.LOCATION), ignore error Update or create INVVENDOR record Do not create INVVENDOR record Change status of PR (auto close based on MAXVAR setting) or reopen when POLINE containing PR reference is deleted, or other instances of reopen Do not change PR status

PO

LOCATIONS, where vendor is the storeroom

POIVM

Create inventory vendor information for inventory Used when approving POs

0 1

PO

ITEM of POLINE

POPR

Update status of PRs Used when copying PR lines to POs, creating POs from PRs, reopening PRs

PO

PR

Collaboration switches

309

Purchase order collaboration switches

Process control identification POREL

Description

Value and action

Derivation of System ID 1 PR

Derivation of System ID 2 PO of the blanket

Create releases for blanket POs Used when approving PR and the PR lines contain a blanket references, and when a release is created directly from a PO without a PR

Generate PO release. (If PRLINE.AGREEMENTPONUM not in PO, do not generate PO release) Do not regenerate PO releases Generate inventory reservations. If itemvendor combination (where vendor is internal storeroom) not in INVENTORY table, do not generate PO reservations. This might happen if POINV is 0 Do not generate inventory reservations

1 0

PORES

Process material reservations Used when changing the status of internal POs

PO

INVENTORY

310

System Administrator Guide

Purchase requisition collaboration switches

Purchase requisition collaboration switches

Process control identification PRDEL Description Value and action Derivation of System ID 1 THISMX Derivation of System ID 2 PR

Delete PRs Used when deleting PRs. Use only when deleting then subsequently re-adding a PR due to changes in the PR. If WPMATERIAL or MRLINE contain references to the PR, clear them. They will be reestablished when you read PR.

0 1

Do not delete PR Delete the PR and PRLINES; do not delete PRSTATUS

PRINV

Do not allow unreferenced external inventory on internal PRs. Used when storerooms are maintained in an external system. Items are in ITEM master in Maximo; storeroom is defined as a LOCATION; INEVENTORY is not defined for item-storeroom combination because it is not owned by Maximo. The owner of the PR is the MXSYSID of the system that creates the PR. Validation occurs when an item-storeroom (INVENTORY) is validated on the PRLINE. The OWNERSYSID of the storeroom is compared with the OWNERSYSID of the PR, and the flag determines if the combination is allowed.

If the item-vendor combination is not in INVENTORY table, error If the item-vendor combination (vendor is the internal storeroom) is not in INVENTORY table, where PR.VENDOR = LOCATIONS.LOCATION, ignore error. LOCATIONS must exist; that is, pass standard validation for the location

PR

LOCATIONS, where vendor is the internal storeroom

Collaboration switches

311

Purchase requisition collaboration switches

Process control identification PRPAB

Description

Value and action

Derivation of System ID 1 PR

Derivation of System ID 2 EXT Normally this would be from PO of the blanket, but in this case the blanket PO does not exist

Do not allow unreferenced external purchase agreements / blankets Used when adding or updating PR lines and changing the status of PRs

If PRLINE.AGREEMENTPONUM is not in PO, error If PRLINE.AGREEMENTPONUM is not in PO, ignore error

312

System Administrator Guide

Receipt collaboration switches

Receipt collaboration switches

Process control identification RC Description Value and action Derivation of System ID 1 MATRECTRANS or SERVRECTRANS MATRECTRANS Derivation of System ID 2 PO

Enter PO receipts Used when creating receipts

0 1 0 1 0 1 0

Allow receiving against the PO Do not allow receiving against the PO Update inventory last cost Do not update inventory last cost Update inventory if it exists Do not update inventory Generate invoice if value of PayOnReceipt is set Do not generate invoice, even if value of PayOnReceipt is set Update PO Do not update PO Allow receipt returns for the PO Do not allow receipt returns for the PO Update vendor last cost Do not update vendor last cost Update work order Do not update work order

RCILC

Update inventory last cost Used when approving receipts

INVENTORY

RCINV

Update inventory Used when receiving, or approving receipts

MATRECTRANS

INVENTORY

RCIV

Generate invoices for PO receipts Used when approving receipts

MATRECTRANS or SERVRECTRANS

PO

1 RCPO Update external PO Used when approving receipt RCR Enter PO receipt return Used when creating receipt return RCVLC Update vendor last cost Used when approving receipt or receiving PO line RCWO Update work orders Used when approving receipts 0 1 0 1 0 1 0 1

MATRECTRANS or SERVRECTRANS MATRECTRANS or SERVRECTRANS MATRECTRANS

PO

PO

INVVENDOR

MATRECTRANS or SERVRECTRANS

WORKORDER

Collaboration switches

313

Work order collaboration switches

Work order collaboration switches

Process control identificaion WORES Description Value and action Derivation of System ID 1 WORKORDER Derivation of System ID 2 INVENTORY

Process material reservations Used when changing the status of a work order. Inventory must exist in this system.

0 1

Generate inventory reservation Do not generate inventory reservation

314

System Administrator Guide

Index

A
ABAP reports. see batch report processing accounting transaction codes 60 action 10 ACTIVE field chart of accounts 110 general ledger components 110 architecture SAP Applications 14 authorization transaction codes 57 autonumbering 74 autoseed 74

B
batch report processing chart of accounts integration 101 craft integration 122 FI GL account data 188 general ledger integration 101 inventory integration 195 inventory vendor integration 201 invoice variances integration 185 invoices integration 177 item integration 195 labor integration 127 labor time integration 129 material group data 187 purchase requisition status updates integration 162 purchasing group data 187 vendor integration 144 Boolean type interface controls 38 bulk loading 109, 146 craft integration 123, 124 general ledger and chart of accounts integration 110 inventory vendor integration 203 vendor integration 146

C
chart of accounts integration account configuration 107 batch report processing 101 bulk load action 109 configuration 103 integration points 111 interface 111 interface controls 111 Copyright IBM Corp. 2011

journals 108 structure 100 work orders 108 collaboration switches adding 287 default 285 format 283 inventory 290 invoice 292 labor transaction 294 modifying 287 overview 283 process control ID 284 process control value 284 purchase order 295 purchase requisition 297 receipt 299 retrieving 285 system IDs 284 viewing 286 work order 300 company masters 143 company. see vendor integration components SAP Adapter 14 configuration default account 107 general ledger requirements 108 Maximo accounts 103 multiple language 50 SAPGLCOMP control 103 SAPGLCONCAT control 105 configuration 1 defined 20 configuration 2 defined 22 configuration 3 defined 23 content 9 contract authorization 152 contracts integration contract authorization 152 contract line status 152 contract types 151 creating release POs 152 data structure 149 filtering 151 interface controls 153 overview 149 requirements 151 cost elements receipts integration 208 cost objects categories 100 craft integration batch report processing 122 bulk load action 123 data structure 121 effectivity of data 123

315

Index
integration point 126 interface 125 interface controls 121, 123, 125, 128 overview 118 pay rates 118 cron task SAPMASTERDATAUPDATE 110, 123, 146, 203 cross-reference type interface controls 39 customization Java user exit procedures 47

F
FI GL accounts batch report processing 188 batch report ZBCXIREPR011 187 fields added COMPANIES 110, 146 CRAFT 125 INVVENDOR 204 to MAXDOMAIN 186 to PO 166 to POLINE 167 to PR 156 to PRLINE 157 to WORKORDER table 217 filtering contracts 151 IDoc type EKSEKS01 152 invoice variances 185 invoices inbound 175 journals 113 purchase orders 168 purchase requisition status updates 162 purchase requisitions 157 formats collaboration switch 283

D
data exchange content 9 data export 9 data import 9 enterprise services 7 external systems 7 invocation channels 6 object structures 4 publish channels 5 web services 8 data transfer SAP invoice data to Maximo 177, 185, 186, 187 SAP PR status to Maximo 160 SAP vendor data to Maximo 144 descriptions, multiple language 51 distribution in SAP 165 domains integration interface controls 188 overview 185

G
general ledger components integration batch report processing 101 bulk load action 109 cost objects 100 effectivity 109 integration points 111 interface 111 interface controls 111 structure 100 GL posting date behavior 173

E
effectivity craft data 123 general ledger component data 109 inventory vendor data 203 item data 194 labor data 128 vendor data 145 enterprise services data exchange 7 error handling SAP BAPI 55 SAP batch input map 55 SAP function modules 54 SAP RETURN table 54 XI 54 EXT_ACTIVE field 123, 146, 194, 219 inventory vendor 203 inventory vendor integration 203 external systems data exchange 7

H
HR transaction codes 61

I
IBMMX/CMXCONFIG table 94 IDOC processing contracts integration 152 error reports 53 inventory integration 196 issues integration 206 item integration 196 labor integration 128 purchase orders integration 169 receipts integration 206 inspection, receipts requiring 210 System Administrator Guide

316

Index
integration components described 16 integration framework for data exchange 4 for operational management product integration 9 for user interface integration 11 overview 2 integration modules operational management product integration 10 integration points contracts integration 153 craft integration 126 general ledger integration 111 inventory integration 200 inventory vendor integration 205 invoices integration 182 issues integration 213 item integration 195 journals integration 114 labor integration 129 labor time integration 133 predefined 14 purchase orders integration 171 purchase requisition status updates integration 163 purchase requisitions integration 159 receipts integration 210 supported 14 vendor integration 148 work order integration 219 interface controls Boolean type 38 configuration 39 contracts integration 153 craft integration 121, 123, 125, 128 creation 39 cross-reference type 39 domains integration 188 general ledger component 111 inventory vendor integration 204 invoice status 139 invoices integration 182 issues integration 212 journals integration 114 labor integration 121, 123, 125, 128 labor time integration 121, 123, 125, 128 list type 38 Maximo 38 multiplication 39 organization-level 38 processing rules 38 purchase order integration 172 purchase requisition 158 purchase requisition status updates 163 purchasing status 139 receipts integration 209 reservations integration 216, 218, 220 SAPAPOUT 112 SAPGLCOMP 103 SAPGLCONCAT 105 SAPRSVOUT 216 SAPWOOUT 216 site-level 38 system-level 38 value type 39 vendor integration 148 work order integration 216, 218, 220 interfaces contracts integration 153 craft integration 125 domains integration 188 general ledger integration 111 inventory integration 193, 200 inventory vendor integration 204 invoices integration 182 issues integration 213 item integration 195 journals integration 114 labor time integration 132 purchase orders integration 171 purchase requisition updates integration 163 purchase requisitions integration 159 receipts integration 210 reservations integration 221 vendor integration 148 work order integration 218 interfaces integration interface controls 182 inventory collaboration switches 290 inventory integration batch report processing 195 IDOC processing 196 integration points 200 interfaces 193, 200 location-level data 198 material cost valuation 198 plant-level data 198 SAP data structure 190 triggers 198 inventory vendor integration batch report processing 201 bulk load action 203 data effectivity 203 data structure 201 EXT_ACTIVE field 203 integration point 205 interface controls 204 SAP_UPDATE field 204 invocation channels data exchange 6 invoice journals configuration 112 invoice variances integration batch report processing 185 filtering 185 inbound data considerations 184 overview 184 requirements 184 invoices centralized 136, 176 collaboration switches 292 data transfer 187 reversing 174 invoices integration batch report processing 177 batch report ZBCXIREPR014 177, 185, 186, 187 data transfer 177, 185, 186, 187 filtering 175 inbound data considerations 175 inbound FI invoice data considerations 177 inbound MM invoice data considerations 176 outbound data considerations 180 outbound data overview 178 outbound FI invoice data considerations 181 outbound MM invoice data considerations 181 overview 173 requirements 174 issues integration IDOC processing 206

317

Index
inbound processing 211 integration points 213 interface controls 212 interfaces 213 movement types 211 outbound processing 210 tables 213 item integration batch report processing 195 effectivity 194 IDOC processing 196 integration point 195 interface 195 SAP data structure 190 item numbers mapping 139 list type interface controls 38 logical management operations integration 10

M
material cost valuation 198 material groups batch report processing 187 material receipts 207 Maximo organizational structure 33 Maximo support 51 MM transaction codes 58 movement types issues 211 issues and receipts 205 receipts 208 reservations integration 219 multiple distribution 165 multiple distributions 140 multiple language support configuration table 50 configuring 52 descriptions 51 Maximo 51 PO text 51 SAP 50 status values 52 units of measure 50, 52 multiplication-type cross reference controls 39

J
Java files naming conventions 47 user exit procedures 47 journals configuration general ledger 108 journals integration chart of accounts 108 filtering 113 integration points 114 interface controls 114 interfaces 114 tables 115 transaction types 111

N L
naming conventions Java user exit files 47 labor collaboration switches 294 labor integration batch report processing 127 data structure 121, 126, 129 effectivity of data 128 IDOC processing 128 integration point 129 interface controls 121, 123, 125, 128 overview 118 pay rates 118 labor time integration batch report processing 129 data structure 129 integration points 133 interface controls 121, 123, 125, 128 interfaces 132 prerequisite 129 tables 133 land in context user interface integration 12 languages, multiple 50, 51 launch entries user interface integration 11 line types purchasing 139

O
object structures data exchange 4 operational management product integration action 10 integration modules 10 logical management operations 10 process management products 9 operational management products integration 11 organization-level interface controls 38 organizations Maximo structure 33 ownership purchase orders 169

318

System Administrator Guide

Index

P
pay rates 118 PO autonumbering 165 PO number prefix 165 PO text multiple language support 51 PONUM autonumbering 74 PR number prefix 156 PR status updates data transfer 160 prerequisites queue-based inbound processing 27 PRNUM autonumbering 74, 156 process control ID, collaboration switch 284 process control value, collaboration switch 284 process management products operational management product integration 9 processing rules interface controls 38 publish channels data exchange 5 purchase order integration creating POs from contracts 152 filtering 168 inbound data considerations 169 inbound PO numbers 165 interface controls 172 multiple distributions 140 outbound data considerations 170 outbound PO numbers 165 overview 163 PO ownership 169 requirements 164 purchase orders collaboration switches 295 numbering 165 purchase requisition integration data structure 154 filtering 157 interface controls 158 PR numbers 156 requirements 155 reusing closed PR lines 160 purchase requisition status updates integration batch report processing 162 filtering 162 interface controls 163 overview 160 purchase requisitions collaboration switches 297 purchasing integration 135 purchasing groups batch report processing 187 purchasing integration line types 139 purchasing scenarios 136

Receipt tolerances MXITEM 194 receipts collaboration switches 299 receipts integration cost elements 208 IDOC processing 206 inbound processing 209 inspection 210 integration points 210 interface controls 209 interfaces 210 material receipts 207 movement types 208 outbound processing 206 purchase order line types 206 service receipts 208 tables 210 requirements contracts integration 151 invoice variances integration 184 invoices integration 174 purchase order integration 164 purchase requisition integration 155 reservations integration account configuration 216 interface 221 interface controls 216, 218, 220 movement types 219 overview 216 tables 221 Reverse invoice 174 RSARFCEX report 53

S
SAP Adapter components 14 SAP Applications architecture 14 SAP support 50 SAP transaction codes 57 SAP_UPDATE field 123, 146 chart of accounts 110 general ledger components 110 inventory vendor 203 inventory vendor integration 204 SAPAPOUT interface control 112 SAPGLCOMP interface control 103 SAPGLCONCAT interface control 105 scenarios purchasing and invoicing 136 service receipts 208 settings coordinating between systems 64 site-level interface controls 38 sites, Maximo 33 skill levels, craft and labor 118 status controls, purchasing 139 status values multiple language support 52 structure chart of accounts data 100 contract data 149 craft data 121 general ledger component data 100

R
Receipt tolerance MXINVENTORY 199, 202 POLINES 165

319

Index
inventory vendor data 201 labor data 121, 126 labor time data 129 purchase requisition data 154 SAP material master 190 vendor data 141 system IDs, collaboration switch 284 system-level interface controls 38 work order integration account configuration 216 chart of accounts 108 general ledger 108 integration points 219 interface 218 interface controls 216, 218, 220 outbound WO numbers 217 overview 216 tables 219 work orders collaboration switches 300 numbering 217

T
tables issues integration 213 journal integration 115 labor time integration 133 receipts integration 210 reservations integration 221 work order integration 219 transaction codes SAP accounting 60 SAP HR 61 SAP MM 58 transaction types journals 111

X
XI error handling 54

Z
ZBC_SAPMXCONFIG table 94

U
units of measure multiple language support 50, 52 user exit procedures Java 47 user interface integration land in context 12 launch entries 11

V
value type interface controls 39 vendor integration batch report processing 144 batch report ZBCXIREPR007 144, 160 bulk load action 146 data structure 141 data transfer 144 effectivity of data 145 interface controls 148 overview 141

W
web services data exchange 8 WO number prefix 217 WONUM autonumbering 217

320

System Administrator Guide

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Copyright IBM Corp. 2006, 2011

321

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

322

System Adminstrator Guide

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries.

323

324

System Adminstrator Guide