Changes for page Implementation Guide
Last modified by Anders Göthberg on 2022/05/20 11:14
From version 1.1
edited by Andreas Benneck
on 2020/09/24 12:28
on 2020/09/24 12:28
To version 2.1
edited by Andreas Benneck
on 2020/09/24 12:28
on 2020/09/24 12:28
Change comment: There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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 +