[DOC] Updated ZugferdDocumentBuilder examples to clearify VAT calcula…

…tion
horstoeko · Dec 30, 2024 · e77e36c · e77e36c
1 parent 673a07b
commit e77e36c
Show file tree

Hide file tree

Showing 6 changed files with 56 additions and 56 deletions.
diff --git a/README.md b/README.md
@@ -307,16 +307,16 @@ The `ZugferdDocumentBuilder` class is again the central entry point to generate
     ->setDocumentPositionLineSummation(198.0)
     ->addNewPosition("2")
     ->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2")
-    ->SetDocumentPositionNetPrice(5.5000)
-    ->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE)
-    ->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
-    ->SetDocumentPositionLineSummation(275.0)
+    ->setDocumentPositionNetPrice(5.5000)
+    ->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE)
+    ->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
+    ->setDocumentPositionLineSummation(275.0)
     ->addNewPosition("3")
     ->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3")
-    ->SetDocumentPositionNetPrice(4.0000)
-    ->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE)
-    ->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
-    ->SetDocumentPositionLineSummation(400.0)
+    ->setDocumentPositionNetPrice(4.0000)
+    ->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE)
+    ->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
+    ->setDocumentPositionLineSummation(400.0)
     ->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 198.0, 37.62, 19.0)
     ->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 675.0, 47.25, 7.0)
     ->setDocumentSummation(957.87, 957.87, 873.00, 0.0, 0.0, 873.00, 84.87)
@@ -373,16 +373,16 @@ Use the class ```ZugferdDocumentPdfBuilder``` if you already have an existing pr
     ->setDocumentPositionLineSummation(198.0)
     ->addNewPosition("2")
     ->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2")
-    ->SetDocumentPositionNetPrice(5.5000)
-    ->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE)
-    ->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
-    ->SetDocumentPositionLineSummation(275.0)
+    ->setDocumentPositionNetPrice(5.5000)
+    ->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE)
+    ->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
+    ->setDocumentPositionLineSummation(275.0)
     ->addNewPosition("3")
     ->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3")
-    ->SetDocumentPositionNetPrice(4.0000)
-    ->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE)
-    ->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
-    ->SetDocumentPositionLineSummation(400.0)
+    ->setDocumentPositionNetPrice(4.0000)
+    ->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE)
+    ->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
+    ->setDocumentPositionLineSummation(400.0)
     ->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 198.0, 37.62, 19.0)
     ->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 675.0, 47.25, 7.0)
     ->setDocumentSummation(957.87, 957.87, 873.00, 0.0, 0.0, 873.00, 84.87);

diff --git a/examples/01_ZugferdDocumentBuilder_EN16931.php b/examples/01_ZugferdDocumentBuilder_EN16931.php
@@ -148,10 +148,10 @@
 
 $documentBuilder->addNewPosition("2");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2");
-$documentBuilder->SetDocumentPositionNetPrice(5.5000);
-$documentBuilder->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(275.0);
+$documentBuilder->setDocumentPositionNetPrice(5.5000);
+$documentBuilder->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(275.0);
 
 // Add a third position
 // - The invoiced item is named "Joghurt Erdbeer" and has an seller assigned item no. "ARNR3" (setDocumentPositionProductDetails)
@@ -162,10 +162,10 @@
 
 $documentBuilder->addNewPosition("3");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3");
-$documentBuilder->SetDocumentPositionNetPrice(4.0000);
-$documentBuilder->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(400.0);
+$documentBuilder->setDocumentPositionNetPrice(4.0000);
+$documentBuilder->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(400.0);
 
 // Write the VAT Summation
 // You have to group the VAT base amounts by VAT-Category ("S"), VAT-Type ("VAT") and VAT percent (19%, 7%)

diff --git a/examples/01_ZugferdDocumentBuilder_XRECHNUNG3.php b/examples/01_ZugferdDocumentBuilder_XRECHNUNG3.php
@@ -153,10 +153,10 @@
 
 $documentBuilder->addNewPosition("2");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2");
-$documentBuilder->SetDocumentPositionNetPrice(5.5000);
-$documentBuilder->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(275.0);
+$documentBuilder->setDocumentPositionNetPrice(5.5000);
+$documentBuilder->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(275.0);
 
 // Add a third position
 // - The invoiced item is named "Joghurt Erdbeer" and has an seller assigned item no. "ARNR3" (setDocumentPositionProductDetails)
@@ -167,10 +167,10 @@
 
 $documentBuilder->addNewPosition("3");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3");
