Plan sütunu nasıl okunur?Etiket, uç noktayı içeren en düşük planı gösterir; yani Starter+, Eko Plan, Profesyonel Plan, Pro ve Kurumsal Plan anlamına gelir. Yanındaki notlar ek koşullardır: bir ek modül, bir kota ya da uç noktanın neyi kabul edeceğine ilişkin bir kısıtlama.Tümü için temel URL:
https://api.tryoto.com. Her çağrı Authorization: Bearer <access_token> gerektirir; ayrıntılar için Kimlik Doğrulama sayfasına bakın.Yetkilendirme
| Uç nokta | Yol | Plan |
|---|---|---|
| Refresh Token Kalıcı refresh anahtarınızı bir saatlik erişim belirteciyle değiştirir. | POST /rest/v2/refreshToken | Free+ |
| Health Check Platform çalışıyor mu? Pratikte kimlik doğrulama gerektirmez; bağlantı testi olarak kullanışlıdır. | GET /rest/v2/healthCheck | Free+ |
Hesap
| Uç nokta | Yol | Plan |
|---|---|---|
| Account Info Hesabınızın profili ve güncel bakiyesi. | GET /rest/v2/accountInfo | Free+ |
| Buy Credit Kargo cüzdanına kredi yükler. | POST /rest/v2/buyCredit | Free+ |
| Request Mobile Verification Bir telefon numarasına doğrulama kodu gönderir. | POST /rest/v2/requestMobileVerification | Free+ |
| Verify Mobile Number Kodu doğrular. Mart 2026’da marketplace alt hesapları için eklendi. | POST /rest/v2/verifyMobileNumber | Free+ |
İşlemler
| Uç nokta | Yol | Plan |
|---|---|---|
| Get Shipping Price Transactions List Her gönderi için alınan ücret ve bu ücreti oluşturan fiyat satırı. | POST /rest/v2/getShippingPriceTransactionsList | Starter+ |
| Credit Transactions Cüzdan hareketleri. | GET /rest/v2/creditTransactions | Free+ |
| Shipment Transactions Gönderi düzeyindeki ücretler; tarihe ve siparişe göre filtrelenebilir. | GET /rest/v2/shipmentTransactions | Free+ |
| COD Transactions Kapıda Ödeme Cüzdanı bakiyesi, yaklaşan transferler, para çekme işlemleri ve geçmiş. Eylül 2026’da eklendi. | GET /rest/v2/codTransactions | Free+ |
Pazaryeri (Marketplace)
| Uç nokta | Yol | Plan |
|---|---|---|
| Register Bir marketplace ana hesabının altında satıcı alt hesabı oluşturur. | POST /rest/v2/marketplace/register | Free+ marketplace anahtarı gerekir |
| Client Info Bir alt hesabın bilgilerini günceller. | POST /rest/v2/marketplace/clientInfo | Free+ marketplace anahtarı gerekir |
| Client Info Bir alt hesabın bilgilerini okur. | GET /rest/v2/marketplace/clientInfo | Free+ marketplace anahtarı gerekir |
Siparişler
| Uç nokta | Yol | Plan |
|---|---|---|
| Create Order Giriş noktası. Müşteri, adres, ürünler, ödeme yöntemi. | POST /rest/v2/createOrder | Free+ |
| Update Order Henüz gönderisi oluşturulmamış bir siparişi değiştirir. | POST /rest/v2/updateOrder | Free+ |
| Update Order Status Kendi sisteminizden bir durumu (delivered, returned, pickedUp) zorla uygular. | POST /rest/v2/updateOrderStatus | Scale+ |
| Cancel Order Gönderimden önce iptal eder. | POST /rest/v2/cancelOrder | Free+ |
| Get Orders Sayfalı ve filtrelenebilir liste. | GET /rest/v2/orders | Free+ |
| Hold Order Bir siparişi iptal etmeden bekletir. | POST /rest/v2/holdOrder | Free+ |
| Unhold Order Siparişi tekrar kuyruğa alır. | POST /rest/v2/unHoldOrder | Free+ |
| Get Order Details Bir siparişe ait tüm bilgiler. | GET /rest/v2/orderDetails | Free+ |
| Check Order Availability Siparişi taahhüt etmeden önce, karşılanıp karşılanamayacağını ve nereden karşılanacağını kontrol eder. | POST /rest/v2/checkOrderAvailability | Pro+ |
Kargo Fiyatları
| Uç nokta | Yol | Plan |
|---|---|---|
| Check OTO Delivery Fee Olası bir koli için fiyatlar, tahmini teslimat süreleri ve son kabul saatleri. Ödeme sayfası için kullanılan uç nokta budur. | POST /rest/v2/checkOTODeliveryFee | Free+ |
| Check Delivery Fee Kendi pazarlık ettiğiniz kargo şirketi sözleşmelerine göre fiyatlar. | POST /rest/v2/checkDeliveryFee | Starter+ |
| Get Delivery Fee Hâlihazırda var olan bir siparişin ücreti. | POST /rest/v2/getDeliveryFee | Free+ |
| Get Delivery Options Hesabınızda tanımlı teslimat seçenekleri. | GET /rest/v2/getDeliveryOptions | Starter+ |
Gönderiler
| Uç nokta | Yol | Plan |
|---|---|---|
| Create Shipment Koliyi bir kargo şirketiyle rezerve eder. deliveryOptionId alır ya da seçimi sizin yerinize yapar. | POST /rest/v2/createShipment | Free+ |
| Cancel Shipment Kargo şirketi nezdinde iptal eder. | POST /rest/v2/cancelShipment | Free+ |
İade Gönderileri
| Uç nokta | Yol | Plan |
|---|---|---|
| Create Return Shipment Dönüş ayağını rezerve eder. | POST /rest/v2/createReturnShipment | Free+ |
| Get Return Link Tek bir sipariş için müşteriye yönelik iade portalı bağlantısı. | POST /rest/v2/getReturnLink | Starter+ |
| Get Return Details Bir iadenin durumu. | POST /rest/v2/getReturnDetails | Free+ |
| Trigger Return SMS İade bağlantısını müşteriye SMS ile gönderir. | POST /rest/v2/triggerReturnSms | Starter+ |
Yazdırma
| Uç nokta | Yol | Plan |
|---|---|---|
| Print AWB Bir siparişin kargo etiketi (AWB). | GET /rest/v2/print/orderId | Free+ |
| Print Label Siparişin belgeleri: kargo etiketi (AWB), proforma, sipariş detayları veya iade belgesi. | POST /rest/v2/printLabel | Free+ plan matrisinde yer almıyor |
Takip
| Uç nokta | Yol | Plan |
|---|---|---|
| Order Tracking Bir siparişin güncel durumu. | POST /rest/v2/orderStatus | Free+ |
| Order History Kargo şirketleri arasında standartlaştırılmış, eksiksiz olay geçmişi. | POST /rest/v2/orderHistory | Free+ |
| Track Shipment Kargo şirketi düzeyinde gönderi takibi. | POST /rest/v2/trackShipment | Enterprise+ |
Müşteri Bildirimleri
| Uç nokta | Yol | Plan |
|---|---|---|
| Customer Notifications Bir sipariş için müşteriye hangi mesajların gönderildiği ve bu mesajlara ne olduğu. | GET /rest/v2/orders/{orderId}/customer-notifications | Scale+ |
Kargo Şirketi Entegrasyonları
| Uç nokta | Yol | Plan |
|---|---|---|
| Get Delivery Estimation Bir hat için beklenen teslimat aralığı. | POST /rest/v2/getDeliveryEstimation | Scale+ |
| AI Estimated Delivery Dates Kargo şirketinin beyan ettiği hizmet seviyesi yerine, modelin tahmin ettiği teslimat tarihleri. | POST /rest/v2/aiEstimatedDeliveryDates | Scale+ |
| Check Coverage Bu adrese teslimat yapan biri var mı? | POST /rest/v2/checkCoverage | Starter+ |
| Available Cities Aktif kargo şirketlerinizin hizmet verdiği şehirler. | POST /rest/v2/availableCities | Free+ |
| Available Time Slots Rezerve edilebilir teslimat zaman aralıkları. | POST /rest/v2/availableTimeslots | Starter+ |
| DC List Kargo şirketi kataloğu. | POST /rest/v2/dcList | Free+ |
| DC Config Belirli bir kargo şirketinin gerektirdiği kimlik bilgisi şablonu. | POST /rest/v2/dcConfig | Starter+ |
| DC Activation Bir kargo şirketi sözleşmesini etkinleştirir. | POST /rest/v2/dcActivation | Starter+ plana göre 3 / 7 / 20 / sınırsız sözleşme |
| Get Cities Şehir referans verileri. | POST /rest/v2/getCities | Free+ |
| Check DC Branch List Kargo şirketlerinin teslim şubeleri ve akıllı teslimat dolapları. | POST /rest/v2/checkDCBranchList | Free+ |
Çıkış Noktaları
| Uç nokta | Yol | Plan |
|---|---|---|
| Create Pickup Location Bir hub oluşturur. Ulusal adres alanlarını, servingRadius ve preparationSla değerlerini içerir. | POST /rest/v2/createPickupLocation | Free+ şube türü yalnızca Kurumsal Plan’da |
| Update Pickup Location Bir çıkış noktasını değiştirir. | POST /rest/v2/updatePickupLocation | Free+ şube türü yalnızca Kurumsal Plan’da |
| Get Pickup Location List Çıkış noktalarını listeler. | GET /rest/v2/getPickupLocationList | Free+ şube türü yalnızca Kurumsal Plan’da |
Markalar
| Uç nokta | Yol | Plan |
|---|---|---|
| Get List of Brands Hesaptaki markalar. | GET /rest/v2/getBrandList | Starter+ |
| Create Brand Marka ekler. | POST /rest/v2/createBrand | Starter+ |
Satış Kanalları
| Uç nokta | Yol | Plan |
|---|---|---|
| Sales Channels List Her kanalın entegrasyon koduyla birlikte katalog. | GET /rest/v2/salesChannel/getSalesChannelsList | Free+ |
| Sales Channel Config Tek bir kanalın kimlik bilgisi şablonu. | POST /rest/v2/salesChannel/getSalesChannelConfig | Free+ |
| Sales Channel Activation Kanalı bağlar. | POST /rest/v2/salesChannel/salesChannelActivation | Free+ plana göre 1 / 3 / 5 / sınırsız kanal |
Ürünler
| Uç nokta | Yol | Plan |
|---|---|---|
| Create Product SKU ekler. | POST /rest/v2/createProduct | Free+ |
| Product List SKU’ları listeler. | POST /rest/v2/productList | Free+ |
| Add Box Bir ambalaj kutusu tanımlar. | POST /rest/v2/addBox | Free+ |
| Update Box Bir kutuyu değiştirir. | POST /rest/v2/updateBox | Free+ |
| Get Box Bir kutuyu okur. | GET /rest/v2/getBox | Free+ |
Stok Yönetimi (Stock Management)
| Uç nokta | Yol | Plan |
|---|---|---|
| Update Stock Quantity Bir SKU’nun bir lokasyondaki stoğunu ayarlar. | POST /rest/v2/updateStockQuantity | Starter+ WMS ek modülü gerekir |
| Check Inventory Stock Tek bir lokasyondaki stok. | GET /rest/v2/checkInventoryStock | Starter+ WMS ek modülü gerekir |
| Check Global Stock Tüm lokasyonlardaki stok. | GET /rest/v2/checkGlobalStock | Starter+ WMS ek modülü gerekir |
| Create Inventory Order Bir giriş ya da transfer siparişi. | POST /rest/v2/createInventoryOrder | Starter+ WMS ek modülü gerekir |
| Update Packing Status Paketleme ilerlemesini kendi WMS’inizden bildirir. | POST /rest/v2/updatePackingStatus | Starter+ WMS ek modülü gerekir |
| Get Orders Ready For Packing Tek bir depo kodu için toplama ve paketleme kuyruğu. | POST /rest/v2/getPackingOrders | Starter+ WMS ek modülü gerekir |
| Check Available Stores For Pickup Ürünleri bulunduran ve teslim edebilecek şubeler. | POST /rest/v2/availableStoresForPickup | Starter+ WMS ek modülü gerekir |
| Available Cities For Pickup Mağazadan teslimin mümkün olduğu şehirler. | POST /rest/v2/availableCitiesForPickup | Starter+ WMS ek modülü gerekir · plan matrisinde yer almıyor |
Ulusal Adres
| Uç nokta | Yol | Plan |
|---|---|---|
| Get National Address From Short Code Suudi Arabistan kısa adres kodunu tam adrese dönüştürür. | POST /rest/v2/getNationalAddressFromShortCode | Free+ |
Webhook
| Uç nokta | Yol | Plan |
|---|---|---|
| Register a webhook Bir URL’yi bir olay türüne abone eder. | POST /rest/v2/webhook | Starter+ |
| List webhooks Kayıtlı abonelikleriniz. | GET /rest/v2/webhook | Starter+ |
| Update a webhook Bir aboneliği id ile yerinde değiştirir. | PUT /rest/v2/webhook | Starter+ |
| Delete a webhook Bir aboneliği kaldırır. | DELETE /rest/v2/webhook | Starter+ |
OTO FLEX
| Uç nokta | Yol | Plan |
|---|---|---|
| Assign Driver Bir siparişi kendi sürücülerinizden birine atar. | POST /rest/v2/assignDriver | Starter+ |
| Track Driver O sürücünün nerede olduğu. | POST /rest/v2/trackDriver | Starter+ |
İlgili sayfalar
- Kimlik Doğrulama — bu uç noktaların nasıl çağrılacağı.
- Webhook’lar — size geri dönen olaylar.
- apis.tryoto.com — tüm şemalar ve çalıştırılabilir örnekler.