Invoice layout

Introduction

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.

Invoice generation

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. 

invoice-example.PNG

The main element that govern column structure is InvoicePrintblock and the subseqent SubOrderBlocks. An invoice can have serveral Printblocks.

InvoicePrintBlock
<BasePrintBlock>
   <SubOrderBlock TableType="A2">
       <ColumnHeadLine>
           <Columns>
               <Column ColumnNo="1">
                   <Text>Services</Text>
               </Column>
               <Column ColumnNo="2">
                   <Text>Products</Text>
               </Column>
       </ColumnHeadLine>
       <Rows>  
           <Row>
               <Columns>
                   <Column ColumnNo="1">
                       <Text>A Service</Text>
                   </Column>
                   <Column ColumnNo="2">
                       <Text>1.00</Text>
                   </Column>
               </Columns>
           </Row>
       </Rows>
       <SummaryRow>
           <Columns>
               <Column ColumnNo="1">
                   <Text>Amount</Text>
               </Column>
               <Column ColumnNo="2">
                   <Text>424.00</Text>
               </Column>
           </Columns>
       </SummaryRow>

<PrintBlockConfig PrecedingPageBreak=”false/true” PrecedingSheetBreak=”false/true”>
</PrintBlockConfig>

Defining column amount

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 SubOrderBlock 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. 

Adding rows

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).   

Adding Rows
<Row>
   <Columns>
       <Column ColumnNo="1">
           <Text>A Service</Text>
       </Column>
       <Column ColumnNo="2">
           <Text>1.00</Text>
       </Column>
   </Columns>
</Row>
<Row>
   <Columns>
       <Column ColumnNo="1">
           <Text>Another Service</Text>
       </Column>
       <Column ColumnNo="2">
           <Text>1.00</Text>
       </Column>
</Row>
<Row>
   <Columns>
       <Column ColumnNo="1">
           <Text>Another more exensive service</Text>
       </Column>
       <Column ColumnNo="2">
           <Text>3.00</Text>
       </Column>
</Row>

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 SummaryRowelemement 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.

Summary row

<SummaryRow>
   <Columns>
       <Column ColumnNo="1">
           <Text>Belopp</Text>
       </Column>
       <Column ColumnNo="2">
           <Text></Text>
       </Column>
       <Column ColumnNo="3">
           <Text></Text>
       </Column>
       <Column ColumnNo="4">
           <Text></Text>
       </Column>
       <Column ColumnNo="5">
           <Text></Text>
       </Column>
       <Column ColumnNo="6">
           <Text></Text>
       </Column>
       <Column ColumnNo="7">
           <Text></Text>
       </Column>
       <Column ColumnNo="8">
           <Text>424.00</Text>
       </Column>
   </Columns>
</SummaryRow>

Too see more details of example columns of different length, please visit the Invoice columns examples section.

Created by Fredrik Nilsson on 2021/06/29 16:51