Home / Documentation / TallyPrime TDL Guide
Official User & Integration Guide

TallyPrime InvoiceNow (Peppol) TDL Manual

Complete step-by-step instructions to install, configure, and operate the certified techneek_invoicenow_v2.tdl module in TallyPrime for 1-click Singapore InvoiceNow e-invoicing.

Client Portal Access ↗ Full User Manual ↗ Technical Support
Jump to: 1. Install TDL 2. InvoiceNow Settings 3. Customer UEN 4. Outbound Dispatch 5. Inbound Mailbox 6. Pending Queue 7. Shortcuts 8. FAQ & Errors

How It Works: Connecting TallyPrime to Singapore Peppol via Billbay

The certified TDL acts as an integrated client bridge inside TallyPrime. When you dispatch a voucher, your company's data is verified, formatted into Singapore PINT-SG UBL 2.1 XML, and handed over securely to your Billbay Access Point via authorized API credentials.

1. TallyPrime Voucher
Sales, Credit & Debit Notes with SG GST.
2. InvoiceNow Gateway
PINT-SG validation, UBL XML generation & PayNow QR.
3. Billbay Access Point
Singapore Peppol AS4 delivery via IMDA-accredited Access Point partner.
4. Buyer's ERP / IRAS
Automatic receipt & non-repudiation tracking.
1

Install & Load TDL in TallyPrime

The module is packaged as a certified techneek_invoicenow_v2.tdl file that loads directly into TallyPrime without altering your core accounting data.

Step-by-Step Instructions:

  1. Download the compiled module: Authenticated clients can download techneek_invoicenow_v2.tdl from their Client Portal under Tally Setup & Workbench.
  2. Save the file into your Tally installation folder (e.g. C:Program FilesTallyPrime).
  3. Launch TallyPrime and press F1: Help in the top bar.
  4. Click TDLs & Add-ons (or press Ctrl + Alt + T).
  5. Press F4: Manage Local TDLs.
  6. Under Load TDL files on startup, select Yes.
  7. In the List of TDL Files to Preload on Startup, enter techneek_invoicenow_v2.tdl.
  8. Press Ctrl + A to accept and save.
Verification: The TDL status bar at the bottom right of Tally will display "1 of 1 TDL loaded successfully". The InvoiceNow menu will now appear on your Gateway of Tally.
2

Configure InvoiceNow Settings (Company UEN, GST & Address)

Bind your company's Singapore ACRA UEN to the InvoiceNow connector. This ensures all dispatched invoices carry your official IMDA Peppol participant identifier.

  1. From the Gateway of Tally open InvoiceNow → InvoiceNow Settings (S).
  2. Fill the company profile:
    • Company Singapore UEN: your 9–10 character ACRA UEN (e.g. 201829401C)
    • Portal Key / Passcode: the company key from the Client/Admin Portal (required)
    • GST Rate %: 9 (GST-registered) or 0
    • Registered Address / City / Postal Code: your registered business address (mandatory on every e-invoice)
    • GST Registration No: mandatory when GST is charged
    • Billing Contact Name / Phone / Email: shown on your PINT-SG invoices
    • Tax Category: SR/ZR/ES/OOS  ·  Auto-Send on Save: Yes/No
  3. Press Esc or Ctrl + A to save, then Alt + T to Test Connection (expect ONLINE).
Multi-Company Isolation: If you run multiple entities in TallyPrime, each company maintains its own isolated UEN and Billbay credentials. Switching active companies in Tally automatically switches the Peppol identity.
3

Tag Customer Ledgers with Singapore UENs

For an invoice to route across the Peppol network, your buyer/debtor must have their Singapore UEN saved in their ledger master.

  1. Go to Gateway of Tally → Alter → Ledger.
  2. Select the Customer (Sundry Debtor) account.
  3. In the Mailing Details section, locate the new field added by the TDL:
    Singapore UEN (Peppol ID): 199201624D
  4. Enter the customer's 9-10 character Singapore UEN (e.g. 199201624D for Singtel, or the buyer's ACRA UEN).
  5. Also fill the buyer's Street, City and Postal Code (and optional Buyer GST Reg No) — these are mandatory for PINT-SG and the invoice will not transmit without them.
  6. Press Ctrl + A to save.
Tip for Test Dispatches: If you are testing before going live, you can enter SGTSTBILLBAY02 as the customer UEN to route to the Billbay Test Sandbox.
4

1-Click Outbound Dispatch (Sales, Credit & Debit Notes)

