Welke gegevens moet een XRechnung minimaal bevatten?

Het formaat xrechnung maakt via de faktoora-API een factuur aan die voldoet aan de Europese norm EN 16931, naar keuze als zuiver XML-bestand of als ZUGFeRD-profiel. Om de factuur te kunnen aanmaken, moeten bepaalde gegevens in het request aanwezig zijn.

Verplichte velden op factuurniveau

Voor het Invoice-object zelf zijn volgens het API-schema de volgende velden verplicht:

• format (hier: xrechnung)
• issueDate: factuurdatum
• invoiceNumber: factuurnummer
• invoiceTypeCode: factuurtype, bijv. 380 voor een reguliere handelsfactuur
• invoiceItems: minstens één factuurregel
• buyer: de koper

Verplichte velden voor de verkoper

Stuurt u een seller-blok mee, dan zijn daarin de volgende velden verplicht:

• name: naam van het bedrijf
• street: straat
• postcode: postcode
• city: plaats
• country: land als ISO 3166-1 alpha-2-code (bijv. DE)

Verplichte velden voor de koper

Het buyer-blok is op factuurniveau sowieso verplicht; daarbinnen zijn verplicht:

• name: naam van de koper
• street: straat
• postcode: postcode
• city: plaats
• country: land als ISO 3166-1 alpha-2-code

Verplichte velden per factuurregel

Elke regel in invoiceItems heeft een id en een product-object nodig. Binnen product zijn verplicht:

• name: omschrijving van het product of de dienst
• quantity: hoeveelheid
• unitCode: eenheid (bijv. HUR voor uren, C62 voor stuks, KGM voor kilogram)
• price: eenheidsprijs
• taxes: minstens één belastingregel met typeCode, categoryCode en rate

Leitweg-ID voor publieke opdrachtgevers

Facturen aan Duitse publieke opdrachtgevers bevatten daarnaast een Leitweg-ID (het routeringsnummer van de ontvangende overheidsinstantie). In de API wordt deze meegegeven in het veld buyerReference.buyerReferenceId. U ontvangt de Leitweg-ID van de ontvanger van de factuur. Zijn uw facturen gericht aan bedrijven in plaats van aan publieke opdrachtgevers, dan is er doorgaans geen Leitweg-ID.

Een XRechnung die u via de interface van faktoora aanmaakt, vraagt dezelfde gegevens stap voor stap op; de stapsgewijze handleiding vindt u in het artikel Het aanmaken van een XRechnung/ZUGFeRD of PDF-factuur.