ClaimsResource
Defined in: sdks/trendyol/src/resources/claims.ts:52
Trendyol claims (return / iade) endpoints.
Rate limit (per Trendyol service limits): shares the order service bucket; the SDK provisions its own 1000 req/min limiter that the caller can override.
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new ClaimsResource(
transport,limiter?):ClaimsResource
Defined in: sdks/trendyol/src/resources/claims.ts:55
Parameters
Section titled “Parameters”transport
Section titled “transport”TrendyolTransport
limiter?
Section titled “limiter?”TokenBucketRateLimiter
Returns
Section titled “Returns”ClaimsResource
Methods
Section titled “Methods”approveLineItems()
Section titled “approveLineItems()”approveLineItems(
claimId,input):Promise<unknown>
Defined in: sdks/trendyol/src/resources/claims.ts:131
Approve specific claim line items. After approval, Trendyol moves those line items into the post-approval refund / return-shipping flow.
Parameters
Section titled “Parameters”claimId
Section titled “claimId”string
Returns
Section titled “Returns”Promise<unknown>
Throws
Section titled “Throws”when claimLineItemIdList is empty.
create()
Section titled “create()”create(
input):Promise<unknown>
Defined in: sdks/trendyol/src/resources/claims.ts:72
Create a return claim against an order. Use this to file a return on
behalf of a customer (e.g. when they called your CS line). For
customer-initiated returns coming from trendyol.com, you receive them
via claims.list() — no need to call create.
Returns whatever Trendyol returns (typically the new claim’s identifier).
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<unknown>
Throws
Section titled “Throws”when claimItems is empty.
createIssue()
Section titled “createIssue()”createIssue(
claimId,input):Promise<unknown>
Defined in: sdks/trendyol/src/resources/claims.ts:92
File a seller-side rejection (“ret talebi”) against a customer claim.
Wire format: multipart/form-data — the SDK builds the FormData
internally from the typed input. claimItemIdList is joined with
commas (Trendyol expects a single comma-separated string field).
Attach supporting docs (PDF / JPEG) via files: [Blob, ...].
Parameters
Section titled “Parameters”claimId
Section titled “claimId”string
Returns
Section titled “Returns”Promise<unknown>
getIssueReasons()
Section titled “getIssueReasons()”getIssueReasons():
Promise<ClaimIssueReason[]>
Defined in: sdks/trendyol/src/resources/claims.ts:196
Fetch the catalog of rejection-reason IDs the seller can use on
claims.createIssue(). Cache the result — it changes rarely.
Note: this endpoint is not seller-scoped (no sellerId in path).
Returns
Section titled “Returns”Promise<ClaimIssueReason[]>
getItemAudits()
Section titled “getItemAudits()”getItemAudits(
claimItemId):Promise<ClaimItemAudit[]>
Defined in: sdks/trendyol/src/resources/claims.ts:214
Fetch the audit log for a single claim item (state transitions,
actor, timestamp). Trendyol’s response shape varies — the SDK
surfaces each row as { raw } and leaves field extraction to the
caller until we observe a stable shape on the wire.
Parameters
Section titled “Parameters”claimItemId
Section titled “claimItemId”string
Returns
Section titled “Returns”Promise<ClaimItemAudit[]>
list()
Section titled “list()”list(
params?):Promise<CursorPage<Claim>>
Defined in: sdks/trendyol/src/resources/claims.ts:158
List claims (page-based; SDK exposes opaque cursor convention).
Parameters
Section titled “Parameters”params?
Section titled “params?”ListClaimsParams = {}
Returns
Section titled “Returns”Promise<CursorPage<Claim>>
Example
Section titled “Example”import { paginate } from '@lonca/core';for await (const c of paginate((p) => client.claims.list({ ...p, claimItemStatus: 'WaitingInAction' }),)) { console.log(c.id, c.orderNumber, c.claimDate);}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.