Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Fatura Oluşturma ve Yükleme

VCS kaydı olan ve olmayan faturaları nasıl oluşturacağınızı ve yükleyeceğinizi öğrenin.

VCS'ye kaydolduktan sonra fatura oluşturmak ve yüklemek için iki seçeneğiniz vardır:

If you don't want to use VCS, you can use your own tax data to create invoices, then manually upload them using SP-API or through Seller Central. For instructions on how to use this method, refer to Manually upload invoices.

İpucu

Müşterilerin kafasını karıştırabileceğinden, faturalarda satıcı havalesi bilgilerini vermeyin. Amazon, ödemeleri doğrudan müşterilerden toplar ve tutarı satıcılara öder.

For information about invoice compliance requirements and invoice corrections, refer to VCS Invoice Compliance and Correction.

Amazon'un sizin için fatura oluşturmasına izin verin

Bu seçenek, KDV Hesaplama Hizmetine (VCS) kaydolan ve aşağıdakileri seçen tüm satıcılar için kullanılabilir. I want Amazon to generate invoices on my behalf seçeneği Amazon KDV Hesaplama Raporuna erişin. Bu rapor, fatura numarası, fatura bağlantısı, alıcı KDV'si ve gönderim/gönderime gönderim bilgileri dahil olmak üzere VCS siparişleri hakkında faydalı bilgiler içerir. Siparişler sevkiyattan üç gün sonra bu raporda mevcuttur. Satış Ortağı API'sini (SP-API) kullanarak VCS raporunu istemek için aşağıdaki tablodaki bilgileri kullanın.

APIRapor API'si
OperationcreateReport
ReportTypeSC_VAT_TAX_REPORT

VCS Programı aşağıdaki raporların içeriğini etkiler:

Sipariş raporları

KDV tutarını ekleyin

Talep ettiğiniz raporları sipariş edin sonra VCS'ye kaydolursanız aşağıdaki gibi görünür:

  • ItemTax (XML raporlarında) ve item_tax (düz dosya raporlarında). Amazon tarafından hesaplanan KDV tutarını içerir.
  • ItemPrice (XML raporlarında) ve item_price (düz dosya raporlarında). KDV dahil fiyatı içerir.

KDV hariç tutar, ürün fiyatından ürün vergisinin çıkarılmasıyla bulunur.

📘

Not

When the item tax is zero, 0% VAT was charged for the transaction. There are several circumstances in which this can happen. Examples include international transactions and B2B EU cross-border transactions. For more information, refer to VCS Calculation Methodology.

KDV ayrıntılarını ekleyin

Sipariş raporlarınıza VCS ile ilgili özellikleri eklemeyi seçebilirsiniz.

VCS ile ilgili özellikleri sipariş raporlarına dahil etmek için aşağıdaki prosedürü kullanın:

  1. Go to Add or remove order report columns in Seller Central.

  2. Ekle VAT details sütun.

Bu işlemi tamamladıktan sonra sipariş raporlarınıza aşağıdaki sütunlar eklenir: Item price VAT exclusive, Shipping price VAT exclusive, ve Gift wrap price VAT exclusive.

FBA (Amazon Lojistik) sipariş raporları

Talep ettiğiniz FBA sipariş raporları sonra VCS'ye kaydolursanız aşağıdaki gibi görünür:

  • ItemTax (XML raporlarında) ve item_tax (düz dosya raporlarında). Amazon tarafından hesaplanan KDV tutarını içerir.
  • ItemPrice (XML raporlarında) ve item_price (düz dosya raporlarında). KDV'ye münhasır tutarı içerir (KDV dahil tutardan değiştirildi).

KDV dahil tutar, ürün fiyatı artı ürün vergisidir.

Fatura oluşturmak için Amazon vergi hesaplama verilerini kullanın

Sadece bu seçeneği kullanabilirsiniz Satış Ortağı API'si (SP-API) ile faturalarınızı oluşturmak için Amazon tarafından sağlanan vergi verilerini kullanmanız gerekir.

1. Adım: Tüm siparişleriniz için vergi hesaplama verilerini KDV fatura veri raporundan (VIDR) çıkarın.

VIDR, işlem düzeyinde vergi hesaplama ayrıntılarını içeren bir rapordur ve yalnızca VCS'ye kaydolan satıcılar tarafından kullanılabilir. Bu rapor, ister satıcı tarafından gönderilen ister Amazon Tarafından Gönderilen (FBA) olsun tüm kargolarda doğru KDV faturası oluşturmak için gereken tüm bilgileri içerir. Gönderimi yapılan kargolar hemen bu raporda yer alır.

Use the createReport operation with the GET_FLAT_FILE_VAT_INVOICE_DATA_REPORT or GET_XML_VAT_INVOICE_DATA_REPORT report type (reportType).

reportOptions + pendingInvoices - all.

  • pendingInvoices: Bir Boole değeri. Hayır olduğunda ReportOption parametre belirtilir, varsayılan ReportOption=PendingInvoices. Örnek: "reportOptions": {"ReportOption=pendingInvoices": "true"}

    • Ne zaman true, rapor yalnızca faturaların ve kredi notlarının beklemede olduğu gönderileri içerir. Bu rapor, faturalarının başarıyla yüklenmiş gönderileri içermez. Bu, önceki 90 gün içinde verilen siparişlerin gönderilerini içerir.
    • Ne zaman false (veya PendingFaturas raportOptions'a dahil değilse), raporun içeriği şu değerine bağlıdır all.

    Bu raporlar, faturaların vadesi geçtiği ve yüklenmesi gereken son 90 gün içinde sipariş tarihlerine sahip gönderilen siparişlerin gönderi ayrıntılarını içerir (fatura durumunun olduğu tüm gönderiler InvoicePending veya CreditNotePending). Bu seçeneğe sahip raporlar, faturalarının başarıyla yüklenmiş gönderileri içermez. Bu seçeneğin amacı, satıcının kendi iş mantığını uygulamak zorunda kalmadan tüm satır öğelerini dolaşmasına ve faturalar oluşturmasına izin vermektir.

  • all: Bir Boole değeri. Varsayılan değer. Örnek: "reportOptions": {"ReportOption=All": "true"}

    • Ne zaman true, rapor, belirttiğiniz tarih aralığında verilen siparişlerin gönderilerini içerir. Bu, olası tüm fatura durumlarının gönderilerini içerir. Belirtmeniz gerekir startDate ve endDate için parametreler createReport operasyon. dataStartTime ve dataEndTime değerler belirtilen geçerli ilk ve son günlere karşılık gelmelidir reportPeriod. Örneğin, ne zaman reportPeriod=WEEK, dataStartTime Pazar günü olmalı ve dataEndTime Cumartesi olmalı. İzin verilen maksimum tarih aralığı 30 gündür.
    • Ne zaman false, veya eğer all dahil değildir reportOptions, raporun içeriği değerine bağlıdır pendingInvoices. Varsayılan değer "pendingInvoices" : "true".

    Bu raporlar mümkün olan tüm gönderileri içerir InvoiceStatus değerler. Buna şunlar dahildir:

    • İle gönderiler InvoiceStatus=InvoiceCreatedByAmazon. Amazon bu işlem için bir fatura düzenler, bu nedenle satıcının fatura yüklemesi gerekmez.
    • İle yapılan işlemler InvoiceStatus=NoTaxCalculated. Amazon bu işlem için vergi hesaplaması yapmadı. Bu, örneğin, ürün satıcının Seller Central'da geçerli bir KDV numarası sağlamadığı bir ülkeden gönderildiğinde gerçekleşir.

You can determine when to schedule these reports. To meet the SLA of 24 hours, you can create a schedule for every 12 hours. This ensures a maximum delay of 12 hours after a shipment is dispatched.

Sevkiyat gönderildikten sonra her gönderi için (her sipariş değil) bir fatura ödenmelidir. Bir gönderi aşağıdaki durumlardan birine sahip olabilir:

Fatura DurumuAçıklamaAction required
InvoicePendingKargo gönderildi.Satıcı, kargo için fatura yüklemelidir.
InvoiceProcessingSatıcı faturayı yükledi ve Amazon faturayı işliyor.Bu noktada satıcının herhangi bir işlem yapması gerekmez. Amazon faturayı işleme koyar.
InvoiceUploadedSatıcı faturayı yükledi ve Amazon, faturayı işlemeyi tamamladı. Herhangi bir hata tespit edilmedi.Satıcı tarafından herhangi bir işlem yapılması gerekmez. Fatura başarıyla yüklendi ve Siparişleriniz sayfasında müşteri tarafından erişilebilir. Müşteriler faturayı istedikleri zaman indirebilir.
InvoiceRejectedSatıcı faturayı yükledi ve Amazon, faturayı işlemeyi tamamladı. Yüklemede hatalar tespit edildi.Satıcı bu kargo için faturayı tekrar yüklemelidir.
CreditNotePendingPara iadesi durumunda, para alıcıya iade edilmiştir. İade durumunda ürün, FBA (Amazon Lojistik) siparişleri için Amazon'un Lojistik Merkezine ulaşmıştır veya satıcı tarafından gönderilen siparişlerde satıcı tarafından onaylanmıştır.Bu işlem için Alacak Dekontunun son tarihi şu andır.
CreditNoteProcessingSatıcı faturayı yükledi ve Amazon faturayı işliyor.Bu noktada satıcının herhangi bir işlem yapması gerekmez. Amazon alacak dekontunu işleme koyar.
CreditNoteUploadedSatıcı alacak dekontunu yükledi ve Amazon işlemi tamamladı. Herhangi bir hata tespit edilmedi.Satıcı tarafından herhangi bir işlem yapılması gerekmez. Alacak Dekontu başarıyla yüklendi ve Siparişleriniz sayfasında müşterinin kullanımına sunuldu.
CreditNoteRejectedSatıcı alacak dekontunu yükledi ve Amazon işlemeyi tamamladı. Yüklemede hatalar tespit edildi.Satıcı, bu işlem için Alacak Dekontunu tekrar yüklemelidir.
CreditNoteCreatedByAmazonAmazon bu işlem için bir kredi notu oluşturdu.Satıcının herhangi bir işlem yapmasına gerek yoktur.
NoTaxCalculatedAmazon bu işlem için herhangi bir vergi hesaplayamadı. Bu genellikle satıcı, gönderinin gönderildiği ülke için bir KDV numarası yüklemediğinde olur.Amazon KDV'yi hesaplamaz ve satıcının bu işlem için faturayı yüklemesi gerekir. Satıcı faturayı Satıcı Merkezi'ne veya SP-API ile yükleyebilir.
InvoiceCreatedByAmazonAmazon bu işlem için bir fatura oluşturdu.Satıcının herhangi bir işlem yapmasına gerek yoktur.

VIDR sütunları

VIDR örnek raporuReport link
XMLCSV

Aşağıdaki tabloda her VIDR sütunu açıklanmaktadır:

Alan adıTanımÖrnek
order-idAmazon'un benzersiz sipariş tanımlayıcısı. Kargo onayı ve sipariş sonrası işlemler için kullanılır.736-3563777-5518068
order-item-idAmazon'un benzersiz sipariş öğesi tanımlayıcısı. Kargo onayı ve sipariş sonrası işlemler için kullanılır.583563777345
shipping-idBu kargonun kargo kimliği.409302382
fulfilled-byBu siparişin lojistik kanalı.MFN or FBA
order-dateSiparişin verildiği tarih.17/05/2018
marketplace-idSiparişin verildiği pazaryeri.DE, FR, IT, ES
recipient-nameAlıcının adı.Mary Major
buyer-nameSatın alanın adı.Diego Ramirez
ship-service-levelÜrünü sipariş ederken alıcı tarafından ödenen lojistik hizmeti düzeyi. Örneğin, standart veya hızlandırılmış.Standard
ship-address-1Gönderim adresinin ilk satırı.123 Any Street
ship-address-2Gönderim adresinin ikinci satırı.Apt. 12
ship-address-3Gönderim adresinin üçüncü satırı.c/o Example Corp.
ship-cityGönderim adresinin bulunduğu şehir.Any City
ship-stateGönderim adresinin bulunduğu eyalet.Any State
ship-postal-codeGönderim adresinin posta kodu.SL1 1QP
ship-countryUluslararası standart iki harfli ülke kodu (ISO 3166 uyumlu).DE
ship-phone-numberGönderim adresinin telefon numarası.999999999
shipment-dateBu kargonun gönderim tarihi.20/05/2018
billing-nameFaturadaki ad.Márcia Oliveira
bill-address-1Fatura adresinin ilk satırı.100 Main Street
bill-address-2Fatura adresinin ikinci satırı.Apt. 12
bill-address-3Fatura adresinin üçüncü satırı.c/o AnyCompany
bill-cityFatura adresinin şehri.Any City
bill-stateFatura adresinin eyaleti.Any State
bill-postal-codeFatura adresinin posta kodu.U7D 294
bill-countryUluslararası standart iki harfli ülke kodu (ISO 3166 uyumlu).DE
bill-phone-numberFatura adresinin telefon numarası.44234343
ship-from-cityGönderen adresinin bulunduğu şehir.Any City
ship-from-stateGönderen adresinin bulunduğu eyalet.Any State
ship-from-countryGönderen adresinin bulunduğu ülke.DE
ship-from-postal-codeGönderen adresinin bulunduğu posta kodu.10178
skuStok bulundurma birimi. Ürünler için satıcı tarafından tanımlanmış benzersiz tanımlayıcı.sku123
product-nameÜrünün adı.DJI CP.PT.03342 Spark - Battery Charging Hub
quantity-purchasedSatın alınan miktar.1
currencyİşlem için kullanılan para birimi.EUR
asinÜrünün ASIN'i.AY39345YE8K
item-vat-incl-amountKDV dahil ürün fiyatı.120.00
item-vat-amountÜrün fiyatının KDV tutarı.20.00
item-vat-excl-amountKDV hariç ürün fiyatı.100.00
item-vat-rateÜrün fiyatının KDV oranı.0.20
gift-wrap-vat-incl-amountToplam KDV dahil hediye paketi.12.00
gift-wrap-vat-amountHediye paketinin toplam KDV tutarı.2.00
gift-wrap-vat-excl-amountToplam KDV hariç hediye paketi.10.00
gift-wrap-vat-rateHediye fiyatının toplam KDV oranı.0.20
shipping-vat-incl-amountKDV dahil kargo bedeli.6.00
shipping-vat-amountKargo bedelinin KDV tutarı.1.00
shipping-vat-excl-amountKDV hariç kargo bedeli.5.00
shipping-vat-rateKargo bedelinin KDV oranı.0.20
item-promo-vat-incl-amountToplam KDV dahil ürün promosyonu.-0.12
item-promo-vat-amountÜrün promosyonunun toplam KDV tutarı.-0.02
item-promo-vat-excl-amountToplam KDV hariç ürün promosyonu.-0.10
item-promo-vat-rateÜrün promosyonunun toplam KDV oranı.0.20
item-promotion-idÜrün tanıtımı için promosyon kimliği. Amazon tarafından oluşturulan alfanümerik bir değer.136643052:AKY54VWVKS3JCY6T
shipping-promo-vat-incl-amountToplam KDV dahil kargo promosyonu.-0.12
shipping-promo-vat-amountKargo promosyonunun toplam KDV tutarı.-0.02
shipping-promo-vat-excl-amountToplam KDV hariç kargo promosyonu.-0.10
shipping-promo-vat-rateKargo promosyonunun toplam KDV oranı.0.20
shipping-promotion-idNakliye promosyonunun promosyon kimliği. Amazon tarafından oluşturulan alfanümerik bir değer.3943834723:BWJRJERIUDKERU
gift-promo-vat-incl-amountToplam KDV dahil hediye paketi promosyonu.-0.20
gift-promo-vat-amountHediye paketi promosyonunun toplam KDV tutarı.-0.12
gift-promo-vat-excl-amountToplam KDV hariç hediye paketi promosyonu.-0.02
gift-promo-vat-rateHediye paketi promosyonunun toplam KDV oranı.0.10
gift-promotion-idHediye paketi promosyonunun promosyon kimliği.385934052:BWJRJDJSDS3JCY6T
transaction-idGönderiler için bu kargo kimliğidir. İadeler için bu, kargo kimliğinden farklı olan benzersiz bir işlem kimliğidir.409302382 (bir gönderi için); AMZN1: CROW: a0f6kwafsv6ymalmhe4vjw (iade veya geri ödeme için)
transaction-typeİşlem türü.SEVKIYAT, İADE veya GERI ÖDEME
is-amazon-invoicedAmazon'un bu işlem için bir Fatura oluşturup oluşturmayacağını belirtir. Satıcı VCS kullanıyorsa ve Amazon'un faturaları oluşturmasına izin verme seçeneğini belirlerse veya Amazon World Imports satıcıdan satın alırsa true değerini alır. Satıcı bu işlemler için Fatura oluşturmamalıdır. Amazon bir fatura oluşturur ve satıcının kullanımına sunar.TRUE veya FALSE
invoice-statusFaturanın durumu.Refer to Step 1 for details about invoice status.
invoice-status-descriptionFatura durumunun açıklaması.Refer to Step 1 for details about invoice status.
is-business-orderBu sipariş, Amazon İşletme web sitesinden veya B2C web sitesinden mi verildi?TRUE veya FALSE
purchase-order-numberPO numarası (müşteri tarafından sağlandıysa).AB45-234934 (can be any string)
seller-vat-numberKDV hesaplamasında kullanılan satıcı KDV numarası.DE111111111
buyer-vat-numberKDV hesaplamasında kullanılan alıcı KDV numarası.DE22222222 veya müşterinin Amazon'da KDV Numarası yoksa boş.
buyer-company-nameAlıcının şirket adı.AnyCompany
price-designationİşletme Fiyatı mı yoksa Standart Fiyat mı olduğunu gösterir.Business Price or Standard Price
invoice-numberSatıcı tarafından sağlanan fatura numarası. PendingInvoices olarak görünüyorsa fatura yüklenmediği için sütun boştur. All olarak görünüyorsa sütun, satıcı tarafından yüklenen fatura numarasını içerir.XXXX
legacy-customer-order-item-idBu sipariş öğesi kimliği, FBA (Amazon Lojistik) raporlarında ve MFN (Satıcıdan Gönderim) raporlarında bulunanla aynıdır. Bir VIDR'deki ayrı satır öğelerini FBA (Amazon Lojistik) veya MFN (Satıcıdan Gönderim) raporlarıyla eşleştirmek istiyorsanız bu sütunu kullanabilirsiniz.82840304120340
buyer-tax-registration-typeMüşterinin vergi türü (müşterinin vergi sicil numarası varsa).KDV, BusinessReg, CitizenID. İspanya ve İtalya pazarlarında işletmeler bir İşletme Kayıt Numarasına (BusinessReg) sahip olabilir ve bireyler vergi kimliklerine (CitizenID) sahip olabilir.
is-buyer-physically-presentMüşteri, vergi numarasının verildiği ülkede fiziksel olarak yerleşik ise doğrudur. buyer-vat-number sütun.TRUE veya FALSE
is-seller-physically-presentSatıcı, KDV numarasının verildiği ülkede fiziksel olarak yerleşik ise doğrudur. seller-vat-number sütun.TRUE veya FALSE
buyer-e-invoice-account-idMüşterinin e-fatura hesap kimliği. Müşteri bir e-fatura hesap kimliği sağladıysa [gerekirse faturayı Sistema di Interscambio'ya (SdI) göndermek için kullanılabilir] bu bilgi doldurulur. Bu sütun, 2019'da yürürlüğe giren İtalya e-fatura yasası için özel olarak eklenmiştir. Bu sayede satıcılar faturaları SdI'ye yükleyebilir.XXXXXXXX
recommended-invoice-formatVergi makamlarına gönderilecek önerilen fatura formatı. Değer PDF ise, PDF fatura biçimini Amazon'a yüklemeniz ve gerçek fatura kopyasıyla aynı PDF'yi kullanmanız gerekir. Önerilen biçim XML ise, Amazon müşterinin BT'de bir B2B Müşterisi olduğunu ve satıcının BT'de fiziksel olarak kurulduğunu belirlemiştir, bu nedenle satıcının İtalyan e-fatura yasasına göre Sistema di Interscambio'ya (SDi) bir XML fatura yüklemesi gerekir. SDi'de bulunan XML faturası, faturanın gerçek kopyası olarak kabul edilir. Ancak, Amazon'a bir PDF faturası da yüklemeniz gerekir. PDF, yinelenen bir fatura olduğunu belirtmek için ek metin veya filigran içermelidir. Müşteri orijinal faturayı SDi'den alabilir. Bu sütundaki değerden bağımsız olarak, satıcının her zaman Fatura Yükleme besleme türünü kullanarak Amazon'a bir PDF faturası yüklemesi gerektiğini unutmayın.PDF veya XML.
Citation-enBu sütun, alıntı metnini İngilizce olarak gösterir.Satıcının faturada verilen alıntı metnini kullanmasını öneririz. Satıcı, faturadaki dile bağlı olarak alıntı için kullanmak istediği dili seçebilir.
Citation-deBu sütun, alıntı metnini Almanca olarak gösterir.Satıcının faturada verilen alıntı metnini kullanmasını öneririz. Satıcı, faturadaki dile bağlı olarak alıntı için kullanmak istediği dili seçebilir.
Citation-esBu sütun, alıntı metnini İspanyolca olarak gösterir.Satıcının faturada verilen alıntı metnini kullanmasını öneririz. Satıcı, faturadaki dile bağlı olarak alıntı için kullanmak istediği dili seçebilir.
Citation-frBu sütun, alıntı metnini Fransızca olarak gösterir.Satıcının faturada verilen alıntı metnini kullanmasını öneririz. Satıcı, faturadaki dile bağlı olarak alıntı için kullanmak istediği dili seçebilir.
Citation-itBu sütun, alıntı metnini İtalyanca olarak gösterir.Satıcının faturada verilen alıntı metnini kullanmasını öneririz. Satıcı, faturadaki dile bağlı olarak alıntı için kullanmak istediği dili seçebilir.
Is-invoice-correctedBu işlemin daha önce düzeltilmiş bir faturaya atıfta bulunup bulunmadığını gösterir. Bu işlem önceki bir işlemin düzeltmesi ise doğrudur.TRUE veya FALSE
original-vat-invoice-numberFatura düzeltmesi gerektiren orijinal gönderinin fatura numarası.Orijinal fatura numarası.
invoice-correction-detailsFatura üzerindeki değişiklikleri açıklayan fatura değişiklik ayrıntıları. Bu yalnızca fatura değişiklik işlemi için geçerlidir.Orijinal KDV faturasındaki fatura adresi değiştirildikten sonra yeni bir fatura düzenlenir; veya orijinal KDV faturasındaki fatura adresini değiştirmek için bir kredi notu düzenlenir.

Adım 2. VIDR raporundaki verilerden kendi faturalarınızı oluşturun

VIDR raporunu indirin ve bilgileri KDV faturanızı derlemek için kullanın.

Adım 3. Feeds API'sini kullanarak faturaları Amazon'a yükleyin

Use the createFeed operation with the UPLOAD_VAT_INVOICE feed type (feedType).

İpucu

To get the marketplace IDs for your country, refer to Marketplace IDs.

için feedOptions, PDF faturası ile anahtar:değer çiftlerinde meta verileri belirtmeniz gerekir. İkisi de OrderId veya ShippingId bir fatura yüklediğinizde gereklidir (ShippingId Tercih edilir).

  • OrderId: Faturanın gönderildiği siparişin tanımlayıcısı.
  • ShippingId: Faturanın gönderildiği gönderinin tanımlayıcısı.

If you include OrderId and ShippingId, Amazon ignores the order ID and uploads the invoice with the shipping ID. If neither is provided, you might get an error. For help with errors, refer to Error Handling.

Aşağıdaki feedOptions vardır gereklidir:

  • TotalAmount. Faturadaki toplam tutar. Bu, tüm promosyonlar için KDV eksi ürünler, hediye paketi ve nakliye için KDV dahil fiyattır. Belirtilen toplam tutar Amazon'un bu gönderi için toplam tutarıyla eşleşmiyorsa (iki ondalık basamağa kadar) fatura yüklemesi reddedilir. VIDR"de sağlanan vergi hesaplamalarını kesinlikle takip etmenizi öneririz.
  • TotalVATAmount. Faturadaki toplam KDV tutarı. Bu, tüm promosyonlar için KDV eksi ürünler, hediye paketi ve nakliye için KDV'dir. KDV tutarı Amazon tarafından bu gönderi için hesaplanan KDV tutarıyla eşleşmiyorsa (iki ondalık basamağa kadar) fatura yüklemesi reddedilir. VIDR"de sağlanan vergi hesaplamalarını kesinlikle takip etmenizi öneririz.
  • InvoiceNumber. Faturada kullanılan fatura numarası. Bu fatura numarası müşterilerle paylaşılır. Satıcılar, faturada aynı fatura numarasının görünmesini sağlamalıdır.

Aşağıdaki feedOptions vardır isteğe bağlı:

  • DocumentType. Olası değerler:

    • Invoice. Bir fatura yüklüyorsanız bunu kullanın.
    • CreditNote. Geri ödeme veya iade için bir kredi notu yüklüyorsanız bunu kullanın.
      Varsayılan değer Invoice.
  • DocumentType=CreditNote olarak ayarlanmış TransactionId.

🚧

Dikkat

Anahtarların veya değerlerin etrafına tırnak işaretleri eklemeyin. Amazon yalnızca aşağıdaki karakterleri kabul eder: virgül (,), ileri eğik çizgiler (/), ters eğik çizgiler (\), boşluklar (), kısa çizgiler (-), alt çizgiler (_), noktalı virgül (;), kolon (:), hash'ler (#), 0-9, A-Z, a-z. Amazon fazladan alanı keser.

Faturalama Beslemesi için kısıtlama sınırı (UPLOAD_VAT_INVOICE) her üç saniyede bir fatura yüklemesidir.

Örnekler

Fatura yüklemeleri:

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}

Kredi notları (CN-123-ABC kredi notu numarasıdır):

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}

