XML DESADV – Leveringsbericht

  • 2 minutes to read

Het DESADV-bericht (Despatch Advice) wordt in twee richtingen gebruikt:

Richting Van → Naar Actie in Business Central
Uitgaand BC → Klant Verkoopverzending wordt via EDI gemeld
Inkomend Leverancier → BC Ontvangst op inkooporder wordt bijgewerkt

Uitgaand XML

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

Element Omschrijving
Message Intern EDI-documentnummer (gegenereerd door Business Central)
ShipmentNo Verzendingsnummer
PostingDate Boekingsdatum
DeliveryDate Verwachte leveringsdatum
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
CustomerGln GLN-code van de klant (factuuradres)
CustomerName Naam van de klant
CustomerAddress Adres van de klant
CustomerAddress2 Adres 2 van de klant
CustomerPostCode Postcode van de klant
CustomerCity Gemeente van de klant
CustomerCountryCode Landcode van de klant
CustomerVATNumber BTW-nummer van de klant
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

Regels (Lines > Line)

Element Omschrijving
SenderOrderNumber Verkoopordernummer van de afzender
SenderShipmentNumber Verzendingsnummer van de afzender
SenderLineId Regelreferentie van de afzender (orderregelnummer)
CustomerOrderNumber Ordernummer van de klant
CustomerLineId Regelreferentie van de klant
OrderDate Orderdatum
GTIN EAN-/GTIN-code van het artikel
GTINOrderUnit EAN-/GTIN-code van de besteleenheid
ItemNo Artikelnummer (intern)
Description Omschrijving van het artikel
Quantity Geleverde hoeveelheid
UoM Eenheidscode

XML Voorbeeld (uitgaand)

<?xml version="1.0" encoding="utf-8"?>
<Desadv>
  <Message>EDI-000002</Message>
  <ShipmentNo>VRZ-00456</ShipmentNo>
  <PostingDate>2026-05-05</PostingDate>
  <DeliveryDate>2026-05-06</DeliveryDate>
  <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>
  <CustomerGln>5419999000001</CustomerGln>
  <CustomerName>Klant NV</CustomerName>
  <CustomerAddress>Klantenstraat 1</CustomerAddress>
  <CustomerAddress2></CustomerAddress2>
  <CustomerPostCode>1000</CustomerPostCode>
  <CustomerCity>Brussel</CustomerCity>
  <CustomerCountryCode>BE</CustomerCountryCode>
  <CustomerVATNumber>BE0555444333</CustomerVATNumber>
  <ShipToGln>5419999000099</ShipToGln>
  <ShipToName>Klant NV – Magazijn</ShipToName>
  <ShipToAddress>Magazijnweg 10</ShipToAddress>
  <ShipToAddress2></ShipToAddress2>
  <ShipToPostCode>1020</ShipToPostCode>
  <ShipToCity>Brussel</ShipToCity>
  <ShipToCountryCode>BE</ShipToCountryCode>
  <Lines>
    <Line>
      <SenderOrderNumber>VRK-00789</SenderOrderNumber>
      <SenderShipmentNumber>VRZ-00456</SenderShipmentNumber>
      <SenderLineId>10</SenderLineId>
      <CustomerOrderNumber>PO-99001</CustomerOrderNumber>
      <CustomerLineId>1</CustomerLineId>
      <OrderDate>2026-04-28</OrderDate>
      <GTIN>5410000111333</GTIN>
      <ItemNo>ART-001</ItemNo>
      <Description>Artikel A</Description>
      <Quantity>100</Quantity>
      <UoM>PCE</UoM>
    </Line>
  </Lines>
</Desadv>

Inkomend XML

Het inkomende formaat gebruikt een <Envelope>-wrapper. Business Central werkt op basis van het inkomend bericht de te ontvangen hoeveelheid op de inkooporderregel bij.

De leverancier wordt opgezocht via zijn GLN-code. De inkooporderregel wordt gevonden via SenderOrderNumber (= inkoopordernummer) en SenderLineId (= regelnummer).

Envelope

Element Omschrijving
Sender GLN-code van de leverancier
Receiver GLN-code van eigen bedrijf
Version Versienummer
DocType Documenttype (waarde conform documentsoortinstelling, b.v. DESADV)
DocDt Documentdatum
DocNumber Documentnummer van de leverancier

Header (Message > Header)

Element Omschrijving
SenderOrderNumber Inkoopordernummer (wordt gebruikt om de inkooporder te vinden)

Partijen (Message > Party)

Qual EANCOM-omschrijving Gebruik in Business Central
BY Koper Verplicht – GLN bepaalt de eigen onderneming
SU Leverancier Verplicht – GLN wordt gebruikt om de leverancier op te zoeken

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

Regels (Message > Line)

Element Omschrijving
SenderLineId Regelnummer van de inkooporder
Quantity Te ontvangen hoeveelheid (wordt ingevuld als Qty. to Receive)

XML Voorbeeld (inkomend)

<?xml version="1.0" encoding="utf-8"?>
<Desadv>
  <Envelope>
    <Sender>5410000111222</Sender>
    <Receiver>5411234567890</Receiver>
    <Version>1</Version>
    <DocType>DESADV</DocType>
    <DocDt>2026-05-05</DocDt>
    <DocNumber>LVR-VRZ-0099</DocNumber>
  </Envelope>
  <Message>
    <Header>
      <SenderOrderNumber>INK-00123</SenderOrderNumber>
    </Header>
    <Party>
      <Qual>BY</Qual>
      <GLN>5411234567890</GLN>
    </Party>
    <Party>
      <Qual>SU</Qual>
      <GLN>5410000111222</GLN>
    </Party>
    <Line>
      <SenderLineId>10</SenderLineId>
      <Quantity>100</Quantity>
    </Line>
  </Message>
</Desadv>

Zie ook