Acknowledge shipment receipt

After successfully processing a shipment, the shipment should be acknowledged so that it does not appear in subsequent requests to /shipments/?is_acknowledged=0.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id

integer

required

Shipment ID

retailer_pk

number

required

Retailer ID

Body

application/json

order_id

integer

required

Order ID

acknowledged_at

string | null

Time of acknowledgement (UTC format)

batch_number

integer | null

Batch number of shipment

Required range: -2147483648 < x < 2147483647

brand

object

Show child attributes

brand.code

string

required

Vendor code, which is vendor name in lower case and underscore

Required string length: 1 - 64

brand.grace_period_ends_at

string | null

Time of grace period expiration (UTC format)

brand.inventory_policy

enum<string>

Inventory policy

Available options:

unmanaged,

managed,

use_variant_policy

brand.is_on_rcn

boolean

true: is on Dropship network <br /> false: not on Dropship network

brand.name

string

Vendor name

Required string length: 1 - 64

brand.requires_subscription

enum<string>

Represents whether subscription is required

Available options:

disabled,

enabled,

upcoming

brand.status

enum<string>

Vendor status

Available options:

active,

pending,

inactive

brand.subscription_expires_at

string | null

Subscription expiry Time (UTC format)

brand.website

string | null

URL of brand website

Maximum length: 100

canceled_at

string | null

Time of cancellation (UTC format)

closed_at

string | null

Time of shipment closure (UTC format)

delivered_at

string | null

Time of delivery (UTC format)

error_logs

object

Show child attributes

error_logs.message

string | null

Message in error log

has_commercial_invoice

boolean

true: Shipment has commercial invoice <br /> Shipment does not have commercial invoice

label_reference

string | null

Label reference

Maximum length: 30

ship_from

object

Show child attributes

ship_from.city

string

required

City name

Required string length: 1 - 64

ship_from.country

string

required

Country name

Required string length: 1 - 128

ship_from.name1

string

required

Name of the primary contact?

Required string length: 1 - 64

ship_from.postal_code

string

required

Postal code

Required string length: 1 - 32

ship_from.province

string

required

State name

Required string length: 1 - 32

ship_from.street1

string

required

Line 1 of the address

Required string length: 1 - 128

ship_from.email

string | null

Contact email address

Maximum length: 128

ship_from.fax

string | null

Fax number

Maximum length: 32

ship_from.federal_tax_id

string | null

Federal tax ID

Maximum length: 32

ship_from.name2

string | null

Name of the alternative contact?

Maximum length: 64

ship_from.phone1

string | null

Primary contact number

Maximum length: 32

ship_from.phone2

string | null

Alternate contact number

Maximum length: 32

ship_from.street2

string | null

Line 2 of the address

Maximum length: 128

ship_from.type

enum<string> | null

Type of address

Available options:

residential,

commercial

ship_height

number | null

Shipment height

ship_length

number | null

Shipment length

ship_to

object

Show child attributes

ship_to.city

string

required

City name

Required string length: 1 - 64

ship_to.country

string

required

Country name

Required string length: 1 - 128

ship_to.name1

string

required

Name of the primary contact?

Required string length: 1 - 64

ship_to.postal_code

string

required

Postal code

Required string length: 1 - 32

ship_to.province

string

required

State name

Required string length: 1 - 32

ship_to.street1

string

required

Line 1 of the address

Required string length: 1 - 128

ship_to.email

string | null

Contact email address

Maximum length: 128

ship_to.fax

string | null

Fax number

Maximum length: 32

ship_to.federal_tax_id

string | null

Federal tax ID

Maximum length: 32

ship_to.name2

string | null

Name of the alternative contact?

Maximum length: 64

ship_to.phone1

string | null

Primary contact number

Maximum length: 32

ship_to.phone2

string | null

Alternate contact number

Maximum length: 32

ship_to.street2

string | null

Line 2 of the address

Maximum length: 128

ship_to.type

enum<string> | null

Type of address

Available options:

residential,

commercial

ship_weight

number | null

Shipment weight

ship_width

number | null

Shipment width

shipped_at

string | null

