Skip to content

CatalogResource

Defined in: sdks/hepsiburada/src/resources/catalog.ts:40

Hepsiburada Catalog Products (katalog-urun-entegrasyonu — product surface).

Service base URL: mpop[-sit].hepsiburada.com, /product/api/products/*.

Covers the full 11-endpoint product CRUD surface — read (list / by-status / history), upload (file / fast-listing), pre-match approve/reject, delete (async with tracking-id polling), and status checks.

new CatalogResource(transport, limiter?): CatalogResource

Defined in: sdks/hepsiburada/src/resources/catalog.ts:43

HepsiburadaTransport

TokenBucketRateLimiter

CatalogResource

approvePreMatch(input): Promise<MutationResult>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:197

Approve a product Hepsiburada has pre-matched to an existing catalog entry.

PreMatchActionInput

Promise<MutationResult>


checkProductStatus(input): Promise<MutationResult>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:229

Check upload status for one or more tracking ids in a single request.

CheckProductStatusInput

Promise<MutationResult>


deleteByMerchantSkuList(input): Promise<CatalogTrackingReceipt>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:250

Delete one or more products by merchant SKU. Returns a trackingId you can poll via getDeleteProcess(trackingId).

DeleteBySkuInput

Promise<CatalogTrackingReceipt>


getDeleteProcess(trackingId): Promise<CatalogProductStatus>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:273

Look up the status of an in-flight delete request by tracking-id.

string

Promise<CatalogProductStatus>


getProductStatus(trackingId): Promise<CatalogProductStatus>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:128

Look up status for a single tracking-id (returned by an earlier upload).

string

Promise<CatalogProductStatus>


getTrackingIdHistory(): Promise<TrackingIdHistoryEntry[]>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:142

Get the upload-history feed for the merchant’s tracking ids.

Promise<TrackingIdHistoryEntry[]>


listProducts(params?): Promise<OffsetPage<CatalogProduct>>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:66

List the merchant’s catalog rows, one page at a time, optionally narrowed to a single barcode / merchantSku / hbSku.

Returns an OffsetPage mapped from Hepsiburada’s Spring-style envelope (totalElements → totalCount, totalPages → pageCount, data → items). Page by page / size, or by offset / limit to drive it with paginateOffset (pass limit — the API pages by number, so offset must be a multiple of it). A filter that matches nothing comes back as HTTP 200 success: false, code: 4014 with an empty data array; that is surfaced as an empty page, not an error.

ListCatalogProductsParams = {}

Promise<OffsetPage<CatalogProduct>>

when offset / limit cannot be expressed as a page.


listProductsByStatus(params): Promise<OffsetPage<CatalogProduct>>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:100

List catalog rows filtered by lifecycle status ('MATCHED', 'WAITING', 'MISSING_INFO', … — see CatalogProductLifecycleStatus).

Hepsiburada requires the status (query parameter productStatus) and answers HTTP 500 — not 400 — when it is missing or not one of its UPPER_SNAKE values, so the SDK validates presence up front. A status bucket with no rows comes back as HTTP 200 success: false, code: 4008 with an empty data array; that is surfaced as an empty page, not an error.

Returns an OffsetPage (see listProducts for the envelope mapping and the offset / limit alias that makes it work with paginateOffset).

ListProductsByStatusParams

Promise<OffsetPage<CatalogProduct>>

when status is missing or empty, or when offset / limit cannot be expressed as a page.


rejectPreMatch(input): Promise<MutationResult>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:213

Reject a pre-match Hepsiburada has proposed.

PreMatchActionInput

Promise<MutationResult>


uploadFastListing(input): Promise<CatalogTrackingReceipt>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:182

Upload a fast-listing payload (Hepsiburada’s “Hızlı Ürün Yükleme” flow).

FastListingInput

Promise<CatalogTrackingReceipt>


uploadProductViaFile(products): Promise<CatalogTrackingReceipt>

Defined in: sdks/hepsiburada/src/resources/catalog.ts:165

Upload one or more products as JSON. Returns a trackingId you can poll via getProductStatus(trackingId).

UploadProductsInput

Promise<CatalogTrackingReceipt>

when products is empty.

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.