@design.estate/dees-document 3.1.1 → 3.2.0

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-document',
-  version: '3.1.1',
+  version: '3.2.0',
   description: 'A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.'
 }

package/ts_web/elements/contentinvoice.ts

@@ -511,15 +511,33 @@ export class DeContentInvoice extends DeesElement {
     </div>`;
   }
 
+  /**
+   * The QR pay box. It is printed only when the payment has a valid EPC QR
+   * code: a euro amount to the sender's IBAN, which a document in another
+   * currency or without the sender's IBAN does not have.
+   */
   private renderPaymentInfo(
     accountingDocArg: plugins.tsclass.finance.TAccountingDoc
-  ): TemplateResult {
+  ): TemplateResult | null {
     const bic = accountingDocArg.from.sepaConnection?.bic;
     const name = accountingDocArg.from.name;
     const iban = accountingDocArg.from.sepaConnection?.iban;
     const currency = accountingDocArg.currency;
     const totalGross = this.getTotalGross();
     const reference = accountingDocArg.id;
+    if (
+      typeof iban !== "string" ||
+      plugins.shared.buildEpcQrPayload({
+        bic,
+        name,
+        iban,
+        currency,
+        amount: totalGross,
+        remittanceInformation: reference,
+      }) === null
+    ) {
+      return null;
+    }
 
     return html`<div class="infoBox">
       <div>
@@ -539,6 +557,26 @@ export class DeContentInvoice extends DeesElement {
     </div>`;
   }
 
+  /**
+   * The reverse-charge statement. § 14a UStG requires the words
+   * "Steuerschuldnerschaft des Leistungsempfängers": Abs. 5 for a domestic
+   * supply whose recipient owes the tax under § 13b, Abs. 1 for a supply in
+   * another member state whose recipient owes the tax there, such as a
+   * business-to-business service under Art. 196 of the VAT Directive. They are
+   * printed on every reverse-charge document, and a document in another language adds its own
+   * line, in English "Reverse charge", the words of Art. 226 Nr. 11a of the VAT
+   * Directive (2006/112/EC).
+   */
+  private renderReverseChargeNote(): TemplateResult {
+    const localizedLine = this.translateKey("invoice@@vat.reverseCharge.note");
+    return html`<div class="taxNote">
+      <div>${plugins.shared.translation.REVERSE_CHARGE_STATUTORY_PHRASE_DE}</div>
+      ${localizedLine === plugins.shared.translation.REVERSE_CHARGE_STATUTORY_PHRASE_DE
+        ? null
+        : html`<div>${localizedLine}</div>`}
+    </div>`;
+  }
+
   /** The earlier documents a correction answers, by number and, when known, by date. */
   private renderRelatedDocuments(): TemplateResult | null {
     const relatedDocuments = this.accountingDoc?.relatedDocuments;
@@ -699,11 +737,7 @@ export class DeContentInvoice extends DeesElement {
         </div>
         <div class="divider"></div>
 
-        ${accountingDoc?.reverseCharge
-          ? html`<div class="taxNote">
-              ${this.translateKey("invoice@@vat.reverseCharge.note")}
-            </div>`
-          : ``}
+        ${accountingDoc?.reverseCharge ? this.renderReverseChargeNote() : ``}
 
         <!-- REFERENCED CONTRACT -->
         ${this.renderReferencedContract()}

package/ts_web/elements/paymentcode.ts

@@ -53,25 +53,34 @@ export class DedocumentPaymentCode extends DeesElement {
   @property()
   accessor reference!: string;
 
+  /** The EPC QR code content, or null when the payment has no valid code (see buildEpcQrPayload). */
+  private get payload(): string | null {
+    if (
+      typeof this.name !== "string" ||
+      typeof this.iban !== "string" ||
+      typeof this.currency !== "string" ||
+      typeof this.totalGross !== "number" ||
+      typeof this.reference !== "string"
+    ) {
+      return null;
+    }
+    return plugins.shared.buildEpcQrPayload({
+      bic: typeof this.bic === "string" ? this.bic : undefined,
+      name: this.name,
+      iban: this.iban,
+      currency: this.currency,
+      amount: this.totalGross,
+      remittanceInformation: this.reference,
+    });
+  }
+
   private updateQRCode(): void {
-    if (!this.canvasEl) return;
+    const payload = this.payload;
+    if (!this.canvasEl || payload === null) return;
 
-    plugins.qrcode.toCanvas(
-      this.canvasEl,
-      `BCD
-001
-1
-SCT
-${this.bic}
-${this.name}
-${this.iban}
-${this.currency}${this.totalGross?.toFixed?.(2)}
-      
-${this.reference}`,
-      (error) => {
-        if (error) console.error(error);
-      }
-    );
+    plugins.qrcode.toCanvas(this.canvasEl, payload, (error) => {
+      if (error) console.error(error);
+    });
   }
 
   public override update(
@@ -82,14 +91,6 @@ ${this.reference}`,
   }
 
   public render(): TemplateResult | null {
-    const allDataAvailable =
-      typeof this.bic === "string" &&
-      typeof this.name === "string" &&
-      typeof this.iban === "string" &&
-      typeof this.currency === "string" &&
-      typeof this.totalGross === "number" &&
-      typeof this.reference === "string";
-
-    return allDataAvailable ? html`<canvas></canvas>` : null;
+    return this.payload === null ? null : html`<canvas></canvas>`;
   }
 }