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)

Cusin_[2.0].xsd-withdistribution.svg

Ledger service (without distribution)

Cusin_[2.0].xsd-withoutdistribution.svg

Encoding

The file must use UTF-8 encoding

Name convention

CUSIN_<CompanyNumber>_<DateTime>_<SerialNumber>.xml

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.

Limitations

LimitationsDescription
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.
  • DistributionDate on the credit invoice must have been passed when using CreditInstructions, in order to execute the settlement against a debit invoice.
  • 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

FileversionVersionReleasedateComment
Cusin[2.X].xsd2.912024-09-03Added VatRate enum item 25.50

Change Log

Version 2.91

September 03, 2024

Cusin[2.X].xsd

Added VatRate enum item 25.50

Version 2.9

April 18, 2023

Cusin[2.9].xsd

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

Version 2.8

March 29, 2023

Cusin[2.8].xsd

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

Version 2.7

February, 2023

Cusin[2.7].xsd

Added VatRate 24 and 10

Version 2.6

October, 2022

Cusin[2.6].xsd

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

Cusin[2.5].xsd

Added support for setting customer LegalStatus

Version 2.4

April, 2022

Cusin[2.4].xsd

eCurrencyType, added new values USD,GBP

Version 2.3

November, 2020

Cusin[2.3].xsd

DistributionAddressInfo, added new field ProtectedIdentity

Version 2.2

October, 2020

Cusin[2.2].xsd

EdiInfo.EDIOrderRows.Quantity decimal support, 

EDIInfo.ExternalreferenceURL, added new field

Added support for more characters in EdiInfo.EDIOrderRow.ContractType

Version 2.1

June, 2020

Cusin[2.1].xsd

Order rows under SubOrderBlocks, no longer mandatory

Version 2.1

February, 2020

Cusin[2.01].xsd

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)

Download sample file

CUSIN_367_20190911090045_93

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