-$documentBuilder->SetDocumentPositionNetPrice(4.0000);
-$documentBuilder->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(400.0);
+$documentBuilder->setDocumentPositionNetPrice(4.0000);
+$documentBuilder->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(400.0);
 
 // Write the VAT Summation
 // You have to group the VAT base amounts by VAT-Category ("S"), VAT-Type ("VAT") and VAT percent (19%, 7%)

diff --git a/examples/02_ZugferdDocumentPdfBuilder_EN16931.php b/examples/02_ZugferdDocumentPdfBuilder_EN16931.php
@@ -64,16 +64,16 @@
 $documentBuilder->setDocumentPositionLineSummation(198.0);
 $documentBuilder->addNewPosition("2");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2");
-$documentBuilder->SetDocumentPositionNetPrice(5.5000);
-$documentBuilder->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(275.0);
+$documentBuilder->setDocumentPositionNetPrice(5.5000);
+$documentBuilder->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(275.0);
 $documentBuilder->addNewPosition("3");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3");
-$documentBuilder->SetDocumentPositionNetPrice(4.0000);
-$documentBuilder->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(400.0);
+$documentBuilder->setDocumentPositionNetPrice(4.0000);
+$documentBuilder->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(400.0);
 $documentBuilder->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 198.0, 37.62, 19.0);
 $documentBuilder->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 675.0, 47.25, 7.0);
 $documentBuilder->setDocumentSummation(957.87, 957.87, 873.00, 0.0, 0.0, 873.00, 84.87);

diff --git a/examples/02_ZugferdDocumentPdfBuilder_XRECHNUNG.php b/examples/02_ZugferdDocumentPdfBuilder_XRECHNUNG.php
@@ -64,16 +64,16 @@
 $documentBuilder->setDocumentPositionLineSummation(198.0);
 $documentBuilder->addNewPosition("2");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2");
-$documentBuilder->SetDocumentPositionNetPrice(5.5000);
-$documentBuilder->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(275.0);
+$documentBuilder->setDocumentPositionNetPrice(5.5000);
+$documentBuilder->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(275.0);
 $documentBuilder->addNewPosition("3");
 $documentBuilder->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3");
-$documentBuilder->SetDocumentPositionNetPrice(4.0000);
-$documentBuilder->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
-$documentBuilder->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
-$documentBuilder->SetDocumentPositionLineSummation(400.0);
+$documentBuilder->setDocumentPositionNetPrice(4.0000);
+$documentBuilder->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE);
+$documentBuilder->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7);
+$documentBuilder->setDocumentPositionLineSummation(400.0);
 $documentBuilder->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 198.0, 37.62, 19.0);
 $documentBuilder->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 675.0, 47.25, 7.0);
 $documentBuilder->setDocumentSummation(957.87, 957.87, 873.00, 0.0, 0.0, 873.00, 84.87);

diff --git a/make/md/ZugferdDocumentBuilder.md b/make/md/ZugferdDocumentBuilder.md
@@ -42,16 +42,16 @@
     ->setDocumentPositionLineSummation(198.0)
     ->addNewPosition("2")
     ->setDocumentPositionProductDetails("Joghurt Banane", "B-Ware", "ARNR2")
-    ->SetDocumentPositionNetPrice(5.5000)
-    ->SetDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE)
-    ->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
-    ->SetDocumentPositionLineSummation(275.0)
+    ->setDocumentPositionNetPrice(5.5000)
+    ->setDocumentPositionQuantity(50, ZugferdUnitCodes::REC20_PIECE)
+    ->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
+    ->setDocumentPositionLineSummation(275.0)
     ->addNewPosition("3")
     ->setDocumentPositionProductDetails("Joghurt Erdbeer", "", "ARNR3")
-    ->SetDocumentPositionNetPrice(4.0000)
-    ->SetDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE)
-    ->AddDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
-    ->SetDocumentPositionLineSummation(400.0)
+    ->setDocumentPositionNetPrice(4.0000)
+    ->setDocumentPositionQuantity(100, ZugferdUnitCodes::REC20_PIECE)
+    ->addDocumentPositionTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 7)
+    ->setDocumentPositionLineSummation(400.0)
     ->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 198.0, 37.62, 19.0)
     ->addDocumentTax(ZugferdVatCategoryCodes::STAN_RATE, ZugferdVatTypeCodes::VALUE_ADDED_TAX, 675.0, 47.25, 7.0)
     ->setDocumentSummation(957.87, 957.87, 873.00, 0.0, 0.0, 873.00, 84.87)