PUT /purchases/{id}/cancel.json
Path parameters
-
Numeric ID of the instance
Minimum value is
1
.
Body Required
-
adminNotes string | null
Admin notes
-
aftershipId string | null
Aftership
-
commercialInvoiceUrl string | null
Commercial invoice url
-
createdAt string(date-time)
Created at
-
days integer(int32) | null
Days
-
dropshipProviderAddressId integer(int32) | null
Dropship provider address
-
durationTerms string | null
Duration terms
-
externalId string | null
External
-
Grams
Default value is
0
. -
id integer(int32)
Id
-
intercomMessageId string | null
Intercom message
-
labelError string | null
Label error
-
labelFileFormat string | null
Label file format
Values are
png
orpdf
. labelFiles object | null | array | boolean | integer | number | string
-
Label refund
Default value is
false
. -
labelUrl string | null
Label url
-
Mute error
Default value is
false
. -
notes string | null
Notes
-
Paid
Default value is
0
. -
Payment status
Values are
notPaid
,partiallyPaid
, orpaid
. Default value isnotPaid
. -
Price
Default value is
0
. -
provider string | null
Provider
-
purchaseId integer(int32) | null
Purchase
-
quoteId string | null
Quote
-
Reference
-
returnAddressLineOne string | null
Return address line one
-
returnAddressLineTwo string | null
Return address line two
-
returnCity string | null
Return city
-
returnCountry string | null
Return country
-
returnFirstName string | null
Return first name
-
Return label type
Values are
prePaid
orpaid
. Default value isprePaid
. -
returnLastName string | null
Return last name
-
returnName string | null
Return name
-
returnShipmentId integer(int32) | null
Return shipment
-
returnState string | null
Return state
-
returnZip string | null
Return zip
-
Sale
-
Sale return source
Values are
internal
orexternal
. Default value isinternal
. -
saleReturnType string | null
Sale return type
Values are
automated
,customer
,dropship_provider
, ormerchant
. -
serviceLevel string | null
Service level
-
serviceLevelTerms string | null
Service level terms
-
shippoLabelIds array[string] | null
Shippo label ids
-
Status
Values are
draft
,requested
,finalized
,shipped
,received
, orcancelled
. Default value isrequested
. -
trackingCompany string | null
Tracking company
-
trackingNumber string | null
Tracking number
-
trackingStatus string | null
Tracking status
Values are
delivered
,failure
,pre_transit
,returned
,transit
, orunknown
. -
trackingStatusDate string(date-time) | null
Tracking status date
-
trackingStatusDetails string | null
Tracking status details
-
trackingUrl string | null
Tracking url
-
updatedAt string(date-time)
Updated at
-
userId integer(int32) | null
User
-
vendorCancelledAt string(date-time) | null
Vendor cancelled at
-
vendorReceivedId string | null
Vendor received
-
Vendor received status
Values are
notSent
,received
, orerror
. Default value isnotSent
.
curl \
-X PUT http://api.example.com/v1/purchases/{id}/cancel.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"adminNotes":"string","aftershipId":"string","commercialInvoiceUrl":"string","createdAt":"2024-05-04T09:42:00+00:00","days":42,"dropshipProviderAddressId":42,"durationTerms":"string","externalId":"string","files":{},"grams":0,"id":42,"intercomMessageId":"string","labelError":"string","labelFileFormat":"png","labelFiles":{},"labelRefund":false,"labelUrl":"string","muteError":false,"notes":"string","paid":0,"paymentStatus":"notPaid","price":0,"provider":"string","purchaseId":42,"quoteId":"string","reference":"string","returnAddressLineOne":"string","returnAddressLineTwo":"string","returnCity":"string","returnCountry":"string","returnFirstName":"string","returnLabelType":"prePaid","returnLastName":"string","returnName":"string","returnShipmentId":42,"returnState":"string","returnZip":"string","saleId":42,"saleReturnSource":"internal","saleReturnType":"automated","serviceLevel":"string","serviceLevelTerms":"string","shippoLabelIds":["string"],"status":"requested","tags":["string"],"trackingCompany":"string","trackingNumber":"string","trackingStatus":"delivered","trackingStatusDate":"2024-05-04T09:42:00+00:00","trackingStatusDetails":"string","trackingUrl":"string","updatedAt":"2024-05-04T09:42:00+00:00","userId":42,"vendorCancelledAt":"2024-05-04T09:42:00+00:00","vendorReceivedId":"string","vendorReceivedStatus":"notSent"}'
{
"adminNotes": "string",
"aftershipId": "string",
"commercialInvoiceUrl": "string",
"createdAt": "2024-05-04T09:42:00+00:00",
"days": 42,
"dropshipProviderAddressId": 42,
"durationTerms": "string",
"externalId": "string",
"files": {},
"grams": 0,
"id": 42,
"intercomMessageId": "string",
"labelError": "string",
"labelFileFormat": "png",
"labelFiles": {},
"labelRefund": false,
"labelUrl": "string",
"muteError": false,
"notes": "string",
"paid": 0,
"paymentStatus": "notPaid",
"price": 0,
"provider": "string",
"purchaseId": 42,
"quoteId": "string",
"reference": "string",
"returnAddressLineOne": "string",
"returnAddressLineTwo": "string",
"returnCity": "string",
"returnCountry": "string",
"returnFirstName": "string",
"returnLabelType": "prePaid",
"returnLastName": "string",
"returnName": "string",
"returnShipmentId": 42,
"returnState": "string",
"returnZip": "string",
"saleId": 42,
"saleReturnSource": "internal",
"saleReturnType": "automated",
"serviceLevel": "string",
"serviceLevelTerms": "string",
"shippoLabelIds": [
"string"
],
"status": "requested",
"tags": [
"string"
],
"trackingCompany": "string",
"trackingNumber": "string",
"trackingStatus": "delivered",
"trackingStatusDate": "2024-05-04T09:42:00+00:00",
"trackingStatusDetails": "string",
"trackingUrl": "string",
"updatedAt": "2024-05-04T09:42:00+00:00",
"userId": 42,
"vendorCancelledAt": "2024-05-04T09:42:00+00:00",
"vendorReceivedId": "string",
"vendorReceivedStatus": "notSent"
}
{
"adminNotes": "string",
"aftershipId": "string",
"commercialInvoiceUrl": "string",
"createdAt": "2024-05-04T09:42:00+00:00",
"days": 42,
"dropshipProviderAddressId": 42,
"durationTerms": "string",
"externalId": "string",
"files": {},
"grams": 0,
"id": 42,
"intercomMessageId": "string",
"labelError": "string",
"labelFileFormat": "png",
"labelFiles": {},
"labelRefund": false,
"labelUrl": "string",
"muteError": false,
"notes": "string",
"paid": 0,
"paymentStatus": "notPaid",
"price": 0,
"provider": "string",
"purchaseId": 42,
"quoteId": "string",
"reference": "string",
"returnAddressLineOne": "string",
"returnAddressLineTwo": "string",
"returnCity": "string",
"returnCountry": "string",
"returnFirstName": "string",
"returnLabelType": "prePaid",
"returnLastName": "string",
"returnName": "string",
"returnShipmentId": 42,
"returnState": "string",
"returnZip": "string",
"saleId": 42,
"saleReturnSource": "internal",
"saleReturnType": "automated",
"serviceLevel": "string",
"serviceLevelTerms": "string",
"shippoLabelIds": [
"string"
],
"status": "requested",
"tags": [
"string"
],
"trackingCompany": "string",
"trackingNumber": "string",
"trackingStatus": "delivered",
"trackingStatusDate": "2024-05-04T09:42:00+00:00",
"trackingStatusDetails": "string",
"trackingUrl": "string",
"updatedAt": "2024-05-04T09:42:00+00:00",
"userId": 42,
"vendorCancelledAt": "2024-05-04T09:42:00+00:00",
"vendorReceivedId": "string",
"vendorReceivedStatus": "notSent"
}