Aan de slag

Minimale beheerdersconfiguratie om eInvoicing end-to-end werkend te krijgen. Op managed sites zijn het PEPPOL-profiel en de codelijsten al voorgeladen.

1. Verifieer het EDocument-profiel

Het PEPPOL-profiel wordt bij installatie automatisch aangemaakt. Controleer via EDocument Profile → PEPPOL:

Instelling	Waarde
Identifier Namespace	`urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2`
Identifier Element Name	`CustomizationID`
Identifier Value	`urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0`
Generator Path	`edocument.edocument.profiles.peppol.generator.generate_peppol_xml`
Parser / Validator / Preview / Detector / Matcher	bijbehorende `…profiles.peppol.*`-paden

Sales Invoice Settings op het profiel bepalen het gedrag:

EDocument generation on Save — genereer bij opslag (handig voor testen)
EDocument generation on Submit — productie-default; EDocument bij indienen
Ignore Validation Error for EDocument generation — laat aanmaken toe bij validatiefouten, met waarschuwing. Niet aanzetten op productie tenzij u een herstelflow heeft.

2. Codelijsten

E-documenten verwijzen naar codes — C62 voor UOM "One", ZZZ voor onderling overeengekomen betaling, enz. Deze komen uit internationale codelijsten gekoppeld aan ERPNext-entiteiten.

Standaardlijsten worden automatisch geïmporteerd bij installatie. Opnieuw importeren of updaten via Import Genericode in het Code List DocType:

Codelijst	Gekoppeld aan	Default
UNTDID 4461 Payment Means	Payment Terms Template, Mode of Payment	`ZZZ`
UN/ECE Rec 20 Units of Measure	UOM	`C62`
UNCL 5305 Tax Categories	Item Tax Template, Account, Tax Category, Sales Taxes and Charges Template	`S`
EAS Electronic Address Schemes	Company, Customer, Supplier	`EM`

Codes worden van specifiek naar algemeen opgelost: voor BTW kijkt de app eerst naar Item Tax Template, dan Income Account, dan Tax Category, dan Sales Taxes and Charges Template.

3. Elektronisch adres

PEPPOL vereist een elektronisch adres voor zender én ontvanger. Stel in op Company, Customer, Supplier:

Veld	Wat
EDocument Profile	Standaardprofiel (PEPPOL)
Electronic Address Scheme	`0106` (KvK NL) · `0208` (Belgisch BTW) · `EM` (e-mail) · `9930` (BTW-DE)
Electronic Address	Het identifier zelf — KvK-nummer, BTW-nummer of e-mailadres

Fallback indien niet ingesteld: klant → Contact Email → Buyer Address Email ID; bedrijf → Seller Contact Email → Company Email.

4. Bankgegevens

Om bankgegevens in het e-document op te nemen:

Maak een Mode of Payment van type "Bank"
Koppel het bijbehorende bedrijfsaccount
Maak een Bank Account voor dat account met IBAN en BIC (SWIFT)
Map een Common Code uit UNTDID 4461 aan de Mode of Payment — bv. "Credit Transfer" → 30, "SEPA Credit Transfer" → 58

PEPPOL ondersteunt één payment means per factuur. Combineer geen meerdere Modes of Payment op dezelfde factuur.

5. BTW-scenario's

De meeste facturen gebruiken standaard-BTW (S) of 0% (Z, auto-gedetecteerd). Speciale gevallen:

Scenario	UNCL 5305 code	Setup
BTW vrijgesteld (boeken, onderwijs, zorg)	`E`	Maak Tax Category "BTW Vrijgesteld" gekoppeld aan `E`
Buiten Toepassing (niet-zakelijk)	`O`	Als een regel `O` gebruikt, worden BTW-identifiers weggelaten uit de hele factuur per PEPPOL-regels
Intracommunautaire levering (EU 0%)	`K`	App voegt auto `VATEX-EU-IC`-vrijstelling, ActualDeliveryDate en leveringslandcode toe (voldoet aan BR-IC-10/11/12)

Voor artikel-specifieke behandeling: map codes aan Item / Item Tax Template / Account in plaats van Tax Category.