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

# ERP entegrasyonları

> ERP’nizi OTO’ya bağlayın: hangi verinin hangi sisteme ait olduğunu, neyin aktarılacağını, önemli tanımlayıcıları ve entegrasyonun nasıl kurulacağını belirleyin.

ERP genellikle bir işletmenin neye sahip olduğunun ve neyi borçlu olduğunun ana kayıt sistemidir. OTO ise hareket hâlindeki her şeyin ana kayıt sistemidir. İkisini entegre etmek, büyük ölçüde birinin nerede bittiği konusunda anlaşmaktır.

## Sınırı çizmek

Ters giden entegrasyonlar, iki sistemin de aynı bilginin sahibi olduğuna inandığı entegrasyonlardır. İşe yarayanlar ise bir sınır çizer ve o sınıra sadık kalır.

| ERP’nin sahip olduğu | OTO’nun sahip olduğu |
| - | - |
| Ürün ana verisi: ne var, adı ne, maliyeti ne | Her birimin fiziksel olarak nerede olduğu ve bir sipariş için nelerin rezerve edildiği |
| Finansal kayıtlar, faturalar, vergi | Gönderi kayıtları, kargo şirketi ücretleri, teslimat kanıtı |
| Satınalma ve tedarikçi ilişkileri | Bir satınalma siparişine karşılık gelen ürün kabulü |
| Muhasebe kaydı olarak müşteri | Teslimat adresi ve telefon numarası olarak müşteri |

> [!WARNING]
>
> **Stokun sahibinin kim olduğuna karar verin ve bu kararın arkasında durun**
>
> Entegrasyonun sakin mi yoksa sürekli tartışmalı mı olacağını belirleyen karar budur. Stokun sahibi ERP ise OTO hareketleri bildirir, ERP mutabakatı yapar. Stokun sahibi OTO ise ERP hareketleri alır ve bunların üzerine yazmaz.
>
> İşe yaramayan şey, aynı lokasyondaki aynı SKU için iki sistemin de stok seviyesi yazmasıdır. Belirtisi, kimsenin açıklayamadığı bir düzende birbirini tutmayan rakamlardır; üstelik üç aylık bir geçmiş biriktikten sonra bunu çözmek çok zordur.

## Sınırı neler geçer?

