Giriş
Gelişmiş Entegre Görünürlük Gönderi Takip Numarası Aboneliği, Gelişmiş Entegre Görünürlük abonelerinin gönderi takip numarası tabanlı web kancası projelerini yönetmeleri ve API uç noktalarını kullanarak yeni gönderi takip numaraları ekleme, iş ayrıntılarını düzenleme veya görüntüleme gibi projeyle ilgili işlemleri gerçekleştirmeleri için tasarlanmıştır.
Not:
- Gelişmiş Entegre Görünürlük projeniz için yönetici veya katılımcı erişimine sahip olmanız gereklidir
- Gelişmiş Entegre Görünürlük ve özellikleri ile ilgili daha fazla bilgi edinmek için Gelişmiş Entegre Görünürlük belgeleri sayfasını ziyaret edin.
Gelişmiş Entegre Görünürlük Takip Numarası Aboneliğinin Avantajları
Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği size aşağıdaki avantajları sağlar:
- Gelişmiş Entegre Görünürlük projenizin takip numaralarını API uç noktalarını kullanarak kolayca güncelleyebilir ve yönetebilirsiniz.
- Bu API, her takip numarasını tek tek ilişkilendirmek yerine tek bir API işlemiyle projenize birden fazla takip numarası ilişkilendirmenize olanak sağlar.
- API isteklerini art arda gönderebilir ve bu isteklerin başarılı/başarısız olduğuna ilişkin günlük kaydı ayrıntılarını görüntüleyebilirsiniz.
Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği Nasıl Çalışır?
Gelişmiş Entegre Görünürlük projenizi yönetmek için aşağıdaki uç noktaları kullanın:
Bu API'ye yalnızca yukarıdaki ekran görüntüsünde de gösterildiği gibi projenize ait genel bakış üzerinden erişilebilir.
Takip Numarası İlişkisi
Bir veya birden fazla takip numarasını belirli bir Gelişmiş Entegre Görünürlük projesiyle ilişkilendirmek amacıyla asenkron bir işi tetiklemek için bu uç noktayı kullanın.
Bu istek için gerekli olan bilgi girişleri şöyledir:
- Eylem – İsteği gönderdiğinizde gerçekleştirilecek eylemi belirtin. Örnek: ADD
- Takip numarası ayrıntıları – Takip numarasını belirtin
Tek bir istekte en fazla 1000 adet takip numarası ilişkilendirebilirsiniz. Bu isteğe verilen başarılı yanıt ile iş kimliği, güncel iş durumu, iş oluşturma ve iş tamamlama zaman damgası bilgileri sunulacaktır. Bu iş kimliği daha sonra asenkron işin durumunu kontrol etmek için kullanılabilir.
Takip Numarası İş Durumu
Bu uç noktayı, asenkron bir işin (sırayla bir veya daha fazla ardışık istek) veya gönderilen tüm işlerin durumunu görmek için kullanın.
Bu istek için gerekli olan bilgi girişleri şöyledir:
- İş Kimliği – Durum bilgisini almak istediğiniz iş kimliğini belirtin.
Not: İş Kimliği bu uç nokta için isteğe bağlı bir giriştir. İş Kimliğini belirtmezseniz gönderilen tüm işlerin durumuna ilişkin bilgileri alırsınız.
Bu isteğe verilen başarılı yanıt ile iş kimliği, güncel iş durumu, iş oluşturma ve iş tamamlama zaman damgası bilgileri sunulacaktır. Yanıtta, işlerin güncel durumu gösterilecektir. Yanıtta ayrıca, kullanıcıların görüntüleyebilmesi ve gerektiğinde sorunları giderebilmesi için başarı mesajları, hatalar veya uyarılar da yer alacaktır.
- İş durumunun TAMAMLANDI olarak görüntülenmesi, tüm takip numaralarının doğrulandığı ve başarıyla işlendiği anlamına gelir.
- TAMAMLANDI durumu, takip numaralarının doğrulandığını ve başarıyla işlendiğini ifade eder. Bu, tüm takip numaralarının Gelişmiş Entegre Görünürlük projesine başarıyla eklendiği anlamına gelmez.
- Birden fazla takip numarasını ilişkilendirmeye çalışırsanız ve bunlardan yalnızca bazıları ilişkilendirilir ve geri kalanları ilişkilendirilemezse iş durumu yine de TAMAMLANDI olarak güncellenir. Ortak talepteki her bir takip numarasının durumunu teyit etmek için toplu raporun indirilmesi gereklidir.
- İş durumunun BAŞARISIZ olarak görüntülenmesi, çeşitli nedenlerden/hatalardan dolayı isteğin işlenemediği ve kullanıcının tekrar denemesi gerektiği anlamına gelir.
Not:
Durumlar ve bunların açıklamaları aşağıda verilmiştir:
| İŞ DURUMU | AÇIKLAMA |
|---|---|
GÖNDERİLDİ |
Tüm temel doğrulamalar yapıldıktan sonra iş sisteme gönderilmiştir ve asenkron olarak işlenecektir. |
KABUL EDİLDİ |
İş kabul edilmiştir ve sıraya alınacaktır. |
KABUL EDİLMEDİ |
Dahili bir arıza olması veya sistemin kullanılamaması nedeniyle iş kabul edilmemiştir, kullanıcının yeniden denemesi gereklidir. |
SIRAYA ALINDI |
İş işlenmek üzere sıraya alınmıştır ve işleme herhangi bir zamanda başlayacaktır. |
İŞLENİYOR |
İş başlatılmıştır ve devam eder durumundadır. |
TAMAMLANDI |
İş tamamlanmıştır ve içe aktarım raporu veya dışa aktarım dosyası kullanıcı tarafından indirilebilir. |
BAŞARISIZ |
Çeşitli nedenlerden dolayı iş başarısız olmuştur ve kullanıcının tekrar denemesi gereklidir. |
Takip Numarası İş Ayrıntıları
TAMAMLANDI durumunda olan asenkron bir işe ilişkin JSON raporunu indirmek için bu uç noktayı kullanın.
Bu istekle ilişkili gerekli girdi bilgileri aşağıdaki gibidir:
- İş Kimliği – Durum bilgisini almak istediğiniz iş kimliğini belirtin.
Not:
- İş Kimliği bu uç nokta için zorunlu bir giriştir.
- Aynı anda yalnızca tek bir asenkron işin raporunu indirebilirsiniz.
- İş TAMAMLANMADIYSA ve raporu indirmeye çalışıyorsanız bir hata mesajı görüntülenir.
Bu isteğe gelen başarılı yanıt, işe ilişkin raporu size JSON biçiminde sağlar.
İş Kuralları
- Her bir istekte, Gelişmiş Entegre Görünürlük projesiyle en fazla 1000 adet kargo takip numarası ilişkilendirilebilir.
- Belirli bir Gelişmiş Entegre Görünürlük projesiyle ilişkilendirebileceğiniz maksimum takip numarası sayısı için herhangi bir sınırlama yoktur.
- Belirli bir Gelişmiş Entegre Görünürlük projesiyle ilişkilendirilmiş olan herhangi bir takip numarası 40 gün sonra kaldırılacaktır.
- Belirli bir Gelişmiş Entegre Görünürlük projesi için oluşturulmuş olan herhangi bir İş Kimliği durumu ve ayrıntısı 90 günlük süre geçtikten sonra kullanılamaz hale gelecektir.
- Alıcı adresi, alıcı imzası gibi güvenli takip bilgileri Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği aracılığıyla kullanılamaz.
