From empty
To version 22.1
edited by Fredrik Nilsson
on 2019/11/07 09:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +Implementation guide
Parent
... ... @@ -1,0 +1,1 @@
1 +Main.Invoicing.invoice-service.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,173 @@
1 += Introduction =
2 +
3 +(% class="jumbotron" %)
4 +(((
5 +(% class="container" %)
6 +(((
7 +This is a general step-for-step implementations guide that guide you through the creation of the CUSIN file that contains your invoice information.
8 +)))
9 +)))
10 +
11 +== Prerequisites ==
12 +
13 +Before you start implementing PayEx Invoice Service the following is required:
14 +
15 +* A sFTP Client
16 +* An agreement that includes PayEx Invoice Service (CUSIN)
17 +* Obtained credentials from PayEx
18 +* A basic understanding of [[file name convention and file format limitations>>doc:Main.Invoicing.invoice-service.Technical reference.Cusin.WebHome||anchor="HNameconvention"]]
19 +
20 +Feel free to [[contact us>>mailto:invoice.client@payex.com]] if you have any questions on how to get started.
21 +
22 +== Overview ==
23 +
24 +Before getting started, have a look at the high level sequence diagram below, which will help you getting a better understanding of the whole process and the components necessary to implement Invoice Service.
25 +
26 +{{plantuml}}
27 +@startuml
28 +skinparam sequence{
29 +ArrowColor #2DA944
30 +ActorFontColor #333333
31 +ActorFontStyle bold
32 +ActorFontSize 15
33 +ActorBackgroundColor #fefefe
34 +ActorBorderColor #2DA944
35 +LifeLineBorderColor #999999
36 +LifeLineBackgroundColor #dddddd
37 +ParticipantBorderColor #2DA944
38 +ParticipantBackgroundColor #ffffff
39 +ParticipantFontColor #333333
40 +ParticipantFontStyle bold
41 +}
42 +skinparam Roundcorner 10
43 +skinparam Shadowing false
44 +skinparam ActivityBorderColor #123123
45 +skinparam NoteBackgroundColor white
46 +skinparam NoteBorderColor #999999
47 +skinparam NoteFontColor #333333
48 +skinparam sequenceDividerBackgroundColor white
49 +skinparam sequenceDividerBorderColor #999999
50 +skinparam sequenceDividerFontStyle bold
51 +skinparam sequenceDividerFontSize 15
52 +'//Sequence start//'
53 +|||
54 +Customer->Company: Purchase information processed via Company's ERP
55 +|||
56 +Activate Customer
57 +==[[/xwiki/wiki/developer/view/Main/Invoicing/invoice-service/Implementation%20guide/#HInvoicing Invoicing]]==
58 +Activate Company
59 +Activate PayEx
60 +Company->PayEx: Create <Cusin>
61 +PayEx->Company: Receive <Receipt>
62 +PayEx->Company: Receive <Errorlog>
63 +Deactivate Company
64 +PayEx->Customer: Distribute <Invoice>]
65 +|||
66 +Deactivate Customer
67 +hnote over Company: Invoice gets payed/closed or continues in claim process
68 +|||
69 +==[[/xwiki/wiki/developer/view/Main/Invoicing/invoice-service/Implementation%20guide/#HReportsandAccounting Reports and Accounting]]==
70 +PayEx->Company: Receive <Bill Journal>
71 +Activate Company
72 +PayEx->Company: Receive <Customer Journal>
73 +PayEx->Company: Receive <Accounting Detail>
74 +PayEx->Company: Receive <SIE4>]
75 +PayEx->Company: Receive <Balance Report>
76 +Deactivate PayEx
77 +Deactivate Company
78 +|||
79 +'//Sequence end//'
80 +@enduml
81 +{{/plantuml}}
82 +
83 +(% class="wikigeneratedid" id="HWhatyoushoulddo2Cstepbystep." %)
84 +All main steps of the invoice process are described below. **Please note** that all XML examples below are here primarily for display purposes, to help you get an understanding of the CUSIN file format and to aid you in the implementation.
85 +
86 +If you encounter any problem during implementation, don't hesitate to [[contact us>>mailto:invoice.client@payex.com]].
87 +
88 +== Invoicing ==
89 +
90 +The initial step is to create your [[CUSIN >>doc:Main.Invoicing.invoice-service.Technical reference.Cusin.WebHome]]file.
91 +
92 +=== Cusin ===
93 +
94 +The first thing you need to do is to create a CUSIN file with extension .XML and UTF-8 encoding. Name it according to the filename convention.
95 +
96 +Head over to our [[technical reference section>>doc:Main.Invoicing.invoice-service.Technical reference.Cusin.WebHome]] for a more extensive description of the file format, where you find more information of each element in the XML schema and CUSIN example file.
97 +
98 +To learn more of how to edit invoice column length and use summary rows, visit the [[Invoice columns section>>url:https://developer.payex.com/xwiki/wiki/developer/view/Main/Invoicing/invoice-service/Invoice%20columns/]].
99 +
100 +(% class="wikigeneratedid" id="HTransferringfilestoPayEx" %)
101 +When you have a complete and validated CUSIN file, you are ready to transfer it to PayEx via sFTP.
102 +
103 +(% class="wikigeneratedid" %)
104 +Upon reception PayEx will process the file and send you a receipt in return. If something went wrong, you will also receive an error log.
105 +
106 +=== Receipt ===
107 +
108 +When the CUSIN file, containing one or more activities - is processed a receipt will be created showing numbers of processed customers, numbers of processed invoices and total amount.
109 +
110 +Each activity has their own set of result parameters
111 +
112 +You can view the XSD and a detailed description [[here>>doc:Main.Invoicing.invoice-service.Technical reference.Receipt.WebHome]].
113 +
114 +=== Error log ===
115 +
116 +If errors are encountered during file processing an errorlog will be created. Errors may refer to insufficient customer information, invoice information or format errors.
117 +
118 +The first part displays the processed item itself.
119 +
120 +The second part of the error log displays the response item message element that gives reference back to the processed file.
121 +
122 +You can view the XSD and a detailed description [[here>>doc:Main.Invoicing.invoice-service.Technical reference.Errorlog.WebHome]].
123 +
124 +=== (% style="color:inherit; font-family:inherit; font-size:23px" %)Invoice generation(%%) ===
125 +
126 +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.
127 +
128 +**Click on the invoice image to download the full PDF invoice example.** If you want to learn more about customizing your invoice, head over to our section that cover [[additional features and functions>>doc:Main.Invoicing.invoice-service.Supplementary features.WebHome]].
129 +
130 +== [[[[image:invoice-example.PNG]]>>attach:Main.Invoicing.invoice-service.Technical reference.example-files.WebHome@Exempelfaktura.pdf]] ==
131 +
132 +== Reports and Accounting ==
133 +
134 +You get response files from PayEx in the from of Bill and Customer Journal.
135 +
136 +=== Bill Journal ===
137 +
138 +Bill Journal is the format used to notify changes in invoice status. Entries could relate to events such as a new claim process level, invoices getting closed and newly registered complaints and respites.
139 +
140 +You find the Bill Journal technical reference [[here>>doc:Main.Invoicing.invoice-service.Technical reference.BillJournal.WebHome||anchor="HBillJournal"]].
141 +
142 +=== Customer Journal ===
143 +
144 +Customer Journal is the format used to notify changes in customer information. Entries could relate to events such as a new legal address, activation/cancellation of consent and customer status changes due to decease.
145 +
146 +You find the Customer Journal technical reference [[here>>doc:Main.Invoicing.invoice-service.Technical reference.CustomerJournal.WebHome||anchor="HCustomerJournal"]].
147 +
148 +=== Accounting Detail ===
149 +
150 +Bookkeeping data is produced on two levels. You get accounting records on the transactional level as well as aggretated in the standardised SIE format type 4.
151 +
152 +Files are exported from PayEx on a daily schedule.
153 +
154 +
155 +**The Accounting Detai**l file describes the accounting records on the transaction level and Includes invoice number, book account, amount, value date, etc.
156 +
157 +You find the Accounting Detail technical reference [[here>>doc:Main.Invoicing.invoice-service.Technical reference.AccountingDetail.WebHome||anchor="HAccountingDetail" style="background-color: rgb(255, 255, 255);"]].
158 +
159 +
160 +**The SIE4** **file **describes the accounting records on an aggregated level, that includes total amounts per book account.
161 +
162 +You find the SIE4 technical reference [[here>>doc:Main.Invoicing.invoice-service.Technical reference.SIE4.WebHome||anchor="HSIE4" style="background-color: rgb(255, 255, 255);"]].
163 +
164 +(% id="HBalanceReport" %)
165 +=== Balance Report ===
166 +
167 +The [[Balance Report (Client Asset Disbursement)>>doc:Main.Invoicing.invoice-service.Technical reference.BalanceReport.WebHome||anchor="HBalanceReport"]] includes:
168 +
169 +* **A payment summary** of amount sold, fees and, VAT and specification of total amount to be paid out.
170 +* **A sales specification**. Each record of "Client asset disbursement" listed is equal to the full Accounting Detail for the specified period.
171 +* (((
172 +**A Fees specification.** Depending on setup, fees are either deducted from the amount to be paid out, or (when applicable) to be invoiced separatly.Each fees row specify Quantity (sales), Amount (sales), Unit price, Provision and fee Amount.
173 +)))
invoiceservice.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +52.9 KB
Content
PayExConnect_Manual_PxR_ExternalServices.docx
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +528.8 KB
Content
SIE4I_10_20161214093949_0[SEK_Claimant_BAS 2000].SI
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +569 bytes
Content
... ... @@ -1,0 +1,26 @@
1 +#FLAGGA 0
2 +#PROGRAM PayEx.AR.Batch.SIE4I 2016.12.344.1
3 +#FORMAT PC8
4 +#GEN 20161214 1321557
5 +#SIETYP 4
6 +#KPTYP "BAS 2000"
7 +#VALUTA SEK
8 +#FNAMN "TestFirma 10"
9 +#ORGNR 556735-56710
10 +#KONTO 1510 "Kundfordingar PayEx"
11 +#KTYP 1510 O
12 +#KONTO 1684 "Kortfristig fordran PayEx"
13 +#KTYP 1684 O
14 +#KONTO 3710 "Nedskrivningar av int´┐Żkter"
15 +#KTYP 3710 I
16 +#VER C 77002 20161213
17 +{
18 + #TRANS 1510 {} -250.00 20161213
19 + #TRANS 1510 {} 250.00 20161213
20 +}
21 +#VER C 77003 20161213
22 +{
23 + #TRANS 1510 {} -2500.00 20161222
24 + #TRANS 1684 {} 2499.50 20161222
25 + #TRANS 3710 {} 0.50 20161222
26 +}
Item_Description_ARAccountingDetail_1.1.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +719.9 KB
Content
PayExConnect_Manual_Common.doc
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +451.5 KB
Content
PayExConnect_Manual_SampleService.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +403.8 KB
Content
invoice-example.PNG
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +56.0 KB
Content