InvoiceNow
InvoiceNow for TallyPrime — User Manual
Techneek Global · Singapore Peppol / PINT-SG · Billbay Access Point
← Portal Home Print / PDF

User Manual

Version 2.0 · Applies to the Techneek InvoiceNow V2 Tally TDL and the Cloud Portal. This manual covers installation, daily use, statuses, inbound, and administration.

What this system does. It connects TallyPrime to the Singapore Peppol (InvoiceNow) network through the Billbay Access Point. When you save a sales invoice in Tally, it can be transmitted automatically; received supplier e-invoices can be pulled and posted into Tally.

Contents

1. Overview & architecture

TallyPrime (TDL)  ⇄  Techneek Cloud Bridge (middleware)  ⇄  Billbay Access Point  ⇄  Peppol (InvoiceNow)

The Bridge is the system of record for what was transmitted; Tally remains the system of record for your books.

2. Prerequisites & onboarding

  1. Billbay onboarding (per company). Register the legal entity with Billbay and obtain:
    • API Key + Tenant ID
    • Sender Peppol ID (e.g. 0195:SGUEN<UEN>)
    • Access Point base URL (provided by Billbay for your tenant)
  2. Company registration in the Portal. The company must be registered and ACTIVE in the Techneek Portal (Admin Console), with its Billbay credentials and a Portal Key/Passcode set.
  3. TallyPrime installed; the company opened in Tally.
  4. Singapore details ready: Company UEN, registered address, GST registration number (if GST-registered), and each customer's UEN + address.
Per-client keys. Each client uses their own Billbay API key/tenant. Do not share a test key in production.

3. Installing the TDL in TallyPrime

  1. Copy techneek_invoicenow_v2.tdl into your TallyPrime folder (or download from the Portal).
  2. In TallyPrime: F1 (Help) → TDLs & Add-ons (or Ctrl+Alt+T).
  3. F4 (Manage Local TDLs) → set Load selected TDL files on startup = Yes → select the file → Enter.
  4. Restart TallyPrime. A new InvoiceNow item appears in the Gateway of Tally.

After any future update, reload the TDL the same way (F4).

4. Company setup (Settings)

Gateway of Tally → InvoiceNow → InvoiceNow Settings (S). Fill and save.

FieldWhat to enter
Company Singapore UENYour registered 9–10 char UEN (drives your Peppol ID 0195:SGUEN…).
Relay Endpoint URLLeave default (Techneek Cloud Bridge) unless instructed.
Portal Key / PasscodeThe company's key from the Portal (Admin → API tab). Required to authenticate transmissions.
Access Point PartnerBillbay (IMDA) — informational.
GST Rate %9 for GST-registered; 0 for non-GST.
Input GST Ledger (inbound)Your Tally input-GST ledger name (default Input GST) used when importing inbound bills.
Registered Address / City / PostalYour registered business address (mandatory on every e-invoice).
GST Registration NoYour GST registration number (mandatory when GST is charged).
Billing Contact Name / Phone / EmailContact shown on your PINT-SG invoices.
Tax CategorySR (standard 9%), ZR (zero-rated/export), ES (exempt), OOS (out of scope).
Send Invoice Line ItemsYes to send per-line detail (goods), No for a single compliant line.
Auto-Send on SaveYes (recommended): saving a sales invoice transmits it automatically. No: send manually with Alt+I.
Diagnostic ModeNo normally. Yes shows a diagnostic popup on save (for support).
Test Connection (Alt+T). Expect ONLINE. Common replies: DISCONNECTED (Billbay key/tenant missing), NOT_REGISTERED (company not registered in Portal), UNAUTHORIZED (wrong Portal Key).

5. Customer ledger setup

For each customer: Gateway of Tally → Alter → Ledger → open the party → Mailing Details:

FieldRequired
Singapore UEN (Peppol ID)Yes — buyer's UEN (routing).
Buyer Street (InvoiceNow)Yes — mandatory for PINT-SG.
Buyer CityYes (defaults to Singapore).
Buyer Postal CodeYes — mandatory.
Buyer GST Reg NoOptional — buyer's GST number if provided.
Invoices cannot be transmitted without the buyer's UEN and address — the system will block them with a clear reminder.

