Receive inventory tracking

Authorizations

Authorization

string

header

required

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

Headers

x-fabric-tenant-id

string

required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-channel-id

string

required

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

x-fabric-request-id

string

Unique request ID

Path Parameters

transferShipmentId

string

required

Body

application/json

Transfer Receiving Request

cartons

object[]

Carton Details for receiving

An object containing information on the carton transfer.

Show child attributes

cartons.cartonNumber

string

required

The carton number.

Example:

"1"

cartons.items

object[]

An array of carton items.

An object containing cancellation information and properties for a line item.

Show child attributes

cartons.items.quantity

integer

required

The quantity of a specific item to be cancelled.

Required range: x >= 1

Example:

1

cartons.items.shipmentLineItemId

string

required

Unique shipment line item id

Example:

"13432-34343-34343-3434"

cartons.items.adjustments

object[]

An array adjustments that have been made.

An object containing all the transfer item adjustment properties.

Show child attributes

cartons.items.adjustments.adjustmentQuantity

integer

default:

0

The total adjustment quantity. The default value is 0.

Example:

2

cartons.items.adjustments.attributes

object

Attributes to save any additional info

Show child attributes

cartons.items.adjustments.attributes.{key}

object

Attributes to save any additional info

Example:

{ "attribute1": "value" }

Example:

{ "attribute1": "value" }

cartons.items.adjustments.reasonCode

string

The primary reason code for the item adjustment.

Example:

"DAMAGED"

cartons.items.adjustments.subReasonCode

string

The sub reason code for the item adjustment.

Example:

"DAMAGED"

cartons.items.attributes

object

Attributes to save any additional info

Show child attributes

cartons.items.attributes.{key}

object

Attributes to save any additional info

Example:

{ "attribute1": "value" }

Example:

{ "attribute1": "value" }

Response

200

application/json

OK

An object containing information and properties of the transfer shipment response.

shipFrom

object

required

An object containing information and properties for the transfers ship from location.

Show child attributes

shipFrom.locationNumber

string

required

Location number

Example:

"132412"

shipFrom.locationName

string

Location name

Example:

"Store1"

shipFrom.locationType

string

Location type

Example:

"STORE"

shipFrom.shipFromAddress

object

Order address model

Show child attributes

shipFrom.shipFromAddress.address1

string

required

The first address line.

Example:

"House No 129"

shipFrom.shipFromAddress.address2

string

The second address line.

Example:

"10 Downing Street"

shipFrom.shipFromAddress.address3

string

The third address line.

Example:

"Bakers Colony"

shipFrom.shipFromAddress.address4

string

The fourth address line.

Example:

"Near ABC School"

shipFrom.shipFromAddress.city

string

City

Example:

"Beaumont"

shipFrom.shipFromAddress.country

string

Country

Example:

"USA"

shipFrom.shipFromAddress.email

string

A valid email address.

Example:

"[e-mail]"

shipFrom.shipFromAddress.latitude

number

Latitude

Example:

35.294952

shipFrom.shipFromAddress.longitude

number

Longitude

Example:

32.294952

shipFrom.shipFromAddress.name

object

Order contact name model

Show child attributes

shipFrom.shipFromAddress.name.first

string

First name

Example:

"John"

shipFrom.shipFromAddress.name.last

string

Last name

Example:

"Doe"

shipFrom.shipFromAddress.name.middle

string

Middle name

Example:

"M"

shipFrom.shipFromAddress.phone

object

The contact phone number provided by the order.

Show child attributes

shipFrom.shipFromAddress.phone.number

string

Phone number

Example:

"[phone]"

shipFrom.shipFromAddress.phone.type

enum<string>

The phone number type. For example, MOBILE, HOME, or BUSINESS.

Available options:

MOBILE,

HOME,

BUSINESS

Example:

"MOBILE"

shipFrom.shipFromAddress.postalCode

string

Postal code

Example:

"77705"

shipFrom.shipFromAddress.state

string

State

Example:

"TX"

shipFrom.shipFromAddress.type

string

The type of address provided. For example, home or residence.

Example:

"residence"

shipTo

object

required

An object containing information and properties for the transfers ship to location.

Show child attributes

shipTo.locationNumber

string

required

Location number

Example:

"132412"

shipTo.locationName

string

Location name

Example:

"Store1"

shipTo.locationType

string

Location type

Example:

"STORE"

shipTo.shipToAddress

object

ShipmentShipToAddress Model

Show child attributes

shipTo.shipToAddress.addressLine1

string

Address line 1

Example:

"254 House number"

shipTo.shipToAddress.addressLine2

string

Address line 2

Example:

"888 Broadway"

shipTo.shipToAddress.addressLine3

string

Address line 3

Example:

"17th street"

shipTo.shipToAddress.addressLine4

string

Address line 4

Example:

