Enkash Developer Portal
Home
Home
Login
  1. Purchase Order
  • Back to home
  • Vendor Payment
  • APIs
    • Business Onboarding
      • Initiate Entity Check
      • Register Entity
      • Bharat Connect B2B ID Registration
      • Search Entity
    • Invoice
      • Create Invoice
      • Confirm Invoice
      • Change Invoice Status
      • Edit Invoice
    • Payment
      • Pay Invoice
      • Payment Confirmation
    • Purchase Order
      • Send Purchase Order Request
        POST
      • Confirm Purchase Order
        POST
      • Edit Purchase Order
        POST
      • Change Purchase Order Status
        POST
    • 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. Purchase Order

Send Purchase Order Request

Developing
POST
api/v0/purchase-order/req-send
📌
Use this API to create and send a purchase order (PO) request from your EnKash account via the Bharat Connect Channel
This allows you to formally request goods or services from your suppliers, complete with details like items, quantities, pricing, and delivery instructions - streamlining your procurement process.

Request

Body Params application/json
device
object 
required
tag
object 
required
b2bIds
object 
required
buyerB2BId
string 
required
supplierB2BId
string 
required
purchaseOrder
object 
required
objectId
string 
required
buyerPONumber
string 
required
ts
string 
required
orderDate
string 
required
deliveryDate
string 
required
subject
string 
required
objectVersion
object 
required
poStatusTransition
object 
required
supplierDetails
object 
required
buyerDetails
object 
required
addressDetails
array [object {2}] 
required
itemLists
array [object {21}] 
required
poValueDetails
object 
required
poInfos
array [object {2}] 
required
contractReferenceDetails
array [object {6}] 
required
additionalDocumentDetails
array [object {3}] 
required
paymentMilestones
array [object {2}] 
required
shippingTermsDetails
object 
required
additionalInfos
array [object {2}] 
required
name
string 
optional
value
string 
optional
Example
{
    "device": {
        "tag": {
            "name": "GEOCODE",
            "value": "string"
        }
    },
    "b2bIds": {
        "buyerB2BId": "string",
        "supplierB2BId": "string"
    },
    "purchaseOrder": {
        "objectId": "string",
        "buyerPONumber": "string",
        "ts": "string",
        "orderDate": "string",
        "deliveryDate": "string",
        "subject": "string",
        "objectVersion": {
            "currentVersion": 0,
            "newVersion": 0
        },
        "poStatusTransition": {
            "currentStatus": "CREATED",
            "newStatus": "CREATED"
        },
        "supplierDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "address": {
                "type": "string",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "string",
                "country": "string",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "string",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "buyerDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "placeOfSupply": "string",
            "address": {
                "type": "string",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "string",
                "country": "string",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "string",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "addressDetails": [
            {
                "addressType": "string",
                "address": {
                    "type": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "city": "string",
                    "state": "string",
                    "country": "string",
                    "pincode": "string"
                }
            }
        ],
        "itemLists": [
            {
                "serialno": "string",
                "productDescription": "string",
                "isService": "string",
                "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
                    }
                ]
            }
        ],
        "poValueDetails": {
            "totalPOValue": 0,
            "otherValues": [
                {
                    "type": "string",
                    "value": 0
                }
            ]
        },
        "poInfos": [
            {
                "detailType": "string",
                "detailValue": "string"
            }
        ],
        "contractReferenceDetails": [
            {
                "receiptAdviceNo": "string",
                "receiptAdviceDate": "string",
                "batchReferenceNo": "string",
                "contractReferenceNo": "string",
                "extraReferenceNo": "string",
                "projectReferenceNo": "string"
            }
        ],
        "additionalDocumentDetails": [
            {
                "url": "string",
                "document": "string",
                "info": "string"
            }
        ],
        "paymentMilestones": [
            {
                "milestoneDate": "string",
                "dueAmount": 0
            }
        ],
        "shippingTermsDetails": {
            "terms": "string",
            "bearingParty": "string",
            "charges": 0
        }
    },
    "additionalInfos": [
        {
            "name": "string",
            "value": "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/purchase-order/req-send' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device": {
        "tag": {
            "name": "GEOCODE",
            "value": "string"
        }
    },
    "b2bIds": {
        "buyerB2BId": "string",
        "supplierB2BId": "string"
    },
    "purchaseOrder": {
        "objectId": "string",
        "buyerPONumber": "string",
        "ts": "string",
        "orderDate": "string",
        "deliveryDate": "string",
        "subject": "string",
        "objectVersion": {
            "currentVersion": 0,
            "newVersion": 0
        },
        "poStatusTransition": {
            "currentStatus": "CREATED",
            "newStatus": "CREATED"
        },
        "supplierDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "address": {
                "type": "string",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "string",
                "country": "string",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "string",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "buyerDetails": {
            "b2bId": "string",
            "gstin": "string",
            "legalName": "string",
            "tradeName": "string",
            "stateCode": "string",
            "placeOfSupply": "string",
            "address": {
                "type": "string",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "string",
                "country": "string",
                "pincode": "string"
            },
            "contactNumber": {
                "type": "string",
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "string"
        },
        "addressDetails": [
            {
                "addressType": "string",
                "address": {
                    "type": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "city": "string",
                    "state": "string",
                    "country": "string",
                    "pincode": "string"
                }
            }
        ],
        "itemLists": [
            {
                "serialno": "string",
                "productDescription": "string",
                "isService": "string",
                "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
                    }
                ]
            }
        ],
        "poValueDetails": {
            "totalPOValue": 0,
            "otherValues": [
                {
                    "type": "string",
                    "value": 0
                }
            ]
        },
        "poInfos": [
            {
                "detailType": "string",
                "detailValue": "string"
            }
        ],
        "contractReferenceDetails": [
            {
                "receiptAdviceNo": "string",
                "receiptAdviceDate": "string",
                "batchReferenceNo": "string",
                "contractReferenceNo": "string",
                "extraReferenceNo": "string",
                "projectReferenceNo": "string"
            }
        ],
        "additionalDocumentDetails": [
            {
                "url": "string",
                "document": "string",
                "info": "string"
            }
        ],
        "paymentMilestones": [
            {
                "milestoneDate": "string",
                "dueAmount": 0
            }
        ],
        "shippingTermsDetails": {
            "terms": "string",
            "bearingParty": "string",
            "charges": 0
        }
    },
    "additionalInfos": [
        {
            "name": "string",
            "value": "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:29:19
Previous
Payment Confirmation
Next
Confirm Purchase Order
Built with