Configuring Back Office Extension Integration

You must complete these tasks to configure the Back Office Extension integration.

Note: It is assumed that Infor ION and a supported ERP system are already installed and configured according to the documentation delivered with those products. For more information about configuring Back Office Extension with Infor CRM SLX, see the Infor CRM Implementation Guide.

The system administrator and users with the appropriate role can access these features. See What are Roles and Secured Actions?

To configure:

  1. Run the conversion utility provided for the selected version of Infor CRM SLX.
    Note: These options are not mandatory, are optional but have significant ramifications and must be enabled based on implementation-specific recommendations from the integrator or the Infor CRM SLX support team.
    • Master Data Consolidation
    • Isolate integrated content by logical ID
  2. Sign in as the administrator.
  3. Select Integrations from Administration or Integrations on the navigation bar. The Integrations list view is displayed.
  4. Select Back Office Extension in the Integrations list view. See Using the Integrations list view.
  5. View this information:
    Field Description/Action
    Integration Back Office Extension

    The name of the integration.

    Version The version of the integration.
    Sync Method ION

    Indicates the process in which information is synchronized between the integrated application and Infor CRM SLX.

    Authentication Type Basic

    The method for authenticating data.

    Note: The integration can fail, if the authentication type is changed.
    Link Type System

    The type of link used to synchronize data with the integrated application and Infor CRM SLX.

    Note: The data is managed through a single link.
    Enabled Use this option to enable or disable synchronization process for the integration.
    Note: When enabled, this option synchronizes data with the integrated application and Infor CRM SLX. This makes all the subsequent synchronization options available.
  6. Verify that the Enabled check box is selected.
    Note: You must clear the Enabled check box, to turn off synchronization.
  7. Click Save.
  8. Click the Reset Inbox Status option (if required) to reset the status of BODs that are yet to be processed due to a disruption in the synchronization process.
    Note: The Reset Inbox Status option is used for troubleshooting purpose. It is not recommended to reset the Inbox unless directed otherwise. Resetting the inbox status inappropriately can result in reprocessing of BODs.
  9. Click the Options tab to specify the required data.
    • Select the Tenant row, click the Value column. Specify the implementation specific Infor LTR Tenant ID provided by your integrator or Infor CRM SLX support team.
    • Select the Logical ID row, click the Value column. Specify the Infor CRM SLX Logical ID defined in the Infor LTR based ION Desk Connection Point editor.
    • Infor CRM SLX recommends leaving the remaining items as the default values, but the items can be edited:
      Contact Account Management Enabled
      This custom setting instructs the inbound processor to cascade changes to the account's account manager to the account's related contacts when the value is set to True.
      Success Message Expiration (in minutes)
      The number of minutes after which success messages are purged from the log. The default setting is 4320. A value of -1 means that success messages are not purged from the log.
      Error Message Expiration (in minutes)
      The number of minutes after which error messages are purged from the log. The default setting is -1 which means that error messages are not purged from the log.
      Local CRM Pricing Quote
      Indicate if local CRM pricing is allowed for quotes. By default, this value is set to False.
      Local CRM Pricing Opportunity
      Indicate if the local CRM pricing is allowed for opportunities. The By default, this value is set to True.
      Local CRM Pricing Sales Order
      Indicate if local CRM pricing is allowed for sales orders. By default, this value is set to False.
      Log Success Messages
      Indicate if the log can include successful transactions. To exclude successful transactions from the log, click the Value column and type False. Setting this option to False reduces the items that are displayed for each record on the Sync History tab.
      Inbound Process List Size
      The number of BODs to be processed by a single job service thread. The default value is 10.
      Inbox Message Fetch Size
      The maximum number of BODs processed at any given time. The default value is 1000.
      Out of Sequence Message Expiration (in hours)
      The length of time for which missing relationship information is stored in a log file. When BODs arrive out of sequence and have missing dependent data, the system stores the missing relationships in a log. The default value is 24 hours.
      Acknowledge Message Timeout (in minutes)
      The maximum delay for Infor CRM SLX back office to respond to the Process BOD request with the Acknowledge response. The default value is 10.
      Associate Roles to Unsynced Account
      The option to restrict the generation of new Ship to or Bill to records until after the associated account is successfully promoted. By default, this value is set to False. When set to True, Ship to or Bill to records can be created for an account, that has not yet been promoted.
      Inbound Poling Interval (in seconds)
      The time duration (in seconds) between inbound sync jobs. The duration is defined as the time period between the completion of one inbound sync job and the start of the next inbound sync job. The default value is 15.
      Outbound Poling Interval (in seconds)
      The time duration (in seconds) between outbound sync jobs. The duration is defined as the time period between the completion of one outbound sync job and the start of the next outbound sync job. The default value is 15.
      Default Quote Duration (in days)
      The default time duration (in days) between the start date and expiration date when creating a quote, if the expiration date is not specified.
      Numeric Culture
      The Culture setting used by the Job Server when parsing numeric content saved in BODs. Although this field is editable, you must not modify the default setting (en-US) unless instructed to do so by Infor CRM SLX Support Personnel.
      Prepend Code to Description for Picklist
      This option is used by host applications for publishing the SyncCodeDefinition BODs at the Accounting Entity level. By default the value is set to False. If the integrated host ERP application publishes unique integrated picklist items at the Accounting Entity level, set this value to True.
      Normalize Base Currency Values
      The value can be set to True to enable inbound BOD handling to use the CRM based exchange rates. This normalizes the base currency values published by the host system in a currency other than the Infor CRM SLX base currency.
      Block Quote For Promoted Records
      The value can be set to True to prevent the promotion of updated quote content for host applications. For example, CSD does not support the promotion of updated CRM quote content.
      Block Quote For Non-Promoted Records
      The value can be set to True to prevent the promotion of new quotes for host applications. For example, CSD does not support the promotion of CRM quote content.
      Block Sales Order For Promoted Records
      The value can be set to True to prevent the promotion of modified sales order content for host applications. For example, CSD does not support the promotion of updated Infor CRM SLX Sales Orders.
      Block Sales Order For Non-Promoted Records
      The value can be set to True to prevent the promotion of new sales orders for host applications. For example, CSD does not support the promotion of CRM sales order content.
      Read Only Quote On Promotion
      The value can be set to True to prevent the modification of quotes for host applications. For example, CSD does not support the promotion of updated CRM Quote content.
      Read Only Sales Order On Promotion
      The value can be set to True prevents the modification of promoted sales order content for host applications. For example, CSD does not support the promotion of updated CRM Sales Order content.
      Publish All Addresses
      This value can be set to True to integrate primary and alternate addresses with the host ERP application. This custom setting enables the outbound processor to publish multiple addresses. By default, the value is set to False.
      Freight Reason Code
      This is the implementation-specific distributed charge freight reason code. (For CSD it corresponds to the CSD-based CRM Freight Addon reason code. For CSI a value of Freight is required.
      Display snapshot shipping summary
      The value can be set to True to view Shipping information in the Sales Order snapshot. By default, the value is set to False. (Supported by both CSD, and CSI.)
      Include ERP Freight Rates
      The value can be set to False to disable the CSD Freight Rate Shopping functionality for Infor CRM SLX based Sales Orders. By default the value is set to True.
      Maximum IOBOX Update Batch Size
      The limit on the number of Inbox records can be updated in a single SQL update statement when changing the status of the pending BOD records. By default the value is set to 1000.
      Sync max percentage of threads to consume in decimal format
      The portion (as a decimal) of 10 worker threads that can be used for inbound BOD processing. By default the value is set to 0.8.
      Sync max thread load governor in KBytes
      The maximum BOD content size (in kilobytes) that each inbound worker thread can process. By default the value is set to 40960 (40 MB in KB).
      Sync reload low water factor in decimal format

      The value indicates if the inbound processor can add more prioritized BODs to the in-process queue and sets the maximum fraction (as a decimal) of the “Inbox Message Fetch Size” that can remain in the queue before reloading with the next batch of prioritized BODs. By default the value is set to 0.2.

      Sync delay between worker threads in seconds
      The setting defines the delay time (in seconds) between the start of each inbound processing thread. By default the value is set to 5 seconds.
      Include CRM Products
      The value is set to True to include non-integrated (CRM) products in the Quote and Sales Order Product lookup. By default the value is set to False. If the integrated host ERP application can process CRM products as write-in products, set this value to True.
      Master Data Consolidation
      The Master Data Consolidation feature is an optional capability that combines data published across multiple Accounting Entities that reference a common ERP Customer ID or Contact ID. This consolidation results in unified Accounts and Contacts that reference transactions from all active Accounting Entities, providing a comprehensive, consolidated view.

      Modifying the option setting manually is not recommended as that is not compressing or adjusting any pre existing data content. To properly enable the optional Master Data Consolidation feature, the Conversion Utility must be used to ensure that all necessary data transformations and consolidations occur correctly.

      Integrated Primary Contact indicator
      The Primary contact indicator is not displayed on the Contact details page, when the value is set to True. Instead, the new primary contact flag displayed on the Contact, Account Associations or Account, Contact Associations tab. Changes to the integrated primary contact must be made on the Account, Contacts Associations tab grid.
      Type of Order Location
      The Quote and Sales Order location lookup filter criteria for the selection of the transaction's integrated location value. Type Office, Warehouse or Site to indicate the type of location required by the host ERP system. To hide the Quote and Sales Order location lookup controls, the field value must be blank. The type of Order location by ERP:
      • SX: Warehouse
      • LN: Office, Site or Warehouse
      • M3: Warehouse
      • CSI: Warehouse
      • Visual: Site
      Price Overrides enabled
      The value is set to True to allow authorized users to override the unit price on quotes or sales orders. These host ERP systems support integrated Infor CRM SLX Sales Order price overrides:
      • Infor Syteline
      • Infor CloudSuite Industrial
      • Infor Distribution SX.e
      • Infor LN
      • Infor M3
      Note: Infor CRM SLX supports price overrides for quote-based unit pricing. However, promoting quotes containing Infor CRM SLX-based price overrides is not supported.
      Price Adjustments enabled
      The value is set to True to allow authorized users to apply price adjustments to unit pricing on quotes or sales orders. These host ERP systems support integrated Infor CRM SLX Sales Order containing price adjustments:
      • Infor Syteline
      • Infor CloudSuite Industrial
      • Infor LN
      Note: Infor CRM SLX supports price adjustments for Quote-based unit pricing. However, promoting Quotes containing CRM SLX-based price adjustments is not supported.
      CRM Price Override Reason Code
      The implementation-specific line-level Distributed Charge Reason Code, published for the combined ERP and Infor CRM SLX-based price adjustment percentage. Possible scenarios:
      • SyteLine or CSI integrations: The Data Value field must be blank.
      • LN integrations: Set the Data Value to the implementation-specific line-level Distributed Charge Reason Code, published for the summary CRM-based SalesOrderLine/DistributedCharge Bod element.
      Note: For assistance defining this unique Distributed Charge Reason Code, check with the LN administrator or integrator.
      ERP Price Override Reason Code
      The implementation-specific line-level Distributed Charge Reason Code, published for the combined ERP and Infor CRM SLX-based price adjustment percentage. Possible scenarios:
      • SyteLine or CSI integrations: Set the Data Value to Discount.
      • LN integrations: Set the Data Value to the implementation-specific line-level Distributed Charge Reason Code, published for the summary ERP-based SalesOrderLine/DistributedCharge Bod element.
      Note: For assistance defining this unique Distributed Charge Reason Code, check with the LN administrator or integrator.
      Filter products by transaction
      The option to specify the Quote and Sales Order Product filtered lookup criteria, based on the transaction’s location settings. Select one of these options based on the requirements of the integrated host ERP system:
      • Logical ID
      • Accounting Entity
      • Warehouse
      • Site
      Filter products by fixed Logical Id
      The option to specify the Quote and Sales Order filtered Product lookup criteria, based on a specified Logical ID. Enter The Back Office Logical ID that publishes the host ERP system's products to be used for all Quotes and Sales Orders. This value is considered only if, the Filter products by transaction custom setting is not specified.
    • Click Save.
  10. Click the Outbound Message Settings tab to define the parent-child relationships that can auto-promote parent records based on modifications to one or more of the dependent child records. See Outbound Message Settings tab.
    • Infor CRM SLX recommends leaving the remaining Outbound Message Settings with the out of the box settings unless otherwise instructed by CRM SLX support.
      Contact
      The contact reference defined by the integrated back office application.
      Account
      The customer reference defined by the integrated back office application.
      ERPBill To
      The Bill To reference defined by the integrated back office application.
      ERPPay From
      The Pay From reference defined by the integrated back office application.
      Address
      The address reference defined by the integrated back office application.
      ERPTrading Account
      The account reference defined by the integrated back office application.
      ERPBillTo Contact
      The contact reference defined by the integrated back office application. A many-to-many relationship exists between Bill To and Contact.
      ERPBillTo Account
      The account reference defined by the integrated back office application. A many-to-many relationship exists between Bill To and Account.
      ERPContact Account
      The contact relationship defined by the integrated back office application.
      Sales Order
      The sales order reference defined by the integrated back office application.
      Quote
      The quote reference defined by the integrated back office application.
      ERPShipTo Account
      The customer reference defined by the integrated back office application. A many-to-many relationship exists between Ship To and Account.
      ERPShipToContact
      The customer reference defined by the integrated back office application. A many-to-many relationship exists between Ship To and Contact.
      ERPBillTo ShipTo
      The customer reference defined by the integrated back office application. A many-to-many relationship exists between Bill To and Ship To.
      ERPPayFrom BillTo
      The billing address defined by the integrated back office application. A many-to-many relationship exists between Pay From and Bill To.
      ERPPayFrom Contact
      The contact relationship defined by the integrated back office application. A many-to-many relationship exists between Pay From and Contact.
      Quote Item
      The quote item defined by the integrated back office application.
      Quote Address
      The quote address defined by the integrated back office application.
      SalesOrder Item
      The sales order item defined by the integrated back office application.
    • Click Save.
  11. Click the Back Offices tab to select the required back office, See Back Office tab. Use the Back Office detail view to:
    1. Configure the back office information fields. See Using the Back Office detail view.
    2. Add a new accounting entity using the Accounting Entities tab. See Adding an accounting entity (back office extension).
    Note: If the required back office does not exist, the standard Bod Pack for the integrated host ERP system must be installed.
  12. Use the BOD Mapping detail view to:
    1. Modify an existing BOD mapping. See Using the BOD mappings detail view.
    2. Add a BOD field mapping. See Defining a BOD field mapping.
    3. Edit a BOD field mapping. See BOD Mappings tab.
    Note: 
  13. Add the users to the Integration role to give individual users access these administrative integration views:
    • Back Office
    • BOD Mappings
    • Field Mappings
    • ERP Persons
  14. Add the users to the BackOffice role to give individual users access to these non-administrative integration views:
    • Invoices
    • Receivables
    • Shipments
    • Bill To
    • Ship To
    • Pay From
    • ERP Persons (View)