"Pearl"

shipTo.shipToAddress.city

string

City

Example:

"New York"

shipTo.shipToAddress.country

string

Country

Example:

"USA"

shipTo.shipToAddress.latitude

number

Latitude

Example:

134.13413

shipTo.shipToAddress.longitude

number

Longitude

Example:

757.0435

shipTo.shipToAddress.postalCode

string

Postal code

Example:

"1003"

shipTo.shipToAddress.state

string

State

Example:

"NY"

shipTo.shipToAddress.type

string

The type of address that was provided.

Example:

"home"

shipTo.shipToId

string

Used to link item with it's shipping address in shipment

Example:

"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"

shipmentNumber

string

required

Shipment's unique identification number

Example:

"78974156816152"

transferId

string

required

Transfer ID for this shipment

Example:

"112345678912340"

transferNumber

string

required

Transfer number for this shipment

Example:

"112345678912340"

attributes

object

Attributes to save any additional info

Show child attributes

attributes.{key}

object

Attributes to save any additional info

Example:

{ "attribute1": "value" }

Example:

{ "attribute1": "value" }

auditLogs

object[]

Audit logs list

Details for updating shipment

Show child attributes

auditLogs.auditId

string

System-generated audit ID (UUID format)

Example:

"a05b72dc-78d8-4ea4-90fc-2fe6a1fe1111"

auditLogs.auditType

string

Audit type such as cancel, return, etc.

Example:

"CANCEL"

auditLogs.auditedAt

string

Audit time (UTC)

Example:

"2023-03-12T09:24:54.804Z"

auditLogs.employeeId

string

Employee (ID or name) who made the last update

Example:

"6227"

auditLogs.lineItemId

string

Merchant-defined unique identifier for each item in an order. When omitted, fabric will generate it during order creation, in UUID format.

Example:

"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"

auditLogs.note

string

Additional info, if any

Example:

"Note"

auditLogs.reasonCode

string

Merchant-defined reason code, varies from merchant to merchant

Example:

"Scratched item"

auditLogs.source

string

Merchant-defined source from where the update was initiated. There are no predefined values; possible values could be Customer Service Representative (CSR), Point-of-Sale (POS), etc.

Example:

"POS"

auditLogs.subReasonCode

string

Merchant-defined sub reason code; provides more clarity to audit reason

Example:

"Scratched item"

auditLogs.updatedFields

object[]

Audit log for change history

Audit log for change history

Show child attributes

auditLogs.updatedFields.fieldName

string

Field or property name that was updated

Example:

"UOM"

auditLogs.updatedFields.fieldOriginalValue

string

Original value of fieldName before it was updated

Example:

"PK"

cartons

object[]

Carton list

An object containing information and properties of the transfer shipment carton.

Show child attributes

cartons.attributes

object

Attributes to save any additional info

Show child attributes

cartons.attributes.{key}

object

Attributes to save any additional info

Example:

{ "attribute1": "value" }

Example:

{ "attribute1": "value" }

cartons.cartonNumber

string

Carton number

Example:

"1"

cartons.cartonType

string

Carton type

Example:

"Package"

cartons.estimatedDeliveryDate

string

Estimated delivery date

Example:

"2022-05-26T07:58:30.996Z"

cartons.estimatedShipmentDate

string

Estimated ship date

Example:

"2022-05-25T07:58:30.996Z"

cartons.items

object[]

List of item to be shipped

An object containing information and properties of the transfer shipment item.

Show child attributes

cartons.items.adjustments

object[]

Adjustment

An object containing all the transfer item adjustment properties.

Show child attributes

cartons.items.adjustments.adjustmentQuantity

integer

default:

0

The total adjustment quantity. The default value is 0.

Example:

2

cartons.items.adjustments.attributes

object

Attributes to save any additional info

Show child attributes

cartons.items.adjustments.attributes.{key}

object

Attributes to save any additional info

Example:

{ "attribute1": "value" }

Example:

{ "attribute1": "value" }

cartons.items.adjustments.reasonCode

string

The primary reason code for the item adjustment.

Example:

"DAMAGED"

cartons.items.adjustments.subReasonCode

string

The sub reason code for the item adjustment.

Example:

"DAMAGED"

cartons.items.attributes

object

Customized attributes

Show child attributes

cartons.items.attributes.{key}

object

Customized attributes

Example:

{ "attribute1": "value" }

Example:

{ "attribute1": "value" }

cartons.items.channelId

string

Channel id

Example:

"12"

cartons.items.deliveredQuantity

integer

default:

0

Delivered quantity

Example:

2

cartons.items.itemId

string

Item id

Example:

"100023"

cartons.items.lineItemId

string

Line item ID

Example:

"1"

cartons.items.packedQuantity

integer

default:

0

Packed quantity

Example:

2

cartons.items.quantityType

