- APIs
- Business Onboarding
- Invoice
- Payment
- Purchase Order
- Credit Note
- Financing
- Business Onboarding
- Webhook
- Business Onboarding
- Invoice
- Payment
- Credit Note
- 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
Send Purchase Order Request
Developing
POST
api/v0/purchase-order/req-send
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