SkuVault

Developing for SkuVault

Welcome to SkuVault's API developer hub. You'll find comprehensive guides and documentation to help you start building your integration as quickly as possible, as well as support if you get stuck.

For partners, we offer a staging server whose data is separate from production.

Suggest Edits

/addItem

Moderate throttling
Add quantity to a warehouse location. Bulk version available

 
posthttps://app.skuvault.com/api/inventory/addItem
{  
   "Sku":"String",
   "Code":"String",
   "WarehouseId":0,
   "LocationCode":"String",
   "Quantity":0,
   "Reason":"String",
   "Note":"String",
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "AddItemStatus": "Success"
}

Body Params

Sku
string

Product SKU. Used when CODE is blank.

Code
string

Product CODE. Used when SKU is blank.

WarehouseId
int32
required

from getWarehouses

LocationCode
string
required

The warehouse location inventory will be added to.

Quantity
int32
required

Quantity to add.

Reason
string
required

Transaction reason must exist in SkuVault

Note
string

Transaction Note

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/addItemBulk

Moderate throttling
Add quantity to warehouse locations, 100 at a time.

 
posthttps://app.skuvault.com/api/inventory/addItemBulk
{  
   "Items":[  
      {  
         "Sku":"String",
         "Code":"String",
         "WarehouseId":0,
         "LocationCode":"String",
         "Quantity":0,
         "Reason":"String",
         "Note":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
    "Results": [
        "Success"
    ],
    "Status": "OK",
    "Errors": []
}

Body Params

Items
object
Items.Sku
string
required

Product SKU. Required if CODE is omitted.

Items.Code
string
required

Product code.

Items.WarehouseId
int32
required

from getWarehouses

Items.LocationCode
string
required
Items.Quantity
int32
required
Items.Reason
string
required

Transaction reason must exist in SkuVault

Items.Note
string

Transaction note

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/addShipments

Heavy throttling.
Using this call, users can add shipments to a sale.

 
posthttps://app.skuvault.com/api/sales/addShipments
{  
   "Shipments":[  
      {  
         "SaleId":"String",
         "Source":"String",
         "TrackingNumber":"String",
         "Carrier":"String",
         "Class":"String",
         "Type":"String",
         "Status":"String",
         "TrackingUrl":"String",
         "ShippedFrom":{  
            "WarehouseId":"0",
            "ThreePL":false,
            "Address":{  
               "FirstName":"String",
               "LastName":"String",
               "Company":"String",
               "Email":"String",
               "Address1":"String",
               "City":"String",
               "Region":"String",
               "Country":"String",
               "PostalCode":"String"
            }
         },
         "Costs":[  
            {  
               "CostType":"String",
               "Amount":0,
               "CurrencyIsoCode":"String"
            }
         ],
         "Parcels":[  
            {  
               "Number":0,
               "Weight":0,
               "WeightUnit":"String",
               "Note":"String",
               "Items":[  
                  {  
                     "Sku":"String",
                     "Quantity":0
                  }
               ]
            }
         ],
         "LandedCosts":[  
            {  
               "Sku":"String",
               "Amount":0,
               "CurrencyIsoCode":"String"
            }
         ]
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
    "Status": "OK",
    "Errors": []
}

Body Params

Shipments
object
Shipments.SaleId
string
required

If provided, the Sale ID must exist in SkuVault

Shipments.Source
string
required

Where the shipping information came from.

Shipments.TrackingNumber
string
required

The unique identifier for a shipment from a particular Carrier.

Shipments.Carrier
string
required

The shipping company responsible for taking the delivery from Point A to Point B.

Shipments.Class
string
required

The level of service the carrier was paid for.

Shipments.Type
string
required

The type of Shipment that is being transported to/from the warehouse. Accepts: "Fulfillment", "Return", "Exchange", "Replacement", "Warranty"

Shipments.Status
string
required

"Created" means the Shipment has been given a tracking number. "Voided" will void the Shipment.

Shipments.AlternateId
string

Alternate ID

Shipments.ManifestId
string

A list of Shipments

Shipments.Note
string

A note for the shipment.

Shipments.TotalWeight
double

Accepts decimal. This is the total weight of the shipment including all parcels in the shipment.

Shipments.WeightUnit
string

Units for the weight measurement. Accepts: "g", "oz", "lbs", "kgs"

Shipments.TrackingUrl
string
required

The URL where the Carrier provides tracking information for the shipment.

Shipments.CreatedDate
date

Date and Time that the shipment was created.

Shipments.EstimatedShipDate
date

At time of shipment, when order is expected to be picked up by the carrier.

Shipments.EstimatedDeliveryDate
date

At time of shipment, when order is expected to deliver.

Shipments.ShippedFrom
object
Shipments.ShippedFrom.WarehouseId
string
required

Warehouse ID. The ID must exist in SkuVault. If Shipments.ShippedFrom.ThreePL is "true", ID must belong to an external warehouse.

Shipments.ShippedFrom.ThreePL
boolean
required

True or False

Shipments.ShippedFrom.Address
object
Shipments.ShippedFrom.Address.FirstName
string
required

First Name

Shipments.ShippedFrom.Address.LastName
string
required

Last Name

Shipments.ShippedFrom.Address.MiddleName
string

Middle Name

Shipments.ShippedFrom.Address.Company
string
required

Company

Shipments.ShippedFrom.Address.Email
string
required

Email

Shipments.ShippedFrom.Address.Address1
string
required

Address 1

Shipments.ShippedFrom.Address.Address2
string

Address 2

Shipments.ShippedFrom.Address.City
string
required

City

Shipments.ShippedFrom.Address.Region
string

Region

Shipments.ShippedFrom.Address.Country
string
required

Country

Shipments.ShippedFrom.Address.PostalCode
string
required

Postal Code

Shipments.Costs
object
Shipments.Costs.CostType
string
required

The type of Shipping Cost appended to the shipment. Accepts: "Transportation", "Insurance", "Sales tax", "Gift Wrap", "Recycling Fee", "VAT Shipping", "VAT Gift Wrap", "Import Shipping", "Import Tax", "ThreePL"

Shipments.Costs.Amount
double
required

The Amount value of the Cost. Accepts decimals.

Shipments.Costs.CurrencyIsoCode
string
required

The type of currency associated with the cost.

Shipments.Parcels
object
Shipments.Parcels.Number
int32
required

The parcel number for each individual parcel.

Shipments.Parcels.Weight
double
required

Accepts decimals. The total weight of the parcel.

Shipments.Parcels.WeightUnit
string
required

The unit of measurement used. Accepts: "g", "oz", "lbs", "kgs".

Shipments.Parcels.Note
string
required

Note for the Parcel.

Shipments.Parcels.Items
object
Shipments.Parcels.Items.Sku
string
required

Sku for the item.

Shipments.Parcels.Items.Quantity
int32
required

Number of items associated with that SKU.

Shipments.Parcels.Dimensions
object
Shipments.Parcels.Dimensions.Height
double

Height. Accepts decimals.

Shipments.Parcels.Dimensions.Width
double

Width. Accepts decimals.

Shipments.Parcels.Dimensions.Length
double

Length. Accepts decimals.

Shipments.Parcels.Dimensions.Unit
string

Unit of Measurement. Accepts: "in", "ft", "yd", "mm", "cm", "m".

Shipments.LandedCosts
object
Shipments.LandedCosts.Sku
string
required

SKU

Shipments.LandedCosts.Amount
int32
required

Cost value of SKU item.

Shipments.LandedCosts.CurrencyIsoCode
string
required

Type of Currency for Amount

TenantToken
string
required

Tenant Token to access account

UserToken
string
required

User Token to access account

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/createBrands

Moderate throttling

 
posthttps://app.skuvault.com/api/products/createBrands
{
  "Brands": [
    {
      "Name": "String"
    }
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Status": "OK",
  "Errors": []
}

Body Params

Brands
object
Brands.Name
string
required

Name of Brand

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/createHolds

Moderate throttling

 
posthttps://app.skuvault.com/api/sales/createHolds
{  
   "Holds":[  
      {  
         "Sku":"String",
         "Quantity":0,
         "ExpirationDateUtc":"0001-01-01T00:00:00.0000000Z",
         "Description":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

[
    {
        "Sku": "string",
        "Quantity": 0
    }
]

Body Params

Holds
object
Holds.Sku
string
required

The SKU to place on hold.

Holds.Quantity
int32
required

The quantity.

Holds.ExpirationDateUtc
date
required

When this hold expires

Holds.Description
string
required

A description of the hold, eg: "Summer Flash Sale"

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Note on the Response

The quantity shown in the response is the product's new Available Quantity (Held quantity is deducted from Available).

Suggest Edits

/createKit

Moderate throttling
Using this call, users may create a kit inside of SkuVault.

 
posthttps://app.skuvault.com/api/products/createKit
{  
   "Sku":"String",
   "Title":"String",
   "Code":"String",
   "KitLines":[  
      {  
         "LineName":"String",
         "Combine":0,
         "Quantity":0,
         "Items":[  
            "String"
         ]
      }
   ],
   "AllowCreateAp":false,
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Success": "String"
}

Body Params

Sku
string
required

Kit SKU

Title
string
required

Kit Title

Code
string

Kit Code. Will be autogenerated if parameter is not included or if value is blank.

KitLines
object
KitLines.LineName
string
required

The name of the line for internal use.

KitLines.Combine
string
required

Substitute combine option. 1) Use up by priority. 2) Use single SKU if possible. 3) Never combine.

KitLines.Quantity
string
required

The quantity of the line item.

KitLines.Items
array of strings
required

List of Codes or SKUs that make up the line. More that one indicates substitutes.

AllowCreateAp
boolean

If true, will allow kit creation if a product with the same SKU exists, turning the product into an Assembled Product.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/createPO

Moderate throttling
This call let's you create a PO using our API.

 
posthttps://app.skuvault.com/api/purchaseorders/createPO
{  
   "PoNumber":"String",
   "SupplierName":"String",
   "OrderDate":"0001-01-01T00:00:00.0000000Z",
   "TermsName":"String",
   "OrderCancelDate":"0001-01-01T00:00:00.0000000Z",
   "Payments":[  
      {  
         "PaymentName":"String",
         "Amount":0,
         "Note":"String"
      }
   ],
   "SentStatus":"Undefined",
   "PaymentStatus":"Undefined",
   "ShippingCarrierClass":{  
      "CarrierName":"String",
      "ClassName":"String"
   },
   "ShipToWarehouse":"String",
   "ShipToAddress":"String",
   "ArrivalDueDate":"0001-01-01T00:00:00.0000000Z",
   "RequestedShipDate":"0001-01-01T00:00:00.0000000Z",
   "TrackingInfo":"String",
   "PublicNotes":"String",
   "PrivateNotes":"String",
   "LineItems":[  
      {  
         "SKU":"String",
         "Quantity":0,
         "QuantityTo3PL":0,
         "Cost":0,
         "PrivateNotes":"String",
         "PublicNotes":"String",
         "Variant":"String",
         "Identifier":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "CreatePOStatus": "Success"
}

Body Params

PoNumber
string

The number you wish to give this PO. If not provided, will automatically be generated.

SupplierName
string
required

The vendor you are purchasing from.

OrderDate
date

The date the PO was placed.

TermsName
string
OrderCancelDate
date

The date you wish to cancel the PO on if it has not been received.

Payments
object
Payments.PaymentName
string

Only accepted values are "Shipping" or "Tax".

Payments.Amount
double
Payments.Note
string
SentStatus
string

Sent Status - NotSent, Sent, and NeedToResend

PaymentStatus
string

Payment Status - NonePaid, PartiallyPaid, and FullyPaid

ShippingCarrierClass
object
ShippingCarrierClass.Carrier
string

The shipping carrier.

ShippingCarrierClass.Class
string

The shipping class.

ShipToWarehouse
string

This is the code of the warehouse in SkuVault. You can specify a warehouse that PO is for.

ShipToAddress
string

This is the Address Name of the warehouse in SkuVault. The address must exist for the ShipToWarehouse.

ArrivalDueDate
date

The date the PO is expected to arrive.

RequestedShipDate
date
TrackingInfo
string
PublicNotes
string

Notes for use on the PO template.

PrivateNotes
string

Notes for internal use only.

LineItems
object
LineItems.SKU
string
required

The SKU you are purchasing.

LineItems.Quantity
int32
required

The total quantity of the SKU you are purchasing.

LineItems.QuantityTo3PL
int32

The quantity of the SKU you are sending to 3PL.

LineItems.Cost
double

The cost of the SKU you are purchasing. If left blank, it will use the Supplier's Cost if the supplier is Active. Otherwise it will use the product's default cost (Product Cost Field).

LineItems.PrivateNotes
string
LineItems.PublicNotes
string
LineItems.Variant
string
LineItems.Identifier
string

Any other identifier used for the item.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Brief Mention about LineItems.Cost (Product Cost)

There is some minor logic in regards to how SkuVault knows which cost to apply to the product when syncing a PO (Purchase Order).

  • If you include a cost - We will always use the cost specified
  • If you exclude a cost - If the product has an active supplier associated with it that is the same as the PO's supplier, then we will use the Supplier cost. If the product has an inactive supplier (that is the same as the PO's supplier) or the product does not contain that supplier, we will use the Product's default cost (the Product Cost field).
Suggest Edits

/createProduct

Throttling: Moderate
Create products in SkuVault one at a time. Bulk version available: /createProducts

 
posthttps://app.skuvault.com/api/products/createProduct
{  
   "Sku":"String",
   "Description":"String",
   "ShortDescription":"String",
   "LongDescription":"String",
   "Classification":"String",
   "Supplier":"String",
   "Brand":"String",
   "Code":"String",
   "PartNumber":"String",
   "Cost":0,
   "SalePrice":0,
   "RetailPrice":0,
   "Weight":0,
   "WeightUnit":"String",
   "VariationParentSku":"String",
   "ReorderPoint":0,
   "MinimumOrderQuantity":0,
   "MinimumOrderQuantityInfo":"String",
   "Note":"String",
   "Statuses":[  
      "String"
   ],
   "Pictures":[  
      "http://www.example.com/image.jpg"
   ],
   "Attributes":{  
      "String":"String"
   },
   "AllowCreateAp":false,
   "SupplierInfo":[  
      {  
         "SupplierName":"String",
         "SupplierPartNumber":"String",
         "Cost":"String",
         "LeadTime":"String",
         "IsActive":"String",
         "IsPrimary":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Status": "OK"
}

Body Params

Sku
string
required

The SKU to give the product.

Description
string

This is the "Title" of your product.

ShortDescription
string

Limit 1000 characters

LongDescription
string

Limit 65665 characters.

Classification
string
required

Must exist in SkuVault.

Supplier
string
required

Primary Supplier for the product. Supplier must exist in SkuVault.

Brand
string
required

Must exist in SkuVault.

Code
string

Barcode number.

PartNumber
string

Manufacturer part number.

Cost
double

Accepts decimal; Your overall cost on hand for that product. Used for a default (fallback) cost field or for the cost averaging feature in SkuVault.

SalePrice
mixed type

Accepts decimal; Your selling price per unit

RetailPrice
double

Accepts decimal; MSRP per unit

Weight
double

Accepts decimal

WeightUnit
string

One of: "lbs", "kgs", "oz", "g"

VariationParentSku
string
ReorderPoint
int32

The point at which you should reorder quantity.

MinimumOrderQuantity
int32
MinimumOrderQuantityInfo
string
Note
string
Statuses
array of strings
Pictures
array of strings

List of picture urls

Attributes
object

Dictionary where key is attribute name and value is attribute value

AllowCreateAp
boolean

Creates an Assembled Product if the kit already exists.

SupplierInfo
object
SupplierInfo.SupplierName
string
required

The name of your supplier in SkuVault. It must exist in SkuVault and at least one supplier is required.

SupplierInfo.isPrimary
boolean
required

At least 1 supplier must be specified as primary (true).

SupplierInfo.Cost
double

This is the supplier's cost for that item.

SupplierInfo.SupplierPartNumber
string

Supplier's part number for that product. It is blank by default.

SupplierInfo.LeadTime
int32

Supplier's lead time.

SupplierInfo.isActive
boolean

If a supplier is active, we will use the supplier information (Cost, Supplier Part Number, etc.) when creating a Purchase Order.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Warning

Be sure to read Modifying Products.

Suggest Edits

/createProducts

Heavy throttling
Create 100 products per request.

 
posthttps://app.skuvault.com/api/products/createProducts
{  
   "Items":[  
      {  
         "Sku":"String",
         "Classification":"String",
         "Supplier":"String",
         "Brand":"String",
         "Description":"String",
         "ShortDescription":"String",
         "LongDescription":"String",
         "Code":"String",
         "PartNumber":"String",
         "Cost":0,
         "SalePrice":0,
         "RetailPrice":0,
         "Weight":0,
         "WeightUnit":"String",
         "VariationParentSku":"String",
         "ReorderPoint":0,
         "MinimumOrderQuantity":0,
         "MinimumOrderQuantityInfo":"String",
         "Note":"String",
         "Statuses":[  
            "String"
         ],
         "Pictures":[  
            "http://www.example.com/image.jpg"
         ],
         "Attributes":{  
            "String":"String"
         },
         "AllowCreateAp":false,
         "SupplierInfo":[  
            {  
               "SupplierName":"String",
               "SupplierPartNumber":"String",
               "Cost":"String",
               "LeadTime":"String",
               "IsActive":"String",
               "IsPrimary":"String"
            }
         ]
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Status": "Accepted",
  "Errors": [
    {
      "Sku": "String",
      "ErrorMessages": [
        "String"
      ]
    }
  ]
}
{
  "Errors": [],
  "Status": "OK"
}

Body Params

Items
object
Items.Sku
string
required

The SKU to give your product.

Items.Description
string

Now known as "Title" in the UI.

Items.ShortDescription
string

Limit 1000 characters.

Items.LongDescription
string

Limit 65665 characters.

Items.Classification
string
required

Must exist in SkuVault.

Items.Supplier
string
required

Primary Supplier for the product. Supplier must exist in SkuVault.

Items.Brand
string
required

Must exist in SkuVault.

Items.Code
string

Barcode number.

Items.PartNumber
string

Manufacturer part number.

Items.Cost
double

Accepts decimal; Your overall cost on hand for that product. Used for a default (fallback) cost field or for the cost averaging feature in SkuVault.

Items.SalePrice
double

Accepts decimal; Your selling price per unit

Items.RetailPrice
double

Accepts decimal; MSRP per unit

Items.Weight
double

Accepts decimal.

Items.WeightUnit
string

One of: "lbs", "kgs", "oz", "g"

Items.VariationParentSku
string
Items.ReorderPoint
int32

The point at which you should reorder quantity.

Items.MinimumOrderQuantity
int32
Items.MinimumOrderQuantityInfo
string
Items.Note
string

A note to place on the SKU.

Items.Statuses
array of strings

Attach tags or statuses to this SKU. The status must exist in SkuVault.

Items.Pictures
array of strings

List of picture urls.

Items.Attributes
object

Dictionary list where AttributeName is key, AttributeValue is value. AttributeName must exist under Classification.

Items.AllowCreateAp
boolean

Creates an Assembled Product if the kit already exists.

Items.SupplierInfo
object
Items.SupplierInfo.SupplierName
string
required

The name of your supplier in SkuVault. It must exist in SkuVault and at least one supplier is required.

Items.SupplierInfo.SupplierPartNumber
string

Supplier's part number for that product. It is blank by default.

Items.SupplierInfo.Cost
double

This is the supplier's cost for that item.

Items.SupplierInfo.LeadTime
int32

Supplier's lead time.

Items.SupplierInfo.isActive
boolean

If a supplier is active, we will use the supplier information (Cost, Supplier Part Number, etc.) when creating a Purchase Order.

Items.SupplierInfo.isPrimary
boolean
required

At least 1 supplier must be specified as primary (true).

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Warning

Be sure to read Modifying products.

Suggest Edits

/createSuppliers

Moderate throttling
Returns the list of current Suppliers in a SkuVault account.

 
posthttps://app.skuvault.com/api/products/createSuppliers
{
  "Suppliers": [
    {
      "EmailTemplateMessage": "String",
      "EmailTemplateSubject": "String",
      "Emails": [
        "String"
      ],
      "Name": "String"
    }
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ]
}

Body Params

Suppliers
object
Suppliers.Name
string
Suppliers.EmailTemplateSubject
string
Suppliers.EmailTemplateMessage
string
Suppliers.Emails
array of strings
TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getAvailableQuantities

Heavy throttling
Retrieve a list of SKUs and their total available quantities across all warehouses. Available Quantity is the quantity that is actually available to sell across all your sales channels.

 
posthttps://app.skuvault.com/api/inventory/getAvailableQuantities
{
  "ExpandAlternateSkus": false,
  "ModifiedAfterDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
  "ModifiedBeforeDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
  "PageNumber": 0,
  "PageSize": null,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Items": [
    {
      "AvailableQuantity": 0,
      "IsAlternateSku": false,
      "LastModifiedDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
      "Sku": "String"
    }
  ]
}

Body Params

ModifiedAfterDateTimeUtc
date

Inventory modified after UTC DateTime

ModifiedBeforeDateTimeUtc
date

Inventory modified before UTC DateTime

PageNumber
int32

The page number to retrieve.

PageSize
int32

Must be between 1000 and 5000.

ExpandAlternateSkus
boolean

If true, we will return alternate SKUs as a list instead of separate line items.

TenantToken
string
required

Acquired from getTokens.

UserToken
string
required

Acquired from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getBrands

Heavy throttling
Returns a list of Brands created in SkuVault.

 
posthttps://app.skuvault.com/api/products/getBrands
{
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Brands": [
    {
      "IsEnabled": false,
      "Name": "String"
    }
  ]
}

Body Params

PageNumber
int32

Page number, 1,000 results per page.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getClassifications

Heavy throttling
Returns classifications and, if they exist, their named attributes.

 
posthttps://app.skuvault.com/api/products/getClassifications
{
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Classifications": [
    {
      "Attributes": [
        {
          "IsEnabled": false,
          "IsRequired": false,
          "Name": "String",
          "Values": [
            "String"
          ]
        }
      ],
      "IsEnabled": false,
      "Name": "String"
    }
  ]
}

Body Params

PageNumber
int32

Page number. 1,000 results per page.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getExternalWarehouseQuantities

Heavy throttling
This call gets the quantities in a designated External Warehouse. Please note these are different than ordinary warehouses.

 
posthttps://app.skuvault.com/api/inventory/getExternalWarehouseQuantities
{
  "GetTotalFbaQuantities": false,
  "PageNumber": 0,
  "PageSize": null,
  "WarehouseId": "String",
  "TenantToken": "String",
  "Usertoken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Quantities": [
    {
      "InStockQuantity": 0,
      "InboundQuantity": 0,
      "ReserveQuantity": 0,
      "Sku": "String",
      "TotalQuantity": 0,
      "TransferQuantity": 0
    }
  ]
}

Body Params

GetTotalFbaQuantities
boolean

Will return the sum of the FBA quantities and warehouses that are associated with an Amazon account in SkuVault. NOTE: If true, then WarehouseId parameter will be ignored.

PageNumber
int32

The page number to be retrieved starting with 0. Defaults to page 0.

PageSize
int32

The number of SKUs to return per page. Can be any number between 1000 and 100000.

WarehouseId
int32
required

from getExternalWarehouses

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getExternalWarehouses

Moderate throttling.
Returns your external warehouses. No page parameters.

 
posthttps://app.skuvault.com/api/inventory/getExternalWarehouses
{
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Warehouses": [
    {
      "Code": "String",
      "Id": "String"
    },
    {
      "Code": "String",
      "Id": "String"
    }
  ]
}

Body Params

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getHandlingTime

 
posthttps://app.skuvault.com/api/products/getHandlingTime
{
   "TenantToken": "String",
   "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{  
   "Items":[  
      {  
         "AccountId":"0",
         "Kits":[  
            {  
               "Sku":"String",
               "Quantity":0
            }
         ],
         "Products":[  
            {  
               "Sku":"String",
               "Quantity":0
            }
         ]
      }
   ],
   "Status":"String",
   "Errors":[  

   ]
}

Body Params

Tenant Token
string
required

from getTokens

User Token
string
required

from getTokens

Headers

Content-Type
string
Accept
string
 
Suggest Edits

/getIncomingItems

Get incoming items for incomplete purchase orders

 
posthttps://app.skuvault.com/api/purchaseorders/getIncomingItems
{  
  "PageNumber":0,
  "TenantToken":"String",
  "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{  
   "SoldItems":[  
      {  
         "SKU":"String",
         "Date":"0001-01-01T00:00:00.0000000Z",
         "Quantity":0,
         "TotalPrice":0
      }
   ],
   "Status":"String",
   "Errors":[  

   ]
}

Body Params

PageNumber
int32

Page number with 0 being the first page. Defaults to 0.

TenantToken
string
required

Tenant Token to access account

UserToken
string
required

User Token to access account

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getIntegrations

Severe throttling.
Returns a list of your enabled channel accounts. No page parameters.

 
posthttps://app.skuvault.com/api/integration/getIntegrations
{
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Accounts": [
    {
      "Id": "101",
      "LongId": "1-600001-2-101",
      "Name": "My Channel Advisor Account",
      "Type": "ChannelAdvisor"
    },
    {
      "Id": "102",
      "LongId": "1-600001-8-102",
      "Name": "My Amazon Account",
      "Type": "Amazon"
    }
  ]
}

Body Params

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getInventoryByLocation

Heavy throttling
Returns location and warehouse per product.

 
posthttps://app.skuvault.com/api/inventory/getInventoryByLocation
{
  "IsReturnByCodes": false,
  "PageNumber": 0,
  "ProductCodes": [
  ],
  "ProductSKUs": [
  ],
  "TenantToken": "String",
  "Usertoken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Items": {
    "SKU-as-Key": [
      {
        "LocationCode": "String",
        "Quantity": 0,
        "Reserve": false,
        "WarehouseCode": "String"
      }
    ]
  }
}

Body Params

IsReturnByCodes
boolean

List products by code instead of SKU.

PageNumber
int32

10,000 products per page.

ProductCodes
array of strings

Filter by product codes.

ProductSKUs
array of strings

Filter by product SKUs.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

On filtering

If filtering by SKU, IsReturnByCodes must be null or false. Likewise, if filtering by Code, IsReturnByCodes must be true.

Suggest Edits

/getItemQuantities

Heavy throttling
Returns product quantities.

 
posthttps://app.skuvault.com/api/inventory/getItemQuantities
{
  "ModifiedAfterDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
  "ModifiedBeforeDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
  "PageNumber": 0,
  "PageSize": null,
  "ProductCodes": [
    "String"
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Items": [
    {
      "AvailableQuantity": 0,
      "Code": "String",
      "HeldQuantity": 0,
      "LastModifiedDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
      "PendingQuantity": 0,
      "PickedQuantity": 0,
      "Sku": "String",
      "TotalOnHand": 0
    }
  ]
}

Body Params

ModifiedAfterDateTimeUtc
date

Product inventory modified after date time in UTC.

ModifiedBeforeDateTimeUtc
date

Product inventory modified before date time in UTC.

ProductCodes
array of strings

Filter results by a list of Codes

PageNumber
int32
PageSize
int32

Value should be between 1000 and 10000.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getKitQuantities

Heavy throttling
Returns kit quantities.

 
posthttps://app.skuvault.com/api/inventory/getKitQuantities
{
  "ModifiedAfterDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "ModifiedBeforeDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Kits": [
    {
      "AvailableQuantity": 0,
      "LastModifiedDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
      "Sku": "String"
    }
  ]
}

Body Params

ModifiedAfterDateTimeUtc
date

Kit inventory modified after date time in UTC.

ModifiedBeforeDateTimeUtc" ModifiedBeforeDateTimeUtc
date

Kit inventory modified before date time in UTC.

PageNumber
int32

10,000 kits per page.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getKits

Heavy throttling
Returns kit details.

 
posthttps://app.skuvault.com/api/products/getKits
{
  "AvailableQuantityModifiedAfterDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "AvailableQuantityModifiedBeforeDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "GetAvailableQuantity": false,
  "IncludeKitCost": false,
  "KitSKUs": [
    "String"
  ],
  "ModifiedAfterDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "ModifiedBeforeDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Kits": [
    {
      "AvailableQuantity": 0,
      "AvailableQuantityLastModifiedDateTimeUtc": "",
      "Statuses":[  
            "String"
         ],
      "Code": "String",
      "Cost": 0,
      "Description": "String",
      "KitLines": [
        {
          "Combine": 1,
          "Items": [
            {
              "Code": "String",
              "Description": "String",
              "SKU": "String"
            }
          ],
          "LineName": "String",
          "Quantity": 1
        }
      ],
      "LastModifiedDateTimeUtc": "2015-07-10 15:53:20Z",
      "SKU": "String"
    }
  ]
}

Body Params

AvailableQuantityModifiedAfterDateTimeUtc
date

Modified kit quantities after date time in UTC.

AvailableQuantityModifiedBeforeDateTimeUtc
date

Modified kit quantities before date time in UTC.

GetAvailableQuantity
boolean

If false, AvailableQuantity will always return 0.

IncludeKitCost
boolean

If true, then return cost for the kit with response

KitSKUs
array of strings

Filter results by a list of SKUs.

ModifiedAfterDateTimeUtc
date
required
ModifiedBeforeDateTimeUtc
date
required
PageNumber
int32
TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getLocations

Severe throttling. Returns all your locations in enabled warehouses.

 
posthttps://app.skuvault.com/api/inventory/getLocations
{  
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{  
   "Items":[  
      {  
         "WarehouseCode":"String",
         "WarehouseName":"String",
         "LocationCode":"String",
         "ContainerCode":"String",
         "ParentLocation":"String",
         "TotalQuantity":5
      }
   ],
   "Status":"OK",
   "Errors":[  

   ]
}

Body Params

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getOnlineSaleStatus

Heavy throttling
Returns a list of sales and their statuses.

 
posthttps://app.skuvault.com/api/sales/getOnlineSaleStatus
{
  "OrderIds": [
    "String"
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Sales": [
    {
      "Id": "String",
      "Items": [
        {
          "OnlineSaleItemStatus": "String",
          "Quantity": 1,
          "Sku": "String"
        }
      ],
      "LastPrintedDate": "0001-01-01T00:00:00.0000000Z",
      "Notes": "",
      "PrintedStatus": false,
      "Status": "String"
    }
  ]
}

Body Params

OrderIds
array of strings
required

List of IDs to get status on. Only 10000 orders can be accessed at at a time. All extra IDs will be ignored.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getPOs

Heavy throttling.
Returns a list of purchase orders.

 
posthttps://app.skuvault.com/api/purchaseorders/getPOs
{
  "IncludeProducts": false,
  "ModifiedAfterDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "ModifiedBeforeDateTimeUtc": "0001-01-01T00:00:00.0000000Z",
  "PageNumber": 0,
  "Status": "String",
  "PONumbers":["test1","test2"],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "PurchaseOrders": [
   {
      "PoId": "500",
      "PoNumber": "SVPO2000000370",
      "Status": "Cancelled",
      "PaymentStatus": "NonePaid",
      "SupplierName": "Unknown",
      "CreatedDate": "2016-06-30T16:18:55.8758885Z",
      "OrderDate": "2016-07-01T03:59:59.9990000Z",
      "OrderCancelDate": "0001-01-01T00:00:00.0000000Z",
      "ArrivalDueDate": "2016-07-01T03:59:59.9990000Z",
      "RequestedShipDate": "2016-07-01T03:59:59.9990000Z",
      "ActualShippedDate": "0001-01-01T00:00:00.0000000Z",
      "TrackingInfo": "String",
      "PublicNotes": "String",
      "PrivateNotes": "String",
      "TermsName": "String",
      "ShipToWarehouse": "N/A",
      "ShipToAddress": "N/A",
      "ShippingCarrierClass": {
        "CarrierName": "String",
        "ClassName": "String"
      },
      "Costs": [],
      "LineItems": [
        {
          "ProductId": "String",
          "SKU": "String",
          "Quantity": 2,
          "QuantityTo3PL": 1,
          "ReceivedQuantity": 1,
          "ReceivedQuantityTo3PL": 0,
          "Cost": 400,
          "RetailCost": 0,
          "PrivateNotes": "String",
          "PublicNotes": "String",
          "Variant": "String",
          "Identifier": "String"
        }
      ]
    }
  ]
}

Body Params

ModifiedAfterDateTimeUtc
date
ModifiedBeforeDateTimeUtc
date
Status
string

We will return all POs that are not completed by Default. To get completed PO's, you must intentionally specify in the call. Possible values are: NoneReceived, PartiallyReceived, Completed, Cancelled

PageNumber
int32

10,000 POs are returned per page.

IncludeProducts
boolean

Returns incoming product details in separate array.

PONumbers
array of strings

A list of PO Numbers you can request data for. If using this parameter, the Date parameters and Status parameter is ignored.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getProducts

Heavy throttling
This call returns product (not kit) details. In addition to product information, the response also includes product quantities.

 
posthttps://app.skuvault.com/api/products/getProducts
{
  "ModifiedAfterDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
  "ModifiedBeforeDateTimeUtc": "0000-00-00T00:00:00.0000000Z",
  "ProductCodes": [
    "String"
    ],
  "PageNumber": 0,
  "PageSize": 0,
  "ProductSKUs": [
    "String"
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{  
   "Products":[  
      {  
         "Id":"String",
         "Code":"String",
         "Sku":"String",
         "PartNumber":"String",
         "Description":"String",
         "ShortDescription":"String",
         "LongDescription":"String",
         "Cost":0,
         "RetailPrice":0,
         "SalePrice":0,
         "WeightValue":"0",
         "WeightUnit":"String",
         "ReorderPoint":0,
         "Brand":"String",
         "Supplier":"String",
         "SupplierInfo":[  
            {  
               "SupplierName":"String",
               "SupplierPartNumber":"String",
               "Cost":0,
               "LeadTime":0,
               "IsActive":true,
               "IsPrimary":true
            }
         ],
         "Classification":"String",
         "QuantityOnHand":0,
         "QuantityOnHold":0,
         "QuantityPicked":0,
         "QuantityPending":0,
         "QuantityAvailable":0,
         "QuantityIncoming":0,
         "QuantityInbound":0,
         "QuantityTransfer":0,
         "QuantityInStock":0,
         "QuantityTotalFBA":0,
         "CreatedDateUtc":"0000-00-00T00:00:00.0000000Z",
         "ModifiedDateUtc":"0000-00-00T00:00:00.0000000Z",
         "Pictures":[  
            "http://www.example.com/image.jpg"
         ],
         "Attributes":[  
            {  
               "Name":"Attribute1",
               "Value":"ExampleValue"
            }
         ],
         "VariationParentSku":"",
         "IsAlternateSKU":false,
         "IsAlternateCode":false,
         "MOQ":0,
         "MOQInfo":"",
         "IncrementalQuantity":1,
         "DisableQuantitySync":false,
         "Statuses":[  
            "Status1",
            "Status2"
         ]
      }
   ],
   "Errors":[  

   ]
}

Body Params

ModifiedAfterDateTimeUtc
date

Modified product details after date time in UTC.

ModifiedBeforeDateTimeUtc
date

Modified product details before date time in UTC.

PageNumber
int32
PageSize
int32

Should be between 1000 and 10000.

ProductCodes
array of strings

Filter results by a list of Product Codes

ProductSKUs
array of strings

Filter results by a list of SKUs.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Alternate SKUs/Codes

If specific codes/SKUs aren't requested (using "ProductCodes" or "ProductSkus" parameters), then all Alternate SKUs will always be returned as separate objects within the product array. The "IsAlternateSku" boolean will indicate whether the SKU is an Alternate (value of "true) or the primary or parent SKU (value of "false").

Currently, products will only return under their Primary Code unless Alternate Codes are specified in the "ProductCodes" parameter.

Suggest Edits

/getReceivesHistory

Heavy throttling.
Returns a list of purchase order receives and receipts.

 
posthttps://app.skuvault.com/api/purchaseorders/getReceivesHistory
{  
   "WarehouseFilter":[  
      "String"
   ],
   "PageNumber":0,
   "PageSize":0,
   "PoNumberFilter":[  
      "String"
   ],
   "ReceivedAfterDateTimeUTC":"0000-00-00T00:00:00.0000000Z",
   "ReceivedBeforeDateTimeUTC":"0000-00-00T00:00:00.0000000Z",
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{  
   "Corrections":[  
      {  
         "Code":"String",
         "CorrectedDate":"0000-00-00T00:00:00.0000000Z",
         "NewQuantity":0,
         "NewQuantity3pl":0,
         "OldQuantity":0,
         "OldQuantity3pl":0,
         "PONumber":"String",
         "PartNumber":"String",
         "QuantityByReceiptDate":[  
            {  
               "NewQuantity":0,
               "OldQuantity":0,
               "ReceiptDate":"0000-00-00T00:00:00.0000000Z"
            }
         ],
         "ReceivedDate":"0000-00-00T00:00:00.0000000Z",
         "SKU":"String",
         "Username":"String"
      }
   ],
   "Receives":[  
      {  
         "Code":"String",
         "Location":"String",
         "PONumber":"String",
         "PartNumber":"String",
         "Quantity":0,
         "Quantity3pl":0,
         "QuantityToLocation":0,
         "ReceiptDate":"0000-00-00T00:00:00.0000000Z",
         "ReceivedDate":"0000-00-00T00:00:00.0000000Z",
         "SKU":"String",
         "Username":"String",
         "Warehouse":"String"
      }
   ]
}

Body Params

WarehouseFilter
array of strings

Filter to get receives for one or a list of Warehouse Codes

PageNumber
int32

Specify which page to return.

PageSize
int32

Specify page size. Value should be between 1000 and 10000. Default is 10000. We will return the "Receives" collection first, then the "Corrections" collections last.

PoNumberFilter
array of strings

Filter to get receives for one or a list of PO's

ReceivedAfterDateTimeUTC
date

Filter for receives after this date and time.

ReceivedBeforeDateTimeUTC
date

Filter for receives before this date and time.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Corrections field

Corrections are always returned. Even if you are specifying a warehouse, this is always returned as Corrections can not be determined on a per warehouse level. Therefore, if you are filtering on a warehouse level, these may not be 100% accurate.

  • All dates are returned in UTC format. Therefore, the "ReceiptDate" parameter will almost always be a day ahead of when the actual receipt is. For example, in the above "Example Response," the Receipt Date of "2016-01-23T00:00:00.0000000Z" is actually January 22 (UTC -> EST for example).
  • The "ReceivedDate" returned in the Corrections array will not contain a time. This is because it is impossible for this to be accurate. Why? Because you may have multiple receives at different times for the same SKU on the same day.
  • The Code/PartNumber parameters are the Code/PartNumber on that PO. So, if the product is deleted/recreated, it will not contain the new information, because the old product is what is on the PO.
Suggest Edits

/getSaleItemCost

Heavy throttling
Retrieves the Item Cost for a Product for a Specific Sale.

 
posthttps://app.skuvault.com/api/sales/getSaleItemCost
   {  
   "SaleIds":[  
      "String"
   ],
   "TenantToken":"String",
   "UserToken":"String"
   }
A binary file was returned

You couldn't be authenticated

{  
   "Sales":[  
      {  
         "SaleId":"String",
         "Items":[  
            {  
               "Sku":"String",
               "Cost":{  
                  "a":0,
                  "s":"String"
               }
            }
         ]
      }
   ],
   "Status":"String",
   "Errors":[  

   ]
}

Body Params

SaleIds
string

List of sale IDs. Can be one or multiple.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

 
Suggest Edits

/getSales

Heavy throttling
Use this call to retrieve a list of sales from SkuVault. 10,000 sales are returned per page.

 
posthttps://app.skuvault.com/api/sales/getSales
{
  "OrderIds": [
    "String"
  ],
  "Status": "ReadyToShip",
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
    "Sales": [
        {
            "Id": "String",
            "MarketplaceId": "String",
            "ChannelId": "String",
            "Status": "String",
            "SaleDate": "String",
            "Marketplace": "String",
            "MerchantItems": [
                {
                    "Sku": "String",
                    "Quantity": 0,
                    "UnitPrice": {
                        "a": 0,
                        "s": "String"
                    }
                }
            ],
            "FulfilledItems": [],
            "MerchantKits": [
                {
                    "Sku": "String",
                    "Quantity": 0,
                    "UnitPrice": {
                        "a": 1,
                        "s": "String"
                    },
                    "KitItems": {}
                }
            ],
            "FulfilledKits": [],
            "ShippingCost": {
                "a": 0,
                "s": "$"
            },
            "ShippingCharge": {
                "a": 0,
                "s": "$"
            },
            "ShippingInfo": {
                "City": "String",
                "Region": "String",
                "Country": "String",
                "PostalCode": "String",
                "Address1": "String",
                "Address2": "String"
            },
            "ContactInfo": {
                "FirstName": "String",
                "LastName": "String",
                "Company": "String",
                "Phone": "String",
                "Email": "String"
            },
            "ShippingCarrier": "String",
            "ShippingClass": "String",
            "Notes": "String",
            "PrintedStatus": true,
            "LastPrintedDate": "String"
        }
    ]
}

Body Params

Status
string

One of: ReadyToShip, Pending

OrderIds
array of strings

This is a list of order IDs that you can query for. Max 10000 per call. If you query for orders, we will only return those orders and ignore the "Status" filter. Essentially, it overwrites this filter. Also, take note that you can only filter for orders that originated from the API if you send in an Order ID. If you send in the full SkuVault ID, it will return the sale that matches that regardless of its source.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getSalesByDate

Heavy throttling
Returns sales based on a date range. 10,000 sales are returned per page.

 
posthttps://app.skuvault.com/api/sales/getSalesByDate
{
  "DateField": "Modified",
  "FromDate": "0001-01-01T00:00:00.0000000Z",
  "ToDate": "0001-01-01T00:00:00.0000000Z",
  "PageSize": 1000,
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

[
    {
        "Id": "1-1-1-1-sale1",
        "MarketplaceId": "String",
        "ChannelId": "String",
        "Status": "ReadyToShip",
        "SaleDate": "2017-02-02T15:11:11.8660000Z",
        "Marketplace": "Manual",
        "MerchantItems": [
            {
                "Sku": "String",
                "Quantity": 1,
                "UnitPrice": {
                    "a": 0,
                    "s": "$"
                },
                "PartNumber": ""
            }
        ],
        "FulfilledItems": [],
        "MerchantKits": [],
        "FulfilledKits": [],
        "ProcessedItems": [
            {
                "Sku": "string",
                "PickedQuantity": 0,
                "FailedQuantity": 0,
                "PassedQuantity": 0
            }
           ],   
        "Client": "",
        "Channel": "Manual",
        "ShippingCost": {
            "a": 0,
            "s": "$"
        },
        "ShippingCharge": {
            "a": 0,
            "s": "$"
        },
        "ShippingCarrier": "",
        "ShippingClass": "",
        "ShippingInfo": {
            "City": "",
            "Region": "",
            "Country": "",
            "PostalCode": "",
            "Address1": "",
            "Address2": ""
        },
        "ContactInfo": {
            "FirstName": "",
            "LastName": "",
            "Company": "",
            "Phone": "",
            "Email": ""
        },
        "Notes": "",
        "PrintedStatus": false,
        "LastPrintedDate": "0001-01-01T00:00:00.0000000Z"
    }
]

Body Params

DateField
string

2 possible values: Modified or Sale. A value of Modified will have the call return sales that have a last modified date within the date range specified. A value of Sale will search for sales that have an order date within the specified date range. (Using Sale is the how the call works when the DateField parameter isn't included at all)

FromDate
date
required

Start of inclusive time interval.

ToDate
date
required

End of inclusive time interval.

PageNumber
int32
PageSize
int32

Number of sales to return per page. Can be a value between 1000 and 10000. It is 10000 by default.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Date range must not be more than 7 days.

Suggest Edits

/getShipments

Heavy throttling.
Using this call, users can get current shipment information.

 
posthttps://app.skuvault.com/api/sales/getShipments
{  
  "SaleIds":[
    "String"
  ],
  "TenantToken":"String",
  "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{  
   "Shipments":[  
      {  
         "SaleId":"String",
         "Source":"String",
         "TrackingNumber":"String",
         "Carrier":"String",
         "Class":"String",
         "Type":"String",
         "Status":"String",
         "AlternateId":"String",
         "ManifestId":"String",
         "Note":"String",
         "TotalWeight":0,
         "WeightUnit":"String",
         "TrackingUrl":"String",
         "CreatedDate":"0001-01-01T00:00:00.0000000Z",
         "EstimatedShipDate":"0001-01-01T00:00:00.0000000Z",
         "EstimatedDeliveryDate":"0001-01-01T00:00:00.0000000Z",
         "ShippedFrom":{  
            "WarehouseCode":"String",
            "ThreePL":false,
            "Address":{  
               "FirstName":"String",
               "LastName":"String",
               "MiddleName":"String",
               "Company":"String",
               "Email":"String",
               "Address1":"String",
               "Address2":"String",
               "City":"String",
               "Region":"String",
               "Country":"String",
               "PostalCode":"String"
            }
         },
         "Costs":[  
            {  
               "CostType":"String",
               "Cost":{  
                  "a":0,
                  "s":"$"
               }
            }
         ],
         "Parcels":[  
            {  
               "Number":0,
               "Items":[  
                  {  
                     "Id":"0",
                     "Sku":"String",
                     "Quantity":0
                  }
               ],
               "Kits":[  
                  {  
                     "Id":"0",
                     "Sku":"String",
                     "Quantity":0,
                     "Items":[  
                        {  
                           "Id":"0",
                           "Quantity":0
                        }
                     ]
                  }
               ],
               "Weight":0,
               "WeightUnit":"String",
               "Dimensions":{  
                  "Height":0,
                  "Width":0,
                  "Length":0,
                  "Unit":"String"
               },
               "Note":"String"
            }
         ],
         "LandedCosts":[  
            {  
               "Sku":"String",
               "Cost":{  
                  "a":0,
                  "s":"$"
               }
            }
         ],
         "FileIds":[  
            {  

            }
         ]
      }
   ],
   "Status":"String",
   "Errors":[  

   ]
}

Body Params

SaleIds
string

Sale ID - Must exist in SkuVault

TenantToken
string
required

Tenant Token associated with account.

UserToken
string
required

User Token associated with account.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getSoldItems

Heavy throttling
Returns a list of sold items filtered by date. 10,000 sales are returned per page.

 
posthttps://app.skuvault.com/api/sales/getSoldItems
{
  "BreakDownKits": false,
  "EndDateUtc": "0001-01-01T00:00:00.0000000Z",
  "StartDateUtc": "0001-01-01T00:00:00.0000000Z",
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "SoldItems": [
    {
      "Date": "0001-01-01T00:00:00.0000000Z",
      "Quantity": 0,
      "SKU": "String",
      "TotalPrice": 0
    }
  ]
}

Body Params

StartDateUtc
date
required

Start date in UTC

EndDateUtc
date
required

End date in UTC

BreakDownKits
boolean

Break down kits to show component products.

PageNumber
int32

Specify page number to be returned

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Date range must not be more than 14 days.

Suggest Edits

/getSuppliers

Heavy throttling
Returns the list of current Suppliers in a SkuVault account.

 
posthttps://app.skuvault.com/api/products/getSuppliers
{
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Supplier": [
    {
      "IsEnabled": false,
      "Name": "String"
    }
  ]
}

Body Params

PageNumber
int32

10,000 results per page.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getTokens

Very Light throttling. Use this call to retrieve your API tokens from SkuVault using your login email and password.

 
posthttps://app.skuvault.com/api/gettokens
{
  "Email": "String",
  "Password": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "TenantToken": "String",
  "UserToken": "String"
}

Body Params

Email
string
required

Your SkuVault login email.

Password
string
required

Your SkuVault login password.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getTransactions

Heavy throttling
Look at your transaction history.

 
posthttps://app.skuvault.com/api/inventory/getTransactions
{  
   "FromDate":"0001-01-01T00:00:00.0000000Z",
   "ToDate":"0001-01-01T00:00:00.0000000Z",
   "PageNumber":0,
   "PageSize":0,
   "WarehouseId":"String",
   "TransactionType":"String",
   "TransactionReasons":[  
      "String"
   ],
   "ExcludeTransactionReasons":[  
      "String"
   ],
   "SaleId":"1-1-1-1-SALE1",
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Transactions":[  
      {  
         "User":"String",
         "Sku":"String",
         "Code":"String",
         "ScannedCode":"String",
         "Title":"String",
         "Quantity":0,
         "QuantityBefore":0,
         "QuantityAfter":0,
         "Location":"String",
         "TransactionType":"String",
         "TransactionReason":"String",
         "TransactionNote":"String",
         "TransactionDate":"0001-01-01T00:00:00.0000000Z",
         "Context":{  
            "Type":"Sale",
            "ID":"1-1-1-1-SALE1"
         }
      ]
   }

Body Params

FromDate
date
required
ToDate
date
required

Max range: 1 week

PageNumber
int32
PageSize
int32

Valid range: 1000-10000

WarehouseId
string
TransactionType
string

All, Add, Remove, Pick, or Create

TransactionReasons
array of strings

This is a list of transactions reason to include in the response.

ExcludeTransactionReasons
array of strings

This is a list of transactions to exclude from the call

SaleId
string

Include a sale ID to see all transactions made against a specific sale.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Sale Context for Picks

Picks that were made against a specific sale (using QC on Pick, Pick on QC, or Check Item Against Order) will show that sale's ID in the Context parameter.

Suggest Edits

/getWarehouseItemQuantities

Heavy throttling
This call returns SKUs and quantities from a specified warehouse. 10,000 SKUs returned per page.

 
posthttps://app.skuvault.com/api/inventory/getWarehouseItemQuantities
{
  "ModifiedBeforeDateTimeUtc":"0001-01-01T00:00:00.0000000Z",
  "ModifiedAfterDateTimeUtc":"0001-01-01T00:00:00.0000000Z",
  "PageNumber": 0,
  "PageSize": 0,
  "WarehouseId": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "ItemQuantities": [
    {
      "Quantity": 0,
      "Sku": "String"
    }
  ]
}

Body Params

ModifiedBeforeDateTimeUtc
date

Modified before date time in UTC (optional, by default used max date).

ModifiedAfterDateTimeUtc
date

Modified after date time in UTC (optional, by default used min date).

PageNumber
int32

Page number with 0 being the first page. Defaults to 0.

PageSize
string

Number of objects to return per page. Can be any value between 1000 and 10000.

WarehouseId
int32
required

from getWarehouses

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getWarehouseItemQuantity

Heavy throttling
Returns the quantity for a specified SKU.

 
posthttps://app.skuvault.com/api/inventory/getWarehouseItemQuantity
{
  "Sku": "String",
  "WarehouseId": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "TotalQuantityOnHand": 0
}

Body Params

Sku
string
required

The Sku to filter by.

WarehouseId
int32
required

from getWarehouses

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/getWarehouses

Severe throttling. Returns all your regular warehouses.

 
posthttps://app.skuvault.com/api/inventory/getWarehouses
{
  "PageNumber": 0,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{  
   "Warehouses":[  
      {  
         "Id":"String",
         "Code":"String"
      }
   ]
}

Body Params

PageNumber
int32

Page to return.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/pickItem

Moderate throttling
Perform a pick transaction through the API. [Bulk version available]

 
posthttps://app.skuvault.com/api/inventory/pickItem
{
  "WarehouseId": 0,
  "LocationCode":"String",
  "Code": "String",
  "Sku": "String",
  "Quantity": 0,
  "IsExpressPick": false,
  "Note": "String",
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "PickItemStatus": "Ok"
}

Body Params

WarehouseId
int32
required

from getWarehouses

LocationCode
string

Location Code. Required if not using express pick.

Code
string

Product to pick. Required if not defining SKU.

Sku
string

Product Sku to pick. Required if not defining Code.

Quantity
int32
required

The quantity to pick

IsExpressPick
boolean

Uses express pick to determine location. Required if not defining location.

Note
string

The note to add to the transaction.

ScannedCode
string

Scanned code

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/pickItemBulk

Moderate throttling
Perform a bulk pick transaction through the API.

 
posthttps://app.skuvault.com/api/inventory/pickItemBulk
{  
   "Items":[  
      {  
         "SaleId":"String",
         "Sku":"String",
         "Code":"String",
         "WarehouseId":0,
         "LocationCode":"String",
         "Quantity":0,
         "IsExpressPick":false,
         "Note":"String",
         "ScannedCode":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
    "Results": [
        "Success"
    ],
    "Status": "OK",
    "Errors": []
}

Body Params

Items
object
Items.Sku
string
required

Product Sku to pick. Required if not defining Code.

Items.Code
string
required

Product to pick. Required if not defining SKU.

Items.WarehouseId
int32
required

from getWarehouses

Items.LocationCode
string

Location Code. Required if not using express pick.

Items.Quantity
int32
required

The quantity to pick

Items.IsExpressPick
boolean
required

Uses Express Pick to determine location. Required if not defining Location Code. Must be entered as either 'false' or 'true'

Items.Note
string

The note to add to the transaction.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/receivePOItems

Moderate throttling

 
posthttps://app.skuvault.com/api/purchaseorders/receivePOItems
{
  "PoNumber": "String",
  "SupplierName": "String",
  "ReceiptDate": "0001-01-01T00:00:00.0000000Z",
  "LineItems": [
    {
      "Quantity": 1,
      "QuantityTo3PL": 0,
      "SKU": "String",
      "Location": "String"
    }
  ],
  "WarehouseId": 100,
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Status": "Success"
}

Body Params

PoNumber
string
required

The PO number to receive against.

SupplierName
string
required

Supplier associated with the PO.

ReceiptDate
date
required

Date and time items were received.

LineItems
object
LineItems.SKU
string
required

The SKU being received.

LineItems.Quantity
int32
required

The quantity being received.

LineItems.QuantityTo3PL
int32
required

The quantity received being sent to your 3PL warehouse.

Location
string

Location the item quantity is being received to.

WarehouseId
int32

from getWarehouses | Required if receiving to a location.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/releaseHeldQuantities

Moderate throttling
Release holds before their expiration date expires.

 
posthttps://app.skuvault.com/api/sales/releaseHeldQuantities
{  
   "SkusToRelease":{  
      "String":0
   },
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
	"ReleasedQuantities": {
		"SKU_as_key": 0
	}
}

Body Params

SkusToRelease
object
required

Dictionary of SKUs and the quantity to release for each SKU

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Did you know?

Inventory quantity can be removed from holds by using a Transaction Reason that has the "Remove from holds" flag enabled. Set this flag on the Transaction Reasons page.

Suggest Edits

/removeItem

Moderate throttling
Remove quantity from a warehouse location. Bulk version available

 
posthttps://app.skuvault.com/api/inventory/removeItem
{  
   "Sku":"String",
   "Code":"String",
   "WarehouseId":0,
   "LocationCode":"String",
   "Quantity":0,
   "Reason":"String",
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "RemoveItemStatus": "Success"
}

Body Params

Code
string

Product Code. Required if SKU is omitted.

Sku
string

Product SKU. Required if Code is omitted.

WarehouseId
int32
required

from getWarehouses

LocationCode
string
required

The warehouse location to remove quantity from

Quantity
int32
required

The quantity to remove

Reason
string
required

Transaction reason must exist in SkuVault

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/removeItemBulk

Moderate throttling
Remove quantity from warehouse locations, 100 at a time.

 
posthttps://app.skuvault.com/api/inventory/removeItemBulk
{  
   "Items":[  
      {  
         "Sku":"String",
         "Code":"String",
         "WarehouseId":0,
         "LocationCode":"String",
         "Quantity":0,
         "Reason":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Results": [
    "Success"
  ],
  "Status": "OK"
}

Body Params

Items
object
Items.Code
string
required

Product Code. Required if SKU is omitted.

Items.Sku
string
required

Product SKU. Required if Code is omitted.

Items.WarehouseId
int32
required

from getWarehouses

Items.LocationCode
string
required

The warehouse location to remove quantity from

Items.Quantity
int32
required

The quantity to remove

Items.Reason
string
required

Transaction reason must exist in SkuVault

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/setItemQuantities

Moderate throttling.
Sets quantity for multiple products in one request.

 
posthttps://app.skuvault.com/api/inventory/setItemQuantities
{
  "Items": [
    {
      "Sku": "String",
      "LocationCode": "String",
      "Quantity": 0,
      "WarehouseId": 0
    }
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
{
  "Items": [
    {
      "Code": "String",
      "LocationCode": "String",
      "Quantity": 0,
      "WarehouseId": 0
    }
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    {
      "Code": "String",
      "Error": "Error explanation",
      "SKU": "String"
    }
  ],
  "Status": "Accepted"
}

Body Params

Items
object
Items.Code
string

Required if SKU is omitted.

Items.Sku
string

Required if Code is omitted.

Items.WarehouseId
int32
required

from getWarehouses

Items.LocationCode
string
required

The warehouse location to set quantity.

Items.Quantity
int32
required

The quantity to set.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Maximum 100 objects under Items array!

Suggest Edits

/setItemQuantity

Moderate throttling
This lets you explicitly set quantity for an item in a warehouse's location.

 
posthttps://app.skuvault.com/api/inventory/setItemQuantity
{  
   "Sku":"String",
   "Code":"String",
   "WarehouseId":0,
   "LocationCode":"String",
   "Quantity":0,
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{  
   "SetItemQuantityStatusEnum":"Undefined"
}

Body Params

Code
string

The SKU you are setting quantity for. Used when SKU is blank.

Sku
string

The SKU you are setting quantity for. Used when Code is blank.

WarehouseId
int32
required

from getWarehouses

LocationCode
string
required

The warehouse location to set quantity in.

Quantity
int32
required

The quantity to set for a SKU.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/setShipmentFile

Severe throttling.
Using this call, users can attach a base64 PDF file to Shipment Tracking Number.

 
posthttps://app.skuvault.com/api/sales/setShipmentFile
{  
   "Shipments":[  
      {  
         "SaleId":"String",
         "TrackingNumber":"String",
         "Carrier":"String",
         "FilesData":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{  
   "FileIds":[  
      {  

      }
   ],
   "Status":"String",
   "Errors":[  

   ]
}

Body Params

Shipments
object
Shipments.SaleId
string

Sale ID. Must exist in SkuVault.

Shipments.TrackingNumber
string

Tracking Number

Shipments.Carrier
string

The shipping company responsible for taking the delivery from Point A to Point B.

Shipments.FilesData
string

Valid Base64 sting.

TenantToken
string
required

Tenant Token

UserToken
string
required

User Token

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/syncOnlineSale

Moderate throttling
Sync an online sale to SkuVault. If the sale does not exists, it's created. If it does exist, it's updated. ShippingStatus is required to create sale, but not update. ItemSkus is always required. Bulk version available: /syncOnlineSales

 
posthttps://app.skuvault.com/api/sales/syncOnlineSale
{
  "CheckoutStatus": "String",
  "ChannelType":"String",
  "ChannelAccountId":"0",
  "FulfilledItems": [
    {
      "Quantity": 1,
      "Sku": "String",
      "UnitPrice": 0
    }
  ],
  "ItemSkus": [
    {
      "Quantity": 1,
      "Sku": "String",
      "UnitPrice": 0
    }
  ],
  "MarketplaceId": "String",
  "Notes": "String",
  "OrderDateUtc": "2016-01-01T00:00:00.0000000Z",
  "OrderId": "String",
  "OrderTotal": 0,
  "PaymentStatus": "String",
  "SaleState": "String",
  "ShippingInfo": {
    "City": "String",
    "CompanyName": "String",
    "Country": "String",
    "Email": "String",
    "FirstName": "String",
    "LastName": "String",
    "Line1": "String",
    "Line2": "String",
    "PhoneNumber": "String",
    "Postal": "String",
    "Region": "String",
    "ShippingCarrier": "String",
    "ShippingClass": "String",
    "ShippingStatus": "String"
  },
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "OrderId": "OK",
  "Status": "Success"
}

Body Params

OrderId
string
required

The order ID. After order is synced it's status can be retrieved by the same ID. NOTE: You can create AND update sales that do not originate from the API if you provide the full SkuVault Sale ID in this parameter. In other words, if a sale originated from Magento, you can update it in the API if you provide the full SkuVault Sale ID.

MarketplaceId
string

Add a distinct marketplace ID to your sale.

OrderDateUtc
date

The UTC date and time order was created.

OrderTotal
double

Total order price. Can be different than the sum sale price of sold SKUs.

CheckoutStatus
string

View guide. One of: NotVisited, Visited, OnHold, Completed, CompletedOffline, Cancelled

PaymentStatus
string

View guide. One of: NotSubmitted, Submitted, Deposited, Cleared, Failed

SaleState
string

View guide. One of: Active, Cancelled, Archived

Notes
string

Sale notes associated with this order.

ItemSkus
object
ItemSkus.Sku
string
required

The SKU sold.

ItemSkus.Quantity
int32
required

The sold quantity, must be higher than or equal to 1.

ItemSkus.UnitPrice
double

The sold unit price.

FulfilledItems
object
FulfilledItems.SKU
string

The SKU of the sold 3PL line item.

FulfilledItems.Quantity
int32

The sold quantity of the 3PL line item.

FulfilledItems.UnitPrice
double

The sold unit price of the 3PL line item.

ShippingInfo
object
ShippingInfo.ShippingStatus
string

View guide. One of: Unshipped, PendingShipment, PartiallyShipped, Shipped

ShippingInfo.ShippingCarrier
string
ShippingInfo.ShippingClass
string
ShippingInfo.FirstName
string
ShippingInfo.LastName
string
ShippingInfo.CompanyName
string
ShippingInfo.PhoneNumber
string
ShippingInfo.Email
string
ShippingInfo.Line1
string
ShippingInfo.Line2
string
ShippingInfo.City
string
ShippingInfo.Region
string
ShippingInfo.Postal
string
ShippingInfo.Country
string
ChannelType
string

Channel Type

ChannelAccountId
int64

Channel Account Id

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

ShippingInfo.ShippingStatus

This field is required to create sales, but not update them.

Suggest Edits

/syncOnlineSales

Severe throttling.
Can make this call 2x per minute, 100 sales max

 
posthttps://app.skuvault.com/api/sales/syncOnlineSales
{
  "Sales": [
    {
      "CheckoutStatus": "String",
      "ChannelType":"String",
      "ChannelAccountId":"0",
      "FulfilledItems": [
        {
          "Quantity": 1,
          "Sku": "String",
          "UnitPrice": 0
        }
      ],
      "ItemSkus": [
        {
          "Quantity": 1,
          "Sku": "String",
          "UnitPrice": 0
        }
      ],
      "MarketplaceId": "String",
      "Notes": "String",
      "OrderDateUtc": "0001-01-01T00:00:00.0000000Z",
      "OrderId": "String",
      "OrderTotal": 0,
      "PaymentStatus": "String",
      "SaleState": "String",
      "ShippingInfo": {
        "City": "String",
        "CompanyName": "String",
        "Country": "String",
        "Email": "String",
        "FirstName": "String",
        "LastName": "String",
        "Line1": "String",
        "Line2": "String",
        "PhoneNumber": "String",
        "Postal": "String",
        "Region": "String",
        "ShippingCarrier": "String",
        "ShippingClass": "String",
        "ShippingStatus": "String"
      }
    }
  ],
  "TenantToken": "String",
  "Usertoken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    {
      "ErrorMessages": [
        "String"
      ],
      "OrderId": "String"
    }
  ],
  "Status": "Accepted"
}
{
  "Errors": [
    {
      "ErrorMessages": [
        "String"
      ],
      "OrderId": "String"
    }
  ],
  "Status": "OK"
}

Body Params

Sales
object
Sales.MarketplaceId
string

Add a distinct marketplace ID to your sale.

Sales.OrderId
string
required

The order ID. After order is synced it's status can be retrieved by the same ID. NOTE: You can create AND update sales that do not originate from the API if you provide the full SkuVault Sale ID in this parameter. In other words, if a sale originated from Magento, you can update it in the API if you provide the full SkuVault Sale ID.

Sales.OrderDateUtc
date

The UTC date and time order was created.

Sales.OrderTotal
double

Total order price. Can be different than the sum sale price of sold SKUs.

Sales.CheckoutStatus
string

View guide. One of: NotVisited, Visited, OnHold, Completed, CompletedOffline, Cancelled

Sales.PaymentStatus
string

View guide. One of: NotSubmitted, Submitted, Deposited, Cleared, Failed

Sales.Notes
string

Sale notes associated with this order.

Sales.SaleState
string

View guide. One of: Active, Cancelled, Archived

Sales.ItemSkus
object
Sales.ItemSkus.Sku
string
required

The SKU sold.

Sales.ItemSkus.Quantity
int32
required

The sold quantity.

Sales.ItemSkus.UnitPrice
double

The sold unit price.

Sales.FulfilledItems
object
Sales.FulfilledItems.Sku
string

The SKU of the sold 3PL/FBA fulfilled item.

Sales.FulfilledItems.Quantity
int32

The quantity of the sold 3PL fulfilled item.

Sales.FulfilledItems.UnitPrice
double

The unit price of the sold 3PL fulfilled item.

Sales.ShippingInfo
object
Sales.ShippingInfo.ShippingStatus
string

View guide. One of: Unshipped, PendingShipment, PartiallyShipped, Shipped

Sales.ShippingInfo.ShippingCarrier
string
Sales.ShippingInfo.ShippingClass
string
Sales.ShippingInfo.FirstName
string
Sales.ShippingInfo.LastName
string
Sales.ShippingInfo.CompanyName
string
Sales.ShippingInfo.PhoneNumber
string
Sales.ShippingInfo.Email
string
Sales.ShippingInfo.Line1
string
Sales.ShippingInfo.Line2
string
Sales.ShippingInfo.City
string
Sales.ShippingInfo.Region
string
Sales.ShippingInfo.Postal
string
Sales.ShippingInfo.Country
string
ChannelType
string

Channel Type

ChannelAccountId
int64

Channel Account Id

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/syncShippedSaleAndRemoveItems

Moderate throttling
This method syncs a shipped sale and auto-removes quantity. If the product is in multiple locations, then the remove will occur at the location that is first in alphanumerical order. Quantity can be removed from normal, Reserved, and Backstock locations.


Warning:

If your account has AutoRemove enabled, then syncing sales using this call will result in the system attempting to remove sale item quantity twice. Please use with caution and if you are unsure if this warning applies to your account, please submit a support ticket here.

 
posthttps://app.skuvault.com/api/sales/syncShippedSaleAndRemoveItems
{
  "OrderId": "String",
  "WarehouseId": 0,
  "OrderDateUtc": "0001-01-01T00:00:00.0000000Z",
  "OrderTotal": 0,
  "Notes": "String",
  "ItemSkus": [
    {
      "Sku": "String",
      "Quantity": 0,
      "UnitPrice": 0
    }
  ],
  "FulfilledItems": [
    {
      "Sku": "String",
      "Quantity": 1,
      "UnitPrice": 0
    }
  ],
  "ShippingInfo": {
    "City": "String",
    "CompanyName": "String",
    "Country": "String",
    "Email": "String",
    "FirstName": "String",
    "LastName": "String",
    "Line1": "String",
    "Line2": "String",
    "PhoneNumber": "String",
    "Postal": "String",
    "Region": "String",
    "ShippingCarrier": "String",
    "ShippingClass": "String"
  },
  "TenantToken": "String",
  "UserToken": "String",
}
A binary file was returned

You couldn't be authenticated

{
  "RemoveItemErrors": [
    "String"
  ]
}

Body Params

OrderId
string
required

The order ID. After order is synced it's status can be retrieved by the same ID. NOTE: You can create AND update sales that do not originate from the API if you provide the full SkuVault Sale ID in this parameter. In other words, if a sale originated from Magento, you can update it in the API if you provide the full SkuVault Sale ID.

WarehouseId
int32

The warehouse to Remove quantity from. If not included then the item will be removed from the first location in alphanumerical order across all warehouses.

OrderDateUtc
date

The UTC date and time order was created.

OrderTotal
double

Total order price. Can be different than the sum sale price of sold SKUs.

Notes
string

Sale notes associated with this order.

ItemSkus
object
ItemSkus.Sku
string
required

The SKU sold.

ItemSkus.Quantity
int32
required

The sold quantity.

ItemSkus.UnitPrice
double
required

The sold unit price.

FulfilledItems
object
FulfilledItems.Sku
string

The SKU sold.

FulfilledItems.Quantity
int32

The sold quantity.

FulfilledItems.UnitPrice
double

The sold unit price.

ShippingInfo
object
ShippingInfo.ShippingStatus
string

One of: Unshipped, PendingShipment, PartiallyShipped, Shipped

ShippingInfo.ShippingCarrier
string
ShippingInfo.ShippingClass
string
ShippingInfo.FirstName
string
ShippingInfo.LastName
string
ShippingInfo.CompanyName
string
ShippingInfo.PhoneNumber
string
ShippingInfo.Email
string
ShippingInfo.Line1
string
ShippingInfo.Line2
string
ShippingInfo.City
string
ShippingInfo.Region
string
ShippingInfo.Postal
string
ShippingInfo.Country
string
TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/syncShippedSaleAndRemoveItemsBulk

Moderate throttling
This method can sync multiple shipped sales and auto-removes quantity. Up to 100 sales per call.

If warehouseId isn't provided then quantity will only be removed if the item can only be found in one location across all warehouses. If a warehouseId is provided then quantity will be removed if the item is only found in one location within that specified warehouse.


Warning:

If your account has AutoRemove enabled, then syncing sales using this call will result in the system attempting to remove sale item quantity twice. Please use with caution and if you are unsure if this warning applies to your account, please submit a support ticket here.

 
posthttps://app.skuvault.com/api/sales/syncShippedSaleAndRemoveItems/bulk
{  
   "Sales":[  
      {  
         "OrderId":"String",
         "WarehouseId":0,
         "OrderDateUtc":"0001-01-01T00:00:00.0000000Z",
         "OrderTotal":0,
         "Notes":"String",
         "ItemSkus":[  
            {  
               "Sku":"String",
               "Quantity":0,
               "UnitPrice":0
            }
         ],
         "FulfilledItems":[  
            {  
               "Sku":"String",
               "Quantity":0,
               "UnitPrice":0
            }
         ],
         "ShippingInfo":{  
            "ShippingCarrier":"String",
            "ShippingClass":"String",
            "FirstName":"String",
            "LastName":"String",
            "CompanyName":"String",
            "PhoneNumber":"String",
            "Email":"String",
            "Line1":"String",
            "Line2":"String",
            "City":"String",
            "Region":"String",
            "Postal":"String",
            "Country":"String"
         },
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
    "Sales": [],
    "Status": "OK",
    "Errors": []
}

Body Params

Sales
object
Sales.OrderId
string
required

The order ID. After order is synced it's status can be retrieved by the same ID. NOTE: You can create AND update sales that do not originate from the API if you provide the full SkuVault Sale ID in this parameter. In other words, if a sale originated from Magento, you can update it in the API if you provide the full SkuVault Sale ID.

Sales.WarehouseId
int32

The warehouse to Remove ItemSku inventory from.

Sales.OrderDateUtc
date

The UTC date and time order was created.

Sales.OrderTotal
double

Total order price. Can be different than the sum sale price of sold SKUs.

Sales.Notes
string

Sale notes associated with this order.

Sales.ItemSkus
object
Sales.ItemSkus.Sku
string
required

The SKU sold.

Sales.ItemSkus.Quantity
int32
required

The sold quantity.

Sales.ItemSkus.UnitPrice
double
required

The sold unit price.

Sales.FulfilledItems
object
Sales.FulfilledItems.Sku
string
Sales.FulfilledItems.Quantity
string
Sales.FulfilledItems.UnitPrice
string
Sales.ShippingInfo
object
Sales.ShippingInfo.ShippingCarrier
string
Sales.ShippingInfo.ShippingClass
string
Sales.ShippingInfo.FirstName
string
Sales.ShippingInfo.LastName
string
Sales.ShippingInfo.CompanyName
string
Sales.ShippingInfo.PhoneNumber
string
Sales.ShippingInfo.Email
string
Sales.ShippingInfo.Line1
string
Sales.ShippingInfo.Line2
string
Sales.ShippingInfo.City
string
Sales.ShippingInfo.Region
string
Sales.ShippingInfo.Postal
string
Sales.ShippingInfo.Country
string
TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/updateAltSKUsCodes

Moderate throttling
Update the Alternate SKUs and Codes for your products.

 
posthttps://app.skuvault.com/api/products/updateAltSKUsCodes
{  
   "Action":"String",
   "Items":[  
      {  
         "Sku":"String",
         "AltSKUs":[  
            "String"
         ],
         "AltCodes":[  
            "String"
         ]
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
  ],
  "Status": "OK"
}

Body Params

Action
string
required

Value can be 'Add', 'Delete', or 'Update'. 'Add' and 'Delete' will only modify a products' Alternates with those specified in the call. 'Update' will overwrite a products' Alternates with the Codes/SKUs provided.

Items
object
Items.Sku
string
required

SKU of the product to update.

Items.AltSKUs
array of strings
required

Alternate SKUs to add, remove, or update the products' Alternates with.

Items.AltCodes
array of strings
required

Alternate Codes to add, remove, or update the products' Alternates with.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/updateExternalWarehouseQuantities

Severe throttling
Set the quantity of SKUs in a specified external warehouse. Updating an external warehouse's quantities will overwrite any existing quantities. The limit is 200,000 SKUs per call.

 
posthttps://app.skuvault.com/api/inventory/updateExternalWarehouseQuantities
{
  "WarehouseId": "String",
  "Quantities": [
    {
      "InStockQuantity": 0,
      "InboundQuantity": 0,
      "ReserveQuantity": 0,
      "Sku": "String",
      "TotalQuantity": 0,
      "TransferQuantity": 0
    }
  ],
  "TenantToken": "String",
  "UserToken": "String",
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Status": "OK"
}

Body Params

WarehouseId
string
required

from getExternalWarehouses

Quantities
object
Quantities.SKU
string
required

The SKU whose quantities are being updated.

Quantities.InStockQuantity
int32

The "In Stock" quantity of that SKU. If excluded we will not 0 out the quantity or update it. We will just leave it how it currently is.

Quantities.InboundQuantity
int32

The "Inbound" quantity of that SKU. If excluded we will not 0 out the quantity or update it. We will just leave it how it currently is.

Quantities.TransferQuantity
int32

The "Transfer" quantity of that SKU. If excluded we will not 0 out the quantity or update it. We will just leave it how it currently is.

Quantities.ReserveQuantity
int32

The "Reserve" quantity of that SKU. If excluded we will not 0 out the quantity or update it. We will just leave it how it currently is.

Quantities.TotalQuantity
int32

The total quantity of that SKU in the external warehouse. We recommend TotalQuantity being the sum of the previous 4 quantities as best practice.

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 

This request overwrites the entire external warehouse.

Any SKU in an external warehouse that is omitted from the next request will be removed from said warehouse.

Suggest Edits

/updateHandlingTime

Severe throttling
Update the handling time for each product per Amazon channel account, 500 at a time.

 
posthttps://app.skuvault.com/api/products/updateHandlingTime
{
  "Items": [
    {
      "HandlingTime": [
        {
          "AccountId": "String",
          "Quantity": 0
        }
      ],
      "Sku": "String"
    }
  ],
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
  ],
  "Status": "Accepted"
}
{
  "Errors": [
  ],
  "Status": "OK"
}

Body Params

Items
object
Items.Sku
object
Items.Sku.HandlingTime
object
Items.Sku.HandlingTime.AccountId
string
required

The channel account ID acquired from /getIntegrations request

Items.Sku.HandlingTime.Quantity
int32
required

Between 1 and 30, the number of days it takes to fulfill this SKU.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/updateOnlineSaleStatus

Light throttling
Update the status of a sale.

 
posthttps://app.skuvault.com/api/sales/updateOnlineSaleStatus
{
  "SaleId": "String",
  "Status": "String",
  "TenantToken": "String",
  "UserToken": "String"
}
A binary file was returned

You couldn't be authenticated

{
  "Status": "OK",
  "Errors": []
}

Body Params

SaleId
string
required

The full SkuVault Sale ID to be updated. NOTE: You can either use SaleID or OrderID. You cannot use both of them.

OrderId
string

The Order ID (not full SkuVault Sale ID) of the order to be updated. NOTE: You can only use this parameter for sales created via the API. If you want to change sale status for sales that did not originate from the API, you must use the 'SaleID' parameter.

Status
string
required

One of: Pending, ReadyToShip, Completed, Cancelled, Invalid, ShippedUnpaid

TenantToken
string
required

from getTokens

UserToken
string
required

from getTokens

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/updatePOs

Heavy throttling
Update your existing Purchase Orders. /updatePOs

 
posthttps://app.skuvault.com/api/purchaseorders/updatePOs
{
 "POs":
 [
	{
    "PurchaseOrderId":"0",
    "SupplierName":"String",
    "LineItems":	
    	[
        {"SKU":"String",
         "Quantity":0,
         "QuantityTo3PL":0,
         "Cost":0,
         "PrivateNotes":"String",
         "PublicNotes":"String",
         "Variant":"String",
         "Identifier":"String"
        }
      ],
    "Status":"Undefined",
    "PoNumber":"String",
    "OrderDate":"0001-01-01T00:00:00.0000000Z",
    "OrderCancelDate":"0001-01-01T00:00:00.0000000Z",
    "ArrivalDueDate":"0001-01-01T00:00:00.0000000Z",
    "RequestedShipDate":"0001-01-01T00:00:00.0000000Z",
    "ActualShippedDate":"0001-01-01T00:00:00.0000000Z",
    "TrackingInfo":"String",
    "PublicNotes":"String",
    "PrivateNotes":"String",
    "TermsName":"String",
    "ShipToWarehouse":"String",
    "ShipToAddress":"String",
    "ShippingCarrierClass":
    		{"CarrierName":"String",
         "ClassName":"String"
        },
    "Payments":
    	[
     		{
         "PaymentName":"String",
         "Amount":0,
         "Note":"String"
         }
      ],
    "SentStatus":"Undefined",
    "PaymentStatus":"Undefined"
  }
 ],
"TenantToken":"String",
"UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Status":"String",
  "Errors":[
  ]
}

Body Params

PurchaseOrderId
int64
required

Purchase Order Id

SupplierName
string

Supplier Name

LineItems
object
LineItems.SKU
string
LineItems.Quantity
int32
LineItems.QuantityTo3PL
int32
LineItems.Cost
double
LineItems.PrivateNotes
string
LineItems.PublicNotes
string
LineItems.Variant
string
LineItems.Identifier
string
Status
string

Purchase Order Status

PoNumber
string

PO Number

OrderDate
date

Order Date

OrderCancelDate
date
ArrivalDueDate
date
RequestedShipDate
date
ActualShippedDate
date
TrackingInfo
string

Tracking Info

PublicNotes
string

Public Notes

PrivateNotes
string

Private Notes

TermsName
string

Terms Name

ShipToWarehouse
string

Ship to Warehouse

ShipToAddress
string
ShippingCarrierClass
object
ShippingCarrierClass.CarrierName
string
ShippingCarrierClass.ClassName
string
Payments
object
Payments.PaymentName
string
Payments.Amount
double
Payments.Note
string
SentStatus
string

Sent Status - NotSent, Sent, and NeedToResend (defaults to NotSent)

PaymentStatus
string

Payment Status - NonePaid, PartiallyPaid, and FullyPaid (defaults to NonePaid)

Headers

Content-Type
string

application/json

Accept
string

application/json

 
Suggest Edits

/updateProduct

Moderate throttling
Update your product details. Bulk version available: /updateProducts

 
posthttps://app.skuvault.com/api/products/updateProduct
{  
   "Sku":"String",
   "Description":"String",
   "ShortDescription":"String",
   "LongDescription":"String",
   "Classification":"String",
   "Supplier":"String",
   "Brand":"String",
   "Code":"String",
   "PartNumber":"String",
   "Cost":0,
   "SalePrice":0,
   "RetailPrice":0,
   "Weight":0,
   "WeightUnit":"String",
   "VariationParentSku":"String",
   "ReorderPoint":0,
   "MinimumOrderQuantity":0,
   "MinimumOrderQuantityInfo":"String",
   "Note":"String",
   "Statuses":[  
      "String"
   ],
   "Pictures":[  
      "String"
   ],
   "Attributes":{  
      "String":"String"
   },
   "SupplierInfo":[  
      {  
         "SupplierName":"String",
         "SupplierPartNumber":"String",
         "Cost":"String",
         "LeadTime":"String",
         "IsActive":"String",
         "IsPrimary":"String"
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
  ],
  "Status": "OK"
}

Body Params

Sku
string
required

The SKU you wish to update.

Description
string

Equals "Title" inside SkuVault UI.

ShortDescription
string

Limit 1000 characters

LongDescription
string

Limit 65665 characters.

Classification
string

Must exist in SkuVault.

Supplier
string

Primary Supplier for the product. Additional supplier information will show in the SupplierInfo array.

Brand
string

Must exist in SkuVault.

Code
string

Barcode number.

PartNumber
string

Manufacturer part number.

Cost
double

Accepts decimal; Your overall cost on hand for that product. Used for a default (fallback) cost field or for the cost averaging feature in SkuVault.

SalePrice
double

Accepts decimal; Your selling price per unit

RetailPrice
double

Accepts decimal; MSRP per unit

Weight
double

Accepts decimal

WeightUnit
string

One of: "lbs", "kgs", "oz", "g"

VariationParentSku
string
ReorderPoint
int32

The point at which you should reorder quantity.

MinimumOrderQuantity
int32
MinimumOrderQuantityInfo
string
Note
string

The note to place o the product.

Statuses
array of strings

List of statuses on the product.

Pictures
array of strings

List of picture urls

Attributes
object

Dictionary where key is attribute name and value is attribute value. NOTE: If you want to update attributes, please include the Classification value as well.

SupplierInfo
object
SupplierInfo.Cost
double

This is the supplier's cost for that item.

SupplierInfo.LeadTime
int32

Supplier's lead time.

SupplierInfo.isPrimary
boolean
required

At least 1 supplier must be specified as primary (true).

SupplierInfo.SupplierName
string
required

The name of your supplier in SkuVault. It must exist in SkuVault and at least one supplier is required.

SupplierInfo.SupplierPartNumber
string

Supplier's part number.

SupplierInfo.isActive
boolean

If a supplier is active, we will use the supplier information (Cost, Supplier Part Number, etc.) when creating a Purchase Order.

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Warning

  • Be sure to read Modifying Products.
    • Blank values are interpreted literally. Omit the field to not update it.
Suggest Edits

/updateProducts

Heavy throttling.
Update products in SkuVault, 100 at a time.

 
posthttps://app.skuvault.com/api/products/updateProducts
{  
   "Items":[  
      {  
         "Sku":"String",
         "Description":"String",
         "ShortDescription":"String",
         "LongDescription":"String",
         "Classification":"String",
         "Supplier":"String",
         "Brand":"String",
         "Code":"String",
         "PartNumber":"String",
         "Cost":0,
         "SalePrice":0,
         "RetailPrice":0,
         "Weight":0,
         "WeightUnit":"String",
         "VariationParentSku":"String",
         "ReorderPoint":0,
         "MinimumOrderQuantity":0,
         "MinimumOrderQuantityInfo":"String",
         "Note":"String",
         "Statuses":[  
            "String"
         ],
         "Pictures":[  
            "String"
         ],
         "Attributes":{  
            "String":"String"
         },
         "SupplierInfo":[  
            {  
               "SupplierName":"String",
               "SupplierPartNumber":"String",
               "Cost":"String",
               "LeadTime":"String",
               "IsActive":"String",
               "IsPrimary":"String"
            }
         ]
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

{
  "Errors": [
    "String"
  ],
  "Status": "Accepted"
}
{
  "Errors": [
    "String"
  ],
  "Status": "OK"
}

Body Params

Items
object
Items.Sku
string
required

The SKU you wish to update.

Items.Description
string

Equals "Title" inside SkuVault UI.

Items.ShortDescription
string

Limit 1000 characters

Items.LongDescription
string

Limit 65665 characters.

Items.Classification
string

If provided, classification must exist in SkuVault.

Items.Supplier
string

Primary Supplier for the product.

Items.Brand
string

If provided, brand must exist in SkuVault.

Items.Code
string

Barcode number.

Items.PartNumber
string

Manufacturer part number.

Items.Cost
double

Accepts decimal; Your overall cost on hand for that product. Used for a default (fallback) cost field or for the cost averaging feature in SkuVault.

Items.SalePrice
double

Accepts decimal; Your selling price per unit

Items.RetailPrice
double

Accepts decimal; MSRP per unit

Items.Weight
double

Accepts decimal

Items.WeightUnit
string

One of: "lbs", "kgs", "oz", "g"

Items.VariationParentSku
string
Items.ReorderPoint
int32

The point at which you should reorder quantity.

Items.MinimumOrderQuantity
int32
Items.MinimumOrderQuantityInfo
string
Items.Note
string

The note to place o the product.

Items.Statuses
array of strings

List of statuses on the product.

Items.Pictures
array of strings

List of picture urls

Items.Attributes
object

Dictionary list where name of attribute is key(AttributeName), value of attribute as value(AttributeValue). NOTE: If you want to update attributes, please include the Classification value as well.

Items.SupplierInfo
object
Items.SupplierInfo.SupplierName
string
required

The name of your supplier in SkuVault. It must exist in SkuVault and at least one supplier is required.

Items.SupplierInfo.SupplierPartNumber
string

Supplier's part number.

Items.SupplierInfo.Cost
double

This is the supplier's cost for that item.

Items.SupplierInfo.LeadTime
int32

Supplier's lead time.

Items.SupplierInfo.isActive
boolean

If true, will use this supplier information when creating a PO.

Items.SupplierInfo.isPrimary
boolean
required

Must have at least one primary supplier set to true

TenantToken
string
required

from getTokens.

UserToken
string
required

from getTokens.

Headers

Content-Type
string

application/json

Accept
string

application/json

 

Warning

  • Be sure to read Modifying Products.
    • Blank values are interpreted literally. Omit the field to not update it.
Suggest Edits

/updateShipments

Severe throttling.
Using this call, users can update shipments to a sale.

 
posthttps://app.skuvault.com/api/sales/updateShipments
{  
   "Shipments":[  
      {  
         "SaleId":"String",
         "TrackingNumber":"String",
         "Carrier":"String",
         "Status":"String",
         "LandedCosts":[  
            {  
               "Sku":"String",
               "Amount":0,
               "CurrencyIsoCode":"String"
            }
         ]
      }
   ],
   "TenantToken":"String",
   "UserToken":"String"
}
A binary file was returned

You couldn't be authenticated

		{  
   "Status":"String",
   "Errors":[  

   ]
   }

Body Params

Shipments
object
Shipments.TrackingNumber
string

The tracking number associated with the shipment.

Shipments.Carrier
string

Shipping company responsible for taking the delivery from Point A to Point B.

Shipments.Status
string

The Status of a shipment if a tracking number has been assigned by the carrier.

Shipments.LandedCosts
object
Shipments.LandedCosts.Sku
string

Sku associated with Landed cost.

Shipments.LandedCosts.Amount
double

Amount value of Landed Cost. Accepts decimals.

Shipments.LandedCosts.CurrencyIsoCode
string

Type of Currency

SaleIds
string

List of Sale IDs.

TenantToken
string
required

Tenant Token to access account

UserToken
string
required

User Token

Headers

Content-Type
string

application/json

Accept
string

application/json