Last modified by Fredrik Nilsson on 2023/10/27 13:47
From empty
To version 7.1
edited by Fredrik Nilsson
on 2022/01/03 14:09
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +Invoice layout
Parent
... ... @@ -1,0 +1,1 @@
1 +developer:Main.Invoicing.invoice-service.Implementation guide.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.XWikiGuest
1 +xwiki:XWiki.frn
Default language
... ... @@ -1,0 +1,1 @@
1 +en
Tags
... ... @@ -1,0 +1,1 @@
1 +px-custom-page-content
Content
... ... @@ -1,0 +1,139 @@
1 +(% id="HEditinginvoicecolumns" %)
2 += Introduction =
3 +
4 +(% class="jumbotron" %)
5 +(((
6 +(% class="container" %)
7 +(((
8 +You have the possibility to specify the structure and presentation of your invoice columns. This is done in the Invoice Printblock directly in the CUSIN file that you send to PayEx.
9 +)))
10 +)))
11 +
12 +(% id="HInvoicegeneration" %)
13 +=== Invoice generation ===
14 +
15 +When you have transfered your CUSIN file to PayEx and it has been processed successfully the end result will look similar to the invoice example below.
16 +
17 +(% id="H" %)
18 +== [[[[image:Main.Invoicing.invoice-service.Implementation guide.WebHome@invoice-example.PNG]]>>attach:Main.Invoicing.invoice-service.Technical reference.example-files.WebHome@Exempelfaktura.pdf]] ==
19 +
20 +
21 +The main element that govern column structure is {{code}}InvoicePrintblock{{/code}} and the subseqent {{code}}SubOrderBlocks{{/code}}. An invoice can have serveral Printblocks.
22 +
23 +{{code language="xml" title="**InvoicePrintBlock**"}}
24 +<BasePrintBlock>
25 + <SubOrderBlock TableType="A2">
26 + <ColumnHeadLine>
27 + <Columns>
28 + <Column ColumnNo="1">
29 + <Text>Services</Text>
30 + </Column>
31 + <Column ColumnNo="2">
32 + <Text>Products</Text>
33 + </Column>
34 + </ColumnHeadLine>
35 + <Rows>
36 + <Row>
37 + <Columns>
38 + <Column ColumnNo="1">
39 + <Text>A Service</Text>
40 + </Column>
41 + <Column ColumnNo="2">
42 + <Text>1.00</Text>
43 + </Column>
44 + </Columns>
45 + </Row>
46 + </Rows>
47 + <SummaryRow>
48 + <Columns>
49 + <Column ColumnNo="1">
50 + <Text>Amount</Text>
51 + </Column>
52 + <Column ColumnNo="2">
53 + <Text>424.00</Text>
54 + </Column>
55 + </Columns>
56 + </SummaryRow>
57 +
58 +<PrintBlockConfig PrecedingPageBreak=”false/true” PrecedingSheetBreak=”false/true”>
59 +</PrintBlockConfig>
60 +
61 +{{/code}}
62 +
63 +== Defining column amount ==
64 +
65 +You can display up to 12 columns on your invoice. The maximum witdh for columns is 180mm, which get divided among the total column count. The ##TableType## attribute for the {{code}}SubOrderBlock{{/code}} ranges from A1 (one column) to A12 (twelve columns). The example above use eight columns (A8). Each column is defined with a corresponding text element. Please note that you can leave columns blank.
66 +
67 +(% id="HAddingrows" %)
68 +== Adding rows ==
69 +
70 +You can add as many rows a necessary as long as you conform to the specified column amount. The example below displays three rows with 2 columns per row as limited by the table type (in this case i would have been A2).
71 +
72 +{{code language="xml" title="**Adding Rows**"}}
73 +<Row>
74 + <Columns>
75 + <Column ColumnNo="1">
76 + <Text>A Service</Text>
77 + </Column>
78 + <Column ColumnNo="2">
79 + <Text>1.00</Text>
80 + </Column>
81 + </Columns>
82 +</Row>
83 +<Row>
84 + <Columns>
85 + <Column ColumnNo="1">
86 + <Text>Another Service</Text>
87 + </Column>
88 + <Column ColumnNo="2">
89 + <Text>1.00</Text>
90 + </Column>
91 +</Row>
92 +<Row>
93 + <Columns>
94 + <Column ColumnNo="1">
95 + <Text>Another more exensive service</Text>
96 + </Column>
97 + <Column ColumnNo="2">
98 + <Text>3.00</Text>
99 + </Column>
100 +</Row>
101 +{{/code}}
102 +
103 +You can also add a summary row to your invoice, which give you a distinct row separated from the previous rows as seen in the example and figure below. The {{code}}SummaryRow{{/code}}elemement in this example contains eight columns (table type A8) even though none but the first and last column contain a value. The first column is used to display the string ##belopp## (amount) and the last column contains the actual amount ##424.00##.
104 +
105 +{{code language="xml" title="**Summary row**"}}
106 +
107 +<SummaryRow>
108 + <Columns>
109 + <Column ColumnNo="1">
110 + <Text>Belopp</Text>
111 + </Column>
112 + <Column ColumnNo="2">
113 + <Text></Text>
114 + </Column>
115 + <Column ColumnNo="3">
116 + <Text></Text>
117 + </Column>
118 + <Column ColumnNo="4">
119 + <Text></Text>
120 + </Column>
121 + <Column ColumnNo="5">
122 + <Text></Text>
123 + </Column>
124 + <Column ColumnNo="6">
125 + <Text></Text>
126 + </Column>
127 + <Column ColumnNo="7">
128 + <Text></Text>
129 + </Column>
130 + <Column ColumnNo="8">
131 + <Text>424.00</Text>
132 + </Column>
133 + </Columns>
134 +</SummaryRow>
135 +
136 +{{/code}}
137 +
138 +
139 +**Too see more details of example columns of different length**, please visit the [[Invoice columns examples >>doc:Main.Invoicing.invoice-service.Implementation guide.Invoice columns.Invoice layout examples.WebHome]]section.