POST /purchases/{id}/ship.json
Path parameters
-
Numeric ID of the instance
Minimum value is
1
.
Body Required
-
adminNotes string | null
Admin notes
-
aftershipId string | null
Aftership
-
carrierPickupId integer(int32) | null
Carrier pickup
-
Channel attempts
Default value is
0
. -
channelError boolean | null
Channel error
-
Channel notification
Values are
trigger
ormute
. Default value istrigger
. -
commercialInvoiceUrl string | null
Commercial invoice url
-
createdAt string(date-time)
Created at
-
days integer(int32) | null
Days
-
Distance unit
Values are
in
orcm
. Default value isin
. -
durationTerms string | null
Duration terms
-
externalId string | null
External
-
Grams
Default value is
0
. -
id integer(int32)
Id
-
Import source
Values are
api
,manual
,platform
,portal
, orshippingEndpoint
. Default value ismanual
. -
intercomMessageId string | null
Intercom message
-
Inventory status
Values are
notShipped
orshipped
. Default value isnotShipped
. -
labelError string | null
Label error
-
labelFileFormat string | null
Label file format
Values are
png
orpdf
. labelFiles object | null | array | boolean | integer | number | string
-
Label print status
Values are
notPrinted
,generating
, orprinted
. Default value isnotPrinted
. labelProblem object | null | array | boolean | integer | number | string
-
Label refund
Default value is
false
. -
labelUrl string | null
Label url
-
manifestId integer(int32) | null
Manifest
-
Mute error
Default value is
false
. -
Packing depth
Default value is
2.4
. -
Packing height
Default value is
13.3
. -
Packing width
Default value is
11.5
. pickupProblem object | null | array | boolean | integer | number | string
-
Price
Default value is
0
. -
Printed label
Default value is
false
. -
printedLabelAt string(date-time) | null
Printed label at
-
provider string | null
Provider
-
Purchase
-
purchaseImportExternalId string | null
Purchase import external
-
quoteId string | null
Quote
-
Reference
-
Requires shipping approval
Values are
notRequired
,approvalRequired
,rateRequired
, orapproved
. Default value isnotRequired
. -
saleId integer(int32) | null
Sale
sendShippingUpdateProblem object | null | array | boolean | integer | number | string
Any of: Send shipping update problem
Send shipping update problem
Send shipping update problem
Send shipping update problem
Send shipping update problem
Send shipping update problem
-
serviceLevel string | null
Service level
-
serviceLevelTerms string | null
Service level terms
-
Shipment routing
Values are
customer
,consolidated
, orconsolidatedInternational
. Default value iscustomer
. -
shippoLabelIds array[string] | null
Shippo label ids
-
Source
Values are
sale
ordropship_purchase_import
. Default value issale
. -
Total weight
Default value is
0
. -
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
-
vendorExternalId string | null
Vendor external
-
Weight unit
Values are
g
,kg
,oz
, orlb
. Default value isg
.
curl \
-X POST http://api.example.com/v1/purchases/{id}/ship.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"adminNotes":"string","aftershipId":"string","carrierPickupId":42,"channelAttempts":0,"channelError":true,"channelNotification":"trigger","commercialInvoiceUrl":"string","createdAt":"2024-05-04T09:42:00+00:00","days":42,"distanceUnit":"in","durationTerms":"string","externalId":"string","files":{},"grams":0,"id":42,"importSource":"manual","intercomMessageId":"string","inventoryStatus":"notShipped","labelError":"string","labelFileFormat":"png","labelFiles":{},"labelPrintStatus":"notPrinted","labelProblem":{},"labelRefund":false,"labelUris":{},"labelUrl":"string","manifestId":42,"muteError":false,"packingDepth":2.4,"packingHeight":13.3,"packingWidth":11.5,"pickupProblem":{},"price":0,"printedLabel":false,"printedLabelAt":"2024-05-04T09:42:00+00:00","provider":"string","purchaseId":42,"purchaseImportExternalId":"string","quoteId":"string","reference":"string","requiresShippingApproval":"notRequired","saleId":42,"sendShippingUpdateProblem":{},"serviceLevel":"string","serviceLevelTerms":"string","shipmentRouting":"customer","shippoLabelIds":["string"],"source":"sale","tags":["string"],"totalWeight":0,"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,"vendorExternalId":"string","weightUnit":"g"}'
{
"adminNotes": "string",
"aftershipId": "string",
"carrierPickupId": 42,
"channelAttempts": 0,
"channelError": true,
"channelNotification": "trigger",
"commercialInvoiceUrl": "string",
"createdAt": "2024-05-04T09:42:00+00:00",
"days": 42,
"distanceUnit": "in",
"durationTerms": "string",
"externalId": "string",
"files": {},
"grams": 0,
"id": 42,
"importSource": "manual",
"intercomMessageId": "string",
"inventoryStatus": "notShipped",
"labelError": "string",
"labelFileFormat": "png",
"labelFiles": {},
"labelPrintStatus": "notPrinted",
"labelProblem": {},
"labelRefund": false,
"labelUris": {},
"labelUrl": "string",
"manifestId": 42,
"muteError": false,
"packingDepth": 2.4,
"packingHeight": 13.3,
"packingWidth": 11.5,
"pickupProblem": {},
"price": 0,
"printedLabel": false,
"printedLabelAt": "2024-05-04T09:42:00+00:00",
"provider": "string",
"purchaseId": 42,
"purchaseImportExternalId": "string",
"quoteId": "string",
"reference": "string",
"requiresShippingApproval": "notRequired",
"saleId": 42,
"sendShippingUpdateProblem": {},
"serviceLevel": "string",
"serviceLevelTerms": "string",
"shipmentRouting": "customer",
"shippoLabelIds": [
"string"
],
"source": "sale",
"tags": [
"string"
],
"totalWeight": 0,
"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,
"vendorExternalId": "string",
"weightUnit": "g"
}
{
"adminNotes": "string",
"aftershipId": "string",
"carrierPickupId": 42,
"channelAttempts": 0,
"channelError": true,
"channelNotification": "trigger",
"commercialInvoiceUrl": "string",
"createdAt": "2024-05-04T09:42:00+00:00",
"days": 42,
"distanceUnit": "in",
"durationTerms": "string",
"externalId": "string",
"files": {},
"grams": 0,
"id": 42,
"importSource": "manual",
"intercomMessageId": "string",
"inventoryStatus": "notShipped",
"labelError": "string",
"labelFileFormat": "png",
"labelFiles": {},
"labelPrintStatus": "notPrinted",
"labelProblem": {},
"labelRefund": false,
"labelUris": {},
"labelUrl": "string",
"manifestId": 42,
"muteError": false,
"packingDepth": 2.4,
"packingHeight": 13.3,
"packingWidth": 11.5,
"pickupProblem": {},
"price": 0,
"printedLabel": false,
"printedLabelAt": "2024-05-04T09:42:00+00:00",
"provider": "string",
"purchaseId": 42,
"purchaseImportExternalId": "string",
"quoteId": "string",
"reference": "string",
"requiresShippingApproval": "notRequired",
"saleId": 42,
"sendShippingUpdateProblem": {},
"serviceLevel": "string",
"serviceLevelTerms": "string",
"shipmentRouting": "customer",
"shippoLabelIds": [
"string"
],
"source": "sale",
"tags": [
"string"
],
"totalWeight": 0,
"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,
"vendorExternalId": "string",
"weightUnit": "g"
}