Inventory Product

POST /openapi/{version}/products/inventory/

Bulk create multiple inventory product entries in a single request.

Note: This is an asynchronous API. This will return the task ID which is submitted to create the Inventory Products.

To know the status of the task, you can do one of the following:-,

  1. Use Get Bulk Create or Update Product Status API by providing the task ID.

    OR

  2. Subscribe to the InventoryProductBulkUploadStatus callback type in Seller Webhooks section.

Example:

curl --location '{{url}}/openapi/v2/products/inventory/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '[
    {
        "sku": "SKU001-test-31",
        "name": "Product One",
        "cost_price_currency": "PHP",
        "cost_price": "10.50",
        "dimension_height": "10.00",
        "dimension_width": "5.00",
        "dimension_length": "20.00",
        "weight": "1.50",
        "expiry_managed_enabled": true,
        "batch_managed_enabled": false,
        "sell_by": 30,
        "serial_number_enabled": true,
        "upc": "Demo-31",
        "country_of_origin": "MY",
        "country_hs_codes": [
            {
                "country_code": "MY",
                "hs_code": "6109.10.01"
            }
        ],
        "material": "Leather",
        "description": "High-quality leather product with excellent durability and comfort."
    },
    {
        "sku": "SKU001-test-32",
        "name": "Product Two",
        "cost_price_currency": "PHP",
        "cost_price": "10.50",
        "dimension_height": "10.00",
        "dimension_width": "5.00",
        "dimension_length": "20.00",
        "weight": "1.50",
        "expiry_managed_enabled": true,
        "batch_managed_enabled": false,
        "sell_by": 30,
        "serial_number_enabled": true,
        "upc": "Demo-32",
        "country_of_origin": "MY",
        "country_hs_codes": [
            {
                "country_code": "MY",
                "hs_code": "6109.10.01"
            }
        ],
        "material": "Wool",
        "description": "Premium wool material providing warmth and comfort."
    }
]'

Request

  • Base URL
    https://base_url
  • Auth
    none declared

Path parameters

versionstring required

Request body