Time of shipping (UTC format)

shipping_account

object

Show child attributes

shipping_account.nickname

string

required

Nickname of shipping account

Required string length: 1 - 64

shipping_account.carrier

object

Show child attributes

shipping_account.carrier.code

string

Carrier code

Required string length: 1 - 64

shipping_account.carrier.name

string

Carrier name

Required string length: 1 - 64

shipping_account.is_first_party_bill

boolean

true: is first party billed shipment <br /> false Is not first party bill

shipping_method

object

Show child attributes

shipping_method.code

string

required

Code of shipping method

Required string length: 1 - 64

shipping_method.name

string

required

Name of shipping method

Required string length: 1 - 64

shipping_method.carrier

object

Show child attributes

shipping_method.carrier.code

string

Carrier code

Required string length: 1 - 64

shipping_method.carrier.name

string

Carrier name

Required string length: 1 - 64

shipping_method.generic_shipping_method

object

Show child attributes

shipping_method.generic_shipping_method.description

string

required

Description of shipping method

Required string length: 1 - 128

shipping_method.generic_shipping_method.name

string

required

Name of shipping method

Required string length: 1 - 32

shipping_method.generic_shipping_method.type

enum<string>

Type of shipping method

Available options:

small_parcel,

ltl

shipping_method.type

enum<string>

Type of shipping method

Available options:

small_parcel,

ltl

shipping_provider_identifier

string | null

Identifier of the shipping provider

Maximum length: 64

signature

enum<string> | null

Signature criteria

Available options:

required,

not_required,

adult

sold_to

object

Show child attributes

sold_to.city

string

required

City name

Required string length: 1 - 64

sold_to.country

string

required

Country name

Required string length: 1 - 128

sold_to.name1

string

required

Name of the primary contact?

Required string length: 1 - 64

sold_to.postal_code

string

required

Postal code

Required string length: 1 - 32

sold_to.province

string

required

State name

Required string length: 1 - 32

sold_to.street1

string

required

Line 1 of the address

Required string length: 1 - 128

sold_to.email

string | null

Contact email address

Maximum length: 128

sold_to.fax

string | null

Fax number

Maximum length: 32

sold_to.federal_tax_id

string | null

Federal tax ID

Maximum length: 32

sold_to.name2

string | null

Name of the alternative contact?

Maximum length: 64

sold_to.phone1

string | null

Primary contact number

Maximum length: 32

sold_to.phone2

string | null

Alternate contact number

Maximum length: 32

sold_to.street2

string | null

Line 2 of the address

Maximum length: 128

sold_to.type

enum<string> | null

Type of address

Available options:

residential,

commercial

tracking

object

Show child attributes

tracking.delivered_at

string | null

Time of order delivery

tracking.picked_up_at

string | null

Time of order pickup

tracking_number

string | null

Tracking number for shipment

Maximum length: 128

Response

200 - application/json

order_id

integer

required

Order ID

acknowledged_at

string | null

Time of acknowledgement (UTC format)

batch_number

integer | null

Batch number of shipment

Required range: -2147483648 < x < 2147483647

brand

object

Show child attributes

brand.code

string

required

Vendor code, which is vendor name in lower case and underscore

Required string length: 1 - 64

brand.cover_url

string

URL of the cover image

Minimum length: 1

brand.grace_period_ends_at

string | null

Time of grace period expiration (UTC format)

brand.id

integer

Vendor (brand) ID

brand.inventory_policy

enum<string>

Inventory policy

Available options:

unmanaged,

managed,

use_variant_policy

brand.is_on_rcn

boolean

true: is on Dropship network <br /> false: not on Dropship network

brand.is_onboarded

boolean

true: Vendor is onboarded <br /> false: Vendor is not onboarded

brand.joined_at

string

Time when vendor joined Dropship (UTC format)

brand.logo_url

string

URL of the brand logo

Minimum length: 1

brand.name

string

Vendor name

Required string length: 1 - 64

brand.profile_tile_url

string

URL of the profile image

Minimum length: 1

brand.requires_subscription

enum<string>

Represents whether subscription is required

Available options:

disabled,

