You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/en/qr-codes.md
+37-14Lines changed: 37 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -39,13 +39,21 @@ This is your normal IBAN. You can't use a reference! You are only allowed to use
39
39
40
40
Follows the ISO-11649 norm. Works like a QR-Reference but uses ISO-11649 which makes it usable international. Unlike the provious two QR codes, this also works outside of Switzerland. You have to use the normal IBAN, not the QR IBAN.
41
41
42
+
### Inserting the QR Code into your Invoice
43
+
44
+
<x-info>
45
+
> Your company country must be set to Switzerland for the QR IBAN and BESR Number fields to become visible on the Company Details page.
46
+
</x-info>
47
+
42
48

43
49
44
-
You can configure this under Settigns > Company Details in the Details page.
50
+
Codes can be inserted directly into the wysiwyg editor in either the public notes or terms sections.
45
51
46
52

47
53
48
-
You'll then need to customize your design to include the QR code on your PDFs. To do this create a new design in Settings > Inovice Design > Customize
54
+
<x-warning>
55
+
> Due to the width of these containers, the QR Code will appear compressed. If you prefer to have the QR code stretch the width of the PDF, you'll want to create a custom design and insert the QR code into the body of the invoice as shown below.
56
+
</x-warning>
49
57
50
58
In the body tab, at the bottom add
51
59
@@ -61,43 +69,58 @@ or we have also made available a decoded version using the following variable
61
69
$swiss_qr_raw
62
70
```
63
71
72
+

64
73
65
-
After you have saved the design, you'll want to make this your new default design.
74
+
This will then allow the QR code to stretch the width of the PDF and will appear as follows.
66
75
67
-

76
+

77
+
78
+
After you have saved the design, you'll want to make this your new default design.
68
79
69
80
If your QR codes are not appearing then there would be a configuration issue that needs to be addressed. The most common reasons the QR code does not appear on the PDF is due to missing company details. Your full address is required along with the clients full details.
70
81
71
82
## SEPA ERC QR Codes
72
83
73
84
To enable SEPA QR codes you'll need to follow a couple of steps to ensure there is the correct data.
74
85
75
-
SEPA QR codes require at the very least a IBAN, for payments outside of EEA you will also need the BIC. These two fields are harvested from the Custom Company Fields section of Invoice Ninja. Please note that IBAN must be the first custom field and BIC the second custom field. To configure these navigate to
86
+
SEPA QR codes require at the very least a IBAN, for payments outside of EEA you will also need the BIC.
76
87
77
-
```bash
78
-
Settings > Custom Fields > Company
79
-
```
88
+
You can configure your payment details by enabling E Invoicing and setting the payment method to Credit Transfer (code 30) or SEPA Credit Transfer (code 58).
89
+
90
+

91
+
92
+
Once you enable E Invoicing, the payment means dialog will appear, then set either code 30 or 58, the form will then populate with the correct fields.
80
93
81
-

94
+

82
95
83
-
Once saved, then navigate to
96
+
The variable
84
97
85
98
```bash
86
-
Settings > Company Details
99
+
$sepa_qr_code
87
100
```
88
101
89
-
And enter in the values for your company
102
+
Can be placed directly into the Public Notes or Terms sections of your invoice, for automatic generation of the QR code in your invoice.
103
+
104
+

90
105
91
-

106
+
If you prefer to have control over the location of the QR code you can create a custom design and then use the following options to inject the QR code into your PDF.
92
107
93
-
In your custom design, you'll then want to insert the variable that allows the QR code to be injected, for example.
94
108
95
109
```
96
110
<div data-state="encoded-html">
97
111
$sepa_qr_code
98
112
</div>
99
113
```
100
114
115
+
or
116
+
117
+
```
118
+
$sepa_qr_code_raw
119
+
```
120
+
121
+

122
+
123
+
101
124
## Generic Payment link QR Codes
102
125
103
126
Generic payment QR codes can easily be applied to your Invoice PDF using the following block in your custom Design
0 commit comments