You can dispatch tax invoices, credit notes, and debit notes directly from the voucher entry screen with instant validation.

Sales Invoice (F8)
Standard commercial e-invoice with 9% GST and SGQR PayNow payload. Transmitted as Peppol type 380.
Credit Note (Alt + F6)
Reduces or cancels a previously issued invoice. Transmitted to the buyer as Peppol type 381.
Debit Note (Alt + F5)
Upward adjustments or supplementary charges. Transmitted to the buyer as Peppol type 383.

How to Dispatch:

  1. Create or open the voucher normally. Ensure items and standard Singapore GST (9%) are applied.
  2. Automatic (recommended): with Auto-Send on Save = Yes just press Ctrl + A to save — it transmits and records automatically.
  3. Manual: press Alt + I on the voucher, then save. Bulk: Pending workbench → Alt + S.
  4. A confirmation modal appears. After confirming, the Access Point accepts the document (status SUBMITTED) and returns its reference, e.g. bb-8bdd…. Delivery is confirmed later as DELIVERED when the network returns a signed AS4 receipt.
Live Tally Voucher Footer Status:
[ InvoiceNow | Peppol SG ] Status : SUBMITTED (Ref: bb-8bdd…)
5

Inbound Vendor Invoices (Peppol Mailbox)

When vendors (suppliers) issue electronic tax invoices to your company, they are routed through the Peppol network into your Billbay mailbox.

  1. From the Gateway of Tally, navigate to:
    Gateway of Tally → InvoiceNow → Inbound Vendor Invoices (I)
  2. Pull (Alt + R) — fetches the latest received e-invoices from your Billbay mailbox.
  3. Import to Tally (Alt + G) — creates a Purchase voucher for each invoice (supplier ledger under Sundry Creditors, Purchase + Input GST) and marks it IMPORTED. Already-imported documents are skipped automatically (no duplicates).
  4. The workbench lists each invoice with Date, Doc No, Party Name, Party UEN, Amount (SGD), Peppol Ref and Status (PENDING_IMPORT or IMPORTED).
6

Pending Invoices Queue & Batch Dispatch

The Pending list is portal-driven: it shows every local sales-type voucher whose number is not yet in the Portal's “sent” list. So once an invoice is transmitted — by any method, even without saving — it drops off the list.

  1. Go to Gateway of Tally → InvoiceNow → Pending Invoices to Send (P) (or press Alt + P from any voucher).
  2. The workbench lists all un-transmitted Sales / Credit Note / Debit Note vouchers.
  3. Press Alt + S (Send All Pending) and confirm to transmit every listed invoice in sequence.
  4. Reopen the workbench after sending — dispatched invoices no longer appear.
7

Tally Keyboard Shortcuts Cheat Sheet

Shortcut Key Action / Command Where to Use
Alt + I or Alt + S Send to InvoiceNow Sales, Credit Note, or Debit Note voucher screen
Alt + U Check Peppol Status Any active voucher screen to inspect live delivery status
Alt + P Open Pending Invoices Workbench Any voucher screen or Gateway menu
Alt + T Test Gateway Ping Connection Inside Inbound or Outbound workbenches
F4 Manage Local TDLs Inside F1: Help → TDLs & Add-ons
Alt + R Pull Inbound from Billbay Inbound Vendor Invoices workbench
Alt + G Import Inbound to Tally Inbound Vendor Invoices workbench
S InvoiceNow Settings (UEN, GST, Address, Portal Key) Gateway of Tally → InvoiceNow
8

Troubleshooting & Frequently Asked Questions

Q: Tally says "Strict Validation Failed: Buyer UEN is invalid". How do I fix this?

This error occurs if the customer's ledger in Tally does not have an ACRA-registered Singapore UEN. Go to Gateway of Tally → Alter → Ledger, select the customer, and ensure the Singapore UEN (Peppol ID) field contains a valid 9 or 10-character UEN (e.g. 199201624D).

Q: What does "Invoice was already dispatched (IDEMPOTENT)" mean?

Our gateway enforces strict non-repudiation and idempotency. If an invoice was already successfully delivered to the Peppol network, pressing Alt+I again will not create a duplicate transaction or duplicate fee. It will return the existing delivery reference.

Q: Where can I view the raw Peppol BIS 3.0 UBL 2.1 XML file?

Log in to your Client Portal, go to Outbound Dispatches, and click Inspect Dossier & XML. You can inspect, copy, or download the full raw XML file.