API Reference

Siparişin Faturasını Gönderme

Giriş

Amazon üzerinden aldığınız siparişlere fatura göndermenizi sağlayan metottur.

Siparişin Faturasını Gönderme Süreci Değerleri ve Açıklamaları

🚧

Zorunlu Alanlar

DeğerAçıklamaVeri Türü
feedType(Zorunlu)Yükleyeceğiniz feed türü: UPLOAD_VAT_INVOICEstring
marketplaceIds (Zorunlu)Amazon satış ortağı mağaza ID'sini temsil eder. TR: A33AVAJ2PDY3EVstring, array
inputFeedDocumentId(Zorunlu)Fatura dosya linki oluşturma metodu kullanımı sonrası dönen değer.string
feedOptions (Zorunlu)Bu değerin altında 3 zorunlu alan vardır. Bu değerler "metadata" olarak sağlanmalıdır.string
OrderId/ShippingId (Zorunlu)OrderId (Sipariş numarası) veya ShippingId (Gönderi Kimliği) belirtilmelidir.
InvoiceNumber (Zorunlu)Faturada kullanılan numara. (Bu numara müşterilerle paylaşılır ve faturada da aynı olmalıdır.)string
DocumentType (Zorunlu)Invoice veya CreditNote. Fatura yüklemek için Invoice, iade veya geri ödeme için CreditNote kullanılmalıdır. Varsayılan değer: Invoicestring

Dikkat Edilmesi Gerekenler

❗️

inputFeedDocumentId parametresine Fatura Dosya Linki Oluşturma response'unda aldığınız değeri girmelisiniz.

🚧

Opsiyonel Alanlar

DeğerAçıklamaVeri Türü
TotalAmountFaturadaki toplam tutar (KDV dahil). Ürün, hediye paketi ve kargo ücretlerinin toplamından promosyon KDV’si çıkarılarak hesaplanır.string
TotalVATAmountFaturadaki toplam KDV tutarı. Ürün, hediye paketi ve kargo KDV’sinden promosyon KDV’si çıkarılarak hesaplanır.string
TransactionIdSadece DocumentType=CreditNote olduğunda zorunludur.string

curl -L -X POST 'https://sellingpartnerapi-eu.amazon.com/feeds/2021-06-30/feeds' \
-H 'Content-Type: application/json' \
-d '{
    "feedType": "UPLOAD_VAT_INVOICE",
  "marketplaceIds": ["A33AVAJ2PDY3EV"],
  "inputFeedDocumentId":"amzn1.tortuga.4.eu.XXXXX",
  "feedOptions": {
    "metadata:OrderId": "403-2681350-XXXXXXX",
    "metadata:TotalAmount": "100.00",
    "metadata:TotalVATAmount": "20.00",
    "metadata:InvoiceNumber": "INV98765",
    "metadata:DocumentType": "Invoice"
  }
}
'
{
    "feedId": "11111111111"
}
<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Code>AccessDenied</Code>
    <Message>Request has expired</Message>
    <X-Amz-Expires>300</X-Amz-Expires>
    <Expires>2025-02-13T10:54:19Z</Expires>
    <ServerTime>2025-02-13T11:57:44Z</ServerTime>
    <RequestId>J60BFER8F0EN697B</RequestId>
    <HostId>zCmGm/XE1h9iFAJTjPIc+MccFC31PeCkeWMnDikMXTo/tuiGnVKZHFHw9DpexfjA++M90ptQwwtJIJRrakiWXQ==</HostId>
</Error>