ballerinax/edifact.d03a.supplychain Ballerina library

Overview

UN/EDIFACT is the United Nations standard for electronic data interchange, used to exchange business documents such as orders, invoices and despatch advices between trading partners.

This package provides Ballerina record types and parser functions for the 29 UN/EDIFACT D03A messages grouped under supplychain: purchase orders, changes and responses, delivery schedules and just-in-time calls, despatch and receiving advices, inventory and order status reports, party information, documentary credit messages, cargo insurance claims, and superannuation messages.

Key Features

• Typed records for all 29 messages in the supplychain group, each in its own submodule, so a program only pulls in the records for the messages it handles.
• Envelope-aware parsing and serialization: an interchange is read from UNB through UNZ, including the UNH/UNT message header and trailer.
• Round-trips in both directions — EDI text to records, and records back to conformant EDI text with the UNT segment count recomputed.
• Generated from the UN/EDIFACT D03A directory with the Ballerina EDI tool, so the records follow the published specification.

Quickstart

To use the edifact.d03a.supplychain package in your Ballerina application, modify the .bal file as follows:

Step 1: Import the module

Import the package and the submodules for the messages you handle.

import ballerina/io;
import ballerinax/edifact.d03a.supplychain;
import ballerinax/edifact.d03a.supplychain.mORDERS;

Step 2: Read an EDI message

Convert an EDIFACT interchange into a Ballerina record.

public function main() returns error? {
    string ediText = check io:fileReadString("orders.edi");
    mORDERS:EDI_ORDERS_ORDERS message =
        check supplychain:fromEdiString(ediText, supplychain:EDI_ORDERS).ensureType();
    io:println(message);
}

supplychain:getEDINames() returns every message name this package supports. interchangeFromEdiString gives access to the full UNB/UNZ interchange, and headersFromEdiString reads just the headers.

Step 3: Write an EDI message

Convert a Ballerina record back into an EDIFACT interchange.

string ediText = check supplychain:toEdiString(message, supplychain:EDI_ORDERS);

Use interchangeToEdiString to write the full interchange rather than the message body alone.

Step 4: Run the Ballerina application

bal run

Supported messages