PayEx CUSIN (CustomerInvoice) is a file format for customers to send customer and invoice information to PayEx. Used in "PayEx Invoice Service". This is a technical overview of the fileformat, its elements and related material. This section should be seen as a companion to the standard setup scenario.

Please note that your CUSIN file, depending on package type and file version, might only utilize and/or contain a subset of all elements described below. See the XSD for your CUSIN file version to learn more.



The file must use UTF-8 encoding

Name convention


Names ComponentDescription
CompanyNumberThe company number in our ledger system
DateTimeDate created, Should be in the format  ISO 8601 format, YYYYMMDDhhmmdd
SerialNumberShould follow an uninterupted number series, 00001, and so on.


Maximum size limit100 MB
Maximum number of lines50.000 items

What to avoid

  • 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.

Receipt and errors

You can find an overview of the Cusin receipt file here and the Cusin errorlog file here.

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

Cusin[2.X].xsd2.X June 2020Order rows under SubOrderBlocks, no longer mandatory

Change Log

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


 Initial version (latest documented version)

Download sample file


Created by David Persson on 2019/06/20 08:41