enabled,

upcoming

brand.status

enum<string>

Vendor status

Available options:

active,

pending,

inactive

brand.subscription_expires_at

string | null

Subscription expiry Time (UTC format)

brand.subscription_is_delinquent

boolean

true: subscription is overdue <br /> false: subscription is paid

brand.subscription_is_expired

boolean

true: subscription is expired <br /> false: subscription is active

brand.subscription_is_on_grace_period

boolean

true: subscription is on grace period <br /> false: subscription is not on grace period

brand.website

string | null

URL of brand website

Maximum length: 100

canceled_at

string | null

Time of cancellation (UTC format)

closed_at

string | null

Time of shipment closure (UTC format)

created_at

string

Time of shipment creation (UTC format)

customer_order_number

string

Customer order number

Minimum length: 1

delivered_at

string | null

Time of delivery (UTC format)

error_logs

object

Show child attributes

error_logs.count

integer

Count of error log

error_logs.created_at

string

Time of error log creation

error_logs.id

integer

Error log ID

error_logs.message

string | null

Message in error log

has_commercial_invoice

boolean

true: Shipment has commercial invoice <br /> Shipment does not have commercial invoice

id

integer

Shipment ID

invoice_number

string

Invoice number

is_acknowledged

boolean

true: Shipment is acknowledged <br /> false: Shipment is not acknowledged

label_reference

string | null

Label reference

Maximum length: 30

ordered_at

string

Time of shipment creation (UTC format)

purchase_order_number

string

Purchase order number

Minimum length: 1

retailer_order_number

string

Retailer order number

Minimum length: 1

ship_from

object

Show child attributes

ship_from.city

string

required

City name

Required string length: 1 - 64

ship_from.country

string

required

Country name

Required string length: 1 - 128

ship_from.name1

string

required

Name of the primary contact?

Required string length: 1 - 64

ship_from.postal_code

string

required

Postal code

Required string length: 1 - 32

ship_from.province

string

required

State name

Required string length: 1 - 32

ship_from.street1

string

required

Line 1 of the address

Required string length: 1 - 128

ship_from.email

string | null

Contact email address

Maximum length: 128

ship_from.fax

string | null

Fax number

Maximum length: 32

ship_from.federal_tax_id

string | null

Federal tax ID

Maximum length: 32

ship_from.id

integer

Address ID

ship_from.name2

string | null

Name of the alternative contact?

Maximum length: 64

ship_from.phone1

string | null

Primary contact number

Maximum length: 32

ship_from.phone2

string | null

Alternate contact number

Maximum length: 32

ship_from.street2

string | null

Line 2 of the address

Maximum length: 128

ship_from.type

enum<string> | null

Type of address

Available options:

residential,

commercial

ship_girth

string

Shipment girth

ship_height

number | null

Shipment height

ship_length

number | null

Shipment length

ship_to

object

Show child attributes

ship_to.city

string

required

City name

Required string length: 1 - 64

ship_to.country

string

required

Country name

Required string length: 1 - 128

ship_to.name1

string

required

Name of the primary contact?

Required string length: 1 - 64

ship_to.postal_code

string

required

Postal code

Required string length: 1 - 32

ship_to.province

string

required

State name

Required string length: 1 - 32

ship_to.street1

string

required

Line 1 of the address

Required string length: 1 - 128

ship_to.email

string | null

Contact email address

Maximum length: 128

ship_to.fax

string | null

Fax number

Maximum length: 32

ship_to.federal_tax_id

string | null

Federal tax ID

Maximum length: 32

ship_to.id

integer

Address ID

ship_to.name2

string | null

Name of the alternative contact?

Maximum length: 64

ship_to.phone1

string | null

Primary contact number

Maximum length: 32

ship_to.phone2

string | null

Alternate contact number

Maximum length: 32

ship_to.street2

string | null

Line 2 of the address

Maximum length: 128

ship_to.type

enum<string> | null

Type of address

Available options:

residential,

commercial

ship_volume

string

Shipment volume

ship_weight

number | null

Shipment weight

ship_width

number | null

Shipment width

shipment_lines

object[]

