DOCS

AB'ye gönderim

Zonos API ile Japan Post paketlerini gümrük vergileri önceden ödenmiş olarak seçili AB ülkelerine gönderin ve AB KDV'sinin nasıl işleneceğini seçin.

1 Ekim 2026 (JST) tarihinden itibaren Doğrulanmış Hesabınız, varış ülkesinin desteklediği durumlarda, şu AB varış noktaları için gümrük vergileri önceden ödenmiş Japan Post etiketleri oluşturabilir: Danimarka, Fransa (Monako dahil), Andorra, Fransız denizaşırı departmanları (Guadeloupe, Fransız Guyanası, Martinik), İsveç, İspanya, Hollanda, Slovakya, İtalya, Finlandiya, Lüksemburg, Estonya, Malta ve Belçika.

Fransa, Monako, Andorra veya Fransız denizaşırı departmanlarına (Guadeloupe, Fransız Guyanası, Martinik) yapılan sevkiyatlarda EMS kullanılamaz.

Bir sevkiyatın DDP'ye uygun olup olmadığı varış noktasına, sevkiyatın değerine ve hediye olup olmadığına bağlıdır; ayrıca bazı posta kodu bölgeleri kapsam dışındadır. Her varış noktasının kuralları için AB ülke hazırlığı sayfasına bakın.

Bazı AB varış noktaları için değer sınırları uygulanır. Sınırlar için Doğrulanmış Hesabınızla neler yapabileceğinize bakın.

ABD sevkiyatları için kullandığınız aynı CreateDeclarationShipment iş akışını kullanırsınız. Bir AB sevkiyatı için varış adresini değiştirin, değeri 150 € veya daha az olan B2C sevkiyatlarda her ürüne ürün tanımlayıcılarını iletin (aşağıya bakın) ve KDV'nin nasıl işleneceğini seçmek için landedCostCalculateWorkflow üzerindeki iki isteğe bağlı alanı kullanın. Kendi IOSS numaranızı Dashboard'a kaydetmek yerine istekte iletiyorsanız, etikete uygulanması için bu numarayı shipmentInput.references.taxCode alanında da iletirsiniz. Diğer her şey tam olarak Tek bir sevkiyat oluşturun sayfasında açıklandığı gibi çalışır.

Temel terimler 

  • DDP (Delivered Duty Paid — Gümrük Vergileri Ödenmiş Teslim): Gümrük vergileri ve diğer vergiler paket ulaşmadan önce ödenir, bu nedenle müşterinizden teslimatta herhangi bir ödeme yapması istenmez. Zonos, varış noktasının kurallarının izin verdiği her yerde desteklenen AB varış noktalarına DDP olarak gönderim yapar. Bkz. AB ülke hazırlığı.
  • KDV (Katma Değer Vergisi, VAT): AB'nin mallar, nakliye ve gümrük vergisi üzerinden alınan tüketim vergisidir. Oran, varış ülkesine göre değişir.
  • IOSS (Import One-Stop Shop — İthalat Tek Durak Noktası): Bir satıcının KDV'yi paket ulaştığında tahsil edilmesi yerine satış anında tahsil etmesini ve AB'ye tek bir aylık beyanla ödemesini sağlayan bir AB kaydıdır. IOSS, mal değeri 150 € veya daha az olan sevkiyatlar için geçerlidir. Bir IOSS numarası, IM ve ardından gelen 10 haneden oluşur.

