Send & Receive E-Documents

General Information

All outgoing e-documents need to be formatted as a Valid Peppol XML file before transacting with the Billbay Access Point. Incorrectly formatted files will not be transmitted across to your counterparty. If you have deployed the Billbay Peppol Adaptor (BBPA), then BBPA will ensure that only valid XMLs are reaching the Access Point.

You may ascertain the correctness of your xml file via the xml validation utility at:

https://singapore.validex.net/en/login

The latest version of the xml files and schematron with examples can be found at the IMDA maintained web page at:

https://www.peppolguide.sg/

From 1-Apr-2025, only the PINT SG Billing Specifications will be supported by the network. If you are beginning a fresh development effort, we recommend that you start looking at the PINT SG Billing Specifications for Invoice and Credit Note.

Apart from Invoice and Credit Note, there are also 2 additional E-Documents that you may find useful and include as part of your development efforts:

• Invoice Response: Is an e-document that is sent by the receiver of an invoice informing the sender the status of the invoice (Acknowledged, In Process, Approved, Paid or Rejected with Reason).
• Order: When received an Order is an E-PO. When a buyer issues an E-PO, information from the Order can then be converted to an Invoice requiring no additional input and possibility of errors / deviations from PO. This helps to improve accuracy and eliminates errors arising out of data entry during invoice preparation.

Sending E-Invoices (or E-Docs):

All e-docs transmitted via the Billbay Access point will receive a Receipt (RCPT) file. This is also an xml file. You will need to open the xml file to read the receipt response. You can correlate the response to the outgoing based on the unique message identifier. The unique message identifier will be generated by you.

1. Use POST Send API
2. Wait for a while (eg. 2-5 mins)
3. Check for RCPT response file in Recv Folder using GET List (or) Check Status (GET Status).

Step 3 lets you know if your file has been received by the counterparty AP. The successfully uploaded response from 1 only means it has reached our Access Point (which will then be sent out via the Peppol Network).

Receiving E-Invoices (or E-Docs)

Incoming files are of 2 types:

• All files start with DLVY represent incoming payloads sent to you by counterparties.
• All files starting with RCPT is a receipt / response to any outgoing message you have sent (ie. Step 3 in Process Flow for Sending).

1. First you need to list the files in the recv folder using GET List API
2. Download the individual file by specifying the exact file name via GET Recv
3. After you have downloaded the .xml for processing, you may choose to delete the specific file (GET Delete) or delete all the files in the directory (GET Flush)

The full API Documentation can be found at the following: https://documenter.getpostman.com/view/20222049/2s9Y5ZtgLp

Ongoing File Maintenance:

File Maintenance activities on both incoming and outgoing queues will be under your responsibility. It is always advisable to keep your incoming and outgoing folders lean and clean.

Questions:

Please email us at invoicenow@billbay.co or bb.support@billbay.co