XML INVOIC – Factuur / Creditnota

  • 4 minutes to read

Het INVOIC-bericht wordt in twee richtingen gebruikt:

Richting Van → Naar Actie in Business Central
Uitgaand BC → Klant Verkoopfactuur of creditnota wordt via EDI verstuurd
Inkomend Leverancier → BC Aankoopfactuur wordt automatisch aangemaakt

Uitgaand XML

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

Element Omschrijving
Message Intern EDI-documentnummer (gegenereerd door Business Central)
Type Documenttype: Invoice of Credit Memo (zoals ingesteld in de documentsoortinstelling)
InvoiceNo Factuurnummer
PostingDate Boekingsdatum
DueDate Vervaldatum
PmtDiscountPercentage Kortingspercentage bij tijdige betaling
PmtDiscountDate Uiterste datum voor betalingskorting
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
BillToCustomerNo GLN-code van de factuurontvanger
BillToCustomerName Naam van de factuurontvanger
BillToCustomerAddress Adres van de factuurontvanger
BillToCustomerAddress2 Adres 2 van de factuurontvanger
BillToCustomerPostCode Postcode van de factuurontvanger
BillToCustomerCity Gemeente van de factuurontvanger
BillToCustomerCountryCode Landcode van de factuurontvanger
BillToCustomerVATNumber BTW-nummer van de factuurontvanger
CurrencyCode Valutacode
TotalAmount Totaalbedrag excl. BTW
TotalVATAmount Totaal BTW-bedrag
TotalAmountInclVAT Totaalbedrag incl. BTW

Regels (Lines > Line)

Elke factuurregel bevat de volledige klant- en afleveradressen, referenties naar de originele order en verzending, artikelgegevens en bedragen.

Element Omschrijving
CustomerNo Klantnummer (intern)
CustomerGln GLN-code van de klant
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
ShipToCode Code van het afleveradres
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
SenderOrderNumber Verkoopordernummer van de afzender
SenderLineId Orderregelnummer van de afzender
CustomerOrderNumber Ordernummer van de klant
CustomerLineId Regelreferentie van de klant
DeliveryNoteNumber Verzendingsnummer (leveringsbon)
OrderDate Orderdatum
ShipmentDate Verzenddatum
GTIN EAN-/GTIN-code van het artikel
ItemNo Artikelnummer (intern)
Description Omschrijving van het artikel
Quantity Gefactureerde hoeveelheid
UnitPrice Eenheidsprijs
Discount Kortingspercentage
LineAmount Regelbedrag (voor factuurkorting)
InvDiscAmount Factuurkortingsbedrag
Amount Bedrag excl. BTW (na korting)
VATIdentifier BTW-identificatiecode
VATPercentage BTW-percentage
VATBaseAmount BTW-grondslag
VATAmount BTW-bedrag
AmountInclVAT Bedrag incl. BTW

XML Voorbeeld (uitgaand)

