The CustomerBilling file is used by the Lessor to bill/invoice the Consumer/Lessee in advance. Based on the information in the file and earlier invoiced unpaid debt, PayEx produces a Lessor branded invoice, reminder 1, reminder 2 or CollectionClaim owned by PayEx.
Filename format convention
CustomerBilling_<OwnerCode>_<YYYYMMDDHHMMSS>_<SeqNo>.xml
| Name components | Description |
|---|---|
| OwnerCode | The identifier of the bank/financier |
| DateTime | The date and time that the file was created. Uses ISO 8601 format, YYYYMMDDhhmmss |
| SeqNo | Should follow an uninterrupted number series, 1, 2, 3 and so on. |
E.g. CustomerBilling_123_20220302080850_12598.xml
Download current XML schema file
| Fileversion | Version | Releasedate | Comment |
|---|---|---|---|
| 2.0 | |||
| 2.1 | 2022-10-18 | Updated version format and length of CoAddress and StreetAddress. Extended PXNameAddressString to include diacritics. | |
| 2.2 | 2024-09-03 | Support for BillInfo with OffContract amounts. |
Example XML
<CustomerBilling Version="2.0" CreatedDateTime="1900-01-01T01:01:01+01:00" CompanyNo="123" CompanyName="CompanyName">
<CustomerInfos>
<CustomerInfo>
<CustomerNo>CustomerNo1</CustomerNo>
<RegNo CountryCode="SE">RegNo1</RegNo>
<AddressInfo>
<Address AddressType="BillingAddress">
<Addressee>Addressee1</Addressee>
<StreetAddress>StreetAddress1</StreetAddress>
<ZipCode>12323</ZipCode>
<City>City1</City>
<CoAddress>CoAddress1</CoAddress>
<CountryCode>SE</CountryCode>
</Address>
<E-MailAddress>E-MailAddress1@mail.com</E-MailAddress>
<Cellphone>Cellphone1</Cellphone>
</AddressInfo>
<PaymentInfo>
<Clear/>
</PaymentInfo>
<BillInfo>
<ReferenceInfo>
<ExternalBillId>ExternalBillId1</ExternalBillId>
</ReferenceInfo>
<ContractAmounts>
<ContractAmount>
<ContractId>0</ContractId>
<Amount Currency="SEK">
<AmountInclVat>49.99</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>4294967295</ContractId>
<Amount Currency="NOK">
<AmountInclVat>100.00</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>1</ContractId>
<Amount Currency="DKK">
<AmountInclVat>79.99</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
</ContractAmounts>
</BillInfo>
</CustomerInfo>
<CustomerInfo>
<CustomerNo>CustomerNo2</CustomerNo>
<RegNo CountryCode="SE">RegNo2</RegNo>
<AddressInfo>
<Address AddressType="BillingAddress">
<Addressee>Addressee2</Addressee>
<StreetAddress>StreetAddress2</StreetAddress>
<ZipCode>12332</ZipCode>
<City>City2</City>
<CoAddress>CoAddress2</CoAddress>
<CountryCode>SE</CountryCode>
</Address>
<E-MailAddress>EMailAddress2@mail.com</E-MailAddress>
<Cellphone>Cellphone2</Cellphone>
</AddressInfo>
<PaymentInfo>
<Set>
<RecurringCardInfo>
<CardReference>CardReference2</CardReference>
<ExpiryDate>12/21</ExpiryDate>
</RecurringCardInfo>
</Set>
</PaymentInfo>
<BillInfo>
<ReferenceInfo>
<ExternalBillId>ExternalBillId2</ExternalBillId>
</ReferenceInfo>
<ContractAmounts>
<ContractAmount>
<ContractId>4294967294</ContractId>
<Amount Currency="EUR">
<AmountInclVat>39.90</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>2</ContractId>
<Amount Currency="SEK">
<AmountInclVat>99.80</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>4294967293</ContractId>
<Amount Currency="NOK">
<AmountInclVat>69.80</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
</ContractAmounts>
<OffContractAmounts>
<OffContractAmount>
<Amount Currency="SEK">
<AmountInclVat>49.99</AmountInclVat>
</Amount>
<ProductDescription>Description</ProductDescription>
<BillingPeriod>2024-01-01--2021-04-31</BillingPeriod>
<TransactionId>1</TransactionId>
</OffContractAmount>
</OffContractAmounts>
</BillInfo>
</CustomerInfo>
</CustomerInfos>
</CustomerBilling>
<CustomerInfos>
<CustomerInfo>
<CustomerNo>CustomerNo1</CustomerNo>
<RegNo CountryCode="SE">RegNo1</RegNo>
<AddressInfo>
<Address AddressType="BillingAddress">
<Addressee>Addressee1</Addressee>
<StreetAddress>StreetAddress1</StreetAddress>
<ZipCode>12323</ZipCode>
<City>City1</City>
<CoAddress>CoAddress1</CoAddress>
<CountryCode>SE</CountryCode>
</Address>
<E-MailAddress>E-MailAddress1@mail.com</E-MailAddress>
<Cellphone>Cellphone1</Cellphone>
</AddressInfo>
<PaymentInfo>
<Clear/>
</PaymentInfo>
<BillInfo>
<ReferenceInfo>
<ExternalBillId>ExternalBillId1</ExternalBillId>
</ReferenceInfo>
<ContractAmounts>
<ContractAmount>
<ContractId>0</ContractId>
<Amount Currency="SEK">
<AmountInclVat>49.99</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>4294967295</ContractId>
<Amount Currency="NOK">
<AmountInclVat>100.00</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>1</ContractId>
<Amount Currency="DKK">
<AmountInclVat>79.99</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
</ContractAmounts>
</BillInfo>
</CustomerInfo>
<CustomerInfo>
<CustomerNo>CustomerNo2</CustomerNo>
<RegNo CountryCode="SE">RegNo2</RegNo>
<AddressInfo>
<Address AddressType="BillingAddress">
<Addressee>Addressee2</Addressee>
<StreetAddress>StreetAddress2</StreetAddress>
<ZipCode>12332</ZipCode>
<City>City2</City>
<CoAddress>CoAddress2</CoAddress>
<CountryCode>SE</CountryCode>
</Address>
<E-MailAddress>EMailAddress2@mail.com</E-MailAddress>
<Cellphone>Cellphone2</Cellphone>
</AddressInfo>
<PaymentInfo>
<Set>
<RecurringCardInfo>
<CardReference>CardReference2</CardReference>
<ExpiryDate>12/21</ExpiryDate>
</RecurringCardInfo>
</Set>
</PaymentInfo>
<BillInfo>
<ReferenceInfo>
<ExternalBillId>ExternalBillId2</ExternalBillId>
</ReferenceInfo>
<ContractAmounts>
<ContractAmount>
<ContractId>4294967294</ContractId>
<Amount Currency="EUR">
<AmountInclVat>39.90</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>2</ContractId>
<Amount Currency="SEK">
<AmountInclVat>99.80</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
<ContractAmount>
<ContractId>4294967293</ContractId>
<Amount Currency="NOK">
<AmountInclVat>69.80</AmountInclVat>
</Amount>
<BillingPeriod>2021-01-01--2021-01-31</BillingPeriod>
</ContractAmount>
</ContractAmounts>
<OffContractAmounts>
<OffContractAmount>
<Amount Currency="SEK">
<AmountInclVat>49.99</AmountInclVat>
</Amount>
<ProductDescription>Description</ProductDescription>
<BillingPeriod>2024-01-01--2021-04-31</BillingPeriod>
<TransactionId>1</TransactionId>
</OffContractAmount>
</OffContractAmounts>
</BillInfo>
</CustomerInfo>
</CustomerInfos>
</CustomerBilling>