Gelişmiş Entegre Görünürlük Web Kancası Türleri
Gelişmiş Entegre Görünürlük web kancası, belirli FedEx hesap numaralarıyla ilişkili gönderilere yönelik olarak neredeyse gerçek zamanlı güvenli takip olayı verilerinin FedEx tarafından bir hedef URL'ye gönderilmesini sağlar.
FedEx Developer Portal'da bir Gelişmiş Entegre Görünürlük web kancası projesi oluşturabilir ve ardından seçtiğiniz abonelik türüne bağlı olarak bunu bir veya daha fazla FedEx hesap numarası veya FedEx takip numarası ile ilişkilendirebilirsiniz.
Şuraya gidin:
İlgili Gelişmiş Entegre Görünürlük web kancasını oluşturmak için GELİŞMİŞ ENTEGRE GÖRÜNÜRLÜK HESAP NUMARASI ABONELİĞİ or GELİŞMİŞ ENTEGRE GÖRÜNÜRLÜK TAKİP NUMARASI ABONELİĞİ .
FedEx Gelişmiş Entegre Görünürlüğe Genel Bakış
Fotoğraflı Teslimat Kanıtı da dahil olmak üzere etiket oluşturma işleminden paketlerin Teslimat kanıtına kadar neredeyse gerçek zamanlı olarak taşıma sırasındaki gönderi olaylarını almak isteyen FedEx müşterileri, Hesap numarasına veya Takip numarasına abone olabilirler.
Abonelik Türleri
FedEx müşterileri aşağıdaki seçeneklerle Gelişmiş Entegre Görünürlüğe abone olabilir:
- Hesap Numarasına Göre: Hesapla eşleşen gönderiler için güncellemeler almak üzere FedEx Hesap Numarasına abone olun.
- Takip Numarasına Göre: API uç noktaları aracılığıyla belirtilen takip numaralarıyla eşleşen gönderiler için güncellemeler almak üzere FedEx Takip Numarasına abone olun.
Not: Abonelikler şu anda faturalandırma için ABD merkezli 9 haneli bir FedEx hesabı gerektirmekte ve müşterilerden Takip Numaralarının sayısına bağlı olarak aylık bir ücret alınmaktadır. Gelişmiş Entegre Görünürlük ücretlendirmesi hakkında daha fazla bilgi edinmek için Gelişmiş Entegre Görünürlüğe Genel Bakış Ücretlendirme Kılavuzu'nu inceleyin.
Hesap numarası ile abone olunması durumunda, Abonelikler için şu anda FedEx 9 haneli ABD merkezli kargo hesapları gerekmektedir.
Aşağıdaki tabloda Hesap Numarası Aboneliği ve Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği özellikleri ile ilgili bilgiler sunulmuştur
| Özellikler | Hesap Numarası Aboneliği | Gönderi Takip Numarası Aboneliği |
|---|---|---|
| Yanıt | Güvenli veriler: Kişisel olarak tanımlanabilir bilgi (PII) verileri Gönderici ve Alıcı verileri SPOD CDO'ları (Uygun Teslimat Seçeneği)/yanıt | Anonim veriler (Gönderi ve taşıma sürecine ilişkin güncellemeleri içerir, kişisel olarak tanımlanabilir bilgileri (PII) hariç tutar/yanıt |
| İlişkilendirme | Hesap numarasıyla ilişkilendirme = Tüm bağlantılı takip numaralarını aynı anda ilişkilendirme | Takip numaralarının birleştirilmesi |
| Sahiplik | Hesap numaralarının kullanıcının kendisine ait olması gerekir | Takip numaralarının kullanıcıya ait olması gerekmez |
| Filtreleme | Olayları gelen, giden ve üçüncü taraf gönderilerine göre filtreleme yeteneğine sahiptir |
Olayları filtreleyemez |
| Entegrasyon | Hesap numaralarının ilişkilendirilmesi UI aracılığıyla yapılır | Takip numaralarının ilişkilendirilmesi API uç noktası aracılığıyla yapılır |
| Sınırlama | 100 adede kadar hesap numarası ekleyebilir | Talep başına 1000 adede kadar takip numarası ekleyebilir |
| Uygun Kullanım Örneği | 1. taraf müşteriler: müşteri hesap numaralarına sahipse | 3. taraf müşteriler: müşterinin 1. taraf müşterilere ait takip numaraları varsa |
Abonelik Türüne Göre FedEx Entegre Görünürlük – Özellik Karşılaştırması
| Özellik / Veri Öğesi | Gönderi Takip Numarası Aboneliği | Hesap Numarası Aboneliği | Notlar |
|---|---|---|---|
| SPOD (İmzalı Teslimat Kanıtı) | Mevcut Değil | Mevcut (yapılandırma gerekli) | TIFF biçiminde imza görüntüsü, safi yükle teslim edilir |
| PPOD (Fotoğraflı Teslimat Kanıtı) | Mevcut (yapılandırma gerekli) | Mevcut (yapılandırma gerekli) | Teslimat yerinin JPEG görüntüsü, base64 kodlu |
| PPODA (Fotoğraflı Teslimat Denemesi Kanıtı) | Mevcut (yapılandırma gerekli) | Mevcut (yapılandırma gerekli) | Teslimat girişimleri için JPEG görüntüsü sağlanır |
| GPS Koordinatları (gpsPodCoordinates) | Mevcut Değil | Kullanılabilir | Takip tabanlı aboneliklerde maskelidir |
| İletişim Bilgileri (Ad, Telefon, Şirket) | Maskeli | Kullanılabilir | Gönderici, alıcı, menşe, varış yeri, aracı, vb. |
| Açık Adres ve Posta Kodu | Maskeli | Kullanılabilir | Takip tabanlı safi yüklerde streetLines ve postalCode maskelidir |
| Hesap Numaraları | Maskeli | Kullanılabilir | Faturalama yeri, gönderici ve alıcı hesabı değerlerini içerir |
| Paket Finansal Değerleri (ör., declaredValue, codAmount) | Maskeli | Kullanılabilir | Gümrük, teslimatta nakit ödeme ve beyan değerleri maskelidir |
| Sorgulama ve İade Ayrıntıları (Sorgulama kodları, İade nedenleri) | Maskeli | Kullanılabilir | Ayrıntıların tamamı yalnızca hesap tabanlı aboneler için gösterilir |
| Ürün ve İçerik Verileri | Maskeli | Kullanılabilir | Parça kodlarını, açıklamaları ve miktarları içerir |
| Çalışan Kimliği (ör. etkinlik personeli) | Maskeli | Mevcut Değil | Her iki durumda da gizlilik nedeniyle maskelidir |
| Olay Bildirimleri ve EDD/EDTW | Kullanılabilir | Kullanılabilir | Tahmini teslimat tarihi/saati özellikleri ikisinde de desteklenir |
| Çoklu Paket Gönderisi (MPS) | Kullanılabilir | Kullanılabilir | İlave takip bilgisi ile |
| Tahmini Teslimat Güveni ve Risk Puanları | Kullanılabilir | Kullanılabilir | Sadece Premium Seviye kapsamında |
Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği için Maskelenmiş Veri Alanları
Özet
Müşteriler gönderi takibi güncellemelerine Gelişmiş Entegre Görünürlük Hesap Numarası Aboneliği yerine Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği kullanarak abone olduklarında müşteri gizliliğinin korunması ve veri güvenliği politikalarına uyumun sağlanması amacıyla belirli veri alanları maskelenir.
Bu maskeleme sayesinde —kişisel iletişim bilgileri, adresler ve finansal değerler gibi— hassas bilgilere yalnızca yetkili taraflarca erişim sağlanabilmesi garanti edilir. Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği kullanan müşteriler, Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği ile söz konusu verilere erişim mümkün olmasına rağmen aşağıda listelenen maskelenmiş alanlarda ‘XXXXX’ görecektir.
Bu maskelemenin sonuçları şunlardır:
- Menşe/varış yeri ayrıntılarına ve dahil olan taraflara ilişkin sınırlı görünürlük.
- Kişisel tanımlama bilgilerinin (örneğin adlar, telefon numaraları) ve mali verilerin veya gümrük ilişkili verilerin bulunmaması.
- Güvenliğin ve yasalara uygunluğun sağlanması amacıyla tescilli veya hassas gönderi bilgileri için özel tasarlanmış koruma.
Operasyonel veya ticari kullanım durumları için bu maskeli alanlara erişime sahip olması gereken müşterilerin kendi Hesap Numarası bilgilerini kullanarak abone olmaları önerilir.
Gelişmiş Entegre Görünürlük Takip Numarası Aboneliğinde MASKELENMİŞ olan veri noktaları:
Olayları Tara
- scanEvent/location/locationContactAndAddress/address/streetLines
- scanEvent/location/locationContactAndAddress/contact/phoneNumber
- scanEvent/location/locationContactAndAddress/contact/companyName
- scanEvent/location/locationContactAndAddress/contact/personName
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName
Gönderici Bilgileri
- trackResult/shipperInfo/contactAndAddress/address/postalCode
- trackResult/shipperInfo/contactAndAddress/address/streetLines
- trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
- trackResult/shipperInfo/contactAndAddress/contact/companyName
- trackResult/shipperInfo/contactAndAddress/contact/personName
- trackResult/shipperInfo/account/value
Alıcı Bilgileri
- trackResult/recipientInfo/contactAndAddress/address/postalCode
- trackResult/recipientInfo/contactAndAddress/address/streetLines
- trackResult/recipientInfo/account/value
- trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
- trackResult/recipientInfo/contactAndAddress/contact/companyName
- trackResultecipientInfo/contactAndAddress/contact/personName
Menşe ve Varış Yeri
- trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
- trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode
Teslimat ve Adres Değişikliği Ayrıntıları
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName
Gümrük Müşaviri Bilgileri
- trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
- trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode
Paket ve Finansal Ayrıntılar
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Sorgu ve Ürün Bilgileri
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Paket İçeriği ve İade Nedeni
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Faturalama Bilgileri
- trackResult/billToParties/[Array]/billToParty/accountNumber
Müşteri Avantajları:
- Tahmini Teslimat Tarihi ve teslimat günü Zaman Aralığında meydana gelen taşıma sırasındaki değişikliklere ilişkin ileriye dönük bildirimler sayesinde alıcının duyduğu güveni artırın.
- FedEx Fotoğraflı Teslimat Kanıtı sağlayarak WISMO (Siparişim Nerede) aramalarına ve teslimat itirazlarına ilişkin müşteri hizmetleri maliyetlerini azaltın.
- Gönderi durumu hakkında neredeyse gerçek zamanlı bildirimler sağlayarak müşteri deneyimini geliştirin.
- Her gönderide takip güncellemelerini kontrol etmek için sürekli sorgulama yapmak yerine gönderiler hakkında gerçek zamanlı anlık güncellemeler alarak operasyonel verimlilik elde edin.
Özellikler ve Takip Olayları
Takip Olayları
Bu özellik, gönderilerin durumunu takip etmeye ve müşterileri gönderi yaşam döngüsündeki farklı güncellemeler hakkında proaktif olarak bilgilendirmeye olanak tanır. Müşterilere bildirim/uyarı almak istedikleri gönderi sürecinin/olaylarının belirli bir aşamasını seçme imkanı sunar. Geçerli gönderi olayları şunlardır:
- Gönderi: Bu seçenek seçili gönderi olayı gerçekleştiğinde bildirim sağlar. Örnek: Etiket Oluşturuldu, Teslim Alma, vb.
- Yolda: Bu seçenek gönderi taşıma olayları için bildirim sağlar. Örnek: Yolda, ürün teslimat ofisinde bekletiliyor vb.
- Teslimat: Bu seçenek gönderi teslimat olayları için bildirim sağlar. Örnek: dağıtıma çıktı, teslim edildi vb.
- İstisnalar: Bu seçenek teslimat istisnaları için bildirim sağlar. Örnek: gümrük gecikmesi vb.
- Kolay teslimat seçenekleri: Bazı kişiselleştirilmiş takip olaylarına ilişkin bildirim almak için bu seçeneği belirleyiniz. Örnek: şubede bekletme talebi kabul edildi.
Mevcut gönderi olayı seçenekleri hakkında daha fazla bilgi için Gelişmiş Entegre Görünürlük Takip Olayları için Durum Kodları ve Durumlar tablosunu inceleyin.
Teslimat Kanıtı
Bu özellik bir siparişin hedeflenen varış yerine başarıyla ulaştığını bildirmek için kullanılır. Buna şunlar dahildir:
- Fotoğraflı teslimat kanıtı (PPOD): PPOD sayesinde müşterinin paketi kapısına teslim edildikten sonra müşteriye paketin bırakıldığı yeri tam olarak gösteren bir fotoğraf gönderilir.
Gelişmiş Entegre Görünürlük, JSON yükündeki fotoğraflı teslimat kanıtı görüntülerini base64 biçiminde sunar. Görüntüler daha sonra JPEG biçimine dönüştürülebilir.
Not:
- Fotoğraflı teslimat kanıtı ABD, Kanada, Porto Riko, Hong Kong, Yeni Zelanda, Birleşik Krallık ve İrlanda'da kullanılabilir.
- Fotoğraflı teslimat kanıtı yalnızca FedEx Ground, FedEx Express ve konut paketleri/adresleri için kullanılabilir.
- İmzalı teslimat kanıtının gerekli olmadığı durumlarda uygun teslimatlar için fotoğraflı teslimat kanıtı kullanılabilir. Fotoğraflı teslimat kanıtı ve imzalı teslimat kanıtı birlikte kullanılamaz.
- Fotoğraflı teslimat kanıtı, doğrudan müşteriye verilmeyen (örn. teslimat sırasında doğrudan müşteriye teslim edilmeyen) imza gerekli değil (NSR) olarak teslimat sırasında doğrudan müşteriye teslim edilen).
- PPOD 14000 ila 33000 bayt arası görüntü boyutunu destekler (320x240 çözünürlüklü görüntü için geçerlidir).
- Fotoğraflı Teslimat Denemesi Kanıtı (PPODA): PPODA, teslimatın tamamlanamaması durumunda müşterilerin paketin teslim edileceği tam konumun resmini almasını sağlar. Gelişmiş Entegre Görünürlük, JSON yükündeki PPODA görüntülerini base64 biçiminde sunar. Görüntüler daha sonra JPEG biçimine dönüştürülebilir.
- PPODA ABD ve Porto Riko'da mevcuttur.
- PPODA yalnızca FedEx Ground, FedEx Express ve konut ve ticari paketler/adresler için geçerlidir.
- PPODA Görüntüsü şu şekilde olabilir:
- Kapıdaki Kapı Etiketinin PPODA fotoğrafı.
- Teslimat Noktasına Engel Olan Durumun (örneğin; kilitli kapı) Fotoğrafı.
- Durakta teslim edilen paketlerin PPOD görüntüsü.
- PPODA 14000 ila 33000 bayt arası görüntü boyutunu destekler (320 x 240 çözünürlük için geçerlidir).
- İmzalı teslimat kanıtı (SPOD): SPOD sayesinde müşteriler alıcının imza görüntüsünün yanı sıra alıcı adı, teslimat tarihi, saati ve yeri gibi bilgileri de alabilirler. İmzalı Teslimat Kanıtı bilgisi, görüntü yerine bayt dizisi olarak sunulur. Bayt dizisi, en son imza görüntüsünü PNG formatında elde etmek için kodunun çözülmesi gereken base64 kodlu bir dizedir
- SPOD özelliği, Gelişmiş Entegre Görünürlük Takip Numarası Aboneliği için mevcut değildir.
- SPOD görüntü boyutu 4000 ila 6000 bayt arasında olacaktır (400x95 çözünürlüklü görüntü için geçerlidir).
- SPOD görüntü boyutu 5000 ila 8000 bayt arasında olacaktır (230x150 çözünürlüklü görüntü için geçerlidir).
- GPS teslimat kanıtı (GPSPOD):
- GPS Teslimat Kanıtı, müşterilerin teslimat yerinin coğrafi koordinatlarını almasına olanak tanır.
Not: GPSPOD özelliği, Gelişmiş Entegre Görünürlük Hesap Numarası Aboneliği için standart olarak mevcuttur.
- GPS Teslimat Kanıtı, müşterilerin teslimat yerinin coğrafi koordinatlarını almasına olanak tanır.
Tahmini Teslimat Tarihi ve Teslimat Zaman Aralığı Olayları
Bu özellik gönderi teslimatları için tarih ve/veya saat aralığı gönderi alıcılarının planlama yapmalarına yardımcı olur. Buna şunlar dahildir:
- Tahmini teslimat tarihi (EDD): Bu seçenek gönderinin alıcıya tahmini olarak teslim edileceği tarihi belirtir. Örnek: 20 Kasım 20XX.
- Tahmini teslimat zaman aralığı (EDTW): Bu seçenek alıcıya gönderinin gerçek teslimat gününde tahmini olarak teslim edileceği bir zaman aralığı sağlar. Örnek: 14:00-18:00 arası.
Olaya Göre Filtreleme
Bu özellik müşterilerin web kancası projelerini gönderilere yönelik faturalama yöntemlerine göre düzenlemelerini sağlar. Seçenekler şunlardır:
- Gelen: Size teslim edilecek ve ücreti alıcı olarak sizin tarafınızdan ödenecek gönderiler için bu seçeneği belirleyebilirsiniz.
- Giden: Sizin tarafınızdan gönderilecek ve ücreti gönderici olarak sizin tarafınızdan ödenecek gönderiler için bu seçeneği belirleyebilirsiniz.
- Üçüncü taraf: Üçüncü taraf ödeyen olarak size fatura edilen gelen ve giden gönderiler için bu seçeneği belirleyebilirsiniz.
Not: Gönderilerin faturalandırılması veya ödenmesi için FedEx hesap numaranız kullanılır. Üçüncü taraf ödeyen olarak gönderici veya alıcı siz olmayabilirsiniz ancak ücretler FedEx hesap numaranıza fatura edilir.
Yeniden Deneme Politikası
Bu özellik istemci tarafında bir sorun olması durumunda FedEx'in takip olayı verilerini göndermesini engeller. FedEx verileri saklar ve 5 dakikalık aralıklarla 3 yeniden deneme süresi içinde yeniden göndermeyi dener.
FedEx, tanımlanmış zaman aralığında başarılı bir yanıt almazsa söz konusu olayın yeniden teslimatını durdurur. Ancak müşteri, Gelişmiş Entegre Görünürlük web kancası Projesi Ayrıntılar sayfasındaki manuel "YENİDEN DENE" düğmesi aracılığıyla son 7 günlük bir süre boyunca kaçırılan olaylar için talepte bulunabilir.
Yeniden deneme politikaları hakkında daha fazla bilgi için Yeniden deneme mekanizması bölümüne bakın.