<?xml version="1.0" encoding="utf-8"?>
<Invoice>
  <Message>EDI-000003</Message>
  <Type>Invoice</Type>
  <InvoiceNo>VRK-FAC-00100</InvoiceNo>
  <PostingDate>2026-05-05</PostingDate>
  <DueDate>2026-06-04</DueDate>
  <PmtDiscountPercentage>2</PmtDiscountPercentage>
  <PmtDiscountDate>2026-05-15</PmtDiscountDate>
  <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>
  <BillToCustomerNo>5419999000001</BillToCustomerNo>
  <BillToCustomerName>Klant NV</BillToCustomerName>
  <BillToCustomerAddress>Klantenstraat 1</BillToCustomerAddress>
  <BillToCustomerAddress2></BillToCustomerAddress2>
  <BillToCustomerPostCode>1000</BillToCustomerPostCode>
  <BillToCustomerCity>Brussel</BillToCustomerCity>
  <BillToCustomerCountryCode>BE</BillToCustomerCountryCode>
  <BillToCustomerVATNumber>BE0555444333</BillToCustomerVATNumber>
  <CurrencyCode>EUR</CurrencyCode>
  <TotalAmount>1000.00</TotalAmount>
  <TotalVATAmount>210.00</TotalVATAmount>
  <TotalAmountInclVAT>1210.00</TotalAmountInclVAT>
  <Lines>
    <Line>
      <CustomerNo>KL-001</CustomerNo>
      <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>
      <ShipToCode>MAG</ShipToCode>
      <ShipToGln>5419999000099</ShipToGln>
      <ShipToName>Klant NV – Magazijn</ShipToName>
      <ShipToAddress>Magazijnweg 10</ShipToAddress>
      <ShipToAddress2></ShipToAddress2>
      <ShipToPostCode>1020</ShipToPostCode>
      <ShipToCity>Brussel</ShipToCity>
      <ShipToCountryCode>BE</ShipToCountryCode>
      <SenderOrderNumber>VRK-00789</SenderOrderNumber>
      <SenderLineId>10</SenderLineId>
      <CustomerOrderNumber>PO-99001</CustomerOrderNumber>
      <CustomerLineId>1</CustomerLineId>
      <DeliveryNoteNumber>VRZ-00456</DeliveryNoteNumber>
      <OrderDate>2026-04-28</OrderDate>
      <ShipmentDate>2026-05-05</ShipmentDate>
      <GTIN>5410000111333</GTIN>
      <ItemNo>ART-001</ItemNo>
      <Description>Artikel A</Description>
      <Quantity>100</Quantity>
      <UnitPrice>12.50</UnitPrice>
      <Discount>5</Discount>
      <LineAmount>1187.50</LineAmount>
      <InvDiscAmount>187.50</InvDiscAmount>
      <Amount>1000.00</Amount>
      <VATIdentifier>BTW21</VATIdentifier>
      <VATPercentage>21</VATPercentage>
      <VATBaseAmount>1000.00</VATBaseAmount>
      <VATAmount>210.00</VATAmount>
      <AmountInclVAT>1210.00</AmountInclVAT>
    </Line>
  </Lines>
</Invoice>

Inkomend XML

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

De leverancier wordt opgezocht via de GLN van de partij met <Qual>SU</Qual>. De eigen onderneming wordt bepaald via de GLN van de partij met <Qual>IV</Qual>. De aankoopfactuurregels worden aangemaakt vanuit de bijbehorende ontvangsten op de inkooporder.

Envelope

Element Omschrijving
Sender GLN-code van de leverancier
Receiver GLN-code van eigen bedrijf
Version Versienummer
DocType Documenttype (waarde conform documentsoortinstelling, b.v. GENERIC_INVOICE_SCO)
DocDt Verzend-datum en -tijdstip van het bericht (b.v. 2020/05/01 15:41)
DocNumber Uniek berichtnummer
Test Aanwezig bij testberichten (leeg element, optioneel)

Header (Message > Header)

Element Omschrijving
InvoiceNr Factuurnummer van de leverancier
InvoiceType Factuurtype (b.v. IV = factuur)
InvoiceTypeEancom EANCOM-factuurtype (b.v. 380 = standaardfactuur)
InvoiceDt Factuurdatum
BuyerOrderDt Datum van de inkooporder van de koper
DeliveryDt Leveringsdatum
Currency Valutacode
DeliveryNote Nummer van de leveringsbon
BuyerOrderNumber Ordernummer van de koper (inkoopordernummer in Business Central)
TotalAmount Totaalbedrag excl. BTW
VATBaseAmount BTW-grondslag
VATAmount Totaal BTW-bedrag

Partijen (Message > Parties > Party)

De partijen worden gegroepeerd in een <Parties>-element. Elk <Party>-element bevat <Qual>, <Gln> en <VATRegNumber>.

Qual EANCOM-omschrijving Gebruik in Business Central
BY Koper Koperidentificatie (optioneel)
DP Afleveradres Afleveradres (optioneel)
IV Factuurontvanger Verplicht – GLN bepaalt de eigen onderneming
SU Leverancier Verplicht – GLN wordt gebruikt om de leverancier op te zoeken

Regels (Message > Lines > Line)

