Skip to main content
POST
/
api
/
v1
/
purchase-orders
/
fixed-cost
Create Purchase Order
curl --request POST \
  --url https://api.example.com/api/v1/purchase-orders/fixed-cost \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "draft",
  "purpose": "<string>",
  "expenseCategory": "<string>",
  "frequency": "<string>",
  "id": "<string>",
  "vendorId": "<string>",
  "employeeId": "<string>",
  "referenceNumber": "<string>",
  "currency": "USD",
  "items": [],
  "internalNotes": "<string>",
  "changeDescription": "<string>"
}
'
{
  "success": true,
  "message": "<string>",
  "id": "<string>",
  "internalId": "<string>",
  "versionNumber": 123,
  "status": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

X-User-Id
string | null

Body

application/json

Input schema for creating/updating a Fixed Cost Purchase Order.

POST /purchase-orders/fixed-cost

  • action: "draft" saves without validation, "submit" validates fully
  • id: None = create new, provided = update existing (creates new version)
action
enum<string>
required

Actions for Purchase Order state transitions.

Permissions:

  • draft, submit: Any authenticated user
  • approve, reject, cancel: Manager or Admin only
Available options:
draft,
submit,
approve,
reject,
cancel
purpose
string
required
expenseCategory
string
required
frequency
string
required
id
string | null
vendorId
string | null
employeeId
string | null
referenceNumber
string | null
currency
string
default:USD
items
FixedCostLineItemInput · object[]
internalNotes
string | null
changeDescription
string | null

Response

Successful Response

Response after creating/updating a Fixed Cost PO

success
boolean
required
message
string
required
id
string
required
internalId
string
required
versionNumber
integer
required
status
string
required