Bir Operatör Toplu İşlem Rezervasyonunu Nihai Ücretiyle Mutabık Kılma
Ayrılmış bakiyeyi, tamamlanan sonuçları ve serbest bırakılan tutarı ayırın; diğer işlemler aynı cüzdanı paylaştığında oluşan farkları açıklayın.
Yerel bir mutabakat kaydı, bir operatör toplu işlemini dosyası, nihai sonuçları ve cüzdan gözlemleriyle, eş zamanlı harcamaları tahmin etmeye gerek kalmadan birbirine bağlar.
Operatör toplu işlem bakiye mutabakatı için, tahmini rezervasyonu nihai ücretten ve kullanılmayan rezervden ayırın. İşi hazırlanan dosyası ve tamamlanan sonuçlarıyla eşleştirin, ardından başka bir etkinliğin paylaşılan hesap bakiyesini etkileyip etkilemediğini kontrol edin.
Rezervasyonu devam eden çalışma olarak okuyun
Bir operatör dosyası gönderir, kullanılabilir bakiyenin düştüğünü görür ve daha sonra orijinal yüklemeden daha az satır içeren bir CSV alırsınız. İlk bakiye hareketi, tek başına işlemin nihai maliyetini size söylemez. Toplu gönderim, işlem gerçekleştirilirken tahmini bir tutarı rezerve eder.
CarrierLookup, sonuç döndüren numaraları ücretlendirir ve kullanılmayan rezervi aynı cüzdana iade eder. Hazırlık sırasında başarısız olan bir işlem, rezervasyonunu tam olarak iade eder. Bu rezerv mutabakatı, bir bakiye yüklemesini veya plan satın alımını tersine çevirmekten farklıdır.
Kendi kaydınızda üç değeri ayrı tutun: rezerve edilen tutar, nihai ücret ve serbest bırakılan tutar. Üçü de aynı işlem için mevcut olduğunda, beklenen ilişki rezervasyonun nihai ücret artı serbest bırakılan rezerve eşit olmasıdır. Bu denklemi çalıştırmak için, mevcut olmayan bir işlem düzeyi değerini tüm hesap bakiyesi farkıyla doldurmayın.
İşlem kaydını gönderilen dosyadan oluşturun
Daha sonra birinin düzenlemiş olabileceği bir elektronik tablonun güncel sürümüyle değil, gönderdiğiniz dosyanın tam haliyle başlayın. Bir dosya özeti (digest), seçilen ülke, carrier_batch hizmet türü, işlem kimliği ve gönderim zamanını kaydedin. İletişim bilgisi içeren dosyaları kısıtlı depolama alanında tutun ve çalışma sayfanızda bunlara referanslar kullanın.
Toplu hazırlık; geçersiz satırları, kopyaları, ülke kodu olmayan numaraları ve seçilen ülke dışındaki numaraları hariç tutar. Hariç tutulan satırlar ücretlendirilmez. Yerel hazırlık raporunuz bazı hariç tutmaları açıklayabilir, ancak tahmininizi hizmet tarafından fiilen bildirilen sayılardan ayırın.
| Yerel çalışma sayfası alanı | Bağlantı kurduğu şey |
|---|---|
| İşlem kimliği ve hizmet türü | Tüm hesap çalışmaları yerine tek bir operatör dosya işlemi |
| Kaynak dosya özeti ve satır sayısı | Tam yükleme sürümü |
| Ülke ve hazırlık notları | Hedeflenen numara kümesi ve yerel hariç tutmalar |
| Gönderim ve durum zaman damgaları | Rezervin tutulduğu dönem |
| Rezervasyon kanıtı | Mevcut işlem veya hesap kayıtlarında gösteriliyorsa tutulan miktar |
| Sonuç dosyası, özet ve satır sayısı | Bu işlem için tamamlanmış çıktı |
| Nihai ücret ve serbest bırakma kanıtı | Mevcut olduğunda mutabakat değerleri |
| Diğer cüzdan etkinliği | Bakiye anlık görüntülerinin neden bu işlemi izole edemeyebileceği |
| Açıklanamayan fark | Görünür, çözülmemiş bir tutar; uydurulmuş bir düzeltme değil |
Bunlar çalışma sayfanızdaki alanlardır, vaat edilen bir sağlayıcı fatura defteri API'si değildir. Bir operatörün gözlemlenen bir rakamı bir hesaplamadan ayırt edebilmesi için her tutarın kaynağını koruyun.
Boşlukları başarısızlık olarak görmeden tamamlanan sonuçları sayın
Başarılı bir operatör işlemi; identifier, carrier, underlying_carrier, number_type, country_code, region ve city içeren bir CSV sağlar. Çıktı satırlarını hazırlanan girdiye bağlamak için tanımlayıcıları kullanın. Toplu CSV, eş zamanlı çoklu yanıtın exists alanına sahip değildir.
Boş bir operatör veya coğrafya değeri, değerin mevcut olmadığı anlamına gelir. Bu, satırın başarısız olduğu veya ücretsiz olması gerektiğine dair yeterli kanıt değildir. Tamamlanan operatör sonuçları, tahsis alanları boş olduğunda bile ücretlendirilebilir olabilir. Bir ücreti tahmin ederken alan tamlığını, tamamlanan sonuçların sayısından ayrı tutun.
Örneğin, yerel raporunuz bazı kopya girdi satırlarını ve boş şehir değerlerine sahip bazı tamamlanan çıktı satırlarını gösterebilir. Kopya girdi satırları ön işleme mutabakatına aittir. Boş şehirler ise sonuç kalitesi incelemesine aittir. Her iki grubu da faturalandırılabilir sayıdan çıkarmak, iki farklı soruyu birbirine karıştırır.
Tanımlayıcıları tutarlı bir şekilde sayın ve toplamları hesaplamadan önce kopya veya eksik çıktı eşlemelerini inceleyin. Mevcut işlem detayı, gönderilen bir tanımlayıcının neden eksik olduğunu açıklamıyorsa, farkı çözülmemiş olarak etiketleyin. Bir CSV satırının yokluğundan numara başına bir başarısızlık kodu uydurmayın. Bunu çözmek için işlem durumunu ve mevcut hizmet kanıtlarını kullanın.
Tek bir işlemi anlamak için sessiz bir cüzdan kullanın
İzole bir çalışmada, kontrolünüz altındaki diğer ücretli işleri duraklatın ve gönderimden hemen önceki bakiyeyi not edin. Rezervasyon gözlemini kaydedin, işlemin nihai durumunu bekleyin ve mutabık kalınan bakiyeyi, görüntülenen ücreti veya serbest bırakılan tutarı kaydedin. Gözlem dönemindeki yüklemeleri, plan değişikliklerini ve diğer tüm hesap hareketlerini dahil edin.
Gerçekten başka bir hareket yoksa, başlangıç ve mutabık kalınan bakiyeler arasındaki fark, işlemin net maliyetini doğrulayabilir. Bu sonucu, tamamlanan sayı ve CarrierLookup fiyatlandırmasında gösterilen geçerli fiyatla karşılaştırmak yine de faydalıdır. O sırada kullanılan fiyatı, daha sonraki bir fiyatla sessizce değiştirmek yerine koruyun.
GET /api/v1/balance, bir kontrol oluşturmadan veya sorgu için ücret almadan mevcut balance_micros değerini okur. Bu tam sayıyı doğrudan saklayın ve farklar için tam sayı aritmetiği kullanın; uygulamanızın sınırında bir görüntüleme tutarına dönüştürün. Bakiye anlık görüntüsü bir hesap gözlemidir, kalem kalem işlem dökümü değildir.
İşlem processing, success veya failed durumunda olabilir. Bir işlem durumu, yalnızca bir bakiye okuması değişmeden kaldığı için sonuçlanmış sayılmaz. İşlem durumunu 30 saniyeden daha sık sorgulamayın ve nihai durumu sonuç kaydıyla birlikte saklayın.
Eş zamanlı harcamaları dosyaya atamadan açıklayın
Gerçek zamanlı operatör kontrolleri ve asenkron hizmetler tek bir bakiyeyi paylaşır. Başka bir ekip toplu işleminiz çalışırken kontroller gerçekleştirirse, başlangıç bakiyesinden bitiş bakiyesinin çıkarılması bu çalışmayı da içerir. Başka bir toplu rezervasyon da dönem sonunda açık kalabilir, bu da kullanılabilir bakiyeyi nihai ücretler için zayıf bir gösterge haline getirir.
Çalışma sayfanızda, işleme atfedilen tutarları hesap genelindeki hareketlerden ayırın. Bilinen diğer ücretleri, kredileri ve ödenmemiş rezervleri elinizdeki kanıtları kullanarak mutabık kılın. Kalıntı atanamıyorsa, gözlem penceresiyle birlikte "atfedilemeyen paylaşılan cüzdan farkı" raporlayın. Bunu en son biten işleme eklemeyin.
Açıklanamayan bir fark için işlem kimliğini, hizmet türünü, zaman damgalarını, dosya özetini, hazırlanan sayıyı, nihai durumu, sonuç sayısını, bakiye gözlemlerini ve mevcut rezervasyon veya mutabakat detaylarını toplayın. Gerçek zamanlı çalışmaların veya diğer dosya işlemlerinin eş zamanlı çalışıp çalışmadığını belirtin. Uygun destek kanalı aracılığıyla yalnızca gerekli minimum iletişim verisini paylaşın; asla bir API anahtarı eklemeyin.
Bir sonraki operatör toplu işlemiyle başlayın: gönderimden önce girdi sürümünü ve işlem kimliğini bir arada tutun. Bu küçük adım, nihai CSV'yi, serbest bırakılan rezervi ve kalan tutarsızlıkları aynı iş parçasına izlenebilir kılar.
Daha Fazla Bilgi Edinin
İş akışınızdaki bir sonraki adıma uyan ürün bilgisini seçin.