Object

Shown below is a sample bharat_connect.invoice object for Fetch Business Data.

{
    "id": "bcinv_k3pbaALyh1CmzTPTOToHywYey",
    "object": "bharat_connect.invoice",
    "type": "OUTGOING"
    "supplier_invoice_number": "INV0012312",
    "supplier_details": {
        "b2b_id": "zwch_1731304320a8b539acf65f1337854926",
        "gst_in": "22AAAAA0000A3Z9",
        "legal_name": "Open Financial",
        "trade_name": "Open Financial",
        "email": "[email protected]",
        "state_code": "32",
        "place_of_supply_code": "",
        "address": {
            "type": "OTHER",
            "address": "RGA Tech park 123",
            "city": "Bangalore",
            "postal_code": "560035",
            "state_code": "",
            "state": "KARNATAKA"
        }
    },
    "buyer_details": {
        "b2b_id": "zwch_1731046715a8b539acf65f6707494305",
        "gst_in": "22AAAAA0000A1H2",
        "legal_name": "Surjava Test",
        "trade_name": "Surjava Test",
        "email": "[email protected]",
        "state_code": "06",
        "place_of_supply_code": "32",
        "address": {
            "type": "OTHER",
            "address": "RGA Tech park 456",
            "city": "Bangalore",
            "postal_code": "560035",
            "state_code": "",
            "state": "KARNATAKA"
        }
    },
    "transaction_detais": {
        "supply_type": "B2B",
        "reverse_charge_tax": "",
        "e_commerce_gstin": "",
        "igst_chargable": ""
    },
    "e_invoice_details": {
        "irn": "",
        "irn_ts": ""
    },
    "items_details": [
        {
            "serial_no": "1",
            "is_service": "NO",
            "hsn_code": "19059040",
            "quantity": 1,
            "unit_price": 2,
            "total_amount": 2,
            "assessment_amount": 2,
            "gst_rate": 18,
            "total_item_value": 4,
            "product_description": "xyz description test"
        }
    ],
    "value_details": {
        "assessment_value": 4,
        "total_invoice_value": 4
    },
    "supplier_bank_details": {
        "vpa": "test@vpa",
        "account_type": "",
        "bank_account_number": "3307",
        "name_of_account_holder": "John Doe",
        "bank_ifsc_code": "SBIN0070305",
        "bank_name": "SBI"
    },
    "metadata": {},
    "status": "SENT TO BUYER",
    "response":{
	    "status":"SUCCESS",
	    "message":""
    }

}


The table below lists the various parameters in the bharat_connect.invoice object.

ParametersTypeDescription
idstringUnique identifier for the invoice. Example: bcinv_k3pbaALyh1CmzTPTOToHywYey
objectstringType of the object. Example: bharat_connect.invoice
typestringType of the invoice. Example: OUTGOING
supplier_invoice_numberstringInvoice number provided by the supplier. Example: INV0012312
supplier_detailsobjectDetails about the supplier.
buyer_detailsobjectDetails about the buyer.
transaction_detailsobjectDetails about the transaction.
e_invoice_detailsobjectE-invoice related details.
items_detailsarray of objectsList of items in the invoice.
value_detailsobjectSummary of the invoice values.
supplier_bank_detailsobjectBank account details of the supplier.
metadataobjectAdditional metadata about the invoice.
statusstringCurrent status of the invoice. Example: SENT TO BUYER
responseobjectResponse details for the invoice processing.

Child Object: Supplier Details

The table below lists the various parameters in the supplier_details object which is part of the bharat_connect.invoice object.

ParametersTypeDescription
b2b_idstringUnique B2B identifier of the supplier. Example: zwch_1731304320a8b539acf65f1337854926
gst_instringGSTIN of the supplier. Example: 22AAAAA0000A3Z9
legal_namestringLegal name of the supplier. Example: Open Financial
trade_namestringTrade name of the supplier. Example: Open Financial
emailstringEmail address of the supplier. Example: [email protected]
state_codestringState code of the supplier. Example: 32
place_of_supply_codestringPlace of supply code. Example: 32
addressobjectAddress of the supplier.

Child Object: Buyer Details

The table below lists the various parameters in the buyer_details object which is part of the bharat_connect.invoice object.

ParametersTypeDescription
b2b_idstringUnique B2B identifier of the buyer. Example: zwch_1731046715a8b539acf65f6707494305
gst_instringGSTIN of the buyer. Example: 22AAAAA0000A1H2
legal_namestringLegal name of the buyer. Example: Surjava Test
trade_namestringTrade name of the buyer. Example: Surjava Test
emailstringEmail address of the buyer. Example: [email protected]
state_codestringState code of the buyer. Example: 06
place_of_supply_codestringPlace of supply code. Example: 32
addressobjectAddress of the buyer.

Child Object: Address (Under Supplier and Buyer Details)

The table below lists the various parameters in the address object which is part of the supplier_details and buyer_details object.

ParametersTypeDescription
typestringType of address. Example: OTHER
addressstringFull address. Example: RGA Tech park 123
citystringCity of the address. Example: Bangalore
postal_codestringPostal code of the address. Example: 560035
state_codestringState code. Example: 32
statestringFull state name. Example: KARNATAKA

Child Object: transaction_details

The table below lists the various parameters in the transaction_details object which is part of the bharat_connect.invoice object.

ParametersTypeDescription
supply_typestringType of supply. Example: B2B
reverse_charge_taxstringReverse charge tax, if applicable. Example: ""
e_commerce_gstinstringE-commerce GSTIN, if applicable. Example: ""
igst_chargablestringIndicates if IGST is chargeable. Example: ""

Child Object: e_invoice_details

The table below lists the various parameters in the e_invoice_details object which is part of the bharat_connect.invoice object.

ParametersTypeDescription
irnstringInvoice Reference Number (IRN). Example: ""
irn_tsstringTimestamp of IRN generation. Example: ""

Child Object: items_details

The table below lists the various parameters in the items_details object which is part of the bharat_connect.invoice object.

ParametersTypeDescription
serial_nostringSerial number of the item. Example: 1
is_servicestringIndicates if the item is a service. Example: NO
hsn_codestringHSN code of the item. Example: 19059040
quantityintegerQuantity of the item. Example: 1
unit_priceintegerUnit price of the item. Example: 2
total_amountintegerTotal amount for the item. Example: 2
assessment_amountintegerAssessment amount for the item. Example: 2
gst_rateintegerGST rate applied to the item. Example: 18
total_item_valueintegerTotal value of the item, including GST. Example: 4
product_descriptionstringDescription of the product. Example: xyz description test

Child Object: response

The table below lists the various parameters in the response object which is part of the bharat_connect.invoice object.

ParametersTypeDescription
statusstringStatus of the response. Example: SUCCESS
messagestringMessage associated with the response. Example: ""