Feed seçeneklerini oluşturmak için Java kodu:

Map<String, String> feedOptions = new HashMap<>(); // building parameter map feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX"); feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT)); feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT)); feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER); String options = feedOptions.entrySet().stream() .map(e -> String.format("%s=%s", e.getKey(), e.getValue())) .collect(Collectors.joining(";")); File pdfD = new File("<PATH TO PDF>"); byte[] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "_UPLOAD_VAT_INVOICE_", options, ContentType.OctetStream); public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType) { SubmitFeedRequest request = new SubmitFeedRequest(); request.setContentMD5(contentMD5); request.setFeedContent(inputStream); request.setFeedOptions(feedOptions); request.setFeedType(feedType); request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces()); request.setMerchant(configuration.getAmazon().getSellerId()); request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken()); request.setContentType(contentType); return getMarketplaceWebServiceClient().submitFeed(request); }

Faturaları manuel olarak yükle

Seçen tüm satıcılar değil VCS'ye kaydolmak için API'yi veya Satıcı Merkezi'ni kullanarak kendi faturalarını Amazon'a yüklemek için varsayılan seçeneğe sahiptir. Bu bölümde API kullanımı açıklanmaktadır.

Faturaları manuel olarak yüklemek için, faturalarınızı oluşturmak için kendi vergi verilerinizi kullanmanız gerekir. Sen yapacaksın değil bir VIDR raporuna erişebilir.

