API Test Keys

Bills Entity

The Bills entity has the following parameters:

Is this page helpful?

Entity

1{
2  "id": "bill_4a5e9ulyzk1mk2",
3  "business_type": "retail",
4  "business_category": "retail_and_consumer_goods",
5  "customer": {
6    "contact": "9000090000",
7    "name": "Gaurav Kumar",
8    "email": "gaurav.kumar@example.com",
9    "customer_id": "",
10    "age": 27,
11    "date_of_birth": "03/12/1889",
12    "profession": "",
13    "company_name": "",
14    "marital_status": "married",
15    "spouse_name": "",
16    "anniversary_date": "",
17    "gender": "male",
18    "gstin": "",
19    "billing_address": {
20      "address_line_1": "r",
21      "address_line_2": "",
22      "landmark": "",
23      "city": "",
24      "province": "",
25      "pin_code": "",
26      "country": ""
27    },
28    "shipping_address": {
29      "address_line_1": "r",
30      "address_line_2": "",
31      "landmark": "",
32      "city": "",
33      "province": "",
34      "pin_code": "",
35      "country": ""
36    }
37  },
38  "loyalty": {
39    "type": "cashback",
40    "card_num": "",
41    "card_holder_name": "",
42    "wallet_amount": 0,
43    "amount_saved": 0,
44    "points_earned": 5,
45    "points_redeemed": 0,
46    "points_available": 0,
47    "points_balance": 0
48  },
49  "store_code": "MM-001",
50  "receipt_timestamp": 946684801,
51  "receipt_number": "INV101",
52  "receipt_type": "tax_invoice",
53  "receipt_delivery": "digital",
54  "bar_code_number": "",
55  "qr_code_number": "",
56  "billing_pos_number": "bn",
57  "pos_category": "traditional_pos",
58  "order_number": "",
59  "order_service_type": "",
60  "delivery_status_url": "google.com",
61  "cashier_name": "wt4rseg",
62  "cashier_code": "fsd",
63  "line_items": [
64    {
65      "name": "dsv",
66      "quantity": 1,
67      "unit_amount": 0,
68      "unit": "kg",
69      "description": "",
70      "hsn_code": "",
71      "product_code": "",
72      "product_uid": "",
73      "image_url": "",
74      "discount": 0,
75      "discount_description": "",
76      "total_amount": 20,
77      "brand": "",
78      "style": "",
79      "colour": "",
80      "size": "",
81      "financier_data": {
82        "reference": "",
83        "name": ""
84      },
85      "taxes": [
86        {
87          "name": "cgst",
88          "percentage": 0,
89          "amount": 20
90        }
91      ]
92    }
93  ],
94  "receipt_summary": {
95    "total_quantity": 1,
96    "sub_total_amount": 1,
97    "currency": "INR",
98    "net_payable_amount": 20,
99    "payment_status": "success",
100    "delivery_charges": 0,
101    "cod_charges": 0,
102    "change_amount": 0,
103    "roundup_amount": 0,
104    "total_discount_percent": 0,
105    "total_discount_amount": 0,
106    "discounts": [
107      {
108        "name": "adsf",
109        "amount": 0
110      }
111    ],
112    "used_wallet_amount": 0
113  },
114  "taxes": [
115    {
116      "name": "cgst",
117      "percentage": 0,
118      "amount": -1
119    }
120  ],
121  "payments": [
122    {
123      "method": "paytm",
124      "currency": "INR",
125      "amount": 5,
126      "payment_reference_id": "",
127      "financier_data": {
128        "reference": "",
129        "name": "v"
130      }
131    }
132  ],
133  "event": null,
134  "receipt_url": "yourbill.me/4a5e9ulyzk1mk2",
135  "created_at": 946684801
136}

id

string

Unique id of the bill generated.

business_type

string

The type of business. Possible values:

ecommerce
retail

business_category

string

The category the business falls under. Possible values:

events
food_and_beverages
retail_and_consumer_goods
other_services

customer

string

Details of the customer. Required if receipt mode is digital or digital_and_print.

Show child parameters (16)

loyalty

object

Customer loyalty details.

Show child parameters (9)

