XML ORDERS – Inkooporder / Verkooporder

  • 2 minutes to read

Het ORDERS-bericht wordt in twee richtingen gebruikt:

Richting Van → Naar Actie in Business Central
Uitgaand BC → Leverancier Inkooporder wordt via EDI verstuurd
Inkomend Klant → BC Verkooporder wordt automatisch aangemaakt

Uitgaand XML

Het root-element is <Order>. Partijgegevens worden als directe child-elementen opgenomen (geen <Party>-wrapper).

Element Omschrijving
Message Intern EDI-documentnummer (gegenereerd door Business Central)
OrderNo Inkoopordernummer
OrderDate Orderdatum
RequestedReceiptDate Gewenste ontvangstdatum
SenderGln GLN-code van de afzender (eigen bedrijf)
SenderName Naam van de afzender
SenderAddress Adres van de afzender
SenderAddress2 Adres 2 van de afzender
SenderPostCode Postcode van de afzender
SenderCity Gemeente van de afzender
SenderCountryCode Landcode van de afzender
SenderVATNumber BTW-nummer van de afzender
ShipToGln GLN-code van het afleveradres
ShipToName Naam van het afleveradres
ShipToAddress Adres van het afleveradres
ShipToAddress2 Adres 2 van het afleveradres
ShipToPostCode Postcode van het afleveradres
ShipToCity Gemeente van het afleveradres
ShipToCountryCode Landcode van het afleveradres
VendorGln GLN-code van de leverancier
VendorName Naam van de leverancier
VendorAddress Adres van de leverancier
VendorAddress2 Adres 2 van de leverancier
VendorPostCode Postcode van de leverancier
VendorCity Gemeente van de leverancier
VendorCountryCode Landcode van de leverancier
VendorVATNumber BTW-nummer van de leverancier

Regels (Lines > Line)

Element Omschrijving
LineId Regelnummer
GTINOrderUnit GTIN-code van de besteleenheid
GTIN EAN-/GTIN-code van het artikel
Description Omschrijving van het artikel
OrderUnit Besteleenheid
Quantity Bestelde hoeveelheid
BaseQuantity Basishoeveelheid (per besteleenheid)
UnitPrice Eenheidsprijs
Discount Kortingspercentage

XML Voorbeeld (uitgaand)

<?xml version="1.0" encoding="utf-8"?>
<Order>
  <Message>EDI-000001</Message>
  <OrderNo>INK-00123</OrderNo>
  <OrderDate>2026-05-05</OrderDate>
  <RequestedReceiptDate>2026-05-12</RequestedReceiptDate>
  <SenderGln>5411234567890</SenderGln>
  <SenderName>Mijn Bedrijf NV</SenderName>
  <SenderAddress>Industrieweg 1</SenderAddress>
  <SenderAddress2></SenderAddress2>
  <SenderPostCode>9000</SenderPostCode>
  <SenderCity>Gent</SenderCity>
  <SenderCountryCode>BE</SenderCountryCode>
  <SenderVATNumber>BE0123456789</SenderVATNumber>
  <ShipToGln>5419876543210</ShipToGln>
  <ShipToName>Magazijn Noord</ShipToName>
  <ShipToAddress>Havenstraat 5</ShipToAddress>
  <ShipToAddress2></ShipToAddress2>
  <ShipToPostCode>9040</ShipToPostCode>
  <ShipToCity>Gent</ShipToCity>
  <ShipToCountryCode>BE</ShipToCountryCode>
  <VendorGln>5410000111222</VendorGln>
  <VendorName>Leverancier BV</VendorName>
  <VendorAddress>Leveranciersstraat 10</VendorAddress>
  <VendorAddress2></VendorAddress2>
  <VendorPostCode>2000</VendorPostCode>
  <VendorCity>Antwerpen</VendorCity>
  <VendorCountryCode>BE</VendorCountryCode>
  <VendorVATNumber>BE0987654321</VendorVATNumber>
  <Lines>
    <Line>
      <LineId>10</LineId>
      <GTINOrderUnit>5410000111333</GTINOrderUnit>
      <GTIN>5410000111333</GTIN>
      <Description>Artikel A</Description>
      <OrderUnit>PCE</OrderUnit>
      <Quantity>100</Quantity>
      <BaseQuantity>1</BaseQuantity>
      <UnitPrice>12.50</UnitPrice>
      <Discount>5</Discount>
    </Line>
  </Lines>
