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:
- Allow Amazon to automatically create and upload your invoices.
- Use Amazon tax calculation data to create your own invoices, then manually upload them using SP-API.
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.
API | Rapor API'si |
---|---|
Operation | createReport |
ReportType | SC_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) veitem_tax
(düz dosya raporlarında). Amazon tarafından hesaplanan KDV tutarını içerir.ItemPrice
(XML raporlarında) veitem_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:
-
Go to Add or remove order report columns in Seller Central.
-
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) veitem_tax
(düz dosya raporlarında). Amazon tarafından hesaplanan KDV tutarını içerir.ItemPrice
(XML raporlarında) veitem_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ğundaReportOption
parametre belirtilir, varsayılanReportOption=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ırall
.
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
veyaCreditNotePending
). 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. - Ne zaman
-
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 gerekirstartDate
veendDate
için parametrelercreateReport
operasyon.dataStartTime
vedataEndTime
değerler belirtilen geçerli ilk ve son günlere karşılık gelmelidirreportPeriod
. Örneğin, ne zamanreportPeriod=WEEK
,dataStartTime
Pazar günü olmalı vedataEndTime
Cumartesi olmalı. İzin verilen maksimum tarih aralığı 30 gündür. - Ne zaman
false
, veya eğerall
dahil değildirreportOptions
, raporun içeriği değerine bağlıdırpendingInvoices
. 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.
- Ne zaman
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 Durumu | Açıklama | Action required |
---|---|---|
InvoicePending | Kargo gönderildi. | Satıcı, kargo için fatura yüklemelidir. |
InvoiceProcessing | Satı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. |
InvoiceUploaded | Satı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. |
InvoiceRejected | Satı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. |
CreditNotePending | Para 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. |
CreditNoteProcessing | Satı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. |
CreditNoteUploaded | Satı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. |
CreditNoteRejected | Satı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. |
CreditNoteCreatedByAmazon | Amazon bu işlem için bir kredi notu oluşturdu. | Satıcının herhangi bir işlem yapmasına gerek yoktur. |
NoTaxCalculated | Amazon 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. |
InvoiceCreatedByAmazon | Amazon bu işlem için bir fatura oluşturdu. | Satıcının herhangi bir işlem yapmasına gerek yoktur. |
VIDR sütunları
Aşağıdaki tabloda her VIDR sütunu açıklanmaktadır:
Alan adı | Tanım | Örnek |
---|---|---|
order-id | Amazon'un benzersiz sipariş tanımlayıcısı. Kargo onayı ve sipariş sonrası işlemler için kullanılır. | 736-3563777-5518068 |
order-item-id | Amazon'un benzersiz sipariş öğesi tanımlayıcısı. Kargo onayı ve sipariş sonrası işlemler için kullanılır. | 583563777345 |
shipping-id | Bu kargonun kargo kimliği. | 409302382 |
fulfilled-by | Bu siparişin lojistik kanalı. | MFN or FBA |
order-date | Siparişin verildiği tarih. | 17/05/2018 |
marketplace-id | Siparişin verildiği pazaryeri. | DE, FR, IT, ES |
recipient-name | Alıcının adı. | Mary Major |
buyer-name | Satı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-1 | Gönderim adresinin ilk satırı. | 123 Any Street |
ship-address-2 | Gönderim adresinin ikinci satırı. | Apt. 12 |
ship-address-3 | Gönderim adresinin üçüncü satırı. | c/o Example Corp. |
ship-city | Gönderim adresinin bulunduğu şehir. | Any City |
ship-state | Gönderim adresinin bulunduğu eyalet. | Any State |
ship-postal-code | Gönderim adresinin posta kodu. | SL1 1QP |
ship-country | Uluslararası standart iki harfli ülke kodu (ISO 3166 uyumlu). | DE |
ship-phone-number | Gönderim adresinin telefon numarası. | 999999999 |
shipment-date | Bu kargonun gönderim tarihi. | 20/05/2018 |
billing-name | Faturadaki ad. | Márcia Oliveira |
bill-address-1 | Fatura adresinin ilk satırı. | 100 Main Street |
bill-address-2 | Fatura adresinin ikinci satırı. | Apt. 12 |
bill-address-3 | Fatura adresinin üçüncü satırı. | c/o AnyCompany |
bill-city | Fatura adresinin şehri. | Any City |
bill-state | Fatura adresinin eyaleti. | Any State |
bill-postal-code | Fatura adresinin posta kodu. | U7D 294 |
bill-country | Uluslararası standart iki harfli ülke kodu (ISO 3166 uyumlu). | DE |
bill-phone-number | Fatura adresinin telefon numarası. | 44234343 |
ship-from-city | Gönderen adresinin bulunduğu şehir. | Any City |
ship-from-state | Gönderen adresinin bulunduğu eyalet. | Any State |
ship-from-country | Gönderen adresinin bulunduğu ülke. | DE |
ship-from-postal-code | Gönderen adresinin bulunduğu posta kodu. | 10178 |
sku | Stok 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-purchased | Satın alınan miktar. | 1 |
currency | İşlem için kullanılan para birimi. | EUR |
asin | Ürünün ASIN'i. | AY39345YE8K |
item-vat-incl-amount | KDV dahil ürün fiyatı. | 120.00 |
item-vat-amount | Ürün fiyatının KDV tutarı. | 20.00 |
item-vat-excl-amount | KDV hariç ürün fiyatı. | 100.00 |
item-vat-rate | Ürün fiyatının KDV oranı. | 0.20 |
gift-wrap-vat-incl-amount | Toplam KDV dahil hediye paketi. | 12.00 |
gift-wrap-vat-amount | Hediye paketinin toplam KDV tutarı. | 2.00 |
gift-wrap-vat-excl-amount | Toplam KDV hariç hediye paketi. | 10.00 |
gift-wrap-vat-rate | Hediye fiyatının toplam KDV oranı. | 0.20 |
shipping-vat-incl-amount | KDV dahil kargo bedeli. | 6.00 |
shipping-vat-amount | Kargo bedelinin KDV tutarı. | 1.00 |
shipping-vat-excl-amount | KDV hariç kargo bedeli. | 5.00 |
shipping-vat-rate | Kargo bedelinin KDV oranı. | 0.20 |
item-promo-vat-incl-amount | Toplam KDV dahil ürün promosyonu. | -0.12 |
item-promo-vat-amount | Ürün promosyonunun toplam KDV tutarı. | -0.02 |
item-promo-vat-excl-amount | Toplam 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-amount | Toplam KDV dahil kargo promosyonu. | -0.12 |
shipping-promo-vat-amount | Kargo promosyonunun toplam KDV tutarı. | -0.02 |
shipping-promo-vat-excl-amount | Toplam KDV hariç kargo promosyonu. | -0.10 |
shipping-promo-vat-rate | Kargo promosyonunun toplam KDV oranı. | 0.20 |
shipping-promotion-id | Nakliye promosyonunun promosyon kimliği. Amazon tarafından oluşturulan alfanümerik bir değer. | 3943834723:BWJRJERIUDKERU |
gift-promo-vat-incl-amount | Toplam KDV dahil hediye paketi promosyonu. | -0.20 |
gift-promo-vat-amount | Hediye paketi promosyonunun toplam KDV tutarı. | -0.12 |
gift-promo-vat-excl-amount | Toplam KDV hariç hediye paketi promosyonu. | -0.02 |
gift-promo-vat-rate | Hediye paketi promosyonunun toplam KDV oranı. | 0.10 |
gift-promotion-id | Hediye paketi promosyonunun promosyon kimliği. | 385934052:BWJRJDJSDS3JCY6T |
transaction-id | Gö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-invoiced | Amazon'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-status | Faturanın durumu. | Refer to Step 1 for details about invoice status. |
invoice-status-description | Fatura durumunun açıklaması. | Refer to Step 1 for details about invoice status. |
is-business-order | Bu sipariş, Amazon İşletme web sitesinden veya B2C web sitesinden mi verildi? | TRUE veya FALSE |
purchase-order-number | PO numarası (müşteri tarafından sağlandıysa). | AB45-234934 (can be any string) |
seller-vat-number | KDV hesaplamasında kullanılan satıcı KDV numarası. | DE111111111 |
buyer-vat-number | KDV hesaplamasında kullanılan alıcı KDV numarası. | DE22222222 veya müşterinin Amazon'da KDV Numarası yoksa boş. |
buyer-company-name | Alı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-number | Satı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-id | Bu 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-type | Müş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-present | Müş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-present | Satı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-id | Müş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-format | Vergi 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-en | Bu 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-de | Bu 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-es | Bu 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-fr | Bu 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-it | Bu 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-corrected | Bu 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-number | Fatura düzeltmesi gerektiren orijinal gönderinin fatura numarası. | Orijinal fatura numarası. |
invoice-correction-details | Fatura ü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ğerInvoice
.
-
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ğerInvoice
.
İ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);
}
Updated 28 days ago