store_code

string

Associated store code for the receipt. Required if you have a multi-store setup where you have a single integration and have multiple stores under you.

receipt_timestamp

integer

UNIX timestamp of the date and time when the receipt was generated.

receipt_number

integer

Unique receipt number generated for the bill.

receipt_type

string

The type of receipt. Possible values:

tax_invoice
sales_invoice
sales_return_invoice
proforma_invoice
credit_invoice
purchase_invoice
debit_invoice

receipt_delivery

string

Indicates the delivery type of the receipt. Possible values:

digital
print
digital_and_print

bar_code_number

integer

Bar code generated after the transaction. This will be displayed on the digital bill only.

qr_code_number

integer

QR code generated after the transaction. This will be displayed on the digital bill only.

billing_pos_number

string

POS number of the machine that generated the bill. This is applicable if business_type is retail.

pos_category

string

The type of POS machine. This is applicable if business_type is retail. Possible values:

traditional_pos
kiosk_pos

order_number

string

Incremental order number of the generated bill.

order_service_type

string

Order service type of the generated bill. This is applicable if business_category is food_and_beverages. Possible values:

dine_in
take_away

delivery_status_url

string

Order delivery status. This is applicable if business_type is ecommerce.

cashier_name

string

Name of the cashier that billed the order. This is applicable if business_type is retail.

cashier_code

string

The unique id of the cashier that billed the order. This is applicable if business_type is retail.

line_items

object

This is an array of objects containing the product data of the bill. Required if receipt_type is not credit_invoice or debit_invoice.

Show child parameters (18)

receipt_summary

object

Details of the receipt.

Show child parameters (13)

taxes

object

This is an array of objects containing the details of the taxes applied. Required if receipt_type is tax_inovice, purchase_invoice or sales_invoice.

Show child parameters (3)

payments

object

This is an array of objects containing the details of the payment.

Show child parameters (4)

event

object

Details of the event booking. Required if business_category is events.

Show child parameters (6)

receipt_url

string

The link to the receipt.

created_at

integer

UNIX timestamp of the date when the bill was generated.

Bills Entity

The Bills entity has the following parameters:

Is this page helpful?

id

string

Unique id of the bill generated.

business_type

string

The type of business. Possible values:

ecommerce
retail

business_category

string

The category the business falls under. Possible values:

events
food_and_beverages
retail_and_consumer_goods
other_services

customer

string

Details of the customer. Required if receipt mode is digital or digital_and_print.

Show child parameters (16)

loyalty

object

Customer loyalty details.

Show child parameters (9)

store_code

string

Associated store code for the receipt. Required if you have a multi-store setup where you have a single integration and have multiple stores under you.

receipt_timestamp

integer

UNIX timestamp of the date and time when the receipt was generated.

receipt_number

integer

Unique receipt number generated for the bill.

receipt_type

string

The type of receipt. Possible values:

tax_invoice
sales_invoice
sales_return_invoice
proforma_invoice
credit_invoice
purchase_invoice
debit_invoice

receipt_delivery

string

Indicates the delivery type of the receipt. Possible values:

digital
print
digital_and_print

bar_code_number

integer

Bar code generated after the transaction. This will be displayed on the digital bill only.

qr_code_number

integer

QR code generated after the transaction. This will be displayed on the digital bill only.

billing_pos_number

string

POS number of the machine that generated the bill. This is applicable if business_type is retail.

pos_category

string

The type of POS machine. This is applicable if business_type is retail. Possible values:

traditional_pos
kiosk_pos

order_number

string

Incremental order number of the generated bill.

order_service_type

string

Order service type of the generated bill. This is applicable if business_category is food_and_beverages. Possible values:

dine_in
take_away

delivery_status_url

string

Order delivery status. This is applicable if business_type is ecommerce.

cashier_name

string

Name of the cashier that billed the order. This is applicable if business_type is retail.

cashier_code

string

The unique id of the cashier that billed the order. This is applicable if business_type is retail.

line_items

object

This is an array of objects containing the product data of the bill. Required if receipt_type is not credit_invoice or debit_invoice.

Show child parameters (18)

receipt_summary

object

