Bu doküman, ikas’ın https://api.myikas.com/api/v2/admin/graphql adresindeki GraphQL API’nin en çok kullanılan örneklerini barındıran bir Postman koleksiyonudur.
\n\n\nNot: Eğer Ekim 2025’ten önce entegrasyon yaptıysanız, hâlâ v1 endpointini kullanıyor olabilirsiniz.
\n
📘 GraphQL’e yeniyseniz:
\nQuery, mutation, arguments gibi temel konulara hâkim değilseniz önce resmi GraphQL dökümanını incelemenizi öneririz.
\n🔑 Kullanıma başlamak için:
\nPostman dökümanındaki Variables kısmına client_id ve client_secret bilgilerinizi girin.
\nCreate Access Token isteğini çalıştırarak bir token alın.
\nAldığınız token’ı Admin API’s klasöründeki Authorization alanına ekleyin.
\nArtık API’yi test etmeye başlayabilirsiniz.
\nBuradaki örnekte client_credentials yani Özel Uygulama Authentication adımı anlatılmıştır. Eğer Admin uygulaması geliştiriyorsanız, OAuth2 Auth Code Flow kullanmalısınız.
\n","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"dfc74d74-e609-4133-88fe-9c6067c5b3b4","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"aad4cb29-0be6-4654-816a-a778e0a44470","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"a985dfe8-8899-43b7-9e38-55ad66b75db6"},{"name":"Admin API Örnekleri","item":[{"name":"Sipariş","item":[{"name":"Sipariş Listeleme","id":"4d6d9817-8901-43ea-9af3-48bb78142608","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"graphql","graphql":{"query":"query listOrder ($branchId: StringFilterInput, $branchSessionId: StringFilterInput, $customerEmail: StringFilterInput, $customerId: StringFilterInput, $id: StringFilterInput, $invoicesStoreAppId: StringFilterInput, $orderNumber: StringFilterInput, $orderPackageStatus: OrderPackageStatusEnumInputFilter, $orderPaymentStatus: OrderPaymentStatusEnumInputFilter, $orderTagIds: StringFilterInput, $orderedAt: DateFilterInput, $pagination: PaginationInput, $paymentMethodType: OrderPaymentMethodEnumFilterInput, $salesChannelId: StringFilterInput, $search: String, $shippingMethod: OrderShippingMethodEnumFilterInput, $sort: String, $status: OrderStatusEnumInputFilter, $stockLocationId: StringFilterInput, $terminalId: StringFilterInput, $updatedAt: DateFilterInput) {\n listOrder (branchId: $branchId, branchSessionId: $branchSessionId, customerEmail: $customerEmail, customerId: $customerId, id: $id, invoicesStoreAppId: $invoicesStoreAppId, orderNumber: $orderNumber, orderPackageStatus: $orderPackageStatus, orderPaymentStatus: $orderPaymentStatus, orderTagIds: $orderTagIds, orderedAt: $orderedAt, pagination: $pagination, paymentMethodType: $paymentMethodType, salesChannelId: $salesChannelId, search: $search, shippingMethod: $shippingMethod, sort: $sort, status: $status, stockLocationId: $stockLocationId, terminalId: $terminalId, updatedAt: $updatedAt) {\n count\n data {\n abandonedCartFlows {\n authorizedAppId\n campaignId\n canApplicable\n couponId\n flowId\n mailSendDate\n mailTemplateId\n mailTranslationId\n messageType\n recoverEmailStatus\n sendAfter\n smsTranslationId\n }\n archived\n attributes {\n orderAttributeId\n orderAttributeOptionId\n value\n }\n availableShippingMethods {\n price\n rateName\n shippingMethod\n shippingSettingsId\n shippingZoneRateId\n }\n billingAddress {\n addressLine1\n addressLine2\n company\n firstName\n id\n identityNumber\n isDefault\n lastName\n phone\n postalCode\n taxNumber\n taxOffice\n }\n branch {\n id\n name\n }\n branchSession {\n id\n name\n }\n branchSessionId\n campaignOffers {\n appliedOrderLineId\n campaignOfferId\n campaignOfferProductId\n offerEndDate\n offerStartDate\n status\n targetPageTypes\n triggerSourceOrderLineId\n }\n cancelReason\n cancelledAt\n cartId\n cartStatus\n checkoutId\n clientIp\n couponCode\n createdAt\n createdBy\n currencyCode\n currencyRates {\n code\n originalRate\n rate\n }\n currencySymbol\n customer {\n email\n firstName\n fullName\n id\n isGuestCheckout\n lastName\n notificationsAccepted\n phone\n preferredLanguage\n }\n customerGroups {\n id\n name\n }\n customerId\n customerOrderCount\n customerSegments {\n id\n name\n }\n customerSubscriptionPlans {\n id\n }\n deleted\n dueDate\n edited\n giftCardLines {\n amount\n code\n giftCardId\n id\n }\n giftPackageLines {\n isRefunded\n price\n priceListId\n taxValue\n }\n giftPackageNote\n host\n id\n invoices {\n appId\n appName\n createdAt\n hasPdf\n id\n invoiceData\n invoiceNumber\n storeAppId\n type\n }\n isGiftPackage\n itemCount\n lastActivityDate\n loyaltyLines {\n amount\n id\n loyaltyProgramCustomerId\n loyaltyProgramId\n loyaltySpendingMethodId\n }\n marketingCampaignId\n merchantId\n netTotalFinalPrice\n note\n orderAdjustments {\n amount\n amountType\n campaignId\n campaignType\n couponId\n name\n order\n transactionId\n type\n }\n orderLineItems {\n createdAt\n currencyCode\n currencySymbol\n deleted\n discountPrice\n edited\n finalPrice\n finalUnitPrice\n id\n originalOrderLineItemId\n price\n quantity\n sourceId\n status\n statusUpdatedAt\n stockLocationId\n taxValue\n unitPrice\n updatedAt\n }\n orderNumber\n orderPackageSequence\n orderPackageStatus\n orderPackages {\n createdAt\n deleted\n errorMessage\n id\n note\n orderLineItemIds\n orderPackageFulfillStatus\n orderPackageNumber\n sourceId\n stockLocationId\n updatedAt\n }\n orderPaymentStatus\n orderSequence\n orderTagIds\n orderedAt\n paymentMethods {\n isAlternativeGateway\n paymentGatewayCode\n paymentGatewayId\n paymentGatewayName\n price\n type\n }\n priceList {\n id\n name\n }\n priceListId\n recoverEmailStatus\n recoveryStatus\n salesChannel {\n id\n name\n type\n }\n salesChannelId\n sessionId\n sessionInfo {\n countryCode\n durationMS\n end\n host\n ip\n journeyId\n referer\n salesChannelId\n sessionId\n start\n storefrontId\n visitorId\n }\n shippingAddress {\n addressLine1\n addressLine2\n company\n firstName\n id\n identityNumber\n isDefault\n lastName\n phone\n postalCode\n taxNumber\n taxOffice\n }\n shippingLines {\n finalPrice\n isRefunded\n paymentMethod\n price\n priceListId\n shippingSettingsId\n shippingZoneRateId\n taxValue\n title\n transactionId\n }\n shippingMethod\n shippingSettingsId\n shippingZoneRateId\n sourceId\n staff {\n email\n firstName\n id\n lastName\n }\n status\n stockLocation {\n id\n name\n }\n stockLocationId\n storefront {\n id\n name\n }\n storefrontId\n storefrontRouting {\n domain\n id\n locale\n path\n priceListId\n salesChannelId\n }\n storefrontRoutingId\n storefrontTheme {\n id\n name\n themeId\n themeVersionId\n }\n storefrontThemeId\n taxLines {\n price\n rate\n }\n terminalId\n totalFinalPrice\n totalPrice\n updatedAt\n userAgent\n workflowId\n workflowName\n workflowNodeId\n }\n hasNext\n limit\n page\n }\n}","variables":"{\n \"pagination\": {\n \"limit\": 20,\n \"page\": 1\n }\n}"}},"url":"https://api.myikas.com/api/v2/admin/graphql","description":"listOrder Query'si ile, ikas sistemindeki oluşan siparişleri çekebilirsiniz. Bir sonraki örnekte, çeşitli filtrelerle atılan listOrder isteğini görebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu örnekte orderPackageStatus ve orderedAt filtrelerini görebilirsiniz. orderPackageStatus panelde gördüğünüz paketin durumuna denk gelmektedir.
\nPLANNED: Sipariş oluşturuldu ama henüz işleme alınmadı. Abonelik siparişlerinde kullanılmaktadır.
\nUNFULFILLED: Sipariş alındı ancak henüz hazırlanmadı veya sevk edilmedi. Siparişin içinde paket yok demektir.
\nFULFILLED: Siparişin tamamı gönderildi demektir.
\nPARTIALLY_FULFILLED: Siparişin bir kısmı gönderildi demektir.
\nREADY_FOR_SHIPMENT: Siparişin kargoya hazır olduğu anlamına gelir.
\nPARTIALLY_READY_FOR_SHIPMENT: Siparişin bir kısmı kargoya hazır.
\nREADY_FOR_PICK_UP: Müşteri tarafından mağazadan teslim alınmaya hazır.
\nDELIVERED: Sipariş başarıyla teslim edildi.
\nPARTIALLY_DELIVERED: Siparişin bir kısmı teslim edildi.
\nCANCEL_REJECTED: İptal talebi reddedildi.
\nCANCELLED: Sipariş tamamen iptal edildi.
\nPARTIALLY_CANCELLED: Siparişin sadece bir kısmı iptal edildi.
\nREFUND_REQUESTED: Müşteri iade talebi oluşturdu.
\nREFUND_REQUEST_ACCEPTED: İade talebi onaylandı.
\nREFUND_REJECTED: İade talebi reddedildi.
\nREFUND_IN_TRANSIT: İade edilen ürün kargo sürecinde.
\nREFUND_DELIVERED: İade edilen ürün satıcıya ulaştı.
\nREFUNDED: Siparişin tamamı için geri ödeme yapıldı.
\nPARTIALLY_REFUNDED: Siparişin bir kısmı için geri ödeme yapıldı.
\nTarih için timestampt olarak filtre verilmeli, Unix epoch olarak örnek değer: 1757365200000
\nDiğer filtre değerlerine GraphQL arayüzünden listOrder query'sini bularak bakabilirsiniz: https://api.myikas.com/api/v2/admin/graphql
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu API sayesinde, siparişin içindeki ödemeleri ve detaylarını sorgulayabilirsiniz. Bir sipariş kredi kartı ile yapıldıysa, taksit sayısı, BIN bilgisi gibi bilgilerin kontrolünü sağlayabilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"fulfillOrder mutation'ı sayesinde, bir siparişin içerisindeki ürünleri kargoya hazırlayabilir ya da gönderildi yapabilirsiniz.
\nEğer paket mantığı ile ilerlemek istiyorsanız, yani bazı ürünler farklı stok lokasyonlarından çıkabillirse / ya da farklı zamanlarda kargoya verilecekse, lines arrayini kullanmalısınız. Eğer bir siparişte farklı stok lokasyonlarına atanmış ürünler varsa, lines array'ini vermek zorundasınız. markAsReadyForShipment true gönderirseniz, sipariş Kargoya Hazır yani READY_FOR_SHIPMENT statüsüne alınacaktır.
\ntrackingInfoDetails kısmında barcode kısmına kargoya verilecek barkodu yazabilirsiniz. Bu barkod, ikas'taki kargo etiketinin üzerinde yer alacaktır.
\nAPI'dan dönen orderPackages içindeki id'yi kendi tarafınızda kaydederek, daha sonra bu paketi GÖNDERİLDİ ya da TESLİM EDİLDİ olarak işaretlemek için Siparişin / Paketin Durumunu Güncelleme / Gönderildi veya Teslim Edildi örneğini kullanabilirsiniz.
\nBir sonraki örnekte, lines üzerinden siparişi kargoya çekmeyi görebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Eğer ürünleri farklı zamanlarda kargoya verecekseniz ya da farklı stok lokasyonlarından ürünleri gönderiyorsanız, bir siparişin içerisinde birden fazla paket olabilir. Bu yüzden satır bazlı / paket bazlı işlem yapmak oldukça kritik.
\nAPI'dan dönen orderPackages içindeki id'yi kendi tarafınızda kaydederek, daha sonra bu paketi GÖNDERİLDİ ya da TESLİM EDİLDİ olarak işaretlemek için Siparişin / Paketin Durumunu Güncelleme / Gönderildi veya Teslim Edildi örneğini kullanabilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu API ile, gönderildi ya da kargoya hazır işaretlediğiniz siparişi / paketi teslim edildi olarak işaretleyebilirsiniz. Kargoya Hazır'dan GÖNDERİLDİ durumuna da bu API'den geçmesini sağlayabilirsiniz. Bu API sadece paket oluşumuş API'lerde kullanılabilir, eğer birden fazla paket ya da paketlenmemiş ürünler varsa, bu API kullanılamaz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Eğer paket bazlı sipariş yönetimi yapıyorsanız, package içinde packageId vererek paketin durumunu güncelleyebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Siparişlere etiket atayarak, bu siparişleri hem kendiniz, hem de yönetim panelini kullanan kullanıcılar filtreleyebilir.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Fiyatlar içerisinde her zaman finalPrice, müşterinin o ürün / sipariş için ödediği tutarı ifade etmektedir ve her zaman bu fiyatlar üzerinden işlem yapmanızı tavsiye ederiz.
\nSiparişlerin durumunu orderPackageStatus'ten kontrol edebilirsiniz. Eğer herhangi bir entegrasyon kullanılmıyorsa, siparişler UNFULLFILED durumunda oluşur. Siparişin içerisindeki ürünler paketlenirse, gönderilse, bu orderPackageStatus güncellenir.
\nÖrnek vermek gerekirse, ikas Kargo uygulamasını kullanan bir kullanıcı kargo kodu aldığında, ürünlerini ekran üzerinden paketler ve kargo kodu, orderPackage içerisindeki trackingInfo.barcode alanına eklenir.
\n","_postman_id":"984184b5-5cc0-4f3f-a6e3-6656d487c205","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Hesap oluşturmuş / oluşturmamış tüm müşterileri bu query'den görüntüleyebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Sistemdeki tüm ürünleri bu query sayesinde çekebilirsiniz.
\nhttps://api.myikas.com/api/v2/admin/graphql adresinden verebileceğiniz filtreleri görebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Yeni bir ürün oluşturmak için kullanılan mutation. Temel ürün bilgileri ve varyant bilgilerini içeren bir input ile çalışır.
\nmutation CreateProduct($input: CreateProductInput!) {\n createProduct(input: $input)\n}\n\nÜrün oluşturmak için gerekli input objesi. Zorunlu ve opsiyonel alanları içerir.
\nEn temel haliyle bir ürün oluşturma örneği:
\nmutation {\n createProduct(input: {\n name: \"Basit Ürün\",\n type: \"PHYSICAL\",\n variants: [\n {\n sku: \"SKU\",\n isActive: true,\n prices: [\n {\n sellPrice: 100\n }\n ]\n }\n ]\n }) {\n id\n name\n variants {\n id\n sku\n prices {\n sellPrice\n }\n }\n }\n}\n\nDaha kapsamlı bir ürün oluşturma örneği:
\nmutation {\n createProduct(input: {\n name: \"Detaylı Ürün\",\n type: \"PHYSICAL\",\n brand: {\n name: \"paen\"\n },\n variants: [\n {\n sku: \"SKU-001\",\n isActive: true,\n prices: [\n {\n sellPrice: 100\n }\n ],\n images: [\n {\n imageUrl: \"https://cdn.example.com/image.webp\",\n isMain: true,\n order: 1\n }\n ]\n }\n ]\n }) {\n id\n name\n brand {\n name\n }\n variants {\n sku\n images {\n imageUrl\n isMain\n }\n }\n }\n}\n\nHer ürün en az bir varyant içermelidir. Varyant yapısı:
\ntype ProductVariantInput = {\n sku: string; // Stok Kodu\n isActive: boolean; // Varyant aktiflik durumu\n prices: [{ // Fiyat bilgileri\n sellPrice: number; // Satış fiyatı\n discountPrice?: number; // İndirimli fiyat\n priceListId?: string; // Fiyat listesi ID //Varsayılan için boş bırakın.\n currency?: string; // Para birimi //Varsayılan için boş bırakın.\n buyPrice?: number; // Alış fiyatı\n }];\n images?: [{ // Ürün görselleri\n imageUrl: string; // Görsel URL\n isMain: boolean; // Ana görsel mi?\n order: number; // Görsel sırası\n }];\n weight?: number; // Varyant ağırlığı\n hsCode?: string; // GTIP kodu\n barcodeList?: string[]; // Barkod listesi\n sellIfOutOfStock?: boolean; // Stok yokken satılabilir mi?\n}\n\nMutation başarılı olduğunda oluşturulan ürünün tüm bilgilerini içeren bir obje döndürür.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Ürün bilgilerini güncellemeye yarayan mutation. Sadece güncellenmek istenen alanları içeren bir input ile çalışır, böylece kısmi güncelleme yapılabilir. Eğer variantlar ile alakalı bir güncelleme yapmak isterseniz, bu sefer variantId'yi de vermeniz gerekiyor.
\nmutation {\n updateProduct(input: {\n id: \"prod_123\"\n description: \"Yeni ürün açıklaması buraya gelecek. Bu ürün şu özelliklere sahiptir...\"\n }) {\n id\n description\n updatedAt\n }\n}\n\nmutation {\n updateProduct(input: {\n id: \"prod_123\"\n variants: [\n {\n id: \"var_456\"\n sku: \"YENİ-SKU-001\"\n }\n ]\n }) {\n id\n variants {\n id\n sku\n updatedAt\n }\n }\n}\n\nmutation {\n updateProduct(input: {\n id: \"prod_123\"\n name: \"Yeni Ürün Adı\"\n }) {\n id\n name\n shortDescription\n updatedAt\n }\n}\n\nMutation, güncellenen ürünün tüm bilgilerini içeren bir obje döndürür. İsteğinize bağlı olarak sadece ihtiyacınız olan alanları seçebilirsiniz.
\nSadece gönderilen alanlar güncellenir
\nGönderilmeyen alanlar mevcut değerlerini korur
\nBu API sayesinde ürünlerinizin stok adetlerini toplu bir şekilde 200 varyanta kadar güncelleyebilirsiniz. Eğer hatalı bir ürün varsa, errorInputs'tan geri bildirim alabilirsiniz.
\nHatalı olmayan ürünlerin stok adetleri verdiğiniz inputa göre güncellenecektir.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Ürünlerinizin satış kanallarındaki durumunu bu API ile güncelleyebilir, ürünü satışa açıp kapatabilirsiniz.
\nSTOREFRONT türündeki satış kanallarında 3 tane seçenek bulunuyor:
\nHIDDEN -> Ürün satışa açıktır, fakat sadece linkten erişilebilir. Arama ve kategori sayfalarında gözükmez.
\nPASSIVE -> Ürün satışa kapalıdır, yani pasiftir.
\nVISIBLE -> Ürün satışa açıktır ve arama / kategori sayfalarında da gözükür.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu API sayesinde, sistemdeki fiyat listelerini çekebilirsiniz. Eğer kullanıncın hiçbir fiyat listesi yoksa, sistemde tek bir Currency ile satış yaptığını varsayabilirsiniz. Bu Currency'i de Satıcı Bilgisi - Varsayılan Para Birimi kısmından öğrenebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu API ile sistemdeki bir ürüne sonradan görsel ekleyebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"ikas'ta ürün hakkında bilmeniz gereken kritik bilgilere buradan erişebilirsiniz.
\nHer üründe bir tane variant mutlaka olmalı, ürün varyantsız olsa bile. Eğer ürününüz seçenekliyse, variants array'ine birden çok variant göndererek, ürünü varyantlı açabilirsiniz.
\nFiyatlar Hakkında Genel Bilgi
\nİlk olarak ikas hesabında hangi para birimini kullandığınını öğrenmelisiniz. Buna ListMerchantSettings (Satıcı Bilgisi - Varsayılan Para Birimi) örneğinden ulaşabilirsiniz. currencyCode neyse, ürün içindeki alttaki objedeki fiyatta o para birimdedir. priceListId sadece birden çok para biriminde satış yaparken ve listPriceList (Fiyat Listelerini Listeleme) API'sinden cevap geliyorsa kullanılmalı.
\nÜründe varsayılan para biriminden mutlaka fiyat bulunmalı. Alış fiyatı bu fiyattan alınmaktadır.
\n{\n \"prices\": [\n {\n \"buyPrice\": null,\n \"currency\": null,\n \"currencyCode\": null,\n \"currencySymbol\": null,\n \"discountPrice\": 499,\n \"priceListId\": null,\n \"sellPrice\": 849\n }\n ]\n}\n\nEğer birden çok fiyat listeniz varsa, B2B, Yurtdışı Dolar fiyatlar gibi, bu sefer fiyatları aşağıdaki şekilde kaydedebilirsiniz.
\n{\n \"prices\": [\n {\n \"buyPrice\": null,\n \"currency\": null,\n \"currencyCode\": null,\n \"currencySymbol\": null,\n \"discountPrice\": 499,\n \"priceListId\": null,\n \"sellPrice\": 849\n },\n \"buyPrice\": null,\n \"currency\": null,\n \"currencyCode\": null,\n \"currencySymbol\": null,\n \"discountPrice\": 499,\n \"priceListId\": \"Fiyat Listenizin ID'si\",\n \"sellPrice\": 849\n }\n ]\n}\n\nStoklar Hakkında Genel Bilgi
ikas hesabı açıldığında bir tane stok lokasyonu açılır, bu stok lokasyonuna stok işlemi yapmak için mutlaka id'sini bilmeniz gerekmektedir. listStockLocation (Stok Lokasyonlarını Listeleme) işlemi ile sistemdeki tüm stok lokasyonlarını öğrenebilirsiniz.
Ürün Objesinin Detaylı Açıklaması
\n{\ndata {\n attributes { //Ürünün özel alanlarını bu alandan görüntüleyebilirsiniz.\n imageIds\n productAttributeId\n productAttributeOptionId\n value\n }\n baseUnit { //Ürünün birim fiyat bilgilerini içerir.\n baseAmount\n type\n unitId\n }\n brand { //Ürünün markasını içerir.\n id\n name\n }\n categories { //Ürünün kategorilerini içerir, kategori ağacını oluşturmanız için listCategory yaparak tüm kategorileri elinizde barındırmalısınız.\n id\n name\n }\n createdAt //Ürünün ne zaman oluştuğunu öğrenebilirsiniz.\n deleted \n description //Ürünün HTML açıklamasını içerir.\n dynamicPriceListIds //Ürün eğer dinamik fiyat listesine dahilse, buradan o fiyat listesinin ID'sini öğrenebilirsiniz.\n googleTaxonomyId // Google kategorisinin ID'sini öğrenebilirsiniz.\n id //Ürünün id'si.\n maxQuantityPerCart //Deprecate alan.\n metaData {\n id\n slug //Ürünün linkini öğrenebilirsiniz. /varyantli-urun gibi.\n }\n name //Ürünün adı.\n productOptionSetId //Eğer üründe kişiselleştirme varsa, bu kişiselleştirme setinin id'si.\n productVolumeDiscountId //Deprecate alan.\n salesChannels { //Ürünlerin satış kanalları.\n id //satış kanalının id'si\n maxQuantityPerCart //Sepete maksimum kaç tane eklenebileceği.\n minQuantityPerCart //Sepete minimum kaç tane eklenmesi gerektiğ.\n productVolumeDiscountId //Deprecate alan.\n quantitySettings//Deprecate alan.\n status //Satış kanalındaki durumu.\n }\n shortDescription//Deprecate alan.\n tags { //Ürün etiketleri\n id\n name\n }\n totalStock //Ürünün total stoğu.\n translations { //ürünün çevirileri.\n description\n locale\n name\n }\n type\n updatedAt\n variants { //Ürünün varyantları, ürün basit olsa bile, bir tane varyantı olmalı.\n barcodeList //Barkod değeri\n bundleSettings { //Bundle ürün ise ayarları.\n maxBundleQuantity\n minBundleQuantity\n products {\n addToBundleBasePrice\n discountRatio\n filteredVariantIds\n id\n maxQuantity\n minQuantity\n order\n productId\n quantity\n }\n }\n createdAt //Varyantın oluşturulma tarihi.\n deleted\n hsCode //HS Code'u\n id //Varyantın id'si.\n images { //Varyantın görselleri.\n fileName\n imageId\n isMain\n isVideo\n order\n }\n isActive //Varyantın satışa açık olup olmadığı\n prices { //Varyant fiyatları\n buyPrice\n currency\n currencyCode\n currencySymbol\n discountPrice\n priceListId\n sellPrice\n }\n sellIfOutOfStock //Stoğu bitse de satmaya devam edilsin mi seçeneği.\n sku //SKU\n stocks { //Stokları\n createdAt\n deleted\n id\n productId\n stockCount\n stockLocationId\n updatedAt\n variantId\n }\n unit { //Birim fiyat seçenekleri\n amount\n type\n }\n updatedAt\n variantValues { //Varyant değerleri\n variantTypeId\n variantTypeName\n variantValueId\n variantValueName\n }\n weight //Ağırlık / Desi\n }\n vendor { //Tedarikçi\n id\n name\n }\n weight //Deprecate alan.\n}\n\nBu API'ı kullanarak, siparişin içerisine mesaj ekleyerek satıcıların görmesini sağlayabilirsiniz. ikas'ta biz dış entegrasyonlara sipariş aktarıldığında veya bir hata meydana geldiğinde buraya mesaj yazarak kullanıcıları bilgilendiriyoruz. Bu mesajlara toplu filtreleme yapılamıyor, eğer filtreleme gibi bir aksiyona ihtiyacınız varsa, sipariş etiketlerini kullanabilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu API sayesinde, uygulamanıza kayıtlı ikas'ın belirttiğiniz adrese gönderdiği Webhookları görüntüleyebilirsiniz. Yeni Webhook oluşturmak için, bir sonraki örneği kullanabilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"ikas belirttiğiniz adrese sistemde gerçekleşen işlemleri bildirebilir. Bu sayede periyodik olarak ikas API'larına gelerek veri çekmenize gerek kalmaz.
\nWebhook'u kendi iş akışlarınızda işlemeden önce, HTTP 200 kodunu ikas'a dönmeniz gerekmektedir, eğer 200 dönmezseniz ikas 3 defa daha göndermeyi deneyip webhook göndermeyi bırakacaktır. Eğer hata oranınız artarsa, Webhook adresiniz bloklanacaktır.
\nKullanabileceğiniz scopelar:
\n\"store/order/created\" → Yeni bir sipariş oluşturulduğunda tetiklenir
\"store/order/updated\" → Mevcut bir sipariş güncellendiğinde tetiklenir
salesChannelIds filtresi vererek sadece belirli satış kanallarının bildirimlerini alabilirsiniz.
\n\"store/product/created\" → Yeni bir ürün oluşturulduğunda tetiklenir
\"store/product/updated\" → Bir ürün güncellendiğinde tetiklenir
\"store/customer/created\" → Yeni bir müşteri oluşturulduğunda tetiklenir
\"store/customer/updated\" → Bir müşteri bilgisi güncellendiğinde tetiklenir
\"store/customer/statusUpdated\" → Müşteri iletişim durumunu güncellendiğinde tetiklenir
\"store/stock/created\" → Yeni bir stok kaydı oluşturulduğunda tetiklenir
\"store/stock/updated\" → Stok bilgileri güncellendiğinde tetiklenir
\"store/app/deleted\" → Uygulamanız mağazadan kaldırıldığında tetiklenir. (Özel uygulamalar için geçerli değildir.)
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Bu API sayesinde kendi script / Javascript kodunuzu kullanıcının online mağazasına ekleyebilirsiniz. storefrontId'yi online mağazaları listeleme API'sinden alabilirsiniz.
\nAPI sonucu dönen id ile, daha sonra scripti güncelleme ve kaldırma işlemlerini gerçekleştirebilirsiniz.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Admin API, GraphQL kullanmaktadır. Buradaki mutation ve queryler yönetim panelinde yapılabilen aksiyonların ve sorguların çoğunu içermektedir.
\nBu API'nin endpoint'i:
\nhttps://api.myikas.com/api/v2/admin/graphql
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"