Enkash APIs
HomePayment GatewayPayoutsCreate Account
HomePayment GatewayPayoutsCreate Account
Login
  1. Bharat Connect (BBPS)
  2. B2B Invoicing
  3. Invoice
  • EnKash Developer Portal Overview
  • Payment Gateway
    • Payment Gateway Overview
    • Payment Gateway Sign Up
    • Payment Methods
    • Supported Integrations
    • Payment Gateway APIs
    • Web Integration
    • Server to Server Integration
    • Test Card Details
    • Authorization
      • About Authorization
      • Get Authorization Token
        POST
    • Orders
      • About Order
      • Create Order
        POST
      • Get Order Status
        GET
      • Get BNPL Payment Modes
        GET
      • Get Dynamic QR Code
        GET
      • UPI Intent Links
        GET
    • Payments
      • About Payment
      • Submit Payment Detail
        POST
      • Get Transaction Status
        GET
      • Validate OTP
        POST
      • Resend OTP
        GET
      • Payment Notify Request
        POST
    • Refunds
      • About Refund
      • Refund
        POST
    • Settlements
      • About Settlement
      • Settlement Reporting
      • Get Settlement Payout By ID
        GET
      • Search Settlement Payouts
        POST
    • Split Settlements
      • About Split Settlements
      • Create Split Settlement Account
        POST
      • Update Split Settlement Account
        POST
      • Get All Split Settlement Account
        GET
      • Deactivate Split Settlement Account
        PATCH
      • Activate Split Settlement Account
        PATCH
      • Submit Payment with Split Details
        POST
      • Edit/Deferred Split Settlement
        POST
    • E-Commerce Plugins
    • Payment Links
    • Payment Button
    • Qr Code
      • Create Qr Code
        POST
      • Get QR Code
        GET
      • Search QR Code
        POST
      • createCustomer
        POST
      • searchCustomer
        POST
      • Cancel QR Code
        PATCH
    • UPI Mandate
      • Create UPI Mandate
        POST
      • Update UPI Mandate
        PATCH
      • Revoke UPI Mandate
        PATCH
      • Get UPI Mandate
        GET
      • UPI mandate create callback
        POST
      • Mandate Pre-debit Notification
        POST
      • Execute mandate debit
        POST
      • Mandate Debit callback
        POST
  • Payment Links
    • Payment Links Overview
    • Payment Link APIs
    • Payment Link
      • Create Payment Link
        POST
      • Get Payment Link Details
        GET
      • Delete Payment Link
        DELETE
    • Payment Link Webhook
      • Payment Link Webhook Request
        POST
  • Bharat Connect (BBPS)
    • About Bharat Connect
    • B2B Invoicing
      • Invoice
        • Create Invoice
          POST
        • Confirm Invoice
          POST
        • Status Change Invoice
          POST
        • Edit Invoice
          POST
      • Payment
        • Pay Invoices
          POST
        • Payment Confirmation
          POST
      • Financing
        • Request Financing
          POST
        • Share Bid
          POST
        • Respond Bid
          POST
      • Onboarding
        • Register Check Entity
          POST
        • Search Entity
          POST
        • Register Entity
          POST
        • Registration Id
          POST
      • cdNote
        • Send CdNote Request
          POST
        • Confirm CdNote Request
          POST
        • Status Change CdNote Request
          POST
      • Purchase Order
        • Send Purchase Order Request
          POST
        • Confirm Purchase Order Request
          POST
        • Edit Purchase Order Request
          POST
        • Status Change Purchase Order Request
          POST
      • webhook-invoice
        • Webhook Create Invoice Request
          POST
        • Webhook Create Invoice Response
          POST
        • Webhook Confirm Invoice Request
          POST
        • Webhook Confirm Invoice Response
          POST
        • Webhook Status Change Invoice Request
          POST
        • Webhook Status Change Invoice Response
          POST
        • Webhook Edit Invoice Request
          POST
        • Webhook Edit Invoice Response
          POST
      • webhook-payments
        • Webhook Payment Request
          POST
        • Webhook Payment Confirmation Request
          POST
        • Webhook Payment Response
          POST
        • Webhook Payment Confirmation Response
          POST
      • webhook-business-onboarding
        • Webhook Check Entity Response
          POST
        • Webhook Register Entity Response
          POST
        • Webhook Search Entity Response
          POST
        • Webhook Registration Id Response
          POST
      • webhook-financing
        • Webhook Financing Response
          POST
        • Webhook Respond Bid Response
          POST
        • Webhook Share Bid Request
          POST
      • webhook-cdNote
        • Webhook Send CdNote Request
          POST
        • Webhook Send CdNote Response
          POST
        • Webhook Confirm CdNote Request
          POST
        • Webhook Confirm CdNote Response
          POST
        • Webhook Status Change CdNote Request
          POST
        • Webhook Status Change CdNote Response
          POST
      • Webhook Purchase Order
        • Webhook Send Purchase Order Request
          POST
        • Webhook Send Purchase Order Response
          POST
        • Webhook Confirm Purchase Order Request
          POST
        • Webhook Confirm Purchase Order Response
          POST
        • Webhook Edit Purchase Order Request
          POST
        • Webhook Edit Purchase Order Response
          POST
        • Webhook Status Change Purchase Order Request
          POST
        • Webhook Status Change Purchase Order Response
          POST
    • Bill Payments
      • Bill Payments Overview
      • Get Authentication Token
        POST
      • Get BillerTypes
        GET
      • Get Billers
        GET
      • Fetch Bill
        POST
      • Create Bill API
        POST
      • Create Bill Without Bill Fetch
        POST
      • Bill Payment
        POST
      • Utility Bill Approval API
        PUT
      • Get Utility Bill Status
        GET
      • Get Utility Bill by Reference Id
        GET
      • Get Utility Bills Detail
        POST
      • Bill Payment Webhook
        POST
  • Payouts
    • Payouts Overview
    • Payouts Sign Up
    • Payout Methods
    • Payout API Response Codes
    • Payouts Integration Steps
    • Encrypting and Decrypting Payload
    • Payouts Status Codes
    • Get Authentication Token
      • Get Authentication Token
        POST
    • Beneficiary Apis
      • Create Beneficiary
        POST
      • Search Beneficiary
        POST
      • Delete Beneficiary
        DELETE
    • Transfer Apis
      • Create Payout
        POST
      • Search Payouts
        POST
      • Create Batch Payout
        POST
    • Payout Account Apis
      • Get Balance
        GET
      • Get Source Bank Account Details
        GET
      • Add Source Bank Account
        POST
    • Webhook Data Apis
      • Get Webhook Data
        GET
      • Create Webhook Data
        POST
  • Accounts Payable Management Tool
    • About AP Management Tool
    • Vendor Management
      • Create Vendor
        POST
      • Create Bulk Vendors
        POST
      • Update Bulk Vendors
        PUT
      • Get Beneficiaries (V1)
        POST
      • Get Beneficiaries
        POST
      • Change Vendor Status
        PATCH
      • Get Beneficiary
        GET
    • Invoice Management
      • Payout Apis
        • validateInvoices
          POST
        • initiate
          POST
        • Search Payouts V1
          POST
        • bulkCreatePayout
          POST
        • Create Payout
          POST
        • Update Payouts
          PATCH
        • Search Payouts
          POST
        • createBulkPayoutForPartnerIntegration
          POST
        • Update Bulk Payouts
          PATCH
        • Update Approval Status
          PATCH
        • Get Invoice Data
          GET
        • Delete Payout
          DELETE
    • Bharat Connect 2.0 AP
      • Confirm Invoice Request
        POST
      • Payment Request
        POST
    • Update Beneficiary
      PUT
  • Account Receivable
    • Accounts Receivable Overview
    • Get Authentication Token Copy
      • Get Authentication Token
        POST
    • Customer Management
      • Customer Apis
        • Activate customer
          PUT
        • createBulkCustomer
          POST
        • bulkUpdate
          POST
        • Deactivate customer
          PUT
        • deleteCustomerByCustomerId
          DELETE
        • updateCustomer
          PATCH
    • Customer Contacts Management
      • Customer Apis
        • getCustomerContactDetails
          GET
    • Invoice Management
      • invoice-controller
        • createInvoice
          POST
        • invoiceBulkUpload
          POST
        • Dispatch Invoice Collection
          POST
        • Delete Invoice Collection
          POST
        • searchCollectionInvoices
          POST
        • getInvoice
          GET
        • updateInvoice
          PATCH
    • Payment Reminders
      • customer-reminder-controller
        • createCustomerReminder
          POST
        • getCustomerReminders
          POST
        • getCustomerReminder
          GET
        • deleteReminder
          DELETE
        • updateCustomerReminder
          PATCH
    • Bharat Connect 2.0 AR
      • Payment Confirmation Request
        POST
      • Change Invoice Status Request
        POST
      • Bulk Create Invoice
        POST
  • Expense Management
    • Expense Management Overview
    • Sign Up - Expense Management
    • Token Api
      • About Authorization
      • Token API
        POST
    • Expenses
      POST
    • Advance
      POST
  • Loyalty
    • Overview
    • Sign Up
    • Employee R&R
      • API Integration Guide
      • Common Fields passed in API requests
      • Token Api
        • Client Authentication
          POST
        • SSO LOGIN (Single Sign On)
          POST
      • Create And Allocate point
        POST
      • Bulk Create And Allocate Points
        POST
      • Get Card Account Details
        POST
      • Get Transaction details
        POST
      • List Users Details
        POST
      • Get User Card Details
        POST
    • Channel Incentives
      • Incentive Create And Allocate point
        POST
      • Reward Get Transaction details
        POST
      • Incentive Get User Details
        POST
    • Points Redemption
      • User Authentication
        POST
      • Get Cart for User
        GET
      • Search Catalog
        POST
      • Get Product Catalog Details
        GET
      • Get Product Configs (Denominations)
        GET
      • Add to cart
        POST
      • Update Cart
        PATCH
      • Create Order
        POST
      • Order Search
        POST
      • create order
        POST
      • Fetch Order Info by Partner order Reference id
        POST
    • Point Management APIs
      • Overview
      • Create Event
        POST
      • Get Event
        GET
      • Update Event
        PATCH
      • Allocate Coins
        POST
      • Get Balance
        GET
  • Card Management
    • EnKash Card Management Systems Overview
    • Cards We Issue
    • API Reference
    • VKYC
    • Developer Guide
    • Cards Integration Steps
    • Encryption / Decryption of API requests / Response
    • Encryption & Decryption Guide
    • Token Api
      • Partner auth Token
        POST
    • Gift Card
      • Create
        POST
      • Request Physical
        POST
      • Block
        POST
      • Replace
        POST
      • Get User Details
        POST
      • Get Transaction Details
        POST
      • Get All Transaction details
        POST
    • Meal Cards
      • Create
        POST
      • Load Balance
        POST
      • Replace
        POST
      • Block
        POST
      • Request Physical
        POST
      • Get User Card Details
        POST
      • Get Transaction Details
        POST
      • Get All Transaction details
        POST
    • Prepaid Cards
      • Create
        POST
      • Load Balance
        POST
      • Replace
        POST
      • Block
        POST
      • Request Physical
        POST
      • Get User Card Details
        POST
      • Get Transaction Details
        POST
      • Get All Transaction details
        POST
    • Fuel_cards
      • Create
        POST
      • Load Balance
        POST
      • Replace
        POST
      • Block
        POST
      • Physical
        POST
      • Get User Card Details
        POST
      • Get Transaction Details
        POST
      • Get All Transaction details
        POST
    • Advance Card Feature
      • Create Card Account
        POST
      • Set Pin
        POST
      • Get Card Account Details
        POST
      • Generate Otp Card
        POST
      • View Card
        POST
      • Update Card Velocity Rules
        POST
      • Get Card Velocity Rules
        POST
  • Verification Suite
    • Verification Suite Overview
    • Bank Account Verification
      • Bank Account Verification PennyLess/PennyDrop
        POST
    • GSTN Verification
      • Gstin Verification
        GET
    • PAN Verification
      • Pan Verification
        GET
    • UPI(VPA) Verification
      • Vpa Verification
        POST
  1. Bharat Connect (BBPS)
  2. B2B Invoicing
  3. Invoice

Create Invoice

POST
/api/v0/invoice/req-send-invoice

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 ''

Responses

🟢200Success
application/json
Body
payload
string 
required
response_code
integer 
required
response_message
string 
required
Example
{
  "payload": "string",
  "response_code": 0,
  "response_message": "string"
}
Modified at 2024-10-10 08:29:16
Previous
About Bharat Connect
Next
Confirm Invoice
Built with