PUT /inventory-feeds/{id}.json
Path parameters
-
Numeric ID of the instance
Minimum value is
1
.
Body Required
-
adminNotes string | null
Admin notes
-
Allocate inventory
Default value is
false
. -
allocationBuffer integer(int32) | null
Allocation buffer
-
Archive reason
Values are
subscription
orother
. Default value isother
. -
authenticationSecret string | null
Authentication secret
-
authenticationToken string | null
Authentication token
-
Automated fetching
Values are
enabled
ordisabled
. Default value isenabled
. -
Automatically connect
Default value is
true
. -
Automatically connect by barcode
Default value is
false
. -
automaticallyConnectChannelVariant boolean | null
Use this setting to link items to their original sales channel SKU, rather than the Onport-imported SKU, which is particularly useful for preventing conflicts with duplicate SKUs already present in your store inventory.
-
automaticallyConnectOptionValues boolean | null
Enable this setting to ensure a vendor item is linked to the corresponding marketplace SKU only if their option values (such as color and size) are an exact match, enhancing accuracy in inventory matching.
-
Automatically connect prefix
Values are
both
orprefixOnly
. Default value isboth
. -
Cache changes
Default value is
false
. -
Cache imports
Default value is
false
. -
Case insensitive skus
Default value is
false
. -
Connected
Default value is
0
. -
createdAt string(date-time)
Created at
-
csvHasHeader boolean | null
Csv has header
-
currencyId integer(int32) | null
Currency
-
Decimal notation
Values are
decimal
orcomma
. Default value isdecimal
. -
delimiter string | null
Delimiter
-
Diff previous
Default value is
true
. -
Dropship provider
-
Enabled
Default value is
true
. -
exportSkuThreshold integer(int32) | null
Export sku threshold
-
externalIdStrategy string | null
External id strategy
Values are
none
oroptions
. -
Fetch cleanup
Values are
enabled
ordisabled
. Default value isenabled
. -
Fetch frequency
Values are
never
,hourly
,daily
,custom
, orwebhook
. Default value ishourly
. -
fetchFrequencyReason string | null
Fetch frequency reason
Values are
manual
,duration
,planAllowance
,count
,plan
,default
, orcustom
. -
fetchMetaFields boolean | null
Enabling this option may affect fetching performance, namely if it’s a very large feed.
fetchProblem object | null | array | boolean | integer | number | string
-
Fetched
Default value is
0
. -
Force all inventory updates
Default value is
false
. -
googleSheetTab integer(int32) | null
Google sheet tab
-
handlePrefix string | null
Handle prefix
-
Handle strategy
Values are
externalGroupId
,externalGroupIdStart
, orname
. Default value isexternalGroupId
. -
hookdeckId string | null
Hookdeck
-
id integer(int32)
Id
-
Import seconds
Default value is
0
. -
Import seconds partial
Default value is
0
. -
Individual products
Default value is
false
. -
Inline inventory updates
Values are
enabled
ordisabled
. Default value isdisabled
. -
intercomMessageId string | null
Intercom message
-
inventoryEndpoint string | null
Inventory endpoint
-
inventoryFeedMappingUrl string | null
To streamline your inventory feed setup, Onport enables you to import mappings directly from a Google Sheet. This method eliminates the need to manually create each mapping within the dashboard, saving you considerable time and effort. To utilize this feature, simply provide the URL of your Google Sheet in the text input below. Ensure your sheet is correctly formatted and shared for Onport to access. For a seamless start, you can use our example sheet: Google Sheet Example - clone this sheet and customize it to fit your inventory needs. Additionally, if you're uncertain how to enable sharing for your Google Sheet, please refer to this instructional video: How to Enable Google Sheet Sharing for Onport. This feature ensures that Onport automatically imports your mappings, facilitating a more efficient data fetch for your inventory feed.
Maximum length is
255
. -
This feature allows you to sync inventory quantities stored in metafields specific to different locations directly to your marketplace. By configuring these metafields, you can ensure accurate inventory management across multiple locations.
Most vendors typically do not use metafields for location-specific inventory tracking. However, if your vendor does use metafields to store inventory quantities for different locations, this feature will be highly beneficial for syncing this information seamlessly to your marketplace.
Default value is
[]
(empty). -
Inventory policy
Values are
default
,ignore
,continue
, ortrack
. Default value isdefault
. -
Inventory policy sync
Default value is
true
. -
inventoryQuantityField string | null
Inventory quantity field
-
Inventory restriction level
Default value is
0
. -
Inventory sync
Values are
all
,selected
, ornone
. Default value isall
. -
Is valid
Default value is
true
. -
Json mapping
Values are
default
orcustom
. Default value isdefault
. -
jsonRoot string | null
Json root
-
Json structure
Values are
nested
orflat
. Default value isnested
. -
lastFetchedAt string(date-time) | null
Last fetched at
-
lastFetchedFile string | null
Last fetched file
-
Limit handling
Values are
fail
orlimit
. Default value isfail
. -
Select how to sync inventory from the locations/warehouse in the vendors store. if you opt to filter by location, this may significantly increase times to fetch data and lead to slower times to update inventory. It's recommend only using this setting if needed (e.g. the vendor has allocation/segmented specific inventory in a location).
Values are
selected
,all
, ornone
. Default value isnone
. -
locationIds array[string] | null
Location ids
-
magentoStoreId string | null
Magento store
-
Manual fetch frequency
Values are
default
,hourly
,daily
,custom
, orwebhook
. Default value isdefault
. -
Mapping
Values are
inventory
,inventory_pricing
,shopify
,custom
,publishing
, orchannelEngine
. Default value isinventory
. -
Mapping type
Values are
fetch
orimport
. Default value isimport
. -
metaFieldTagDelimiters array[string] | null
Use this feature to automatically convert your tags into structured metafields, simplifying data organization and management. Specify the characters that you use to split your tags, such as a colon (:) or a pipe (|). You can enter multiple characters, each one representing a different way you might separate parts of your tags. For example, if you have the tag
Genre:Fiction
, enter the character:
below. -
minimumInventoryQuantity integer(int32) | null
Minimum inventory quantity
-
Mute error
Default value is
false
. -
Name
-
Negative inventory buffer
Default value is
true
. -
Override vendor name
Default value is
true
. -
parseWebhookEndpoint string | null
Parse webhook endpoint
-
Enable this option to prevent connections from automatically updating connections between vendor and marketplace items when underlying vendor attributes (e.g., SKU, barcode) change.
Values are
enabled
ordisabled
. Default value isenabled
. -
Prefix handle
Default value is
false
. -
Prefix name
Default value is
false
. -
prefixSeperator string | null
Prefix seperator
-
Prefix sku
Default value is
false
. -
Presta shop legacy
Default value is
false
. -
Prestashop barcode field
Values are
ean13
orupc
. Default value isupc
. -
Activate this feature to ensure that, even with auto-connect enabled, items will not be connected automatically if a duplicate SKU or barcode is detected in your inventory. This measure prevents incorrect item associations in the marketplace. When duplicates are found, an error appears, prompting manual verification and connection to the correct item. This process helps maintain accurate inventory management.
Values are
enabled
ordisabled
. Default value isdisabled
. -
Price change base
Values are
retail_price
orcost_price
. Default value isretail_price
. -
priceField string | null
Price field
-
priceListId integer(int32) | null
Price list
-
priceUpliftEndpoint string | null
Price uplift endpoint
-
If you have multiple vendors selling the same SKU, you can let vendors see the prices other vendors are selling the SKU for in their vendor portal.
Values are
none
,full
, orprices
. Default value isnone
. -
Process type
Values are
default
orpush
. Default value isdefault
. -
proxyUri boolean | null
Proxy uri
-
Publish changes automatically
Default value is
false
. -
Publish products
Default value is
true
. -
Purpose
Values are
publishing
orinventory
. Default value ispublishing
. -
Require barcode
Default value is
false
. -
resourceLocation string | null
Resource location
-
resourcePath string | null
Resource path
-
Resource type
Values are
api
,bigCommerce
,channelEngine
,channelEngineCsv
,etsy
,ftpCsv
,googleDrive
,json
,magento
,magentoLegacy
,manual
,prestaShop
,salesforce
,selz
,shopify_csv
,shopify
,squareSpace
,tradeGecko
,upload
,webhook
,wooCommerce
,wooCommerceLegacy
,wix
, orxml
. -
Restrict inventory import
Default value is
false
. -
Retail price change
Default value is
0
. -
Retail price change type
Values are
percentage
orfixed
. Default value ispercentage
. -
reviewApprovedEndpoint string | null
Review approved endpoint
-
Review changes
Default value is
false
. -
reviewRejectedEndpoint string | null
Review rejected endpoint
-
Send notification
Default value is
false
. -
Send webhook
Default value is
false
. -
Skipped
Default value is
0
. -
skuExempt boolean | null
Sku exempt
-
skuField string | null
Sku field
-
In some scenarios, vendors may not use the expected field for storing the SKU. This allows you to pull the SKU using a Regex from the product name or description. Or, if the vendor stores the SKU in on of the option values. If no SKU if found using these advanced options, it will go back to the default value.
Values are
sku
,name
,description
, oroptionValue
. Default value issku
. -
skuImportStrategyOption integer(int32) | null
-
skuImportStrategySearch string | null
For example, you could enter
/{(.*)}/
in the field if the vendor has placed the SKU in curly braces. -
skuPrefix string | null
Sku prefix
-
sourceLocation string | null
Source location
-
Sync all price lists
Default value is
true
. -
Sync cost prices
Default value is
false
. -
Sync description
Default value is
false
. -
When enabled, where compareAtPrice is equal to retail price. compareAtPrice will be synced when fetching inventory feeds.
Default value is
false
. -
Sync images
Default value is
false
. -
Sync name
Default value is
false
. -
Sync options
Default value is
false
. -
Sync pricing
Default value is
false
. -
Set the product type for the item when publishing on the channel. For all channels except Saleor (e.g. Shopify), the product type will always be synced when publishing.
Default value is
false
. -
Sync sale prices
Default value is
true
. -
Sync the weights from your inventory feed. The weight should be in grams in order to correctly sync with Onport and your online stores. You should ensure your vendor has complete weight information if using Onport's live carrier rates feature.
Default value is
false
. -
Sync weight zero
Default value is
false
. -
Tag restriction
Values are
deny
orallow
. Default value isdeny
. -
Taxable override
Values are
default
,taxable
, ornotTaxable
. Default value isdefault
. -
transformImageTemplate string | null
Transform image template
-
transformImages boolean | null
Transform images
-
Unpublish removed items
Default value is
false
. -
unpublishedProducts boolean | null
Unpublished products
-
updatedAt string(date-time)
Updated at
-
uploadPricing boolean | null
Upload pricing
-
Automatically set the allocation buffer for items using an API pipeline. Jetti will send a payload of data detailing the item and feed. The external service can then use that data to dynamically set the inventory allocation buffer. This will override the default value set in inventory feed settings.
Default value is
false
. -
useParseWebhookEndpoint boolean | null
Use parse webhook endpoint
-
Use price uplift endpoint
Default value is
false
. -
useProxy boolean | null
Use proxy
-
The Approved Webhook allows you to configure a URL endpoint that will receive an HTTP POST request whenever an inventory feed variant object's review status changes to "approved." When an item is approved, the system will automatically send a payload containing the relevant inventory feed variant details to the provided URL. This webhook enables you to integrate your systems or services with real-time updates. For example, you could use this webhook to trigger the publishing of an item to a channel in Onport.
Default value is
true
. -
The Rejected Webhook enables you to set up a URL endpoint that will be notified through an HTTP POST request whenever an inventory feed variant review status is changed to "rejected." In the case of a rejection, the system will send a payload containing the pertinent inventory feed variant information to the specified URL. This webhook facilitates seamless integration to your external systems, allowing you to respond dynamically to rejected items. For instance, you might use this webhook to trigger a custom email notification to the vendor.
Default value is
true
. -
validationMessage array[string] | null
Validation message
-
vendorName string | null
Vendor name
-
vendorNameMetafields boolean | null
Vendor name metafields
-
webhookEndpoint string | null
Webhook endpoint
-
Weight unit
Values are
g
,kg
,oz
, orlb
. Default value isg
. -
Xml mapping
Values are
custom
orgoogle
. Default value isgoogle
. -
xmlPath string | null
Xml path
-
Zero null prices
Default value is
false
.
curl \
-X PUT http://api.example.com/v1/inventory-feeds/{id}.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"adminNotes":"string","allocateInventory":false,"allocationBuffer":42,"archiveReason":"other","authenticationSecret":"string","authenticationToken":"string","automatedFetching":"enabled","automaticallyConnect":true,"automaticallyConnectByBarcode":false,"automaticallyConnectChannelVariant":true,"automaticallyConnectOptionValues":true,"automaticallyConnectPrefix":"both","cacheChanges":false,"cacheImports":false,"caseInsensitiveSkus":false,"connected":0,"createdAt":"2024-05-04T09:42:00+00:00","csvHasHeader":true,"currencyId":42,"decimalNotation":"decimal","delimiter":"string","diffPrevious":true,"dropshipProviderId":42,"enabled":true,"excludeTags":["string"],"exportSkuThreshold":42,"externalIdStrategy":"none","fetchCleanup":"enabled","fetchFrequency":"hourly","fetchFrequencyReason":"manual","fetchMetaFields":true,"fetchProblem":{},"fetched":0,"forceAllInventoryUpdates":false,"googleSheetTab":42,"handlePrefix":"string","handleStrategy":"externalGroupId","hash":{},"hookdeckId":"string","id":42,"importSeconds":0,"importSecondsPartial":0,"importTags":true,"individualProducts":false,"inlineInventoryUpdates":"disabled","intercomMessageId":"string","inventoryEndpoint":"string","inventoryFeedMappingUrl":"string","inventoryLocationMetafields":[],"inventoryPolicy":"default","inventoryPolicySync":true,"inventoryQuantityField":"string","inventoryRestrictionLevel":0,"inventorySync":"all","isBeta":{},"isValid":true,"jsonMapping":"default","jsonRoot":"string","jsonStructure":"nested","lastFetchedAt":"2024-05-04T09:42:00+00:00","lastFetchedFile":"string","limitHandling":"fail","locationFetch":"none","locationIds":["string"],"magentoStoreId":"string","manualFetchFrequency":"default","mapping":"inventory","mappingType":"import","metaFieldTagDelimiters":["string"],"minimumInventoryQuantity":42,"muteError":false,"name":"string","negativeInventoryBuffer":true,"overrideVendorName":true,"overwriteTags":false,"parseWebhookEndpoint":"string","persistConnections":"enabled","prefixHandle":false,"prefixName":false,"prefixSeperator":"string","prefixSku":false,"prestaShopLegacy":false,"prestashopBarcodeField":"upc","preventConnectDuplicates":"disabled","priceChangeBase":"retail_price","priceField":"string","priceListId":42,"priceUpliftEndpoint":"string","priceVisibility":"none","processType":"default","proxyUri":true,"publishChangesAutomatically":false,"publishProducts":true,"purpose":"publishing","requireBarcode":false,"resourceLocation":"string","resourcePath":"string","resourceType":"api","restrictInventoryImport":false,"retailPriceChange":0,"retailPriceChangeType":"percentage","reviewApprovedEndpoint":"string","reviewChanges":false,"reviewRejectedEndpoint":"string","sendNotification":false,"sendWebhook":false,"skipped":0,"skuExempt":true,"skuField":"string","skuImportStrategy":"sku","skuImportStrategyOption":42,"skuImportStrategySearch":"string","skuPrefix":"string","sourceLocation":"string","stripTags":false,"strippedTags":["string"],"syncAllPriceLists":true,"syncCostPrices":false,"syncDescription":false,"syncEqualCompareAtPrice":false,"syncImages":false,"syncName":false,"syncOptions":false,"syncPricing":false,"syncProductType":false,"syncSalePrices":true,"syncTags":false,"syncWeight":false,"syncWeightZero":false,"tagRestriction":"deny","tags":["string"],"taxableOverride":"default","transformImageTemplate":"string","transformImages":true,"transformTags":"unchanged","unpublishRemovedItems":false,"unpublishedProducts":true,"updatedAt":"2024-05-04T09:42:00+00:00","uploadPricing":true,"useInventoryEndpoint":false,"useParseWebhookEndpoint":true,"usePriceUpliftEndpoint":false,"useProxy":true,"useReviewApprovedEndpoint":true,"useReviewRejectedEndpoint":true,"validationMessage":["string"],"vendorName":"string","vendorNameMetafields":true,"webhookEndpoint":"string","weightUnit":"g","xmlMapping":"google","xmlPath":"string","zeroNullPrices":false}'
{
"adminNotes": "string",
"allocateInventory": false,
"allocationBuffer": 42,
"archiveReason": "other",
"authenticationSecret": "string",
"authenticationToken": "string",
"automatedFetching": "enabled",
"automaticallyConnect": true,
"automaticallyConnectByBarcode": false,
"automaticallyConnectChannelVariant": true,
"automaticallyConnectOptionValues": true,
"automaticallyConnectPrefix": "both",
"cacheChanges": false,
"cacheImports": false,
"caseInsensitiveSkus": false,
"connected": 0,
"createdAt": "2024-05-04T09:42:00+00:00",
"csvHasHeader": true,
"currencyId": 42,
"decimalNotation": "decimal",
"delimiter": "string",
"diffPrevious": true,
"dropshipProviderId": 42,
"enabled": true,
"excludeTags": [
"string"
],
"exportSkuThreshold": 42,
"externalIdStrategy": "none",
"fetchCleanup": "enabled",
"fetchFrequency": "hourly",
"fetchFrequencyReason": "manual",
"fetchMetaFields": true,
"fetchProblem": {},
"fetched": 0,
"forceAllInventoryUpdates": false,
"googleSheetTab": 42,
"handlePrefix": "string",
"handleStrategy": "externalGroupId",
"hash": {},
"hookdeckId": "string",
"id": 42,
"importSeconds": 0,
"importSecondsPartial": 0,
"importTags": true,
"individualProducts": false,
"inlineInventoryUpdates": "disabled",
"intercomMessageId": "string",
"inventoryEndpoint": "string",
"inventoryFeedMappingUrl": "string",
"inventoryLocationMetafields": [],
"inventoryPolicy": "default",
"inventoryPolicySync": true,
"inventoryQuantityField": "string",
"inventoryRestrictionLevel": 0,
"inventorySync": "all",
"isBeta": {},
"isValid": true,
"jsonMapping": "default",
"jsonRoot": "string",
"jsonStructure": "nested",
"lastFetchedAt": "2024-05-04T09:42:00+00:00",
"lastFetchedFile": "string",
"limitHandling": "fail",
"locationFetch": "none",
"locationIds": [
"string"
],
"magentoStoreId": "string",
"manualFetchFrequency": "default",
"mapping": "inventory",
"mappingType": "import",
"metaFieldTagDelimiters": [
"string"
],
"minimumInventoryQuantity": 42,
"muteError": false,
"name": "string",
"negativeInventoryBuffer": true,
"overrideVendorName": true,
"overwriteTags": false,
"parseWebhookEndpoint": "string",
"persistConnections": "enabled",
"prefixHandle": false,
"prefixName": false,
"prefixSeperator": "string",
"prefixSku": false,
"prestaShopLegacy": false,
"prestashopBarcodeField": "upc",
"preventConnectDuplicates": "disabled",
"priceChangeBase": "retail_price",
"priceField": "string",
"priceListId": 42,
"priceUpliftEndpoint": "string",
"priceVisibility": "none",
"processType": "default",
"proxyUri": true,
"publishChangesAutomatically": false,
"publishProducts": true,
"purpose": "publishing",
"requireBarcode": false,
"resourceLocation": "string",
"resourcePath": "string",
"resourceType": "api",
"restrictInventoryImport": false,
"retailPriceChange": 0,
"retailPriceChangeType": "percentage",
"reviewApprovedEndpoint": "string",
"reviewChanges": false,
"reviewRejectedEndpoint": "string",
"sendNotification": false,
"sendWebhook": false,
"skipped": 0,
"skuExempt": true,
"skuField": "string",
"skuImportStrategy": "sku",
"skuImportStrategyOption": 42,
"skuImportStrategySearch": "string",
"skuPrefix": "string",
"sourceLocation": "string",
"stripTags": false,
"strippedTags": [
"string"
],
"syncAllPriceLists": true,
"syncCostPrices": false,
"syncDescription": false,
"syncEqualCompareAtPrice": false,
"syncImages": false,
"syncName": false,
"syncOptions": false,
"syncPricing": false,
"syncProductType": false,
"syncSalePrices": true,
"syncTags": false,
"syncWeight": false,
"syncWeightZero": false,
"tagRestriction": "deny",
"tags": [
"string"
],
"taxableOverride": "default",
"transformImageTemplate": "string",
"transformImages": true,
"transformTags": "unchanged",
"unpublishRemovedItems": false,
"unpublishedProducts": true,
"updatedAt": "2024-05-04T09:42:00+00:00",
"uploadPricing": true,
"useInventoryEndpoint": false,
"useParseWebhookEndpoint": true,
"usePriceUpliftEndpoint": false,
"useProxy": true,
"useReviewApprovedEndpoint": true,
"useReviewRejectedEndpoint": true,
"validationMessage": [
"string"
],
"vendorName": "string",
"vendorNameMetafields": true,
"webhookEndpoint": "string",
"weightUnit": "g",
"xmlMapping": "google",
"xmlPath": "string",
"zeroNullPrices": false
}