Changes for page Implementation Guide: Cusin

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,175 +1,172 @@
1	1	= Introduction =
2	2
3		-
4	4	(% class="jumbotron" %)
5	5	(((
6		-
7		-
8	8	(% class="container" %)
9	9	(((
10		- This is a general step-for-step implementations guide that guide you through the creation of the CUSIN file that contains your invoice information.
	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.
11	11	)))
12	12	)))
13	13
14		-
15	15	== Prerequisites ==
16	16
	13	+Before you start implementing PayEx Invoice Service the following is required:
17	17
18		- Before you start implementing PayEx Invoice Service the following is required:
19		-
20		-
21	21	* A sFTP Client
22	22	* An agreement that includes PayEx Invoice Service (CUSIN)
23	23	* Obtained credentials from PayEx
24	24	* A basic understanding of [[file name convention and file format limitations>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Cusin.WebHome||anchor="HNameconvention"]]
25		-\\ Pease contact us if you have any questions on how to get started.
26		-
27	27
	20	+Pease contact us if you have any questions on how to get started.
	21	+
28	28	== Overview ==
29	29
	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.
30	30
31		- 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.
32		-\\{{plantuml}} @startuml
33		- skinparam sequence{
34		- ArrowColor #2DA944
35		- ActorFontColor #333333
36		- ActorFontStyle bold
37		- ActorFontSize 15
38		- ActorBackgroundColor #fefefe
39		- ActorBorderColor #2DA944
40		- LifeLineBorderColor #999999
41		- LifeLineBackgroundColor #dddddd
42		- ParticipantBorderColor #2DA944
43		- ParticipantBackgroundColor #ffffff
44		- ParticipantFontColor #333333
45		- ParticipantFontStyle bold
46		- }
47		- skinparam Roundcorner 10
48		- skinparam Shadowing false
49		- skinparam ActivityBorderColor #123123
50		- skinparam NoteBackgroundColor white
51		- skinparam NoteBorderColor #999999
52		- skinparam NoteFontColor #333333
53		- skinparam sequenceDividerBackgroundColor white
54		- skinparam sequenceDividerBorderColor #999999
55		- skinparam sequenceDividerFontStyle bold
56		- skinparam sequenceDividerFontSize 15
57		- '//Sequence start//'
58		- |||
59		- Customer->Company: Purchase information processed via Company's ERP
60		- |||
61		- Activate Customer
62		- ==[[/xwiki/wiki/developer/view/Main/Invoicing/invoice-service/Implementation%20guide/#HInvoicing Invoicing]]==
63		- Activate Company
64		- Activate PayEx
65		- Company->PayEx: Create <Cusin>
66		- PayEx->Company: Receive <Receipt>
67		- PayEx->Company: Receive <Errorlog>
68		- Deactivate Company
69		- PayEx->Customer: Distribute <Invoice>]
70		- |||
71		- Deactivate Customer
72		- hnote over Company: Invoice gets payed/closed or continues in claim process
73		- |||
74		- ==[[/xwiki/wiki/developer/view/Main/Invoicing/invoice-service/Implementation%20guide/#HReportsandAccounting Reports and Accounting]]==
75		- PayEx->Company: Receive <Bill Journal>
76		- Activate Company
77		- PayEx->Company: Receive <Customer Journal>
78		- PayEx->Company: Receive <Accounting Detail>
79		- PayEx->Company: Receive <SIE4>]
80		- PayEx->Company: Receive <Balance Report>
81		- PayEx->Company: Receive <ARAccounting (Billing only)>
82		- Deactivate PayEx
83		- Deactivate Company
84		- |||
85		- '//Sequence end//'
86		- @enduml
87		- {{/plantuml}}
88		-\\\\(% class="wikigeneratedid" id="HWhatyoushoulddo2Cstepbystep." %) 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.
89		-\\ If you encounter any problem during implementation, don't hesitate to [[contact us>>mailto:invoice.client@payex.com]].
90		-
	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	+PayEx->Company: Receive <ARAccounting (Billing only)>
	77	+Deactivate PayEx
	78	+Deactivate Company
	79	+|||
	80	+'//Sequence end//'
	81	+@enduml
	82	+{{/plantuml}}
91	91
92		-== Invoicing ==
	84	+(% class="wikigeneratedid" id="HWhatyoushoulddo2Cstepbystep." %)
	85	+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.
93	93
	87	+If you encounter any problem during implementation, don't hesitate to [[contact us>>mailto:invoice.client@payex.com]].
94	94
95		- The initial step is to create your [[CUSIN >>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Cusin.WebHome]]file.
96		-
	89	+== Invoicing ==
97	97
	91	+The initial step is to create your [[CUSIN >>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Cusin.WebHome]]file.
	92	+
98	98	=== Cusin ===
99	99
	95	+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.
100	100
101		- 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.
102		-\\ Head over to our [[technical reference section>>doc:Main.Invoicing.invoice-service.Implementation guide.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.
103		-\\ 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/]].
104		-\\\\(% class="wikigeneratedid" id="HTransferringfilestoPayEx" %) When you have a complete and validated CUSIN file, you are ready to transfer it to PayEx via sFTP.
105		-\\ (%%)
106		-(% class="wikigeneratedid" %) 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.
107		-
	97	+Head over to our [[technical reference section>>doc:Main.Invoicing.invoice-service.Implementation guide.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.
108	108
	99	+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/]].
	100	+
	101	+(% class="wikigeneratedid" id="HTransferringfilestoPayEx" %)
	102	+When you have a complete and validated CUSIN file, you are ready to transfer it to PayEx via sFTP.
	103	+
	104	+(% class="wikigeneratedid" %)
	105	+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.
	106	+
109	109	=== Receipt ===
110	110
	109	+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.
111	111
112		- 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.
113		-\\ Each activity has their own set of result parameters
114		-\\ You can view the XSD and a detailed description [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Receipt.WebHome]].
115		-
	111	+Each activity has their own set of result parameters
116	116
	113	+You can view the XSD and a detailed description [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Receipt.WebHome]].
	114	+
