std.edi.partner
Handelspartner-Profile für AS2- und SFTP-Transportkanäle. Die Unit ist ein Metadaten-Registry — kein Netzwerktreiber. Sie definiert, wie Nachrichten an einen Partner übertragen werden (Protokoll, Host, Pfad, vereinbarte Nachrichtentypen, Sicherheitsoptionen).
Das Wire-Format ist Pipe-delimitierter Text (eine Zeile pro Partner):
protocol|partnerID|ourID|host|port|path|msgTypes|options
AS2|ACME-GmbH|MINE-Corp|as2.acme.com|4080|/as2|ORDERS,INVOIC|0
SFTP|ACME-FTP|MINE-Corp|sftp.acme.com|22|/edi/in|REMADV,ORDERS|1
import std.edi.partner;
// Partner definieren
var partner: int64 := alloc(EDI_PART_SIZE);
poke64(partner + EDI_PART_PROTOCOL, EDI_PART_PROTO_AS2);
poke64(partner + EDI_PART_PARTNERID, "ACME-GmbH" as int64);
poke64(partner + EDI_PART_PARTNERLEN, 9);
poke64(partner + EDI_PART_OURID, "MINE-Corp" as int64);
poke64(partner + EDI_PART_OURIDLEN, 9);
poke64(partner + EDI_PART_HOST, "as2.acme.com" as int64);
poke64(partner + EDI_PART_HOSTLEN, 12);
poke64(partner + EDI_PART_PORT, 4080);
poke64(partner + EDI_PART_MSGTYPES, EDI_PART_MSG_ORDERS + EDI_PART_MSG_INVOIC);
poke64(partner + EDI_PART_OPTIONS, EDI_PART_OPT_SIGN + EDI_PART_OPT_MDN_SYNC);
// Prüfen ob Partner INVOIC unterstützt
if (EdiPartnerSupports(partner, EDI_PART_MSG_INVOIC) == 1) {
PrintLn("INVOIC wird unterstützt");
}
free(partner, EDI_PART_SIZE);
Imports
Konstanten
Transport-Protokolle
| Konstante | Wert | Bedeutung |
EDI_PART_PROTO_AS2 | 1 | AS2-Transport (HTTPS + MDN) |
EDI_PART_PROTO_SFTP | 2 | SFTP-Transport |
Nachrichtentypen (Bit-Maske)
| Konstante | Bit | Nachrichtentyp |
EDI_PART_MSG_ORDERS | 1 | Bestellungen (ORDERS/ORDRSP/ORDCHG) |
EDI_PART_MSG_INVOIC | 2 | Rechnungen (INVOIC) |
EDI_PART_MSG_DESADV | 4 | Lieferschein/Wareneingang (DESADV/RECADV) |
EDI_PART_MSG_REMADV | 8 | Zahlungsavis (REMADV) |
EDI_PART_MSG_ORDERS_RSP | 16 | Auftragsbestätigungen |
EDI_PART_MSG_TRANSPORT | 32 | Transportnachrichten (IFTMIN etc.) |
EDI_PART_MSG_CUSTOMS | 64 | Zollnachrichten (CUSCAR etc.) |
EDI_PART_MSG_SEAFREIGHT | 128 | Seefrachtdaten (BAPLIE etc.) |
AS2-Optionen (Bit-Maske)
| Konstante | Bit | Bedeutung |
EDI_PART_OPT_SIGN | 1 | Ausgehende Nachrichten signieren |
EDI_PART_OPT_ENCRYPT | 2 | Ausgehende Nachrichten verschlüsseln |
EDI_PART_OPT_MDN_SYNC | 4 | Synchrones MDN (Message Disposition Notification) anfordern |
EDI_PART_OPT_COMPRESS | 8 | Payload komprimieren |
Struct
EdiPartner (EDI_PART_SIZE = 96 Bytes)
| Offset-Konstante | Inhalt |
EDI_PART_PROTOCOL | Transportprotokoll (EDI_PART_PROTO_*) |
EDI_PART_PARTNERID / EDI_PART_PARTNERLEN | Partner-ID (AS2-ID oder SFTP-User) |
EDI_PART_OURID / EDI_PART_OURIDLEN | Eigene ID beim Partner |
EDI_PART_HOST / EDI_PART_HOSTLEN | Hostname |
EDI_PART_PORT | TCP-Port (AS2: typisch 4080, SFTP: 22) |
EDI_PART_PATH / EDI_PART_PATHLEN | URL-Pfad (AS2) oder SFTP-Verzeichnis |
EDI_PART_MSGTYPES | Bit-Maske der vereinbarten Nachrichtentypen |
EDI_PART_OPTIONS | Bit-Maske der AS2-Optionen |
Funktionen
| Signatur | Beschreibung |
EdiPartnerValidate(partner: int64): int64 | Prüft Pflichtfelder (Protokoll, Partner-ID, Host). Gibt 0=ok, 1=Fehler. |
EdiPartnerSupports(partner: int64, msgType: int64): int64 | Prüft ob ein Nachrichtentyp-Bit gesetzt ist. Gibt 1=ja, 0=nein. |
EdiPartnerWrite(partner: int64, out: int64, outMax: int64): int64 | Serialisiert einen Partner als Pipe-delimited-Zeile. Gibt geschriebene Bytes zurück. |
EdiPartnerRead(buf: int64, bufLen: int64, partner: int64): int64 | Deserialisiert eine Partner-Zeile. Gibt 0=ok. |
EdiPartnerListWrite(partners: int64, count: int64, out: int64, outMax: int64): int64 | Schreibt mehrere Partner-Profile (eine Zeile pro Partner). |
EdiPartnerListRead(buf: int64, bufLen: int64, partners: int64, maxCount: int64): int64 | Liest mehrzeilige Partner-Datei; gibt Anzahl der gelesenen Profile. |
EdiPartnerFind(partners: int64, count: int64, partnerID: int64, idLen: int64): int64 | Sucht Partner-ID im Array; gibt Zeiger auf gefundenen EdiPartner oder 0. |
Codebeispiel — Partner-Liste laden und suchen
import std.edi.partner;
// Partner aus Datei lesen (Dateiinhalt vorher in buf geladen)
var partners: int64 := alloc(20 * EDI_PART_SIZE);
var count: int64 := EdiPartnerListRead(buf, bufLen, partners, 20);
// Partner "ACME-GmbH" suchen
var found: int64 := EdiPartnerFind(
partners, count, "ACME-GmbH" as int64, 9);
if (found != 0) {
var proto: int64 := peek64(found + EDI_PART_PROTOCOL);
if (proto == EDI_PART_PROTO_AS2) {
PrintLn("AS2-Partner gefunden.");
}
}
free(partners, 20 * EDI_PART_SIZE);
Hinweise
Netzwerk nicht enthalten: std.edi.partner liefert nur die Profile. Der eigentliche AS2/SFTP-Transport muss vom Caller implementiert werden.
Nachrichtentypen kombinieren: Mehrere Typen werden mit +-Operator kombiniert: EDI_PART_MSG_ORDERS + EDI_PART_MSG_INVOIC = 3 (Bits 0 und 1 gesetzt).
ORDERS_RSP vs ORDERS: Das Bit EDI_PART_MSG_ORDERS_RSP deckt Auftragsbestätigungen (ORDRSP) ab — separat von ORDERS (16 vs. 1).
Quelldatei
| Unit | Datei |
std.edi.partner | std/edi/partner.lyx |
Letzte Aktualisierung: 2026-06-16