01. Cusin

XSD overview

Invoice service (with distribution)

Ledger service (without distribution)

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 invoices	50.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