Show child attributes

shipment_lines.freight_class

enum<string> | null

Freight class

Available options:

50,

55,

60,

65,

70,

77.5,

85,

92.5,

100,

110,

125,

150,

175,

200,

250,

300,

400,

500

shipment_lines.id

integer

Shipment line ID

shipment_lines.order_line_number

string

Order line number

shipment_lines.part

integer

Internal only

Required range: -2147483648 < x < 2147483647

shipment_lines.quantity

integer

Order quantity

Required range: -2147483648 < x < 2147483647

shipment_lines.updated_at

string

Time of last update

shipment_lines.variant

object

Show child attributes

shipment_lines.variant.brand

object

Show child attributes

shipment_lines.variant.brand.code

string

required

Vendor code. Same as vendor name in lower case and hyphenated

Required string length: 1 - 64

shipment_lines.variant.brand.id

integer

Vendor ID

shipment_lines.variant.brand.name

string

Vendor name

Required string length: 1 - 64

shipment_lines.variant.brand_identifier

string

Brand identifier

Minimum length: 1

shipment_lines.variant.id

integer

Variant ID

shipment_lines.variant.identifier

string | null

Stock Keeping Unit (SKU), unique identifier of a product

Maximum length: 128

shipment_lines.variant.name

string | null

Variant name

Maximum length: 200

shipment_lines.variant.retailer_identifiers

object[]

Show child attributes

shipment_lines.variant.retailer_identifiers.id

integer

Retailer ID

shipment_lines.variant.retailer_identifiers.identifier

string | null

Stock Keeping Unit (SKU), unique identifier of a product

Maximum length: 256

shipment_lines.variant.retailer_identifiers.name

string | null

Retailer name

Maximum length: 256

shipment_lines.variant.retailer_identifiers.retailer

object

Show child attributes

shipment_lines.variant.retailer_identifiers.retailer.code

string

required

Retailer code, which is retailer name in lower case and hyphenated

Required string length: 1 - 32

shipment_lines.variant.retailer_identifiers.retailer.name

string

required

Retailer name

Required string length: 1 - 64

shipment_lines.variant.retailer_identifiers.retailer.brand_permit_creation_allowed

boolean

true: Platform allows creation of brand permit <br /> false: Platform doesn't require creation of brand permit

shipment_lines.variant.retailer_identifiers.retailer.cover_url

string

URL of retailer cover image

Minimum length: 1

shipment_lines.variant.retailer_identifiers.retailer.id

integer

Retailer ID

shipment_lines.variant.retailer_identifiers.retailer.is_onboarded

boolean

true: Retailer is onboarded <br /> false: Retailer is not onboarded

shipment_lines.variant.retailer_identifiers.retailer.is_rcn_retailer

boolean

true: Retailer is in Dropship network; Retailer is not in Dropship network

shipment_lines.variant.retailer_identifiers.retailer.joined_at

string

Time of retailer joining Dropship (UTC format)

shipment_lines.variant.retailer_identifiers.retailer.logo_url

string

URL of retailer logo

Minimum length: 1

shipment_lines.variant.retailer_identifiers.retailer.platform

enum<string>

Platform on which retailer is onboarded

Available options:

fabric

shipment_lines.variant.retailer_identifiers.retailer.profile_tile_url

string

URL of retailer profile image

Minimum length: 1

shipment_lines.variant.retailer_identifiers.retailer.requires_subscription

enum<string>

Represent whether retailer requires subscription to use the platform

Available options:

disabled,

enabled,

upcoming

shipment_lines.variant.retailer_identifiers.retailer.status

enum<string>

Retailer status

Available options:

active,

setup,

ghost

shipment_lines.variant.retailer_identifiers.retailer.website

string | null

Website URL

Maximum length: 100

shipment_lines.variant.upc

string

Universal product code (UPC) is a 12-digit combination of numbers assigned to each product in your drop-shipping store

Maximum length: 64

shipped_at

string | null

Time of shipping (UTC format)

shipping_account

object

Show child attributes

shipping_account.nickname

string

required

Nickname of shipping account

Required string length: 1 - 64

shipping_account.carrier

