PayEx CUSIN (CustomerInvoice) is a file format for you to send customer and invoice information to PayEx. This is a technical overview of the file format, its elements and related material. This section should be seen as a companion to the standard setup scenario.
XSD overview
Invoice service (with distribution)
![Cusin_[2.0].xsd-withdistribution.svg](/xwiki/wiki/developer/downloadrev/Main/Invoicing/invoice-service/Implementation%20guide/Technical%20reference/Cusin/WebHome/Cusin_%5B2.0%5D.xsd-withdistribution.svg?rev=1.1&width=435&height=961)
Ledger service (without distribution)
![Cusin_[2.0].xsd-withoutdistribution.svg](/xwiki/wiki/developer/downloadrev/Main/Invoicing/invoice-service/Implementation%20guide/Technical%20reference/Cusin/WebHome/Cusin_%5B2.0%5D.xsd-withoutdistribution.svg?rev=1.1&width=397&height=829)
Encoding
The file must use UTF-8 encoding.
Name convention
CUSIN_<CompanyNumber>_<DateTime>_<SerialNumber>.xml
| Name components | Description |
|---|---|
| CompanyNumber | The company number in our ledger system |
| DateTime | Date created, Should be in the format ISO 8601 format, YYYYMMDDhhmmdd |
| SerialNumber | Should follow an uninterrupted number series, 1, 2, 3 and so on. |
Limitations
| Limitations | Description |
|---|---|
| Maximum size limit | 100 MB |
| Maximum number of lines | 50.000 items |
Important to note!
- You cannot use the same serial number more than once. In case something goes wrong during CUSIN processing, you need to supply a new serial number - the next number in the number series you are using - when transferring the rectified file to PayEx.
- To avoid most file errors, always validate the cusin-file toward an up-to-date XML schema before transferring the file to PayEx.
- Standard length of CustomerNo in Norway and Denmark is 7 characters (numeric only).
- Only use numeric characters for CustomerNo in Sweden, in order to use AutoGiro (Direct Debit).
Current XML schema description
A detailed description of the elements in the current version of the XML schema definition file (XSD) can be found here
The Cusin file must be validated toward an up-to-date XML schema file!
Download current XML schema file
| Fileversion | Version | Releasedate | Comment |
|---|---|---|---|
| 2.4 | 2022-04-26 | eCurrencyType, added new values USD,GBP | |
| 2.3 | 2020-11-24 | DistributionAddressInfo, added new field ProtectedIdentity | |
| 2.2 | 2020-10-06 | EdiInfo.EDIOrderRows.Quantity decimal support, EDIInfo.ExternalreferenceURL, added new field Added support for more characters in EdiInfo.EDIOrderRow.ContractType | |
| 2.1 | June 2020 | Order rows under SubOrderBlocks, no longer mandatory | |
| Cusin[2.01].xsd | 2.01 | February 2020 | |
| Cusin[2.0].xsd | 2.0 | 2016 |
Change Log
Version 2.4
April, 2020
eCurrencyType, added new values USD,GBP
Version 2.3
November, 2020
DistributionAddressInfo, added new field ProtectedIdentity
Version 2.2
October, 2020
EdiInfo.EDIOrderRows.Quantity decimal support,
EDIInfo.ExternalreferenceURL, added new field
Added support for more characters in EdiInfo.EDIOrderRow.ContractType
Version 2.1
June, 2020
Order rows under SubOrderBlocks, no longer mandatory
Version 2.1
February, 2020
Added new DistributionRule UseEInvoiceB2CFI, and two new properties for accounting InterCompanyCode and VatType
Version 2.0
September, 2016
Cusin[2.0].xsd
Initial version (latest documented version)