Skip to main content

Ledger Segment Integration

LeaseAccelerator requires maintaining some master data such as:

  • Lessees

  • Funders

  • Entity

  • Business Units (SBU)

  • Vendors

  • Cost Centers

  • System users (with different roles and responsibilities)

  • People included in LeaseAccelerator workflow (asset owners, asset users, etc.)

  • Addresses

  • GL Accounts (codes)

  • Custom Participants

LeaseAccelerator allows clients to maintain master data through many options; user interface, Bulk import feature (CIW) and importing from ERPs and other sources via integration through any supported method. (See Master data integration for details).

When a client defines ledger(s), they select “Segment(s)” mapped to corresponding segments in the ERP system. LeaseAccelerator supports up to 11 segments for each ledger.

Usually, those segments are selected from available master data files, and they are called “Ledger Segments.”

Once a segment is selected for a ledger, the values for such segment can be synchronized with the sources system (ERP or other) through “Ledger Segment Integration” covered in this section.

Whenever the client retires values (entries) of the ledger segments or creates new ones, LeaseAccelerator must be synchronized to reflect the new values for the segments to maintain addressing the same values as the client’s ERP. LeaseAccelerator can be integrated with the source of this master data or segment values.

Download a PDF version of the Enterprise Integration User Guide.

Business architecture

The client can update the ledger segments in LeaseAccelerator as needed or on a regular basis. The client must update LeaseAccelerator for each segment.

When receiving updates, LeaseAccelerator expects to receive the full set of values, not only the new ones.

For each segment received, the system will match the received values to the existing values:

  • Matching values remain active; changes in name overwrite the existing name.

  • New values and their corresponding names are added and activated.

  • Old values not received in the update file are retired (marked inactive).

For example, a client configured LeaseAccelerator segments as follows:

Ledger Segment

Segment 1

Segment 2

Segment 3

Segment 4

Segment name

Company

Inter Company

Cost Center

Business Unit

The company may have two scenarios for updating the segment values:

  • A new entry needs to be added.

  • Descriptions need to be updated.

Adding a new entry

In the ERP, the client adds a new entry for the company in segment 1 (in the ERP which is – for example - mapped to the ASC 842 Ledger). The new entry has the value of 101 to represent “South Africa”. The client now needs to add this entry to LeaseAccelerator. The client must send a list of all active values for this segment, including the new entry. One of the entries should look like the following:

Source

Attribute

Name

Value

ASC 842 Ledger

company

-----

----

ASC 842 Ledger

company

South Africa

101

ASC 842 Ledger

company

-----

----

When LeaseAccelerator processes this entry, it fetches the source “ASC 842 Ledger” and the segment named “company” for a value code equal to “101”. When LeaseAccelerator does not find it, LeaseAccelerator automatically adds it.

Updating descriptions

The client decides that the official name for South Africa must be updated to Republic of South Africa and makes the update in the ERP. The same update must be made in LeaseAccelerator.

The client must send a list of all active values for this segment, including the updated description. One of the entries should look like the following:

Source

Attribute

Name

Value

ASC 842Ledger

company

-----

----

ASC 842 Ledger

company

Republic of South Africa

101

ASC 842 Ledger

company

-----

----

When LeaseAccelerator processes this entry, it fetches the source “ASC 842 Ledger” and the segment named “company” for a value code equal to “101”. LeaseAccelerator finds the record and recognizes that the name is different so LeaseAccelerator updates the name by overwriting the existing name and keeps the entry active.

Integration process


Process Step ID

Process Step Description

Phase

P100

Start

Extract Ledger Segments from ERP

P200

Extract Ledger Segments Values

Extract Ledger Segments from ERP

P300

Send LS Values to LeaseAccelerator

Update Ledger Segments in LeaseAccelerator

P400

Receive LS Values

Update Ledger Segments in LeaseAccelerator

P500

Validated?

Update Ledger Segments in LeaseAccelerator

P600

Retire Old Values & Activate New Values

Update Ledger Segments in LeaseAccelerator

P1000

Stop

Update Ledger Segments in LeaseAccelerator

P100: Start

The client’s integration engine automatically triggers this process. The engine can either run the export values for each segment individually and then follow the process for each segment or the engine can run the export values for all segments at one time.

P200: Extract ledger segments values

The client’s integration engine extracts the ledger segment values (entries). Each segment value can be extracted in a separate file or all segment values in one file. LeaseAccelerator can process it successfully using the Attribute field to identify the segment.

Each file must include all values for the exported segment(s), not just the new ones.

P300: send ledger segment values to LeaseAccelerator

Method

Process

Next Step

RESTful API

The client’s integration engine calls LeaseAccelerator API (DefineReferenceData) with proper request data and payload.

LeaseAccelerator validates and imports the payload. LeaseAccelerator acknowledges the request with an OK response.

P500

File- based

The client’s integration engine places the file into the client’s SFTP folder then to the client’s DMZ area then to LeaseAccelerator’s SFTP folder.

P400

P400: Receive ledger segment values files

LeaseAccelerator’s file-watcher automatically detects the Ledger Segment file. (Note that Ledger Segment values can also be uploaded manually using the Bulk Import functionality in the LeaseAccelerator application.)

P500: Validated?

LeaseAccelerator inspects the file for errors and potentially invalid entries.

Method

Process

Next Step

RESTful API

If the file contains any errors, LeaseAccelerator rejects it and sends error status in the API Response. The ledger segment value must be re- extracted, and the API called again. (P200)

Otherwise, LeaseAccelerator acknowledges the request with an OK response.

P600

File- based

If the file contains any errors, LeaseAccelerator rejects it and sends an email alert to the designated person. (P200).

P600

P600: Retire old values & activate new values

LeaseAccelerator matches the received entries to the existing ones as follows:

  • Matching values remain active, changes in name overwrite the existing name.

  • New values and their corresponding names are added and activated.

  • Old values not in the Ledger Segment file are retired and marked inactive.

LeaseAccelerator sends an email to the designated person.

P1000: Stop

The process ends, and the client updates the proper log.

Additional use cases

Cast trigger

The client needs to send one file, instead of five files.

Scenario

The client needs to send one file to update all segments, instead of sending one file for each ledger segment.

Steps and Expected Outcome:

The client combines the five files into one file and LeaseAccelerator processes it successfully using the Attribute field to identify the segment.

Integration data

During the integration process, LeaseAccelerator receives data from the Ledger Segment file as shown in the LS-C1 connection in the integration process diagram on page 49.

Ledger segments to LeaseAccelerator

LeaseAccelerator expects the following data structure:

Field

Type (Format)

Allowed to be Null

Comment

Source

Text

no

The source ledger from ERP. Sending empty ledger name updates all ledgers.

Attribute

Text

no

The segment name (company, cost center, etc.)

Name

Text

no

The segment entry name (USA, South Africa, etc.)

Value

Text

no

The segment entry value (usually digits, 101, 144, etc.)

If you don’t specify the source ledger to use to resolve the attribute you are updating in the received file, the LeaseAccelerator importer chooses the oldest unretired ledger which is “Default Ledger” and searches for a segment name that matches the sent “attribute.”

Was this article helpful?

We're sorry to hear that.