Body
      
    Required
 
    
  
  - 
    
  
Adjustment reason
 - 
    
  
Admin notes
 - 
    
  
Approved
Default value is
true. - 
    
  
Billing address line one
 - 
    
  
Billing address line two
 - 
    
  
Billing address message
 - 
    
  
Billing city
 - 
    
  
Billing country
 - 
    
  
Billing first name
 - 
    
  
Billing last name
 - 
    
  
Billing name
 - 
    
  
Billing state
 - 
    
  
Billing zip
 - 
    
  
Cancellation status
Values are
none,partial, orfull. Default value isnone. - 
    
  
Cancelled
Default value is
false. - 
    
  
Cancelled at
 - 
    
  
City tax location
 - 
    
  
City tax rate
 - 
    
  
Combined tax rate
 - 
    
  
County tax location
 - 
    
  
County tax rate
 - 
    
  
Created at
 - 
    
  
Customer reference
 - 
    
  
Date ordered
Default value is
{}(empty). - 
    
  
Delivery expected at
 - 
    
  
Discounts
Default value is
0. - 
    
  
District tax rate
 - 
    
  
Dropship notes
 - 
    
  
Dropship provider address
 - 
    
  
Dropship provider
 - 
    
  
Finalized
Default value is
true. - 
    
  
Id
 - 
    
  
Intercom message
 - 
    
  
Internal reference
 - 
    
  
Invalid billing address
 - 
    
  
Invalid shipping address
Default value is
false. - 
    
  
Inventory status
Values are
notReceived,partiallyReceived, orreceived. Default value isnotReceived. - 
    
  
Invoice status
Values are
notInvoiced,partiallyInvoiced, orinvoiced. Default value isnotInvoiced. - 
    
  
Is dropship
 - 
    
  
Last dropshipment reference
Default value is
0. - 
    
  
Last goods receipt reference
Default value is
0. - 
    
  
Last purchase invoice reference
Default value is
0. - 
    
  
Locked
Default value is
false. - 
    
  
Mute error
Default value is
false. - 
    
  
Notes
 - 
    
  
Order splitting
Values are
group,splitTag,splitQuantity, orexternalLocationId. Default value isgroup. - 
    
  
Order splitting key
 - 
    
  
Payment expected at
 - 
    
  
Payment status
Values are
notPaid,partiallyPaid, orpaid. Default value isnotPaid. - 
    
  
Price list
 - 
    
  
Purchase
 - 
    
  
Purchase import external
 - 
    
  
Purchase status
 - 
    
  
Purchase type
Values are
replenishment,dropship,automated_dropship,automated_replenishment, oradjusted_dropship. Default value isreplenishment. - 
    
  
Quantity
Default value is
0. - 
    
  
Receiver address line one
 - 
    
  
Receiver address line two
 - 
    
  
Receiver city
 - 
    
  
Receiver country
 - 
    
  
Receiver name
 - 
    
  
Receiver state
 - 
    
  
Receiver zip
 - 
    
  
Reference
 - 
    
  
Reminder last sent
 - 
    
  
Reminder sent
Default value is
false. - 
    
  
Return status
Values are
notReturned,partiallyReturned, orreturned. Default value isnotReturned. - 
    
  
Sale
 - 
    
  
Send source
Values are
manualorautomatic. - 
    
  
Shipment routing
Values are
customer,consolidated, orconsolidatedInternational. Default value iscustomer. - 
    
  
Shipping address line one
 - 
    
  
Shipping address line two
 - 
    
  
Shipping address message
Default value is
false. - 
    
  
Shipping city
 - 
    
  
Shipping country
 - 
    
  
Shipping expected at
 - 
    
  
Shipping first name
 - 
    
  
Shipping last name
 - 
    
  
Shipping name
 - 
    
  
Shipping rate error
Values are
valueorweight. - 
    
  
Shipping state
 - 
    
  
Shipping zip
 - 
    
  
Split tag
 - 
    
  
State tax location
 - 
    
  
State tax rate
 - 
    
  