Use the createFeed operation with the UPLOAD_VAT_INVOICE feed type (feedType).

İpucu

To get the marketplace IDs for your country, refer to Marketplace IDs.

için feedOptions, PDF faturası ile anahtar:değer çiftlerinde meta verileri belirtmeniz gerekir. İkisi de OrderId veya ShippingId bir fatura yüklediğinizde gereklidir (ShippingId Tercih edilir).

  • OrderId: Faturanın gönderildiği siparişin tanımlayıcısı.
  • ShippingId: Faturanın gönderildiği gönderinin tanımlayıcısı.

If you include OrderId and ShippingId, Amazon ignores the order ID and uploads the invoice with the shipping ID. If neither is provided, you might get an error. For help with errors, refer to Error Handling.

Aşağıdaki feedOptions vardır gereklidir:

  • InvoiceNumber. Faturada kullanılan fatura numarası. Bu fatura numarası müşterilerle paylaşılır. Satıcılar, faturada aynı fatura numarasının görünmesini sağlamalıdır.
  • DocumentType. Olası değerler:
    • Invoice. Bir fatura yüklüyorsanız bunu kullanın.
    • CreditNote. Geri ödeme veya iade için bir kredi notu yüklüyorsanız bunu kullanın.
      Varsayılan değer Invoice.

