Billbay Access Point: General Information for Send & Receive

The Access Point has the following folder structure:

send: place any peppol e-documents for outbound transmission into this folder.
recv: retrieve incoming peppol e-documents or receipts from this folder.
done: after a file is picked for e-delivery, it is moved from 'send' to 'done' folder.
logs: contains records of critical transmission errors; typically empty if no errors are present.

General Information

1. All outgoing e-documents need to be formatted as a Valid XML file before transacting with the Billbay Access Point. Incorrectly formatted files will not be transmitted.
2. You may ascertain the correctness of your xml file via the xml validation utility at: https://singapore.validex.net/en/login
3. 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/

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 starting 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 / Folder 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.

Send & Receive Testing:

You will need.a pair of APi Keys (SFTP Credentials) to simulate a proper send & receive testing.

You may use your Production Account / API Key as one of the parties

You may use one of our Sandbox Accounts / API Key as the counterparty

Questions:

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