# Send Purchase Order Request

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/purchase-order/req-send:
    post:
      summary: Send Purchase Order Request
      deprecated: false
      description: >-
        📌

        :::highlight purple 

        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.

        :::
      tags:
        - Bharat Connect (BBPS)/APIs - BBPS/Vendor Payment/Purchase Order
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendPurchaseOrderRequest'
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  payload:
                    type: string
                  response_code:
                    type: integer
                  response_message:
                    type: string
                required:
                  - payload
                  - response_code
                  - response_message
                x-apidog-orders:
                  - payload
                  - response_code
                  - response_message
                x-apidog-ignore-properties: []
              example:
                payload: SUCCESS
                response_code: 0
                response_message: SUCCESS
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Bharat Connect (BBPS)/APIs - BBPS/Vendor Payment/Purchase Order
      x-apidog-status: developing
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-10669365-run
components:
  schemas:
    SendPurchaseOrderRequest:
      type: object
      properties:
        device:
          type: object
          properties:
            tag:
              type: object
              properties:
                name:
                  type: string
                  enum:
                    - GEOCODE
                    - IP
                    - AGENTID
                  x-apidog-enum:
                    - value: GEOCODE
                      name: ''
                      description: ''
                    - value: IP
                      name: ''
                      description: ''
                    - value: AGENTID
                      name: ''
                      description: ''
                value:
                  type: string
              required:
                - name
                - value
              x-apidog-orders:
                - name
                - value
              x-apidog-ignore-properties: []
          required:
            - tag
          x-apidog-orders:
            - tag
          x-apidog-ignore-properties: []
        b2bIds:
          type: object
          properties:
            buyerB2BId:
              type: string
            supplierB2BId:
              type: string
          required:
            - buyerB2BId
            - supplierB2BId
          x-apidog-orders:
            - buyerB2BId
            - supplierB2BId
          x-apidog-ignore-properties: []
        purchaseOrder:
          type: object
          properties:
            objectId:
              type: string
            buyerPONumber:
              type: string
            ts:
              type: string
            orderDate:
              type: string
            deliveryDate:
              type: string
            subject:
              type: string
            objectVersion:
              type: object
              properties:
                currentVersion:
                  type: integer
                newVersion:
                  type: integer
              required:
                - currentVersion
                - newVersion
              x-apidog-orders:
                - currentVersion
                - newVersion
              x-apidog-ignore-properties: []
            poStatusTransition:
              type: object
              properties:
                currentStatus:
                  type: string
                  enum:
                    - CREATED
                    - SENT TO BUYER
                    - ACCEPTED
                    - REJECTED
                    - UNDER REVIEW
                    - CANCELLED
                    - DELETED
                    - PARTIALLY PAID
                    - FULLY PAID
                    - CLOSED
                    - ABANDONED
                    - PAYMENT INITIATED
                    - PARTIALLY PAID AND PAYMENT INITIATED
                  x-apidog-enum:
                    - value: CREATED
                      name: ''
                      description: ''
                    - value: SENT TO BUYER
                      name: ''
                      description: ''
                    - value: ACCEPTED
                      name: ''
                      description: ''
                    - value: REJECTED
                      name: ''
                      description: ''
                    - value: UNDER REVIEW
                      name: ''
                      description: ''
                    - value: CANCELLED
                      name: ''
                      description: ''
                    - value: DELETED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID
                      name: ''
                      description: ''
                    - value: FULLY PAID
                      name: ''
                      description: ''
                    - value: CLOSED
                      name: ''
                      description: ''
                    - value: ABANDONED
                      name: ''
                      description: ''
                    - value: PAYMENT INITIATED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID AND PAYMENT INITIATED
                      name: ''
                      description: ''
                newStatus:
                  type: string
                  enum:
                    - CREATED
                    - SENT TO BUYER
                    - ACCEPTED
                    - REJECTED
                    - UNDER REVIEW
                    - CANCELLED
                    - DELETED
                    - PARTIALLY PAID
                    - FULLY PAID
                    - CLOSED
                    - ABANDONED
                    - PAYMENT INITIATED
                    - PARTIALLY PAID AND PAYMENT INITIATED
                  x-apidog-enum:
                    - value: CREATED
                      name: ''
                      description: ''
                    - value: SENT TO BUYER
                      name: ''
                      description: ''
                    - value: ACCEPTED
                      name: ''
                      description: ''
                    - value: REJECTED
                      name: ''
                      description: ''
                    - value: UNDER REVIEW
                      name: ''
                      description: ''
                    - value: CANCELLED
                      name: ''
                      description: ''
                    - value: DELETED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID
                      name: ''
                      description: ''
                    - value: FULLY PAID
                      name: ''
                      description: ''
                    - value: CLOSED
                      name: ''
                      description: ''
                    - value: ABANDONED
                      name: ''
                      description: ''
                    - value: PAYMENT INITIATED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID AND PAYMENT INITIATED
                      name: ''
                      description: ''
              required:
                - currentStatus
                - newStatus
              x-apidog-orders:
                - currentStatus
                - newStatus
              x-apidog-ignore-properties: []
            supplierDetails:
              type: object
              properties:
                b2bId:
                  type: string
                gstin:
                  type: string
                legalName:
                  type: string
                tradeName:
                  type: string
                stateCode:
                  type: string
                address:
                  type: object
                  properties:
                    type:
                      type: string
                    addressLine1:
                      type: string
                    addressLine2:
                      type: string
                    city:
                      type: string
                    state:
                      type: string
                    country:
                      type: string
                    pincode:
                      type: string
                  required:
                    - type
                    - addressLine1
                    - addressLine2
                    - city
                    - state
                    - country
                    - pincode
                  x-apidog-orders:
                    - type
                    - addressLine1
                    - addressLine2
                    - city
                    - state
                    - country
                    - pincode
                  x-apidog-ignore-properties: []
                contactNumber:
                  type: object
                  properties:
                    type:
                      type: string
                    countryCode:
                      type: string
                    phoneNumber:
                      type: string
                  required:
                    - type
                    - countryCode
                    - phoneNumber
                  x-apidog-orders:
                    - type
                    - countryCode
                    - phoneNumber
                  x-apidog-ignore-properties: []
                email:
                  type: string
              required:
                - b2bId
                - gstin
                - legalName
                - tradeName
                - stateCode
                - address
                - contactNumber
                - email
              x-apidog-orders:
                - b2bId
                - gstin
                - legalName
                - tradeName
                - stateCode
                - address
                - contactNumber
                - email
              x-apidog-ignore-properties: []
            buyerDetails:
              type: object
              properties:
                b2bId:
                  type: string
                gstin:
                  type: string
                legalName:
                  type: string
                tradeName:
                  type: string
                stateCode:
                  type: string
                placeOfSupply:
                  type: string
                address:
                  type: object
                  properties:
                    type:
                      type: string
                    addressLine1:
                      type: string
                    addressLine2:
                      type: string
                    city:
                      type: string
                    state:
                      type: string
                    country:
                      type: string
                    pincode:
                      type: string
                  required:
                    - type
                    - addressLine1
                    - addressLine2
                    - city
                    - state
                    - country
                    - pincode
                  x-apidog-orders:
                    - type
                    - addressLine1
                    - addressLine2
                    - city
                    - state
                    - country
                    - pincode
                  x-apidog-ignore-properties: []
                contactNumber:
                  type: object
                  properties:
                    type:
                      type: string
                    countryCode:
                      type: string
                    phoneNumber:
                      type: string
                  required:
                    - type
                    - countryCode
                    - phoneNumber
                  x-apidog-orders:
                    - type
                    - countryCode
                    - phoneNumber
                  x-apidog-ignore-properties: []
                email:
                  type: string
              required:
                - b2bId
                - gstin
                - legalName
                - tradeName
                - stateCode
                - placeOfSupply
                - address
                - contactNumber
                - email
              x-apidog-orders:
                - b2bId
                - gstin
                - legalName
                - tradeName
                - stateCode
                - placeOfSupply
                - address
                - contactNumber
                - email
              x-apidog-ignore-properties: []
            addressDetails:
              type: array
              items:
                type: object
                properties:
                  addressType:
                    type: string
                  address:
                    type: object
                    properties:
                      type:
                        type: string
                      addressLine1:
                        type: string
                      addressLine2:
                        type: string
                      city:
                        type: string
                      state:
                        type: string
                      country:
                        type: string
                      pincode:
                        type: string
                    required:
                      - type
                      - addressLine1
                      - addressLine2
                      - city
                      - state
                      - country
                      - pincode
                    x-apidog-orders:
                      - type
                      - addressLine1
                      - addressLine2
                      - city
                      - state
                      - country
                      - pincode
                    x-apidog-ignore-properties: []
                x-apidog-orders:
                  - addressType
                  - address
                x-apidog-ignore-properties: []
            itemLists:
              type: array
              items:
                type: object
                properties:
                  serialno:
                    type: string
                  productDescription:
                    type: string
                  isService:
                    type: string
                  hsnCode:
                    type: string
                  barCode:
                    type: string
                  quantity:
                    type: number
                  freeQuantity:
                    type: number
                  unit:
                    type: string
                  unitPrice:
                    type: number
                  totalAmt:
                    type: number
                  assessmentAmount:
                    type: number
                  gstRate:
                    type: number
                  totalItemValue:
                    type: number
                  orderLineReference:
                    type: string
                  originCountry:
                    type: string
                  productSerialNumber:
                    type: string
                  itemValueDetails:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        value:
                          type: number
                      x-apidog-orders:
                        - type
                        - value
                      x-apidog-ignore-properties: []
                  rates:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        value:
                          type: number
                      x-apidog-orders:
                        - type
                        - value
                      x-apidog-ignore-properties: []
                  batchDetails:
                    type: object
                    properties:
                      batchNumber:
                        type: string
                      expiryDate:
                        type: string
                      batchWarrantyDate:
                        type: string
                    required:
                      - batchNumber
                      - expiryDate
                      - batchWarrantyDate
                    x-apidog-orders:
                      - batchNumber
                      - expiryDate
                      - batchWarrantyDate
                    x-apidog-ignore-properties: []
                  attributeDetails:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        value:
                          type: string
                      x-apidog-orders:
                        - name
                        - value
                      x-apidog-ignore-properties: []
                  otherTaxes:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        rate:
                          type: number
                        amount:
                          type: number
                      x-apidog-orders:
                        - name
                        - rate
                        - amount
                      x-apidog-ignore-properties: []
                x-apidog-orders:
                  - serialno
                  - productDescription
                  - isService
                  - hsnCode
                  - barCode
                  - quantity
                  - freeQuantity
                  - unit
                  - unitPrice
                  - totalAmt
                  - assessmentAmount
                  - gstRate
                  - totalItemValue
                  - orderLineReference
                  - originCountry
                  - productSerialNumber
                  - itemValueDetails
                  - rates
                  - batchDetails
                  - attributeDetails
                  - otherTaxes
                x-apidog-ignore-properties: []
            poValueDetails:
              type: object
              properties:
                totalPOValue:
                  type: number
                otherValues:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      value:
                        type: number
                    x-apidog-orders:
                      - type
                      - value
                    x-apidog-ignore-properties: []
              required:
                - totalPOValue
                - otherValues
              x-apidog-orders:
                - totalPOValue
                - otherValues
              x-apidog-ignore-properties: []
            poInfos:
              type: array
              items:
                type: object
                properties:
                  detailType:
                    type: string
                  detailValue:
                    type: string
                x-apidog-orders:
                  - detailType
                  - detailValue
                x-apidog-ignore-properties: []
            contractReferenceDetails:
              type: array
              items:
                type: object
                properties:
                  receiptAdviceNo:
                    type: string
                  receiptAdviceDate:
                    type: string
                  batchReferenceNo:
                    type: string
                  contractReferenceNo:
                    type: string
                  extraReferenceNo:
                    type: string
                  projectReferenceNo:
                    type: string
                x-apidog-orders:
                  - receiptAdviceNo
                  - receiptAdviceDate
                  - batchReferenceNo
                  - contractReferenceNo
                  - extraReferenceNo
                  - projectReferenceNo
                x-apidog-ignore-properties: []
            additionalDocumentDetails:
              type: array
              items:
                type: object
                properties:
                  url:
                    type: string
                  document:
                    type: string
                  info:
                    type: string
                x-apidog-orders:
                  - url
                  - document
                  - info
                x-apidog-ignore-properties: []
            paymentMilestones:
              type: array
              items:
                type: object
                properties:
                  milestoneDate:
                    type: string
                  dueAmount:
                    type: number
                x-apidog-orders:
                  - milestoneDate
                  - dueAmount
                x-apidog-ignore-properties: []
            shippingTermsDetails:
              type: object
              properties:
                terms:
                  type: string
                bearingParty:
                  type: string
                charges:
                  type: number
              required:
                - terms
                - bearingParty
                - charges
              x-apidog-orders:
                - terms
                - bearingParty
                - charges
              x-apidog-ignore-properties: []
          required:
            - objectId
            - buyerPONumber
            - ts
            - orderDate
            - deliveryDate
            - subject
            - objectVersion
            - poStatusTransition
            - supplierDetails
            - buyerDetails
            - addressDetails
            - itemLists
            - poValueDetails
            - poInfos
            - contractReferenceDetails
            - additionalDocumentDetails
            - paymentMilestones
            - shippingTermsDetails
          x-apidog-orders:
            - objectId
            - buyerPONumber
            - ts
            - orderDate
            - deliveryDate
            - subject
            - objectVersion
            - poStatusTransition
            - supplierDetails
            - buyerDetails
            - addressDetails
            - itemLists
            - poValueDetails
            - poInfos
            - contractReferenceDetails
            - additionalDocumentDetails
            - paymentMilestones
            - shippingTermsDetails
          x-apidog-ignore-properties: []
        additionalInfos:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              value:
                type: string
            x-apidog-orders:
              - name
              - value
            x-apidog-ignore-properties: []
      required:
        - device
        - b2bIds
        - purchaseOrder
        - additionalInfos
      x-apidog-orders:
        - device
        - b2bIds
        - purchaseOrder
        - additionalInfos
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```