EInvoicing
  • Introduction
  • Environments
  • Authentication
    • Access Tokens
    • API KEY
  • Generate IRN
  • Cancel IRN
  • Generate E-Way Bill by IRN
  • Generate IRN in Bulk
  • Get IRN Details In Bulk
  • Get IRN Details By IRN
  • Get IRN Details By Doc Details
  • Get e-Waybill Details by IRN
  • Get Gstin Details
  • Sync GSTIN Details from CP
Powered by GitBook
On this page
  • Request Method
  • Request Path
  • Request Headers
  • Request Body
  • Response Body

Generate IRN in Bulk

This API is used for registering the invoice and getting the Invoice Registration Number (IRN). The details of the requests and responses are explained.

PreviousGenerate E-Way Bill by IRNNextGet IRN Details In Bulk

Last updated 1 year ago

Request Method

POST

Request Path

{{API_URL}}/api/v1/einvoiceGenerateInBulk/

Request Headers

Parameter
Value
Description

Authorization/api_key

api_key/auth token

Value and header type is mentioned in the Authentication Page

Request Body

The request body description for the API can be found .

Sample Request

{
	"einvoice_list": [{
			"user_gstin": "XXXXXXXXXXXXXXX",
			"data_source": "erp",
			"transaction_details": {
				"supply_type": "B2B",
				"charge_type": "Y",
				"igst_on_intra": "N",
				"ecommerce_gstin": ""
			},
			"document_details": {
				"document_type": "INV",
				"document_number": "TATA/A/0011",
				"document_date": "23/06/2023"
			},
			"seller_details": {
				"gstin": "XXXXXXXXXXXXXXX",
				"legal_name": "MastersIndia UP",
				"trade_name": "123",
				"address1": "45",
				"address2": "l45",
				"location": "1279",
				"pincode": 201301,
				"state_code": "09",
				"phone_number": 9876543231,
				"email": ""
			},
			"buyer_details": {
				"gstin": "XXXXXXXXXXXXXXX",
				"legal_name": "ewewewehyriu32y8ru",
				"trade_name": "122",
				"address1": "9",
				"address2": "17843",
				"location": "12321u",
				"pincode": 263001,
				"place_of_supply": "13",
				"state_code": "05",
				"phone_number": "123233",
				"email": ""
			},
			"dispatch_details": {
				"company_name": "dqfefkewl",
				"address1": "Vila",
				"address2": "Vila",
				"location": "Noida",
				"pincode": 201301,
				"state_code": "09"
			},
			"ship_details": {
				"gstin": "XXXXXXXXXXXXXXX",
				"legal_name": "123",
				"trade_name": "232",
				"address1": "1",
				"address2": "",
				"location": "221",
				"pincode": 263001,
				"state_code": "5"
			},
			"export_details": {
				"ship_bill_number": "",
				"ship_bill_date": "",
				"country_code": "IN",
				"foreign_currency": "inr",
				"refund_claim": "N",
				"port_code": "12",
				"export_duty": "90.9"
			},
			"payment_details": {
				"bank_account_number": "Account Details",
				"paid_balance_amount": "100.2",
				"credit_days": 2,
				"credit_transfer": "Credit Transfer",
				"direct_debit": "Direct Debit",
				"branch_or_ifsc": "KKK000180",
				"payment_mode": "CASH",
				"payee_name": "Payee Name",
				"outstanding_amount": "1.9",
				"payment_instruction": "Payment Instruction",
				"payment_term": "Terms of Payment"
			},
			"reference_details": {
				"invoice_remarks": "Invoice Remarks",
				"document_period_details": {
					"invoice_period_start_date": "07/03/2020",
					"invoice_period_end_date": "07/03/2020"
				},
				"preceding_document_details": [{
					"reference_of_original_invoice": "CFRT/0006",
					"preceding_invoice_date": "07/03/2020",
					"other_reference": "2334"
				}],
				"contract_details": [{
					"receipt_advice_number": "aaa",
					"receipt_advice_date": "07/03/2020",
					"batch_reference_number": "2334",
					"contract_reference_number": "2334",
					"other_reference": "2334",
					"project_reference_number": "2334",
					"vendor_po_reference_number": "233433454545",
					"vendor_po_reference_date": "07/02/2020"
				}]
			},
			"additional_document_details": [{
				"supporting_document_url": "asafsd",
				"supporting_document": "india",
				"additional_information": "india"
			}],
			"ewaybill_details": {
				"transporter_id": "XXXXXXXXXXXXXXX",
				"transporter_name": "Jay Trans",
				"transportation_mode": "1",
				"transportation_distance": 4000,
				"transporter_document_number": "1230",
				"transporter_document_date": "23/06/2023",
				"vehicle_number": "PQR1234",
				"vehicle_type": "R"
			},
			"value_details": {
				"total_assessable_value": 4,
				"total_cgst_value": "",
				"total_sgst_value": 0,
				"total_igst_value": 0.2,
				"total_cess_value": 0,
				"total_cess_value_of_state": 0,
				"total_discount": 0,
				"total_other_charge": 0,
				"total_invoice_value": 4.2,
				"round_off_amount": 0,
				"total_invoice_value_additional_currency": 0
			},
			"item_list": [{
				"item_serial_number": "501",
				"product_description": "Wheat desc",
				"is_service": "N",
				"hsn_code": "1001",
				"bar_code": "1212",
				"quantity": 1,
				"free_quantity": 0,
				"unit": "KGS",
				"unit_price": 4,
				"total_amount": 4,
				"pre_tax_value": 0,
				"discount": 0,
				"other_charge": 0,
				"assessable_value": 4,
				"gst_rate": 5,
				"igst_amount": 0.2,
				"cgst_amount": 0,
				"sgst_amount": 0,
				"cess_rate": 0,
				"cess_amount": 0,
				"cess_nonadvol_amount": 0,
				"state_cess_rate": 0,
				"state_cess_amount": 0,
				"state_cess_nonadvol_amount": 0,
				"total_item_value": 4.2,
				"country_origin": "",
				"order_line_reference": "",
				"product_serial_number": "",
				"batch_details": {
					"name": "aaa",
					"expiry_date": "31/10/2020",
					"warranty_date": "31/10/2020"
				},
				"attribute_details": [{
					"item_attribute_details": "aaa",
					"item_attribute_value": "147852"
				}]
			}]
		},

		{
			"user_gstin": "XXXXXXXXXXXXXXX",
			"data_source": "erp",
			"transaction_details": {
				"supply_type": "B2B",
				"charge_type": "Y",
				"igst_on_intra": "N",
				"ecommerce_gstin": ""
			},
			"document_details": {
				"document_type": "INV",
				"document_number": "TATA/A/0012",
				"document_date": "23/06/2023"
			},
			"seller_details": {
				"gstin": "XXXXXXXXXXXXXXX",
				"legal_name": "MastersIndia UP",
				"trade_name": "123",
				"address1": "45",
				"address2": "l45",
				"location": "1279",
				"pincode": 201301,
				"state_code": "09",
				"phone_number": 9876543231,
				"email": ""
			},
			"buyer_details": {
				"gstin": "XXXXXXXXXXXXXXX",
				"legal_name": "ewewewehyriu32y8ru",
				"trade_name": "122",
				"address1": "9",
				"address2": "17843",
				"location": "12321u",
				"pincode": 263001,
				"place_of_supply": "13",
				"state_code": "05",
				"phone_number": "123233",
				"email": ""
			},
			"dispatch_details": {
				"company_name": "dqfefkewl",
				"address1": "Vila",
				"address2": "Vila",
				"location": "Noida",
				"pincode": 201301,
				"state_code": "09"
			},
			"ship_details": {
				"gstin": "XXXXXXXXXXXXXXX",
				"legal_name": "123",
				"trade_name": "232",
				"address1": "1",
				"address2": "",
				"location": "221",
				"pincode": 263001,
				"state_code": "5"
			},
			"export_details": {
				"ship_bill_number": "",
				"ship_bill_date": "",
				"country_code": "IN",
				"foreign_currency": "inr",
				"refund_claim": "N",
				"port_code": "12",
				"export_duty": "90.9"
			},
			"payment_details": {
				"bank_account_number": "Account Details",
				"paid_balance_amount": "100.2",
				"credit_days": 2,
				"credit_transfer": "Credit Transfer",
				"direct_debit": "Direct Debit",
				"branch_or_ifsc": "KKK000180",
				"payment_mode": "CASH",
				"payee_name": "Payee Name",
				"outstanding_amount": "1.9",
				"payment_instruction": "Payment Instruction",
				"payment_term": "Terms of Payment"
			},
			"reference_details": {
				"invoice_remarks": "Invoice Remarks",
				"document_period_details": {
					"invoice_period_start_date": "07/03/2020",
					"invoice_period_end_date": "07/03/2020"
				},
				"preceding_document_details": [{
					"reference_of_original_invoice": "CFRT/0006",
					"preceding_invoice_date": "07/03/2020",
					"other_reference": "2334"
				}],
				"contract_details": [{
					"receipt_advice_number": "aaa",
					"receipt_advice_date": "07/03/2020",
					"batch_reference_number": "2334",
					"contract_reference_number": "2334",
					"other_reference": "2334",
					"project_reference_number": "2334",
					"vendor_po_reference_number": "233433454545",
					"vendor_po_reference_date": "07/02/2020"
				}]
			},
			"additional_document_details": [{
				"supporting_document_url": "asafsd",
				"supporting_document": "india",
				"additional_information": "india"
			}],
			"ewaybill_details": {
				"transporter_id": "XXXXXXXXXXXXXXX",
				"transporter_name": "Jay Trans",
				"transportation_mode": "1",
				"transportation_distance": 4000,
				"transporter_document_number": "1230",
				"transporter_document_date": "23/06/2023",
				"vehicle_number": "PQR1234",
				"vehicle_type": "R"
			},
			"value_details": {
				"total_assessable_value": 4,
				"total_cgst_value": "",
				"total_sgst_value": 0,
				"total_igst_value": 0.2,
				"total_cess_value": 0,
				"total_cess_value_of_state": 0,
				"total_discount": 0,
				"total_other_charge": 0,
				"total_invoice_value": 4.2,
				"round_off_amount": 0,
				"total_invoice_value_additional_currency": 0
			},
			"item_list": [{
				"item_serial_number": "501",
				"product_description": "Wheat desc",
				"is_service": "N",
				"hsn_code": "1001",
				"bar_code": "1212",
				"quantity": 1,
				"free_quantity": 0,
				"unit": "KGS",
				"unit_price": 4,
				"total_amount": 4,
				"pre_tax_value": 0,
				"discount": 0,
				"other_charge": 0,
				"assessable_value": 4,
				"gst_rate": 5,
				"igst_amount": 0.2,
				"cgst_amount": 0,
				"sgst_amount": 0,
				"cess_rate": 0,
				"cess_amount": 0,
				"cess_nonadvol_amount": 0,
				"state_cess_rate": 0,
				"state_cess_amount": 0,
				"state_cess_nonadvol_amount": 0,
				"total_item_value": 4.2,
				"country_origin": "",
				"order_line_reference": "",
				"product_serial_number": "",
				"batch_details": {
					"name": "aaa",
					"expiry_date": "31/10/2020",
					"warranty_date": "31/10/2020"
				},
				"attribute_details": [{
					"item_attribute_details": "aaa",
					"item_attribute_value": "147852"
				}]
			}]
		}


	]
}

Response Body

200 (OK)

Sample Response

{
  "results": {
    "status": "Success",
    "message": "Request has been accepted.Please get response by the request id",
    "code": 200,
    "request_status": "pending",
    "requestId": "edoc_1694681573_7a4d44de71b7"
  }
}

204 (Invalid Parameters)

{
  "error": "invalid_request",
  "error_description": "Invalid Json Structure."
}

The response description for the API can be found .

here
here