Docs

Create Purchase Order

POST

Body

Arguments
array of objectrequired

Purchase order batch items.

stringrequired

Company code. Required; must be a valid company.

string

Purchase order number. Required; leave blank to auto-assign the next PO number.

stringrequired

Vendor code. Required; valid vendor code must exist in the company.

string

Warehouse code. Required unless no non-direct cost detail records are included.

string

Job number. Required unless a valid warehouse code is defined and there are no direct job cost detail records.

string

VAT code. Must exist in the company when used.

string

PO status. P = Proposed, O = Open, C = Closed. Blank defaults to Proposed.

string

Cost center code. Must be valid if cost centers are enabled.

string

Remarks code or free text, up to 29 characters.

string

Special instructions code or free text, up to 29 characters.

string

Ship-to code. D = Default, J = Job, I = Input. Blank defaults to D.

string

Ship-to name. Required when ship-to code is I.

string

Ship-to address line 1. Required when ship-to code is I.

string

Ship-to address line 2.

string

Ship-to city. Required when ship-to code is I.

string

Ship-to state. Required when ship-to code is I.

string

Ship-to postal code. Required when ship-to code is I.

string

Ship via code or free text. Blank defaults from Purchase Order Installation.

string

Shipping terms code or free text. Blank defaults from Purchase Order Installation.

string

FOB text. Blank defaults from Purchase Order Installation.

string

Ordered by, up to 20 characters.

string

Confirmed by. Blank defaults from Purchase Order Installation.

string

Order date in MM/DD/CCYY format. Blank defaults to the current PO processing date.

string

Batch code. Blank defaults to the operator code from Authorization_ID.

string

Payment terms basis. A = Based on invoice date, B = Based on first of next month.

number

Payment number of days. Must be non-negative.

string

Discount due basis. A = Based on invoice date, B = Based on first of next month.

number

Discount number of days. Must be non-negative.

number

Discount percent. Enter 12.34 for 12.34%; must be non-negative.

string

Terms description, up to 20 characters. Constructed automatically when blank.

string

For resale flag. Y = For resale, N = Not for resale.

string

Default sales/use tax code. Must exist in the company when used.

string

Routing code. Must exist in the company when used.

string

Delivery date in MM/DD/CCYY format.

string

Receiving method. Must be 1 or 2 when supplied.

string

Pricing type. U = Unit price, L = Lump sum.

string

Credit card account code. Must be a credit-card type account when used.

string

Card number. Required if the account tracks card numbers.

string

Header comment, up to 250 characters.

array of object

Purchase order detail lines.

string

Detail entry type. D = Defined item code, N = Non-stock item, M = Message-only.

number

Quantity. Required and non-zero unless this is a message-only line.

string

Item ID. Required unless this is a message-only line.

string

Item description. Used for non-stock items; stock item descriptions default from inventory item master.

string

Unit of measure, up to 3 characters.

number

Item price. Blank defaults using Spectrum purchase order rules.

number

Line discount percent. Enter 12.34 for 12.34%; must be non-negative.

string

G/L account. Required unless this is a message-only line.

string

Phase code. Required unless this is a message-only line or non-job purchase.

string

Cost type. Required unless this is a message-only line or non-job purchase.

string

Detail sales/use tax code. Must exist in the company when used.

string

Detail delivery date in MM/DD/CCYY format.

string

Message text. Required for message-only lines; up to 250 characters.

string

Detail cost center. Must be valid if cost centers are enabled.

Field selectionChoose which fields should be included in the response. Learn more
string

Comma-separated response fields to include.

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is
One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.
Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.
Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.