Acknowledge shipment receipt

PUT

retailers

{retailer_pk}

shipments

{id}

acknowledge

curl --request PUT \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_pk}/shipments/{id}/acknowledge/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": 677,
  "batch_number": 6,
  "label_reference": "Sample label 123",
  "shipping_method": {
    "name": "White Glove Bronze",
    "code": "cory_white_glove",
    "type": "ltl (less than truck load)",
    "carrier": {
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "generic_shipping_method": {
      "name": "LTL",
      "description": "Less than truckload (LTL)",
      "type": "ltl"
    }
  },
  "shipping_account": {
    "nickname": "Hobie FedEx",
    "carrier": {
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "is_first_party_bill": true
  },
  "tracking_number": "1Z9999999999999988",
  "tracking": {
    "picked_up_at": "2022-08-10T15:24:56Z",
    "delivered_at": "2022-09-10T15:24:56Z"
  },
  "has_commercial_invoice": true,
  "canceled_at": null,
  "sold_to": {
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_to": {
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_from": {
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_weight": 10,
  "ship_width": 1,
  "ship_length": 1,
  "ship_height": 1,
  "shipping_provider_identifier": "shp_3a61e10243da49ab92f0e3861d5d256b",
  "error_logs": {
    "message": "Sample errors to fix"
  },
  "acknowledged_at": "2022-08-10T15:24:56Z",
  "closed_at": null,
  "delivered_at": "2022-09-10T15:24:56Z",
  "shipped_at": "2022-09-10T15:24:56Z",
  "signature": null,
  "brand": {
    "name": "Marla Cielo",
    "code": "demo-brand",
    "website": null,
    "is_on_rcn": false,
    "requires_subscription": "enabled",
    "subscription_expires_at": "2024-09-19T13:32:10Z",
    "grace_period_ends_at": "2024-10-26T13:32:10Z",
    "inventory_policy": "managed",
    "status": "active"
  }
}'

{
  "id": 767,
  "order_id": 677,
  "batch_number": 6,
  "label_reference": "Sample label 123",
  "ordered_at": "2021-09-10T15:24:56Z",
  "customer_order_number": "765637",
  "retailer_order_number": "66367",
  "purchase_order_number": "PO-576",
  "shipping_method": {
    "id": 5,
    "name": "White Glove Bronze",
    "code": "cory_white_glove",
    "type": "ltl (less than truck load)",
    "carrier": {
      "id": 229,
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "generic_shipping_method": {
      "id": 5,
      "name": "LTL",
      "description": "Less than truckload (LTL)",
      "type": "ltl"
    }
  },
  "shipping_account": {
    "id": 3,
    "nickname": "Hobie FedEx",
    "owner": "Sample Owner",
    "carrier": {
      "id": 229,
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "is_first_party_bill": true
  },
  "tracking_number": "1Z9999999999999988",
  "tracking_url": "https://wwwapps.demo.com/WebTracking/track?track=yes&trackNums=1Z9999999999999988",
  "tracking": {
    "picked_up_at": "2022-08-10T15:24:56Z",
    "delivered_at": "2022-09-10T15:24:56Z",
    "tracking_details": [
      {
        "id": 78895456,
        "Time": "10-10-2022",
        "status": "Delivered",
        "status_detail": "Out for delivery",
        "country": "USA",
        "state": "New york",
        "city": "New york",
        "postal_code": "123R32"
      }
    ]
  },
  "status": "Shipped",
  "is_acknowledged": true,
  "has_commercial_invoice": true,
  "canceled_at": null,
  "sold_to": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_to": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_from": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_weight": 10,
  "ship_width": 1,
  "ship_length": 1,
  "ship_height": 1,
  "ship_girth": "<string>",
  "ship_volume": 4,
  "valid_packing_slip": true,
  "valid_shipping_label": true,
  "shipping_provider_identifier": "shp_3a61e10243da49ab92f0e3861d5d256b",
  "error_logs": {
    "id": 677,
    "message": "Sample errors to fix",
    "count": 12,
    "created_at": "2022-08-10T15:24:56Z"
  },
  "acknowledged_at": "2022-08-10T15:24:56Z",
  "closed_at": null,
  "delivered_at": "2022-09-10T15:24:56Z",
  "shipped_at": "2022-09-10T15:24:56Z",
  "updated_at": "2022-09-10T15:25:56Z",
  "created_at": "2022-09-10T15:24:56Z",
  "shipment_lines": [
    {
      "id": 1001,
      "order_line_number": "1001",
      "quantity": 1,
      "part": 1,
      "freight_class": 50,
      "updated_at": "2022-09-10T15:24:56Z",
      "variant": {
        "id": 249,
        "name": "Var45",
        "brand": {
          "id": 456,
          "code": "marla-store",
          "name": "Marla Store"
        },
        "identifier": "123-DEF12345",
        "brand_identifier": "HATR",
        "upc": 555555555202,
        "retailer_identifiers": [
          {
            "id": 5642,
            "retailer": {
              "id": 500,
              "name": "Demo Retailer",
              "code": "demo-retailer",
              "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
              "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
              "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
              "joined_at": "2021-08-03T17:24:12Z",
              "is_rcn_retailer": false,
              "is_onboarded": false,
              "platform": "fabric",
              "requires_subscription": "disabled",
              "brand_permit_creation_allowed": false,
              "website": "https://demoabc.com",
              "status": "active"
            },
            "identifier": "SKU976",
            "name": "Retailer Sample"
          }
        ]
      }
    }
  ],
  "signature": null,
  "brand": {
    "id": 500,
    "name": "Marla Cielo",
    "code": "demo-brand",
    "joined_at": "2022-09-10T15:24:56Z",
    "logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
    "cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
    "profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
    "website": null,
    "is_onboarded": false,
    "is_on_rcn": false,
    "requires_subscription": "enabled",
    "subscription_expires_at": "2024-09-19T13:32:10Z",
    "grace_period_ends_at": "2024-10-26T13:32:10Z",
    "subscription_is_expired": false,
    "subscription_is_on_grace_period": false,
    "subscription_is_delinquent": false,
    "inventory_policy": "managed",
    "status": "active"
  },
  "invoice_number": "RC123456"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

integer

required

Shipment ID

retailer_pk

number

required

Retailer ID

Body

application/json

order_id

integer

required

Order ID

Example:

677

batch_number

integer | null

Batch number of shipment

Required range: -2147483648 <= x <= 2147483647

Example:

6

label_reference

string | null

Label reference

Maximum length: 30

Example:

"Sample label 123"

shipping_method

object

shipping_account

object

tracking_number

string | null

Tracking number for shipment

Maximum length: 128

Example:

"1Z9999999999999988"

tracking

object

has_commercial_invoice

boolean

true: Shipment has commercial invoice Shipment does not have commercial invoice

Example:

true

canceled_at

string | null

Time of cancellation (UTC format)

Example:

null

sold_to

object

ship_to

object

ship_from

object

ship_weight

number | null

Shipment weight

Example:

10

ship_width

number | null

Shipment width

Example:

1

ship_length

number | null

Shipment length

Example:

1

ship_height

number | null

Shipment height

Example:

1

shipping_provider_identifier

string | null

Identifier of the shipping provider

Maximum length: 64

Example:

"shp_3a61e10243da49ab92f0e3861d5d256b"

error_logs

object

acknowledged_at

string | null

Time of acknowledgement (UTC format)

Example:

"2022-08-10T15:24:56Z"

closed_at

string | null

Time of shipment closure (UTC format)

Example:

null

delivered_at

string | null

Time of delivery (UTC format)

Example:

"2022-09-10T15:24:56Z"

shipped_at

string | null

Time of shipping (UTC format)

Example:

"2022-09-10T15:24:56Z"

signature

enum<string> | null

Signature criteria

Available options:

required,

not_required,

adult

Example:

null

brand

object

Response

200

application/json

order_id

integer

required

Order ID

Example:

677

integer

Shipment ID

Example:

767

batch_number

integer | null

Batch number of shipment

Required range: -2147483648 <= x <= 2147483647

Example:

6

label_reference

string | null

Label reference

Maximum length: 30

Example:

"Sample label 123"

ordered_at

string

Time of shipment creation (UTC format)

Example:

"2021-09-10T15:24:56Z"

customer_order_number

string

Customer order number

Minimum length: 1

Example:

"765637"

retailer_order_number

string

Retailer order number

Minimum length: 1

Example:

"66367"

purchase_order_number

string

Purchase order number

Minimum length: 1

Example:

"PO-576"

shipping_method

object

shipping_account

object

tracking_number

string | null

Tracking number for shipment

Maximum length: 128

Example:

"1Z9999999999999988"

tracking_url

string

URL for tracking shipment

Example:

"https://wwwapps.demo.com/WebTracking/track?track=yes&trackNums=1Z9999999999999988"

tracking

object

status

string

Status of shipment

Minimum length: 1

Example:

"Shipped"

is_acknowledged

boolean

true: Shipment is acknowledged false: Shipment is not acknowledged

Example:

true

has_commercial_invoice

boolean

true: Shipment has commercial invoice Shipment does not have commercial invoice

Example:

true

canceled_at

string | null

Time of cancellation (UTC format)

Example:

null

sold_to

object

ship_to

object

ship_from

object

ship_weight

number | null

Shipment weight

Example:

10

ship_width

number | null

Shipment width

Example:

1

ship_length

number | null

Shipment length

Example:

1

ship_height

number | null

Shipment height

Example:

1

ship_girth

string

Shipment girth

ship_volume

string

Shipment volume

Example:

4

valid_packing_slip

boolean

true: Shipment has valid packing slip false: Shipment does not valid packing slip

Example:

true

valid_shipping_label

boolean

true: Shipment has valid shipping label false: Shipment does not valid valid shipping label

Example:

true

shipping_provider_identifier

string | null

Identifier of the shipping provider

Maximum length: 64

Example:

"shp_3a61e10243da49ab92f0e3861d5d256b"

error_logs

object

acknowledged_at

string | null

Time of acknowledgement (UTC format)

Example:

"2022-08-10T15:24:56Z"

closed_at

string | null

Time of shipment closure (UTC format)

Example:

null

delivered_at

string | null

Time of delivery (UTC format)

Example:

"2022-09-10T15:24:56Z"

shipped_at

string | null

Time of shipping (UTC format)

Example:

"2022-09-10T15:24:56Z"

updated_at

string

Time of shipment update (UTC format)

Example:

"2022-09-10T15:25:56Z"

created_at

string

Time of shipment creation (UTC format)

Example:

"2022-09-10T15:24:56Z"

shipment_lines

object[]

signature

enum<string> | null

Signature criteria

Available options:

required,

not_required,

adult

Example:

null

brand

object

invoice_number

string

Invoice number

Example:

"RC123456"

List fulfillments or shipments from vendors Get active permits

curl --request PUT \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_pk}/shipments/{id}/acknowledge/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": 677,
  "batch_number": 6,
  "label_reference": "Sample label 123",
  "shipping_method": {
    "name": "White Glove Bronze",
    "code": "cory_white_glove",
    "type": "ltl (less than truck load)",
    "carrier": {
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "generic_shipping_method": {
      "name": "LTL",
      "description": "Less than truckload (LTL)",
      "type": "ltl"
    }
  },
  "shipping_account": {
    "nickname": "Hobie FedEx",
    "carrier": {
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "is_first_party_bill": true
  },
  "tracking_number": "1Z9999999999999988",
  "tracking": {
    "picked_up_at": "2022-08-10T15:24:56Z",
    "delivered_at": "2022-09-10T15:24:56Z"
  },
  "has_commercial_invoice": true,
  "canceled_at": null,
  "sold_to": {
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_to": {
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_from": {
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_weight": 10,
  "ship_width": 1,
  "ship_length": 1,
  "ship_height": 1,
  "shipping_provider_identifier": "shp_3a61e10243da49ab92f0e3861d5d256b",
  "error_logs": {
    "message": "Sample errors to fix"
  },
  "acknowledged_at": "2022-08-10T15:24:56Z",
  "closed_at": null,
  "delivered_at": "2022-09-10T15:24:56Z",
  "shipped_at": "2022-09-10T15:24:56Z",
  "signature": null,
  "brand": {
    "name": "Marla Cielo",
    "code": "demo-brand",
    "website": null,
    "is_on_rcn": false,
    "requires_subscription": "enabled",
    "subscription_expires_at": "2024-09-19T13:32:10Z",
    "grace_period_ends_at": "2024-10-26T13:32:10Z",
    "inventory_policy": "managed",
    "status": "active"
  }
}'

{
  "id": 767,
  "order_id": 677,
  "batch_number": 6,
  "label_reference": "Sample label 123",
  "ordered_at": "2021-09-10T15:24:56Z",
  "customer_order_number": "765637",
  "retailer_order_number": "66367",
  "purchase_order_number": "PO-576",
  "shipping_method": {
    "id": 5,
    "name": "White Glove Bronze",
    "code": "cory_white_glove",
    "type": "ltl (less than truck load)",
    "carrier": {
      "id": 229,
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "generic_shipping_method": {
      "id": 5,
      "name": "LTL",
      "description": "Less than truckload (LTL)",
      "type": "ltl"
    }
  },
  "shipping_account": {
    "id": 3,
    "nickname": "Hobie FedEx",
    "owner": "Sample Owner",
    "carrier": {
      "id": 229,
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "is_first_party_bill": true
  },
  "tracking_number": "1Z9999999999999988",
  "tracking_url": "https://wwwapps.demo.com/WebTracking/track?track=yes&trackNums=1Z9999999999999988",
  "tracking": {
    "picked_up_at": "2022-08-10T15:24:56Z",
    "delivered_at": "2022-09-10T15:24:56Z",
    "tracking_details": [
      {
        "id": 78895456,
        "Time": "10-10-2022",
        "status": "Delivered",
        "status_detail": "Out for delivery",
        "country": "USA",
        "state": "New york",
        "city": "New york",
        "postal_code": "123R32"
      }
    ]
  },
  "status": "Shipped",
  "is_acknowledged": true,
  "has_commercial_invoice": true,
  "canceled_at": null,
  "sold_to": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_to": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_from": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_weight": 10,
  "ship_width": 1,
  "ship_length": 1,
  "ship_height": 1,
  "ship_girth": "<string>",
  "ship_volume": 4,
  "valid_packing_slip": true,
  "valid_shipping_label": true,
  "shipping_provider_identifier": "shp_3a61e10243da49ab92f0e3861d5d256b",
  "error_logs": {
    "id": 677,
    "message": "Sample errors to fix",
    "count": 12,
    "created_at": "2022-08-10T15:24:56Z"
  },
  "acknowledged_at": "2022-08-10T15:24:56Z",
  "closed_at": null,
  "delivered_at": "2022-09-10T15:24:56Z",
  "shipped_at": "2022-09-10T15:24:56Z",
  "updated_at": "2022-09-10T15:25:56Z",
  "created_at": "2022-09-10T15:24:56Z",
  "shipment_lines": [
    {
      "id": 1001,
      "order_line_number": "1001",
      "quantity": 1,
      "part": 1,
      "freight_class": 50,
      "updated_at": "2022-09-10T15:24:56Z",
      "variant": {
        "id": 249,
        "name": "Var45",
        "brand": {
          "id": 456,
          "code": "marla-store",
          "name": "Marla Store"
        },
        "identifier": "123-DEF12345",
        "brand_identifier": "HATR",
        "upc": 555555555202,
        "retailer_identifiers": [
          {
            "id": 5642,
            "retailer": {
              "id": 500,
              "name": "Demo Retailer",
              "code": "demo-retailer",
              "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
              "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
              "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
              "joined_at": "2021-08-03T17:24:12Z",
              "is_rcn_retailer": false,
              "is_onboarded": false,
              "platform": "fabric",
              "requires_subscription": "disabled",
              "brand_permit_creation_allowed": false,
              "website": "https://demoabc.com",
              "status": "active"
            },
            "identifier": "SKU976",
            "name": "Retailer Sample"
          }
        ]
      }
    }
  ],
  "signature": null,
  "brand": {
    "id": 500,
    "name": "Marla Cielo",
    "code": "demo-brand",
    "joined_at": "2022-09-10T15:24:56Z",
    "logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
    "cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
    "profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
    "website": null,
    "is_onboarded": false,
    "is_on_rcn": false,
    "requires_subscription": "enabled",
    "subscription_expires_at": "2024-09-19T13:32:10Z",
    "grace_period_ends_at": "2024-10-26T13:32:10Z",
    "subscription_is_expired": false,
    "subscription_is_on_grace_period": false,
    "subscription_is_delinquent": false,
    "inventory_policy": "managed",
    "status": "active"
  },
  "invoice_number": "RC123456"
}

Authentication v1

User Self Service APIs

Experiences v2 (XM v2)

Experiences v1 (XM v1)

Product Catalog

Orders v2 (OMS v2)

Orders v1 (OMS v1)

Offers v2

Offers v1

Subscriptions (SMT API)

Loyalty (Member)

Dropship

Cart API

Checkout API

Customer

Acknowledge shipment receipt

Authorizations

Path Parameters

Body

Response