skustring required
namestring required
upcstring
image_urlstring
hs_codestring
cost_price_currencystring required
cost_pricestring decimal required
inventory_buffer_percentinteger
minimum_buffer_stockinteger
brand_idinteger required
is_fragileboolean
activeboolean
dimension_heightstring decimal required
dimension_widthstring decimal required
dimension_lengthstring decimal required
weightstring decimal required
expiry_managed_enabledboolean
batch_managed_enabledboolean
sell_byinteger
serial_number_enabledboolean
is_split_enabledboolean
storage_typestring
country_of_origin'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MK' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'AN' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'NO' | 'OM' | 'PK' | 'PW' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'CS' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW'
  • AF - AF
  • AL - AL
  • DZ - DZ
  • AS - AS
  • AD - AD
  • AO - AO
  • AI - AI
  • AG - AG
  • AR - AR
  • AM - AM
  • AW - AW
  • AU - AU
  • AT - AT
  • AZ - AZ
  • BS - BS
  • BH - BH
  • BD - BD
  • BB - BB
  • BY - BY
  • BE - BE
  • BZ - BZ
  • BJ - BJ
  • BM - BM
  • BT - BT
  • BO - BO
  • BA - BA
  • BW - BW
  • BV - BV
  • BR - BR
  • IO - IO
  • BN - BN
  • BG - BG
  • BF - BF
  • BI - BI
  • KH - KH
  • CM - CM
  • CA - CA
  • CV - CV
  • KY - KY
  • CF - CF
  • TD - TD
  • CL - CL
  • CN - CN
  • CX - CX
  • CC - CC
  • CO - CO
  • KM - KM
  • CG - CG
  • CD - CD
  • CK - CK
  • CR - CR
  • CI - CI
  • HR - HR
  • CU - CU
  • CY - CY
  • CZ - CZ
  • DK - DK
  • DJ - DJ
  • DM - DM
  • DO - DO
  • EC - EC
  • EG - EG
  • SV - SV
  • GQ - GQ
  • ER - ER
  • EE - EE
  • ET - ET
  • FK - FK
  • FO - FO
  • FJ - FJ
  • FI - FI
  • FR - FR
  • GF - GF
  • PF - PF
  • TF - TF
  • GA - GA
  • GM - GM
  • GE - GE
  • DE - DE
  • GH - GH
  • GI - GI
  • GR - GR
  • GL - GL
  • GD - GD
  • GP - GP
  • GU - GU
  • GT - GT
  • GN - GN
  • GW - GW
  • GY - GY
  • HT - HT
  • HM - HM
  • VA - VA
  • HN - HN
  • HK - HK
  • HU - HU
  • IS - IS
  • IN - IN
  • ID - ID
  • IR - IR
  • IQ - IQ
  • IE - IE
  • IL - IL
  • IT - IT
  • JM - JM
  • JP - JP
  • JO - JO
  • KZ - KZ
  • KE - KE
  • KI - KI
  • KP - KP
  • KR - KR
  • KW - KW
  • KG - KG
  • LA - LA
  • LV - LV
  • LB - LB
  • LS - LS
  • LR - LR
  • LY - LY
  • LI - LI
  • LT - LT
  • LU - LU
  • MO - MO
  • MK - MK
  • MG - MG
  • MW - MW
  • MY - MY
  • MV - MV
  • ML - ML
  • MT - MT
  • MH - MH
  • MQ - MQ
  • MR - MR
  • MU - MU
  • YT - YT
  • MX - MX
  • FM - FM
  • MD - MD
  • MC - MC
  • MN - MN
  • MS - MS
  • MA - MA
  • MZ - MZ
  • MM - MM
  • NA - NA
  • NR - NR
  • NP - NP
  • NL - NL
  • AN - AN
  • NC - NC
  • NZ - NZ
  • NI - NI
  • NE - NE
  • NG - NG
  • NU - NU
  • NF - NF
  • MP - MP
  • NO - NO
  • OM - OM
  • PK - PK
  • PW - PW
  • PA - PA
  • PG - PG
  • PY - PY
  • PE - PE
  • PH - PH
  • PN - PN
  • PL - PL
  • PT - PT
  • PR - PR
  • QA - QA
  • RE - RE
  • RO - RO
  • RU - RU
  • RW - RW
  • SH - SH
  • KN - KN
  • LC - LC
  • PM - PM
  • VC - VC
  • WS - WS
  • SM - SM
  • ST - ST
  • SA - SA
  • SN - SN
  • CS - CS
  • SC - SC
  • SL - SL
  • SG - SG
  • SK - SK
  • SI - SI
  • SB - SB
  • SO - SO
  • ZA - ZA
  • ES - ES
  • LK - LK
  • SD - SD
  • SR - SR
  • SJ - SJ
  • SZ - SZ
  • SE - SE
  • CH - CH
  • SY - SY
  • TW - TW
  • TJ - TJ
  • TZ - TZ
  • TH - TH
  • TL - TL
  • TG - TG
  • TK - TK
  • TO - TO
  • TT - TT
  • TN - TN
  • TR - TR
  • TM - TM
  • TC - TC
  • TV - TV
  • UG - UG
  • UA - UA
  • AE - AE
  • GB - GB
  • US - US
  • UM - UM
  • UY - UY
  • UZ - UZ
  • VU - VU
  • VE - VE
  • VN - VN
  • VG - VG
  • VI - VI
  • WF - WF
  • EH - EH
  • YE - YE
  • ZM - ZM
  • ZW - ZW
materialstring

Material of the product (e.g., Leather, Wool)

descriptionstring

Long description of the product

Response

Successful Bulk Create Inventory Product Task Submission.

successboolean
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.