Step 4 - Invoices

When a registered taxable person supplies taxable goods or services, a GST invoice is issued. To issue and receive a GST compliant invoice is a prerequisite to claim ITC. If a taxpayer does not issue such an invoice to his customer - who is a registered taxable person, his customer loses the ITC claim and the taxpayer loses its customers. These APIs help you create, update, delete and share invoices.

Invoice Entity

The various properties are explained below:

Param

Type

Description

balance

bigdecimal

Current balance

bank_account

object

Bank account

discount

bigdecimal

Discout amount

document_type

string

Type of document. Possible values: Bill of Supply and Invoice

due_date

date

Due date of payment

id

hex(32)

Unique invoice identifier

invoice_date

date

Date of invoice generation

invoice_number

string

Invoice number

is_cancelled

boolean

Whether invoice is cacelled or not

is_uploaded

boolean

Whether invoice is uploaded or not

is_round_off

boolean

Whether invoice is round of or not

items

array

List of items

note

string

Additional notes on invoice

original_invoice_number

string

Original invoice number

payment_status

string

Payment status. Possible values: Paid, Partial, Overdue and Unpaid

purchaser

object

Purchaser dealer

reference_number

string

Reference number

status

string

Document status. Possible values: Deleted, Opened, Sent and Unsent

subtotal

bigdecimal

Subtotal amount

supplier

object

Supplier dealer

supporting_documents

array

List of documents

taxable_value

bigdecimal

Taxable value

terms_and_conditions

string

Terms and conditions on invoice

total

bigdecimal

Total amount in invoice

transaction_type

string

Type of transaction. Possible values: Purchase and Sale

url

string

Signed url of invoice document

Tax Invoice Entity

The additional properties excluding properties of it's supertype "Invoice" are explained below:

Param

Type

Description

cess

bigdecimal

Cess amount

cgst

bigdecimal

CGST amount

gst

bigdecimal

GST amount

igst

bigdecimal

IGST amount

is_reverse_charge

boolean

Whether invoice is reverse charged

sgst

bigdecimal

SGST amount