Skip to main content
POST
/
shipment
/
tracking
Update package tracking
curl --request POST \
  --url https://prod01.oms.fabric.inc/api/v2/shipment/tracking \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-site-context: <x-site-context>' \
  --data '{
  "event": "picked up",
  "eventId": "627963716b19511e8a3a631b",
  "timestamp": "2019-09-30T07:58:30.996Z",
  "shipmentCarrier": "FEDEX",
  "location": "Reno, NV",
  "notes": {}
}'
[
  {
    "shipmentId": "627963716b19511e8a3a631b",
    "shipmentNum": "78974156816152",
    "invoiceId": "5674156816152",
    "allocationId": "112345678912340",
    "orderNumber": [
      "112345678912340",
      "112345678912340"
    ],
    "poNumber": "1125",
    "vendorId": "56",
    "statusCode": "SHIPPED",
    "type": "STANDARD",
    "reshipmentReasonCode": "Order went missing",
    "shipDate": "2022-06-06T07:58:30.996Z",
    "locationNum": "132412",
    "locationType": "DC",
    "totalCartons": 2,
    "masterTrackingNumber": "TX112345678",
    "shipToId": "1",
    "shipToAddress": {
      "addressLine1": "888 Broadway",
      "addressLine2": "505 suite",
      "addressLine3": "<string>",
      "addressLine4": "<string>",
      "city": "New York",
      "state": "NY",
      "country": "USA",
      "postalCode": "1003",
      "type": "home",
      "latitude": 134.13413,
      "longitude": 757.0435
    },
    "recipient": [
      {
        "name": {
          "first": "John",
          "middle": "<string>",
          "last": "Doe"
        },
        "email": "[email protected]",
        "phone": {
          "number": 10612345678,
          "type": "MOBILE"
        }
      }
    ],
    "cartons": [
      {
        "cartonNum": "1",
        "cartonType": "Package",
        "promisedDeliveryDate": "2022-05-26T07:58:30.996Z",
        "estimatedShipDate": "2022-05-25T07:58:30.996Z",
        "estimatedDeliveryDate": "2022-05-26T07:58:30.996Z",
        "shipmentMethod": "ground",
        "shipmentCarrier": "FEDEX",
        "weight": "500 gram",
        "trackingNumber": "1Z999AA10123456784",
        "trackingURL": "https://fedex.com/tracking",
        "trackingDetails": [
          {
            "event": "picked up",
            "eventId": "627963716b19511e8a3a631b",
            "timestamp": "2019-09-30T07:58:30.996Z",
            "shipmentCarrier": "FEDEX",
            "location": "Reno, NV",
            "notes": {}
          }
        ],
        "items": [
          {
            "shipmentLineItemId": "607f1f77bcf86cd799439011",
            "orderId": "317736896",
            "orderNumber": "507f1f77bcf86cd799439011",
            "lineItemId": "1",
            "itemId": "100023",
            "sku": "SKU0023",
            "channelId": "12",
            "segment": null,
            "vendorId": "56",
            "orderedQuantity": 2,
            "shippedQuantity": 2,
            "returnQuantity": 1,
            "returnAmount": 10,
            "fees": [
              {
                "type": "tax",
                "value": 34.56,
                "quantity": 12,
                "refundAmount": 10.4
              }
            ],
            "giftCard": [
              {
                "giftCardNum": "453456765",
                "amount": 50,
                "giftCardStatus": "ACTIVE",
                "giftCardActiveRequestDate": "2022-05-26T07:58:30.996Z",
                "giftCardActiveDate": "2022-06-26T07:58:30.996Z"
              }
            ],
            "attributes": {},
            "uom": null
          }
        ]
      }
    ],
    "scratchedItems": [
      {
        "orderId": "507f1f77bcf86cd799439012",
        "lineItemId": "2",
        "itemId": "100043",
        "sku": "SKU00043",
        "quantity": 1,
        "reasonCode": "<string>",
        "subReasonCode": "<string>",
        "attributes": {},
        "uom": null
      }
    ],
    "createdAt": "2022-06-06T07:58:30.996Z",
    "updatedAt": "2022-06-06T07:58:30.996Z",
    "auditLogs": [
      {
        "auditType": "create",
        "employeeId": "62272e917b12209e68751d94",
        "auditTimestamp": "2022-05-12T09:24:54.804Z",
        "source": "POS",
        "note": "Note",
        "attributes": {},
        "updatedFields": [
          {
            "attributeName": "UOM",
            "attributeOriginalValue": "PK"
          }
        ]
      }
    ],
    "attributes": {}
  }
]

Authorizations

​
Authorization
string
header
required

Headers

​
x-site-context
string
required
Example:

Body

application/json
​
event
string
Example:
​
eventId
string
Example:
​
timestamp
string
Example:
​
shipmentCarrier
string
Example:
​
location
string
Example:
​
notes
object

Response

​
shipmentId
string
Example:
​
shipmentNum
string
Example:
​
invoiceId
string
Example:
​
allocationId
string
Example:
​
orderNumber
string[]
Example:
​
poNumber
string
Example:
​
vendorId
string
Example:
​
statusCode
enum<string>
Available options:
SHIPMENT_CREATED,
SHIPMENT_CANCELLED,
PICKUP_CREATED,
PICKUP_COMPLETED,
SHIPMENT_RETURN_PENDING,
SHIPMENT_RETURN_RECEIVED,
SHIPMENT_PARTIALLY_DELIVERED,
SHIPMENT_DELIVERED
Example:
​
type
enum<string>
Available options:
STANDARD,
RESHIP,
RETURN,
SCRATCH,
PICKUP
Example:
​
reshipmentReasonCode
string
Example:
​
shipDate
string<date-time>
Example:
​
locationNum
string
Example:
​
locationType
string
Example:
​
totalCartons
integer
Example:
​
masterTrackingNumber
string
Example:
​
shipToId
string
Example:
​
shipToAddress
object
​
recipient
object[]
​
cartons
object[]
​
scratchedItems
object[]
​
createdAt
string<date-time>
Example:
​
updatedAt
string<date-time>
Example:
​
auditLogs
object[]
​
attributes
object