E-Invoicing for Singapore: API References

Introduction

In Singapore, the government introduced the e-invoicing mandate under the e-invoicing framework, which was rolled out to standardize business-to-business (B2B) invoicing and improve the efficiency of the invoicing process. This system, InvoiceNow, enables seamless exchange of invoices between businesses and with government agencies. It allows for the secure transmission of structured electronic invoices in the Peppol BIS Billing 3.0 format, which ensures consistency and reduces errors in tax reporting.

Introduction to InvoiceNow:

InvoiceNow was launched to simplify the invoicing process, reduce manual errors, and improve the reconciliation process for businesses. The platform is powered by the Peppol network, a global standard for electronic data exchange. As of January 2024, it has become a requirement for businesses that are registered with the Goods and Services Tax (GST) to use InvoiceNow for sending and receiving invoices for transactions with other businesses. This move aims to promote digital transformation across Singapore's economy and streamline the tax compliance process.

Peppol Standards:

InvoiceNow is based on the Peppol network, which facilitates the exchange of e-invoices in a standardized format. Peppol ensures interoperability with various countries globally, allowing businesses to exchange invoices across borders seamlessly.

BIS Billing 3.0 Format:

The system uses the Peppol BIS Billing 3.0 standard for invoice data exchange, which is the technical format required by all users for invoice submission. This ensures consistency in how invoices are generated, transmitted, and processed.

Integration with Accounting Systems:

Businesses are encouraged to integrate their accounting or ERP systems with the InvoiceNow platform, either by using certified software or by building their own integrations. This allows invoices to be directly sent to the platform without manual intervention.

Transaction Validation:

The e-invoices sent through InvoiceNow undergo validation, ensuring they meet regulatory and technical standards. This includes checks for proper GST formatting, invoice authenticity, and compliance with tax reporting rules.

In Singapore, businesses that are GST-registered must adopt InvoiceNow for their transactions with other businesses as part of the broader push for digitalization. By utilizing InvoiceNow, companies can ensure real-time invoicing, reduce errors, and simplify compliance with tax regulations.

Onboard to InvoiceNow

curl 
  --url https://sandbox-api.flick.network/sg/einvoice/onboard \
  --header 'x-flick-auth-key: {token}' \
  --header 'Content-Type: application/json' \
  --data '
  {
    "registered_name": "TestCompany",
    "identifiers": [
      {
        "scheme": "SG:UEN",
        "id": "SGTST0987654321SC"
      }
    ],
    "city": "Singapore",
    "street": "Example Street 45",
    "county": "Central Region",
    "country": "SG",
    "contact_number": "+65-61234567"
  }'

{
  "status": "success",
  "message": "Successfully Onboarded to Peppol",
  "data": {
    "supplier_uuid": "f4b173a9-9f0f-4850-b682-762290885fee"
  }
}

Submit an Invoice

curl --url https://sandbox-api.flick.network/sg/einvoice/generate/invoice \
  --header 'x-flick-auth-key: {token}' \
  --header 'supplier_uuid: {supplier_uuid}' \
  --header 'transport_mode: peppol' \
  --header 'Content-Type: application/json' \
  --data '
    {
      "ID": "INV-11",
      "DocumentType": "Invoice",
      "IssueDate": "2024-12-01",
      "DocumentCurrencyCode": "SGD",
      "CustomerParty": {
        "RegisteredName": "Test Inc.",
        "address": {
          "Street": "Street Name 987",
          "ZipCode": "9999AA",
          "City": "City Test",
          "Country": "SG"
        },
        "Identifiers": [
          {
            "Scheme": "SG:UEN",
            "ID": "SGTST0987654321SC"
          }
        ]
      },
      "InvoiceLines": [
        {
          "Description": "Test Item",
          "InvoicedQuantity": 2,
          "PriceAmount": 100,
          "TaxType": {
            "TaxRate": 19,
            "TaxType": "standard",
            "TaxCountry": "SG"
          }
        }
      ],
      "TotalIncludingVat": 238.00
    }'

{
  "status": "success",
  "data": {
    "DocumentID": "52d08f40-a2a0-450b-857f-2e1dd865064c",
    "DeliveryStatus": "Scheduled"
  }
}

Get Document Details

curl 
  --url https://sandbox-api.flick.network/sg/einvoice/get-document/{uuid} \

  --header 'x-flick-auth-key: {token}' \
  --header 'supplier_uuid: {supplier_uuid}' 

{
  "uuid": "52d08f40-a2a0-450b-857f-2e1dd865064c",
  "ID": "INV-11",
  "DocumentType": "Invoice",
  "IssueDate": "2024-12-01",
  "DocumentCurrencyCode": "SGD",
  "CustomerParty": {
    "RegisteredName": "Test Inc.",
    "address": {
      "Street": "Street Name 987",
      "ZipCode": "9999AA",
      "City": "City Test",
      "Country": "SG"
    },
    "Identifiers": [
      {
        "Scheme": "SG:UEN",
        "ID": "SGTST0987654321SC"
      }
    ]
  },
  "InvoiceLines": [
    {
      "Description": "Test Item",
      "InvoicedQuantity": 2,
      "PriceAmount": 100,
      "TaxType": {
        "TaxRate": 19,
        "TaxType": "standard",
        "TaxCountry": "SG"
      }
    }
  ],
  "TotalIncludingVat": 238.00
}

Get Delivery Status

curl 
  --url https://sandbox-api.flick.network/sg/einvoice/delivery-status/{uuid} \

  --header 'x-flick-auth-key: {token}' \
  --header 'supplier_uuid: {supplier_uuid}' 

{
  "DocumentID": "52d08f40-a2a0-450b-857f-2e1dd865064c",
  "DeliveryStatus": "Delivered"
}

Received Document

{
  "Event": "DocumentReceived",
  "EventType": "PeppolReceived",
  "EventGroup": "Invoice",
  "uuid": "52d08f40-a2a0-450b-857f-2e1dd865064c",
  "DocumentId": "INV-123",
  "Status": "Delivered"
}