summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/qrbill/qrbill.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/qrbill/qrbill.dtx')
-rw-r--r--macros/latex/contrib/qrbill/qrbill.dtx43
1 files changed, 29 insertions, 14 deletions
diff --git a/macros/latex/contrib/qrbill/qrbill.dtx b/macros/latex/contrib/qrbill/qrbill.dtx
index 09e705814d..21126cf973 100644
--- a/macros/latex/contrib/qrbill/qrbill.dtx
+++ b/macros/latex/contrib/qrbill/qrbill.dtx
@@ -2,7 +2,7 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
-% Copyright (C) 2020 by Marei Peischl (peiTeX) <marei@peitex.de>
+% Copyright (C) 2020–2021 by Marei Peischl (peiTeX) <marei@peitex.de>
%
% This work is a collaboration of
% Marei Peischl (peiTeX) and Alex Antener (foobar LLC).
@@ -54,7 +54,7 @@
% \fi
% \iffalse
%<*driver>
-\ProvidesFile{qrbill.dtx}[2020/08/25 v1.02 \ create QR-bills based on the Swiss standard]
+\ProvidesFile{qrbill.dtx}[2021/05/10 v1.03 \ create QR-bills based on the Swiss standard]
\documentclass[english, parskip=half-]{scrartcl}
\usepackage{iftex}
\ifPDFTeX
@@ -175,7 +175,7 @@
% \GetFileInfo{qrbill.dtx}
%
% \DoNotIndex{\newcommand,\newenvironment}
-% \title{qrbill v1.02}
+% \title{qrbill v1.03}
% \subtitle{\LaTeX-package to create QR-bills based on the Swiss payments standards}
% \author{Marei Peischl \href{mailto:marei@peitex.de}{<marei@peitex.de>}}
% \publishers{A collaborative project of pei\TeX{} and foobar LLC}
@@ -311,22 +311,27 @@
%
% \section{Setup for the preconfigured Swiss QR-bill}
% \subsection{Preconfigured data}
+% \changes{v1.03}{2021/05/07}{Update to swiss qrbill standard version 2.2}
% The initial configuration which uses the Swiss standard already adds the following data:
% \begin{doccode}
% \SetupQrBill{
% QRType=SPC,
-% Version=0210,
+% Version=0200,
% CodingType=1,
% Trailer=EPD,
% }
% \end{doccode}
-% These fields are required to use these values for Version 2.1 of the QRbill standard. If any future changes on the standard would require changes, they can be overwritten or redefined by using a custom implementation file, similar to swiss.qrbill-cfg.tex.
+% These fields are required to use these values for Version 2.2 of the QRbill standard. If any future changes on the standard would require changes, they can be overwritten or redefined by using a custom implementation file, similar to swiss.qrbill-cfg.tex.
%
% \changes{v1.02}{2020/08/25}{Note the version number inconsistency in the official guidelines}
-% Be aware that we use the versioncode \code{0210}, as this is the current, implemented standard from the official guidelines, which replaced version 2.0 in 09/2019.
-% As the mentioned example in v2.1 of the official guidelines use an outdated version code (e.g. \code{0200}), some banking apps may refuse the processing of the QR code. Hence, this is not a bug of the qrbill package, but of these apps.
-% Feel free to change the version back to \code{0200} to override and support the replaced standard.
-% The corresponding issue and discussion can be found at \url{https://github.com/peiTeX/qrbill/issues/3}.
+% Be aware that version 2.1 of the standard requested to use the versioncode \code{0210}.
+% With the update to version 2.2 of the standard this was changed to \code{0200}.
+% This change was caused by a discrepancy between the standard and the commong implementation.
+% Most of them continued to use the version code \code{0200} therefore SIX decided to keep this error and created a workaround with finally documenting this change in version 2.2 of the guildelines.
+% \begin{quote}
+%Note: In collaboration with representatives of the financial center, SIX has decided that only the version designation “0200” is permitted in master version 02. From master version 03 onwards, depiction of subversions is enabled.\\\hspace*{\fill}\cite{qrbill-spec}
+% \end{quote}
+% The corresponding issue and discussion concerning this especially for version 2.1 can be found at \url{https://github.com/peiTeX/qrbill/issues/3}.
%
% Additionally the Currency has been initialized to use \enquote{CHF}. This also can be overwritten. Currently the Swiss standards only allow the values \code{CHF} or \code{EUR}.
% \subsection{Address data}
@@ -426,7 +431,7 @@
% \section{Implementation}
% \begin{macrocode}
\RequirePackage{expl3}
-\ProvidesExplPackage{qrbill}{2020/08/25}{1.02}{
+\ProvidesExplPackage{qrbill}{2021/05/10}{1.03}{
Template for QR-bills based on the Swiss Payment Standards
}
\RequirePackage{iftex}
@@ -1057,7 +1062,7 @@
\SetupQrBill{
QRType=SPC,
- Version=0210,
+ Version=0200,
CodingType=1,
Trailer=EPD,
Currency=CHF,
@@ -1072,11 +1077,12 @@
%
% \PrintChanges
% \begin{thebibliography}{99}
-% \bibitem{qrbill-spec} Swiss Implementation Guidelines QR-bill: Technical and professional specifications of the payment part with Swiss QR Code and of the receipt. Version 2.1, with effect from 30 September 2019. \url{https://www.paymentstandards.ch/dam/downloads/ig-qr-bill-en.pdf}
+% \bibitem{qrbill-spec} Swiss Implementation Guidelines QR-bill: Technical and professional specifications of the payment part with Swiss QR Code and of the receipt. Version 2.2, with effect from 22 February 2021. \url{https://www.paymentstandards.ch/dam/downloads/ig-qr-bill-en.pdf}. Last checked 2021-05-07
% \bibitem{qrbill-design} Style Guide QR-billStyle Guide QR-bill: The right layout pays off. Layout rules and recommendations for the payment part with Swiss QR Code and for the receipt. \url{https://www.paymentstandards.ch/dam/downloads/style-guide-en.pdf}
% \end{thebibliography}
% \appendix
% \section{Example of standalone qrbill}
+% \changes{v1.03}{2021/05/07}{set sep-iban and sep-reference in examples}
% \label{standalone-complete}
% \iffalse
% \begin{macrocode}
@@ -1089,7 +1095,12 @@
\usepackage[nswissgerman]{babel}
\RequirePackage{xcolor}
-\usepackage[icon=swiss-cross,separate=false]{qrbill}
+\usepackage[
+ icon=swiss-cross,
+ separate=false,
+ sep-iban=4,
+ sep-reference=-5
+]{qrbill}
\begin{document}
@@ -1129,7 +1140,11 @@
% \begin{macrocode}
% !TeX Program=lualatex
\documentclass[foldmarks=b]{scrletter}
-\usepackage[frame=top]{qrbill}
+\usepackage[
+ frame=top,
+ sep-iban=4,
+ sep-reference=-5,
+]{qrbill}
% Setup layer
\DeclareNewLayer[