### Example GET Request for Package Listing Source: https://developers.trendyol.com/docs/paket-listeleme-v2 This is an example of a GET request to the /v2/packages endpoint. It includes query parameters for filtering and pagination. ```http GET (ROOT_URL)/v2/1234/packages?trackingNumber=514805&status=pending&page=1&size=20&approvedStartDate=1712014519618&approvedEndDate=1712014519618&creationStartDate=1712014519618&creationEndDate=1712014519618&boutiqueId=1234 ``` -------------------------------- ### Package Items GET Request Example Source: https://developers.trendyol.com/docs/paket-detay%C4%B1-v2 This is an example of a GET request to retrieve package items. It includes parameters for filtering and pagination. Ensure you replace placeholder IDs with actual values. ```HTTP (ROOT_URL)/v2/1234/packages/items?packageId=123456&status=pending&page=1&size=20 ``` -------------------------------- ### Example Product Listing Request Source: https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-listeleme An example of a GET request to list products, including parameters for size, pageKey, and barcodes. The pageKey should be updated with the x-paging-key from the previous response for subsequent requests. ```HTTP (ROOT_URL)/v2/1234/products?size=20&pageKey=1680212960932,898605982&barcodes=8683116492789 ``` -------------------------------- ### Example Request URL Source: https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-stok-fiyat-i%CC%87%C5%9Flemleri-sonu%C3%A7-entegrasyonu-batch-id-sorgulama This is an example of a GET request URL for checking the status of a batch operation. It includes a placeholder seller ID and a sample batch ID. ```http GET - (ROOT_URL)/v1/1234/check-status?batchId=57a7229a-e345-4232-88ac-f4169b864293 ``` -------------------------------- ### Example Request URL Source: https://developers.trendyol.com/docs/materyal-bile%C5%9Fenleri This is an example of the request URL format for retrieving compositions, including a placeholder seller ID. ```HTTP (ROOT_URL)/v1/1234/lookup/compositions ``` -------------------------------- ### Example Origin List Request Source: https://developers.trendyol.com/docs/men%C5%9Fei An example of how to structure the request URL to fetch the origin list, including a placeholder seller ID. ```http (ROOT_URL)/v1/1234/lookup/origins ``` -------------------------------- ### Example JSON Response for Package Listing Source: https://developers.trendyol.com/docs/paket-listeleme-v2 This is an example of a successful JSON response from the /v2/packages endpoint. It contains pagination details and a list of package items. ```json { "totalItemCount": 2465, "totalPageCount": 2465, "size": 1, "page": 1, "items": [ { "trackingNumber": 518315, "packageId": "75243c90-55eb-45a3-a052-e227ca1465f9", "totalQuantity": 13, "totalBuyingPrice": 3802, "currency": "EUR", "status": "pending", "boutiqueId": "6783", "platformId": 150, "creationDate": 1678691613208, "approvedDate": 1678691614208, "lastModifiedDate": 1678691614208, "cargos": [ { "codes": [ "3ac32647-20aa-4a0b-97bc-f80de06c1692" ], "provider": "Trendyol Express" } ] } ] } ``` -------------------------------- ### Example API Response Source: https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages This is an example of a successful response when fetching shipment packages. ```json { "totalElements": 1, "totalPages": 1, "page": 0, "size": 1, "content": [ { "shipmentAddress": { "id": 11111111, "firstName": "Trendyol", "lastName": "Customer", ``` -------------------------------- ### Get Brands by Name API Response Example Source: https://developers.trendyol.com/docs/trendyol-marka-listesi-getbrands Example JSON response structure for the getBrandsName API, showing a matching brand. ```json [ { id: 40, name: "TRENDYOLMİLLA", }, ]; ``` -------------------------------- ### Example Service Request for updatePackage Source: https://developers.trendyol.com/docs/tedarik-edememe-bildirimi-updatepackage This is an example JSON payload for the updatePackage service request. It includes the lines to be updated and the reason ID for the unsupplied items. ```json { "lines": [ { "lineId": 0, "quantity": 0 } ], "reasonId":0 } ``` -------------------------------- ### Webhook Request Model Example Source: https://developers.trendyol.com/docs/webhook-model An example of the webhook request model payload, showing the structure for invoice status and rejection reasons. ```json { "invoiceStatus": "NotInvoiced", "invoiceRejectedReasonKeys": [ { "INVOICE_NUMBER_ALREADY_EXISTS", "NVOICE_TOTAL_MISMATCH" } ] } ``` -------------------------------- ### Get Shipment Packages (Staging) Source: https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages Fetches orders from the staging environment. Use this for testing purposes. ```bash curl -X GET https://stageapigw.trendyol.com/integration/order/sellers/{sellerId}/orders ``` -------------------------------- ### Get Brands API Response Example Source: https://developers.trendyol.com/docs/trendyol-marka-listesi-getbrands Example JSON response structure for the getBrands API, showing brand IDs and names. ```json { "brands": [ { "id": 10, "name": "TrendyolMilla" }, { "id": 19, "name": "Milla" }, { "id": 20, "name": "Trendyol" } ] } ``` -------------------------------- ### Example Service Response - Product Creation Source: https://developers.trendyol.com/docs/toplu-i%CC%87%C5%9Flem-kontrol%C3%BC-getbatchrequestresult This JSON shows a successful response for a product creation batch request. It includes the batch ID, item details, status, and failure reasons if any. ```JSON { "batchRequestId": "76e55c53-e0a4-473c-b4e1-1a008c02a9ab-1736179465", "items": [ { "requestItem": { "product": { "barcode": "11111122222", "title": "Test Product Title", "productMainId": "11111122222test", "brandId": 187803, "categoryId": 91266, "quantity": 50, "stockCode": "STK-test", "origin": "AD", "dimensionalWeight": 2, "description": "Test Product Description", "currencyType": "TRY", "listPrice": 6, "salePrice": 6, "vatRate": 20, "images": [ { "url": "https://cdn.ae1stcry.com/brainbees/images/products/zoom/3453114a.jpg" } ], "attributes": [ { "attributeId": 293, "attributeValueId": 2904, "customAttributeValue": null }, { "attributeId": 47, "attributeValueId": null, "customAttributeValue": "White" }, { "attributeId": 17620, "attributeValueId": null, "customAttributeValue": "Metal" }, { "attributeId": 294, "attributeValueId": 2878, "customAttributeValue": null }, { "attributeId": 296, "attributeValueId": 2873, "customAttributeValue": null }, { "attributeId": 295, "attributeValueId": 2893, "customAttributeValue": null } ], "cargoCompanyId": 10, "shipmentAddressId": null, "returningAddressId": null }, "barcode": "11111122222" }, "status": "SUCCESS", "failureReasons": [] } ], "status": "COMPLETED", "creationDate": 1736154265337, "lastModification": 1736154266924, "sourceType": "API", "itemCount": 1, "failedItemCount": 0, "batchRequestType": "ProductV2OnBoarding" } ``` -------------------------------- ### Get Claims Issue Reasons API Response Example Source: https://developers.trendyol.com/docs/i%CC%87ade-red-sebeplerini-%C3%A7ekme-getclaimsissuereasons This is an example of the JSON response structure returned by the `getClaimsIssueReasons` API. It lists available issue reasons with their IDs and names. ```json [ { "id": 1, "name": "İade gelen ürün sahte" }, ... .. . ] ``` -------------------------------- ### Get Supplier Addresses Example Response Source: https://developers.trendyol.com/docs/i%CC%87ade-ve-sevkiyat-adres-bilgileri-getsuppliersaddresses This JSON structure represents a typical response from the getSuppliersAddresses service, detailing various supplier addresses including shipment, invoice, and returning types. ```json { "supplierAddresses": [ { "id": 1, "addressType": "Shipment", "country": "Country-0", "city": "Kocaeli", "cityCode": 0, "district": "Gebze", "districtId": 0, "postCode": "post-code-0", "address": "Address-0", "isReturningAddress": false, "fullAddress": "Address-0 Gebze post-code-0 Kocaeli Country-0", "isShipmentAddress": true, "isInvoiceAddress": false, "isDefault": true }, { "id": 2, "addressType": "Invoice", "country": "Country-2", "city": "Ankara", "cityCode": 0, "district": "Mamak", "districtId": 0, "postCode": "post-code-2", "address": "Address-2", "isReturningAddress": false, "fullAddress": "Address-2 Mamak post-code-2 Ankara Country-2", "isShipmentAddress": false, "isInvoiceAddress": true, "isDefault": true }, { "id": 3, "addressType": "Returning", "country": "Country-3", "city": "Bursa", "cityCode": 0, "district": "Teleferik", "districtId": 0, "postCode": "post-code-3", "address": "Address-3", "isReturningAddress": true, "fullAddress": "Address-3 Teleferik post-code-3 Bursa Country-3", "isShipmentAddress": false, "isInvoiceAddress": false, "isDefault": true }, { "id": 4, "addressType": "Returning", "country": "Country-4", "city": "İzmir", "cityCode": 0, "district": "Bornova", "districtId": 0, "postCode": "post-code-4", "address": "Address-4", "isReturningAddress": true, "fullAddress": "Address-4 Bornova post-code-4 İzmir Country-4", "isShipmentAddress": false, "isInvoiceAddress": false, "isDefault": false } ], "defaultShipmentAddress": { "id": 0, "addressType": "Shipment", "country": "Country-0", "city": "Kocaeli", "cityCode": 0, "district": "Gebze", "districtId": 0, "postCode": "post-code-0", "address": "Address-0", "isReturningAddress": false, "fullAddress": "Address-0 Gebze post-code-0 Kocaeli Country-0", "isShipmentAddress": true, "isInvoiceAddress": false, "isDefault": true }, "defaultInvoiceAddress": { "id": 2, "addressType": "Invoice", "country": "Country-2", "city": "Ankara", "cityCode": 0, "district": "Mamak", "districtId": 0, "postCode": "post-code-2", "address": "Address-2", "isReturningAddress": false, "fullAddress": "Address-2 Mamak post-code-2 Ankara Country-2", "isShipmentAddress": false, "isInvoiceAddress": true, "isDefault": true }, "defaultReturningAddress": { "present": true } } ``` -------------------------------- ### Get Category Tree - Filtered by Name Source: https://developers.trendyol.com/docs/trendyol-kategori-listesi-getcategorytree This example shows how to filter category results by name using the 'name' query parameter. The response will include all categories at any level that contain the specified keyword. ```http https://apigw.trendyol.com/integration/product/product-categories?name=saat ``` -------------------------------- ### Example Product Listing Response Source: https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-listeleme A sample JSON response for the product listing API. It includes details such as barcode, sellerBarcode, pricing, stock, origin, composition, description, currency, categoryId, and attributes. ```JSON [ { "barcode": "8681261723738", "sellerBarcode": "example-seller-barcode", "rrpPrice": 27.25, "buyingPrice": 5.12, "stock": 8, "origin": "TR", "composition": "%5 Elastan, %95 Pamuk", "description": "Dantelli V yaka Dikişli kısa kol", "currency": "EUR", "gtip": "610831000000", "categoryId": 1000, "careInstructions": "T44", "attributes": [ { "attributeId": 200, "attributeName": "Renk", "valueId": null, "valueName": "Yeşil" }, { "attributeId": 300, "attributeName": "Cinsiyet", "valueId": 101, "valueName": "Erkek" }, { "attributeId": 400, "attributeName": "Materyal Bileşeni", "valueId": null, "valueName": "%5 Elastan, %95 Pamuk" } ] }, { "barcode": "8681261710478", "sellerBarcode": "example-seller-barcode-2", "rrpPrice": 19, "buyingPrice": 4.21, "stock": 15, "origin": "TR", "composition": "%100 Pamuk", "description": "İnce yaka işlemeli kısa kollu gömlek", "currency": "EUR", "gtip": "621210900000", "categoryId": 1001, "careInstructions": "T104", "attributes": [ { "attributeId": 200, "attributeName": "Renk", "valueId": null, "valueName": "Yeşil" }, { "attributeId": 300, "attributeName": "Cinsiyet", "valueId": 101, "valueName": "Erkek" }, { "attributeId": 400, "attributeName": "Materyal Bileşeni", "valueId": null, "valueName": "%100 Pamuk" } ] } ] ``` -------------------------------- ### Create Claim Response Example Source: https://developers.trendyol.com/docs/i%CC%87ade-talebi-olu%C5%9Fturma-createclaim Bu JSON yapısı, iade talebi başarıyla oluşturulduğunda alınacak örnek yanıtı gösterir. Yanıt, oluşturulan iade talebinin ID'sini ve ilgili diğer bilgileri içerir. ```json { "claimId": "string", "cargoTrackingNumber": 733xxxxxxx, "claimItemIds": [ "string" ] } ``` -------------------------------- ### Get Shipment Packages Response Example Source: https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages This JSON object represents the detailed response from the getShipmentPackages API endpoint. It includes information about order items, pricing, discounts, product details, shipment status, delivery information, and specific flags for micro-export and 4P orders. ```json { "lineSellerDiscount": 0.00, "lineTyDiscount": 0.00, "discountDetails": [ { "lineItemPrice": 498.90, "lineItemSellerDiscount": 0.00, "lineItemTyDiscount": 0.00 } ], "currencyCode": "TRY", "productColor": "Yeşil", "lineId": 4765111111, "vatRate": 20.00, "barcode": "8683772071724", "orderLineItemStatusName": "Delivered", "lineUnitPrice": 498.90, "fastDeliveryOptions": [], "productCategoryId": 2710, "commission": 13, "businessUnit": "Sports Shoes", "cancelledBy": "", "cancelReason": "", "cancelReasonCode": 0 } ], "orderDate": 1762253333685, "identityNumber": "11111111111", "currencyCode": "TRY", "packageHistories": [ { "createdDate": 1762242537624, "status": "Created" } ], "shipmentPackageStatus": "Delivered", "status": "Delivered", "whoPays": 1, "deliveryType": "normal", "timeSlotId": 0, "estimatedDeliveryStartDate": 1762858136000, "estimatedDeliveryEndDate": 1763030936000, "packageTotalPrice": 498.90, "deliveryAddressType": "Shipment", "agreedDeliveryDate": 1762376340000, "fastDelivery": false, "originShipmentDate": 1762242537619, "lastModifiedDate": 1762865408581, "commercial": false, "fastDeliveryType": "", "deliveredByService": false, "warehouseId": 372389, "invoiceLink": "https://efatura01.evidea.com/11111111111", "micro": true, "giftBoxRequested": false, "3pByTrendyol": false, "etgbNo": "25341453EX025864", "etgbDate": 1762646400000, "containsDangerousProduct": false, "cargoDeci": 10, "isCod": false, "createdBy": "order-creation", "originPackageIds": null, "hsCode": "711111000000", "shipmentNumber": 606404425, "is4P": true } ``` -------------------------------- ### Create Claim Request Example Source: https://developers.trendyol.com/docs/i%CC%87ade-talebi-olu%C5%9Fturma-createclaim Bu JSON yapısı, iade talebi oluşturmak için gönderilmesi gereken örnek isteği gösterir. Gerekli alanlar arasında sipariş numarası, müşteri ID'si ve iade edilecek ürünlerin detayları bulunur. ```json { "claimItems": [ { "barcode": "string", "customerNote": "string", "quantity": 0, "reasonId": 401 } ], "customerId": 0, "excludeListing": true, "forcePackageCreation": true, "orderNumber": "string", "shipmentCompanyId": 4 } ``` -------------------------------- ### PUT activate Source: https://developers.trendyol.com/docs/webhook-aktifpasif-alma Bu servis, pasif durumunda olan webhook methodlarını aktif duruma getirir. Entegrasyon servislerine gönderilecek istekler, temel kimlik doğrulama yöntemi olan "basic authentication" ile yetkilendirilmelidir. ```APIDOC ## PUT activate ### Description Bu servis, pasif durumunda olan webhook methodlarını aktif duruma getirir. ### Method PUT ### Endpoint https://apigw.trendyol.com/integration/webhook/sellers/\{sellerId}/webhooks/\{Id}/activate (PROD) https://stageapigw.trendyol.com/integration/webhook/sellers/\{sellerId}/webhooks/\{Id}/activate (STAGE) ### Parameters #### Path Parameters - **sellerId** (string) - Required - Satıcı ID'si. - **Id** (string) - Required - Webhook ID'si. ### Response #### Success Response (200) OK ``` -------------------------------- ### Create Webhook Response Example Source: https://developers.trendyol.com/docs/webhook-yaratma This is an example of a successful response when creating a webhook. The 'id' field is the unique identifier for the created webhook. ```json { "id": "string" } ``` -------------------------------- ### POST /v1/{sellerId}/products (Ürün Oluşturma V2) Source: https://developers.trendyol.com/docs/api-endpointleri Creates a new product for a seller. This is the updated version of the product creation endpoint. ```APIDOC ## POST /v1/{sellerId}/products ### Description Creates a new product for a seller. This is the updated version of the product creation endpoint. ### Method POST ### Endpoint `{{ROOT_URL}}/v1/{sellerId}/products` ### Parameters #### Path Parameters - **sellerId** (string) - Required - The unique identifier for the seller. ``` -------------------------------- ### Product Buybox Control Service Response Example Source: https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-buybox-kontrol-servisi This JSON response shows the structure of the data returned by the Product Buybox Control Service. It includes buybox order, price, and seller multiplicity for each queried barcode. ```json { "buyboxInfo": [ { "barcode": "1111111111111", "buyboxOrder": 1, "buyboxPrice": 600, "hasMultipleSeller": false, "secondBuyboxPrice": 2999, "thirdBuyboxPrice": 3199 }, { "barcode": "2222222222", "buyboxOrder": 3, "buyboxPrice": 299.9, "hasMultipleSeller": true, "secondBuyboxPrice": 400, "thirdBuyboxPrice": 500 }, { "barcode": "3333333333", "buyboxOrder": 47, "buyboxPrice": 340, "hasMultipleSeller": true, "secondBuyboxPrice": 700, "thirdBuyboxPrice": 800 } ] } ``` -------------------------------- ### Product Buybox Control Service Request Example Source: https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-buybox-kontrol-servisi This JSON payload demonstrates how to structure a request to the Product Buybox Control Service, including a list of up to 10 barcodes for which to retrieve buybox information. ```json { "barcodes": [ "1111111111111", "2222222222", "3333333333" ] } ``` -------------------------------- ### PUT processAlternativeDelivery (Kargo Linki ile Gönderim) Source: https://developers.trendyol.com/docs/alternatif-teslimat-i%CC%87le-g%C3%B6nderim Sipariş paketini gönderdikten sonra elinizde olan kargo takip linki ile besleme yapabilirsiniz. Bu isteği başarılı bir şekilde ilettikten sonra sipariş otomatik olarak "Shipped" statüsüne geçecektir. ```json { "isPhoneNumber": false, "trackingInfo": "http://tex....", "params": {} } ``` -------------------------------- ### Create Common Label Request Example Source: https://developers.trendyol.com/docs/ortak-etiket-barkod-talebi-createcommonlabel This is an example of the JSON payload to request a common label barcode. Ensure the 'format' field is set to 'ZPL'. ```json { "format": "ZPL", //required "boxQuantity": 5, "volumetricHeight": 3.5 } ``` -------------------------------- ### POST createClaimIssue Endpoint (STAGE) Source: https://developers.trendyol.com/docs/i%CC%87ade-sipari%C5%9Flerinde-ret-talebi-olu%C5%9Fturma-createclaimissue Bu endpoint, Trendyol'un test (STAGE) ortamında iade siparişleri için ret talebi oluşturmak amacıyla kullanılır. Seller ID, Claim ID, Claim Issue Reason ID ve Claim Item ID listesi gibi parametreler gereklidir. Dosya yüklemeleri için 'form-data (file)' formatı kullanılmalıdır. ```HTTP POST https://stageapigw.trendyol.com/integration/order/sellers/{sellerId}/claims/{claimId}/issue?claimIssueReasonId={claimIssueReasonId}&claimItemIdList={claimItemIdList}&description={test} ``` -------------------------------- ### Example JSON Response for Filtered Products Source: https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-filtreleme-onays%C4%B1z-%C3%BCr%C3%BCn-v2 This is an example of the JSON response structure when filtering products. It includes pagination details and a list of product content. ```json { "totalElements": 1, "totalPages": 1, "page": 0, "size": 1, "nextPageToken": "eyJzb3J0IjpbMTI3MTU4MTVdfQ==", "content": [ { "supplierId": 2748, "productMainId": "smoketest-114333a11", "status": "rejected"/"pendingApproval", "createDateTime": 1763964757705, "lastUpdateDate": 1764059908901, "lastPriceChangeDate": 1763964757656, "lastStockChangeDate": 1763964757656, "brand": { "id": 317259, "name": "Trendyol Üyelik" }, "category": { "id": 129332, "name": "Üyelik Servisi" }, "barcode": "smoketest-114333a11", "title": "Test Product", "description": "Test Product Description", "quantity": 1, "listPrice": 25000, "salePrice": 20000, "vatRate": 20, "dimensionalWeight": null, "stockCode": "TEST-STOCK", "origin": "AD", "media": [ { "url": "https://marketplace-supplier-media-center.oss-eu-central-1.aliyuncs.com/prod/431929/3bda8d78-00e8-4bbf-abb7-f7a13297d2f3/A_TABLO1148.jpg?x-oss-process=style/resized" } ], "attributes": [ { "attributeId": 293, "attributeName": "Beden", "attributeValueId": 410928, "attributeValue": "tttt" }, { ``` -------------------------------- ### Get Cities for Turkey Source: https://developers.trendyol.com/docs/adres-bilgileri Retrieve a list of cities specifically for Turkey. ```APIDOC ## GET /integration/member/countries/domestic/TR/cities ### Description Retrieve a list of cities for Turkey. ### Method GET ### Endpoint https://apigw.trendyol.com/integration/member/countries/domestic/TR/cities ``` -------------------------------- ### Package Items Response Example Source: https://developers.trendyol.com/docs/paket-detay%C4%B1-v2 This JSON object represents the response for a package items request. It includes pagination details and a list of package items with their respective quantities and pricing. ```JSON { "totalItemCount": 2, "totalPageCount": 1, "size": 20, "page": 1, "items": [ { "itemId": "75243c90-55eb-45a3-a052-e227ca1465f9-816701986", "name": "product-name-01", "trackingNumber": null, "sellerBarcode": "seller-barcode-01", "barcode": "barcode-01", "newQuantity": 10, "pendingQuantity": 20, "completedQuantity": 5, "unSuppliedQuantity": 5, "cancelledQuantity": 10, "unitBuyingPrice": 10.0, "creationDate": 1678691613222, "lastModifiedDate": 1678691613210 }, { "itemId": "75243c90-55eb-45a3-a052-e227ca1465f9-728609554", "name": "product-name-02", "trackingNumber": 3687712, "sellerBarcode": "seller-barcode-02", "barcode": "barcode-02", "newQuantity": 15, "pendingQuantity": 10, "completedQuantity": 7, "unSuppliedQuantity": 6, "cancelledQuantity": 3, "unitBuyingPrice": 15.0, "creationDate": 1678691633736, "lastModifiedDate": 1678691613210 } ] } ```