### Get Claims - Example Response (Product Resend) Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/urun-entegrasyonu/trendyol-yemek-entegrasyonu/iade-entegrasyonu/ymk-iade-siparisleri-cekme This JSON object demonstrates an example response from the 'getClaims' API when a product resend is the resolution for a claim. It details the order, claim items, and specifies 'PRODUCT_RESEND' as the 'sellerRefundType'. ```json { "totalElements": 1, "totalPages": 1, "page": 0, "size": 50, "content": [ { "id": "d72d4855-6f74-4929-b622-6210db9ec5b0", "orderNumber": "1417897210", "orderId": 1001417897210, "storeId": 5, "packageId": "d603eacda3d85e019b4f8f257acf4f4e501df40adc7b5a2e9b6a58488238a731", "claimItems": [ { "id": "1a418fd3-33ba-45ff-bf8d-a271d252aebe", "lineItemId": 1000004185655, "status": "WaitingForSellerRefund", "customerClaimItemReason": { "id": 4000, "name": "SKT - Geçmiş Ürün Teslimatı", "code": "OTHER" }, "completionClaimItemReason": null, "completionDate": null, "price": 9.99 }, { "id": "05c63a4d-018b-4812-974d-8f1a94a2ee5e", "lineItemId": 1000004185656, "status": "WaitingForSellerRefund", "customerClaimItemReason": { "id": 4000, "name": "SKT - Geçmiş Ürün Teslimatı", "code": "OTHER" }, "completionClaimItemReason": null, "completionDate": null, "price": 29.99 } ], "createdDate": 1713346126133, "type": "Standard", "totalPrice": 39.98, "sellerRefundType": "PRODUCT_RESEND" } ] } ``` -------------------------------- ### Example Response for Package Information Source: https://developers.tgoapps.com/docs/trendyol-go-yemek-entegrasyonu/siparis-entegrasyonu/ymk-siparis-paketlerini This is an example JSON response for the GET package information API endpoint. It includes pagination details, total counts, and a list of package contents, each with detailed information like IDs, pricing, customer data, and address. ```JSON { "page": 0, "size": 50, "totalPages": 1, "totalCount": 1, "content": [ { "id": "1000000023261", "supplierId": 107385, "storeId": 330, "orderCode": "007", "storePickupSelected": false, "orderId": "1000000017209", "orderNumber": "1221047877", "packageCreationDate": 1631014650126, "packageModificationDate": 1631015071040, "preparationTime": 0, "totalPrice": 40.99, "callCenterPhone": "0212 365 34 03", "deliveryType": "STORE", "customer": { "id": 25039720, "firstName": "Ali", "lastName": "Y" }, "address": { "firstName": "Ali", "lastName": "Y", "company": "", "address1": "Cumhuriyet Mahallesi Selimiye Caddesi", "address2": "On Kasım Sokak", "city": "İstanbul", "cityCode": 34, "cityId": 133, "district": "Adalar", "districtId": 33, "neighborhoodId": 21734, "neighborhood": "Burgazada Mah", "apartmentNumber": "9", "floor": "2", "doorNumber": "2", "addressDescription": "2", "postalCode": "34000", "countryCode": "TR", "latitude": "41.00432", "longitude": "29.091809", "phone": "0212 365 34 03" }, "packageStatus": "Created", "lines": [ { "price": 34.99, "unitSellingPrice": 40.99, "productId": 161162, "name": "İkili Hamburger Menü", "items": [ { "packageItemId": "1000000021680", "lineItemId": 1000000069963, "isCancelled": false, "promotions": [ { "promotionId": 1949565, "description": "X TL Indirim", "discountType": "INSTANT_DISCOUNT", "sellerCoverageRatio": 0.0, "amount": { "seller": 0.0 } } ], "coupon":{ "couponId": "f61369c8-55fa-4d42-ad20-2c71e6b3646d", "description": "X İndirim", "sellerCoverageRatio": 0.0, "amount": { "seller": 0.0 } } } ], "modifierProducts": [ ``` -------------------------------- ### Get Meal Claims - Product Resend Example (JSON) Source: https://developers.tgoapps.com/docs/trendyol-go-yemek-entegrasyonu/iade-entegrasyonu/ymk-iade-siparisleri-cekme This JSON example demonstrates the response structure for a meal claim where a product resend is applicable. It details the claim and its associated items, with statuses indicating a pending seller action. ```json { "totalElements": 1, "totalPages": 1, "page": 0, "size": 50, "content": [ { "id": "d72d4855-6f74-4929-b622-6210db9ec5b0", "orderNumber": "1417897210", "orderId": 1001417897210, "storeId": 5, "packageId": "d603eacda3d85e019b4f8f257acf4f4e501df40adc7b5a2e9b6a58488238a731", "claimItems": [ { "id": "1a418fd3-33ba-45ff-bf8d-a271d252aebe", "lineItemId": 1000004185655, "status": "WaitingForSellerRefund", "note": "Customer Note", "customerClaimItemReason": { "id": 4000, "name": "SKT - Geçmiş Ürün Teslimatı", "code": "OTHER" }, "completionClaimItemReason": null, "completionDate": null, "price": 9.99 }, { "id": "05c63a4d-018b-4812-974d-8f1a94a2ee5e", "lineItemId": 1000004185656, "status": "WaitingForSellerRefund", "customerClaimItemReason": { "id": 4000, "name": "SKT - Geçmiş Ürün Teslimatı", "code": "OTHER" }, "completionClaimItemReason": null, "completionDate": null, "price": 29.99, "imageUrls": ["https://xxxxxx.jpeg"] } ], "createdDate": 1713346126133, "type": "Standard", "totalPrice": 39.98, "sellerRefundType": "PRODUCT_RESEND" } ] } ``` -------------------------------- ### Order Structure Example Source: https://developers.tgoapps.com/docs/deprecated-trendyol-yemek-entegrasyonu/siparis-entegrasyonu/ymk-siparis-paketlerini Provides an example of the JSON structure for an order, including product details, payment information, and courier status. ```APIDOC ## Order Structure Example ### Description An example of a JSON payload representing an order, detailing items, pricing, modifiers, and payment preferences. ### Method N/A (Data Structure Example) ### Endpoint N/A (Data Structure Example) ### Request Body Example ```json { "products": [ { "name": "Tavuk Burger", "price": 0.0, "productId": 160933, "modifierGroupId": 19899, "modifierProducts": [ { "name": "60 gr.", "price": 0.0, "productId": 789, "modifierGroupId": 212, "modifierProducts": [], "extraIngredients": [], "removedIngredients": [] } ], "extraIngredients": [ { "id": 25728, "name": "Tursu", "price": 0.0 } ], "removedIngredients": [ { "id": 25721, "name": "Göbek Salata" } ] }, { "name": "Patates Kızartması (Büyük Boy)", "price": 0.0, "productId": 160946, "modifierGroupId": 19852, "modifierProducts": [ { "name": "Acı Sos", "price": 0.0, "productId": 160973, "modifierGroupId": 19949, "modifierProducts": [], "extraIngredients": [], "removedIngredients": [] } ], "extraIngredients": [], "removedIngredients": [] } ], "payment": { "paymentType": "PAY_WITH_MEAL_CARD", "mealCard": { "cardSourceType": "MEAL_CARD_NAME-ONLINE" // cardSourceType alanı "PLUXEE - ONLINE" , "MULTINET - ONLINE" , "EDENRED - ONLINE" şeklinde değer alabilir }, "customerNote": "", "lastModifiedDate": 1631015072000, "isCourierNearby": true, // Model 2 siparişler için kurye atanınca isCourierNearby alanı true değer alır. "cancelInfo": { "reasonCode": 625 }, "eta": "32 - 47 dk", "testPackage": false, "pickupEtaState": "SUCCESS", // SUCCESS, FAILED ve null("") değerlerini alabilir. "estimatedPickupTimeMin": 1688472305599, "estimatedPickupTimeMax": 1688472905599 } } ``` ``` -------------------------------- ### Get Meal Claims - Monetary Refund Example (JSON) Source: https://developers.tgoapps.com/docs/trendyol-go-yemek-entegrasyonu/iade-entegrasyonu/ymk-iade-siparisleri-cekme This JSON example demonstrates the response structure for a successful monetary refund of meal claims. It includes details about the claim, items, pricing, and refund type. ```json { "totalElements": 1, "totalPages": 1, "page": 0, "size": 50, "content": [ { "id": "fb7d6b47-34f9-414c-bf98-875025909410", "orderNumber": "9853564888", "orderId": 1009853564888, "storeId": 131, "packageId": "30ae28f9abfb5b21af2859245d6862cac2c28302a2ce67090c2ccf4104d0da43", "claimItems": [ { "id": "864e33e1-a732-4bfc-b652-e00b3d3f2967", "lineItemId": 1000004455324, "status": "Accepted", "note": "Customer Note", "customerClaimItemReason": { "id": 4000, "name": "SKT - Geçmiş Ürün Teslimatı", "code": "OTHER" }, "completionClaimItemReason": { "id": 5026, "reasonText": "Satıcı para iade/ürün telafisi yaptı", "descriptionAvailable": false, "isSellerPaid": true }, "completionDate": 1726496835702, "price": 43.6, "imageUrls": ["https://xxxxxx.jpeg"] } ], "createdDate": 1724671900437, "type": "Standard", "totalPrice": 43.6, "sellerRefundType": "PAY_BACK" } ] } ``` -------------------------------- ### Example Service Response Source: https://developers.tgoapps.com/docs/category/4-muhasebe-ve-finans-entegrasyonu This is an example of a service response, demonstrating the structure and content of transaction data, specifically with 'transactionType' set to 'Sale'. ```APIDOC ## GET /transactions ### Description Retrieves a list of transactions based on specified criteria. ### Method GET ### Endpoint `/websites/developers_tgoapps/transactions` ### Query Parameters * **transactionType** (string) - Optional - Filters transactions by type (e.g., 'Sale', 'Return'). * **page** (integer) - Optional - The page number for pagination. * **size** (integer) - Optional - The number of items per page. ### Response #### Success Response (200) - **page** (integer) - The current page number. - **size** (integer) - The number of items per page. - **totalPages** (integer) - The total number of pages. - **totalElements** (integer) - The total number of elements. - **content** (array) - An array of transaction objects. - **id** (string) - The unique identifier for the transaction. - **transactionDate** (long) - The timestamp of the transaction. - **barcode** (string) - The barcode of the product. - **transactionType** (string) - The type of transaction. - **receiptId** (integer) - The receipt ID. - **description** (string) - A description of the transaction. - **debt** (float) - The debt amount. - **credit** (float) - The credit amount. - **paymentPeriod** (integer) - The payment period. - **commissionRate** (float) - The commission rate for the product in the order. - **commissionAmount** (float) - The commission amount charged by Trendyol Go by Uber Eats. - **commissionInvoiceSerialNumber** (null) - The serial number of the commission invoice. - **sellerRevenue** (float) - The seller's revenue amount. - **orderNumber** (string) - The order number. - **paymentOrderId** (integer) - The payment order ID. - **paymentDate** (long) - The timestamp of the payment. - **sellerId** (integer) - The seller's ID. - **storeId** (null) - The store ID. - **storeName** (null) - The store name. - **storeAddress** (null) - The store address. - **country** (string) - The country. - **orderDate** (long) - The timestamp of the order. #### Response Example ```json { "page": 0, "size": 500, "totalPages": 878, "totalElements": 438974, "content": [ { "id": "725041340", "transactionDate": 1613397671561, "barcode": "8681385952874", "transactionType": "Satış", "receiptId": 48376618, "description": "Satış", "debt": 0.0, "credit": 449.99, "paymentPeriod": 30, "commissionRate": 15.0, "commissionAmount": 67.4985, "commissionInvoiceSerialNumber": null, "sellerRevenue": 382.4915, "orderNumber": "501915861", "paymentOrderId": 112360, "paymentDate": 1615989671561, "sellerId": 123456, "storeId": null, "storeName": null, "storeAddress": null, "country": "Türkiye", "orderDate": 1720107451532 }, { "id": "725041335", "transactionDate": 1613397671557, "barcode": "8681387147421", "transactionType": "Satış", "receiptId": 48376618, "description": "Satış", "debt": 0.0, "credit": 699.99, "paymentPeriod": 28, "commissionRate": 15.0, "commissionAmount": 104.9985, "commissionInvoiceSerialNumber": null, "sellerRevenue": 594.9915, "orderNumber": "501915861", "paymentOrderId": 112360, "paymentDate": 1615989671557, "sellerId": 123456, "storeId": null, "storeName": null, "storeAddress": null, "country": "Türkiye", "orderDate": 1720107451532 } ] } ``` ``` -------------------------------- ### Example API Response for Package Details Source: https://developers.tgoapps.com/docs/deprecated-trendyol-yemek-entegrasyonu/siparis-entegrasyonu/ymk-siparis-paketlerini This JSON object represents a sample response from the 'GET packageId' API endpoint. It illustrates the structure and content of the data returned, including pagination details, order information, customer and address specifics, and details about individual line items with potential promotions and coupons. ```JSON { "page": 0, "size": 50, "totalPages": 1, "totalCount": 1, "content": [ { "id": "1000000023261", "supplierId": 107385, "storeId": 330, "orderCode": "007", "storePickupSelected": false, "orderId": "1000000017209", "orderNumber": "1221047877", "packageCreationDate": 1631014650126, "packageModificationDate": 1631015071040, "preparationTime": 0, "totalPrice": 40.99, "callCenterPhone": "0850 241 9090", "deliveryType": "STORE", "customer": { "id": 25039720, "firstName": "Ali", "lastName": "Y" }, "address": { "firstName": "Ali", "lastName": "Y", "company": "", "address1": "Cumhuriyet Mahallesi Selimiye Caddesi", "address2": "On Kasım Sokak", "city": "İstanbul", "cityCode": 34, "cityId": 133, "district": "Adalar", "districtId": 33, "neighborhoodId": 21734, "neighborhood": "Burgazada Mah", "apartmentNumber": "9", "floor": "2", "doorNumber": "2", "addressDescription": "2", "postalCode": "34000", "countryCode": "TR", "latitude": "41.00432", "longitude": "29.091809", "phone": "0850 241 9090" }, "packageStatus": "Created", "lines": [ { "price": 34.99, "unitSellingPrice": 40.99, "productId": 161162, "name": "İkili Hamburger Menü", "items": [ { "packageItemId": "1000000021680", "lineItemId": 1000000069963, "isCancelled": false, "promotions": [ { "promotionId": 1949565, "description": "X TL Indirim", "discountType": "INSTANT_DISCOUNT", "sellerCoverageRatio": 0.0, "amount": { "seller": 0.0 } } ], "coupon":{ "couponId": "f61369c8-55fa-4d42-ad20-2c71e6b3646d", "description": "X İndirim", "sellerCoverageRatio": 0.0, "amount": { "seller": 0.0 } } } ], "modifierProducts": [ { ``` -------------------------------- ### Get Claims - Example Response (Monetary Refund) Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/urun-entegrasyonu/trendyol-yemek-entegrasyonu/iade-entegrasyonu/ymk-iade-siparisleri-cekme This JSON object represents an example response from the 'getClaims' API when a monetary refund is processed. It includes details about the claim, associated order, and item information, with a 'sellerRefundType' of 'PAY_BACK'. ```json { "totalElements": 1, "totalPages": 1, "page": 0, "size": 50, "content": [ { "id": "fb7d6b47-34f9-414c-bf98-875025909410", "orderNumber": "9853564888", "orderId": 1009853564888, "storeId": 131, "packageId": "30ae28f9abfb5b21af2859245d6862cac2c28302a2ce67090c2ccf4104d0da43", "claimItems": [ { "id": "864e33e1-a732-4bfc-b652-e00b3d3f2967", "lineItemId": 1000004455324, "status": "Accepted", "customerClaimItemReason": { "id": 4000, "name": "SKT - Geçmiş Ürün Teslimatı", "code": "OTHER" }, "completionClaimItemReason": { "id": 5026, "reasonText": "Satıcı para iade/ürün telafisi yaptı", "descriptionAvailable": false, "isSellerPaid": true }, "completionDate": 1726496731180, "price": 43.6 } ], "createdDate": 1724671900437, "type": "Standard", "totalPrice": 43.6, "sellerRefundType": "PAY_BACK" } ] } ``` -------------------------------- ### Order Data Structure Example (JSON) Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/urun-entegrasyonu/trendyol-yemek-entegrasyonu/siparis-entegrasyonu/ymk-siparis-paketlerini This snippet demonstrates the structure of order data, including supplier and store IDs, order details, customer information, delivery address, package status, and line items. It also shows examples of promotions and coupons applied to order items. The data format is JSON. ```json { "supplierId": 107385, "storeId": 330, "orderCode": "007", "orderId": "1000000017209", "orderNumber": "1221047877", "packageCreationDate": 1631014650126, "packageModificationDate": 1631015071040, "preparationTime": 0, "totalPrice": 40.99, "callCenterPhone": "0850 241 9090", "deliveryType": "GO", "customer": { "id": 25039720, "firstName": "Ali", "lastName": "Y" }, "address": { "firstName": "Ali", "lastName": "Y", "company": "Trendyol Yemek", "address1": "Trendyol Yemek", "address2": "Trendyol Yemek", "city": "Trendyol Yemek", "cityCode": 34, "cityId": 133, "district": "Trendyol Yemek", "districtId": 56, "neighborhoodId": 29560, "neighborhood": "Trendyol Yemek", "apartmentNumber": "Trendyol Yemek", "floor": "Trendyol Yemek", "doorNumber": "Trendyol Yemek", "addressDescription": "Trendyol Yemek", "postalCode": "Trendyol Yemek", "countryCode": "Trendyol Yemek", "latitude": "Trendyol Yemek", "longitude": "Trendyol Yemek", "phone": "0850 241 9090" }, "packageStatus": "Created", "lines": [ { "price": 34.99, "unitSellingPrice": 40.99, "productId": 161162, "name": "İkili Hamburger Menü", "items": [ { "packageItemId": "1000000021680", "lineItemId": 1000000069963, "isCancelled": false, "promotions": [ { "promotionId": 1949565, "description": "X TL Indirim", "discountType": "INSTANT_DISCOUNT", "sellerCoverageRatio": 0.0, "amount": { "seller": 0.0 } } ], "coupon": { "couponId": "f61369c8-55fa-4d42-ad20-2c71e6b3646d", "description": "X İndirim", "sellerCoverageRatio": 0.0, "amount": { "seller": 0.0 } } } ], "modifierProducts": [ { "name": "Et Burger", "price": 0.0, "productId": 161167, "modifierGroupId": 19900, "modifierProducts": [ { "name": "3 Ekstra Peynir", "price": 6.0, "productId": 161463, "modifierGroupId": 19926, "modifierProducts": [], "extraIngredients": [], "removedIngredients": [] } ], "extraIngredients": [ { "id": 25720, "name": "Domates", "price": 0.0 } ], "removedIngredients": [ { "id": 25730, "name": "Soğan" } ] } ] } ] } ``` -------------------------------- ### Example Response for Delivery Areas Source: https://developers.tgoapps.com/docs/trendyol-go-yemek-entegrasyonu/restoran-entegrasyonu/ymk-teslimat-bolgelerinin-alinmasi This is an example JSON response for the GET /delivery-areas endpoint. It details the branch ID, delivery radius, and a list of defined areas, each with an ID, name, and polygonal coordinates. ```json { "branchId": 285, "radius": 5000, "areas": [ { "id": 26157, "areaId": 1, "name": "Bölge 1", "coordinates": "MULTIPOLYGON (((29.05824452890285 40.96957191668142, 29.05863768169147 40.970216379185715, 29.058072812678212 40.970802230711975, 29.05711478452898 40.97074361686519, 29.056549899987395 40.97132946002922, 29.056943049942042 40.97197391990874, 29.056378156218976 40.972559757578715, 29.056771310533676 40.97320421135323, 29.056206407628867 40.973790043528616, 29.05659956630372 40.974434491197655, 29.05603465421686 40.97502031787792, 29.055076577108284 40.974961694020216, 29.054511649492376 40.97554751233592, 29.054904805331553 40.97619195737819, 29.054339868532967 40.976777770197685, 29.054733028732176 40.97742220913347, 29.054168082750607 40.97800801645624, 29.054561247309934 40.97865244928507, 29.05551936504753 40.9787110713122, 29.055912541163814 40.97935549455476, 29.05534759234596 40.979941299249084, 29.05574077282283 40.980585716383864, 29.05517581482153 40.98117151558035, 29.055568999659023 40.981815926606885, 29.055004032473988 40.982401720305, 29.055397221672223 40.98304612522283, 29.056355385252505 40.983104732963675, 29.05674858600862 40.98374912829354, 29.056183615987607 40.984334919361366, 29.05657682110491 40.9849793085817, 29.056011841899682 40.985565094150054, 29.056405051378242 40.986209477260374, 29.05736324725906 40.98626807132349, 29.05775646829605 40.98691244484457, 29.05719148625536 40.98749822778132, 29.05758471165406 40.98814259519157, 29.05854292629022 40.98820117618612, 29.058936163247544 40.98884553400619, 29.0598943830919 40.98890410254221, 29.060287631607668 40.989548450771586, 29.059722653083014 40.990134233943984, 29.060115905961304 40.99077857606131, 29.061074144560195 40.99083713152707, 29.061467408997103 40.99148146405279, 29.062425652802457 40.99154000705897, 29.062818928797796 40.99218432999255, 29.0637771778086 40.9922428605388, 29.064170465362203 40.99288717387969, 29.06512871957746 40.9929456919657, 29.06552201868915 40.99358999571335, 29.066480278107814 40.99364850133877, 29.0668735887774 40.99429279549266, 29.067831853398484 40.99435128865716, 29.068225175625784 40.99499557321672, 29.069183445448285 40.995054053919944, 29.069576779233113 40.99569832888467, 29.07053505425601 40.99575679712627, 29.070928399598188 40.99640106249562, 29.07188667982046 40.99645951827528, 29.072451601150707 40.995873709299865, 29.073409873021465 40.9959321532319, 29.07380323711164 40.99657640552464, 29.074761514179475 40.99663483699442, 29.0753264136071 40.99604901678651, 29.076284682320903 40.99610743640915, 29.076678065156962 40.99675167562418, 29.077636339065535 40.99681008278424, 29.078201216587843 40.99622425134514, 29.079159482139914 40.99628264665855, 29.07955288371972 40.99692687279476, 29.080511154464237 40.996985255645285, 29.081076010078533 40.996399412976295, 29.082034272464018 40.996457783980674, 29.08259911253214 40.99587193294774, 29.083557366557404 40.99593029210644, 29.083950794064716 40.99657450168053, 29.08490905327884 40.99663284837604, 29.085473871435106 40.99604698611544, 29.086432122286485 40.99610532096577, 29.086996924895075 40.99551945034284, 29.087955167382514 40.995577773348465, 29.088519954443054 40.99499189436395, 29.08947818856531 40.995050205525324, 29.090042960077426 40.99446431817994, 29.09100118583332 40.99452261749753, 29.09156594179662 40.993936721792004, 29.092524159184933 40.99399500926628, 29.09308889959904 40.993409105201316, 29.09269542899409 40.99276491652558, 29.0932601602284 40.99217900696522, 29.094218355698104 40.99223728321731, 29.094783071383223 40.99165136529877, 29.095741258483013 40.99170962970891, 29.09630595861853 40.99112370343292, 29.095912478024943 40.99047951560993, 29.096477168981686 40.98989358384014, 29.09743533416108 40.98995183703042, 29.098000009568224 40.989365896904424, 29.098958166375372 40.98942413825416, 29.099522826232537 40.98883818977267, 29.09912933565466 40.98819400280425, 29.09969398633409 40.98760804883059, 29.099300500127182 40.98696385574787, 29.09986514162913 40.98637789628256, 29.10082326296568 40.986436127037386, 29.101387888918016 40.98585015921837, 29.100994399906426 40.98520596350713, 29.101559016681918 40.98461999019755, 29.101165532041435 40.98397578837302, 29.101730139640388 40.98338980957339, 29.10133665937092 40.98274560163604, 29.101901257793607 40.98215961734691, 29.101507781895076 40.98151540329721, 29.102072371141784 40.98092941351912, 29.101678899614107 40.980285193357524, 29.102243479685118 40.97969919809103, 29.1018500125282 40.979054971817995, 29.1024145834238 40.97846897106363, 29.10202112063756 40.97782473867962, 29.1025856823580" } ] } ``` -------------------------------- ### Example Service Responses Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/urun-entegrasyonu/trendyol-yemek-entegrasyonu/restoran-entegrasyonu/ymk-teslimat-bolgelerinin-alinmasi This table outlines the possible HTTP status codes for service requests, their meanings, and recommended actions. It covers successful requests, authentication errors, and server-side issues. ```markdown Status Code| Açıklama| ---|---| 200| Gönderilen istek başarılı olmuştur. Restorana ait kategorinin statüsü istekte gönderilen statüye geçecektir.| 401| İstek gönderirken kullandığınız supplierID, API Key, API Secure Key bilgilerinden birisi eksik ya da yanlıştır. Mağazanız için doğru bilgilere Trendyol Satıcı Paneli üzerinden ulaşabilirsiniz.| 5xx| Anlık bir hata yaşanmış olabilir.. Bir kaç dakika bekleyerek durumun düzelmemesi durumunda kullanılan endpoint, gönderilen istek ve cevap ile beraber "API Entegrasyon Destek Talebi" başlığından talep oluşturunuz.| ``` -------------------------------- ### Example Restaurant Products API Response Source: https://developers.tgoapps.com/docs/deprecated-trendyol-yemek-entegrasyonu/menu-entegrasyonu/ymk-menulerin-alinmasi This is an example JSON response for the GET getRestaurantProducts API. It details ingredients, modifier groups, products with their details (like price, description, ingredients), and sections within the restaurant's menu. The status indicates whether an item is 'ACTIVE'. ```json { "ingredients": [ { "id": 2, "name": "Soğan salatası", "price": 0, "status": "ACTIVE" } ], "modifierGroups": [ { "id": 4, "max": 2, "min": 0, "modifierProducts": [ { "id": 5, "position": 1, "price": 10 } ], "name": "Çorbalar" } ], "products": [ { "id": 1, "description": "Mevsim salata ile servis edilir.", "ingredients": [ 2 ], "extraIngredients": [ 3 ], "modifierGroups": [ { "id": 4, "position": 1 } ], "name": "Adana Kebap", "originalPrice": 30, "sellingPrice": 25, "status": "ACTIVE" }, { "id": 3, "description": "Biberiye Turşusu", "ingredients": [], "extraIngredients": [], "modifierGroups": [], "name": "Turşu", "originalPrice": 0, "sellingPrice": 0, "status": "ACTIVE" }, { "id": 4, "description": "Mercimek çorbası", "ingredients": [], "extraIngredients": [], "modifierGroups": [], "name": "Çorba", "originalPrice": 0, "sellingPrice": 5, "status": "ACTIVE" } ], "sections": [ { "id":4567, "name": "Kebaplar", "position": 1, "products": [ { "id": 1, "position": 1 } ], "status": "ACTIVE" } ] } ``` -------------------------------- ### Get Brands API Response Example Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/urun-entegrasyonu/hm-trendyol-marka-bilgileri Bu, getBrands servisi tarafından döndürülen örnek bir JSON yanıtıdır. Markaların bir listesini içerir, her marka için 'id' ve 'name' alanları bulunur. ```json { "brands": [ { "id": 10, "name": "TrendyolMilla" }, { "id": 19, "name": "Milla" }, { "id": 20, "name": "Trendyol" } ] } ``` -------------------------------- ### Return Reasons Source: https://developers.tgoapps.com/docs/trendyol-go-hizli-market-entegrasyonu/iade-entegrasyonu/hm-iade-onaylama-reddetme Provides a list of available reason codes and their descriptions for claim rejections. ```APIDOC ## Return Reasons ### Description This section lists the available reason codes and their corresponding descriptions for rejecting return claims. ### Return Reason Codes | Id | Açıklama | |------|------------------------------------------------| | 201 | Müşteriden gelen ürün yanlış | | 251 | Müşteriden gelen ürün defolu/zarar görmüş | | 301 | Gelen ürün bana ait değil | | 401 | Müşteriden gelen ürün adedi eksik | | 1701 | Gönderdiğim ürün yanlış değil | | 1751 | Gönderdiğim ürün kusurlu değil | | 2051 | Hijyenik risk barındıran ürün paketi açılmış | | 2200 | Gönderdiğim ürünlerde eksik yok | | 2201 | Satıcı kaynaklı gecikme yok | | 2202 | Satıcı kaynaklı bir problem değil | | 2203 | Fiş gönderilmişti, yeni fiş kesemiyorum | | 2204 | Girilen fiş tutarı doğru girilmiş | | 2205 | İletilen görseller veya bilgiler yanlış / yetersiz | | 2206 | Satıcı iade talebi için görüş vermedi | | 2207 | Fiş müşteriye yeniden gönderildi, iade yapılmayacak | ``` -------------------------------- ### Get Brands Name API Response Example Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/urun-entegrasyonu/hm-trendyol-marka-bilgileri Bu, getBrandsName servisi tarafından döndürülen örnek bir JSON yanıtıdır. Belirtilen isme uyan markaların bir listesini içerir, her marka için 'id' ve 'name' alanları bulunur. ```json [ { "id": 40, "name": "TRENDYOLMİLLA" } ] ``` -------------------------------- ### Example Invoice Amount API Response Source: https://developers.tgoapps.com/docs/trendyol-go-hizli-market-entegrasyonu/siparis-entegrasyonu/hm-paket-statu-bildirimi This JSON object represents a sample response from the invoice amount API. It shows the 'min' and 'max' values for the invoice amount. ```json { "min": 17.25, "max": 24.74 } ``` -------------------------------- ### Get Working Status Example Response - JSON Source: https://developers.tgoapps.com/docs/deprecated-hizli-market-entegrasyonu/market-entegrasyonu/randevulu-teslimat/hm-calisma-durumu-bildirimi Bu kod bloğu, workingStatus API'sinden alınabilecek örnek bir JSON yanıtını göstermektedir. Yanıt, mağaza kimliği ve o anki çalışma durumunu (OPEN/CLOSED) içeren bir öğe listesi içerir. Bu, mevcut mağazaların çalışma durumunu sorgulamak için kullanılır. ```json { "data": { "items": [ { "id": 6160, "workingStatus": "OPEN" }, { "id": 6154, "workingStatus": "OPEN" }, { "id": 28011, "workingStatus": "CLOSED" } ], "page": 0, "size": 3, "totalSize": 3 } } ``` -------------------------------- ### Product Details with Pricing and Weight Information Source: https://developers.tgoapps.com/docs/trendyol-go-hizli-market-entegrasyonu/siparis-entegrasyonu/hm-yeni-siparis-paketlerini-cekme This JSON object details a specific product, including its name, brand, and pricing information. It also contains weight details, specifying the unit and value, which are crucial for logistics and display. ```json { "amount": 44.97, "price": 44.97, "barcode": "837599517", "vatBaseAmount": 44, "product": { "name": "Zencefil 500 Gr", "productSaleName": "Zencefil 500 Gr", "brandName": "Yerli Sebze", "imageUrls": null, "weight": { "typeName": "Gr", "defaultSaleUnitValue": "500" } } } ```