Kalem satırındaki alanlar
| Alan | Anlamı |
|---|---|
| orderId | Sipariş numarası |
| orderItemId | Kalem numarası |
| orderCreateDate, orderCreateTime | Sipariş tarihi (GG/AA/YYYY) ve saati |
| orderModifyDate, orderModifyTime | Son değişiklik tarihi ve saati |
| productId, productCode, code, name | Ürün kimlikleri ve adı |
| barcode | Ürün barkodu; boş gelebilir |
| quantity | Adet |
| totalPrice, tax | Kalem tutarı ve vergi |
| orderItemStatusId, orderProductStatus | Durum numarası ve durum metni |
| isOrderStatusActive | Kalemin aktif olup olmadığı |
| receiverName, receiverPhone, receiverAddress | Alıcının adı soyadı, telefonu, adresi |
| cargoCompany, cargoNumber, shipmentTrackingUrl, partialNumber | Kargo bilgileri |
| cardMessage, cardName | Hediye kartı mesajı ve gönderen adı |
| branchId, customerId | Şube ve müşteri numarası |
Bazı yanıtlarda receiverCity, receiverDistrict, zipCode ve invoiceEmail alanları da görüldü; posta kodu çoğunlukla boş geliyor.
Satırları siparişe çevirmek
Ana siparişin birden fazla alt siparişi olduğunda aynı orderId birden fazla satırda görünür. Doğru sipariş görünümü için:
- Satırları orderId ile gruplayın; alıcı ve adres bilgisini ilk satırdan alın.
- Sipariş toplamını, satırlardaki totalPrice değerlerini toplayarak bulun.
- Kalem sayısını satır sayısından, toplam adedi quantity alanlarından hesaplayın.
- Barkod boş gelen satırlarda ürünü code alanından tanıyın.
Bu gruplama yapılmazsa iki kalemli bir sipariş iki ayrı sipariş gibi görünür ve stok iki kez düşülebilir.
Tarih, ad ve hediye notu
- Tarih: orderCreateDate GG/AA/YYYY biçimindedir. Birçok programlama dili bu metni ABD sırasıyla (ay/gün) okur; ayın 12'sinden büyük günlerde geçersiz tarih, diğer günlerde sessizce yanlış tarih üretir. Tarihi parçalara ayırıp kendiniz oluşturun.
- Ad soyad: receiverName tek alanda ad ve soyadı birlikte verir. Fatura için ayrı alan gerekiyorsa son boşluktan bölüp kullanıcıya düzeltme imkânı bırakın.
- Hediye notu: Çiçeksepeti siparişleri çoğunlukla hediye olarak verilir. cardMessage ve cardName doluysa paketlemede karta yazdırılması gereken mesajdır; hazırlık ekranında öne çıkarın.
Kişisel veri ve sık hatalar
Yanıt alıcının adını, telefonunu ve adresini açık metin taşır. Kayıtlarda ve hata günlüklerinde bu alanları maskeleyin; yalnız siparişi hazırlamak ve fatura kesmek için gereken süre boyunca saklayın.
- Kalemleri sipariş saymak: Sipariş sayısı şişer.
- Tarihi otomatik ayrıştırmak: Gün ve ay yer değiştirir.
- Hediye notunu atlamak: Müşteri deneyimi açısından en görünür hatadır.
- Durumu yalnız metinden okumak: İptalde durum metni değişmeyebilir; isOrderStatusActive alanına da bakın. Ayrıntı: sipariş akışı ve iptal.
Sık sorulanlar
Çiçeksepeti'de tek siparişin detayı nasıl alınır?
Sipariş listeleme yanıtındaki satırlar orderId ile gruplanır. Her satır bir kalemdir; alıcı, adres ve kargo bilgisi aynı siparişin satırlarında ortaktır.
Çiçeksepeti sipariş tutarı hangi alandan hesaplanır?
Her kalemdeki totalPrice alanından. Siparişin toplamı, aynı orderId'ye sahip satırların totalPrice değerlerinin toplamıdır; vergi tutarı tax alanında ayrıca gelir.
Hediye notu API'de nerede?
cardMessage alanında; gönderen adı cardName alanında gelir. Müşteri not yazmadıysa alanlar boş olabilir.
Sipariş tarihi neden yanlış görünüyor?
orderCreateDate GG/AA/YYYY biçimindedir. Otomatik tarih ayrıştırıcıları bunu ay/gün sırasıyla okuyabilir. Tarihi gün, ay ve yıl parçalarına ayırarak oluşturun.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı