POST /variants.json
Body Required
-
Accounting sync
Values are
active
ordisabled
. Default value isactive
. -
Automatically backorder
Values are
vendor_default
,backorder
, orignore
. Default value isvendor_default
. -
Backorder quantity
Default value is
0
. -
barcode string | null
Barcode
-
Commission rate
Default value is
0
. -
Commission rate routing
Values are
dropship_provider
orvariant
. Default value isdropship_provider
. -
Commission rate type
Values are
percentage
orfixed
. Default value ispercentage
. -
Cost price
Default value is
0
. -
countryOfOrigin string | null
Country of origin
-
Default purchase quantity
Default value is
1
. -
Deny threshold
Default value is
0
. -
description string | null
Description
-
Distance unit
Values are
in
orcm
. Default value isin
. -
dropshipProviderAddressId integer(int32) | null
Dropship provider address
-
Dropship provider address mapping
Values are
default
ormanual
. Default value isdefault
. -
dropshipProviderId integer(int32) | null
Dropship provider
-
Dropship provider mapping
Values are
brand_name
ormanual
. Default value isbrand_name
. -
dynamicInventoryPolicy boolean | null
Dynamic inventory policy
-
Fulfillment policy
Values are
vendor_default
,manual
,dropship
,fulfill
, orblended
. Default value isvendor_default
. -
Grams
Default value is
0
. -
hsCode string | null
Hs code
imagesMapped object | null | array | boolean | integer | number | string
-
Inventory allocated
Default value is
0
. -
Inventory feeds
Default value is
0
. -
Inventory policy
Values are
ignore
,deny
,continue
,dropship
, ortrack
. Default value istrack
. -
Inventory quantity
Default value is
0
. -
Inventory routing
Values are
inventory_feed
ormanual
. Default value isinventory_feed
. -
Inventory sync
Values are
channel
ordisabled
. Default value ischannel
. -
Inventory type
Values are
tracked
,serialized
,bundle
, orservice
. Default value istracked
. -
leadTime integer(int32) | null
Lead time
-
lowInventoryQuantity boolean | null
Low inventory quantity
-
Min inventory quantity
Default value is
0
. -
This field allows you to set a recommended price, which will be shown to the vendor in the portal. Vendors can also set up pricing rules based on this price in the vendor portal. For example, set a fixed or percentage amount above or below this price.
Default value is
0
. -
mpn string | null
Mpn
-
Name
-
No inventory policy
Values are
vendor_default
,manual
,dropship
, orreplenish
. Default value isreplenish
. -
notes string | null
Notes
-
Order splitting
Values are
group
,splitQuantity
, ordefault
. Default value isdefault
. -
Packing depth
Default value is
0
. -
Packing height
Default value is
0
. -
Packing width
Default value is
0
. -
Position
Default value is
0
. -
Product
-
productType string | null
Product type
-
requiresShipping boolean | null
Requires shipping
-
Reseller visibility
Values are
visible
,hidden
, orselected
. Default value isvisible
. -
serialPrefix string | null
Serial prefix
-
Serial reference
Default value is
0
. -
serialSuffix string | null
Serial suffix
-
Sku
-
Taxable
Default value is
true
. -
Total purchase items
Default value is
0
. -
Total sale items
Default value is
0
. -
vendorId integer(int32) | null
Vendor
-
vendorSku string | null
Vendor sku
Maximum length is
50
.
curl \
-X POST http://api.example.com/v1/variants.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"accountingSync":"active","automaticallyBackorder":"vendor_default","backorderQuantity":0,"barcode":"string","commissionRate":0,"commissionRateRouting":"dropship_provider","commissionRateType":"percentage","costPrice":0,"countryOfOrigin":"string","defaultPurchaseQuantity":1,"denyThreshold":0,"description":"string","distanceUnit":"in","dropshipProviderAddressId":42,"dropshipProviderAddressMapping":"default","dropshipProviderId":42,"dropshipProviderMapping":"brand_name","dynamicInventoryPolicy":true,"fulfillmentPolicy":"vendor_default","grams":0,"hsCode":"string","images":[],"imagesMapped":{},"imagesRaw":{},"inventoryAllocated":0,"inventoryFeeds":0,"inventoryPolicy":"track","inventoryQuantity":0,"inventoryRouting":"inventory_feed","inventorySync":"channel","inventoryType":"tracked","leadTime":42,"levels":{},"lowInventoryQuantity":true,"minInventoryQuantity":0,"minimumGuidePrice":0,"mpn":"string","name":"string","noInventoryPolicy":"replenish","notes":"string","orderSplitting":"default","packingDepth":0,"packingHeight":0,"packingWidth":0,"position":0,"productId":42,"productType":"string","requiresShipping":true,"resellerVisibility":"visible","serialPrefix":"string","serialReference":0,"serialSuffix":"string","sku":"string","tags":["string"],"taxable":true,"totalPurchaseItems":0,"totalSaleItems":0,"vendorId":42,"vendorSku":"string"}'
{
"accountingSync": "active",
"automaticallyBackorder": "vendor_default",
"backorderQuantity": 0,
"barcode": "string",
"commissionRate": 0,
"commissionRateRouting": "dropship_provider",
"commissionRateType": "percentage",
"costPrice": 0,
"countryOfOrigin": "string",
"defaultPurchaseQuantity": 1,
"denyThreshold": 0,
"description": "string",
"distanceUnit": "in",
"dropshipProviderAddressId": 42,
"dropshipProviderAddressMapping": "default",
"dropshipProviderId": 42,
"dropshipProviderMapping": "brand_name",
"dynamicInventoryPolicy": true,
"fulfillmentPolicy": "vendor_default",
"grams": 0,
"hsCode": "string",
"images": [],
"imagesMapped": {},
"imagesRaw": {},
"inventoryAllocated": 0,
"inventoryFeeds": 0,
"inventoryPolicy": "track",
"inventoryQuantity": 0,
"inventoryRouting": "inventory_feed",
"inventorySync": "channel",
"inventoryType": "tracked",
"leadTime": 42,
"levels": {},
"lowInventoryQuantity": true,
"minInventoryQuantity": 0,
"minimumGuidePrice": 0,
"mpn": "string",
"name": "string",
"noInventoryPolicy": "replenish",
"notes": "string",
"orderSplitting": "default",
"packingDepth": 0,
"packingHeight": 0,
"packingWidth": 0,
"position": 0,
"productId": 42,
"productType": "string",
"requiresShipping": true,
"resellerVisibility": "visible",
"serialPrefix": "string",
"serialReference": 0,
"serialSuffix": "string",
"sku": "string",
"tags": [
"string"
],
"taxable": true,
"totalPurchaseItems": 0,
"totalSaleItems": 0,
"vendorId": 42,
"vendorSku": "string"
}
{
"accountingSync": "active",
"automaticallyBackorder": "vendor_default",
"backorderQuantity": 0,
"barcode": "string",
"commissionRate": 0,
"commissionRateRouting": "dropship_provider",
"commissionRateType": "percentage",
"costPrice": 0,
"countryOfOrigin": "string",
"createdAt": "2024-05-04T09:42:00+00:00",
"defaultPurchaseQuantity": 1,
"denyThreshold": 0,
"description": "string",
"distanceUnit": "in",
"dropshipProviderAddressId": 42,
"dropshipProviderAddressMapping": "default",
"dropshipProviderId": 42,
"dropshipProviderMapping": "brand_name",
"dynamicInventoryPolicy": true,
"fulfillmentPolicy": "vendor_default",
"grams": 0,
"hsCode": "string",
"id": 42,
"images": [],
"imagesMapped": {},
"imagesRaw": {},
"inventoryAllocated": 0,
"inventoryFeeds": 0,
"inventoryPolicy": "track",
"inventoryQuantity": 0,
"inventoryRouting": "inventory_feed",
"inventorySync": "channel",
"inventoryType": "tracked",
"leadTime": 42,
"levels": {},
"lowInventoryQuantity": true,
"minInventoryQuantity": 0,
"minimumGuidePrice": 0,
"mpn": "string",
"name": "string",
"noInventoryPolicy": "replenish",
"notes": "string",
"orderSplitting": "default",
"packingDepth": 0,
"packingHeight": 0,
"packingWidth": 0,
"position": 0,
"productId": 42,
"productType": "string",
"requiresShipping": true,
"resellerVisibility": "visible",
"serialPrefix": "string",
"serialReference": 0,
"serialSuffix": "string",
"sku": "string",
"tags": [
"string"
],
"taxable": true,
"totalPurchaseItems": 0,
"totalSaleItems": 0,
"updatedAt": "2024-05-04T09:42:00+00:00",
"vendorId": 42,
"vendorSku": "string"
}