Enkash Developer Portal
Home
Home
Login
  1. Invoice
  • Back to home
  • Vendor Payment
  • APIs
    • Business Onboarding
      • Initiate Entity Check
      • Register Entity
      • Bharat Connect B2B ID Registration
      • Search Entity
    • Invoice
      • Create Invoice
        POST
      • Confirm Invoice
        POST
      • Change Invoice Status
        POST
      • Edit Invoice
        POST
    • Payment
      • Pay Invoice
      • Payment Confirmation
    • Purchase Order
      • Send Purchase Order Request
      • Confirm Purchase Order
      • Edit Purchase Order
      • Change Purchase Order Status
    • Credit Note
      • Send C/N Request
      • Confirm C/N Request
      • Status Change C/N Request
    • Financing
      • Request Financing
      • Share Bid
      • Respond To Bid
  • Webhook
    • Business Onboarding
      • Check Entity Webhook
      • Entity Registration Response Webhook
      • Search Entity Response Webhook
      • Registration ID Response Webhook
    • Invoice
      • Create Invoice Request Webhook
      • Create Invoice Response Webhook
      • Confirm Invoice Request Webhook
      • Confirm Invoice Response Webhook
      • Status Change Invoice Request
      • Status Change Invoice Response Webhook
      • Edit Invoice Request Webhook
      • Edit Invoice Response Webhook
    • Payment
      • Payment Response Webhook
      • Payment Confirmation Response Webhook
      • Payment Request Webhook
      • Payment Confirmation Request Webhook
    • Credit Note
      • Send C/N RequestWebhook
      • Send C/N Response Webhook
      • Confirm C/N Request Webhook
      • Confirm C/N Response Webhook
      • Status Change C/N Request Webhook
      • Status Change C/N Response Webhook
    • Purchase Order
      • Send Purchase Order Request Webhook
      • Send Purchase Order Response Webhook
      • Confirm Purchase Order Request Webhook
      • Confirm Purchase Order Response Webhook
      • Edit Purchase Order Request Webhook
      • Edit Purchase Order Response Webhook
      • Status Change Purchase Order Request Webhook
      • Status Change Purchase Order Response Webhook
    • Financing
      • Financing Response Webhook
      • Respond Bid Response Webhook
      • Share Bid Request Webhook
  1. Invoice

Create Invoice

POST
/api/v0/invoice/req-send-invoice
📌
Use this API to generate a new invoice through your EnKash account on the Bharat Connect Platform.
This allows you to create and issue invoices to your customers, specifying details such as invoice amount, due date, and customer information, which helps streamline your billing and collections process.

Request