</Order>

Inkomend XML

Het inkomende formaat gebruikt een <Envelope>-wrapper. Business Central maakt op basis van het inkomend bericht automatisch een verkooporder aan.

De klant (koper) wordt opgezocht op basis van zijn GLN-code. Het artikel wordt opgezocht via de GTIN-code of de SupplierArticleCode.

Envelope

Element Omschrijving
Sender GLN-code van de zendende partij (klant)
Receiver GLN-code van de ontvangende partij (eigen bedrijf)
Version Versienummer
DocType Documenttype (waarde conform documentsoortinstelling, b.v. ORDERS)
DocDt Documentdatum
DocNumber Documentnummer van de afzender

Header (Message > Header)

Element Omschrijving
OrderNumber Ordernummer van de klant (wordt ingevuld als External Document No.)
CustomerRef Referentie van de klant (wordt ingevuld als Your Reference)
OrderDt Orderdatum
ReqDeliveryDt Gewenste leveringsdatum
SupplierRef Ons ordernummer (optioneel)
EarliestDeliveryDt Vroegst mogelijke leveringsdatum (optioneel)
LatestDeliveryDt Laatste leveringsdatum (optioneel)
DiscountPct Algemeen kortingspercentage (optioneel)
Remark Opmerking (optioneel)

Partijen (Message > Party)

Qual EANCOM-omschrijving Gebruik in Business Central
SU Leverancier Verplicht – GLN bepaalt de eigen onderneming
BCO Beneficial Cargo Owner Voorkeur koper – heeft voorrang op BY; GLN wordt gebruikt om de klantenkaart op te zoeken
BY Koper Verplicht (fallback) – GLN wordt gebruikt om de klantenkaart op te zoeken
IV Factuurontvanger Optioneel – GLN wordt gebruikt als afwijkend factuuradres (Bill-to Customer)
PW Afleveradres (Despatch party) Optioneel – GLN wordt gebruikt om het afleveradres (Ship-to Address) op te zoeken

Elk <Party>-element bevat minimaal <Qual> en <GLN>.

Regels (Message > Line)

Element Omschrijving
LineId Regelnummer van de klant
GTIN EAN-/GTIN-code van het artikel
SupplierArticleCode Ons artikelnummer (fallback als GTIN niet gevonden wordt)
Qty Bestelde hoeveelheid
OrderUnit Besteleenheid (optioneel)
Price Prijs (optioneel)
DiscountPct Kortingspercentage (optioneel)
LineAmount Regelbedrag (optioneel)
ReqDeliveryDt Gewenste leveringsdatum per regel (optioneel)

XML Voorbeeld (inkomend)

<?xml version="1.0" encoding="utf-8"?>
<Order>
  <Envelope>
    <Sender>5419999000001</Sender>
    <Receiver>5411234567890</Receiver>
    <Version>1</Version>
    <DocType>ORDERS</DocType>
    <DocDt>2026-05-05</DocDt>
    <DocNumber>PO-99001</DocNumber>
  </Envelope>
  <Message>
    <Header>
      <OrderNumber>PO-99001</OrderNumber>
      <CustomerRef>REF-2026-001</CustomerRef>
      <OrderDt>2026-05-05</OrderDt>
      <ReqDeliveryDt>2026-05-12</ReqDeliveryDt>
    </Header>
    <Party>
      <Qual>SU</Qual>
      <GLN>5411234567890</GLN>
    </Party>
    <Party>
      <Qual>BY</Qual>
      <GLN>5419999000001</GLN>
    </Party>
    <Party>
      <Qual>PW</Qual>
      <GLN>5419999000099</GLN>
    </Party>
    <Line>
      <LineId>1</LineId>
      <GTIN>5410000111333</GTIN>
      <SupplierArticleCode>ART-001</SupplierArticleCode>
      <Qty>100</Qty>
      <OrderUnit>PCE</OrderUnit>
      <Price>12.50</Price>
      <DiscountPct>5</DiscountPct>
    </Line>
  </Message>
</Order>

Zie ook