Skip to content

Commit 72a6dc9

Browse files
feat: Add SG InvoiceNow and update E-Invoice (#31)
* feat: Add SG InvoiceNow GST Operation guide * feat: Update SG InvoiceNow GST guide * feat: Update E-Invoice submission type * feat: Update E-Invoice Request * feat: Add Info Request --------- Co-authored-by: ang <achilles0904@gmail.com>
1 parent a6a7404 commit 72a6dc9

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

63 files changed

+291
-71
lines changed
Lines changed: 159 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,159 @@
1+
---
2+
sidebar_position: 3
3+
title: InvoiceNow GST Operation
4+
description: A guide for E-Invoicing Operation for Singapore SQL User
5+
slug: /singapore/c5
6+
tags: ["SQL Account", "Singapore", "InvoiceNow", "Activation"]
7+
---
8+
9+
## Activation of InvoiceNow GST Submission
10+
11+
To activate InvoiceNow GST submission for GST-registered Businesses, navigate to **File** > **Company Profile** > **Peppol** and perform the actions below:
12+
13+
![c5](../../static/img/singapore-gst/c5/c5.png)
14+
15+
### Activate
16+
17+
To initiate InvoiceNow GST activation for specified participants and organizations. Activation requires signing with Corppass.
18+
19+
1. Click on **InvoiceNow GST** > **Activate**
20+
21+
![c5_activate](../../static/img/singapore-gst/c5/c5_activate.png)
22+
23+
### Get Status
24+
25+
To check the InvoiceNow GST activation status for a specific participant and organization.
26+
27+
1. Click on **InvoiceNow GST** > **Get status**
28+
29+
![c5_status](../../static/img/singapore-gst/c5/c5_status.png)
30+
31+
### Cancel Activation
32+
33+
To cancel an initiated InvoiceNow GST activation, a KYC pending InvoiceNow GST activation or a InvoiceNow GST deactivation.
34+
35+
1. Click on **InvoiceNow GST** > **Cancel Activation**
36+
37+
![c5_cancel](../../static/img/singapore-gst/c5/c5_cancel.png)
38+
39+
### Deactivate
40+
41+
To deactivate an existing InvoiceNow GST activation. Deactivation requires signing with Corppass.
42+
43+
1. Click on **InvoiceNow GST** > **Deactivate**
44+
45+
![c5_deactivate](../../static/img/singapore-gst/c5/c5_deactivate.png)
46+
47+
## Extraction and Packaging of Invoice Data
48+
49+
### Type 1A (Peppol)
50+
51+
This type will submits documents to the Peppol network and automatically forwards them to IRAS. You may use this type when the customer is on Peppol.
52+
53+
:::info[NOTE]
54+
55+
- Supported format: PINT (Default), BIS
56+
- Supported document types: Sales Invoice, Credit Notes
57+
58+
:::
59+
60+
1. Click on **Peppol** > **Peppol (PINT)** or **Peppol (BIS)**
61+
62+
![A](../../static/img/singapore-gst/c5/A.png)
63+
64+
### Type 2A (Non Peppol)
65+
66+
This type will submits documents directly to IRAS.
67+
68+
:::info[NOTE]
69+
70+
- Supported format: PINT
71+
- Supported document types: Sales Invoice, Credit Notes
72+
73+
:::
74+
75+
1. Click on **Peppol** > **IRAS**
76+
77+
![B](../../static/img/singapore-gst/c5/B.png)
78+
79+
### Type 2B (POS or STI)
80+
81+
This type will groups items by tax code and submits documents to IRAS. You may use this type for cash register sales or sales made via point-of-sale systems (POS) or simplified tax invoices issued (STI).
82+
83+
:::info[NOTE]
84+
85+
- Supported format: PINT
86+
- Supported document types: Cash Sales
87+
88+
:::
89+
90+
1. Click on **Peppol** > **IRAS**
91+
92+
![C](../../static/img/singapore-gst/c5/C.png)
93+
94+
### Type 1B (Peppol Received)
95+
96+
This type will submits received documents via the Peppol network and forwards them to IRAS. You may use this type for documents imported using Peppol.
97+
98+
:::info[NOTE]
99+
100+
- Supported format: PINT (Default), BIS
101+
- Supported document types: Purchase Invoice, Purchase Returned
102+
103+
:::
104+
105+
1. Click on **Peppol** > **Peppol (PINT)** or **Peppol (BIS)**
106+
107+
![D](../../static/img/singapore-gst/c5/D.png)
108+
109+
### Type 3A (Non Peppol Received)
110+
111+
This type will submits received documents directly to IRAS.
112+
113+
:::info[NOTE]
114+
115+
- Supported format: PINT
116+
- Supported document types: Purchase Invoice, Purchase Returned
117+
118+
:::
119+
120+
1. Click on **Peppol** > **IRAS**
121+
122+
![E](../../static/img/singapore-gst/c5/E.png)
123+
124+
### Type 3B (PCP)
125+
126+
This type will groups items by tax code and submits documents to IRAS. You may use this type for petty cash purchases (PCP).
127+
128+
:::info[NOTE]
129+
130+
- Supported format: PINT
131+
- Supported document types: Cash Purchase
132+
133+
:::
134+
135+
1. Click on **Peppol** > **IRAS**
136+
137+
![F](../../static/img/singapore-gst/c5/F.png)
138+
139+
## Reporting & Reconciliation
140+
141+
### Log
142+
143+
To check the Peppol log of a document.
144+
145+
:::info[NOTE]
146+
The Remark column stores the IRAS Acknowledgement ID
147+
:::
148+
149+
![log](../../static/img/singapore-gst/c5/log.png)
150+
151+
### Reconciliation
152+
153+
To compare document submissions in SQL Account and the Peppol network.
154+
155+
:::info[NOTE]
156+
The record highlighted in red color indicate missing document submissions in SQL Account
157+
:::
158+
159+
![recon](../../static/img/singapore-gst/c5/recon.png)

docs/singapore/e-invoice.md

Lines changed: 23 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
2-
title: InvoiceNow
2+
sidebar_position: 2
3+
title: InvoiceNow GST
34
description: A guide for E-Invoicing for Singapore SQL User
45
slug: /singapore/invoicenow
56
tags: ["SQL Account", "Singapore", "InvoiceNow"]
@@ -27,8 +28,8 @@ tags: ["SQL Account", "Singapore", "InvoiceNow"]
2728

2829
![3](../../static/img/singapore-gst/sg-e-invoice/3.png)
2930

30-
:::info Note
31-
**Please note that obtaining the API Key and API Secret will incur additional charges**
31+
:::info[NOTE]
32+
Please note that obtaining the API Key and API Secret will incur additional charges
3233
:::
3334

3435
## 2. Setting Peppol In Company Profile
@@ -45,6 +46,14 @@ tags: ["SQL Account", "Singapore", "InvoiceNow"]
4546

4647
![4](../../static/img/singapore-gst/sg-e-invoice/4.png)
4748

49+
:::info[NOTE]
50+
The icon next to API secret indicates the status for the API key and secret as follows:
51+
52+
- ✅ - Valid API key and secret
53+
- ❌ - Invalid API key and secret
54+
55+
:::
56+
4857
### 2.2 B2G (Business To Government)
4958

5059
1. Fill in your **Vendor ID** registered on Vendors@Gov
@@ -65,23 +74,23 @@ tags: ["SQL Account", "Singapore", "InvoiceNow"]
6574

6675
1. Click on **Edit**
6776

68-
2. Select **Note Tab**
77+
2. Fill in customer **UEN number in Reg. No (New)**
6978

70-
3. Click on the **‘magnifier’ button** to search customer peppol ID
79+
3. Select **Note Tab**
7180

72-
4. Select the Customer **Company Name to get Peppol ID**
81+
4. Click on the **'magnifier' button** to search customer peppol ID
7382

74-
*(When you input your Peppol details, the system will automatically update your UEN Number. Please double check to ensure its accuracy)*
83+
5. Select the Customer **Company Name to get Peppol ID**
7584

76-
5. Fill in customer **UEN number in ‘Reg. No (New)**
85+
*(When you input your Peppol details, the system will automatically update your UEN Number. Please double check to ensure its accuracy)*
7786

7887
6. Click **Save**
7988

8089
![7](../../static/img/singapore-gst/sg-e-invoice/7.png)
8190

8291
### 3.2 Peppol B2G (Business To Government)
8392

84-
1. **Peppol ID must be : 0195:SGUENT08GA0028A**
93+
1. Peppol ID must be: **0195:SGUENT08GA0028A**
8594

8695
2. Must fill in your customer **Business Unit**
8796

@@ -93,7 +102,7 @@ tags: ["SQL Account", "Singapore", "InvoiceNow"]
93102

94103
![8](../../static/img/singapore-gst/sg-e-invoice/8.png)
95104

96-
:::info For Supplier
105+
:::info[For Supplier]
97106
Go to Supplier > Maintain Supplier > Edit > Note Tab
98107
:::
99108

@@ -115,7 +124,7 @@ B2G follows the same steps as B2C, but B2G's Peppol ID must be **0195:SGUENT08GA
115124

116125
## 5. Item Code Mapping
117126

118-
:::info
127+
:::info[NOTE]
119128
Item codes for items in the Peppol document will be automatically selected if there is a matching description.
120129
:::
121130

@@ -138,12 +147,9 @@ Item codes for items in the Peppol document will be automatically selected if th
138147
![12](../../static/img/singapore-gst/sg-e-invoice/12.png)
139148

140149
After done settings, when you import a document from Peppol, the items will be automatically mapped item code and displayed as shown in the picture below, as an example:
141-
142-
**1. Supplier Code and Supplier Name matched**
143-
144-
**2. Item Description matched**
145-
146-
**3. Item Code set automatically**
150+
1. Supplier Code and Supplier Name matched
151+
2. Item Description matched
152+
3. Item Code set automatically
147153

148154
![13](../../static/img/singapore-gst/sg-e-invoice/13.png)
149155

docs/usage/myinvois/einvoice-operation.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -336,95 +336,95 @@ You can download the shared invoice PDF from SQL supplier.
336336

337337
![purchase-invoice-download-pdf](../../../static/img/myinvois/einvoice/purchase-invoice-download-pdf.png)
338338

339-
## TIN Info Link
339+
## E-Invoice Request
340340

341-
The TIN Info Link feature streamlines the process of collecting buyer information for E-Invoice submission. By providing a link, buyers can easily submit their personal or company details, ensuring accurate and real-time invoice creation with a validated LHDN QR code.
341+
The E-Invoice Request feature streamlines the process of collecting buyer information for E-Invoice submission. By providing a link, buyers can easily submit their personal or company details, ensuring accurate and real-time invoice creation with a validated LHDN QR code.
342342

343343
:::warning[IMPORTANT]
344344
The invoice will auto submit to LHDN once the buyer has submitted the required information
345345
:::
346346

347-
### Create TIN Info Link
347+
### Create E-Invoice Request
348348

349-
To create TIN Info link that allows buyers to fill in their personal or company information and submit it for E-Invoice
349+
To create E-Invoice Request that allows buyers to fill in their personal or company information and submit it for E-Invoice
350350

351-
1. Click on **MyInvois** > **Create TIN Info Link** in detail mode
351+
1. Click on **MyInvois** > **E-Invoice Request** in detail mode
352352

353-
![create-link](../../../static/img/myinvois/tininfo/create-link.png)
353+
![create-request](../../../static/img/myinvois/einvoice-request/create-request.png)
354354

355355
2. Select the desired report from the report list
356356

357-
![report-list](../../../static/img/myinvois/tininfo/report-list.png)
357+
![report-list](../../../static/img/myinvois/einvoice-request/report-list.png)
358358

359-
3. Download the report and share it with the buyer
359+
3. Share the report with the buyer
360360

361361
4. The buyer can scan the QR code included in the report to fill in their personal or company information and submit it for E-Invoice
362362

363-
5. An hourglass icon will appear next to the invoice with the TIN Info Link
363+
5. An hourglass icon will appear next to the invoice with the E-Invoice Request
364364

365365
:::info[NOTE]
366366
When clicked, the icon will open the link shared with the buyer
367367
:::
368368

369-
![hourglass](../../../static/img/myinvois/tininfo/hourglass.png)
369+
![hourglass](../../../static/img/myinvois/einvoice-request/hourglass.png)
370370

371-
![eivrequest-form-pending](../../../static/img/myinvois/tininfo/eivrequest-form-pending.png)
371+
![eivrequest-form-pending](../../../static/img/myinvois/einvoice-request/eivrequest-form-pending.png)
372372

373373
6. A filled hourglass icon indicates that the buyer has completed and submitted the required information for E-Invoice
374374

375375
:::info[NOTE]
376376
When clicked, the icon updates the invoice with the submitted details and opens the link shared with the buyer
377377
:::
378378

379-
![filled-hourglass](../../../static/img/myinvois/tininfo/filled-hourglass.png)
379+
![filled-hourglass](../../../static/img/myinvois/einvoice-request/filled-hourglass.png)
380380

381-
![eivrequest-form-valid](../../../static/img/myinvois/tininfo/eivrequest-form-valid.png)
381+
![eivrequest-form-valid](../../../static/img/myinvois/einvoice-request/eivrequest-form-valid.png)
382382

383-
### Cancel TIN Info Link
383+
### Cancel E-Invoice Request
384384

385-
To cancel the TIN Info Link and prevent the buyer from submitting information for E-Invoice
385+
To cancel the E-Invoice Request and prevent the buyer from submitting information for E-Invoice
386386

387-
1. Click on **MyInvois** > **Cancel TIN Info Link** in detail mode
387+
1. Click on **MyInvois** > **Cancel E-Invoice Request** in detail mode
388388

389-
![cancel-link](../../../static/img/myinvois/tininfo/cancel-link.png)
389+
![cancel-request](../../../static/img/myinvois/einvoice-request/cancel-request.png)
390390

391-
### Refresh TIN Info status
391+
### Refresh E-Invoice Request status
392392

393393
To check if the buyer has submitted information for E-Invoice and update the invoice with the submitted details
394394

395-
1. Click on **MyInvois** > **Refresh TIN Info status** in detail mode
395+
1. Click on **MyInvois** > **Refresh E-Invoice Request status** in detail mode
396396

397-
![refresh-status](../../../static/img/myinvois/tininfo/refresh-status.png)
397+
![refresh-status](../../../static/img/myinvois/einvoice-request/refresh-status.png)
398398

399399
2. If the buyer has submitted the required information, the status icon will change to "Valid" and the invoice will be updated with the submitted details
400400

401-
![refresh-status-valid](../../../static/img/myinvois/tininfo/refresh-status-valid.png)
401+
![refresh-status-valid](../../../static/img/myinvois/einvoice-request/refresh-status-valid.png)
402402

403-
### Batch Refresh TIN Info status
403+
### Batch Refresh E-Invoice Request status
404404

405405
To check if buyers have submitted information for E-Invoice and update the status for multiple invoices
406406

407-
1. Click on **MyInvois** > **Batch Refresh TIN Info status** in browse mode
407+
1. Click on **MyInvois** > **Batch Refresh E-Invoice Request status** in browse mode
408408

409-
![batch-refresh-status](../../../static/img/myinvois/tininfo/batch-refresh-status.png)
409+
![batch-refresh-status](../../../static/img/myinvois/einvoice-request/batch-refresh-status.png)
410410

411-
2. A progress dialog will appear and retrieve the latest status for all invoices with TIN Info Links
411+
2. A progress dialog will appear and retrieve the latest status for all invoices with E-Invoice Request
412412

413-
![batch-refresh-status-progress](../../../static/img/myinvois/tininfo/batch-refresh-status-progress.png)
413+
![batch-refresh-status-progress](../../../static/img/myinvois/einvoice-request/batch-refresh-status-progress.png)
414414

415415
### Batch Submit E-Invoice & Consolidate E-Invoice
416416

417-
When selected invoices include those with TIN Info Links (Hourglass icon), the following options will appear in the Batch Submit E-Invoice and Consolidate E-Invoice forms:
417+
When selected invoices include those with E-Invoice Request (Hourglass icon), the following options will appear in the Batch Submit E-Invoice and Consolidate E-Invoice forms:
418418

419419
- Refresh - Verify that the selected invoices have been submitted for E-Invoice by the buyers and update the information
420-
- Cancel - Cancel the TIN Info Links for the selected invoices to prevent buyers from submitting information for E-Invoice
420+
- Cancel - Cancel the E-Invoice Request for the selected invoices to prevent buyers from submitting information for E-Invoice
421421

422-
![batch-submit](../../../static/img/myinvois/tininfo/batch-submit.png)
422+
![batch-submit](../../../static/img/myinvois/einvoice-request/batch-submit.png)
423423

424424
:::info[NOTE]
425425
You may click the Valid icon to perform check status
426426
:::
427427

428-
![batch-submit-valid](../../../static/img/myinvois/tininfo/batch-submit-valid.png)
428+
![batch-submit-valid](../../../static/img/myinvois/einvoice-request/batch-submit-valid.png)
429429

430-
![batch-submit-check-status](../../../static/img/myinvois/tininfo/batch-submit-check-status.png)
430+
![batch-submit-check-status](../../../static/img/myinvois/einvoice-request/batch-submit-check-status.png)

0 commit comments

Comments
 (0)