Tedarikçi Perakende Tedarik API'leri v1 Kullanım Senaryosu Rehberi
Tedarikçilerin perakende iş operasyonlarını web hizmeti entegrasyonu yoluyla programlı olarak yönetmelerine nasıl yardımcı olunur?
Perakende Satıcıları için Satış Ortağı API'leri, tedarikçilerin perakende iş operasyonlarını web hizmeti entegrasyonu yoluyla programlı olarak yönetmesine yardımcı olur. Amazon ile otomatik entegrasyon, tedarikçilerin performanslarını büyük ölçekte iyileştirip sürdürmelerine ve Amazon ile işlerini büyütmelerine yardımcı olabilir.
Doğrudan gönderim programındaki satıcılar, doğrudan gönderime özel API'ler hakkında bilgi edinmek için Tedarikçi Doğrudan Gönderim API'leri v1 Kullanım Senaryosu Rehberi'ni inceleyebilir.
Tedarikçiler bu API'leri kullanarak operasyonel verimliliği artıracak, zorlukları azaltacak, hata sayısını düşürecek ve performansı yükseltecek uygulamalar geliştirebilir.
Kimlik doğrulama ve yetkilendirme bilgileri için bkz. Satış Ortağı API uygulamalarını yetkilendirme.
Satıcı Perakende Tedarik API'lerini kullanarak gerçekleştirebileceğiniz iş süreçleri
Kullanabilirsiniz Satıcı Siparişleri API'si satınalma siparişlerini yönetmek için, Satıcı Gönderileri API'si gönderi onaylarını göndermek için, Satıcı Faturaları API'si fatura göndermek ve Satıcı İşlem Durumu API'si sipariş onaylarınızın ve gönderi onaylarınızın durumunu belirlemek için.
İş süreci | Kullanım örneği | İşlem |
Satınalma siparişi yönetimi | ||
Satın alma siparişi değişikliklerini veya iptallerini alın | getPurchaseOrders Belirttiğiniz zaman dilimi içinde oluşturulan veya değiştirilen satınalma siparişlerinin listesini döndürür. |
|
Satınalma siparişi durumunu kontrol edin | getPurchaseOrdersStatus Belirttiğiniz filtrelere göre satınalma emri durumlarını döndürür. |
|
Satınalma siparişi onayını gönder | submitAcknowledgement Bir veya daha fazla satınalma siparişi için onay gönderir. |
|
Sipariş Onayı işlem durumunu kontrol edin | getTransaction Belirttiğiniz işlemin durumunu döndürür. |
|
Sevkiyatlar | ||
Sevkiyat taleplerini gönderir | SubmitShipments Satıcı Siparişleri için bir veya daha fazla gönderi talebi gönderir. |
|
Gönderi durumunu veya gönderi/nakliye etiketlerini alın | GetShipmentDetails Belirttiğiniz filtre parametreleri değerine göre Gönderiyle ilgili Ayrıntılar, Taşıyıcı Ayrıntıları, gönderinin durumu, konteyner ayrıntıları ve gönderiyle ilgili diğer detayları döndürür. |
|
Ön sevkiyat bildirimi (ASN) /sevkiyat onaylarını gönderin veya güncelleyin | SubmitShipmentConfirmations Satıcı siparişleri için bir veya daha fazla gönderi onayı gönderir. |
|
Gönderi Onayı işlem durumunu kontrol edin | getTransaction Belirttiğiniz işlemin durumunu döndürür. |
|
Gönderi etiketlerini alın | GetShipmentLabels Belirttiğiniz filtrelere göre küçük paket gönderi etiketlerini döndürür. |
|
Faturalar ve kredi notları | ||
Satıcı faturalarını gönderin | submitInvoices Amazon'a yeni faturalar gönderin. |
Tedarikçi Siparişleri API'si nedir?
Kullanabilirsiniz Satıcı Siparişleri API'si (Siparişler API'si) satın alma siparişlerini almak ve sipariş gönderimini kabul etmek veya reddetmek için sipariş onayları göndermek için.
Satıcı Siparişleri API'si aşağıdaki işlemleri içerir:
İşlem | HTTP Yöntemi | Path | Açıklama |
---|---|---|---|
getPurchaseOrders |
GET | /vendor/orders/v1/purchaseOrders |
Belirttiğiniz zaman aralığında oluşturulan veya değiştirilen satın alma siparişlerinin bir listesini döndürür. Veri alımı, orijinal POST çağrısının yapıldığı tarihten itibaren en fazla altı aylık bir süre için mümkündür. |
getPurchaseOrder |
GET | /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} |
Aşağıdakilere göre bir satınalma siparişi (PO) döndürür purchaseOrderNumber Belirttiğiniz değer. Veri alma, orijinal POST çağrısının yapıldığı tarihten itibaren en fazla altı ay süreyle mümkündür.. |
submitAcknowledgement |
POST | /vendor/orders/v1/acknowledgements |
Bir ya da daha fazla satın alma siparişini kabul eder (kabul eder veya reddeder). |
getPurchaseOrdersStatus |
GET | /vendor/orders/v1/purchaseOrdersStatus |
Belirttiğiniz filtrelere dayalı olarak satın alma siparişi durumlarını döndürür. Veri alımı, orijinal POST çağrısının yapıldığı tarihten itibaren en fazla altı aylık bir süre için mümkündür. |
Kullanabilirsiniz getPurchaseOrders
Belirli bir zaman diliminde oluşturulan veya değiştirilen siparişlere erişme işlemi (Haziran 2020'den sonra son altı ayın değişen bir penceresi içinde). Yanıt süresini optimize etmek için, zaman aralığını en fazla yedi gün ile sınırlamanızı öneririz.
Kullanabilirsiniz getPurchaseOrder
Belirli bir sipariş için ayrıntılı sipariş bilgisi almak için işlem. Daha sonra kullanabilirsiniz submitAcknowledgement
siparişi kabul etme veya reddetme işlemi.
Siparişlerinizi kabul ettikten veya reddettikten sonra, şunları kullanabilirsiniz: getPurchaseOrdersStatus
bir veya daha fazla satın alma siparişinin onay durumunu iade etme işlemi.
Not
Tüm satın alma siparişi ayrıntılarını arayarak iade edebilirsiniz.
getPurchaseOrders
işlem veya yalnızca satınalma siparişi numaralarını içeren iade edinincludeDetails
filtre. Bu parametrenin varsayılan değeri true değeridir, dolayısıyla bu sorgu parametresini eklemezseniz, satınalma siparişlerinin tüm ayrıntılarını döndürürsünüz. Eğer kullanırsanızincludeDetails=false
Yanıt yalnızca satınalma emri numaralarının bir listesini ve her satın alma siparişinin mevcut durumunu içerecektir.
Aşağıdaki şemada, Tedarikçi Siparişleri API'sini kullanan iş akışı gösterilmektedir.
getPurchaseOrders
getPurchaseOrders
getPurchaseOrders
işlem, istekte belirtilen kriterleri karşılayan tüm siparişler için sipariş referanslarının bir listesini (satın alma emri numaraları ve durumu) veya eksiksiz sipariş ayrıntılarını döndürür. Yalnızca sipariş referanslarını iade ediyorsanız, daha sonra bunlar ile birlikte kullanılabilir. getPurchaseOrder
Belirli bir sipariş için sipariş ayrıntılarını almak için işlem.
Gönderim talimatı oluşturmak için kullanabileceğiniz satın alma siparişlerini almak amacıyla bu API'yi kullanmalısınız. Amazon, tedarikçilerin çalışma saatleri içinde saatte en az bir kez siparişleri kontrol etmesini önerir. İş hacminize bağlı olarak daha sık kontrol etmeyi tercih edebilirsiniz. Bir API çağrısında en fazla 100 sipariş alabilirsiniz. 100'den fazla sipariş varsa bir sonraki sipariş kümesini almak için nextToken
kullanabilirsiniz.
Sipariş değişiklikleri ve iptali
getPurchaseOrders
işlemini kullanarak sipariş değişikliklerini ve iptallerini iade edebilirsiniz
Sipariş Değişiklikleri: Bazen Amazon, bir gereksinim değişikliği nedeniyle sipariş oluşturulduktan sonra satın alma siparişi verilerini değiştirir. Satıcılar, güncellenmiş siparişleri almak için getPurchaseOrders
API'sini kullanabilir. Amazon bir satın alma siparişini değiştirirse siparişte, Amazon'un siparişi güncellediği zaman damgası olan bir purchaseOrderChangedDate
alanı bulunur. Bu alan yoksa sipariş oluşturulduktan sonra hiç değişmemiş demektir.
Not
Amazon, siz onayladıktan sonra satın alma siparişini de değiştirebilir.
Tedarikçiler, changedAfter
ve changedBefore
sorgu parametrelerini kullanarak belirli bir tarih aralığında değiştirilen siparişlerin bir listesini alabilir. Bu, tarih aralığı içinde Amazon tarafından değiştirilen siparişleri döndürür ve tedarikçilerin güncellenmiş satın alma siparişini göndermesi gerekir. Alternatif olarak tedarikçiler, değiştirilen tüm satın alma siparişlerini almak için isPOChanged=true
kullanarak filtreleme yapabilir.
Amazon, değiştirilen siparişleri bir gün boyunca almak için değişen tarih aralığıyla günde birkaç kez ayrı bir API çağrısı yapmanızı önerir. Örneğin, son altı saat içinde siparişlerin değiştirilmesini sağlamak için günde dört kez satın alma siparişleri al işlemini arayabilirsiniz.
Aşağıda, sipariş değişikliklerine katkıda bulunabilecek değişikliklerin bir listesi bulunmaktadır. Bu değişiklikler için, değiştirilen siparişi çekmeli ve doğru satınalma siparişini göndermelisiniz:
- Gemi veya teslimat penceresi değişikliği
- Miktar değişikliği, ürün iptali, kalem maliyet değişikliği gibi PO ürün güncellemeleri
- PO'ya yeni öğe eklendi
- PO iptal edildi/iptal edilmedi
- PO türü değişti
- PO teslimat hedefi (gönderim merkezi) değişikliği
- PO Navlun bilgileri değişti
Ürün İptali: Ayrıca filtre ile Satıcı Siparişleri API'sini kullanabilirsiniz. poItemState=Cancelled
, bir veya daha fazla iptal edilen ürün içeren siparişleri iade etmek için. Bu, satın alma siparişi oluşturulduktan sonra Amazon tarafından bir veya daha fazla öğenin iptal edildiği tüm siparişleri iade eder. Bu, yalnızca ürünleri iptal eden siparişleri almanıza yardımcı olur (sipariş edilen miktar sıfırdır) ve iptal edilen ürünleri göndermemenize yardımcı olur.
Not
Ürün iptali, sipariş değişikliği olarak nitelendirilir ve bu nedenle bu siparişleri değiştirilen siparişler listesiyle de iade edersiniz.
Satınalma Siparişi Durumu ve Satıcı Kodu: Satınalma emri şeması, geçerli satınalma emri durumunu ve durum güncelleme zamanını içerir. Filtreyi kullanabilirsiniz purchaseOrderState
mevcut duruma göre siparişleri filtrelemek için.
Örneğin, tedarikçiler purchaseOrderState=New
kullanarak henüz onaylanmamış veya yerine getirilmemiş tüm satın alma siparişlerini alabilir.
Tedarikçiler, orderingVendorCode
filtresinde yetkili satıcı kodlarından birini sağlayarak belirli bir satıcı kodu için satın alma siparişleri de alabilirler. Bu filtre, yalnızca filtrede belirtilen satıcı kodu için oluşturulan satın alma siparişlerini döndürür.
Kullanılabilir tüm filtreler hakkında ayrıntılı bilgi için Tedarikçi Siparişleri API Referansı bölümünü inceleyin.
Aşağıdaki şemada, satın alma siparişleri alınırken kullanılan entegrasyon iş akışı gösterilmektedir:
getPurchaseOrder
getPurchaseOrder
getPurchaseOrder
işlem, satınalma siparişi hakkında belirttiğiniz bilgileri iade etmek için satınalma emri numarasını kullanır. Yanıt, satır öğesi ayrıntıları, miktar ve maliyet dahil olmak üzere eksiksiz satınalma siparişi bilgilerini içerir.
İade edilen belirli siparişlerin ayrıntılarını almak için bu işlemi kullanın getPurchaseOrders
operasyon.
Aşağıdaki diyagram, belirli bir satınalma siparişini alırken entegrasyon iş akışını gösterir:
İşletme gereksinimleri
-
Ağırlığa dayalı sipariş
Ağırlığa göre satılan öğeleri içeren siparişler için,
unitOfMeasure
alan (altındalistPrice
venetCost
) gerçek ağırlık ölçü birimini yansıtır. Ölçüm değerlerinin ağırlık birimi şunları içerir:POUNDS
,OUNCES
,GRAMS
, veKILOGRAMS
. -
Gemi Penceresi veya Teslimat Penceresi kullanımı
Satıcı ücretli yükler için teslimat penceresi bilgileri kullanılmalıdır. Tarihler, aşağıdakilere uygun olarak tarih zaman aralığı biçiminde temsil edilir. İSO 8601. Biçim, çift tire (--) ile ayrılmış başlangıç ve bitiş tarihidir. Başlangıç tarihi alanı, Amazon'un navlunun satın alma siparişinde listelenen Amazon gönderim merkezine teslim edilmesini beklediği en erken tarihi temsil eder. Bitiş tarihi alanı, Amazon'un navlunun satın alma siparişinde listelenen Amazon gönderim merkezine teslim edilmesini beklediği en son tarihi temsil eder.
Amazon ücretli yükler için gemi penceresi bilgilerini kullanın. Tarih, aşağıdakilere göre tarih/saat aralığı biçiminde gösterilir İSO 8601. Biçim, çift tire (--) ile ayrılmış başlangıç ve bitiş tarihidir. Başlangıç tarihi alanı, Amazon'un navlunu almayı beklediği en erken tarihi temsil eder. Bitiş tarihi, Amazon'un navlunu almayı beklediği en son tarihi temsil eder. Başlangıç tarihi ve bitiş tarihi alanlarında aynı tarih listeleniyorsa, Amazon'un navlunu almayı beklediği tarih olarak bu tarihi okuyun.
-
Satır öğeleri için tekrar siparişleri kabul edilebilir mi?
isBackOrderAllowed
alanındaki değeri okumanız gerekir. "true" olduğunda sipariş bir tekrar siparişi olarak işlenebilir. "false" olduğunda tekrar siparişlerine izin verilmez. -
Fırsat kodları
Fırsat kodları, siparişin
dealCode
alanında bildirilen promosyon kodlarıdır. Promosyon kodu, özel indirimler veya fiyatlandırma ile ilgili her türlü bilgi bu alanda yer alır. -
Tekrar siparişi iptal politikası
Amazon işletme temsilciniz, ön sipariş politikasını belirler. Ayrıntıları satıcı yöneticinizle tartışın.
Not
Ön sipariş iptal tarihleri siparişte gönderilemez. Ön sipariş politikasını hesap düzeyinde ayarlamanız gerekir.
-
Bir siparişi değiştirmek için API'yi kullanın
API kullanarak bir siparişte değişiklik göndermek şu anda mümkün değildir. Bir sipariş verildikten sonra, değiştirilmesi Satıcı Merkezi aracılığıyla manuel bir işlemdir.
Ülkeye özel işletme gereksinimleri
İşlevsellik | Hindistan | Avrupa | Kuzey Amerika |
---|---|---|---|
Net Maliyet | Koşullu. Net Maliyet veya Liste Fiyatı. | Koşullu. Net Maliyet veya Liste Fiyatı. | Koşullu. Net Maliyet veya Liste Fiyatı. |
Liste Fiyatı | Koşullu. Net Maliyet veya Liste Fiyatı. | Koşullu. Net Maliyet veya Liste Fiyatı. | Koşullu. Net Maliyet veya Liste Fiyatı. |
Tekrar Siparişi | Geçerli Değil | Desteklenir | Desteklenir |
Satın Alan Taraf | Amazon Satın Alma Kuruluşunun adresi | Satın alan tarafın atanan taraf kimliği | Geçerli Değil |
Satış Yapan Taraf | Tedarikçiye atanan Amazon Tedarikçi Kodu | Tedarikçiye atanan Amazon Tedarikçi Kodu | Tedarikçiye atanan Amazon Tedarikçi Kodu |
Gönderim Yapılan Taraf | Gönderim Yapılan Kuruluşun adresi | Gönderim yapılan tarafından atanan taraf kimliği | Geçerli Değil |
Faturalandırılacak Taraf | Faturalandırılacak Tüzel Kişinin adresi | Faturalandırılacak Tüzel Kişinin adresi | Geçerli Değil |
submitAcknowledgement
submitAcknowledgement
Kullanabilirsiniz submitAcknowledgement
Gönderim için bir satınalma siparişini kabul etme veya reddetme işlemi. Amazon, satınalma siparişi için tüm satınalma siparişi satırı öğeleri de dahil olmak üzere eksiksiz bir onay bekler. Onayda satınalma siparişi için tüm satır öğelerini sağlamazsanız Amazon eksik satır öğelerini dolaylı olarak reddeder.
Amazon, onayınızı mümkün olan en kısa sürede göndermenizi bekler; en geç 24 saat içinde. Onay, gerçek sevkiyat miktarlarının ve tarihlerinin doğru bir görünümü olmalıdır.
Miktar, fiyat, kargo tarihleri veya teslimat tarihlerindeki herhangi bir değişiklik için Amazon, tedarikçi tarafından gönderilen onayda 48 saat içinde bir güncelleme yapılmasını bekler. Tedarikçi, tam bir onay güncellemesi gönderebilir veya yalnızca belirli bir satır öğesini güncelleyebilir. Amazon, güncellemeyi her zaman satır öğesinin önceki onaylarının yerine değerlendirir. 48 saatten sonra yalnızca kargo tarihleri veya teslimat tarihleriyle ilgili güncellemeler almayı bekleriz.
Belirli bir satır öğesi için ilk onay kodu ise rejected
, güncellemenizle bunu her ikisine de değiştirmenize izin verilmez accepted
veya backordered
.
Başarıyla gönderilen sipariş onaylarının doğrulanması
Sipariş onayının orijinal veya güncellenmiş sürümünün durumunu şu şekilde doğrulayabilirsiniz Satıcı Merkezi veya kullanarak İşlem Durumu API'si. Orijinal veya güncellenmiş sürüm 30 dakika sonra görünmezse, şu adrese giderek Satıcı Merkezi'nde bir destek talebi gönderin Vendor Central > Support > Contact Us > API Integration.
Aşağıdaki şemada, siparişleri onaylarken kullanılan entegrasyon iş akışını gösterilmektedir.
İşletme gereksinimleri
-
Tedarikçi, bir siparişi onaylarken satın alma siparişinde sunulan orijinal miktarı artırabilir mi?
Hayır, onayda satın alma siparişinde gönderilenden daha yüksek bir miktar gönderemezsiniz.
-
Her satın alma siparişi için bir sipariş onayı gönderilmesi zorunlu mudur?
Evet, Amazon sistemindeki bir siparişin durumunu doğru bir şekilde güncellemek için Amazon, API'yi kullanarak PO onayı gerektirir veya Satıcı Merkezi. API'yi kullanarak sipariş onayı gereksinimlerimizi karşılayamıyorsanız, satın alma siparişlerinizi şu şekilde onaylamanız gerekir: Satıcı Merkezi. Sahip değilseniz Amazon iş temsilcinizle iletişime geçin. Satıcı Merkezi hesap.
-
İlgili sipariş onayında her PO satır öğesini sağlamak zorunlu mudur?
Evet, böylece Amazon sipariş durumunu doğru şekilde güncelleyebilir.
-
Bir satır öğesi tekrar siparişine eklenirse sipariş onayında miktarın belirtilmesi gerekli midir?
Evet, böylece Amazon sistemi satır öğesinin durumunu doğru şekilde güncelleyebilir.
-
Siparişteki geçersiz veya eski ürünler sipariş onayı kullanılarak nasıl bildirilmelidir?
Siparişte geçersiz bir ürün numarasıyla gelen bir ürünü işlemeyin veya göndermeyin. Onaydaki geçersiz ürün numarasını iade edin ve şu şekilde onaylayın
invalid
. Aşağıdaki onay kodları şunları gösterir:rejected
öğenin eski olması nedeniyle:Reddedildi: Amazon'un yorumu, bu kodla belirtilen miktarın bu satın alma siparişinin bir parçası olarak Amazon'a teslim edilmeyeceğidir. Uygun ret nedenini şu şekilde göndermelisiniz:
obsolete
Teşekkür içinde. Bu, ürünün eski olması nedeniyle ürünün artık sipariş edilmemesi gerektiğini gösterir. Bunun için Amazon terminolojisi “sert reddetme” dır, yani bu öğe yeniden sipariş edilmemelidir. Bu kod aynı proje için art arda iki kez alınırsa (en az 48 saatlik bir zaman aralığı ile ayrılır), öğe yeniden sıralanmayacaktır.
Not
Amazon, satın alma siparişindeki tüm satır öğeleri geçersiz olsa ve sipariş veya fatura üretmemiş olsa bile bir onay bekler. Bir satın alma siparişi için ilgili bir onay gönderilemiyorsa Amazon geçersiz öğelerin manuel olarak bildirilmesini gerektirir. Satın alma ekibinizi şu adresten bildirebilirsiniz Satıcı Merkezi Contact Us bağlantı.
-
Sipariş işleminde aldığım onayda aynı ürün tanımlayıcısını döndürmem gerekiyor mu?
Onaylar, satın alma siparişinde gönderilen ürün tanımlayıcısının tam olarak aynısını döndürmelidir.
-
Onayda fiyat belirtilmesi zorunlu mudur?
Evet, tedarikçilerin onayda birim maliyet fiyatını döndürmesi gerekmektedir. Maliyet fiyatı, fatura edilecek birim maliyet fiyatıyla eşleşmelidir. Kitap satıcılarının bir liste fiyatı ve indirim çarpanı sağlaması gerekmektedir.
-
Satın alma siparişindeki fiyat, onay belgesinde basitçe döndürülebilir mi?
Hayır. Satın alma siparişinde gönderilen fiyat ne olursa olsun Amazon, onayda maliyet fiyatının belirtilmesini ister. Onayda gönderilen maliyet fiyatı, faturada gönderilen maliyet fiyatıyla eşleşmelidir. Amazon ödeme sistemleri ikisini karşılaştırır ve eşleşmezlerse ödemeyi geciktirebilir.
-
İlk onay iletildikten sonra fiyat ve/veya stok durumu değişirse Amazon.com ne talep eder?
İlk onay iletildikten sonra Amazon siparişlerinde yapılan değişikliklerle ilgili manuel bildirim sağlayın. Amazon.com işletme temsilciniz ne zaman, nasıl ve kime bildirimde bulunacağınız konusunda tavsiyede bulunabilir.
-
Tekrar siparişindeki ürünler için fiyat verisi sağlamak gerekli mi?
Evet, Amazon'un siparişin durumunu doğru şekilde güncelleyebilmesi için bu gereklidir. Fiyat ihmal edilirse, bu onayın reddedilmesine neden olur.
-
Tekrar siparişlerine izin verilip verilmediğini nasıl bileceğim?
İçindeki değeri okumanız gerekmektedir.
isBackOrderAllowed
satınalma siparişindeki alan. True değeri, ön siparişlere izin verildiğini gösterir. False değeri, ön siparişlere izin verilmediğini gösterir. -
Durumuna bakılmaksızın tüm satır öğeleri için bir onay kodu sağlanması gerekli midir?
Evet, siparişin durumunu doğru bir şekilde güncelleyebilmemiz için gereklidir. Onay kodu atlanırsa, onay reddedilir.
-
Amazon'un kısmi kargolarla ilgili politikası nedir? Sipariş onayı gönderilirken kısmi kargolar nasıl bildirilmelidir?
Satınalma siparişi ön siparişlere izin veriyorsa kısmi gönderilere izin verilir (ne zaman
isBackOrderAllowed
dırtrue
). Amazon, kodu kullanarak bir onay döngüsü belirtmenizi öneriraccepted
ilgili tarih ve kodu kullanan başka bir onay döngüsü ilebackordered
ve ilgili tarih.Kabul edildi: Hemen gönderilebilecek ürünler için.
Tekrar sipariş edildi: Hemen gönderilemeyen kalan miktar için. Kalan miktar (sipariş edilen miktar eksi tüm onaylanan miktar) daha sonra teslim edilecektir (tekrar sipariş edildi).
-
listPrice
segmentini ne zaman kullanmalıyım?listPrice
segmenti, yalnızca bir tedarikçi liste fiyatıyla kitap satıyorsa zorunludur.
Ülkeye özel işletme gereksinimleri
İşlevsellik | Hindistan | Avrupa | Kuzey Amerika |
---|---|---|---|
Planlanan Kargo Tarihi | Koşullu. Navlun koşullarına ve tedarikçiyle olan mevcut iş anlaşmasına bağlıdır. | İsteğe bağlı | İsteğe bağlı |
Planlanan Teslimat Tarihi | Koşullu. Navlun koşullarına ve tedarikçiyle olan mevcut iş anlaşmasına bağlıdır. | İsteğe bağlı | İsteğe bağlı |
Liste Fiyatı | Sadece Kitap Satıcıları için gerekli | Desteklenir | Sadece Kitap Satıcıları için gerekli |
Satın Alma Siparişleri Durumunu Alma
getPurchaseOrdersStatus
işlem, istekte belirtilen kriterleri karşılayan satınalma siparişleri listesinin durumunu döndürür. Bu işlemi, gönderim için kullanabileceğiniz satınalma siparişlerindeki öğelerin onay durumunu almak için kullanabilirsiniz. Bu işlem, sipariş edilen miktar ve bir öğenin onaylarının geçmişini döndürür. Bir satın alma siparişindeki bir öğe için işlenen tüm onayların ayrıntılarını görüntüleyebilirsiniz. İhtiyacınıza göre PoS listesini filtrelemek için çok çeşitli sorgu parametreleri sağladık.
Bir API çağrısında 100 adede kadar sipariş döndürebilirsiniz. 100'den fazla sipariş varsa bir sonraki sipariş kümesini almak için nextToken
kullanabilirsiniz.
Aşağıda getPurchaseOrdersStatus
işlemini farklı sorgu parametreleriyle nasıl kullanabileceğinize dair birkaç örnek verilmiştir:
-
PO oluşturma tarihini kullanarak belirli bir tarih aralığındaki tüm açık satın alma siparişlerinin durumunu alabilirsiniz (
createdBefore
vecreatedAfter
) veya PO güncelleme tarihi (updatedBefore
veupdatedAfter
) ile birliktepurchaseOrderStatus=OPEN
. -
Kullanabilirsiniz
getPurchaseOrdersStatus
PoS durumunu filtrelemek için işlem. Örneğin, eğeritemConfirmationStatus=REJECTED
Yanıt, bir veya daha fazla öğenin reddedilmiş statüsüne sahip tüm siparişleri döndürür. -
Belirli bir PO'nun durumunu,
purchaseOrderNumber
sorgu parametresinde PO numarasını girerek kontrol edebilirsiniz. -
Satıcı kodu değerini
orderingVendorCode
içinde sağlayarak vepurchaseOrderStatus=OPEN
dahil ederek belirli bir satıcı kodu için oluşturulmuş tüm açık PO'ların durumunu alabilirsiniz. -
Bir zaman aralığında oluşturulan ve belirli bir Amazon FC'ye gönderilmesi gereken tüm PO'ların durumunu,
shipToPartyId
üzerinde lojistik merkezi (FC) kodunu vecreatedBefore
ilecreatedAfter
üzerinde zaman aralığı aralığını girerek alabilirsiniz.
Satın Alma Siparişi ve Onay kullanım senaryoları
Satın alma siparişinde geçersiz satır öğesi
Satın alma siparişinde geçersiz bir ürün tanımlayıcısı alırsanız, ürünü bir onay kodu ile reddetmelisiniz Rejected
ve rejectionReason
olarak InvalidProductIdentifier
:
Satın Alma Siparişi
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Satın Alma Siparişi Onayı
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10
},
"rejectionReason": "InvalidProductIdentifier"
}
]
}
]
}
]
}
Satın Alma Siparişi Durumu
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "CLOSED",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "REJECTED",
"acceptedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
}
}
]
}
]
}
}
Satın alma siparişindeki eski satır öğesi
Satın alma siparişinde eski bir ürün alırsanız, ürünü bir onay kodu ile reddetmelisiniz Rejected
ve rejectionReason
olarak ObsoleteProduct
.
Satın Alma Siparişi
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Satın Alma Siparişi Onayı
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266356",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123438",
"vendorProductIdentifier": "028877454079",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "IN",
"amount": "100.20"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10
},
"rejectionReason": " ObsoleteProduct"
}
]
}
]
}
]
}
Kısmi ürün miktarını onaylama ve kalan miktarı tekrar siparişe alma
Amazon 10 adet ürün sipariş etti. Satıcı, gönderileri bölmeyi planlıyor ve bu nedenle bir gönderiyor Accepted
öğe miktarı altı ve bir BackOrdered
İlk sevkiyatta altı birim ve ikincisinde dört birim sevk edileceğini belirtmek için dört adet ürün miktarı.
Satın alma siparişi - (Satın Alma Siparişini İçe Aktar)
{
"order": {
"purchaseOrderNumber": " L8266357",
"purchaseOrderState": "Acknowledged",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderChangedDate": "2019-07-18T16:05:00Z",
"purchaseOrderStateChangedDate": "2019-07-17T10:00:34.304Z",
"purchaseOrderType": "RegularOrder",
"importDetails": {
"importContainers": "2-20'HC,1-45',1-45'HC",
"internationalCommercialTerms": "FreeOnBoard",
"methodOfPayment": "PrepaidBySeller",
"portOfDelivery": "USA",
"shippingInstructions": "PREFERENCE IS PALLET-LOAD, BUT IF CONTAINERS ARE FLOOR-LOADED"
},
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "XYZ1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"billToParty": {
"partyId": "XYZ1",
"taxInfo": {
"taxRegistrationNumber": "12AAXYZ4259Z123",
"taxRegistrationType": "VAT"
}
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Eaches"
},
"isBackOrderAllowed": true,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Satın Alma Siparişi Onayı
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": " ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 6
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
},
{
"acknowledgementCode": "Backordered",
"acknowledgedQuantity": {
"amount": 4
},
"scheduledShipDate": "2019-07-25T19:17:34.304Z"
}
]
}
]
}
]
}
Tedarikçi, siparişin ilk bölümünü gönderdikten sonra Amazon'a, tekrar sipariş edilen ürünler için scheduledShipDate
kullanarak ikinci teslimatın daha doğru bir tarihini verir. Tedarikçilerin her zaman bağımsız ürünler için sipariş edilen toplam miktarı içeren tam güncellemeler göndermesi gerektiğini unutmayın. Tam güncellemeler, miktarlara ilişkin açık bir görünürlük sağlar.
Satın Alma Siparişi Durumu
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-18T16:05:00Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "XYZ1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "ACCEPTED",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"rejectedQuantity": {
"amount": 0,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
}
]
}
]
}
}
Başlangıçta kabul edilen miktarları iptal etmek için birden fazla onay
İlk olarak kabul edilen bir siparişin birimlerinin bir kısmını veya tamamını yerine getiremeyeceğinizi keşfettiğinizde ve Amazon'a bu birimlerin gönderilmeyeceğini bildirmek istediğinizde bunu kullanabilirsiniz.
Satın Alma Siparişi
{
"order": {
"purchaseOrderNumber": " L8266355",
"purchaseOrderState": "New",
"orderDetails": {
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z",
"purchaseOrderType": "RegularOrder",
"paymentMethod": "Invoice",
"buyingParty": {
"partyId": "NAG1"
},
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"billToParty": {
"partyId": "NAG1"
},
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": "10",
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"isBackOrderAllowed": false,
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
}
}
]
}
}
}
Satın Alma Siparişi Onayı
Tedarikçi başlangıçta miktarı kabul etti.
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
}
]
}
]
}
]
}
Daha sonra tedarikçi kabul edilen miktarı karşılayamıyor ve başka bir satın alma siparişi onay talebi yoluyla tam veya kısmi bir iptal gönderiyor.
Tam iptal
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"rejectionReason": "TemporarilyUnavailable"
}
]
}
]
}
]
}
Kısmi iptal
{
"acknowledgements": [
{
"purchaseOrderNumber": "L8266355",
"sellingParty": {
"partyId": "999US"
},
"acknowledgementDate": "2019-07-17T20:10:34.304Z",
"items": [
{
"itemSequenceNumber": "1",
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "10.2"
},
"itemAcknowledgements": [
{
"acknowledgementCode": "Accepted",
"acknowledgedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"scheduledShipDate": "2019-07-17T19:17:34.304Z"
},
{
"acknowledgementCode": "Rejected",
"acknowledgedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"rejectionReason": "TemporarilyUnavailable"
}
]
}
]
}
]
}
Sonraki kısmi iptalden sonra satın alma siparişi durumu
{
"payload": {
"ordersStatus": [
{
"purchaseOrderNumber": "L8266355",
"purchaseOrderStatus": "OPEN",
"purchaseOrderDate": "2019-07-16T19:17:34.304Z",
"lastUpdatedDate": "2019-07-17T19:17:34.304Z",
"sellingParty": {
"partyId": "999US"
},
"shipToParty": {
"partyId": "NAG1"
},
"itemStatus": [
{
"itemSequenceNumber": "1",
"buyerProductIdentifier": "ABC123434",
"vendorProductIdentifier": "028877454078",
"netCost": {
"amount": "10.2",
"currencyCode": "USD"
},
"listPrice": {
"amount": "10.2",
"currencyCode": "USD"
},
"orderedQuantity": {
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"orderedQuantityDetails": [
{
"updatedDate": "2019-07-16T19:17:34.304Z",
"orderedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
},
"acknowledgementStatus": {
"confirmationStatus": "PARTIALLY_ACCEPTED",
"acceptedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"acknowledgementStatusDetails": [
{
"acknowledgementDate": "2019-07-17T19:17:34.304Z",
"acceptedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 0,
"unitOfMeasure": "Cases",
"unitSize": 5
}
},
{
"acknowledgementDate": "2019-07-17T20:10:34.304Z",
"acceptedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": 5
},
"rejectedQuantity": {
"amount": 7,
"unitOfMeasure": "Cases",
"unitSize": 5
}
}
]
}
}
]
}
]
}
}
Tedarikçi Kargoları API'si nedir?
Kullanabilirsiniz Satıcı Gönderileri API'si Gönderiyle ilgili belgeleri Amazon ile değiştirmek için (Gönderiler API'si).
Kargolar API'sine aşağıdaki işlemler dahildir:
İşlem | HTTP Yöntemi | Path | Açıklama |
---|---|---|---|
SubmitShipmentConfirmations
|
POST | /vendor/shipping/v1/shipmentConfirmations |
Amazon'a bir veya daha fazla kargo onayı gönderin. |
GetShipmentDetails
|
GET | /vendor/shipping/v1/shipments |
Amazon'a gönderilen nakliye talebi için gönderi ayrıntılarını alın. Veri alma, gönderi talebinin oluşturulduğu tarihten itibaren en fazla altı ay süreyle mümkündür. |
SubmitShipments
|
POST | /vendor/shipping/v1/shipments |
Amazon'a tek veya birden fazla ulaşım isteği gönderin. |
SubmitShipmentConfirmations
SubmitShipmentConfirmations
Kullanabilirsiniz SubmitShipmentConfirmations
Amazon'a gönderi onaylarını gönderme işlemi. Sevkiyat onayınız ile gönderilerinizi verimli bir şekilde alabilir ve işleyebiliriz. Satın alma siparişi numarası, gönderim tarihi, tahmini teslimat tarihi, lot numarası, son kullanma tarihi ve Seri Nakliye Konteyner Kodu (SSCC) dahil olmak üzere gönderilen öğeler hakkında bilgiler içerir.
Geçerli ve zamanında bir gönderi onayı alarak, bize gönderdiğiniz gönderileri doğru bir şekilde tahmin edebiliriz. Gönderi onaylarını göndermenin bazı avantajları şunlardır:
-
Amazon, gönderilerinizi takip etmek ve almak için taşıyıcılarla daha etkili işbirliği yapabilir. Bu, işgücü kaynaklarımızı etkili bir şekilde planlamamıza olanak tanır ve gönderinizin daha hızlı ve daha verimli bir şekilde alınmasını sağlamaya yardımcı olur, bu da PoS'larınızı daha hızlı faturalandırabileceğiniz anlamına gelir.
-
Amazon, gelen envanteri takip edebilir ve ürünlerin stokta kalmamasını sağlamak için otomatik siparişler oluşturabilir.
-
Ürün kullanılabilirliğini (döneme göre teslimat) son müşterilere daha doğru bir şekilde yansıtmamızı sağlayan nakliye sırasında ürünlerde daha fazla görünürlük.
-
Amazon'un PO iptal politikalarıyla, ödenmemiş PO gönderileri iptal edilebilir. Ancak, doğru sevkiyat onayına sahip Po'lar, dahili sistemlerimizi nakliye durumu konusunda uyarır. Bu, gereksiz PO iptallerini, geri ödemeleri ve navlun reddini önlemeye yardımcı olabilir.
Geçerli bir kargo onayının olmaması şunlara neden olabilir:
- Gelen kargolar için yetersiz görünürlük.
- Fiziksel gönderimlerin satın alma siparişleri ile mutabakatında hatalar.
- Tutarsızlıkları gidermek için manuel takip işlemleri.
- Faturalandırma için teslimat kanıtı (POD) sağlama ihtiyacı.
Kargo Onayı - Değiştir
Bir gönderi onayında bir shipmentConfirmationType
dan Replace
, güncellenmiş bir sürüm göndererek önceden gönderilen gönderi onaylarını düzeltebilirsiniz. İkinci gönderi onay çağrısı, ilk gönderi onay verilerinin üzerine tamamen yazacaktır.
Ana avantajı, ilk kargodan sonra hatalı kargo onaylarını güncelleyerek rezervasyon doğruluğunu artırmaktır.
İşleyiş şekli nasıldır?
Daha önce gönderilen bir gönderi onayını değiştirmek için ikinci bir gönderi onayı gönderilebilir. shipmentIdentifier
ve sellingParty.partyId
Her iki iletim için de aynı olması gerekir, böylece sevkiyat onayının önceki sürümünün üzerine başarıyla yazabiliriz.
Sevkiyat Onayının Kapsamı - Değiştirin
-
Tüm gönderi onay değerleri aşağıdakiler dışında düzenlenebilir:
shipmentIdentifier
vesellingParty.partyId
, başarılı bir Gönderim Onayı için aynı kalması gereken - Değiştir. -
Palet, karton ve kargo miktarı artırılamaz ancak azaltılabilir. Hacimleri artırmak için yeni bir
shipmentIdentifier
ile ikinci bir kargo onayı göndermeniz gerekir. Ek birimler aynı kargoyla teslim edilecekse aynı BOL referansını kullanabilirsiniz. -
API kullanılarak gönderilen bir gönderi onayı, yalnızca API kullanılarak başka bir gönderi onayı gönderilerek düzenlenebilir. İçinde oluşturulmuş bir gönderi onayı Satıcı Merkezi API kullanılarak düzenlenemez.
-
Kargo onayının değiştirilmesi yalnızca ilk kargo onayından sonraki 7 gün içinde ve yalnızca kargo henüz Amazon lojistik merkezine ulaşmamışsa mümkündür.
Başarıyla gönderilen kargo onaylarının doğrulanması
Orijinal veya değiştirilen gönderi onaylarınızın durumunu şu şekilde doğrulayabilirsiniz: Satıcı Merkezi > Siparişler > Gönderiler veya İşlem Durumu API'sini kullanarak. Sistemin gönderildikten sonra orijinal/değiştirilen sürümü göstermesi 30 dakikaya kadar sürebilir. Eğer Satıcı Merkezi değiştirilen gönderi onayı için doğru değerleri göstermiyor, açın Contact Us içinde vaka Satıcı Merkezi.
Aşağıdaki şemada, kargo onaylarını gönderirken kullanılan entegrasyon iş akışını gösterilmektedir.
İşletme gereksinimleri
-
Bir satıcı ağırlıkça satılan ürünleri gönderdiğinde, şunları sağlamalıdır:
totalWeight
alan. ThetotalWeight
alan, satıcının gönderdiği öğelerin ağırlığını ve ağırlık ölçü birimini içerir. Ölçüm değerlerinin ağırlık birimi şunları içerir:POUNDS
,OUNCES
,GRAMS
, veKILOGRAMS
. -
Her kamyon hesabı kargo için 100 kargo onayı sınırı vardır. Bu, yalnızca söz konusu kamyon hesabı kargosu (TL)/parsiyel yük (LTL) gönderimi için toplam bağımsız kargo onayı sayısı 100'den az veya buna eşitse PO düzeyinde ya da karton düzeyinde ayrı kargo onayları gönderebileceğiniz anlamına gelir. Tüm PO ve koli ayrıntılarını içeren TL/LTL kargosunun tamamı için tek bir kargo onayı göndermenizi öneririz.
-
Amazon, ürün Amazon Lojistik Merkezi'ne ulaşmadan önce kargo onayını almalıdır. Kargo onayının eksik olması veya gecikmesi ters ibrazlara neden olacaktır.
-
Küçük Koli kargolarında her paket/koli için bir kargo onayı gereklidir.
-
Aşağıdakiler Amazon tarafından gereklidir ve uyumluluğu izlemek için ölçülür:
- Paletli teslimatlar için Amazon gönderim merkezinde bir teslimat yeri talep etmeden önce bir gönderi onayı göndermeniz gerekir, çünkü randevular yalnızca Amazon sistemlerinde geçerli bir gönderi onayı bulunursa sağlanır. İstisnalar için yerel gönderi onayına bakın Yardım mevcut seçenekleri anlamak için sayfalar. Parseller için, öğeler gönderilmeden önce gönderi onayının gönderilmesi gerekir. Eksik veya gecikmiş gönderi onayı, geri ödemelere neden olur.
- Bir gönderi onayı, tek bir satıcıdan ve yalnızca bir kamyon için teslimat için olmalıdır. Birden çok kamyonda, birden çok Amazon gönderim merkezine, birden çok satıcı hesabından veya birden çok günde varış yapan gönderiler birden fazla gönderi onayı gerektirir.
- Aynı satıcı hesabı için birkaç küçük gönderi daha büyük bir gönderide birleştirilirse ve birden fazla gönderi onayı gerekiyorsa, aşağıdaki örnekte gösterildiği gibi şemsiye BOL seçeneğini kullanabilirsiniz:
Sevkiyat Onayı 1
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1"
Sevkiyat Onayı 2
"billOfLadingNumber": "BOL1"
"shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"
Ülkeye özel işletme gereksinimleri
İşlevsellik | İşletme Tanımı | Hindistan | Avrupa | Kuzey Amerika |
---|---|---|---|---|
Konşimento Numarası/Teslimat Teklifi |
BOL numarası, satıcı tarafından atanan benzersiz numaradır. Sevkiyat onayında bulunan BOL, gönderiyle birlikte verilen BOL kağıdıyla ideal olarak eşleşir, ancak bu gerekli değildir. Bakınız Ek alan açıklamaları daha fazla bilgi için. BOL referansı randevu rezervasyonu ve gönderi etiketi oluşturma için kullanılır. Teslimat Teklifi numarası, bir gönderi için referans numarası olarak BOL'a bir alternatiftir. |
Koşullu |
Tüm kargo onayları için zorunludur. | FTL veya LTL gönderileri için zorunludur. |
Taşıyıcı Kargo Referans Numarası (PRO #) | PRO numarası (Pro Numarası) taşıyıcı tarafından atanan benzersiz bir numaradır. Teslimat için giden kargoyu tanımlamak ve izlemek üzere kullanılır. | Tüm kargo onayları için zorunludur. | İsteğe bağlı | Tüm kargo onayları için zorunludur. |
Kargoya Verilme Tarihi | Kargonun satıcının deposundan ayrıldığı tarih. |
Tüm kargo onayları için zorunludur. |
Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Tahmini Teslim Tarihi |
Kargonun Amazon Lojistik Merkezi'ne ulaşmasının beklendiği tarih. Bunun, kargonun gönderildiği konum ile varış noktası arasındaki ortalama geçiş süresine dayalı bir tahmin olması gerekir. Kesin randevu saati Amazon tarafından sağlanacaktır ve kargo oluşturulurken potansiyel olarak bilinmemektedir. |
Tüm kargo onayları için zorunludur. |
Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Koli Sayısı | Kargoda bulunan karton sayısı. Palet üzerinde dış koli olmadan istiflenen birimler 1 birim = 1 koli olarak sayılır. Koli sayısı kargo düzeyinde gereklidir. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Palet Sayısı | Kargoda bulunan palet sayısı. Saf koli gönderileri için 0 değerinin belirtilmesi gerekir. Bir palet üzerinde FC'ye ulaşan tüm birimlerin bu segmentte en az "1" olarak belirtilmesi gerekir. Bu bilgiler kargo düzeyinde gereklidir. | Paletli teslimatlar için tüm kargo onaylarında zorunludur. | Tüm kargo onayları için zorunludur. | FTL ve LTL gönderileri için zorunludur. |
Standart taşıyıcı Alfa Kodu (SCAC) | Kargonun taşıyıcısını tanımlayan kod. Standart Taşıyıcı Alfa Kodu (SCAC), bir taşıyıcıyı tanımlamak için kullanılan iki ila dört harfli benzersiz bir koddur. Taşıyıcı SCAC kodları NMFTA (Ulusal Motorlu Taşımacılık Trafiği Birliği) tarafından atanır ve muhafaza edilir. | İsteğe bağlı | İsteğe bağlı | Tüm kargo onayları için zorunludur. |
Kargo Konumu (Gönderim Yapılan) | Ürünlerin gönderildiği konumun Taraf Kimliği/Depo Kodu. API şeması alan adı "shipToParty" şeklindedir. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Tedarikçi Kimliği | Malları Amazon'a gönderen tedarikçinin tedarikçi kimliği. API şeması alan adı "SellingParty" şeklindedir. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. | İsteğe bağlı |
Gönderen Konumu | Ürünlerin fiziksel gönderiminin yapıldığı yerin adresi (posta kodu) ve ülke referansı. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Amazon Referans Numarası (yalnızca WePay Kargoları için). | Yönlendirme talimatlarında alınan Amazon Referans Numarası (GetShipmentDetails yanıt) bir WePay Gönderisi için. |
Sadece kargo onayları için zorunludur (WePay Kargoları için). |
Sadece kargo onayları için zorunludur (WePay Kargoları için). |
Toplama Kargoları için zorunludur. |
Satın Alma Siparişi Numarası | Amazon Satın Alma Siparişi Numarası. Bir tedarikçinin ürünleri belirli bir fiyattan göndermesi için verilen ve tedarikçi kabul ettiğinde yasal olarak bağlayıcı bir sözleşme haline gelen yazılı yetki. | Başlık veya satır öğesi düzeyinde zorunludur. | Başlık veya satır öğesi düzeyinde zorunludur. | Başlık veya satır öğesi düzeyinde zorunludur. |
Seri Kargo Konteyner Kodu (SSCC) | Paleti/Koliyi tanımlamak için dahil edilecek benzersiz 18 haneli Seri Kargo Konteyner Kodu (SSCC). | Paketleme birimi içindeki tüm kargo onayları için önerilir. | Paketleme birimi içindeki tüm kargo onayları için zorunludur. | Paketleme birimi içindeki tüm kargo onayları için zorunludur. |
Ürün Tanımlama | Ürünün Tedarikçi SKU'su. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Lot Numarası | Parti veya lot numarası, ürünleri üreticinin Öğe Dizesi'nin uygulandığı ticari ürünün izlenebilirliği için ilgili olduğunu düşündüğü bilgilerle ilişkilendirir. Veriler ticari ürünün kendisine veya içerdiği ürünlere atıfta bulunabilir. | Bozulabilir Ürünler için zorunlu. | Bozulabilir Ürünler için zorunlu. | Bozulabilir Ürünler için zorunlu. |
Son Kullanma Tarihi | Ürünün tüketim veya kullanım sınırını belirleyen tarih. Anlamı, ticari ürün bağlamına göre belirlenir. | Bozulabilir Ürünler için zorunlu. | Bozulabilir Ürünler için zorunlu. | Son Kullanma Tarihi veya Üretici Tarihi ve Raf Ömrü gereklidir. |
Üretim Tarihi | Üretici tarafından belirlenen Üretim, Paketleme veya Montaj Tarihi. Anlamı, ticari ürün bağlamına göre belirlenir. | İsteğe bağlı | İsteğe bağlı | Son Kullanma Tarihi veya Üretici Tarihi ve Raf Ömrü gereklidir. |
Miktar | Belirli bir ürün için gönderilen birim sayısı. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. | Tüm kargo onayları için zorunludur. |
Ek alan açıklamaları
Konşimento numarası
Konşimento numarası (BOL#), Amazon'da randevu rezervasyonu için gereken referans numarasıdır. Amazon geçerli bir gönderi onayı istediğinde bu referans sağlanmalıdır. Fiziksel gönderiye eşlik eden belge için varsayılan referans numarasıdır. Sevkiyat onayındaki BOL#, gönderi belgelerinde verilen BOL# ile eşleşmelidir.
BOL# değerini tanımlarken, her gönderi için benzersiz olduğundan emin olun. BOL#, fiziksel BOL referansı olabilir, ancak farklı bir sayı seçerseniz:
- En az sekiz basamak kullanın.
- Amazon tedarikçi kodunu ön ek olarak kullanma (örneğin: ABCD193939393).
- Tarih veya saat kullanmayın.
Kargo Tanımlama
Bu alan, bu gönderi onayını temsil eden benzersiz bir kimliktir (benzersizlik satıcı bağlamında tanımlanır). Bir sağlanamama Shipment Identification
gönderi onayının reddedilmesine neden olur. Gönderilen kimliğin son 365 gün içinde kullanılmadığından emin olun.
Kargoya Verilme Tarihi
Bu alan, gönderinin satıcının bulunduğu yerden kalkış tarihini gösterir. Satıcılardan, navlun Amazon FC'ye ulaşmadan önce gönderi onaylarını göndermeleri istenir.
Tahmini Teslim Tarihi
Bu, bir kargonun Amazon lojistik merkezine ne zaman teslim edilmesinin beklendiğine dair deneyime dayalı kaba bir tahmindir. Satıcıların bunu, taşıyıcının ortalama nakliye süresine göre belirlemesi gerekir. Bu bilgiler, kargo firmasından Tahmini Teslim Tarihi alamazsak kargo için planlama yapmamıza yardımcı olur.
Bu aşamada randevu tarihi potansiyel olarak bilinmese bile, her kargo için bu tarihin verilmesi gerekmektedir.
Seri Kargo Konteyner Kodu (SSCC)
Amazon, Plaka veya LP Receive adı verilen son derece otomatik bir yaklaşım kullanarak makbuzları işler ve bu işlem, gönderi onay mesajlarınızda karton içerik ayrıntılarını sağlamanızı gerektirir. Bu gerekli alım süreci, alınan ürünlerin kartonunun veya paletinin dışındaki bir Seri Gönderi Konteyner Kodu (SSCC) barkodunu tarar ve karton veya palet içindeki her öğeyi tarama ihtiyacını ortadan kaldırır. Bu süreç, artan verimlilik, gelişmiş alım doğruluğu, daha doğru ödeme ve daha hızlı ödeme döngüsü süresi gibi bir dizi önemli avantaja sahiptir.
Amazon, GS1-128 çözümünü kesinlikle takip etmemeye karar verdiği için teknik bir çözüm seçebilirsiniz. Amazon Plaka gereksinimlerine uymak için, bir SSCC'nin bir palet veya kartonu tanımlayan benzersiz bir 18 basamaklı kod olması gerekir, 365 gün içinde tekrarlanamaz ve hem karton etiketinde hem de gönderi onay mesajında bir barkod içermelidir. Ek olarak, fiziksel etiket üzerindeki barkod, sevkiyat onayında SSCC ile %100 eşleşmelidir. GS1-128'i uygulamak isteyen satıcılardan bir tane eklemeleri istenir 00
sevkiyat onayı dahilinde SSCC'lerinin başında.
Bir SSCC oluşturma ve fiziksel gönderi için gereksinimler hakkında daha fazla bilgi için bkz. Satıcı Merkezi. Etiketleme gereksinimlerini içeren Satıcı Kılavuzunu bulmak için seçin Nakliye, o zaman Plaka etiketi ve alma gereksinimleri.
Son Kullanma Tarihi
Son kullanma tarihi, bir ürünün tüketim veya kullanım sınırını belirleyen tarihtir. Ticari ürün bağlamına göre belirlenir (örneğin, gıda için bu tarihten sonra ürünün kullanımından kaynaklanan doğrudan bir sağlık riski olasılığını gösterir, farmasötik ürünler için bu tarihten sonra ürünün etkisizliğinden kaynaklanan dolaylı bir sağlık riski olasılığını gösterir). Genellikle "son kullanım tarihi" veya "maksimum dayanıklılık tarihi" olarak adlandırılır.
Üretim Tarihi
Bu, malların paketlendiği veya üretildiği tarihtir. Bir ürün çabuk bozulabiliyorsa veya tanımlanmış bir raf ömrüne sahipse bu alan sağlanmalıdır.
Lot Numarası
Parti veya parti numarası, bir öğeyi, üreticinin ürünün kendisinin veya öğede bulunan bileşenlerin izlenebilirliği için uygun gördüğü bilgilerle ilişkilendirir.. Sayı bir üretim partisini, bir iş vardiyasını, bir makineyi, bir zamanı veya bir dahili üretim kodunu gösterebilir.
Kargo onayında Son Kullanma Tarihi/Üretim Tarihi/Lot Numaralarının kullanılması
Bu alanlar yalnızca bozulabilir öğeler için, yani aşağıdaki öğeler için zorunludur. is expiration dated product
öznitelik Yes
Yeni öğe kurulumu (NIS) formunda.
Gönderim onayında Son Kullanma Tarihleri, Üretim Tarihleri veya Lot Numaralarını tanımladığınızda:
-
Son Kullanma Tarihleri/Üretim Tarihleri/Lot Numaraları ürün düzeyinde gönderilmelidir.
-
Bir kasa/palet, her biri ayrı Son Kullanma Tarihleri/Üretim Tarihleri/Lot Numaraları olan birden fazla ürüne (ASIN) sahip olabilir.
-
Bir ürün (ASIN) aynı Kasa/Palet içinde birden fazla Son Kullanma Tarihine/Üretim Tarihine/Lot Numarasına sahip olmamalıdır.
Satıcıların kargo onayında Son Kullanma Tarihi ve Üretim Tarihini "YYYYAAGG" biçiminde belirtmesi gerekir.
Kargo Onayı kullanım senaryoları
Son kullanma tarihi ve lot numaralı küçük paket standart çantası
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseStandardCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"estimatedDeliveryDate": "2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698889"
}
],
"cartonSequenceNumber": " 002",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
]
}
]
}
Küçük LooseAssortmentCase
son kullanma tarihi ve lot numaralı parsel
LooseAssortmentCase
son kullanma tarihi ve lot numaralı parsel{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "LooseAssortmentCase",
"transportationDetails": {
"carrierScac": "UPSN",
"billOfLadingNumber": "02440000"
},
"amazonReferenceNumber": "ARN_Number",
"shipmentConfirmationDate": "2019-07-29T21:56:18.575Z",
"shippedDate": "2019-07-29T21:56:18.575Z",
"estimatedDeliveryDate": "2019-07-29T21:56:18.575Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"cartonCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"amazonProductIdentifier": "AB1234233",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
},
{
"itemSequenceNumber": "002",
"amazonProductIdentifier": "AB1234235",
"vendorProductIdentifier": "VN24343370",
"shippedQuantity": {
"amount": 50,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2019-11-29T21:56:18.575Z"
}
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": " 001",
"trackingNumber": "UPS TRACKING NUMBER",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 1
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 10,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
]
}
]
}
]
}
Birden fazla ürünün yer aldığı paletli tır yükü
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "TruckLoad",
"shipmentStructure": "PalletizedAssortmentCase",
"transportationDetails": {
"transportationMode": "Road",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "VENDORWAREHOUSECODE"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "250"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"palletCount": 2
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
},
{
"itemSequenceNumber": "002",
"vendorProductIdentifier": "9782700001000",
"shippedQuantity": {
"amount": 400,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACC",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698999"
}
],
"cartonSequenceNumber": "002",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698669"
}
],
"cartonSequenceNumber": "003",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697799"
}
],
"cartonSequenceNumber": "004",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAACD",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "89.00"
},
"handlingCode": "Oversized"
}
},
{
"itemReference": "002",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAADD",
"lotNumber": "1087",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "120.00"
},
"handlingCode": "Oversized"
}
}
]
}
],
"pallets": [
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"tier": 1,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"001",
"002"
]
}
},
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098700"
}
],
"tier": 1,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "55"
},
"cartonReferenceDetails": {
"cartonCount": 2,
"cartonReferenceNumbers": [
"003",
"004"
]
}
}
]
}
]
}
Paletli standart kutuların bulunduğu parsiyel tır yükü
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "00050003",
"shipmentConfirmationType": "Original",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletizedStandardCase",
"transportationDetails": {
"transportationMode": "Road",
"billOfLadingNumber": "02440000"
},
"shipmentConfirmationDate": "2019-08-07T19:56:45.632Z",
"shippedDate": "2019-08-07T19:56:45.632Z",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "VENDORWAREHOUSECODE"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"grossShipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
},
"palletCount": 1
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "9782700001659",
"shippedQuantity": {
"amount": 100,
"unitOfMeasure": "Eaches",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "1BBBAAAA",
"lotNumber": "1045",
"maximumRetailPrice": {
"currencyCode": "EUR",
"amount": "299.00"
},
"handlingCode": "Oversized"
}
}
],
"cartons": [
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666698888"
}
],
"cartonSequenceNumber": "001",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666699999"
}
],
"cartonSequenceNumber": "002",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666696666"
}
],
"cartonSequenceNumber": "003",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
},
{
"cartonIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567666697777"
}
],
"cartonSequenceNumber": "004",
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 25,
"unitOfMeasure": "Eaches",
"unitSize": 1
}
}
]
}
],
"pallets": [
{
"palletIdentifiers": [
{
"containerIdentificationType": "SSCC",
"containerIdentificationNumber": "00102234567898098745"
}
],
"tier": 2,
"block": 2,
"dimensions": {
"length": "1.2",
"width": "0.8",
"height": "1",
"unitOfMeasure": "In"
},
"weight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"cartonReferenceDetails": {
"cartonCount": 4,
"cartonReferenceNumbers": [
"001",
"002",
"003",
"004"
]
}
}
]
}
]
}
Tek ASIN Paletlerin kamyon yükünden daha az sevkiyatı
{
"shipmentConfirmations": [
{
"shipmentIdentifier": "5013088794",
"shipmentConfirmationType": "Original",
"shipmentType": "LessThanTruckLoad",
"shipmentStructure": "PalletOfItems",
"transportationDetails": {
"carrierShipmentReferenceNumber": "1021396377",
"billOfLadingNumber": "501308879400010001",
"transportationMode": "Road"
},
"shipmentConfirmationDate": "2023-04-21T22:31:43Z",
"shippedDate": "2023-04-21T22:31:43Z",
"estimatedDeliveryDate": "2023-04-21T22:31:43Z",
"sellingParty": {
"partyId": "VENDORCODE"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCED"
},
"shipToParty": {
"partyId": "AMZWAREHOUSECODE"
},
"shipmentMeasurements": {
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "181.656"
},
"palletCount": 3,
"grossShipmentWeight": {
"unitOfMeasure": "Lb",
"value": "3315.744"
}
},
"shippedItems": [
{
"itemSequenceNumber": "001",
"vendorProductIdentifier": "VN24343334",
"shippedQuantity": {
"amount": 315,
"unitOfMeasure": "Cases",
"unitSize": 1
},
"itemDetails": {
"purchaseOrderNumber": "PO1234BD",
"lotNumber": " 12345",
"expiry": {
"expiryDate": "2024-11-29T21:56:18.575Z"
}
}
}
],
"pallets": [
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297459",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
},
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297589",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
},
{
"tier": 10,
"palletIdentifiers": [
{
"containerIdentificationNumber": "108195730651297595",
"containerIdentificationType": "SSCC"
}
],
"weight": {
"unitOfMeasure": "Lb",
"value": "828.936"
},
"block": 15,
"items": [
{
"itemReference": "001",
"shippedQuantity": {
"amount": 105,
"unitOfMeasure": "Cases",
"unitSize": 1
}
}
],
"dimensions": {
"unitOfMeasure": "In",
"length": "44.375",
"width": "39.750",
"height": "40.500"
}
}
]
}
]
}
SubmitShipments
SubmitShipments
Önemli
SubmitShipments
sadece Kuzey Amerika ve AB pazarlarında mevcuttur.
SubmitShipments
Operasyon, Collect veya WePay satıcılarının gönderilerinin Amazon tarafından teslim alınmasına ilişkin taleplerde bulunmaları için tasarlanmıştır. Bu işlemle gönderilen istekleri de güncelleyebilir veya iptal edebilirler. Tek bir gönderi talebi aracılığıyla gönderilmeye hazır olan birden fazla siparişi birleştirebilir ve böylece zamandan tasarruf edebilir ve maliyetleri düşürebilirsiniz. Bir gönderi talebi gönderirken, istenen teslim alma tarihi, geçerli tarihten en az iki iş günü sonra olmalıdır.
Not
SubmitShipments
operasyon standart olmayan paletler için gönderi taleplerinin gönderilmesini desteklemez.
Gönderi oluşturma veya güncelleme
Ne zaman transactionType
bir gönderi talebi için New
, yeni bir istek oluşturabilir veya önceden gönderilmiş bir gönderi isteğini güncelleyebilirsiniz. Mevcut bir gönderi talebinde yapılan güncellemeler, Satıcı Gönderi Kimliğine göre yapılır. Sağlanan satıcı gönderi kimliğine sahip bir gönderi zaten mevcutsa, bir güncelleme işlemi gerçekleşir; aksi takdirde yeni bir gönderi oluşturulur.
Güncelleme sevkiyatının kapsamı:
- Tüm gönderi isteği değerleri düzenlenebilir, hariç
vendorShipmentIdentifier
,buyerReferenceNumber
, vesellingParty.partyId
başarılı bir güncelleme için aynı kalması gerekir. Taşıyıcı atanmadan önce gönderi talebindeki diğer tüm alanları değiştirme esnekliğine sahipsiniz. - Sevkiyat talebinde istenen teslim alma tarihi ancak taşıyıcı atandıktan sonra değiştirilebilir.
Gönderiyi İptal Et
İle bir gönderi talebi transactionType
olarak Cancel
önceden gönderilmiş bir gönderi isteğini iptal etmenizi sağlar. Daha önce gönderilen bir gönderi talebini iptal etmek için, sağlamanız gerekir vendorShipmentIdentifier
, buyerReferenceNumber
, sellingParty.partyId
, shipFromParty.partyId
, shipToParty.partyId
ve transactionType
olarak Cancel
.
Sevkiyat İptal Kapsamı:
- Bir gönderi talebini iptal etmek, bir taşıyıcı atanmadan ve yönlendirme planlanmasından önce ve sonra mümkündür.
Başarıyla gönderilen gönderi taleplerinin doğrulanması
Sen kullanıyorsun Satıcı Merkezi ya da Satıcı İşlem Durumu API'si gönderi talebinizin durumunu doğrulamak için. Gönderilen isteğin durumu 30 dakika sonra görünmüyorsa, şu adrese giderek Satıcı Merkezi'nde bir destek talebi gönderin. Vendor Central > Support > Contact Us > API Integration.
Not
İşlem Durumu API'si yalnızca destekler
Processing
veFailure
gönderilen durum değerleri Gönderiyi İptal Et istekler.
Aşağıdaki diyagram, gönderi taleplerini gönderirken entegrasyon iş akışını göstermektedir.
İşletme gereksinimleri
- Sevkiyat talebi yalnızca ilgili PO tamamen onaylandığında gönderilmelidir. PO henüz onaylanmamışsa, gönderi talebi işleme alınmayacaktır.
-
requestedPickUp
Sevkiyat talebinde, geçerli tarihten en az iki iş günü sonra olmalıdır. - Tüm gönderi isteği değerleri düzenlenebilir, hariç
vendorShipmentIdentifier
,buyerReferenceNumber
, vesellingParty.partyId
, başarılı bir güncelleme için aynı kalması gerekir. Taşıyıcı atanmadan önce gönderi talebindeki diğer tüm alanları değiştirme esnekliğine sahipsiniz. - Gönderim isteğinde istenen teslim alma tarihini ancak bir taşıyıcı atandıktan sonra değiştirebilirsiniz.
- Bir gönderi talebini iptal etmek, bir taşıyıcı atanmadan ve yönlendirme planlanmasından önce ve sonra mümkündür.
Ek alan açıklamaları
Satıcı Gönderi Tanımlayıcısı
Bu alan, bu Taşıma İsteğini temsil eden benzersiz bir kimliktir (benzersizlik satıcı bağlamında tanımlanır). Bir sağlanamama vendorShipmentIdentifier
Taşıma Talebinin reddedilmesine neden olur. Gönderilen kimliğin son 365 gün içinde kullanılmadığından emin olun.
Talep Edilen Teslim Tarihi
Bu alan olarak da adlandırılır Freight Ready Date
, satıcının bulunduğu yerden en erken gönderi teslim alma tarihini belirtmek için kullanılır. Öğeler teslim alınmaya hazır olduğunda Ulaşım Talebini göndermeniz istenir.
Gönderi örneği isteklerini gönderin
Gönderi isteği oluşturma veya güncelleme
{
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"transactionType": "New",
"transactionDate": "2019-08-07T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "PQRSS"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "999US"
},
"shipToParty": {
"partyId": "ABCDF"
},
"shipmentMeasurements": {
"totalCartonCount": 30,
"totalPalletStackable": 30,
"totalPalletNonStackable": 30,
"shipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
}
},
"collectFreightPickupDetails": {
"requestedPickUp": "2019-08-07T19:56:45.632"
},
"purchaseOrders": [
{
"purchaseOrderNumber": "1BBBAAAA"
},
{
"purchaseOrderNumber": "1BBBACCC"
}
]
}
]
}
Gönderim Talebini İptal Et
{
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"buyerReferenceNumber": "1234567",
"transactionType": "Cancel",
"transactionDate": "2019-08-07T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "PQRSS"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "999US"
},
"shipToParty": {
"partyId": "ABCDF"
}
}
]
}
GetShipmentDetails
GetShipmentDetails
Önemli
GetShipmentDetails
yalnızca WePay içindir ve Kuzey Amerika ve AB pazarlarındaki siparişleri toplar.
Kullanabilirsiniz GetShipmentDetails
planlanmış teslim alma ve taşıyıcı atama bilgilerini alma işlemi. Kullanmalısın SubmitShipments
veya sevkiyat detayları mevcut olmadan önce bir yönlendirme talebi. GetShipmentDetails
yalnızca, planlanan teslim alma işlemiyle aynı gün veya teslim alma tarihinden bir gün önce gerçekleşen taşıyıcı atamasından sonra bir yanıt döndürür.
Yanıtta iade edilen ayrıntılar, kargo sürecinizi verimli bir şekilde yürütmenize, siparişin paketlendiğinden ve atanan teslim alma tarihinde taşıyıcı tarafından teslim alınmaya hazır olduğundan emin olmanıza yardımcı olur. Gönderi yaşam döngüsü boyunca istediğiniz zaman, gönderi durumunu ve ayrıntılarını görüntülemek için bu işlemi kullanabilirsiniz. Bu işlem öncelikle WePay satıcıları tarafından kullanılır.
Aşağıdaki şemada Satıcı Alın gönderi entegrasyonu iş akışı gösterilmektedir.
İşletme gereksinimleri
-
The
GetShipmentDetails
işlem yalnızca gönderi oluşturma başarılı olursa yanıt sağlar. Yanıt, Amazon Referans Numarasını (ARN) ve diğer gönderi ayrıntılarını içerir. Taşıyıcı atama ayrıntıları, yalnızca gönderi için taşıyıcı atamasından sonra kullanılabilir. Taşıyıcı ataması, planlanan teslim alma işlemiyle aynı gün veya teslim alma tarihinden bir gün önce gerçekleşir. -
GetShipmentDetails
operasyon, aracılığıyla gönderilen gönderiler için ayrıntı sağlamayacaktır Satıcı Merkezi.
GetShipmentDetails
zorunludur
GetShipmentDetails
zorunludurMüşteri faturası döndürmek için GetShipmentDetails
işlemini çağırın ve şu parametreyi geçirin:
Sorgu parametreleri:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
limit |
Döndürülen kayıt sayısının sınırı. Tür: tamsayı |
Hayır |
sortOrder |
Listeyi gönderi oluşturma tarihine göre artan veya azalan sırada sıralayın. Tür: dize Tür: numaralandırma ( |
Hayır |
nextToken |
Belirtilen sonuç boyutu sınırından daha fazla gemi etiketi olduğunda sayfalama için kullanılır. Belirteç değeri önceki API çağrısında döndürülür. Tür: dize |
Hayır |
createdAfter |
Bu süreden sonra oluşturulan gönderiler sonuca dahil edilecektir. Bu alan içinde olmalı İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
createdBefore |
Bu saatten önce oluşturulan gönderiler sonuca dahil edilecektir. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
shipmentConfirmedBefore |
Bu tarihten önce onaylanan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
shipmentConfirmedAfter |
Bu tarihten sonra onaylanan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
packageLabelCreatedBefore |
Bu tarihten önce paket etiketlerinin oluşturulduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: string (Boolean) |
Hayır |
packageLabelCreatedAfter |
Bu tarihten sonra paket etiketlerinin oluşturulduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
shippedBefore |
Gönderim tarihi bu tarihten önce olan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
shippedAfter |
Gönderim tarihinin bu tarihten sonra olduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
estimatedDeliveryBefore |
Tahmini teslimat tarihi bu tarihten önce olan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
estimatedDeliveryAfter |
Bu tarihten sonra tahmini teslimat tarihi olan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
shipmentDeliveryBefore |
Bu tarihten önce gönderi teslim tarihi olan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
shipmentDeliveryAfter |
Gönderinin teslimat tarihinin bu tarihten sonra olduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
requestedPickUpBefore |
Talep edilen teslim alma tarihi bu tarihten önce olan tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
requestedPickUpAfter |
Talep edilen teslim alma tarihinin bu tarihten sonra olduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
scheduledPickUpBefore |
Planlanan teslim alma tarihinin bu tarihten önce olduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
scheduledPickUpAfter |
Planlanan teslim alma tarihinin bu tarihten sonra olduğu tüm gönderilerin Gönderim Ayrıntılarını alma tarihini sağlamak için kullanın. Bu alan içinde olmalıdır İSO 8601 tarih/saat biçimi. Tür: dize (tarih-saat) |
Hayır |
currentShipmentStatus |
Geçerli gönderi durumunu geçerek Gönderi Ayrıntılarını alın. Tür: dize |
Hayır |
vendorShipmentIdentifier |
Satıcı Gönderi Kimliğini ileterek Gönderim Ayrıntılarını Alın. Tür: dize |
Hayır |
buyerReferenceNumber |
Alıcı Referans Kimliğini ileterek Gönderim Ayrıntılarını Alın. Tür: dize |
Hayır |
buyerWarehouseCode |
Alıcı depo koduna göre Nakliye Ayrıntılarını alın. Bu değer ile aynı olmalıdır shipToParty.partyId Sevkiyatta. Tür: dize |
Hayır |
sellerWarehouseCode |
Satıcı depo koduna göre Nakliye Ayrıntılarını alın. Bu değer ile aynı olmalıdır sellingParty.partyId Sevkiyatta. Tür: dize |
Hayır |
İstek örneği:
GET https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments?vendorShipmentIdentifier=00050003
GetShipmentDetails
örneği:
GetShipmentDetails
örneği:Yanıt örneği:
{
"payload": {
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"shipments": [
{
"vendorShipmentIdentifier": "00050003",
"buyerReferenceNumber": "1234567",
"currentShipmentStatus": "CarrierAssigned",
"currentshipmentStatusDate": "2019-08-09T19:56:45.632",
"shipmentStatusDetails": [
{
"shipmentStatus": "CarrierAssigned",
"shipmentStatusDate": "2019-08-09T19:56:45.632"
},
{
"shipmentStatus": "TransportationRequested",
"shipmentStatusDate": "2019-07-07T19:56:45.632"
},
{
"shipmentStatus": "Created",
"shipmentStatusDate": "2019-07-06T19:56:45.632"
}
],
"shipmentCreateDate": "2019-07-06T19:56:45.632",
"shipmentFreightTerm": "Collect",
"sellingParty": {
"partyId": "998US"
},
"shipFromParty": {
"address": {
"name": "ABC electronics warehouse",
"addressLine1": "DEF 1st street",
"city": "Lisses",
"stateOrRegion": "abcland",
"postalCode": "91090",
"countryCode": "DE"
},
"partyId": "ABCD12"
},
"shipToParty": {
"partyId": "999US"
},
"shipmentMeasurements": {
"totalCartonCount": 30,
"totalPalletStackable": 30,
"totalPalletNonStackable": 30,
"shipmentWeight": {
"unitOfMeasure": "Kg",
"value": "120.45"
},
"shipmentVolume": {
"unitOfMeasure": "CuFt",
"value": "2.4"
}
},
"collectFreightPickupDetails": {
"requestedPickUp": "2019-08-10T19:56:45.632",
"scheduledPickUp": "2019-08-10T19:56:45.632",
"carrierAssignmentDate": "2019-08-09T19:56:45.632",
},
"purchaseOrders": [
{
"purchaseOrderNumber": "1BBBAAAA"
}
],
"transportationDetails": {
"shipMode": "LessThanTruckLoad",
"transportationMode": "Road",
"shippedDate": "2019-08-07T19:56:45.632",
"estimatedDeliveryDate": "2019-08-07T19:56:45.632",
"shipmentDeliveryDate": "2019-08-07T19:56:45.632",
"carrierDetails": {
"name": "UPS",
"phone": "1234567890",
"email": "abc@xyz.com",
"code": "string",
"shipmentReferenceNumber": "TRACK001"
},
"billOfLadingNumber": "string"
}
}
]
}
}
GetShipmentLabels
GetShipmentLabels
Kullanabilirsiniz GetShipmentLabels
Collect/WEPay satıcıları adına yalnızca küçük parsel gönderileri için Amazon'dan nakliye etiketleri alma işlemi. Bu işlem satıcıların, satıcının deposundan Amazon'un deposuna gönderilmesi gereken onaylanmış siparişler için kargo etiketlerini almasına yardımcı olur. Satıcılar, etiketleri tek bir API çağrısı veya birden çok API çağrısı yoluyla alabilir. Gönderim talebi tamamlandıktan ve bir taşıyıcı atandıktan sonra etiketler oluşturulur. Satıcılar, Amazon tarafından oluşturulan etiketleri alıcı referans numaraları (Amazon referans numaraları olarak da bilinir), satıcı depo kodları ve diğer değerler gibi çeşitli parametrelere göre filtreleme seçeneğine sahiptir.
Aşağıdaki diyagram, satıcı gönderi etiketi entegrasyonu iş akışını göstermektedir.
İşletme gereksinimleri
- Arayın
GetShipmentLabels
sadece bir taşıyıcı atandıktan sonra. - Eğer
GetShipmentLabels
bir etiket iade etmez veya iade ederResource Not Found
, bir taşıyıcının atandığını doğrulayın. Alternatif olarak, arayabilirsinizGetShipmentDetails
taşıyıcının atanıp atanmadığını doğrulamak için. - Bir taşıyıcı atanmışsa ve işlem hala etiket vermiyorsa, Satıcı Merkezi portalında bir “Bize Ulaşın” davası açın.
- Bir etiket nakliye için kullanıldıktan sonra, asla tekrar kullanılamaz.
Ülkeye özel işletme gereksinimleri
Bu API işlemi yalnızca NA bölgesinde kullanılabilir.
Sorgu isteği
Kargo etiketlerinin listesini almak için GetShipmentLabels
işlemini çağırın ve şu parametreleri geçirin:
Ad | Açıklama | Zorunlu mu? |
---|---|---|
limit |
Döndürülen kayıt sayısının sınırı. Tür: tamsayı |
Hayır |
sortOrder |
Listeyi artan veya azalan sırada gönderi etiketi oluşturma tarihine göre sıralayın. Tür: dize Tür: numaralandırma ( |
Hayır |
nextToken |
Belirtilen sonuç boyutu sınırından daha fazla sipariş olduğunda sayfalandırma için kullanılır. Kod değeri bir önceki API çağrısında döndürülür. Tür: dize |
Hayır |
labelCreatedAfter |
Bu süreden sonra oluşturulan gönderi etiketleri sonuca dahil edilecektir. Bu alan ISO 8601 tarih/saat biçiminde olmalıdır. Tür: dize (tarih-saat) |
Hayır |
labelCreatedBefore |
Bu saatten önce oluşturulan gönderi etiketleri sonuca dahil edilecektir. Bu alan ISO 8601 tarih/saat biçiminde olmalıdır. Tür: dize (tarih-saat) |
Hayır |
buyerReferenceNumber |
Alıcı Referans Kimliğini ileterek Gönderi etiketlerini alın. Tür: dize |
Hayır |
vendorShipmentIdentifier |
Satıcı Gönderi Kimliğini ileterek Gönderi etiketlerini alın. Tür: dize |
Hayır |
sellerWarehouseCode |
Satıcı depo koduna göre Kargo etiketlerini alın. Bu değer ile aynı olmalıdır sellingParty.partyId Sevkiyatta. Tür: dize |
Hayır |
İstek örneği
GET /vendor/shipping/v1/transportLabels?vendorShipmentIdentifier=7822
GetShipmentLabels Yanıtı
{
"payload": {
"pagination": {
"nextToken": "MDAwMDAwMDAwMQ=="
},
"transportLabels": [
{
"labelCreateDateTime": "2024-10-23T17:10:35Z",
"shipmentInformation": {
"vendorDetails": {
"sellingParty": {
"partyId": "WAD47"
},
"vendorShipmentIdentifier": "7822"
},
"buyerReferenceNumber": "14511336331",
"shipToParty": {
"partyId": "LAX9"
},
"shipFromParty": {
"partyId": "0-55767831",
"address": {
"name": "Wheeler Bros., Inc. HQ",
"addressLine1": "384 Drum Ave",
"addressLine2": "Suite 123",
"addressLine3": "DOOR 1",
"city": "Somerset",
"stateOrRegion": "PA",
"postalCode": "15501",
"countryCode": "US"
}
},
"masterTrackingId": "1ZR873R70319165935",
"totalLabelCount": 1,
"shipMode": "SmallParcel"
},
"labelData": [
{
"labelSequenceNumber": 1,
"labelFormat": "PDF",
"carrierCode": "UPSN",
"trackingId": "1ZR873R70319165935",
"label": "Base 64 encoded string goes here."
}
]
}
]
}
}
Satıcı Faturaları API'si nedir?
Kullanabilirsiniz Satıcı Faturaları API'si, ödemeyle ilgili belgeleri Amazon ile değiştirmek için. Faturaları Gönder işlemiyle onaylanmış ve gönderilen siparişler için satıcı faturalarını Amazon'a gönderebilirsiniz.
Şu işlemler dahildir:
İşlem | HTTP Yöntemi | Path | Açıklama |
---|---|---|---|
submitInvoices | POST | /vendor/payments/v1/invoices | Bir veya daha fazla tedarikçi faturasını Amazon'a gönderir |
Not
submitInvoices
operasyon Avrupa'da kredi notu göndermek için kullanılabilir.
Fatura Gönderme
Kullanabilirsiniz submitInvoices
Gönderilen ürünler için Amazon'dan ödeme talep etme işlemi. Bu işlemi tek bir API çağrısında birden fazla fatura göndermek için kullanabilirsiniz.
Ürünler ancak onaylandıktan ve Amazon'a gönderildikten sonra faturalandırılmalıdır. Aksi takdirde fatura reddedilir.
Doğru bilgileri içeren bir fatura Amazon, tarafından herhangi bir insan etkileşimi olmadan işlenir. Bu da tedarikçinin ödemeyi daha hızlı alacağı anlamına gelir.
Yanlış bilgiler içeren faturalar Amazon'un alacaklı sisteminde reddedilir, bu nedenle doğru bilgilerin gönderilmesi önemlidir. Doğru bilgilerle nasıl fatura oluşturacağınızı öğrenmek için işletme gereksinimleri bölümünü inceleyin.
Fatura gönderiminin paralel testleri
Kullanmaya başlamadan önce ödeme sistemimizle paralel testi tamamlamanız gerekir. submitInvoices
ödeme işlemleri için işlem.
API'yi kullanarak fatura göndermeye başladığınızda paralel test aşaması başlar. Paralel test aşamasında, gönderilen tüm siparişler için Satıcı Merkezi ve API faturaları gönderirsiniz. En az beş ila 10 fatura dosyasının içeriği doğrulanana kadar paralel test yapmanız gerekir. Üretim PO'ları ve faturalar ile paralel testler yapılır.
Amazon Borç Hesapları (AP) ekibi, paralel test tamamlandığında veya faturalarınızda herhangi bir içerik tutarsızlığı olduğunda sizinle iletişime geçecektir.
Paralel testlerin tamamlandığını belirten bir e-posta aldığınızda, artık Vender Central faturalarını göndermenize gerek kalmaz; Fatura göndermek için API'yi kullanabilirsiniz.
Başarıyla gönderilen faturaların doğrulanması
İşlem Durumu API'si Gönderilen faturalar için anlamsal doğrulamaların durumunu gösterir, ancak fatura işlemenin gerçek durumunu göstermez. Faturaların orijinal veya güncellenmiş versiyonunun gerçek durumunu şu şekilde doğrulayabilirsiniz: Satıcı Merkezi > Ödemeler > Faturalar. Nasıl kullanılacağı hakkında daha fazla bilgi için İşlem Durumu API'si, İşlem Durumu için iş kullanım durumu belgelerine bakın. Güncellenen fatura için doğru değerlere sahip orijinal veya güncellenmiş sürüm 30 dakika sonra mevcut değilse, Satıcı Merkezi'nde şu adrese giderek bir destek talebi gönderin. Vendor Central > Support > Contact Us > API Integration.
Aşağıdaki şemada, onaylanmış ve gönderilen bir sipariş için fatura gönderilirken kullanılan entegrasyon iş akışını gösterilmektedir.
İşletme gereksinimleri
-
Ağırlığa göre fiyatlandırdığınız ürünler için şunları sağlamalısınız:
totalWeight
alan. ThetotalWeight
alan, faturalandırılan öğenin toplam ağırlığını içerir. bunlara ek olarak,netCostUnitOfMeasure
alan, ağırlıkça fiyatlandırdığınız öğelerin ölçü birimini yansıtmalıdır. Ölçü birimi değerleri şunları içerir:POUNDS
,OUNCES
,GRAMS
, veKILOGRAMS
. -
Fatura numaraları benzersiz olmalı ve asla tekrar kullanılmamalıdır (bir yıl sonra bile).
-
API tarafından gönderilen bir fatura yanlış veriler nedeniyle başarısız olursa, ancak Satıcı Merkezi faturası doğru verilere sahipse, faturayı API aracılığıyla aynı verileri kullanarak doğru verilerle güncellemeniz gerekir. Invoice ID.
-
Bir faturada hatalı veriler varsa (hem Satıcı Merkezi hem de API), fatura iptal edilir ve yeni bir fatura ile birlikte gönderilmelidir. Invoice ID.
-
"
total amount = 0
= 0" olan bir fatura, faturanın geçersiz olmasına neden olacağından gönderilmemelidir. -
Amazon, vergi uyumluluğu nedeniyle adres segmentlerinde tam adres ayrıntılarını gerektirir. Bu özellikle önemlidir bill to party. Bu segment için Amazon Payee sistemi tam bir eşleşme gerektirir. Adreslerin listesi için bkz. Parti Adreslerine SP-API Faturası.
-
Faturada gönderilen ödeme koşulları, Amazon alıcısıyla üzerinde anlaşmaya varılan ödeme koşullarıyla eşleşmelidir.
-
Ürün tanımlayıcısı, eşleşen satın alma siparişinde satıcıya gönderilen sipariş öğesi ürün tanımlayıcısıyla eşleşmelidir.
-
Fatura toplam tutarı ürünlerin, maliyetlerin ve ödeneklerin toplamına eşit olmalıdır.
-
Her satır düzeyi için vergi tutarı toplamı, başlık düzeyindeki vergi tutarı toplamına eşit olmalıdır.
-
Fatura toplam miktarı, tüm ürünlerin miktarlarının toplamıyla eşleşmelidir.
-
Her bir farklı ücret ve ödenek, başlık düzeyinde detaylandırılmalıdır (ör. navlun ücreti, paket ücreti, küçük sipariş ücreti)
Uyarı
Bir havale adresi, Amazon'un dosyasında bulunan adresle eşleşmelidir. Adres eşleşmiyorsa fatura başarısız olur.
Ülkeye özel işletme gereksinimleri
İşlevsellik | Hindistan | Avrupa | Kuzey Amerika |
---|---|---|---|
Fatura Türü | Fatura türü CreditNote desteklenmiyor. Fatura türü her zaman olmalıdır Invoice . |
Fatura türleri Invoice ve CreditNote desteklenmektedir. Satıcıların fatura türünü buna göre göndermesi gerekir. |
Fatura türü CreditNote desteklenmiyor. Fatura türü her zaman olmalıdır Invoice . |
Alacak Dekontu Referansları | Kullanılmıyor | Fatura türü ise, satıcıların bu referansları öğe düzeyinde göndermeleri gerekir. CreditNote . |
Kullanılmıyor |
Tarih | Olmalı now veya daha önce. |
Olmalı now veya daha önce. |
Olmalı now veya daha önce. |
HSN Numarası | Vergi Uyumlu Faturalar için Uyumlaştırılmış İsimlendirme Sistemi (HSN) kodu zorunludur. İzin verilen maksimum uzunluk sekiz karakterdir. | Kullanılmıyor | Kullanılmıyor |
Satır ve başlık düzeyinde Vergi Türü | Vergi türü için şu değerlere izin verilir:
Vergi bilgisi verilmezse fatura reddedilir. |
Gönderilecek vergi türü. | Kullanılmıyor |
Vergi Kayıt Numarası | 15 karakterlik bir GST kimliği sağlanmalıdır. | KDV Numarası | KDV Numarası |
Satır ve başlık düzeyinde vergi ayrıntıları | Bir ürüne birden fazla vergi uygulanabilirse "Vergi ayrıntıları" bölümü ilgili ürün için uygun vergi türüyle birlikte birden fazla kez gönderilmelidir. Aynısı faturanın toplam tutarı için de geçerlidir. |
Bir ürüne birden fazla vergi uygulanabilirse "Vergi ayrıntıları" bölümü ilgili ürün için uygun vergi türüyle birlikte birden fazla kez gönderilmelidir. Aynısı faturanın toplam tutarı için de geçerlidir. Ayrıca adı verilen ek bir vergi türü de vardır. |
Bir ürüne birden fazla vergi uygulanabilirse "Vergi ayrıntıları" bölümü ilgili ürün için uygun vergi türüyle birlikte birden fazla kez gönderilmelidir. Aynısı faturanın toplam tutarı için de geçerlidir. |
Havale Yapılacak Taraf | Amazon'a mal tedarik eden ve ödemeyi alacak olan taraf. Tedarikçi olarak da adlandırılır. | Gönderilen ürünler (fatura olması durumunda) veya iade edilen ürünler (alacak dekontu olması durumunda) için ödeme alacak olan tarafın (satıcı) vergi ve adres bilgileri. Bu alan zorunludur. | Gönderilen ürünler için ödeme alacak olan tarafın (satıcı) vergi ve adres bilgileri. Bu alan zorunludur. |
Kargoyu Gönderen Taraf | Eyalet ISO Kodu ile birlikte Kargonun Gönderildiği Adres ayrıntıları. Vergi kayıt numarasında GST Kimliği gönderilmelidir. Kargoyu Gönderen Taraf zorunludur. Değerler Amazon'un sistemlerindeki değerlerle eşleşmelidir. |
Satıcı kodu veya depo kodu ve ürünlerin gönderileceği tarafın adresi. | Satıcı kodu veya depo kodu ve ürünlerin gönderileceği tarafın adresi. |
Gönderim Yapılan Taraf | Eyalet ISO Kodu ile birlikte Kargonun Gönderildiği Adres ayrıntıları. Gönderim yapılan taraf zorunludur. Değerler Amazon sistemlerindeki değerlerle eşleşmelidir. |
Ürünlerin gönderileceği tarafın Amazon kimliği veya depo kodu ve adresi. | Ürünlerin gönderileceği tarafın Amazon kimliği veya depo kodu ve adresi. |
Faturalandırılacak Taraf | Faturalandırılacak Taraf zorunludur. Kargonun Gönderildiği Taraf ile aynı olabilir. Öyleyse satıcının her iki segmentte de aynı bilgileri göndermesi gerekir. | Gönderilen ürünler (fatura olması durumunda) veya iade edilen ürünler (alacak dekontu olması durumunda) için faturalandırılacak tarafın (Amazon) Vergi ve Adres bilgileri. Amazon faturalandırılacak taraf adreslerinin tam listesi ve JSON kodu örnekleri için SP-API faturalandırılacak taraf adresleri bölümünü inceleyin. Bu alan zorunludur. |
Gönderilen ürünler için faturalandırılacak tarafın (Amazon) vergi ve adres bilgileri. Bu alan zorunludur. |
Amazon Ürün Tanımlayıcısı ve Harici Ürün Tanımlayıcısı | Bu değerlerden en az biri gereklidir. Tanımlayıcı, siparişte alınanla aynı olmalıdır. | Bu değerlerden en az biri gereklidir. Tanımlayıcı, siparişte alınanla aynı olmalıdır. | Bu değerlerden en az biri gereklidir. Tanımlayıcı, siparişte alınanla aynı olmalıdır. |
Net Maliyet | Bu alan zorunludur. | Bu alan zorunludur. | Bu alan zorunludur. |
Satın Alma Siparişi Numarası | Faturalar yalnızca bir sipariş için bilgi içerebilir. Bu nedenle, bir faturadaki tüm satır öğeleri için PO numarası aynı olmalıdır. Zorunlu. |
Bir fatura birden fazla sipariş için bilgi içerebilir. PO numarası, farklı satır öğeleri için buna göre gönderilmelidir. Bu alan gereklidir fatura türü ise Invoice ve fatura türü olduğunda kullanılmaz CreditNote . |
Faturada birden fazla siparişle ilgili bilgiler bulunabilir. PO numarası farklı satır öğeleri için uygun şekilde gönderilmelidir. Zorunlu. |
Ek Ayrıntılar | Kullanılmıyor | Bu alan, satıcı tarafın özel amaçlar için ek ayrıntılar göndermesi gerektiğinde kullanılır. Örneğin, Polonya bölünmüş ödeme faturaları durumunda, satıcı tarafın ayrıntıyı göndermesi gerekir”mechanizm podzielonej płatności “tipte SUR ve languageCode “PL “. |
Kullanılmıyor |
referenceNumber | Her fatura için Hindistan Hükümeti tarafından oluşturulan benzersiz bir fatura referans numarası. Bu alan yalnızca Hindistan'daki faturalar için zorunludur. | Kullanılmıyor | Kullanılmıyor |
Faturalandırılacak taraf adresleri
Bir fatura gönderilirken, tarafa fatura adresi ayrıntılarının eksiksiz ve doğru biçimlendirilmiş olması gerekir, aksi takdirde API çağrısı başarısız olur. Konum faturası için Amazon Vergi Kimliğini bilmiyorsanız, bkz. Satıcı Merkezi yardım sayfaları.
Amazon faturasının taraf adreslerine ve JSON kodu örneklerinin tam listesi için bkz. Parti adreslerine SP-API faturası. Amazon'un vergi kimlikleri de dahil olmak üzere bu listeyi şu adreste bulabilirsiniz: EDI Kaynakları yardım sayfası Satıcı Merkezi hesabınızda.
Alacak dekontu
Kullanabilirsiniz Satıcı Faturaları API'si Amazon'a kredi notu göndermek için. Kredi notu, Amazon'a sağladığınız ancak Amazon'un iade ettiği veya almadığı ürün veya hizmetler için kabul edilen ürünleri, miktarları ve kararlaştırılan fiyatları listeler. Amazon ile satıcı arasında önceden ödenekler veya indirimler üzerinde anlaşmaya varıldığında, hasarlı mallar veya fiyat hataları durumunda bir kredi notu düzenlenebilir.
Amazon tarafından desteklenen alacak dekontları
Borç Hesapları (AP) KREDİ DEKONTLARI | Alacak Hesapları (AR) KREDİ DEKONTLARI |
---|---|
PPV kredisi
Faturalandırılan ancak alınmayan öğeler için kredi veya yinelenen ödemeler için kredi. |
İadeler
Örneğin hasarlı mallar, yanlış gönderilen mallar ve fazla stok nedeniyle satıcıya iade edilen ürünler için kredi. |
PPV kredisi
Daha yüksek/daha düşük maliyetle faturalandırılan ürünlerle ilgili kredi. |
COOP (örneğin, Fiyat Koruması, Hasar Ödeneği)
Satıcı tarafından Amazon'a ürünlerini satması veya fiyat koruma anlaşması için ödenen COOP Kredileri. |
Not
Kredi notları tüm yerlerde desteklenmez.
submitInvoices
Sınıfı
submitInvoices
SınıfıVergisiz birden fazla ürün içeren fatura
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "I5599913",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"city": "SAN RAFAEL",
"stateOrRegion": "CA",
"postalOrZipCode": "60693",
"countryCode": "US"
}
},
"shipToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"city": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "US"
}
},
"billToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON.COM",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"addressLine3": "string",
"city": "LEWISBERRY",
"stateOrRegion": "PA",
"postalOrZipCode": "17339",
"countryCode": "US"
}
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "2.00",
"discountDueDays": 30,
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "USD",
"amount": "1295"
},
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "040YP0U",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "140"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "0264CBS",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "USD",
"amount": "125"
},
"purchaseOrderNumber": "S8672793"
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "040YP0K",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Cases",
"unitSize": "5"
},
"netCost": {
"currencyCode": "USD",
"amount": "130"
},
"purchaseOrderNumber": "S8672793"
}
]
}
]
}
Bir ürün için tek vergi içeren fatura
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "5002841638",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "VENDORID",
"address": {
"name": "VENDORNAME",
"addressLine1": "PO BOX 1234",
"city": "TORONTO",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"city": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
}
},
"billToParty": {
"partyId": "AMAZONCA",
"address": {
"name": "AMAZON CANADA",
"addressLine1": "500 MCCARTHY DR",
"addressLine2": "FAIRVIEW BUSINESS PARK",
"addressLine3": "string",
"city": "MISSISSAUGA",
"stateOrRegion": "ON",
"postalOrZipCode": "M5W 5M5",
"countryCode": "CA"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 31
},
"invoiceTotal": {
"currencyCode": "CAD",
"amount": "1950"
},
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "97.5"
},
"taxableAmount": {
"currencyCode": "CAD",
"amount": "1950"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "1012380100000",
"invoicedQuantity": {
"amount": 4,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "1000570100000",
"invoicedQuantity": {
"amount": 30,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "50.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "2.50"
}
}
]
},
{
"itemSequenceNumber": 3,
"amazonProductIdentifier": "ABC123436",
"vendorProductIdentifier": "0543900100000",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "90"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "4.50"
}
}
]
},
{
"itemSequenceNumber": 4,
"amazonProductIdentifier": "ABC123437",
"vendorProductIdentifier": "1000570200000",
"invoicedQuantity": {
"amount": 5,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "CAD",
"amount": "20.00"
},
"purchaseOrderNumber": "Q6515853",
"taxDetails": [
{
"taxType": "GS",
"taxRate": "5",
"taxAmount": {
"currencyCode": "CAD",
"amount": "1.00"
}
}
]
}
]
}
]
}
Bir ürün için birden fazla vergi içeren fatura
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "8900000001234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "4TH FLOOR",
"city": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORTAXID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ123",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "Near Coal India Complex",
"city": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONTAXID"
}
]
},
"paymentTerms": {
"type": "Basic",
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "258262.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809000-0000",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.90",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.91",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
]
}
]
}
]
}
Vergiyle birlikte başlık düzeyi ve satır düzeyi ödenek/ücret ayrıntılarını içeren fatura
{
"invoices": [
{
"invoiceType": "Invoice",
"id": "0136981234",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ INDIA PRIVATE LIMITED",
"addressLine1": "4TH FLOOR",
"city": "GURUGRAM",
"stateOrRegion": "HR",
"postalOrZipCode": "122002",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "VENDORVATID"
}
]
},
"shipToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"countryCode": "IN"
}
},
"shipFromParty": {
"partyId": "XYZ12345",
"address": {
"name": "XYZ RETAIL PVT LTD",
"addressLine1": "Chowranghee Mansion JN Road",
"city": "Kolkata",
"stateOrRegion": "WB",
"postalOrZipCode": "700016",
"countryCode": "IN"
}
},
"billToParty": {
"partyId": "AMAZONIN",
"address": {
"name": "AMAZON INDIA",
"addressLine1": "Arrjaw Industrial & Warehouse Park",
"addressLine2": "Near Coal India Complex",
"city": "Hooghly",
"stateOrRegion": "WB",
"postalOrZipCode": "712310",
"countryCode": "IN"
},
"taxRegistrationDetails": [
{
"taxRegistrationType": "VAT",
"taxRegistrationNumber": "AMAZONVATID"
}
]
},
"paymentTerms": {
"type": "Basic",
"discountPercent": "5",
"discountDueDays": 15,
"netDueDays": 30
},
"invoiceTotal": {
"currencyCode": "INR",
"amount": "259678.39"
},
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "19697.98"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "218866.43"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "1200.00"
},
"taxDetails": [
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
},
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "108.00"
},
"taxableAmount": {
"currencyCode": "string",
"amount": "string"
}
}
]
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "809281-5100",
"invoicedQuantity": {
"amount": 2,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "21060.34"
},
"purchaseOrderNumber": "3DY3TK6T",
"hsnCode": "76.06.92.93",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "1895.43"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "21060.34"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
},
{
"itemSequenceNumber": 2,
"amazonProductIdentifier": "ABC123435",
"vendorProductIdentifier": "795000-0001",
"invoicedQuantity": {
"amount": 3,
"unitOfMeasure": "Eaches"
},
"netCost": {
"currencyCode": "INR",
"amount": "58915.25"
},
"purchaseOrderNumber": "3DY3TK6T",
"taxDetails": [
{
"taxType": "SGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
},
{
"taxType": "CGST",
"taxRate": "9",
"taxAmount": {
"currencyCode": "INR",
"amount": "5302.37"
},
"taxableAmount": {
"currencyCode": "INR",
"amount": "58915.25"
}
}
],
"chargeDetails": [
{
"type": "Freight",
"description": "Freight Charges",
"chargeAmount": {
"currencyCode": "INR",
"amount": "600.00"
}
}
]
}
]
}
]
}
Vergi içeren AB kredi dekontu
{
"invoices": [
{
"invoiceType": "CreditNote",
"id": "BasicCredit",
"date": "2019-07-24T21:17:59.821Z",
"remitToParty": {
"partyId": "AMAZON",
"address": {
"name": "AMAZON EU SARL, UK BRANCH",
"addressLine1": "1 PRINCIPAL PLACE WORSHIP STREET",
"city": "LONDON",
"postalOrZipCode": "EC2A 2FA",
"countryCode": "GB"
}
},
"billToParty": {
"partyId": "VendorCode",
"address": {
"name": "Vendor Name",
"addressLine1": "Vendor Address",
"city": "Vendor City",
"stateOrRegion": "Vendor State",
"postalOrZipCode": "Vendor ZIP Code",
"countryCode": "Vendor Country"
}
},
"invoiceTotal": {
"currencyCode": "GBP",
"amount": "100"
},
"taxDetails": [
{
"taxType": "VAT",
"taxRate": "10",
"taxAmount": {
"currencyCode": "GBP",
"amount": "10.00"
},
"taxableAmount": {
"currencyCode": "GBP",
"amount": "100.00"
}
}
],
"items": [
{
"itemSequenceNumber": 1,
"amazonProductIdentifier": "ABC123434",
"vendorProductIdentifier": "TESTSKU",
"invoicedQuantity": {
"amount": 1,
"unitOfMeasure": "Cases",
"unitSize": "10"
},
"netCost": {
"currencyCode": "GBP",
"amount": "100"
},
"creditNoteDetails": {
"referenceInvoiceNumber": "test-basic-ref",
"debitNoteNumber": "debit-ref",
"returnsReferenceNumber": "return-ref",
"goodsReturnDate": "2019-07-24T21:17:59.821Z",
"rmaId": "rma-ref",
"consignorsReferenceNumber": "VRET-ref"
}
}
]
}
]
}
Tedarikçi İşlem Durumu API'si nedir?
Kullanabilirsiniz Satıcı İşlem Durumu API'si POST işlemlerinizin işlem durumunu kontrol etmek için.
Şu işlemler dahildir:
.İşlem | HTTP Yöntemi | Path | Açıklama | |
---|---|---|---|---|
getTransaction | GET | /vendor/transactions/v1/transactionStatus/{transactionId} | İşlem sonrası isteğinin durumunu öğrenin. | Belirttiğiniz purchaseOrderNumber değerine göre bir satın alma siparişi (PO) döndürür. İşlemlerin durumu, orijinal POST çağrısının yapıldığı tarihten itibaren dört aya kadar olan veriler için kontrol edilebilir. |
İşlem Durumunu Alma
Tedarikçiler, bir POST işleminin durumunu kontrol etmek için bu API'yi kullanabilir. Sipariş Onayı veya Kargo Onayı gibi bir işlem, API kullanılarak Amazon'a gönderildiğinde yanıt, işlemi benzersiz şekilde tanımlayan bir işlem tanımlayıcısı içerir. Amazon, işlemi eşzamansız olarak işler ve nihai yanıt getTransaction
işlemi aracılığıyla kullanılabilir. İşlem durumunu almak üzere bu API'nin ne zaman çağrılacağını anlamak için ayrı API bölümlerindeki (ör. Tedarikçi Siparişleri ve Tedarikçi Kargoları) ilgili entegrasyon iş akışı şemalarını inceleyin.
Amazon, bu API aracılığıyla Sipariş Onayı ve Kargo Onayı gibi POST API işlemleri için son işlenme durumunu sunar. Satıcıların, işlemlerinin başarıyla işlendiğinden emin olmak için bu API'yi kullanarak durumu kontrol etmelerini önemle tavsiye ederiz. Hata oluşursa yanıt, hata bilgisi içerir. Daha sonra işlemi düzeltebilir ve yeniden gönderebilirsiniz.
İşlem Durumu | Tanım |
---|---|
İşleniyor | API işlemi Amazon tarafından alındı ve işleniyor. İşlem henüz tamamlanmadı. İşlemin tamamlanması için beklenen süre için her bir API işleminin SLA'sını kontrol edin. |
Başarılı | Bu durum yalnızca ABD ve AB'de Gönderi Onaylarını Gönder ve Gönderiyi Gönder için desteklenir. Başarı için desteklenmiyor submitAcknowledgement ve submitInvoices operasyonlar. |
Başarısız | API işlemi işleme sırasında başarısız oldu. Hata ayrıntıları, işlem durumu yanıt gövdesinde sağlanır. |
Not
İşlem durumu aşağıdaki API işlemleri için desteklenir:
İşlem durumu yalnızca şunları destekler Processing
ve Failure
durum değerleri. İşlem durumu ise Processing
, ve güncellenmedi Failure
15 dakika sonra, işlemin sistemlerimizde başarıyla işlendiğini gösterir.
Durum şu olduğunda genellikle bir işlemin bizim tarafımızdan başarıyla teslim edildiği kabul edilir. Processing
. Herhangi bir sebepten ötürü, Satıcı Merkezi durum mesajı gönderdikten sonraki 30 dakika içinde güncellenmez, kullanarak bir destek vakası açın Satıcı Merkezi POST çağrısında döndürülen işlem kimliğini sağlayarak. Kasayı açmadan önce gönderilen verilerin doğru formatta olduğundan emin olun.
Bu API'yi aşağıdakiler için kullanamazsınız Invoice
iletiler desteklenmedikleri için ve durum her zaman olacaktır Processing
. Ödeme ile ilgili sorularınız için önce check-in yapın Satıcı Merkezi, ve sonra bir oluşturun Contact Us içinde vaka Satıcı Merkezi ve ilgili kuyruğu seçin.
İşlem Durumu kullanım senaryoları
İşlem, işleniyor durumunda
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"status": "Processing"
}
}
}
İşlem başarıyla işlendi
İşlem, gönderildikten sonra 15 dakikadır işleniyor durumunda.
{
"payload": {
"transactionStatus": {
"transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477",
"status": "Processing"
}
}
}
İşlem Amazon'da başarısız oldu
{
"payload": {
"transactionStatus": {
"transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50",
"status": "Failure",
"errors": [
{
"code": "INVALID_ORDER_ID",
"message": "Invalid order ID."
}
]
}
}
}
Updated 23 days ago