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.

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 here.

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)

The response description for the API can be found here.

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."
}