| Akış | Yön | Uç noktalar |
| - | - | - |
| **Ürünler** | ERP → OTO | `createProduct`, `productList` |
| **Stok seviyeleri** | Yukarıdaki karara göre her iki yön de olabilir | `updateStockQuantity`, `checkInventoryStock`, `checkGlobalStock` |
| **Siparişler** | ERP → OTO | `createOrder`, `updateOrder` |
| **Sipariş hazırlama olayları** | OTO → ERP | [Webhook’lar](https://docs.tryoto.com/tr/integrations/webhooks.md): `orderStatus`, `shipmentError` |
| **Kargo maliyetleri** | OTO → ERP | `shipmentTransactions`, `getShippingPriceTransactionsList` |
| **Gelen ürünler ve transferler** | ERP → OTO | `createInventoryOrder` |

Stok Yönetimi uç noktaları WMS eklentisini gerektirir. Plana göre kullanılabilirlik [uç nokta dizininde](https://docs.tryoto.com/tr/developers/rest-api-reference.md) yer alır.

## Önemli olan iki tanımlayıcı

| | |
| - | - |
| **SKU** | Ürünle ilgili her şeyin bağlantı noktası. ERP ile OTO bir SKU konusunda anlaşamıyorsa stok ve siparişler aynı anda bozulur. |
| **Hub kodu** | Lokasyonla ilgili her şeyin bağlantı noktası. ERP’nizdeki tesisler ve lokasyonlar bu kodla OTO [hub’larına](https://docs.tryoto.com/tr/modules/hubs-management/overview.md) eşlenir. |

> [!TIP]
>
> **İlk hub oluşturulmadan önce ERP’nin sahibiyle on dakika**
>
> Hub kodlarına ve SKU’lara karar vermek ücretsizdir, değiştirmek ise pahalıdır; çünkü her entegrasyon, her içe aktarma dosyası ve her geçmiş kayıt bunları anahtar olarak kullanır.
>
> Alternatifi, altı ay sonra yapılan bir yeniden adlandırma çalışması ve arada birinin elle tuttuğu bir eşleştirme tablosudur.

## Bir ERP bağlantısının kurulmasının üç yolu

[Satış kanallarının](https://docs.tryoto.com/tr/integrations/sales-channels.md) aksine ERP bağlantıları self servis bir katalog değildir. Üç yol vardır ve kurumsal müşterilerin çoğu gerçekte üçüncüsünü seçer.

| Yol | Nasıl işler? | Kimler için uygun? |
| - | - | - |
| **Siz geliştirirsiniz** | Geliştiricileriniz kendi hızınızda [REST API](https://docs.tryoto.com/tr/developers/overview.md) ve [webhook’lar](https://docs.tryoto.com/tr/integrations/webhooks.md) üzerinde çalışır. | Şirket içi geliştiricileri ve iyi bilinen bir ERP’si olan ekipler. |
| **ERP iş ortağınız geliştirir** | ERP’nizin bakımını zaten yapan entegratör, sistemi OTO’yu çağıracak şekilde genişletir. | ERP’si üçüncü bir tarafta yönetilen işletmeler. |
| **OTO sizin için geliştirir** | Kendi sisteminizin uç noktalarını ve iş kurallarını siz sağlarsınız; OTO bunlara karşı hesabınıza özel bir bağlayıcı geliştirir. | Kurumsal müşteriler, size özel ya da şirket içi sistemler ve alışılmadık gereksinimleri olan her şey. |

### OTO’nun geliştirdiği özel entegrasyonlar

Bir sistemin hazır bağlayıcısı olmadığında (şirket içi bir ERP, size özel bir WMS, başka kimsenin kullanmadığı sektörel bir paket) OTO, size bir API verip “kolay gelsin” demek yerine entegrasyonu kendisi geliştirebilir.

Yapı basittir: **siz uç noktaları açarsınız, OTO bunlara entegre olur.** Bağlayıcı hesabınız için, iş gereksinimlerinize göre geliştirilir ve bitip zamanla eskiyen bir proje olarak değil, kurulumunuzun bir parçası olarak bakımı yapılır.

| OTO’nun sizden ihtiyaç duyduğu | Neden? |
| - | - |
| **Uç nokta dokümantasyonu** | Sisteminizin sunduğu çağrılar, istek ve yanıt yapılarıyla birlikte. |
| **Kimlik doğrulama** | Bağlayıcının kendini nasıl tanıtacağı ve canlı olmayan bir ortam için kimlik bilgileri. |
| **Bir test ortamı** | Canlı ERP’niz olmayan, üzerinde geliştirme yapılabilecek bir ortam. |
| **Alan eşleştirmesi** | Alanlarınızdan hangisinin SKU, hangisinin lokasyon kodu olduğu ve durumlarınızın OTO’nun durumlarına nasıl karşılık geldiği. |
| **İş kuralları** | Stokun sahibinin kim olduğu, bir siparişin ne zaman kesinleşmiş sayıldığı, kısmi sipariş hazırlamada ne olduğu, iadelerin nasıl geri kaydedildiği. |

> [!TIP]
>
> **Zamanı uzatan kod değil, iş kurallarıdır**
>
> Dokümante edilmiş bir uç noktaya karşı bağlayıcı yazmak rutin bir iştir. Zaman alan, bunun altındaki kararlardır ve bunlar işletmenizle ilgili kararlar olduğu için yalnızca siz verebilirsiniz.
>
> Bu soruları önceden yanıtlanmış olarak getirmek, bir entegrasyonu kısaltan en büyük etkendir: stokun sahibi kim, kısmi sipariş hazırlama muhasebenizde ne anlama geliyor ve bir sipariş verildiğinde mi yoksa toplandığında mı kesinleşiyor? Bunları netleştirerek gelen ekipler, geliştirme sırasında keşfeden ekiplerin harcadığı sürenin çok küçük bir kısmında entegre olur.

> [!NOTE]
>
> **Bu, her iki yönde de işler**
>
> Aynı yaklaşım, OTO’ya veri *göndermesi* gereken sistemleri (sipariş oluşturan bir ERP, stok bildiren bir POS) ve OTO’dan veri *alması* gereken sistemleri (kargo maliyetlerini alan bir finans sistemi, sipariş hazırlama olaylarını alan bir BI veri ambarı) kapsar.
>
> Ayrıca yalnızca ERP ile sınırlı değildir. [POS](https://docs.tryoto.com/tr/integrations/pos-systems.md), WMS, şirket içi sipariş yöneticileri ve size özel iç araçların hepsi aynı şekilde bağlanır.

Özel entegrasyonların kapsamı ticari olarak belirlenir. Hesap sorumlunuzla görüşün ya da sistemi ve bu sistemle OTO arasında neyi aktarmanız gerektiğini anlatan bir e-postayı [support@tryoto.com](mailto:support@tryoto.com) adresine gönderin.

## Görüşmeye hazırlıklı gelmek

Değerlendirme aşamasındaysanız, getirmeniz gereken faydalı soru “X ile entegre oluyor musunuz?” değil, “stokun sahibi şu sistem, lokasyon kodlarımız bunlar, SKU kuralımız bu ve ERP’miz şunları sunuyor” olmalıdır. Bu görüşme kısa sürer. Diğeri sürmez.

## İlgili sayfalar

* [Geliştiriciler](https://docs.tryoto.com/tr/developers/overview.md): kimlik doğrulama ve API’nin kapsamı.
* [Stok Senkronizasyonu](https://docs.tryoto.com/tr/modules/inventory-management/inventory-sync.md): stokun nasıl hesaplandığı ve gönderildiği.
* [Hub Yönetimi](https://docs.tryoto.com/tr/modules/hubs-management/overview.md): hub kodları.
* [POS sistemleri](https://docs.tryoto.com/tr/integrations/pos-systems.md): mağaza tarafındaki karşılığı.


## Related topics

- [POS entegrasyonları](https://docs.tryoto.com/tr/integrations/pos-systems.md)
- [Pazaryeri entegrasyonları](https://docs.tryoto.com/tr/integrations/marketplaces.md)
- [Satış kanalı entegrasyonları](https://docs.tryoto.com/tr/integrations/sales-channels.md)


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