> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hızlı başlangıç: OTO ile ilk siparişinizi gönderin

> Size uygun yolla OTO’da ilk siparişinizi yola çıkarın: mağazasını bağlayan işletme, çok lokasyonlu şirket ya da API kullanan geliştirici.

OTO’yu kullanmaya başlamanın üç yolu var; hangisini izleyeceğiniz, rolünüze ve neyi hedeflediğinize bağlı. Üç yolun sonunda da gerçek bir sipariş yola çıkmış olur.

## Hangi yoldan başlamalısınız?

| Durumunuz | Başlangıç noktası |
| - | - |
| Bir e-ticaret siteniz var ve siparişlerinizi göndermek istiyorsunuz | İşletmeler için: yaklaşık bir saat |
| Birden fazla lokasyonunuz, markanız veya kargo şirketiniz var | Çoklu lokasyon: hub’lar ve kurallar eklenir |
| Başka bir sistemi OTO’ya entegre ediyorsunuz | Geliştiriciler için: beş API çağrısı |

## İşletmeler için

Mağazanızı bağlamaktan, üzerinde kargo etiketi olan ilk pakete kadar en kısa yol.

| # | Adım | Nerede? |
| - | - | - |
| 1 | **Mağazanızı bağlayın.** Katalogda mağazanızın platformunu bulun ve **Explore Channel**’a tıklayın. Shopify ve Salla’da OTO uygulaması kendi uygulama mağazalarından kurulur; diğerlerinin çoğu için mağaza URL’si ve API anahtarı yeterlidir. | **Entegrasyonlar → Satış Kanalları** |
| 2 | **Gönderim yapacağınız noktayı oluşturun.** Başlamak için bir depo yeterli. Adresi yazmak yerine haritada işaretleyin; böylece yönlendirme kuralları konumu koordinatıyla bilir. | **Ayarlar → Yönetim → Depolar** |
| 3 | **Teslimat süresini belirleyen iki alanı doldurun.** O hub için **Serving Radius** (hizmet yarıçapı) ve **Hazırlık Süresi SLA**. SLA varsayılan olarak 24 saattir; bunu gerçek hazırlık sürenize göre değiştirin. | Aynı ekran, sihirbazın 2. adımı |
| 4 | **Bir kargo şirketi bağlayın.** Kargo şirketini açın ve ihtiyacınız olan *servisi* bağlayın. Bir kargo şirketinin birden fazla servisi vardır ve kurallar kargo şirketini değil, servisi seçer. | **Entegrasyonlar → Shipping Partners** |
| 5 | **Bir mesajlaşma sağlayıcısı bağlayın.** Takip mesajlarının kayıtlı gönderici adınızla gitmesi için SMS hesabınızı bağlayın. | **Ayarlar → Customer Notifs → SMS** |
| 6 | **İlk siparişinizi gönderin.** Gerçek bir sipariş seçin, gönderiyi oluşturun ve etiketi yazdırın. Ardından siparişi teslim edilene kadar takip edin ve müşterinizin göreceği takip sayfasına göz atın. | **Gönderiler** |

> [!TIP]
>
> **Başka bir şey ayarlamadan önce bir siparişi baştan sona gönderin**
>
> İlk akla gelen; kuralları, bildirimleri ve marka ayarlarını yapıp sonra denemektir. Tam tersini yapın: Tüm ayarlar varsayılandayken bir siparişi teslim edilene kadar takip edin.
>
> Bu yaklaşık yirmi dakika sürer ve gerçek sorunları ortaya çıkarır: kargo şirketinin kabul etmediği bir adres formatı, eksik bir alıcı adı, ağırlığı girilmemiş bir ürün. Üstelik bunları dört yüz sipariş yerine tek bir siparişte düzeltirsiniz.

## Çoklu lokasyon

Yukarıdaki adımların hepsi geçerli. Bunlara ek olarak, bir şeyden birden fazla olduğunda önem kazanan dört kararı vermeniz gerekir.

