04. BillJournal

This is a technical overview of one of the response files (Bill Journal) you retrieve from PayEx.

Please note that your Response files might only utilize and/or contain a subset of all elements described below. See the XSD version for your response files to learn more.


The Bill Journal displays changes in invoice status that relates to contracted services.

Entries in the Bill Journal could stem from events such as:

  • An invoice has been closed or backordered in accounts receivable (including invoice substatus if applicable)
  • A reminder, interest claim or debt claim has been sent
  • An invoice has been transfered to debt collection
  • An invoice claim has been received
  • An invoice claim has been registered as settled
  • A respite has been registered
  • A respite has been removed
  • A notification has been created
  • A failed direct debit has occurred

The file can contain up to 300,000 events, if there are more events to be exported via BillJournal, it will be split into several files

Below diagram shows the structure of BillJournal in current version


Name Convention


Name componentsDescription
CompanyNumberThe company number in our ledger system
DateTimeThe date and time that the file was created. Uses ISO 8601 format, YYYYMMDDhhmmdd
SerialNumberShould follow an uninterrupted number series, 1, 2, 3  and so on.

Example filename: BILLJOURNAL_9999_20080923124422_1.xml

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

Download XML schema file

BillJournal[1.X].xsd1.32022-04-26Added support for new eCurrencyTypes USD and GBP
BillJournal[1.2].xsd1.22020-03-10Added PaymentOrderEvents

Added InvoiceNotificationEvents
Added optional InvoiceSubStatus


Change Log

Version 1.3

April, 2022


Added support for new eCurrencyTypes USD and GBP

Version 1.2

Mars, 2020


Added PaymentOrderEvents

Version 1.1

Oktober, 2019


Added information notifications before and after due date and before reminder date.

Added optional InvoiceSubStatus under InvoiceStatusEvent

Version 1.0

September, 2016


 Initial version (latest documented version)

Download sample file


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