From version 1.1
edited by Andreas Benneck
on 2020/09/24 12:28
To version 2.1
edited by Andreas Benneck
on 2020/09/24 12:28
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,0 +1,198 @@
1 +(% id="HIntroduction" %)
2 += Introduction =
3 +
4 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=1]]
5 +
6 +In PayEx Billing, the invoice is created for the ledger system. At Billing we compiles one-time and recurring fees and credits to a invoice basis per end customer. When creating a invoice, any debit or credit products are taken into account. The invoice is then exported to PayEx Ledger service (invoice service) and further to Distribution. Data can be received and loaded automatically all around the clock every day of the year.
7 +
8 +This is a general step-for-step implementations guide that guide you through.....
9 +
10 +(% id="HPrerequisites" %)
11 +== Prerequisites ==
12 +
13 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=2]]
14 +
15 +Before you start implementing PayEx Billing the following is required:
16 +
17 +* An Agreement Invoice Service with Billing
18 +* Obtained credentials from PayEx
19 +* A sFTP Client
20 +* Business Rules
21 +* Revenue Accounting Rules
22 +
23 +Feel free to [[contact us>>path:mailto:sales@payex.com]] if you have any questions on how to get started.
24 +
25 +
26 +(% id="HWhatyoushoulddo2Cstepbystep." %)
27 +All main steps of the invoice process are described below. **Please note** that all XML/csv examples below are here primarily for display purposes, to help you get an understanding of the file format and to aid you in the implementation.
28 +
29 +(% id="HOverview" %)
30 +== Overview ==
31 +
32 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=3]]
33 +
34 +PayEx Billing aggregates one-time and recurring fees & credits to one invoice basis per end customer. When creating invoice documents, any submitted discounts and credit products are taken into account. The invoice documentation is then exported to PayEx ledgers and PayEx Distribution (creation of invoices and mailings in various channels).
35 +
36 +When implementing Invoice Service Billing with Revenue Accounting, customer-specific configuration takes place
37 +
38 +(% id="HBicus228Customerfilexml29" %)
39 +=== Bicus2 (Customerfile xml) ===
40 +
41 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=4]]
42 +
43 +Customerfile is used to submit end-user information to the PayEx Billing System. Bicus2 contains the end customer's customer information together with all of the end customer's subscriptions and products to be processed in the PayEx Billing System.
44 +
45 +(% id="HKUB28Customerfilecsv29" %)
46 +=== KUB (Customerfile csv) ===
47 +
48 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=5]]
49 +
50 +Customerfile to billing (KUB) is used to submit end-user information to the PayEx Billing System. KUB contains the end customer's customer information together with all of the end customer's subscriptions and products to be processed in the PayEx Billing System.
51 +
52 +(% id="HPR0128Productfilecsv29" %)
53 +=== PR01 (Productfile csv) ===
54 +
55 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=6]]
56 +
57 +Using PR01 files in the Payex Billing system gives possibilities to create non recurrent products on both customer and subscription level.
58 +
59 +Communication of disposable products that will be placed at the end customer level. The productfile contains information about price (+/-), VAT rate and the product name that is communicated to the end customer.
60 +
61 +(% id="HProductCatalog" %)
62 +=== Product Catalog ===
63 +
64 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=7]]
65 +
66 +The file contains instructions how products is to be booked.
67 +
68 +(% id="HRevenueAccountingRules" %)
69 +=== Revenue Accounting Rules ===
70 +
71 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=8]]
72 +
73 +...
74 +
75 +(% id="HReceipt" %)
76 +== Receipt ==
77 +
78 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=9]]
79 +
80 +When one of above files are sent to us, and after PayEx have started the file you will receive a receipt at the file and its content.
81 +
82 +Each activity has their own set of result parameters
83 +
84 +You can view the receipt and a detailed description here.
85 +
86 +(% id="HCostumerfile" %)
87 +=== Costumerfile ===
88 +
89 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=10]]
90 +
91 +...
92 +
93 +(% id="HProductfile" %)
94 +=== Productfile ===
95 +
96 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=11]]
97 +
98 +...
99 +
100 +(% id="HProductCatalog-1" %)
101 +=== Product Catalog ===
102 +
103 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=12]]
104 +
105 +...
106 +
107 +(% id="HReports" %)
108 +== Reports ==
109 +
110 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=13]]
111 +
112 +...
113 +
114 +(% id="HInvoiceJournalBilling" %)
115 +=== Invoice Journal Billing ===
116 +
117 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=14]]
118 +
119 +...
120 +
121 +(% id="HBillingAccounting" %)
122 +=== BillingAccounting ===
123 +
124 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=15]]
125 +
126 +After every billing where we have created invoices, we create a Revenue Accounting report BillingAccounting. The report including:
127 +
128 +(% role="list" %)
129 +* (((
130 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":0,~"335559685~":450,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{93}" paraid="0" %)
131 +Invoicenumber​
132 +)))
133 +* (((
134 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":1,~"335559685~":1170,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{96}" paraid="0" %)
135 +VAT code
136 +)))
137 +* (((
138 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":1,~"335559685~":1170,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{96}" paraid="0" %)
139 +Account
140 +)))
141 +* (((
142 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":1,~"335559685~":1170,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{96}" paraid="0" %)
143 +ProductCode
144 +)))
145 +* (((
146 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":1,~"335559685~":1170,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{96}" paraid="0" %)
147 +Group company code
148 +)))
149 +* (((
150 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":1,~"335559685~":1170,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{99}" paraid="0" %)
151 +Cost center
152 +)))
153 +* (((
154 +(% data-ccp-props="{~"335551550~":1,~"335551620~":1,~"335559683~":1,~"335559685~":1170,~"335559731~":-450,~"335559737~":0,~"335562764~":2,~"335562765~":1,~"335562766~":4,~"335562767~":0,~"335562768~":4,~"335562769~":0}" data-indent="-450" lang="EN-US" paraeid="{5c66c65e-8d9e-4bcf-a86e-8e130028a5b7}{102}" paraid="0" %)
155 +Amount
156 +)))
157 +
158 +(% id="HBilledInAdvanced" %)
159 +=== BilledInAdvanced ===
160 +
161 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=16]]
162 +
163 +Once a month PayEx Billing sends a report containing billed in advanced
164 +
165 +(% id="HUnbilledProduct" %)
166 +=== UnbilledProduct ===
167 +
168 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=17]]
169 +
170 +Once a month PayEx Billing sends a report containing unbilled products
171 +
172 +(% id="HQueuepostReport" %)
173 +=== QueuepostReport ===
174 +
175 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=18]]
176 +
177 +After billing we create report BRPT001 + BRPT002, the reports contains companys queuepost that are sent for billing, but yet not invoiced.
178 +
179 +The BRPT001 report is ment to update your database or imported to excel.
180 +
181 +The BRPT002 report is ment to be easy to read and understand, also easy to print but not import to a database.
182 +
183 +Both reports consists recurring and non recurring products.
184 +
185 +
186 +(% id="HReceipt" %)
187 +=== ===
188 +
189 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=19]]
190 +
191 +(% id="HErrorlog" %)
192 +== Error log ==
193 +
194 +[[Edit>>url:https://developer.payex.com/xwiki/wiki/developer/edit/Main/billing/implementation-guide/WebHome?section=20]]
195 +
196 +If errors are encountered during file processing an errorlog will be created. Errors may refer to insufficient customer information or format errors.
197 +
198 +