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

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.

Invoice Service = <InvoiceWithDistribution>

Ledger Service = <InvoiceWithoutDistribution>

Invoice service (with distribution)


Ledger service (without distribution)



The file must use UTF-8 encoding

Name convention


Name componentsDescription
CompanyNumberThe company number in our ledger system
DateTimeDate created, Should be in the format  ISO 8601 format, YYYYMMDDhhmmdd
SerialNumberShould follow an uninterrupted number series, 1, 2, 3 and so on.


Maximum size limit100 MB
Maximum number of invoices50.000 invoice 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 and not with a leading zero for CustomerNo in Sweden, in order to use AutoGiro (Direct Debit).
  • The use of EDIInfo will result in distribution by E-Invoice B2B if no other preferred distribution method is set in eDistributionType, see Standard Invoice distribution order of priority.
  • Dependency to LegalEntity in CustomerInfo element:
    • Late fee will be added instead of reminder fee or collection claim fee when LegalEntity is set to "Business" (if specially contracted with PayEx and configured in ledger)
    • SSN (RegNo) for private individuals will not be displayed in ledger reports due to GDPR. RegNO will only be displayed when LegalEntity is set till "Business"
    • If distributed by e-mail: When LegalEntity is set to "Private" the e-mail message will include a link to PayEx Invoice Portal where the invoice/claim is available, otherwise a copy of the invoice/claim will be attached in the e-mail message as a pdf-file.
    • Finland only: Different claim processes will be used depending on "Private" or "Business"

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.92023-04-18Added element 'CashDiscountInfo' for specifying cash discount on invoices, only supported for invoices without distribution

Change Log

Version 2.9

April 18, 2023


Added element 'CashDiscountInfo' for specifying cash discount on invoices, only supported for invoices without distribution

Version 2.8

March 29, 2023


Added element 'RecurringCardInfo' to support recurring card payments (agreement for card payments must be set before use)

Version 2.7

February, 2023


Added VatRate 24 and 10

Version 2.6

October, 2022


Allows a wider range of chars for Name, Addressee, StreetAddress, COAddress and City.

Supports StreetAddress and COAddress with up to 72 chars in length.

Version 2.5

September, 2022


Added support for setting customer LegalStatus

Version 2.4

April, 2022


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


 Initial version (latest documented version)

Download sample file


Created by Fredrik Nilsson on 2021/06/29 16:52