117	117	=== Error log ===
118	118
	117	+If errors are encountered during file processing an errorlog will be created. Errors may refer to insufficient customer information, invoice information or format errors.
119	119
120		- If errors are encountered during file processing an errorlog will be created. Errors may refer to insufficient customer information, invoice information or format errors.
121		-\\ The first part displays the processed item itself.
122		-\\ The second part of the error log displays the response item message element that gives reference back to the processed file.
123		-\\ You can view the XSD and a detailed description [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Errorlog.WebHome]].
124		-
	119	+The first part displays the processed item itself.
125	125
	121	+The second part of the error log displays the response item message element that gives reference back to the processed file.
	122	+
	123	+You can view the XSD and a detailed description [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.Errorlog.WebHome]].
	124	+
126	126	=== (% style="color:inherit; font-family:inherit; font-size:23px" %)Invoice generation(%%) ===
127	127
	127	+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.
128	128
129		- 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.
130		-\\**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.Implementation guide.Supplementary features.WebHome]].
131		-
	129	+**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.Implementation guide.Supplementary features.WebHome]].
132	132
133	133	== [[[[image:invoice-example.PNG]]>>attach:invoice-example.PNG]] ==
134	134
135		-
136	136	== Reports and Accounting ==
137	137
	135	+You get response files from PayEx in the from of Bill and Customer Journal.
138	138
139		- You get response files from PayEx in the from of Bill and Customer Journal.
140		-
141		-
142	142	=== Bill Journal ===
143	143
	139	+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.
144	144
145		- 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.
146		-\\ You find the Bill Journal technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.BillJournal.WebHome||anchor="HBillJournal"]].
147		-
	141	+You find the Bill Journal technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.BillJournal.WebHome||anchor="HBillJournal"]].
148	148
149	149	=== Customer Journal ===
150	150
	145	+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.
151	151
152		- 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.
153		-\\ You find the Customer Journal technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.CustomerJournal.WebHome||anchor="HCustomerJournal"]].
154		-
	147	+You find the Customer Journal technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.CustomerJournal.WebHome||anchor="HCustomerJournal"]].
155	155
156	156	=== Accounting Detail ===
157	157
	151	+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.
158	158
159		- 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.
160		-\\ Files are exported from PayEx on a daily schedule.
161		-\\\\**The Accounting Detai**l file describes the accounting records on the transaction level and Includes invoice number, book account, amount, value date, etc.
162		-\\ You find the Accounting Detail technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.6\. ARAccountingDetail.WebHome||anchor="HAccountingDetail" style="background-color: rgb(255, 255, 255);"]].
163		-\\\\**The SIE4** **file **describes the accounting records on an aggregated level, that includes total amounts per book account.
164		-\\ You find the SIE4 technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.SIE4.WebHome||anchor="HSIE4" style="background-color: rgb(255, 255, 255);"]].
165		-\\
	153	+Files are exported from PayEx on a daily schedule.
166	166
167		-=== Balance Report ===
168	168
	156	+**The Accounting Detai**l file describes the accounting records on the transaction level and Includes invoice number, book account, amount, value date, etc.
169	169
170		- The [[Balance Report (Client Asset Disbursement)>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.BalanceReport.WebHome||anchor="HBalanceReport"]] includes:
171		-
	158	+You find the Accounting Detail technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.6\. ARAccountingDetail.WebHome||anchor="HAccountingDetail" style="background-color: rgb(255, 255, 255);"]].
172	172
	160	+
	161	+**The SIE4** **file **describes the accounting records on an aggregated level, that includes total amounts per book account.
	162	+
	163	+You find the SIE4 technical reference [[here>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.SIE4.WebHome||anchor="HSIE4" style="background-color: rgb(255, 255, 255);"]].
	164	+
	165	+(% id="HBalanceReport" %)
	166	+=== Balance Report ===
	167	+
	168	+The [[Balance Report (Client Asset Disbursement)>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.BalanceReport.WebHome||anchor="HBalanceReport"]] includes:
	169	+
173	173	* **A payment summary** of amount sold, fees and, VAT and specification of total amount to be paid out.
174	174	* **A sales specification**. Each record of "Client asset disbursement" listed is equal to the full Accounting Detail for the specified period.
175	175	* (((