ListingsResource
Defined in: sdks/hepsiburada/src/resources/listings.ts:144
Hepsiburada listings / stock / price / shipping / additional-info endpoints.
Service base URL: listing-external[-sit].hepsiburada.com.
Async upload pattern (mirrors Trendyol’s batch model): every POST upload
endpoint returns { id } — poll the matching get*Upload(id) to read the
outcome (status + per-item errors). Hepsiburada retains upload results for
24+ hours.
Rate limit: Hepsiburada doesn’t publish a per-endpoint limit on this surface; the SDK provisions a generous 600 req/min token bucket that you can override.
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new ListingsResource(
transport,limiter?):ListingsResource
Defined in: sdks/hepsiburada/src/resources/listings.ts:147
Parameters
Section titled “Parameters”transport
Section titled “transport”HepsiburadaTransport
limiter?
Section titled “limiter?”TokenBucketRateLimiter
Returns
Section titled “Returns”ListingsResource
Methods
Section titled “Methods”activate()
Section titled “activate()”activate(
hepsiburadaSku):Promise<void>
Defined in: sdks/hepsiburada/src/resources/listings.ts:411
Activate one listing by hepsiburadaSku. Reverses a prior
deactivate / “is not salable” state when the underlying issue
(low stock, suspended, etc.) is resolved.
Parameters
Section titled “Parameters”hepsiburadaSku
Section titled “hepsiburadaSku”string
Returns
Section titled “Returns”Promise<void>
bulkUnlock()
Section titled “bulkUnlock()”bulkUnlock(
input):Promise<void>
Defined in: sdks/hepsiburada/src/resources/listings.ts:461
Bulk-unlock Hepsiburada SKUs that Hepsiburada has locked (typically
due to pricing or supply issues — same family as Trendyol’s unlock).
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<void>
Throws
Section titled “Throws”when hbSkuList is empty.
deactivate()
Section titled “deactivate()”deactivate(
hepsiburadaSku):Promise<void>
Defined in: sdks/hepsiburada/src/resources/listings.ts:421
Deactivate one listing by hepsiburadaSku.
Parameters
Section titled “Parameters”hepsiburadaSku
Section titled “hepsiburadaSku”string
Returns
Section titled “Returns”Promise<void>
deleteSingle()
Section titled “deleteSingle()”deleteSingle(
hepsiburadaSku,merchantSku):Promise<void>
Defined in: sdks/hepsiburada/src/resources/listings.ts:446
Permanently delete one listing.
Parameters
Section titled “Parameters”hepsiburadaSku
Section titled “hepsiburadaSku”string
merchantSku
Section titled “merchantSku”string
Returns
Section titled “Returns”Promise<void>
getAdditionalInfoUpload()
Section titled “getAdditionalInfoUpload()”getAdditionalInfoUpload(
uploadId):Promise<UploadResult>
Defined in: sdks/hepsiburada/src/resources/listings.ts:398
Parameters
Section titled “Parameters”uploadId
Section titled “uploadId”string
Returns
Section titled “Returns”Promise<UploadResult>
getBuyboxOrder()
Section titled “getBuyboxOrder()”getBuyboxOrder(
skuList):Promise<BuyboxOrderRow[]>
Defined in: sdks/hepsiburada/src/resources/listings.ts:213
Buybox-rank info for one or more SKUs. Pass a comma-separated string
via skuList — Hepsiburada accepts both Hepsiburada SKUs and merchant
SKUs. Required despite what the published OpenAPI spec suggests:
the live API rejects empty/missing skuList with 400 "skuList cannot be empty". The SDK validates client-side so the bad request never
leaves the process.
Parameters
Section titled “Parameters”skuList
Section titled “skuList”string
Returns
Section titled “Returns”Promise<BuyboxOrderRow[]>
Throws
Section titled “Throws”when skuList is empty / not a string.
getCommissions()
Section titled “getCommissions()”getCommissions(
skuList):Promise<CommissionRow[]>
Defined in: sdks/hepsiburada/src/resources/listings.ts:250
Commission rates for one or more SKUs (skuList as CSV).
Required despite what the published OpenAPI spec suggests: the live
API rejects empty/missing skuList with 400 "skuList cannot be empty".
Parameters
Section titled “Parameters”skuList
Section titled “skuList”string
Returns
Section titled “Returns”Promise<CommissionRow[]>
Throws
Section titled “Throws”when skuList is empty / not a string.
getInventoryUpload()
Section titled “getInventoryUpload()”getInventoryUpload(
uploadId):Promise<UploadResult>
Defined in: sdks/hepsiburada/src/resources/listings.ts:297
Poll the result of a prior uploadInventory.
Parameters
Section titled “Parameters”uploadId
Section titled “uploadId”string
Returns
Section titled “Returns”Promise<UploadResult>
getPriceUpload()
Section titled “getPriceUpload()”getPriceUpload(
uploadId):Promise<PriceUploadResult>
Defined in: sdks/hepsiburada/src/resources/listings.ts:340
Poll a price upload — surfaces priceValidations[] for floor/ceiling rejections.
Parameters
Section titled “Parameters”uploadId
Section titled “uploadId”string
Returns
Section titled “Returns”Promise<PriceUploadResult>
getShippingInfoUpload()
Section titled “getShippingInfoUpload()”getShippingInfoUpload(
uploadId):Promise<UploadResult>
Defined in: sdks/hepsiburada/src/resources/listings.ts:381
Parameters
Section titled “Parameters”uploadId
Section titled “uploadId”string
Returns
Section titled “Returns”Promise<UploadResult>
getStockUpload()
Section titled “getStockUpload()”getStockUpload(
uploadId):Promise<UploadResult>
Defined in: sdks/hepsiburada/src/resources/listings.ts:319
Parameters
Section titled “Parameters”uploadId
Section titled “uploadId”string
Returns
Section titled “Returns”Promise<UploadResult>
list()
Section titled “list()”list(
params):Promise<OffsetPage<Listing>>
Defined in: sdks/hepsiburada/src/resources/listings.ts:162
List the merchant’s listings. Pagination is mandatory — pass offset
and limit.
Parameters
Section titled “Parameters”params
Section titled “params”Returns
Section titled “Returns”Promise<OffsetPage<Listing>>
Throws
Section titled “Throws”when limit < 1 or offset < 0.
updateSingle()
Section titled “updateSingle()”updateSingle(
hepsiburadaSku,merchantSku,input):Promise<void>
Defined in: sdks/hepsiburada/src/resources/listings.ts:431
Update one listing’s stock / price / dispatch-time in a single call.
Parameters
Section titled “Parameters”hepsiburadaSku
Section titled “hepsiburadaSku”string
merchantSku
Section titled “merchantSku”string
Returns
Section titled “Returns”Promise<void>
uploadAdditionalInfo()
Section titled “uploadAdditionalInfo()”uploadAdditionalInfo(
items):Promise<UploadReceipt>
Defined in: sdks/hepsiburada/src/resources/listings.ts:390
Bulk-update product extras (customization text, installation flag).
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<UploadReceipt>
uploadInventory()
Section titled “uploadInventory()”uploadInventory(
items):Promise<UploadReceipt>
Defined in: sdks/hepsiburada/src/resources/listings.ts:288
“Inventory upload” — Hepsiburada’s combined stock/price/shipping/etc.
bulk endpoint. Use this when you want to push everything at once;
uploadStock, uploadPrice, uploadShippingInfo are narrower
surfaces that update one dimension at a time.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<UploadReceipt>
Throws
Section titled “Throws”when items is empty or longer than 1000.
uploadPrice()
Section titled “uploadPrice()”uploadPrice(
items):Promise<UploadReceipt>
Defined in: sdks/hepsiburada/src/resources/listings.ts:335
Bulk-update prices.
Hepsiburada validates against floor/ceiling rules; if rejected, the
result populates priceValidations[] on getPriceUpload.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<UploadReceipt>
Throws
Section titled “Throws”when items is empty or longer than 1000.
uploadShippingInfo()
Section titled “uploadShippingInfo()”uploadShippingInfo(
items):Promise<UploadReceipt>
Defined in: sdks/hepsiburada/src/resources/listings.ts:373
Bulk-update shipping config (dispatch time, cargo company, warehouses).
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<UploadReceipt>
uploadStock()
Section titled “uploadStock()”uploadStock(
items):Promise<UploadReceipt>
Defined in: sdks/hepsiburada/src/resources/listings.ts:315
Bulk-update stock quantities.
⚠️ This overwrites the stock Hepsiburada holds for each SKU. For listings
fulfilled by Hepsiburada (Listing.isFulfilledByHB === true), that figure
is managed by HB’s warehouse — pushing your own can oversell or zero them
out. Filter those SKUs out of your stock sync unless you mean to override.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<UploadReceipt>
Throws
Section titled “Throws”when items is empty or longer than 1000.
Unofficial. Lonca is an independent, community-maintained project — not affiliated with, endorsed by, or supported by Trendyol, Hepsiburada, or any other marketplace. All marketplace names and trademarks belong to their respective owners.