PurchaseOrders

Get a Purchase Order.

get/api/v1/PurchaseOrders/{id}

Request

  • Base URL: https://api.cin7.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.cin7.com/api/v1/PurchaseOrders/{id}
  • Auth: none declared

Path parameters

idinteger required

Response

OK

idinteger

The unique Cin7 Id.

createdDatestring date-time nullable

Created date.

modifiedDatestring date-time nullable

Last modified date.

createdByinteger

The ID for the User who created the Transaction.

processedByinteger

The ID for the User who processed the Transaction.

isApprovedboolean

Is Approved (default: true)

referencestring nullable

A unique order reference (leave blank to auto-generate in an insert).

memberIdinteger

The Customer Id (Optional). MemberId or MemberEmail should be specified to link a member to the order.

firstNamestring nullable

Contact first name

lastNamestring nullable

Contact last name

companystring nullable

Contact company

emailstring email nullable

Contact email address, could be different from MemberEmail assigned to the order

phonestring nullable

Contact phone

mobilestring nullable

Contact mobile

faxstring nullable

Contact fax

deliveryFirstNamestring nullable

Delivery recipient first name

deliveryLastNamestring nullable

Delivery recipient last name

deliveryCompanystring nullable

Delivery recipient company name

deliveryAddress1string nullable

Delivery address 1

deliveryAddress2string nullable

Delivery address 2

deliveryCitystring nullable

Delivery address city

deliveryStatestring nullable

Delivery address state

deliveryPostalCodestring nullable

Delivery address postcode

deliveryCountrystring nullable

Delivery address country

billingFirstNamestring nullable

​Billing recipient first name

billingLastNamestring nullable

​Billing recipient last name

billingCompanystring nullable

The billing company name

billingAddress1string nullable

​Billing address 1

billingAddress2string nullable

​Billing address 2

billingCitystring nullable

​Billing address city

billingPostalCodestring nullable

​Billing address postcode

billingStatestring nullable

Billing address state

billingCountrystring nullable

Billing address country

branchIdinteger

Branch Id. Not updatable if SO Dispatched or PO Received. Defaults to "Main Branch" ID when omitted.

branchEmailstring email nullable

Branch email

projectNamestring nullable

Project Name

trackingCodestring nullable

Shipping tracking code

internalCommentsstring nullable

Internal comment

productTotalnumber double

Product Total Only

freightTotalnumber double nullable

Total cost of delivery charges

freightDescriptionstring nullable

Freight/​carrier description

surchargenumber double nullable

Surcharge

surchargeDescriptionstring nullable

Surcharge description

discountTotalnumber double nullable

Total overall discount

discountDescriptionstring nullable

The discount description

totalnumber double

Order total includes Product Total, Freight Total, Discount Total, Surcharge Total, and Tax

currencyIdinteger

The unique Cin7 currency Id.

currencyCodestring nullable

The three-character ISO currency code e.g. NZD. Omit to use account default.

currencyRatenumber double

The currency rate. ​​If no rate is specified (i.e. zero or null), Cin7 will lookup the currency rate from the start of the day as provided by our 3rd party currency service.

currencySymbolstring nullable

The currency symbol e.g. $. This field is automatically populate based on currency code.

taxStatus0 | 1 | 2 | 3

Tax Status

taxRatenumber double

Tax Rate e.g. 15. If different from your default tax rate you will need to set the CostCenter or Alternative tax rate field as well.

sourcestring nullable

The source of the Transaction. This field is read-only.

customFieldsobject nullable

Custom fields.

status0 | 1 | 2

Order status.

stagestring nullable

Stage: New, Awaiting Payment, Declined, Dispatched, Processing, On Hold (default: New)

memberEmailstring email nullable

The CRM contact email of a customer in an order

memberCostCenterstring nullable

Member Cost Center (Alternative GL Account).

memberAlternativeTaxRatestring nullable

The member Alternative Tax Rate.

costCenterstring nullable

Cost Center (Alternative GL Account).

alternativeTaxRatestring nullable

Alternative Tax Rate.

estimatedDeliveryDatestring date-time nullable

Estimated Delivery Date

salesPersonIdinteger

The unique Cin7 user Id of the sales person.

salesPersonEmailstring email nullable

Made obsolete. This value will be null in the response.

paymentTermsstring nullable

Payment terms

customerOrderNostring nullable

Customer purchase order reference

voucherCodestring nullable

Voucher code

deliveryInstructionsstring nullable

Delivery instructions e.g. Leave at the door, beware the dog.

cancellationDatestring date-time nullable

Order cancellation date - (Read-only)

modifiedCOGSDatestring date-time nullable

Last modified date of Cost of Good Sold(COGS) - (Read-only)

supplierInvoiceReferencestring nullable
supplierAcceptanceDatestring date-time nullable
portstring nullable

Port for Indent Order.

estimatedArrivalDatestring date-time nullable

Estimated time of arrival for Indent Order.

fullyReceivedDatestring date-time nullable
invoiceDatestring date-time nullable
logisticsCarrierstring nullable

Logistics Carrier

logisticsStatusinteger nullable

Logistics Status

isVoidboolean

Set to true to void an order; note this behaviour is irreversible.

Changes

No recorded changes to this operation across all 1 revision of this API.