İpucu

Manuel yüklemelerde, aynı sipariş kimliğine göre birden fazla fatura yükleyebilirsiniz. Ancak, fatura numarası benzersiz olmalıdır. Yalnızca en son fatura geçerli kabul edilir.

Aşağıdaki feedOptions vardır isteğe bağlı:

  • TotalAmount. Faturadaki toplam tutar. Bu, tüm promosyonlar için KDV eksi ürünler, hediye paketi ve nakliye için KDV dahil fiyattır. Belirtilen toplam tutar Amazon'un bu gönderi için toplam tutarıyla eşleşmiyorsa (iki ondalık basamağa kadar) fatura yüklemesi reddedilir. VIDR"de sağlanan vergi hesaplamalarını kesinlikle takip etmenizi öneririz.
  • TotalVATAmount. Faturadaki toplam KDV tutarı. Bu, tüm promosyonlar için KDV eksi ürünler, hediye paketi ve nakliye için KDV'dir. KDV tutarı Amazon tarafından bu gönderi için hesaplanan KDV tutarıyla eşleşmiyorsa (iki ondalık basamağa kadar) fatura yüklemesi reddedilir. VIDR"de sağlanan vergi hesaplamalarını kesinlikle takip etmenizi öneririz.
  • DocumentType=CreditNote olarak ayarlanmış TransactionId.

