Status

  Approved

Owner
Stakeholders
Jira Request ID

ERP-1212 - Getting issue details... STATUS

Jira Development ID

ERP-1534 - Getting issue details... STATUS

High- Level Specification

Implementing SystemKinaxis Maestro
Invoked by/Invokes

ERP-1521 - Getting issue details... STATUS

Business Process Reference04.04.06.01. Data provisioning ERP to Maestro


Functional Overview

This table stores information required for Customer Hierarchy in Maestro.

Scope and Objective

The scope of this interface is between Global Integration Suite and Maestro. This document includes details of the CustomerGroupEnriched.tab object. 

The objective is to populate the CustomerGroupEnriched and it's referenced tables based on the file provided by Global Integration Suite.

Process Flow Diagram

draw.io

Source page access restriction: Click the link below to check if the page is accessible.
/display/ER/System+Interface+-+Reference+Specification+for+Maestro

Step

Description

1

Global Integration Suite transfers transformed Composites / Rest of World data from S/4, and performs some formatting, and sends the data to Maestro. 

3

Transferred files will be sent to Maestro’s Client SFTP server. This sits outside of the Maestro firewall and is accessible by client using a user id/ password. Files are transferred from this component to the Planning Server SFTP by a Kinaxis automatic process once the trigger file has been placed (see below)

4

Files are moved to this SFTP server automatically, where they await loading into Maestro.

5

Maestro uses the configured DSM (Data Sources and Mapping) setup to load the data into the CustomerGroupEnriched table, with the load initiated either manually or through a scheduled system task.

The Data Tables which store information in Maestro

Assumptions

See OnHand.tab System Interface document for assumptions.

Dependencies

See OnHand.tab System Interface document for dependencies.

Security, Integrity and Controls

See Application Architecture Kinaxis Maestro for security requirements for SFTP/REST based authentication and security. 

Configuration Requirements

The Data Sources and Mapping for this interface should be configured once, according to the structure in the Data Structure section below. 

The Data Model needs to be configured with the Syway-specific fields shown in the Data Model Custom Fields section below.

Special Requirements

None



Design Rationale

The base of this design has been taken from the existing Maestro implementation, as designed during the Advanced Planning System (APS) Project. 

A fit-gap analysis was undertaken within Syway, and changes were identified which have been incorporated into the Syway spec as shown.

API Use

The data object provided by either Integration Suite will be consumed by Maestro.

For more information see the Data Integration Document.

Data Structure

 The following Maestro fields will be populated by the file provided by Integration Suite:

Column NumberField NameTechnical Field NameData TypeKeyField TypeAutocreateDescription

1

Id

Id

String

Y

ExtractField


A value that uniquely identifies the enriched Customer Group

2

Description

Description

String

N

ExtractField


CustomerGroupEnriched Description

File Formats 

See File Formats - SFTP section in the Data Integration Document.


Data Model CustomerGroupEnriched table settings:

Allow Data update to:


Currency


Insert, Modify and Delete recordsInsert and Modify records only

Allow automatic record creation

Determined by Maestro

Expression

Y-YY-

Data Model CustomerGroupEnriched custom fields:

There are no additional custom fields in this table. See section Data Structure above.

Processing Logic

See Processing Logic - SFTP section in the Data Integration Document.

Delta or Full Load Requirements

The preference is to do a full load. 

For more information on the difference between Full and Delta loads, see the  Full Loads and Delta Loads - SFTP section in the Data Integration Document.

Interface Alert & Monitoring

See the Interface Alert & Monitoring - SFTP section in the Data Integration Document,

Language Requirements

None

User Interface Requirements

Not required.
 

Sequencing

N/A


Volumetrics

Current APS Volume of CustomerGroupEnriched records is 17171. Because APS makes up approximately 60% of Syway projected records, an expected estimate for Syway is therefore 27474.

This value is expected to grow by 1-2% per year. 



Performance Consideration

N/A


Error Handling

See Interface Alert & Monitoring section. 


Testing

How to Test

See OnHand.tab System Interface document for information on how to test.

There are no CustomerGroupEnriched-specific testing requirements.

Test Conditions and Expected Results

There are no CustomerGroupEnriched-specific test conditions.

Test Considerations/Dependencies

Dependent files should already be loaded into Maestro for these tests to complete. See Sequencing section above. 


Other Information


Development Details

Package

Package NameParent Package




Other Development Objects

Object TypeObject NamePurpose/High Level LogicDesign Rationale Reference









Appendix

See also


No files shared here yet.

Change log

Version Published Changed By Comment
CURRENT (v. 7) Apr 02, 2026 14:29 KAVLEKAR-ext, Nihaal Updated the Delta or Full load Requirement section
v. 6 Mar 12, 2026 11:04 KAVLEKAR-ext, Nihaal
v. 5 Feb 27, 2026 05:28 GARG-ext, Praful
v. 4 Feb 06, 2026 10:21 KAVLEKAR-ext, Nihaal
v. 3 Feb 06, 2026 07:51 KAVLEKAR-ext, Nihaal
v. 2 Feb 05, 2026 07:31 KAVLEKAR-ext, Nihaal
v. 1 Feb 04, 2026 08:58 KAVLEKAR-ext, Nihaal