Skip to content

Latest commit

 

History

History
158 lines (112 loc) · 7.7 KB

Beispiele.md

File metadata and controls

158 lines (112 loc) · 7.7 KB

Beispiele (de)

Das Einführungsbeispiel gab es bereits im README. Zum Verständnis Der Beispiele verweise ich auf die DIN-EN16931-1, dem "€uro invoice" Standard.

Übersicht über das EN16931 Modell

Beteiligte Geschäftspartner

Im Vertriebsprozess gibt es zwei Geschäftspartner, den Verkäufer (Seller/Supplier) und den Käufer (Buyer/Customer). Jeder Partner kann im Prozess mehrere Rollen ausüben.

  • der Verkäufer ist i.A. auch der Lieferant und der Zahlungsempfänger (Payee)
  • der Käufer/Kunde kann auch Empfänger der Waren oder Dienstleistungen sein

Beide Geschäftspartner sind i.A. umsatzsteuerpflichtig. Der Verkäufer darf seine Rolle an einen Steuerbevollmächtigten delegieren, der die Umsatzsteuer in seinem Namen ausweist und bezahlt.

Die Rolle des Zahlungsempfängers darf an einen weiteren Geschäftspartner delegiert werden (Factoring).

Die Geschäftspartner im Modell

Geschäftsregeln für Rechnungen

siehe auch rechtliche Anforderungen an eine Rechnung

  • BR-6: Eine Rechnung muss den Namen des Verkäufers (BT-27) enthalten.
  • BR-7: Eine Rechnung muss den Namen des Käufers (BT-44) enthalten.
  • BR-8: Eine Rechnung muss die Postanschrift des Verkäufers (BG-5) enthalten.
  • BR-9: Eine Postanschrift des Verkäufers (BG-5) muss einen Ländercode der Verkäuferanschrift (BT-40) enthalten.
  • BR-10: Eine Rechnung muss die Postanschrift des Käufers (BG-8) enthalten.
  • BR-11: Die Postanschrift des Käufers muss einen Ländercode der Käuferanschrift (BT-55) enthalten.

Beispiel Verkäufer und Käufer

Das folgende Beispiel definiert den Verkäufer und den Käufer und damit erfüllt es die ersten vier Regeln. Auch BR-11 ist erfüllt. Nicht jedoch BR-10, in der Adresse der Käufers fehlt die "Straße aka address line 1":

  static final String DE = "DE";  // country code 
...
	// BusinessParty Seller aka Supplier
	PostalAddress sellerAddress = invoice.createAddress(DE, "12345", "[Seller city]");
	sellerAddress.setAddressLine1("[Seller address line 1]");
	IContact sellerContact = null;                           // (optional)
	invoice.setSeller("[Seller name]", sellerAddress, sellerContact, 
		"[HRA-Eintrag]", "123/456/7890, HRA-Eintrag in […]");
		  
	// BusinessParty Buyer aka Customer 
	PostalAddress buyerAddress = invoice.createAddress(DE, "12345", "[Buyer city]");
	IContact buyerContact = null;                           // (optional)
	invoice.setBuyer("[Buyer name]", buyerAddress, buyerContact);
...

Die Adresse der Käufers ist einfach zu vervollständigen: setAddressLine1(...). Auch die optionalen Kontaktdaten lassen sich einfach ergänzen:

...
	String contactName = "nicht vorhanden";
	String contactTel  = "+49 1234-5678";
	String contactMail = "seller@email.de";
	IContact sellerContact = invoice.createContact(contactName, contactTel, contactMail);
...

Beispiel Factoring

Die Rolle des Zahlungsempfängers darf auch von einem anderen Geschäftspartner als dem Verkäufer, z. B. von einem Factoringdienst, ausgeübt werden.

  • BR-17: Falls der Zahlungsempfänger (BG-10) nicht mit dem Verkäufer (BG-4) identisch ist, muss seine Firmierung/sein Name in der Rechnung (BT-59) angegeben werden

Die facturx API hat dafür die Methode setPayee:

public interface CoreInvoice ...
public void setPayee(String name, String id, String companyId);

Beispiel Steuerbevollmächtigte

