From empty
To version 87.1
edited by Fredrik Nilsson
on 2023/03/23 11:25
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +Supplementary features
Parent
... ... @@ -1,0 +1,1 @@
1 +developer:Main.Invoicing.invoice-service.Implementation guide.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,332 @@
1 += Introduction =
2 +
3 +(% class="jumbotron" %)
4 +(((
5 +(% class="container" %)
6 +(((
7 +This section covers additional features and functions of PayEx Invoice Service, that are not part of the base service. If you want to add additional features to your Invoice Service package please contact us for more information!
8 +)))
9 +)))
10 +
11 +== Automatic payment service ==
12 +
13 +Automatic payment service (direct debit) enables automatic payments that debit your customer's bank account on the invoice due date. If the bank account lacks coverage, up to three attempts will be made before a reminder is sent to your customer.
14 +
15 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
16 +
17 +When the customer apply for the automatic payment service PayEx handles the consent.
18 +You retrieve information about activated/deactivated consents in Customer Journal (depending on service set up).
19 +
20 +By default, an active consent means that the next invoice produced will use the the automatic payment method.
21 +
22 +(% lang="EN-US" %)
23 +To use automatic payment service, your customer needs to apply in any of the following ways:
24 +
25 +(% lang="EN-US" %)
26 +- The automatic payment sign up via the customers internet bank.
27 +
28 +(% lang="EN-US" %)
29 +- The automatic payment sign up via the service providers app/web site, etc. (depending on service/country)
30 +
31 +(% lang="EN-US" %)
32 +- Using the Electronic agreement application provided by PayEx, see below.
33 +
34 +(% lang="EN-US" %)
35 +**Please note** that different customer information is required for different counties, in order for direct debit to work
36 +
37 +(% lang="EN-US" %)
38 +Sweden:
39 +
40 +* RegNo/nationalIdentifier (SSN) needs to be sent to PayEx as it is the identifier used by Autogiro
41 +* Only numeric characters and not with a leading zero may be used in CustomerNo
42 +
43 +Norway:
44 +
45 +* KID-number (Kundeiidentifikasjon) is the identifier used by AvtaleGiro
46 +* KID-number is generated by PayEx, no additional customer information needs to be sent to PayEx in order for AvtaleGiro to work
47 +
48 +Denmark:
49 +
50 +* CustomerNo is the identifier used by Betalingsservice
51 +* No additional customer information needs to be sent to PayEx in order for Betalingsservice to work
52 +
53 +(% lang="EN-US" %)
54 +=== Electronic agreement application (Sweden) ===
55 +
56 +(% lang="EN-US" %)
57 +The customer access the service application on a website hosted by PayEx. You may offer the Electronic agreement service within your own "My Site" or as a part of your onboarding process of registering as a new customer. A link to the website can also be sent to the customer i.e. via sms or e-mail.
58 +
59 +(% lang="EN-US" %)
60 +The customers RegNo/nationalIdentifier (SSN) needs to be sent to PayEx as it is the identifier used by Autogiro
61 +
62 +(% lang="EN-US" %)
63 +The customer fills in social security number and bank account number from which the money is to be deducted, reviews the information related to the agreement and then submits by signing with BankID. The agreement is then sent to BGC and the consent will be visible in both the customers internet bank and on the customer information in PayEx web interface when activated. The consent is stored in xml-format at PayEx.
64 +
65 +(% lang="EN-US" %)
66 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
67 +
68 +(% lang="EN-US" %)
69 +=== Electronic agreement application (Norway) ===
70 +
71 +(% lang="EN-US" %)
72 +The customer access the direct debit sign up as an HTML form on your website. The customer authenticates with BankID, choose bank account from which the money is to be deducted, fills monthly amout limit, reviews the information related to the agreement and then submits by signing with BankID. The agreement is forwarded to the bank for confirmation and will be visible in both the customers internet bank and on the customer information in PayEx web interface when activated. For further information about the concept please visit: [[https:~~/~~/www.mastercardpaymentservices.com/norway/utvikler/pvuoverview>>url:https://www.mastercardpaymentservices.com/norway/utvikler/pvuoverview]]
73 +
74 +(% lang="EN-US" %)
75 +You may offer the Electronic agreement service within your own "My Site" or as a part of your onboarding process of registering as a new customer. A link to the form can also be sent to the customer e.g. via sms or e-mail.
76 +
77 +(% lang="EN-US" %)
78 +The HTML form on your website inter​act with the E-Agreement via an http post. A guide how to set up the web form and http post is found here: [[https:~~/~~/www.mastercardpaymentservices.com/norway/utvikler/pvugetstarted>>url:https://www.mastercardpaymentservices.com/norway/utvikler/pvugetstarted]]
79 +
80 +In order for AvtaleGiro sign up to work a unique KID-number needs to be created for every customer.
81 +
82 +KID number at PayEx always consists of 12 digits by default, e.g.(% style="font-family:Calibri,sans-serif; font-size:11pt" %) (% style="background:yellow; font-family:Calibri,sans-serif; font-size:11pt" %)1234567(% style="background:lime; font-family:Calibri,sans-serif; font-size:11pt" %)0000(% style="background:aqua; font-family:Calibri,sans-serif; font-size:11pt" %)X
83 +
84 +(% style="margin:0cm" %)
85 +(% style="background:yellow; font-family:Calibri,sans-serif; font-size:11pt" %)7 digits (%%)= customer number sent to PayEx
86 +
87 +(% style="margin:0cm" %)
88 +(% style="background:lime; font-family:Calibri,sans-serif; font-size:11pt" %)4 digits (%%)= used at PayEx for invoice serial number per customer and ledger (may also be filled out with all zeroes when generating KID, i.e. in sign up for AvtaleGiro)
89 +
90 +(% style="margin:0cm" %)
91 +(% style="background:aqua; font-family:Calibri,sans-serif; font-size:11pt" %)1 digit (%%)= control digit (may also be replaced with zero when generating KID, i.e. in sign up for AvtaleGiro)
92 +
93 +
94 +(% style="margin:0cm" %)
95 +Modulus 10 is used as algorithm to calculate the control digit.
96 +
97 +
98 +(% lang="EN-US" %)
99 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
100 +
101 +(% id="HVerifiedpayment-Verifieratbetalsatt" %)
102 +== Verified payment - Verifierat betalsätt ==
103 +
104 +With Verified payment the change to automated payments through Autogiro/AvtaleGiro is activated only when the payment rules in the CUSIN file is changed accordingly. This verification ensures that i.e. the customer invoice fee is correct at all times.
105 +
106 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
107 +
108 +This is achieved by activating or deactivating direct debit as part of the verified payment service in the PaymentRule element of the CUSIN file.
109 +
110 +Payment Rules:
111 +UseBGAGSE = Autogiro (Sweden)
112 +UseBKAGNO = AvtaleGiro (Norway)
113 +
114 +Set Value to 1 for activation and Value to 0 for deactivation.
115 +
116 +{{code language="xml" title="**Payment rule Autogiro**"}}
117 +<CUSIN>
118 + <CUSINInfo>
119 + <PaymentInfo>
120 + <Set>
121 + <PaymentRules>
122 + <PaymentRule Rule="UseBGAGSE">
123 + <Value>1</Value>
124 + </PaymentRule>
125 + </PaymentRules>
126 + </Set>
127 + </PaymentInfo>
128 + </CUSINInfo>
129 +</CUSIN>
130 +{{/code}}
131 +
132 +== E-Invoice - eFaktura ==
133 +
134 +The eFaktura service enables distribution of bills electronically, either to a customer's online banking system or directly to a business ERP system.
135 +
136 +=== E-invoice internet bank B2C ===
137 +
138 +To distribute and get paid via the online banking system the customer needs to give their consent in the internet bank.
139 +
140 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
141 +
142 +When the customer applies for the service PayEx handles the consent and you will retrieve information about activated/deactivated consents in Customer Journal.
143 +
144 +An active consent will set distribution method to e-invoice and override any DistributionType set in Cusin, meaning that by default the next invoice produced will use the specified distribution method.
145 +
146 +=== eFaktura internet bank B2C Norway only ===
147 +
148 +eFaktura 2.0 is a "one click applies to all"-solution used by the norwegian online banking system. To use eFaktura 2.0 the customer needs to give their consent to the service in the internet bank.
149 +
150 +In order to make eFaktura 2.0 available as a distribution method on a specific customer PayEx will do lookups in Nets eFaktura Service alias register. Therefore, these alias parameters (perfect match) must be sent to PayEx in order to generate a match to each specific customer at Nets. The following rules outline which alias combinations will return a match when doing lookups:
151 +
152 +* **SSN**, //or//
153 +* 2 of 3 of the following: **Phone number**, **e-mail**, **zip code**
154 +
155 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
156 +
157 +When the customer applies for the service PayEx handles the consent and you will retrieve information about activated/deactivated consents in Customer Journal.
158 +
159 +An active consent will set distribution method to e-invoice and override any DistributionType set in Cusin, meaning that by default the next invoice produced will use the specified distribution method.
160 +
161 +=== Vipps eFaktura Norway only ===
162 +
163 +Customer using eFaktura automatically has the possibility to use Vipps Regning. Regardless of whether the customer apply for Vipps Regning or eFaktura they will receive the invoice electronically __both __in their Vipps app and in their online bank as eFaktura.
164 +
165 +Thereby both eFaktura and Vipps Regning are defined as EInvoiceB2CSE.
166 +
167 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
168 +
169 +When the customer applies for the service PayEx handles the consent and you retrieve information about activated/deactivated consents in Customer Journal.
170 +
171 +An active consent will set distribution method to e-invoice and override any DistributionType set in Cusin, meaning that by default the next invoice produced will use the specified distribution method.
172 +
173 +=== E-Invoice B2B ===
174 +
175 +You can distribute bills business to business (B2B) electronically. To retrieve and import bills directly into a business customer's ERP system (e.g through EHF, EDI or Svefaktura) you need to send a technical specification of the necessary requirements from the receiving system, in order for PayEx to verify format and structure.
176 +
177 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
178 +
179 +If invoice distribution in cusin is set to EInvoiceB2B, the following information is mandatory in the EDIInfo:
180 +- Customer VAN
181 +- Buyer ID
182 +- Seller ID
183 +
184 +If any of these values is not supplied, an error is created and the invoices will not be distributed B2B. As fallback an invoice copy will be distributed by postal service to the customers Billing Address.
185 +
186 +(% id="HVerifieddistribution-Verifieratdistributionssatt" %)
187 +== Verified distribution - Verifierat distributionssätt ==
188 +
189 +With Verified distribution the change to electronic distribution through E-Invoice B2C is activated only when the distribution rules in the CUSIN file is changed accordingly. This verification ensures that i.e. the customer invoice fee is correct at all times.
190 +
191 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
192 +
193 +This is achieved by activating or deactivating E-Invoice B2C as part of the Verified distribution service in the DistributionRule element of the CUSIN file.
194 +
195 +Distribution Rules:
196 +UseEInvoiceB2CSE = E-faktura (Sweden)
197 +UseEInvoiceB2CNO = eFaktura (Norway)
198 +UseEInvoiceB2CFI = EInvoice (Finland)
199 +
200 +Set Value to 1 for activation and Value to 0 for deactivation.
201 +
202 +**N.B.** No activation is needed if distribution is made by B2B EDI (DistributionType EInvoiceB2B is used).
203 +
204 +{{code language="xml" title="**Distribution rule eFaktura**"}}
205 +<CUSIN>
206 + <CUSINInfo>
207 + <DistributionInfo>
208 + <Set>
209 + <BillTypes>
210 + <BillType DistributionBillType="I_Invoice">
211 + <DistributionRules>
212 + <DistributionRule Rule="UseEInvoiceB2CSE">
213 + <value>1</value>
214 + </DistributionsRule>
215 + </DistributionsRules>
216 + </BillType>
217 + </BillTypes>
218 + </Set>
219 + </DistributionInfo>
220 + </CUSINInfo>
221 +</CUSIN>
222 +{{/code}}
223 +
224 +== Kivra (Sweden only) ==
225 +
226 +To distribute via Kivra, your customer needs to sign up for a Kivra account.
227 +
228 +**N.B.** Can only be used if specially contracted with PayEx, contact us to learn more.
229 +
230 +When the customer applies for the service PayEx handles the consent and you will retrieve information about activated/deactivated consents in Customer Journal.
231 +
232 +An active consent will set distribution method to Kivra and override any DistributionType set in Cusin.
233 +
234 +== Settle surplus payment ==
235 +
236 +(% class="wikigeneratedid" %)
237 +If an invoice is paid in excess, a credit is created. PayEx supports automatic settlement on the receivables instead of disbursement.
238 +
239 +(% class="wikigeneratedid" %)
240 +The credit amout can be used to either:
241 +- settle an overdue invoice, or
242 +- to be deducted from the amout to be payed on the next invoice (typically applicable when billing of subscription services).
243 +
244 +(% class="wikigeneratedid" %)
245 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
246 +
247 +== Unpaid costs in arrear ==
248 +
249 +If only the original capital amout is paid on an invoice claim, fees and interest remain to be paid.
250 +
251 +PayEx supports handling of unpaid costs in arrear by billing the remaining costs at the same time as the next invoice is created (typically applicable when billing of subscription services).
252 +
253 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
254 +
255 +== Invoice layout ==
256 +
257 +You can tailor you invoice according to your business needs - from adding you company logotype to editing invoice columns and request a more thorough customization.
258 +
259 +=== Adding logotype ===
260 +
261 +To use your own logotype for invoices generated by PayEx Invoice Service you need to send a logotype image to [[setup.invoice@payex.com>>mailto:setup.invoice@payex.com]] together with customer identification.
262 +
263 +(% class="table-bordered table-striped" %)
264 +|=Property|=Description
265 +|Format|.jpg or .pcx
266 +|Resolution|300 DPI or higher is highly recommended
267 +|Max Height|1,7 cm
268 +|Max Width|8 cm
269 +
270 +=== Editing invoice columns ===
271 +
272 +You have the possibility to specify the structure and presentation of your invoice columns. This is done directly you CUSIN file that you send to PayEx.
273 +
274 +Read more about [[editing invoice colums here>>doc:Main.Invoicing.invoice-service.Implementation guide.Invoice columns.WebHome]]. To see extended details of example columns of different length, please visit the [[Invoice layout examples >>doc:Main.Invoicing.invoice-service.Implementation guide.Invoice columns.Invoice layout examples.WebHome]]section.
275 +
276 +=== Customised invoice layout ===
277 +
278 +If you want to have a customised layout that goes beyond the general framework presented above, you can use PayEx' customised layout. This supplemental service enable a wider range of options to create a tailor made invoice template. This service is set up together with PayEx in order to create and verify templates. Please contact us for more information regarding this service.
279 +
280 +== Late fee ==
281 +
282 +(% data-placeholder="Översättning" dir="ltr" id="tw-target-text" %)
283 +Companies and authorities can be charged a Late fee immediately after the due date has passed. The fee replaces the reminder and collection fee.
284 +
285 +(% dir="ltr" %)
286 +To use Late fee LegalEntity must be set to Business.
287 +
288 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
289 +
290 +== Invoice attachment ==
291 +
292 +(% data-placeholder="Översättning" dir="ltr" id="tw-target-text" %)
293 +PayEx Invoice Service offers the possibility to add invoice attachments/enclosures. The attachment will be produced as an extra page following the invoice document. Attachments can be distributed both electronically and by postal service.
294 +
295 +(% dir="ltr" %)
296 +To use Invoice attachment a pdf-document is required consisting of one or more pages.
297 +
298 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
299 +
300 +== Protected Identity (Sweden only) ==
301 +
302 +(% data-placeholder="Översättning" dir="ltr" id="tw-target-text" %)
303 +{{{Private individuals can be registered with the status of Protected identity at the Swedish Tax Agency (Skatteverket)
304 +meaning the personal data such as name and address are protected and not available in public population register.
305 +}}}
306 +
307 +(% dir="ltr" %)
308 +In order to distribute invoices and letters ProtectedIdentity must be set, which allows special postal distribution service handled by Skatteverket.
309 +
310 +(% dir="ltr" %)
311 +ProtectedIdentity must be set in combination with a correct RegNo in order to work.
312 +
313 +(% id="HPayExConnectAPI" %)
314 +== PayEx Connect API ==
315 +
316 +PayEx Connect is a Web Service system that enables integrated access to PayEx services in a controlled and secure manner.
317 +Access to this services requires explicit permissions on a company level and on a method level.
318 +
319 +**N.B. **Can only be used if specially contracted with PayEx, contact us to learn more.
320 +
321 +Learn more about PayEx Connect below:
322 +
323 +[[Manual - Common>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.PayEx Connect (API).Commonimplementationsmanual.WebHome]] covers the prerequisites needed before you start to integrate a system with PayEx Connect. This manual cover architecture, implementation, security and error handlings.
324 +
325 +[[Manual - Sample Service>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.PayEx Connect (API).WebHome]] covers web methods used in sample scenarios.
326 +
327 +[[Manual - External Services>>doc:Main.Invoicing.invoice-service.Implementation guide.Technical reference.PayEx Connect (API).WebHome]] covers Invoice Services and the following type of methods:
328 +
329 +* Get Invoice Information
330 +* Get Invoice document in the format of PDF
331 +* Get Customer Information
332 +* Request invoice/customer actions
ColumnLayout.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.dap
Size
... ... @@ -1,0 +1,1 @@
1 +0 bytes
Content