Element Omschrijving
LineId Regelnummer in het EDI-bericht
GTINArticle GTIN-code van het artikel
SupplierArticleCode Artikelcode van de leverancier
SupplierArticleDescr Artikelomschrijving van de leverancier
InvoicedQty Gefactureerde hoeveelheid
PriceWithoutAC Eenheidsprijs excl. kortingen/toeslagen
BuyerOrderNumber Inkoopordernummer van de koper (zoekt de bijbehorende inkooporder op)
BuyerOrderLineNumber Orderregelnummer van de koper (zoekt de inkooporderregel op)
LineSubTotal Regelbedrag voor kortingen/toeslagen
LineTotal Totaal regelbedrag
LineVAT BTW-bedrag op de regel
ChargeAndAllowances Kortingen en toeslagen (leeg element indien niet van toepassing)

Totalen (Message > Totals)

Element Omschrijving
VATTotals > VATTotal > VATPct BTW-percentage
VATTotals > VATTotal > VATBase BTW-grondslag voor dit percentage
VATTotals > VATTotal > VATAmount BTW-bedrag voor dit percentage
ChargeAndAllowances Documentbrede kortingen en toeslagen

XML Voorbeeld (inkomend)

<Invoice>
  <Envelope>
    <Sender>8711595000017</Sender>
    <Receiver>5400010000000</Receiver>
    <Version>1.0</Version>
    <DocType>GENERIC_INVOICE_SCO</DocType>
    <DocDt>2020/05/01 15:41</DocDt>
    <DocNumber>3956975</DocNumber>
    <Test/>
  </Envelope>
  <Message>
    <Header>
      <InvoiceNr>0091268262</InvoiceNr>
      <InvoiceType>IV</InvoiceType>
      <InvoiceTypeEancom>380</InvoiceTypeEancom>
      <InvoiceDt>2020/05/01 00:00:00.000</InvoiceDt>
      <BuyerOrderDt>2020/04/30 00:00:00.000</BuyerOrderDt>
      <DeliveryDt>2020/05/04 00:00:00.000</DeliveryDt>
      <Currency>EUR</Currency>
      <DeliveryNote>0081151876</DeliveryNote>
      <BuyerOrderNumber>IO/20/02132</BuyerOrderNumber>
      <TotalAmount>4838.62000</TotalAmount>
      <VATBaseAmount>4838.62000</VATBaseAmount>
      <VATAmount>0</VATAmount>
    </Header>
    <Parties>
      <Party>
        <Qual>BY</Qual>
        <Gln>5400010000000</Gln>
        <VATRegNumber/>
      </Party>
      <Party>
        <Qual>DP</Qual>
        <Gln>5400010000000</Gln>
        <VATRegNumber/>
      </Party>
      <Party>
        <Qual>IV</Qual>
        <Gln>5400010000000</Gln>
        <VATRegNumber/>
      </Party>
      <Party>
        <Qual>SU</Qual>
        <Gln>8711595000017</Gln>
        <VATRegNumber>NL003388773B01</VATRegNumber>
      </Party>
    </Parties>
    <Lines>
      <Line>
        <LineId>2</LineId>
        <GTINArticle>8711595126410</GTINArticle>
        <SupplierArticleCode>000000000000210032</SupplierArticleCode>
        <SupplierArticleDescr>ZW REPOX 250ML BEIGE</SupplierArticleDescr>
        <InvoicedQty>12</InvoicedQty>
        <PriceWithoutAC>10.64000</PriceWithoutAC>
        <BuyerOrderNumber>IO/20/02132</BuyerOrderNumber>
        <BuyerOrderLineNumber>2</BuyerOrderLineNumber>
        <LineSubTotal>127.68000</LineSubTotal>
        <LineTotal>127.68000</LineTotal>
        <LineVAT>0</LineVAT>
        <ChargeAndAllowances/>
      </Line>
    </Lines>
    <Totals>
      <VATTotals>
        <VATTotal>
          <VATPct>0</VATPct>
          <VATBase>4838.62000</VATBase>
          <VATAmount>0</VATAmount>
        </VATTotal>
      </VATTotals>
      <ChargeAndAllowances/>
    </Totals>
  </Message>
</Invoice>

Zie ook