| Karar | Neden şimdi? |
| - | - |
| **Hub kodları** | Hub’ları oluşturmadan *önce* ERP veya POS sisteminizden sorumlu kişiyle birlikte belirleyin. Sistemler arasındaki ortak anahtar bunlardır; belirlemesi kolay, sonradan değiştirmesi zordur. Bkz. [ERP sistemleri](https://docs.tryoto.com/tr/integrations/erp-systems.md). |
| **Hangi hub, nereye, ne gönderecek?** | Her hub için hizmet yarıçapı ve Hazırlık Süresi SLA; ardından aralarında seçim yapacak [sipariş yönlendirme](https://docs.tryoto.com/tr/modules/omnichannel-oms/order-routing.md) kuralları. |
| **Hangi kargo şirketi, ne zaman?** | Maliyet, kapsama alanı ve hızı karşılaştıran [Kargo OTOmasyonu](https://docs.tryoto.com/tr/modules/shipping-management/shipping-automation.md) kuralları. Kendi sürücüleriniz varsa onlar da bu karşılaştırmaya dahildir. |
| **Kim neyi görecek?** | Kullanıcıları eklemeden önce rol şablonlarını oluşturun. Finansal bilgileri görme yetkisi ayrı bir yetkidir. Bkz. [Kullanıcılar, roller ve yetkiler](https://docs.tryoto.com/tr/platform/users-roles-and-permissions.md). |

Depoların yanında mağazalarınız da varsa onları **şube** olarak ekleyin ve her hub için lokasyon bazlı stok takibinin açık olup olmayacağına karar verin. Bkz. [Hub Yönetimi](https://docs.tryoto.com/tr/modules/hubs-management/overview.md). Birden fazla marka adıyla satış yapıyorsanız önce **markaları** oluşturun; çünkü mesajlar, takip sayfaları ve etiketler markaya bağlıdır.

> [!WARNING]
>
> **Ayarları yapma sırası göründüğünden daha önemli**
>
> Markalar, hub kodları ve SKU kuralları, kendilerinden sonra oluşturulan her şeyde kullanılır. Bunları en başta ayarlarsanız gerisi kolayca gelir; sonradan ayarlarsanız mevcut kayıtları tek tek düzeltmeniz gerekir.
>
> İşe yarayan sıra şudur: **markalar → hub’lar → ürünler → kanallar → kargo şirketleri → kurallar → kullanıcılar**.

## Geliştiriciler için

Sırasıyla beş çağrı. Tüm endpoint’ler [endpoint listesinde](https://docs.tryoto.com/tr/developers/rest-api-reference.md) yer alır; burada yalnızca temel akış var.

| # | Çağrı | Sonuç |
| - | - | - |
| 1 | `POST /rest/v2/refreshToken` | Bir saat geçerli bir erişim belirteci (access token). Önbelleğe alın; her istek için yeni bir tane almayın. |
| 2 | `GET /rest/v2/healthCheck` | Başka bir şeyle uğraşmadan önce belirtecin ve sunucu adresinin doğru olduğunun teyidi. |
| 3 | `POST /rest/v2/createOrder` | Sipariş OTO’da oluşur ve yönlendirme kurallarına tabi olur. Kendi sipariş numaranızı gönderebilir ya da OTO’nun oluşturmasını sağlayabilirsiniz. |
| 4 | `POST /rest/v2/createShipment` | Kargo şirketinde gönderi kaydı açılır ve kargo etiketi (AWB) oluşur. |
| 5 | `POST /rest/v2/webhook` | Her sipariş için değil, bir kez kaydedilir. Bu noktadan sonraki her şey size otomatik olarak gönderilir. |

`refresh_token` değerini **Ayarlar → API Integrations → Bağla** yolundan alın ve canlıya geçmeden önce `https://staging-api.tryoto.com` üzerinde geliştirin. Bkz. [Kimlik doğrulama](https://docs.tryoto.com/tr/developers/authentication.md).

> [!TIP]
>
> **5. adımı ilk gün ekleyin, sorgulama sorun çıkarmaya başladığında değil**
>
> `orderStatus` endpoint’ini düzenli olarak sorgulamak hemen çalışır ve sizin tarafınızda bir endpoint gerektirmez. Entegrasyonların bu şekilde kurulup yıllarca öyle kalmasının nedeni de tam olarak budur.
>
> Webhook kurmak bir sabahlık iştir. Bir yıldır sorgulamaya göre çalışan bir sisteme sonradan webhook eklemek ise öyle değildir.

## Canlıya geçmeden önce

| | |
| - | - |
| **Hazırlık sürelerini kontrol edin** | Her hub için Hazırlık Süresi SLA’yı varsayılan 24 saate göre değil, gerçek hazırlık sürenize göre ayarlayın. |
| **Çalışma saatlerini kontrol edin** | Şubelerin çalışma saatlerinin tanımlı olup olmadığına da bakın. Teslimat süresi bu saatlere göre hesaplanır. |
| **Tüm mesajları kendinize gönderin** | Takip, teslimat ve iade mesajlarını desteklediğiniz her dilde, gerçek bir telefonda test edin. |
| **Kredi uyarı limitini belirleyin** | Bakiyenin azaldığını fark edip ödeme yapmaya zaman kalacak kadar yüksek bir limit belirleyin. Kredi biterse gönderi oluşturulamaz. |
| **İki adımlı doğrulamayı (MFA) açın** | Herkes için açın; yöneticilerden başlayın. Bkz. [Güvenlik ve uyumluluk](https://docs.tryoto.com/tr/platform/security-and-compliance.md). |
| **Sessiz hataların bildirimlerine abone olun** | **Shipment Creation Attempt Failed** ve **SLA Breach**. Bu sorunları size başka hiçbir şey haber vermez. Bkz. [bildirimler](https://docs.tryoto.com/tr/platform/collaboration-and-notifications.md). |

## Sonraki adımlar

> **[Temel kavramlar](https://docs.tryoto.com/tr/get-started/core-concepts.md)**
>
> Dokümantasyonun geri kalanında kullanılan kavramlar.

> **[Omnichannel OMS](https://docs.tryoto.com/tr/modules/omnichannel-oms/overview.md)**
>
> İlk okunması gereken modül.

> **[Geliştiriciler](https://docs.tryoto.com/tr/developers/overview.md)**
>
> API’nin tamamı.


## Related topics

- [OTO nedir?](https://docs.tryoto.com/tr/get-started/what-is-oto.md)
- [E-ticaret operasyon platformu ve kargo entegratörü](https://docs.tryoto.com/tr/index.md)
- [Planlar, fiyatlar ve eklentiler](https://docs.tryoto.com/tr/pricing/plans-and-packaging.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.