Body Params application/json
device
object 
required
tag
object 
required
b2bIds
object 
required
buyerB2BId
string 
required
Match pattern:
^([^\\\"]){1,100}$
supplierB2BId
string 
required
Match pattern:
^([^\\\"]){1,100}$
invoice
object 
required
objectId
string 
required

Unique Identifier of
the invoice across all
entities, created by
the originator.
Format:
INV<ThreadID

Match pattern:
^[INV]{3}[A-Za-z0-9]{32,32}$
supplierInvoiceNumber
string 
required
Match pattern:
^([^\\\"]){1,50}$
objectVersion
object 
required
ts
string 
required
Timestamp at which
invoice was created.
2017-08-
10T17:57:35+05:30
statusTransition
object 
required
transactionDetails
object 
required
supplierDetails
object 
required
buyerDetails
object 
required
dispatchDetails
object 
optional
shippingDetails
object 
optional
itemLists
array [object {21}] 
required
valueDetails
object 
optional
supplierBankAccountDetails
object 
required
advancePaymentDetails
object 
optional
invoiceReferenceDetails
object 
optional
precedingInvoiceDetails
array [object {3}] 
optional
poDetails
array [object {3}] 
optional
contractReferenceDetails
array [object {6}] 
optional
additionalDocumentDetails
array [object {3}] 
optional
exportDetails
object 
optional
ewayBillDetail
object 
optional
recurringPayments
object 
optional
paymentMilestones
array [object {2}] 
optional
shippingTermsDetails
object 
optional
invoiceFinancingDetails
object 
optional
einvoiceResponse
string 
optional
eInvoiceInfo
object 
optional
Example
{
    "device": {
        "tag": {
            "name": "GEOCODE",
            "value": "string"
        }
    },
    "b2bIds": {
        "buyerB2BId": "string",
        "supplierB2BId": "string"
    },
    "invoice": {
        "objectId": "string",
        "supplierInvoiceNumber": "string",
        "objectVersion": {
            "currentVersion": 1,
            "newVersion": 1
        },
        "ts": "string",
        "statusTransition": {
            "currentStatus": "CREATED",
            "newStatus": "CREATED"
        },
        "transactionDetails": {
            "taxScheme": "GST",
            "supplyType": "B2B",
            "reverseChargeTax": "YES",
            "igstChargable": "YES",
            "ecommerceGstin": "string"
        },
        "supplierDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "buyerDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "placeOfSupply": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "dispatchDetails": {
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "shippingDetails": {
            "gstin": "string",
            "lglNm": "string",
            "trdNm": "string",
            "stateCode": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "itemLists": [
            {
                "serialno": "string",
                "productDescription": "string",
                "isService": "YES",
                "hsnCode": "string",
                "barCode": "string",
                "quantity": 0,
                "freeQuantity": 0,
                "unit": "string",
                "unitPrice": 0,
                "totalAmt": 0,
                "assessmentAmount": 0,
                "gstRate": 0,
                "totalItemValue": 0,
                "orderLineReference": "string",
                "originCountry": "string",
                "productSerialNumber": "string",
                "itemValueDetails": [
                    {
                        "type": "string",
                        "value": 0
                    }
                ],
                "rates": [
                    {
                        "type": "string",
                        "value": 0
                    }
                ],
                "batchDetails": {
                    "batchNumber": "string",
                    "expiryDate": "string",
                    "batchWarrantyDate": "string"
                },
                "attributeDetails": [
                    {
                        "name": "string",
                        "value": "string"
                    }
                ],
                "otherTaxes": [
                    {
                        "name": "string",
                        "rate": 0,
                        "amount": 0
                    }
                ]
            }
        ],
        "valueDetails": {
            "assessmentValue": 0,
            "totalInvoiceValue": 0,
            "otherValues": [
                {
                    "type": "string",
                    "value": 0
                }
            ]
        },
        "supplierBankAccountDetails": {
            "maskedAccountNumber": "string",
            "ifsc": "string",
            "beneficiaryName": "string",
            "businessVPA": "string"
        },
        "advancePaymentDetails": {
            "payeeName": "string",
            "mode": "string",
            "paymentTerms": "string",
            "paymentInstruction": "string",
            "creditTransfer": "string",
            "directDebit": "string",
            "creditDays": 0,
            "paidAmount": 0,
            "pendingDueAmount": 0
        },
        "invoiceReferenceDetails": {
            "invoiceRemarks": "string",
            "invoiceStartDate": "string",
            "invoiceEndDate": "string"
        },
        "precedingInvoiceDetails": [
            {
                "invoiceNumber": "string",
                "date": "string",
                "otherReferenceNo": "string"
            }
        ],
        "poDetails": [
            {
                "poObjId": "string",
                "buyerPoId": "string",
                "poDate": "string"
            }
        ],
        "contractReferenceDetails": [
            {
                "receiptAdviceNo": "string",
                "receiptAdviceDate": "string",
                "batchReferenceNo": "string",
                "contractReferenceNo": "string",
                "extraReferenceNo": "string",
                "projectReferenceNo": "string"
            }
        ],
        "additionalDocumentDetails": [
            {
                "url": "string",
                "document": "string",
                "info": "string"
            }
        ],
        "exportDetails": {
            "shipBillNo": "string",
            "shipBillDate": "string",
            "port": "string",
            "refundClaim": "string",
            "foreignCurrency": "string",
            "countryCode": "string",
            "exportDuty": 0
        },
        "ewayBillDetail": {
            "transporterId": "string",
            "transporterName": "string",
            "transportMode": "string",
            "distance": 0,
            "transportDocumentNo": "string",
            "transportDocumentDate": "string",
            "vehicleNo": "string",
            "vehicleType": "string"
        },
        "recurringPayments": {
            "originalInvoiceId": "string",
            "frequency": "string",
            "startDate": "string",
            "endDate": "string",
            "mandateDetails": "string",
            "mandateExecutionDate": "string",
            "mandateAmount": 0
        },
        "paymentMilestones": [
            {
                "milestoneDate": "string",
                "dueAmount": 0
            }
        ],
        "shippingTermsDetails": {
            "terms": "string",
            "bearingParty": "string",
            "charges": 0
        },
        "invoiceFinancingDetails": {
            "dueAmount": 0,
            "financingRequestAmount": 0
        },
        "einvoiceResponse": "string",
        "eInvoiceInfo": {
            "schemaVersion": "string",
            "irnNumber": "string",
            "irnTs": "string"
        }
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v0/invoice/req-send-invoice' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device": {
        "tag": {
            "name": "GEOCODE",
            "value": "string"
        }
    },
    "b2bIds": {
        "buyerB2BId": "string",
        "supplierB2BId": "string"
    },
    "invoice": {
        "objectId": "string",
        "supplierInvoiceNumber": "string",
        "objectVersion": {
            "currentVersion": 1,
            "newVersion": 1
        },
        "ts": "string",
        "statusTransition": {
            "currentStatus": "CREATED",
            "newStatus": "CREATED"
        },
        "transactionDetails": {
            "taxScheme": "GST",
            "supplyType": "B2B",
            "reverseChargeTax": "YES",
            "igstChargable": "YES",
            "ecommerceGstin": "string"
        },
        "supplierDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "buyerDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "placeOfSupply": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "dispatchDetails": {
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "shippingDetails": {
            "gstin": "string",
            "lglNm": "string",
            "trdNm": "string",
            "stateCode": "string",
            "address": {
                "type": "REGISTERED ADDRESS",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "ANDAMAN AND NICOBAR ISLANDS",
                "country": "INDIA",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "MOBILE",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "itemLists": [
            {
                "serialno": "string",
                "productDescription": "string",
                "isService": "YES",
                "hsnCode": "string",
                "barCode": "string",
                "quantity": 0,
                "freeQuantity": 0,
                "unit": "string",
                "unitPrice": 0,
                "totalAmt": 0,
                "assessmentAmount": 0,
                "gstRate": 0,
                "totalItemValue": 0,
                "orderLineReference": "string",
                "originCountry": "string",
                "productSerialNumber": "string",
                "itemValueDetails": [
                    {
                        "type": "string",
                        "value": 0
                    }
                ],
                "rates": [
                    {
                        "type": "string",
                        "value": 0
                    }
                ],
                "batchDetails": {
                    "batchNumber": "string",
                    "expiryDate": "string",
                    "batchWarrantyDate": "string"
                },
                "attributeDetails": [
                    {
                        "name": "string",
                        "value": "string"
                    }
                ],
                "otherTaxes": [
                    {
                        "name": "string",
                        "rate": 0,
                        "amount": 0
                    }
                ]
            }
        ],
        "valueDetails": {
            "assessmentValue": 0,
            "totalInvoiceValue": 0,
            "otherValues": [
                {
                    "type": "string",
                    "value": 0
                }
            ]
        },
        "supplierBankAccountDetails": {
            "maskedAccountNumber": "string",
            "ifsc": "string",
            "beneficiaryName": "string",
            "businessVPA": "string"
        },
        "advancePaymentDetails": {
            "payeeName": "string",
            "mode": "string",
            "paymentTerms": "string",
            "paymentInstruction": "string",
            "creditTransfer": "string",
            "directDebit": "string",
            "creditDays": 0,
            "paidAmount": 0,
            "pendingDueAmount": 0
        },
        "invoiceReferenceDetails": {
            "invoiceRemarks": "string",
            "invoiceStartDate": "string",
            "invoiceEndDate": "string"
        },
        "precedingInvoiceDetails": [
            {
                "invoiceNumber": "string",
                "date": "string",
                "otherReferenceNo": "string"
            }
        ],
        "poDetails": [
            {
                "poObjId": "string",
                "buyerPoId": "string",
                "poDate": "string"
            }
        ],
        "contractReferenceDetails": [
            {
                "receiptAdviceNo": "string",
                "receiptAdviceDate": "string",
                "batchReferenceNo": "string",
                "contractReferenceNo": "string",
                "extraReferenceNo": "string",
                "projectReferenceNo": "string"
            }
        ],
        "additionalDocumentDetails": [
            {
                "url": "string",
                "document": "string",
                "info": "string"
            }
        ],
        "exportDetails": {
            "shipBillNo": "string",
            "shipBillDate": "string",
            "port": "string",
            "refundClaim": "string",
            "foreignCurrency": "string",
            "countryCode": "string",
            "exportDuty": 0
        },
        "ewayBillDetail": {
            "transporterId": "string",
            "transporterName": "string",
            "transportMode": "string",
            "distance": 0,
            "transportDocumentNo": "string",
            "transportDocumentDate": "string",
            "vehicleNo": "string",
            "vehicleType": "string"
        },
        "recurringPayments": {
            "originalInvoiceId": "string",
            "frequency": "string",
            "startDate": "string",
            "endDate": "string",
            "mandateDetails": "string",
            "mandateExecutionDate": "string",
            "mandateAmount": 0
        },
        "paymentMilestones": [
            {
                "milestoneDate": "string",
                "dueAmount": 0
            }
        ],
        "shippingTermsDetails": {
            "terms": "string",
            "bearingParty": "string",
            "charges": 0
        },
        "invoiceFinancingDetails": {
            "dueAmount": 0,
            "financingRequestAmount": 0
        },
        "einvoiceResponse": "string",
        "eInvoiceInfo": {
            "schemaVersion": "string",
            "irnNumber": "string",
            "irnTs": "string"
        }
    }
}'

Responses

🟢200Success
application/json
Body
payload
string 
required
response_code
integer 
required
response_message
string 
required
Example
{
  "payload": "SUCCESS",
  "response_code": 0,
  "response_message": "SUCCESS"
}
Modified at 2025-07-08 19:19:07
Previous
Search Entity
Next
Confirm Invoice
Built with