🚧

Dikkat

Anahtarların veya değerlerin etrafına tırnak işaretleri eklemeyin. Amazon yalnızca aşağıdaki karakterleri kabul eder: virgül (,), ileri eğik çizgiler (/), ters eğik çizgiler (\), boşluklar (), kısa çizgiler (-), alt çizgiler (_), noktalı virgül (;), kolon (:), hash'ler (#), 0-9, A-Z, a-z. Amazon fazladan alanı keser.

Faturalama Beslemesi için kısıtlama sınırı (UPLOAD_VAT_INVOICE) her üç saniyede bir fatura yüklemesidir.

Örnekler

Fatura yüklemeleri:

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"INT-3431-XJE3", "DocumentType":"Invoice"}

Kredi notları (CN-123-ABC kredi notu numarasıdır):

{"OrderID":"206-2341234-3455465", "InvoiceNumber":"CN-123-ABC", "DocumentType":"CreditNote"}

PDF dosyasını eklemek için aşağıdaki örnek kodu kullanabilirsiniz. Bu örnek Java dilinde olsa da, diğer programlama dilleri için bir model olarak kullanabilirsiniz.

Map<String, String> feedOptions = new HashMap<>(); // building parameter map feedOptions.put("metadata:OrderId", "XXX-XXXXXXX-XXXXXXX"); feedOptions.put("metadata:TotalAmount", String.format(TOTALAMMOUNT)); feedOptions.put("metadata:TotalVATAmount", String.format(TOTALVATAMMOUNT)); feedOptions.put("metadata:InvoiceNumber", INVOICE_NUMBER); String options = feedOptions.entrySet().stream() .map(e -\> String.format("%s=%s", e.getKey(), e.getValue())) .collect(Collectors.joining(";")); File pdfD = new File("\<PATH TO PDF\>"); byte\[\] pdfDocument = FileUtils.readFileToByteArray(pdfD); // read pdf document to byte array String contentMD5 = Base64.encodeBase64String(pdfDocument); // building hash code InputStream contentStream = new ByteArrayInputStream(pdfDocument); // inputstream of SubmitFeedResponse response = submitFeed(contentStream, contentMD5, "\_UPLOAD_VAT_INVOICE\_", options, ContentType.OctetStream); public SubmitFeedResponse submitFeed(InputStream, String contentMD5, String feedType, String feedOptions, ContentType contentType) { SubmitFeedRequest request = new SubmitFeedRequest(); request.setContentMD5(contentMD5); request.setFeedContent(inputStream); request.setFeedOptions(feedOptions); request.setFeedType(feedType); request.setMarketplaceIdList(new IdList(Arrays.asList(getMarketPlaces()); request.setMerchant(configuration.getAmazon().getSellerId()); request.setMWSAuthToken(configuration.getAmazon().getMwsAuthToken()); request.setContentType(contentType); return getMarketplaceWebServiceClient().submitFeed(request); }

Bu sayfa size yardımcı oldu mu?