These new fields will only work when sending the new_format boolean as true. For this to work, you will also have to reach out to support and request the flag for the new snapshot format to be activated in the account from which you will pull the snapshot.
Starting on April 1st, 2025, we will remove these 2 conditions and fully deprecate the old format in favor of the new one. This means you won’t be able to request a snapshot in the old format, and using the new_format boolean will be deprecated.
New fields:
sell_ahead: Units from inbounds that have not yet been received and are flagged as available for sale.qty_in_totes: These are the units that were physically moved to totes after a pick.barcode: Main barcode assigned to an SKU.dimensions: An array of fields that returns all 4 dimensions of an SKU:height,width,lengthandweight.thumbnail: URL pointing to the thumbnail of the SKU as seen in the mobile app, for example.large_thumbnail: A higher resolution version of the above.
Here’s an extract of how you will receive the details for a single SKU within the snapshot:
"FU10040045":
{
"sku": "FU10040045",
"account_id": "QWNjb3VudDo2Mzg5OA==",
"vendors":
{
"VmVuZG9yOjQyMzA0OQ==":
{
"vendor_id": "VmVuZG9yOjQyMzA0OQ==",
"vendor_name": "Fujifilm",
"vendor_sku": ""
}
},
"warehouse_products":
{
"V2FyZWhvdXNlOjc2NzMz":
{
"warehouse_id": "V2FyZWhvdXNlOjc2NzMz",
"on_hand": 2313,
"allocated": 65,
"backorder": 3,
"available": 2235,
"reserve": 10,
"item_bins":
{
"QmluOjQyOTkzMDg=":
{
"location_id": "QmluOjQyOTkzMDg=",
"location_name": "A1",
"lot_id": "",
"lot_name": "",
"expiration_date": "",
"quantity": 170,
"sellable": true,
"qty_in_totes": 0
},
"QmluOjQzMTc5NTU=":
{
"location_id": "QmluOjQzMTc5NTU=",
"location_name": "AA-01-04-02",
"lot_id": "",
"lot_name": "",
"expiration_date": "",
"quantity": 1196,
"sellable": true,
"qty_in_totes": 0
},
"QmluOjQzMTc5NjU=":
{
"location_id": "QmluOjQzMTc5NjU=",
"location_name": "AA-01-01-03",
"lot_id": "",
"lot_name": "",
"expiration_date": "",
"quantity": 0,
"sellable": true,
"qty_in_totes": 0
},
"QmluOjUwMzk1Nzk=":
{
"location_id": "QmluOjUwMzk1Nzk=",
"location_name": "Receiving",
"lot_id": "",
"lot_name": "",
"expiration_date": "",
"quantity": 947,
"sellable": true,
"qty_in_totes": 0
}
},
"non_sellable": 0,
"sell_ahead": 0,
"qty_in_totes": 0
},
"V2FyZWhvdXNlOjgyNzQ4":
{
"warehouse_id": "V2FyZWhvdXNlOjgyNzQ4",
"on_hand": 50,
"allocated": 3,
"backorder": 0,
"available": 47,
"reserve": 0,
"item_bins":
{
"QmluOjU4ODIzNDU=":
{
"location_id": "QmluOjU4ODIzNDU=",
"location_name": "Test-Webhook",
"lot_id": "",
"lot_name": "",
"expiration_date": "",
"quantity": 50,
"sellable": true,
"qty_in_totes": 0
}
},
"non_sellable": 0,
"sell_ahead": 0,
"qty_in_totes": 0
},
"V2FyZWhvdXNlOjg1NTI2":
{
"warehouse_id": "V2FyZWhvdXNlOjg1NTI2",
"on_hand": 0,
"allocated": 0,
"backorder": 0,
"available": 0,
"reserve": 0,
"item_bins":
{},
"non_sellable": 0,
"sell_ahead": 0,
"qty_in_totes": 0
}
},
"barcode": "1|6501109",
"dimensions":
{
"weight": "192.00000000",
"height": "0.00000000",
"width": "0.00000000",
"length": "0.00000000"
},
"thumbnail": "URL",
"large_thumbnail": "URL"
}
Grouping by account ID
The new format adds a new level to the file structure in addition to the new fields described above. Inside the products field, you will find a new one enclosing the products themselves. This field returns the base64-encoded version of the account ID. For brand accounts, this will return its own ID and contain all its products, but 3PLs will now see the SKUs grouped by each child account.
Old format
{
"snapshot_id": "6749e3549a916c35ba9c7823",
"warehouse_id": "string",
"customer_account_id": "string",
"snapshot_started_at": "2024-11-29T15-52-52+00:00",
"products":
{
"FU10040045":
New format
{
"snapshot_id": "6749e1784ab5a54fd5d14a25",
"warehouse_id": "string",
"customer_account_id": "string",
"snapshot_started_at": "2024-11-29T15-57-59+00:00",
"products":
{
"QWNjb3VudDo2Mzg5OA==":
{
"FU10040045":