Ürün tanımlayıcıları (1 Kasım 2026'dan itibaren zorunlu) 

Değeri 150 € veya daha az olan bir B2C sevkiyata ait her AB gümrük beyannamesinde her ürün için ürün tanımlayıcıları listelenmelidir. 150 €'yu aşan sevkiyatlar için bunlar gerekmez.

Alan↕AB tanımlayıcısı↕Nedir↕Durum↕
skuSatıcı ürün tanımlayıcısı (M-PID)Sizin, pazaryerinizin veya platformunuzun ürüne atadığı kimlik, örneğin SKU'nuz.Zorunlu
manufacturerProductIdStandart olmayan üretici ürün tanımlayıcısı (NS-PID)Üreticinin veya tedarikçinin kendi ürün kodu, örneğin model veya parça numarası.Zorunlu
gtinStandart üretici ürün tanımlayıcısı (S-PID)Uluslararası bir standarda dayanan barkod numarası, örneğin JAN, EAN veya UPC kodu ya da kitaplar için ISBN.Ürünün bir barkod numarası varsa zorunludur. Yoksa gtin alanını eklemeyin.

Nerede sağlanmalı

Her ürünün tanımlayıcıları, etiket isteğinde ya da Zonos kataloğunuzdaki üründe kayıtlı olarak bulunmalıdır. Bunları etiket isteğinde iletmenizi öneririz.

  • Etiket isteğinde (önerilir): Üçünü de itemCreateWorkflow içindeki her üründe iletin.
  • Zonos kataloğunuzda: Bunları bir kanal entegrasyonu, bir CSV içe aktarma veya Catalog API aracılığıyla katalog ürünlerinize kaydedin. Ardından Zonos'un her sevkiyat için katalog ürününü bulması gerekir:
    • Siparişleri ve katalog ürünlerini senkronize eden bir kanal entegrasyonuyla: Japan Post takip numarasını kanalınızdaki siparişe ekleyin. Zonos, sevkiyatı takip numarasına göre siparişle eşleştirir.
    • Kanal entegrasyonu olmadan: Etiket isteğindeki her üründe eşleşen sku değerini iletin.
{
  "itemInput": [
    {
      "name": "Cotton T-shirt",
      "sku": "TSHIRT-BLK-M",
      "manufacturerProductId": "MFR-TS-2201",
      "gtin": "4901234567894"
    },
    {
      "name": "Canvas tote bag",
      "sku": "TOTE-NAT-01",
      "manufacturerProductId": "MFR-TB-0310"
    }
  ]
}

Bez çantanın barkod numarası olmadığı için gtin alanı eklenmemiştir.

Bu alanlar Zonos'ta kalır ve Japan Post My Page API'sine gönderilmez; bu nedenle Japan Post alan sınırlarını etkilemez. Zonos, AB sevkiyatlarınız için üçüncü taraf beyan sahibi olarak hareket eder. Kuralın tamamı için AB ithalat vergisi düzenlemesi sayfasına bakın.

Kendi IOSS numaranıza ihtiyacınız var mı? 

Hayır. IOSS numaranız yoksa her şey hazır. Zonos'un kendi IOSS numarası vardır. Zonos Doğrulanmış Hesabınızla gönderim yaptığınızda Zonos kendi IOSS numarasını kullanır, KDV'yi gümrük vergileriyle birlikte sizden tahsil eder ve KDV'yi sizin adınıza AB'ye öder. Satıcıların çoğu bu seçeneği kullanır.

Kendi IOSS numaranızı yalnızca zaten bir numaranız varsa ya da IOSS numarası olan bir pazaryeri (örneğin eBay veya Etsy) üzerinden satış yapıyorsanız ve KDV'yi ödeme sırasında müşterilerinizden tahsil ediyorsanız kullanın. IOSS numaranızı iletmeniz, KDV'yi siz (veya pazaryeriniz) ödeyeceğiniz için Zonos'a sizden KDV'yi ikinci kez tahsil etmemesini bildirir.

IOSS numaranızı Dashboard'a kaydettiyseniz, Zonos bu numarayı AB varış noktasına yönelik her landed cost hesaplamasına ve Japan Post'a gönderilen etiket isteğine ekler, KDV ödeme ayarını da sizin yerinize yönetir. IOSS numaranız için taxIdNumber, taxRemittanceCalculation veya taxCode göndermeniz gerekmez. Aşağıdaki tablo, bunun yerine IOSS numarasını istekte iletmek içindir; örneğin belirli bir sevkiyat için farklı bir numara kullanmak istediğinizde.

↕Zonos'un IOSS numarası (satıcıların çoğu)↕Kendi IOSS numaranız↕
taxIdNumberEklemeyinIOSS numaranız
taxRemittanceCalculationREMITTANCEKDV içeren bir tahmin için REMITTANCE, etiketi oluşturmak için NO_REMITTANCE
shipmentInput.references.taxCodeEklemeyinEtiketi oluştururken IOSS numaranız
KDV'yi kim tahsil eder ve öderZonosSiz veya pazaryeriniz
Zonos'un size faturaladıklarıGümrük vergileri, KDV ve ücretlerGümrük vergileri ve ücretler
IOSS numaranız yalnızca 150 € veya daha az değerdeki sevkiyatlar için geçerlidir

Kendi IOSS numaranızı yalnızca mal değeri 150 € veya daha az olan sevkiyatlarda iletin. Zonos yalnızca biçimi kontrol eder (IM ve ardından 10 hane). Biçim geçersizse Zonos numarayı yok sayar ve bunun yerine kendi IOSS numarasını kullanır; bu nedenle gönderdiğiniz numarayı iki kez kontrol edin.

Landed cost tahmini alın 

Bir sevkiyatın gümrük vergilerini, KDV'sini ve ücretlerini görmek için iş akışını shipmentCreateWorkflow olmadan landedCostCalculateWorkflow adımına kadar çalıştırın. Hiçbir şey gönderilmez ve etiket oluşturulmaz. İstek, AB varış noktasıyla Tek bir sevkiyat oluşturun sayfasındakiyle aynıdır; yalnızca landedCostInput değişir.

Zonos'un IOSS numarasını kullanma

taxIdNumber alanını eklemeyin ve taxRemittanceCalculation değerini REMITTANCE olarak ayarlayın. Tahmin; AB gümrük vergisini, KDV'yi ve ücretleri döndürür. Zonos'un size faturalayacağı tutar budur ve Zonos KDV'yi kendi IOSS numarası altında öder.

1{
2 "landedCostInput": {
3 "calculationMethod": "DDP",
4 "endUse": "NOT_FOR_RESALE",
5 "currencyCode": "EUR",
6 "taxRemittanceCalculation": "REMITTANCE"
7 }
8}

Kendi IOSS numaranızı kullanma

IOSS numaranızı taxIdNumber alanında iletin. taxRemittanceCalculation değerini ihtiyacınıza göre seçin:

  • REMITTANCE: Tahmin KDV'yi döndürür; böylece müşterinizden ne kadar tahsil edeceğinizi ve kendi IOSS kaydınız altında ne kadar ödeyeceğinizi bilirsiniz.
  • NO_REMITTANCE: KDV'yi hesaplamak ve tahsil etmek için zaten kendi sistemleriniz varsa bunu kullanın. Tahmin KDV döndürmez; yalnızca Zonos'un size faturalayacağı gümrük vergilerini ve ücretleri döndürür.
1{
2 "landedCostInput": {
3 "calculationMethod": "DDP",
4 "endUse": "NOT_FOR_RESALE",
5 "currencyCode": "EUR",
6 "taxIdNumber": "IM5281234567",
7 "taxRemittanceCalculation": "REMITTANCE"
8 }
9}

Tam örnek: Gümrük vergilerini ve diğer vergileri tahmin edin

Japonya'dan Fransa'ya bir sevkiyat için taraflardan landed cost'a kadar eksiksiz bir tahmin isteği. Mutasyon her iki seçenek için de aynıdır; yalnızca landedCostInput değişkenleri değişir.

1mutation EstimateLandedCost(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$cartonInput: [CartonCreateWorkflowInput!]!
5$shipmentRatingInput: ShipmentRatingCreateWorkflowInput!
6$landedCostInput: LandedCostWorkFlowInput!
7) {
8 partyCreateWorkflow(input: $partyInput) {
9 id
10 type
11 }
12 itemCreateWorkflow(input: $itemInput) {
13 id
14 }
15 cartonsCreateWorkflow(input: $cartonInput) {
16 id
17 }
18 shipmentRatingCreateWorkflow(input: $shipmentRatingInput) {
19 id
20 amount
21 serviceLevel {
22 code
23 }
24 }
25 landedCostCalculateWorkflow(input: $landedCostInput) {
26 id
27 currencyCode
28 amountSubtotals {
29 duties
30 taxes
31 fees
32 shipping
33 landedCostTotal
34 }
35 duties {
36 amount
37 description
38 }
39 taxes {
40 amount
41 description
42 }
43 remittance {
44 amount
45 description
46 note
47 taxIdNumber
48 }
49 }
50}

Etiket oluşturun 

shipmentCreateWorkflow dahil olmak üzere CreateDeclarationShipment iş akışının tamamını bir AB varış noktasıyla çalıştırın. Zonos, Japan Post etiketini ve takip numarasını oluşturur ve paket posta akışına kabul edildikten sonra size fatura keser.

Zonos'un IOSS numarasını kullanma

taxIdNumber ve references.taxCode alanlarını eklemeyin ve taxRemittanceCalculation değerini REMITTANCE olarak ayarlayın. Hiçbir yerde IOSS numarası iletmezsiniz: Zonos varsayılan olarak kendi IOSS numarasını sevkiyata uygular, gümrük vergileri ve KDV için size fatura keser ve KDV'yi AB'ye öder.

{
  "landedCostInput": {
    "calculationMethod": "DDP",
    "endUse": "NOT_FOR_RESALE",
    "currencyCode": "EUR",
    "taxRemittanceCalculation": "REMITTANCE"
  }
}

Kendi IOSS numaranızı kullanma

IOSS numaranızı iki yerde iletin:

  • landedCostInput.taxIdNumber, taxRemittanceCalculation değeri NO_REMITTANCE olarak ayarlanmış şekilde. KDV'yi zaten tahsil ettiğiniz ve kendi IOSS kaydınız altında ödeyeceğiniz için Zonos bu sevkiyatta sizden KDV almaz. Zonos, gümrük vergileri ve ücretler için size fatura keser.
  • shipmentInput.references.taxCode. Bu, IOSS numaranızı Japan Post etiketine uygular.
{
  "landedCostInput": {
    "calculationMethod": "DDP",
    "endUse": "NOT_FOR_RESALE",
    "currencyCode": "EUR",
    "taxIdNumber": "IM5281234567",
    "taxRemittanceCalculation": "NO_REMITTANCE"
  },
  "shipmentInput": {
    "serviceLevel": "japan_post.air.parcel",
    "generateLabel": true,
    "contentsType": "ECOMMERCE_GOODS",
    "references": {
      "taxCode": "IM5281234567"
    }
  }
}
Kendi IOSS numaranızı istekte mi iletiyorsunuz? Her iki yerde de iletin

Kendi IOSS numaranızı Dashboard'a kaydetmek yerine istekte iletiyorsanız, numarayı her zaman hem landedCostInput.taxIdNumber (NO_REMITTANCE ile) hem de shipmentInput.references.taxCode alanında iletin. Bunlardan birinin eksik olması, kendiniz ödediğiniz KDV'nin sizden tahsil edilmesine veya IOSS numaranızın etikete uygulanmamasına yol açabilir. Kendi IOSS numaranızla REMITTANCE yalnızca tahminler içindir.

Tam örnek: Japan Post etiketi oluşturun

Japonya'dan Fransa'ya bir sevkiyat için taraflardan etikete kadar eksiksiz bir CreateDeclarationShipment isteği. Mutasyon her iki seçenek için de aynıdır. Kendi IOSS numaranızla değişkenler iki yerde değişir: landedCostInput ve shipmentInput.references.taxCode.

1mutation CreateDeclarationShipment(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$cartonInput: [CartonCreateWorkflowInput!]!
5$shipmentRatingInput: ShipmentRatingCreateWorkflowInput!
6$landedCostInput: LandedCostWorkFlowInput!
7$shipmentInput: ShipmentCreateWorkflowInput!
8) {
9 partyCreateWorkflow(input: $partyInput) {
10 id
11 type
12 }
13 itemCreateWorkflow(input: $itemInput) {
14 id
15 }
16 cartonsCreateWorkflow(input: $cartonInput) {
17 id
18 }
19 shipmentRatingCreateWorkflow(input: $shipmentRatingInput) {
20 id
21 amount
22 serviceLevel {
23 code
24 }
25 }
26 landedCostCalculateWorkflow(input: $landedCostInput) {
27 id
28 currencyCode
29 amountSubtotals {
30 duties
31 taxes
32 fees
33 shipping
34 landedCostTotal
35 }
36 duties {
37 amount
38 description
39 }
40 taxes {
41 amount
42 description
43 }
44 remittance {
45 amount
46 description
47 note
48 taxIdNumber
49 }
50 }
51 shipmentCreateWorkflow(input: $shipmentInput) {
52 id
53 trackingDetails {
54 number
55 }
56 shipmentCartons {
57 label {
58 url
59 }
60 }
61 }
62}

Batch dispatch 

AB sevkiyatları, ABD sevkiyatlarınızla aynı ertelenmiş ödemeli dispatch grubuna eklenebilir. Her sevkiyatın landedCostCalculateWorkflow adımındaki IOSS alanlarını yukarıda gösterildiği gibi ayarlayın, ardından grubu Batch dispatch sayfasında açıklandığı şekilde ekleyin ve kapatın.

Bu sayfa faydalı mıydı?