6. Sending invoices

Automatic (recommended)

With Auto-Send on Save = Yes: enter the sales invoice and press Ctrl+A. It is transmitted immediately; a popup confirms the reference. No extra step.

Manual (single)

On a sales / credit / debit voucher press Alt+I ("Send to InvoiceNow"). Then save the voucher to record the status.

Bulk

InvoiceNow → Pending Invoices to Send (P) → press Alt+S ("Send All Pending") → confirm. Each pending invoice is dispatched.

Supported types: Sales, GST Sales, Tax Invoice, Sales Invoice, Invoice, Credit Note (381), Debit Note (383).

7. Pending invoices (unsent)

Portal-driven. The Pending list shows every local sales-type voucher whose number is not in the Portal's "sent" list. So once an invoice is transmitted — by any method, even without saving — it disappears from Pending the next time you open the workbench.

Verification. "Sent vs not sent" is verified against the Portal (the Access Point record), not a local flag — so it is reliable regardless of saving.

8. Outbound (sent) workbench

InvoiceNow → Outbound Sent Invoices (O) lists what has been transmitted, with date, invoice no, buyer, UEN, amount, Peppol reference and status. Alt+T tests the connection.

9. Inbound (receive & import)

  1. Gateway of Tally → InvoiceNow → Inbound Vendor Invoices (I).
  2. Alt+R — pull the latest received e-invoices from Billbay.
  3. Alt+G — Import to Tally. Each row creates a Purchase voucher (supplier ledger under Sundry Creditors, Purchase + Input GST) and is marked IMPORTED.

Auto-reconcile: already-imported documents are flagged and skipped on future runs, so re-pulling never duplicates vouchers. Only new/pending items are imported.

Test inbound import on a copy company first — it creates supplier ledgers and Purchase vouchers.

10. Status meanings

StatusMeaning
SUBMITTEDAccepted by the Access Point; awaiting delivery confirmation from the network.
DELIVEREDConfirmed delivered — a signed AS4 receipt (RCPT-200) was returned by the network.
FAILEDRejected (e.g. validation) or delivery failed; the reason is shown from the receipt (RCPT-500).
PENDING_IMPORTAn inbound invoice received but not yet posted into Tally.
IMPORTEDInbound invoice posted into Tally as a Purchase voucher.

Status transitions to DELIVERED/FAILED automatically from the Access Point's delivery receipts.

11. Admin & client portal

Recommended: enable MFA on the admin account and give each administrator their own user.

12. Troubleshooting

SymptomCause / fix
"Missing Company UEN / Portal Key"Fill them in InvoiceNow Settings.
"Missing Buyer UEN / Address"Fill the customer's ledger Mailing Details.
"DISCONNECTED" on Test ConnectionBillbay key/tenant not set in the Portal for this company.
"UNAUTHORIZED"Portal Key in Tally doesn't match the Portal.
Stuck on SUBMITTEDNo delivery receipt yet; the network hasn't confirmed delivery.
Invoice stays in Pending after sendingReopen Pending (Alt+P) so it re-reads the Portal sent-list.
Receive 403/401 on dispatchCredentials mismatch — check Portal Key; contact admin.

Support: support@techneekglobal.com · WhatsApp +65 8922 7725

13. Compliance & data

Compliance documents: Data Processing Agreement · Privacy/PDPA Notice · Data Retention Policy.

14. Glossary

UENUnique Entity Number (Singapore business identifier).
Peppol IDNetwork address of a participant, e.g. 0195:SGUEN<UEN>.
Access Point (AP)Certified gateway (Billbay) that transmits documents on the Peppol network.
PINT-SGPeppol International Invoice for Singapore.
SBDH / AS4Envelope and transport used by Peppol (AS4 receipts confirm delivery).
SR/ZR/ES/OOSGST tax categories: Standard-rated / Zero-rated / Exempt / Out-of-scope.