> ## 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.

# Kargo şirketi entegrasyonu ve yapılandırması

> Kargo hesaplarınızı OTO’ya bağlayın ve her birinin fiyatını, SLA’sını, şehir kapsamını ve günlük kapasitesini girin; Kargo OTOmasyonu bunlara göre seçer.

> [!NOTE]
>
> **Nerede bulunur:** Main → Entegrasyonlar → Shipping Partners — [OTO’da aç ↗](https://app.tryoto.com/shipping-partners)

Kargo şirketi entegrasyonu, kargo tarafındaki diğer her şeyin dayandığı ayar katmanıdır. Hesapları bağlayın; OTO’ya her kargo şirketinin ne kadar ücret aldığını, nerelere gittiğini, ne kadar hızlı teslim etmeyi taahhüt ettiğini ve günde ne kadar gönderi alabildiğini söyleyin. Böylece modülün geri kalanı karar verirken dayanacağı bilgiye sahip olur.

## Kargo iş ortağı kataloğu

**Main → Entegrasyonlar → Shipping Partners** ekranını açın. Sayfada iki sekme vardır: Bağlayabileceğiniz tüm iş ortaklarının kataloğu olan **More Connections** ve zaten bağladıklarınızı gösteren **Connected**. Katalog anahtar kelimeye, **Country**’ye ve **Service Type**’a göre filtrelenebilir. Her kartta, o iş ortağının sunduğu hizmet türleri için küçük simgeler bulunur; sığmayanlar için `+2` veya `+7` gibi bir etiket görünür.

![Shipping Partners kataloğu](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/carrier-1-shipping-partners.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=e90820372354645c987defef5dfbdef9)

Şekil 1 — More Connections altındaki katalog. Alt başlıktaki Connect your shipping partners (Your Own Rates) ifadesi, bu sekmenin sözleşmeniz olan kargo şirketleri için olduğunu açıkça gösterir.

### Bir iş ortağı, birden fazla hizmet

Bir iş ortağını açmak onu bağlamaz. Bu ekran, iş ortağının **Available Services** listesini, her birinin kendi **Connect** düğmesiyle gösterir. Örneğin Aramex; Domestic (Regular 2–7 days), International, Heavy & Bulky (furniture), PUDO (pick up / drop off), Same Day (24 hours) ve Banking hizmetlerini sunar. Altı hizmet, altı ayrı bağlantı demektir.

![Bir kargo şirketinin sunduğu hizmetler](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/carrier-2-available-services.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=6283a2ab23dedf7343aeeaffdcbe3cff)

Şekil 2 — Her hizmet ayrı bağlanır. Bir kuralın Riyadh’de bir kargo şirketinin aynı gün hizmetini, başka her yerde aynı şirketin standart hizmetini tercih edebilmesi bu sayede mümkün olur.

## Kargo şirketi bağlamak

Bağlantı iki adımlı bir sihirbazla kurulur: **1 Credentials**, ardından **2 Settings**.

### 1. adım: Credentials

Bu bilgiler kargo şirketindeki hesabınızdan gelir; bu yüzden form iş ortağına göre değişir. Aramex; Username, Password, Account Number, Account PIN, Account Entity ve Account Country Code isterken başka bir iş ortağı yalnızca bir API anahtarı isteyebilir. **Advanced Settings** açıldığında isteğe bağlı parametreler görünür.

**Test Connection**, devam etmeden önce kimlik bilgilerini kargo şirketinde doğrular. Mutlaka kullanın: Hatalı bir şifreyle kaydedilen bağlantı sessizce bekler ve daha sonra, gönderi oluşturulurken, başka birinin vardiyasında hata verir.

![Credentials adımı](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/carrier-3-credentials.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=ede402708d4df0babb107efc2d31cfb6)

Şekil 3 — 1. adım. Kırmızı yıldızlı tüm alanlar zorunludur; Account Country Code, hesabınızın ülkesine göre önceden doldurulur.

### 2. adım: Settings

İkinci adım, bağlantının kimlik doğrulamasıyla değil, *OTO’nun* bu bağlantıyı nasıl kullanacağıyla ilgilidir.

| Ayar | Ne yapar? |
| - | - |
| **Connection Name** | Sizin belirlediğiniz bir ad. Aynı kargo şirketine birden fazla bağlantıyı yönetilebilir kılan budur; otomasyon kurallarında, kargo seçenekleri listesinde ve raporlarda göreceğiniz ad bu olur. |
| **Service Type** | Bu bağlantının kargo şirketinin hangi hizmetini temsil ettiği: Express, Regular, Same Day vb. |
| **Active** | Bağlantıyı, kapsama alanını, SLA’larını ve geçmişini silmeden açıp kapatır. |
| **Return Available** | Bu bağlantının iade gönderileri için kullanılıp kullanılamayacağı. |
| **Do not send SMS** | Kargo şirketinin kendi takip mesajlarını kapatır. Müşteriyi zaten kendi [bildirimlerinizle](https://docs.tryoto.com/tr/modules/customer-notification/overview.md) bilgilendiriyorsanız kullanın; böylece müşteri aynı koli için iki kez mesaj almaz. |

Geri kalan ayarlar **Advanced Settings** altındadır: Bu kargo şirketinin faturalamada kullandığı hacimsel ağırlık (desi) böleni ve bir markanın kolilerinin yalnızca kendi hesabıyla gönderilmesini sağlayan marka kısıtlaması bunlar arasındadır.

![Settings adımı](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/carrier-4-settings.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=242b798af541b3bb641c681f803276ca)

Şekil 4 — 2. adım. Buradaki Save bağlantıyı oluşturur; bağlantı ardından kendi ayar menüsüyle Connected sekmesinde görünür.

## Özellikler

Bu işlevde 6 özellik bulunur.

### Kendi kargo hesaplarınızı bağlama

Kargo şirketleriyle zaten anlaşma yapmış işletmeler bu ilişkileri korur. Hesap bilgilerini eklediğinizde OTO, gönderileri sizin sözleşmeniz üzerinden, sizin fiyatlarınızla ve sizin hesap numaranızla oluşturur.

OTO, **dünya genelinde 460’tan fazla kargo şirketiyle** entegredir ve bunların her birini kendi sözleşmenizle bağlayabilirsiniz. **15’ten fazlası** OTO fiyatlarıyla da kullanılabilir; bunun için sözleşme gerekmez. Üründeki katalog yalnızca ülkenizde kullanılabilen iş ortaklarını listeler; bu yüzden orada gördüğünüz sayı global rakamdan küçüktür.

### Kargo şirketinin her hizmeti için ayrı bağlantı

Bir kargo şirketi genellikle birden fazla hizmet sunar: standart, ekspres, aynı gün, soğuk zincir, ağır ve hacimli, PUDO. Her biri kendi **Connection Name** ve **Service Type** değerleriyle ayrı bir bağlantı olur. Yani her birinin kendi kapsama alanı, kendi SLA’sı ve kendi günlük kapasitesi vardır ve otomasyon tarafından bağımsız olarak seçilir.

Bu olmasaydı “Aramex” tek ve ayrıştırılamayan bir seçenek olurdu; hiçbir kural bir şehirde ekspres hizmetini, başka bir şehirde standart hizmetini tercih edemezdi.

### OTO’nun anlaşmalı fiyatları

Kendi sözleşmesi olmayan ya da iyi bir sözleşme alacak hacme sahip olmayan işletmeler, OTO’nun önceden pazarlık ettiği fiyatlarla ve ek indirimlerle gönderim yapabilir. İmzalanacak bir şey ya da kargo şirketinde açılacak bir hesap yoktur: Bağlantı oluşturulduğu anda fiyat kullanılabilir.

İki model bir arada çalışır. Bir işletme bir kargo şirketiyle kendi sözleşmesini kullanıp başka bir kargo şirketinde OTO fiyatlarını kullanabilir; otomasyon ikisini birlikte karşılaştırır.

### Sözleşme fiyatları ve görünür kargo maliyeti

Sözleşmenizdeki fiyatları girmek iki işe yarar. Birincisi, her kargo şirketinin maliyetini aralarında seçim yaptığınız anda görmenizi sağlar; faturada fark etmek zorunda kalmazsınız. İkincisi, [mutabakata](https://docs.tryoto.com/tr/modules/shipping-management/shipping-invoices-reconciliation.md) kargo şirketinin faturasını karşılaştıracağı beklenen bir tutar verir.

Kendi sözleşmenizle gönderim yapmak, gönderi oluştururken açıkça seçilen bir tercihtir: **Create Shipment → With My Rates**, iadeler için de **Create Reverse Shipment With My Rates**.

> [!NOTE]
>
> **İadeler tek tek oluşturulur**
>
> Kendi fiyatlarınızla oluşturulan iade gönderileri tek tek oluşturulmalıdır; bunlar için toplu oluşturma yoktur.

### Kargo şirketi bazında teslim alma, teslimat ve iade SLA’ları

SLA, kargo şirketinin taahhüt ettiği süreyi kaydeder. Böylece OTO kargo şirketini bu taahhüde göre ölçebilir, otomasyon da gerçekten daha hızlı olanı tercih edebilir. SLA’yı bağlı iş ortağının **⋯** menüsündeki **SLA Configurations** altından ayarlayın. Bu da iki adımlı bir sihirbazdır: Önce **SLA Method**’u seçer, ardından **SLA Configuration Details** alanlarını doldurursunuz.

Bir taahhüt her zaman aynı biçimde ifade edilmediği için altı yöntem vardır:

| SLA yöntemi | Ne zaman kullanılır? |
| - | - |
| **City Based** | Yurt içi ekspres gönderilerde yaygın olan durum: her varış şehri için ayrı bir taahhüt. |
| **District Based** | Şehirden daha ayrıntılıdır; bir şehrin ilçeleri arasında belirgin farklar olan pazarlar için. |
| **KM-Range Based** | Mesafe aralıkları. Aralıklar tam sayı olmalı ve çakışmamalıdır. |
| **Tier Based** | Sizin adlandırdığınız coğrafi bölgeler yerine kargo şirketinin tanımladığı bölgeler. |
| **Distance based (hourly)** | Hızlı Teslimat (Bullet) için: taahhüdün günle değil saatle ölçüldüğü, talebe bağlı teslimat. |
| **Country Based** | Birimin varış ülkesi olduğu uluslararası gönderiler. |

Hangi yöntemi seçerseniz seçin, her satır **üç** ayrı taahhüdü kaydeder: **Pickup SLA**, **Delivery SLA** ve **Return SLA**. Her biri bir en az ve bir en çok değerle girilir; böylece müşteriye tek ve iyimser bir rakam yerine bir aralık gösterilebilir. **Upload Data** tablonun tamamını tek seferde içe aktarır; ulusal bir kargo şirketinin şehir listesi elle yazılmadan bu şekilde ayarlanır.

![SLA Configurations](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/carrier-5-sla-config.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=f930f2b569c7d5aeaf081c77cf7a4feb)

Şekil 5 — Mesafeye dayalı bir yapılandırma. Her sütun filtrelenebilir ve her SLA bir Min ve bir Max değeri alır.

### Kapsama alanı ve günlük kapasite

Her ikisi de bağlı iş ortağının menüsünden açılan **City Coverage** ekranındadır.

Yeni bir bağlantıda, kargo şirketinin hizmet verdiği tüm şehirler **Default Covered** olarak listelenir. Bu, sizin değil kargo şirketinin kapsama alanıdır; sözleşmeniz daha dar olabilir. Yalnızca gerçekten gönderim yaptığınız şehirleri etkinleştirin. Etkinleştirilmeyen her şehir **Passive** sayılır ve otomatik gönderi oluşturmaya dahil edilmez. **Tools** menüsü bunu toplu olarak yapar; ülke ve durum filtreleri de birkaç yüz şehirlik bir listeyi yönetilebilir tutar.

![City Coverage](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/carrier-6-city-coverage.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=b8f0d671d63296836adf6599f79b715d)

Şekil 6 — Kapsama alanı ve kapasite aynı ekranda. Default Covered, kargo şirketinin o şehre hizmet verdiğini, sizin ise henüz verip vermediğinizi belirtmediğinizi gösterir.

**Daily Capacity** aynı tablodaki bir sütundur ve satırın **⋯** menüsünden şehir bazında ayarlanır. O şehrin bir günde kaç gönderi alacağını sınırlar; sınıra ulaşıldığında o şehir için ertesi güne kadar otomatik gönderi oluşturulmaz. Sınır istemiyorsanız boş bırakın.

![Bir şehir için günlük kapasiteyi ayarlamak](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/carrier-7-daily-capacity.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=abb679f9921a4ef2d1c76567b87b6000)

Şekil 7 — Şehir bazında kapasite penceresi. Şehir sabittir; yalnızca sayı düzenlenebilir.

> [!WARNING]
>
> **Yalnızca otomatik gönderiler**
>
> Kapsama alanı ve kapasite yalnızca *otomatik* gönderi oluşturmayı sınırlar. Elle oluşturulan bir gönderiyi ikisi de engellemez; yani kapasite sınırı bir zorlama mekanizması değil, bir planlama aracıdır.

## Sınırlar ve ön koşullar

| Gereksinim | Ayrıntı |
| - | - |
| **Plan sınırları** | Ücretsiz Plan bir, Eko Plan üç kargo iş ortağına izin verir; Profesyonel Plan’da sınır yoktur. |
| **Hesap bakiyesi** | OTO fiyatlarıyla gönderim için hesabınızda yeterli bakiye olması gerekir. |
| **Bir depo** | Gönderi oluşturabilmek için en az bir lokasyon tanımlı olmalıdır. |
| **KM aralıkları** | Yalnızca tam sayı olabilir ve aralıklar çakışmamalıdır. |
| **Kapsama alanının etkisi** | Kapsama alanı ve kapasite yalnızca otomatik oluşturmada geçerlidir. |
| **Toplu iade gönderileri** | Kendi fiyatlarınızla kullanılamaz; tek tek oluşturun. |

## İlgili sayfalar

* [Kargo OTOmasyonu](https://docs.tryoto.com/tr/modules/shipping-management/shipping-automation.md): kargo şirketi seçmek için burada ayarlanan her şeyi kullanır.
* [Kargo fatura mutabakatı](https://docs.tryoto.com/tr/modules/shipping-management/shipping-invoices-reconciliation.md): kargo faturalarını burada girilen sözleşme fiyatlarıyla karşılaştırır.
* [Sipariş hazırlama](https://docs.tryoto.com/tr/modules/omnichannel-oms/order-fulfillment.md): teslimat zaman aralıklarının bağlı her iş ortağı için ayarlandığı yer.
* [OTO FLEX](https://docs.tryoto.com/tr/modules/oto-flex/overview.md): ayrı ayarlanan ama aynı kurallarda yarışan kendi filonuz.


## Related topics

- [Kargo OTOmasyonu ve kargo şirketi seçim kuralları](https://docs.tryoto.com/tr/modules/shipping-management/shipping-automation.md)
- [Kargo şirketi entegrasyonları](https://docs.tryoto.com/tr/integrations/carriers.md)
- [Kargo Yönetimi](https://docs.tryoto.com/tr/modules/shipping-management/overview.md)


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