Subtotal
Default value is
0. - 
    
  
Tax
Default value is
0. - 
    
  
Tax calculation
Values are
defaultorcustom. Default value isdefault. - 
    
  
Tax included
Default value is
false. - 
    
  
Tax shipping
Default value is
true. - 
    
  
Total
Default value is
0. - 
    
  
Updated at
 - 
    
  
User
 - 
    
  
Vendor endpoint format
Values are
json,xml,csv,text,email,website, orphone. - 
    
  
Vendor endpoint response
 - 
    
  
Vendor
 - 
    
  
Vendor received
 - 
    
  
Vendor received reference
 - 
    
  
Vendor received status
Values are
notSent,received, orerror. Default value isnotSent. - 
    
  
Vendor received status reason
Values are
sent,shipped, orcancelled. Default value issent. - 
    
  
Vendor reference
 - 
    
  
Warehouse
 - 
    
  
Weight
Default value is
0. 
curl \
 --request PUT 'http://api.example.com/v1/purchases/{id}.json' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"adjustmentReasonId":42,"adminNotes":"string","approved":true,"billingAddressLineOne":"string","billingAddressLineTwo":"string","billingAddressMessage":"string","billingCity":"string","billingCountry":"string","billingFirstName":"string","billingFullName":{},"billingLastName":"string","billingName":"string","billingState":"string","billingZip":"string","cancellationStatus":"none","cancelled":false,"cancelledAt":"2025-05-04T09:42:00Z","cityTaxLocation":"string","cityTaxRate":42.0,"combinedTaxRate":42.0,"countyTaxLocation":"string","countyTaxRate":42.0,"createdAt":"2025-05-04T09:42:00Z","customerReference":"string","dateOrdered":{},"deliveryExpectedAt":"2025-05-04T09:42:00Z","discounts":0,"districtTaxRate":42.0,"dropshipNotes":"string","dropshipProviderAddressId":42,"dropshipProviderId":42,"files":{},"finalized":true,"id":42,"intercomMessageId":"string","internalReference":"string","invalidBillingAddress":"string","invalidShippingAddress":false,"inventoryStatus":"notReceived","invoiceProblem":{},"invoiceStatus":"notInvoiced","isDropship":true,"labelProblem":{},"lastDropshipmentReference":0,"lastGoodsReceiptReference":0,"lastPurchaseInvoiceReference":0,"locked":false,"muteError":false,"notes":"string","orderProblem":{},"orderSplitting":"group","orderSplittingKey":"string","pauseProblems":{},"paymentExpectedAt":"2025-05-04T09:42:00Z","paymentStatus":"notPaid","priceListId":42,"purchaseId":42,"purchaseImportExternalId":"string","purchaseStatusId":42,"purchaseType":"replenishment","quantity":0,"receiverAddressLineOne":"string","receiverAddressLineTwo":"string","receiverCity":"string","receiverCountry":"string","receiverName":"string","receiverState":"string","receiverZip":"string","reference":"string","reminderLastSent":"2025-05-04T09:42:00Z","reminderSent":false,"returnLabelProblem":{},"returnStatus":"notReturned","saleId":42,"sendSource":"manual","shipmentRouting":"customer","shippingAddressLineOne":"string","shippingAddressLineTwo":"string","shippingAddressMessage":false,"shippingCity":"string","shippingCountry":"string","shippingExpectedAt":"2025-05-04T09:42:00Z","shippingFirstName":"string","shippingFullName":{},"shippingLastName":"string","shippingName":"string","shippingRateError":"value","shippingState":"string","shippingZip":"string","splitTag":"string","stateTaxLocation":"string","stateTaxRate":42.0,"subtotal":0,"tags":["string"],"tax":0,"taxCalculation":"default","taxIncluded":false,"taxShipping":true,"total":0,"updatedAt":"2025-05-04T09:42:00Z","userId":42,"vendorEndpointFormat":"json","vendorEndpointHeaders":{},"vendorEndpointResponse":"string","vendorId":42,"vendorReceivedId":"string","vendorReceivedReference":"string","vendorReceivedStatus":"notSent","vendorReceivedStatusReason":"sent","vendorReference":"string","warehouseId":42,"weight":0}'
    {
  "adjustmentReasonId": 42,
  "adminNotes": "string",
  "approved": true,
  "billingAddressLineOne": "string",
  "billingAddressLineTwo": "string",
  "billingAddressMessage": "string",
  "billingCity": "string",
  "billingCountry": "string",
  "billingFirstName": "string",
  "billingFullName": {},
  "billingLastName": "string",
  "billingName": "string",
  "billingState": "string",
  "billingZip": "string",
  "cancellationStatus": "none",
  "cancelled": false,
  "cancelledAt": "2025-05-04T09:42:00Z",
  "cityTaxLocation": "string",
  "cityTaxRate": 42.0,
  "combinedTaxRate": 42.0,
  "countyTaxLocation": "string",
  "countyTaxRate": 42.0,
  "createdAt": "2025-05-04T09:42:00Z",
  "customerReference": "string",
  "dateOrdered": {},
  "deliveryExpectedAt": "2025-05-04T09:42:00Z",
  "discounts": 0,
  "districtTaxRate": 42.0,
  "dropshipNotes": "string",
  "dropshipProviderAddressId": 42,
  "dropshipProviderId": 42,
  "files": {},
  "finalized": true,
  "id": 42,
  "intercomMessageId": "string",
  "internalReference": "string",
  "invalidBillingAddress": "string",
  "invalidShippingAddress": false,
  "inventoryStatus": "notReceived",
  "invoiceProblem": {},
  "invoiceStatus": "notInvoiced",
  "isDropship": true,
  "labelProblem": {},
  "lastDropshipmentReference": 0,
  "lastGoodsReceiptReference": 0,
  "lastPurchaseInvoiceReference": 0,
  "locked": false,
  "muteError": false,
  "notes": "string",
  "orderProblem": {},
  "orderSplitting": "group",
  "orderSplittingKey": "string",
  "pauseProblems": {},
  "paymentExpectedAt": "2025-05-04T09:42:00Z",
  "paymentStatus": "notPaid",
  "priceListId": 42,
  "purchaseId": 42,
  "purchaseImportExternalId": "string",
  "purchaseStatusId": 42,
  "purchaseType": "replenishment",
  "quantity": 0,
  "receiverAddressLineOne": "string",
  "receiverAddressLineTwo": "string",
  "receiverCity": "string",
  "receiverCountry": "string",
  "receiverName": "string",
  "receiverState": "string",
  "receiverZip": "string",
  "reference": "string",
  "reminderLastSent": "2025-05-04T09:42:00Z",
  "reminderSent": false,
  "returnLabelProblem": {},
  "returnStatus": "notReturned",
  "saleId": 42,
  "sendSource": "manual",
  "shipmentRouting": "customer",
  "shippingAddressLineOne": "string",
  "shippingAddressLineTwo": "string",
  "shippingAddressMessage": false,
  "shippingCity": "string",
  "shippingCountry": "string",
  "shippingExpectedAt": "2025-05-04T09:42:00Z",
  "shippingFirstName": "string",
  "shippingFullName": {},
  "shippingLastName": "string",
  "shippingName": "string",
  "shippingRateError": "value",
  "shippingState": "string",
  "shippingZip": "string",
  "splitTag": "string",
  "stateTaxLocation": "string",
  "stateTaxRate": 42.0,
  "subtotal": 0,
  "tags": [
    "string"
  ],
  "tax": 0,
  "taxCalculation": "default",
  "taxIncluded": false,
  "taxShipping": true,
  "total": 0,
  "updatedAt": "2025-05-04T09:42:00Z",
  "userId": 42,
  "vendorEndpointFormat": "json",
  "vendorEndpointHeaders": {},
  "vendorEndpointResponse": "string",
  "vendorId": 42,
  "vendorReceivedId": "string",
  "vendorReceivedReference": "string",
  "vendorReceivedStatus": "notSent",
  "vendorReceivedStatusReason": "sent",
  "vendorReference": "string",
  "warehouseId": 42,
  "weight": 0
}