enum<string>

Transfer quantity type

Available options:

INCREMENT,

DECREMENT,

ABSOLUTE

cartons.items.receivedQuantity

integer

default:

0

Received quantity

Example:

2

cartons.items.segment

string

Segment

cartons.items.shipmentLineItemId

string

System generated shipment line item ID

Example:

"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"

cartons.items.shippedQuantity

integer

default:

0

Shipped quantity

Example:

2

cartons.items.sku

string

Sku

Example:

"SKU0023"

cartons.items.stockedQuantity

integer

default:

0

Stocked quantity

Example:

2

cartons.items.uom

string

Unit of measurement

Example:

"EA"

cartons.items.vendorId

string

Vendor ID

Example:

"vend12346667"

cartons.promisedDeliveryDate

string

Promised delivery date

Example:

"2022-05-26T07:58:30.996Z"

cartons.shipmentCarrier

string

Shipment carrier

Example:

"FEDEX"

cartons.shipmentMethod

string

Shipment method

Example:

"ground"

cartons.tracking

object[]

Tracking detail list

Shipment tracking details

Show child attributes

cartons.tracking.event

string

Shipment-specific event. Mandatory in the request body of Update shipment tracking - POST /shipments/actions/update-tracking endpoint

Example:

"picked up"

cartons.tracking.eventId

string

Event ID provided by carrier

Example:

"627963716b19511e8a3a631b"

cartons.tracking.eventRecordedAt

string

Time event was recorded (UTC)

Example:

"2019-09-30T07:58:30.996Z"

cartons.tracking.location

string

Delivery location

Example:

"Reno, NV"

cartons.tracking.notes

object

Attributes to save any additional info

Show child attributes

cartons.tracking.notes.{key}

string

Attributes to save any additional info

Example:

"{\"description\":\"Shipment picked up\"}"

Example:

{ "description": "Shipment picked up" }

cartons.tracking.shipmentCarrier

string

Shipment carrier

Example:

"FEDEX"

cartons.trackingNumber

string

Tracking number

Example:

"1Z999AA10123456784"

cartons.trackingURL

string

Tracking URL

Example:

"https://example.com/tracking"

cartons.weight

string

Weight

Example:

"500 gram"

createdAt

string

Created date

Example:

"2022-06-06T07:58:30.996Z"

deliveredAt

string

Delivered date of shipment

Example:

"2022-06-06T07:58:30.996Z"

masterTrackingNumber

string

Master tracking number

Example:

"TX112345678"

poNumber

string

Optional purchase order number

Example:

"1125"

receivedAt

string

Received date of shipment

Example:

"2022-06-06T07:58:30.996Z"

recipient

object[]

Recipient list

Shipment recipient details

Show child attributes

recipient.email

string

Recipient's email

Example:

"[e-mail]"

recipient.name

object

Contact person's name

Show child attributes

recipient.name.firstName

string

Contact person's first name

Example:

"Alex"

recipient.name.lastName

string

Contact person's last name

Example:

"Doe"

recipient.name.middleName

string

Contact person's middle name or initial

Example:

"E"

recipient.phone

object

Contact person's phone details

Show child attributes

recipient.phone.number

string

Contact person's phone number

Example:

"123-456-7890"

recipient.phone.type

enum<string>

Contact number type

Available options:

MOBILE,

HOME,

BUSINESS

Example:

"MOBILE"

shipmentId

string

Shipment's autogenerated unique id

Example:

"627963716b19511e8a3a631b"

shippedAt

string

Ship date

Example:

"2022-06-06T07:58:30.996Z"

statusCode

enum<string>

Transfer Shipment Status

Available options:

TRANSFER_SHIPMENT_PACKED,

TRANSFER_SHIPMENT_SENT,

TRANSFER_SHIPMENT_CREATED,

TRANSFER_SHIPMENT_DRAFT,

TRANSFER_SHIPMENT_DELIVERED,

TRANSFER_SHIPMENT_RECEIVED,

TRANSFER_SHIPMENT_STOCKED,

TRANSFER_SHIPMENT_CANCELLED,

TRANSFER_SHIPMENT_ERROR

Example:

"TRANSFER_SHIPMENT_CREATED"

stockReleaseTimeStamp

string

Stock release time stamp date

Example:

"2022-06-06T07:58:30.996Z"

subtype

enum<string>

Shipment subtype

Available options:

COD

Example:

"COD"

totalCartons

integer

Total number of cartons

Example:

2

type

enum<string>

Shipment types

Available options:

STANDARD,

RESHIP,

RETURN,

SCRATCH,

PENDING_RETURN,

PICKUP,

TRANSFER

Example:

"TRANSFER"

updatedAt

string

Updated date

Example:

"2022-06-06T07:58:30.996Z"

vendorId

string

Vendor ID

Example:

"56"