Nakliyat verinizi CRM'e aktarma: API ve CSV

Hangi veri nereden alınır?

Her araç yalnız anahtarınıza verdiğiniz kapsamların verisini döndürür; kapsam dışındaki bir alan yanıta hiç girmez.

• Talepler (requests_list, request_get — "Talepleri oku" kapsamı): durum, kanal, müşteri adı ve çıkış şehri. Sonuçlar sayfalı gelir; bir sayfada en çok 50 kayıt.
• Müşteri iletişim bilgisi ("Müşteri iletişim bilgisi" kapsamı): telefon, e-posta ve tam adres yalnız bu kapsam verilmiş anahtarla talep yanıtına eklenir.
• Teklifler (quotes_list — "Teklifleri oku" kapsamı): teklifin durumu, nihai fiyatı (TRY, USD, EUR ya da GBP; firmanız hangisiyle çalışıyorsa o birimde, çevrilmeden), toplam hacim (m³) ve mesafe (km). Maliyet dökümü ve kâr marjı paylaşılmaz.
• Envanter (iş başına CSV): eşya, oda, adet, ölçüler, hacim, ağırlık ve onay durumu; talep sayfasındaki "Envanter (CSV)" bağlantısından.

API anahtarı nasıl oluşturulur?

Anahtar kişiseldir: onu oluşturan kullanıcının yetkileriyle çalışır ve her kullanıcı aynı anda en çok 10 etkin anahtar tutabilir.

Anahtar, aktif paketi olan her firmada çalışır; ekipten ayrılan kullanıcının anahtarları kendiliğinden iptal edilir.

• Panelde Bağlantılar sayfasını açın ve "YZ asistanları" kartındaki "Yeni anahtar oluştur" bölümüne gelin.
• Yalnız gerekeni seçin: CRM aktarımı için genellikle "Talepleri oku", "Teklifleri oku" ve gerekiyorsa "Müşteri iletişim bilgisi".
• Süreyi seçin: 30, 90, 180 ya da 365 gün (varsayılan 90). Bitişe 7 gün kala kart sizi uyarır.
• "Anahtar oluştur"a basın ve anahtarı hemen kopyalayın: güvenliğiniz için bir daha gösterilmez. Otomasyon aracınızın gizli değer alanına saklayın; e-postaya ya da paylaşılan bir belgeye yazmayın.

Örnek: açık talepleri çekmek

Her araç tek bir uçtan çağrılır: POST /api/v1/tools/<araç adı>. Gövde aracın girdisidir; anahtar Authorization başlığında gider. Aşağıdaki istek açık (kapanmamış) talepleri en yeniden başlayarak 50'şerli sayfalarla getirir:

curl -X POST https://loduvo.com/api/v1/tools/requests_list \
  -H "Authorization: Bearer $LODUVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"active","limit":50,"page":1}'

Yanıt {"ok": true, "data": …} biçimindedir; hata hâlinde "ok": false ve bir hata kodu döner. Anahtarınızın gerçekten çağırabildiği araçları ve girdilerinin şemasını GET /api/v1/tools listeler. İstekler hız sınırına tabidir; sınırı aşan istek 429 ve ne kadar bekleneceğini bildiren bir yanıt alır.

Envanter CSV olarak

Bir işin eşya listesini CRM kaydına ya da muhasebenize eklemek için talep sayfasındaki "Envanter (CSV)" bağlantısını kullanın. Dosya panelin dilinde açılır: Türkçe panelde Türkçe başlıklarla, Excel'in beklediği ayraç ve ondalık işaretiyle.

• Sütunlar: kod, eşya, oda, adet, uzunluk, genişlik, yükseklik (cm), hacim (m³), ağırlık (kg), kırılabilir, özel taşıma, onay durumu ve not.
• CSV dışa aktarımı Büyüme ve üstü paketlerde vardır.
• Her indirme envanteri o anki hâliyle verir; sonradan yapılan düzeltmeler için yeniden indirin.

Düzenli aktarım nasıl kurulur?

HTTP isteği gönderebilen herhangi bir otomasyon aracı ya da kendi küçük betiğiniz, requests_list'i belirli aralıklarla çağırıp yeni ya da değişen kayıtları CRM'inize yazabilir. Loduvo değişiklikleri kendisi göndermez; aralığı işinizin hızına göre seçin ve aynı kaydı iki kez yazmamak için talebin kimliğini (id) CRM'deki kayıtla eşleştirin.