Sign in
Purchase Order

Create a new draft purchase order

post/api/purchase-orders

Request body

vendorIdstring required

Vendor Id

type'standard' | 'outsideProcessing' | 'vendorCredit' required

Purchase order type

contactIdstring nullable

Vendor Contact Id; defaults to the Id of the first contact belonging to the input vendor

companyInfoIdstring nullable

Company Information Id; defaults to primary company info Id

currencyCodestring nullable

Currency code override; defaults to vendor currency code override, then the company's primary currency code

externalReferencesobject nullable

External references associated with this entity.

expectedReceiveDatestring date-time nullable

PO Expected receipt date

Response

Purchase order created

idstring required

Unique id associated to this entity.

numberinteger required

Number

issueDatestring date-time nullable

PO creation date

earliestReceiveDatestring date-time nullable

Earliest Receive Date

orderDatestring date-time nullable

PO order date (null until status set to Ordered)

expectedReceiveDatestring date-time nullable

PO Expected receipt date

promiseDatestring date-time nullable

PO Promise date.

vendorIdstring required

Vendor Id

contactIdstring nullable

Vendor Contact Id. Null for purchase orders that have no contact.

paymentTermsIdstring nullable

Payment terms key identifier. Please reference /api/payment-terms endpoint.

type'standard' | 'outsideProcessing' | 'vendorCredit' required

Purchase order type

status'draft' | 'needsApproval' | 'approved' | 'ordered' | 'paid' | 'cancelled' required

Purchase order status

receivingStatus'notReceived' | 'partiallyReceived' | 'received' required

Purchase order receipt status

vendorCreditnumber double nullable

Vendor credit applied to this purchase order, if applicable

discountnumber double nullable

Discount applied to this purchase order, if applicable

subTotalnumber double

Total cost of this purchase order, sans tax (if applicable)

totalnumber double

Total cost of this purchase order, tax included (if applicable)

companyInfoIdstring required

Company Information Id;

vendorNotestring nullable

The vendor note is a string property that represents a note provided to the vendor.

notesstring[] nullable

Notes

externalReferencesobject nullable

External references associated with this entity.

customFieldsobject nullable

Custom fields that have been defined on this entity.

deletedboolean

Indicates whether this purchase order has been deleted

currencyCodestring nullable

Currency code/denomination associated to this vendor. If not provided, default to the primary currency code for the organization.

vendorOrderNumberstring nullable

The vendor's purchase order number

Changes

Changed in 2 of the 23 revisions of this API.42

  • c002514312372See the full diff
    • ○

      added the optional property to the response with the status (media type: application/json)

      response-optional-property-added

    • ○

      added the optional property to the response with the status (media type: application/problem+json)

      response-optional-property-added

  • c4b2ba5fc2704See the full diff
    • ▲

      the response property became nullable for the status (media type: application/json)

      response-property-became-nullable

    • ▲

      the response property became nullable for the status (media type: application/problem+json)

      response-property-became-nullable

    • ▲

      the response property became optional for the status (media type: application/json)

      response-property-became-optional

    • ▲

      the response property became optional for the status (media type: application/problem+json)

      response-property-became-optional