Der Verkäufer darf seine Rolle an einen Steuerbevollmächtigten delegieren, der die Umsatzsteuer in seinem Namen ausweist und bezahlt. In der Rechnung müssen weitere Regeln beachtet werden:

  • BR-18: Falls sich der Verkäufer (BG-4) durch einen Steuerbevollmächtigten (BG-11) vertreten lässt, muss dessen Name (BT-62) in der Rechnung angegeben werden.
  • BR-19: Falls sich der Verkäufer (BG-4) durch einen Steuerbevollmächtigten (BG-11) vertreten lässt, muss die Postanschrift des Steuerbevollmächtigten des Verkäufers (BG-12) in der Rechnung angegeben werden.
  • BR-20 Falls sich der Verkäufer (BG-4) durch einen Steuerbevollmächtigten (BG-11) vertreten lässt, muss die Postanschrift des Steuerbevollmächtigten des Verkäufers (BG-12) den Ländercode der Steuerbevollmächtigtenanschrift (BT-69) enthalten.

Ähnlich wie bei Payee gibt es auch dafür eine Methode setTaxRepresentative.

Rechnungspositionen

Geschäftsregeln für Rechnungspositionen

jede Rechnungsposition muss ...

  • BR-21: eine Kennung (BT-126) haben, z.B. Positionsnummer
  • BR-22: die in Rechnung gestellte Menge (BT-129) und den Code für
  • BR-23: die Maßeinheit (BT-130) aufweisen. Der Maßeinheitcode ist der UN/ECE Recommendation No. 20/21 „Codes for Units of Measure“ zu entnehmen. Beispiele:
    • LTR = Liter,
    • MTQ = Kubikmeter,
    • KGM = Kilogramm,
    • XPP = piece/Stück,
    • HUR = hour/Stunde
  • BR-24 der Nettobetrag der Rechnungsposition (BT-131) angegeben werden
  • BR-26: den Nettopreis des Artikels (BT-146) enthalten
  • BR-25: den Artikelnamen (BT-153) enthalten
  • BR-CO-4: einer Umsatzsteuerkategorie/VAT (BT-151) zugeordnet werden

Die obligatorischen Informationen einer Rechnungsposition sind bereits mit der factory-Methode createInvoiceLine abgedeckt:

  CoreInvoiceLine line = invoice.createInvoiceLine("1"      // Rechnungsposition
    , new Quantity("XPP", new BigDecimal(1))                // Code und Menge
    , new Amount(EUR, new BigDecimal(288.79))               // Nettobetrag Rechnungsposition
    , new UnitPriceAmount(EUR, new BigDecimal(288.79))      // Artikelpreis
    , "Zeitschrift [...]"                                   // Artikelname
    , TaxCategoryCode.StandardRate, new BigDecimal(7));     // VAT category code, rate 7%
...  
  invoice.addLine(line);
  • Rechnungsposition: "1"
  • Code und Menge: 1 Stück/XPP
  • Nettobetrag der Rechnungsposition: 288.79€
  • Artikelpreis: 288.79€
  • Artikelname: "Zeitschrift [...]"
  • Umsatzsteuerkategorie mit Steuersatz: 7%

Zusätzliche Angaben können angefügt werden:

  line.setNote("Die letzte Abonnementslieferung ... ");     // Bemerkungen
  line.setPeriod("2016-01-01", "2016-12-31");               // Lieferzeitraum
  line.setOrderLineID("6171175.1");                         // Referenz Bestellposition
...  
  invoice.addLine(line);

Detailinformationen zum Preis

Zu dieser Gruppe gehört der Preisrabatt. Dieser muss bereits im "Nettopreis des Artikels (BT-146)" einbezogen sein. Um zu zeigen, dass ein Rabatt gewährt wurde, kann der Nachlass (BT-147) auf den brutto Artikelpreis und auch der Bruttopreis (BT-148) angegeben werden:

    , new Amount(EUR, new BigDecimal(288.79))               // Nettobetrag Rechnungsposition
...
  line.setUnitPriceAllowance(new UnitPriceAmount(EUR, new BigDecimal(21.21)) // Nachlass
                            ,new UnitPriceAmount(EUR, new BigDecimal(310))); // Bruttopreis
  invoice.addLine(line);

Abschäge und Zuschläge (Allowance and Charges)

Ein Positionsabschlag kann als Rabatt 2. Ordnung angesehen werden. Bei Abschlägen und Zuschlägen/Gebühren (BT-141) kann ein Grund (BT-144) angegeben werden. Der zur Berechnung der Gesamtsumme verwendete Preis ist jedoch immer der Nettopreis (BT-146).

TODO Beispiel