object

Show child attributes

shipping_account.carrier.code

string

Carrier code

Required string length: 1 - 64

shipping_account.carrier.id

integer

Carrier ID

shipping_account.carrier.name

string

Carrier name

Required string length: 1 - 64

shipping_account.id

integer

Shipping account ID

shipping_account.is_first_party_bill

boolean

true: is first party billed shipment <br /> false Is not first party bill

shipping_account.owner

string

Owner of shipping account

shipping_method

object

Show child attributes

shipping_method.code

string

required

Code of shipping method

Required string length: 1 - 64

shipping_method.name

string

required

Name of shipping method

Required string length: 1 - 64

shipping_method.carrier

object

Show child attributes

shipping_method.carrier.code

string

Carrier code

Required string length: 1 - 64

shipping_method.carrier.id

integer

Carrier ID

shipping_method.carrier.name

string

Carrier name

Required string length: 1 - 64

shipping_method.generic_shipping_method

object

Show child attributes

shipping_method.generic_shipping_method.description

string

required

Description of shipping method

Required string length: 1 - 128

shipping_method.generic_shipping_method.name

string

required

Name of shipping method

Required string length: 1 - 32

shipping_method.generic_shipping_method.id

integer

ID of shipping method

shipping_method.generic_shipping_method.type

enum<string>

Type of shipping method

Available options:

small_parcel,

ltl

shipping_method.id

integer

ID of shipping method

shipping_method.type

enum<string>

Type of shipping method

Available options:

small_parcel,

ltl

shipping_provider_identifier

string | null

Identifier of the shipping provider

Maximum length: 64

signature

enum<string> | null

Signature criteria

Available options:

required,

not_required,

adult

sold_to

object

Show child attributes

sold_to.city

string

required

City name

Required string length: 1 - 64

sold_to.country

string

required

Country name

Required string length: 1 - 128

sold_to.name1

string

required

Name of the primary contact?

Required string length: 1 - 64

sold_to.postal_code

string

required

Postal code

Required string length: 1 - 32

sold_to.province

string

required

State name

Required string length: 1 - 32

sold_to.street1

string

required

Line 1 of the address

Required string length: 1 - 128

sold_to.email

string | null

Contact email address

Maximum length: 128

sold_to.fax

string | null

Fax number

Maximum length: 32

sold_to.federal_tax_id

string | null

Federal tax ID

Maximum length: 32

sold_to.id

integer

Address ID

sold_to.name2

string | null

Name of the alternative contact?

Maximum length: 64

sold_to.phone1

string | null

Primary contact number

Maximum length: 32

sold_to.phone2

string | null

Alternate contact number

Maximum length: 32

sold_to.street2

string | null

Line 2 of the address

Maximum length: 128

sold_to.type

enum<string> | null

Type of address

Available options:

residential,

commercial

status

string

Status of shipment

Minimum length: 1

tracking

object

Show child attributes

tracking.delivered_at

string | null

Time of order delivery

tracking.picked_up_at

string | null

Time of order pickup

tracking.tracking_details

object[]

Show child attributes

tracking.tracking_details.status

string

required

Tracking status

Required string length: 1 - 32

tracking.tracking_details.status_detail

string

required

Status details

Required string length: 1 - 64

tracking.tracking_details.Time

string

required

Time of tracking (UTC format)

tracking.tracking_details.city

string | null

City of delivery

Maximum length: 32

tracking.tracking_details.country

string | null

Country of delivery

Maximum length: 8

tracking.tracking_details.id

integer

Tracking ID

tracking.tracking_details.postal_code

string | null

Postal code for delivery

Maximum length: 16

tracking.tracking_details.state

string | null

State of delivery

Maximum length: 8

tracking_number

string | null

Tracking number for shipment

Maximum length: 128

tracking_url

string

URL for tracking shipment

updated_at

string

Time of shipment update (UTC format)

valid_packing_slip

boolean

true: Shipment has valid packing slip <br /> false: Shipment does not valid packing slip

valid_shipping_label

boolean

true: Shipment has valid shipping label <br /> false: Shipment does not valid valid shipping label