Details of the receipt.

Show child parameters (13)

taxes

object

This is an array of objects containing the details of the taxes applied. Required if receipt_type is tax_inovice, purchase_invoice or sales_invoice.

Show child parameters (3)

payments

object

This is an array of objects containing the details of the payment.

Show child parameters (4)

event

object

Details of the event booking. Required if business_category is events.

Show child parameters (6)

receipt_url

string

The link to the receipt.

created_at

integer

UNIX timestamp of the date when the bill was generated.

Entity

1{
2  "id": "bill_4a5e9ulyzk1mk2",
3  "business_type": "retail",
4  "business_category": "retail_and_consumer_goods",
5  "customer": {
6    "contact": "9000090000",
7    "name": "Gaurav Kumar",
8    "email": "gaurav.kumar@example.com",
9    "customer_id": "",
10    "age": 27,
11    "date_of_birth": "03/12/1889",
12    "profession": "",
13    "company_name": "",
14    "marital_status": "married",
15    "spouse_name": "",
16    "anniversary_date": "",
17    "gender": "male",
18    "gstin": "",
19    "billing_address": {
20      "address_line_1": "r",
21      "address_line_2": "",
22      "landmark": "",
23      "city": "",
24      "province": "",
25      "pin_code": "",
26      "country": ""
27    },
28    "shipping_address": {
29      "address_line_1": "r",
30      "address_line_2": "",
31      "landmark": "",
32      "city": "",
33      "province": "",
34      "pin_code": "",
35      "country": ""
36    }
37  },
38  "loyalty": {
39    "type": "cashback",
40    "card_num": "",
41    "card_holder_name": "",
42    "wallet_amount": 0,
43    "amount_saved": 0,
44    "points_earned": 5,
45    "points_redeemed": 0,
46    "points_available": 0,
47    "points_balance": 0
48  },
49  "store_code": "MM-001",
50  "receipt_timestamp": 946684801,
51  "receipt_number": "INV101",
52  "receipt_type": "tax_invoice",
53  "receipt_delivery": "digital",
54  "bar_code_number": "",
55  "qr_code_number": "",
56  "billing_pos_number": "bn",
57  "pos_category": "traditional_pos",
58  "order_number": "",
59  "order_service_type": "",
60  "delivery_status_url": "google.com",
61  "cashier_name": "wt4rseg",
62  "cashier_code": "fsd",
63  "line_items": [
64    {
65      "name": "dsv",
66      "quantity": 1,
67      "unit_amount": 0,
68      "unit": "kg",
69      "description": "",
70      "hsn_code": "",
71      "product_code": "",
72      "product_uid": "",
73      "image_url": "",
74      "discount": 0,
75      "discount_description": "",
76      "total_amount": 20,
77      "brand": "",
78      "style": "",
79      "colour": "",
80      "size": "",
81      "financier_data": {
82        "reference": "",
83        "name": ""
84      },
85      "taxes": [
86        {
87          "name": "cgst",
88          "percentage": 0,
89          "amount": 20
90        }
91      ]
92    }
93  ],
94  "receipt_summary": {
95    "total_quantity": 1,
96    "sub_total_amount": 1,
97    "currency": "INR",
98    "net_payable_amount": 20,
99    "payment_status": "success",
100    "delivery_charges": 0,
101    "cod_charges": 0,
102    "change_amount": 0,
103    "roundup_amount": 0,
104    "total_discount_percent": 0,
105    "total_discount_amount": 0,
106    "discounts": [
107      {
108        "name": "adsf",
109        "amount": 0
110      }
111    ],
112    "used_wallet_amount": 0
113  },
114  "taxes": [
115    {
116      "name": "cgst",
117      "percentage": 0,
118      "amount": -1
119    }
120  ],
121  "payments": [
122    {
123      "method": "paytm",
124      "currency": "INR",
125      "amount": 5,
126      "payment_reference_id": "",
127      "financier_data": {
128        "reference": "",
129        "name": "v"
130      }
131    }
132  ],
133  "event": null,
134  "receipt_url": "yourbill.me/4a5e9ulyzk1mk2",
135  "created_at": 946684801
136}