Recently, in order to help users to better use the EDI system, we open source the mature EDI projects based on past project implementation experience. After the user installs the Zhixingzhiqiao EDI system, he only needs to download the sample code we have compiled and place it in the workspace designated by Zhixingzhiqiao to start using it.
Today's article mainly introduces the IKEA EDI project, how to obtain the open source project code and how to deploy it to the Zhixingzhiqiao EDI system.
ready to download and run
IKEA EDI to JSON
Use JSON files to generate a series of EDI documents to communicate with IKEA.
Download WorkflowDownload Sample Files
Introduction to IKEA EDI Solution
The IKEA EDI to JSON sample stream has pre-configured ports for converting the following transaction sets according to the EDI specification provided by IKEA:
1. PRODAT product size, weight, packaging information, IKEA sends to the supplier
2. PARTIN business unit information, IKEA sends to the supplier
3. ORDERS order, IKEA sends to the supplier
4. ORDRSP order confirmation, the supplier sends to IKEA
5 . IFTMBF Shipping booking request, supplier sends to IKEA
6. IFTMBC Shipping booking confirmation, IKEA sends to supplier
7. DESADV Shipping notification, supplier sends to IKEA
8. VERMAS Message to verify gross weight, supplier sends to IKEA
9 . INVOIC invoice, supplier sends to IKEA
It is a very common solution to realize the integration between the EDI system and the ERP system through JSON, which can effectively decouple the two systems, thereby improving the reliability and maintainability of the entire system.
The following ports form the core elements of the workflow:
1. AS2 port: It is used for the function of secure transmission through the Internet network, and confirms the IKEA information of IKEA DVS, such as AS2 ID, URL and public key certificate, so as to configure correctly.
2. EDIFACT Port: Generate EDI files from XML or convert EDI files to XML for further processing.
3. XMLMap port: provide a visual way to convert XML data from one structure to another, and establish a mapping relationship from source files to template files.
4. Branch port: judge and match XML to distinguish files of different business types.
5. Notify Port: Send email notifications to specified recipients.
6. JSON port: realize the function of converting between JSON files and XML files.
How to deploy the above workflow in the Zhixingzhiqiao EDI system?
create workspace
To run the Zhixingzhiqiao EDI system, navigate to the Workflow tab and click the gear icon in the upper right corner. Select the Create Workspace option to create a new workspace IKEA for this example stream.
import workspace
From the gear drop-down menu on the right, click Import Workspace. In the dialog that appears, select the downloaded sample flow IKEA.arcflow to import the relevant ports and settings. Or directly drag and drop IKEA.arcflow to the designated workspace.
After successfully importing the sample workflow, you will see the complete workflow as shown in the image below:
Perfect workflow configuration
Implement AS2 communication
Navigate to the Settings tab for the IKEA_AS2 port. Configure IKEA's AS2 information according to the AS2 document provided by IKEA, such as IKEA's AS2 ID, trading partner URL, trading partner certificate and other information. After the configuration is complete, please navigate to the "Input" tab to upload the test file to test the AS2 connection with IKEA, and at the same time navigate to the "Output" tab to view the file sent by IKEA.
At the same time, you need to configure the supplier's AS2 information under the Personal Settings tab: the supplier's AS2 ID, private key certificate, certificate password, etc.
Realize the format conversion from EDIFACT to database XML
The realization of file format conversion is mainly realized by means of EDIFACT port and XMLMap port. The XMLMap port has already pre-configured the data mapping, and the user does not need to perform additional operations. In the EDIFACT port, you need to fill in the real information of the user and IKEA under the setting tab to configure the switching head:
Supplementary Schemas
Since the EDIFACT specification with version number D16A is used in the IKEA EDI project, you need to find the following folder under the installation path of Zhixingzhiqiao EDI system: \www\app_data\edifact_schemas, decompress the D16A file in the sample file and place it in the above folder. As shown below:
Enter the test process
Taking the parsing direction (that is, receiving the ORDERS order from IKEA and converting it into JSON format) as an example, the test process is as follows:
Upload test file
Navigate to the EDIFACT port with Port ID IKEA_EDIFACTToXML and under the Input tab upload the previously downloaded sample file: ORDERS.edifact.
view JSON result
After the X12 port is issued, navigate to the JSON port whose port ID is IKEA_XMLToJSON, and under the output tab, you can see that the status of the 850 file just received is Success, and you can download the JSON to view the order data.
As shown below, this is a JSON file received from IKEA containing purchase order information.
{
"Header": {
"orderNo": "01206151111",
"createDate": "2022-03-21",
"orderType": "J",
"freeTextZ": "",
"transInfo": "",
"freeTextT": "",
"poNo": "01206151111",
"customerOrderNo": "",
"buyerNo": "5100-COM",
"buyerName1": "",
"buyerName2": "",
"buyerStreet1": "",
"buyerStreet2": "",
"buyerCity": "",
"buyertelephoneNo": "",
"deliveryNo": "123-STO",
"deliveryName1": "",
"deliveryName2": "",
"deliveryStreet1": "",
"deliveryStreet2": "",
"deliveryCity": "",
"deliverytelephoneNo": "",
"invoiceNo": "3400-COM",
"invoiceName1": "",
"invoiceName2": "",
"invoiceStreet1": "",
"invoiceStreet2": "",
"invoiceCity": "",
"invoicetelephoneNo": "",
"supplierNo": "23211-SUP",
"supplierName1": "",
"supplierName2": "",
"supplierStreet1": "",
"supplierStreet2": "",
"supplierCity": "",
"suppliertelephoneNo": "",
"deliveryCondition": "FCA",
"deliveryPlace": "Haining, CN",
"Detail": [
{
"lineItemNo": "1",
"buyerItemNo": "10251234",
"orderQty": "92",
"departureDate": "2022-03-04",
"lastDeliveryDate": "2022-03-03",
"netPrice": "3.87",
"currency": "CNY",
"loadPlanNo": "1",
"referenceNo": "",
"tariffNo": "940399",
"priorityNo": "0",
"entryFlagNo": "",
"transInstructionNo": "",
"serviceLevelNo": "1",
"fileName": "",
"fileFormatName": ""
}
]
}
}Are you up and running?
If the answer is yes, then congratulations you have successfully configured the IKEA EDI solution example workflow! If you encounter any problems or have any questions, please feel free to contact us.