DOCS

Landed cost object

/

Landed Cost obiekt

Poznaj możliwości i funkcje obiektu Landed Cost.

Obiekt Landed Cost zapewnia szczegółowy opis oraz całkowitą wartość opłat importowych, podatków i opłat.

Atrybuty 

PoleUwagi
id STRINGUnikalny identyfikator obiektu. Id dla obiektu Landed Cost zawsze będzie poprzedzone ldct.
amount_subtotal HASHCałkowity koszt Landed cost. Jeśli używasz go do checkout w e-commerce, zalecamy korzystanie z tych całkowitych kwot do wyświetlania użytkownikowi końcowemu. Te kwoty umożliwiają łatwiejszą integrację bez potrzeby sumowania opłat celnych, podatków lub opłat według pozycji i poziomu przesyłki. Dodatkowe szczegóły są dostępne w obiekcie landed cost. Zobacz atrybuty podrzędne poniżej.
amount_subtotal.duties DECIMALSuma wszystkich opłat celnych w tablicy opłat celnych. Obejmuje opłaty celne nałożone na przedmioty, przesyłkę lub inne dodatkowe opłaty nałożone na import. Aby zrozumieć, jak obliczane są opłaty celne, zobacz dokument o opłatach celnych.
amount_subtotal.fees DECIMALSuma różnych opłat w tablicy opłat. Obejmuje opłaty za odprawę, opłaty importowe kraju lub inne opłaty nałożone na import. Aby dowiedzieć się więcej o opłatach importowych, zobacz dokument o opłatach importowych.
amount_subtotal.taxes DECIMALSuma wszystkich podatków w tablicy podatków. Obejmuje podatki nałożone na przedmioty, opłaty celne, przesyłkę lub opłaty. Aby dowiedzieć się więcej o podatkach importowych, zobacz dokument o podatkach importowych.
currency HASHHash zawierający informacje o podstawowej walucie wysłanej w żądaniu oraz innych walutach z kursem rate używanym w momencie odpowiedzi. Jest to przydatne, jeśli chcesz przeliczyć na walutę kraju importu lub na inne waluty używane w obliczeniach landed cost. Zobacz atrybuty podrzędne poniżej.
currency.id STRINGUnikalny identyfikator dla obiektu waluty.
currency.base STRINGPodstawowa waluta wysłana w żądaniu landed cost, reprezentowana przez trzyznakowy kod ISO. Wszystkie kwoty w obiekcie landed cost są podane w podstawowej walucie.
currency.date TIMESTAMPData, w której kurs waluty rate został pobrany, w formacie ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASHHash zawierający waluty i kursy wymiany potrzebne do przeliczenia z podstawowej waluty.
currency.rates.currency STRINGWaluta kursu wymiany rate używana w obliczeniach landed cost.
currency.rates.rate DECIMALKurs wymiany rate w momencie żądania landed cost dla określonej waluty.
customs HASHHash zawierający informacje używane do określenia landed cost oraz informacje potrzebne do dokumentacji celnej i odprawy celnej. Zobacz atrybuty podrzędne poniżej.
customs.delivery_duty_paid STRINGMożliwość obciążenia opłat celnych i podatków osobie innej niż odbiorca (DDP - dostawa opłacona) różni się w zależności od przewoźnika, usługi transportowej lub kraju docelowego. Możliwe wartości to available, unavailable i unknown. Jeśli landed cost jest używane w e-commerce checkout, powinieneś pozwolić kupującemu na opłacenie opłat celnych i podatków tylko wtedy, gdy wynik to available. Jeśli wynik to unknown, możesz przedstawić kupującemu szacunkową kwotę opłaty celnej i podatku, które będą musieli zapłacić przy dostawie, lub możesz nie chcieć w ogóle wyświetlać opłaty celnej i podatku dla tego poziomu usługi przewoźnika. Jeśli wynik to unavailable, Twoje konto zostało skonfigurowane w Zonos Dashboard, aby nie zezwalać na DDP, mimo że jest to dozwolona usługa przez wybranego przewoźnika.
customs.items LISTLista przedmiotów wysłanych w żądaniu. Zobacz atrybuty podrzędne poniżej.
customs.items.id STRINGUnikalny identyfikator wysłany w żądaniu.
customs.items.amount DECIMALKwota przedmiotu w walucie podstawowej. To jest kwota wysłana w żądaniu dla tego przedmiotu.
customs.items.country_of_origin STRINGKraj produkcji, w którym przedmiot lub artykuł został wyprodukowany. Reprezentowany przez dwu-literowy kod ISO. Zobacz dokument o opłatach importowych, aby zrozumieć, jak kraj pochodzenia wpływa na obliczenia landed cost.
customs.items.country_of_origin_source STRINGŹródło kraju pochodzenia. Możliwe wartości to zonos_catalog, api_request i account_default platform.
customs.items.description_customs STRINGSugerowany opis towarów na fakturze handlowej. Ten opis zazwyczaj różni się od opisu detalicznego i zazwyczaj zawiera ogólny opis tego, czym jest, z czego jest zrobione i do czego jest używane.
customs.items.description_retail STRINGOpis detaliczny przedmiotu.
customs.items.detail STRINGDodatkowe cechy, atrybuty lub opisy przedmiotu.
customs.items.dimensions LISTRozmiar przesyłki. hash
customs.items.dimensions.height DECIMALWysokość przedmiotu.
customs.items.dimensions.length DECIMALDługość przedmiotu.
customs.items.dimensions.unit STRINGJednostka miary dla wymiarów przedmiotu. Możliwe wartości to inch, centimeter, millimeter i null. Gdy null, używana będzie inch.
customs.items.dimensions.width DECIMALSzerokość przedmiotu.
customs.items.hs_code STRINGZharmonizowany kod taryfowy używany do określenia stawki taryfowej rate w obliczeniach landed cost.
customs.items.hs_code_source STRINGŹródło zharmonizowanego kodu taryfowego, które może być ustawione przez Zonos. Możliwe wartości to zonos_catalog, api_request, zonos_classified, account_default i hs_correction.
customs.items.image_url STRINGURL obrazu.
customs.items.note STRINGDodatkowe szczegóły dotyczące odprawy przedmiotu lub kodu HS, jeśli dotyczy. Przykład dla Indii to Zgodnie z indyjskimi wytycznymi importowymi dla przesyłek osobistych, Twój kod HS został skorygowany do 9804.90.00.
customs.items.quantity INTEGERIlość przedmiotu wysłana w żądaniu.
customs.items.upc_code STRINGKod UPC przedmiotu.
customs.items.weight DECIMALWaga przedmiotu.
customs.items.weight_unit STRINGJednostka miary dla wagi. Możliwe wartości to pound, ounce, kilogram i null. Gdy null, używana będzie pound.
customs.ship_to_country STRINGKraj importu, w którym stosowane są opłaty celne i podatki.
customs.shipping_amount DECIMALKwota za wysyłkę, która powinna być wymieniona w dokumentacji celnej.
de_minimis HASHInformacje o progu specyficznym dla kraju, który określa, kiedy obowiązują cła i podatki. Tablica kursów walutowych będzie zawierać konwersję rate używaną do określenia, czy import był powyżej czy poniżej progów cła i podatku. Zobacz atrybuty podrzędne poniżej.
de_minimis.formula STRINGWzór używany do obliczenia kwalifikowalności progu de minimis.
de_minimis.method STRINGTo jest metoda obliczenia, taka jak cif, cifd, cifdt, fob lub fobd.
de_minimis.note STRINGDodatkowe szczegóły dotyczące de minimis, takie jak informowanie, czy przedmiot nie kwalifikował się do rozważenia de minimis, na przykład wino.
de_minimis.threshold STRINGCzy podatek jest poniżej czy powyżej progu podatkowego. Możliwe wartości to above lub below.
de_minimis.type STRINGDe minimis stosowane do type. Możliwe wartości to tax i duty.
duties HASHTablica ceł nałożonych na import. Suma kwot ceł jest równa amount_subtotal.duties. Zobacz atrybuty podrzędne poniżej.
duties.amount DECIMALKwota cła na item, shipping lub fee.
duties.description STRINGRóżne opisy cła, takie jak duty, anti_dumping_duty i inne.
duties.formula STRINGWzór używany do obliczenia kwoty cła. Dla cła jest to zazwyczaj taryfa dla kraju importu i może być ad valorem lub specyficznym cłem rate.
duties.item_id STRINGUnikalny identyfikator wysłany w żądaniu. Id jest podawane tylko wtedy, gdy typ to item.
duties.note STRINGDodatkowe szczegóły dotyczące cła, w tym umowy o wolnym handlu, obniżone stawki celne, cła antydumpingowe i inne.
duties.type STRINGCło jest stosowane do type. Możliwe wartości to item, shipping i fee.
fees HASHTablica opłat nałożonych na import. Suma kwot opłat jest równa amount_subtotal.fees. Zobacz atrybuty podrzędne poniżej.
fees.amount DECIMALKwota opłaty nałożona na przedmiot, wysyłkę, cło, poziom usługi, przewoźnika lub kraj. Ta kwota jest w walucie bazowej i mogła zostać przeliczona z odpowiedniej waluty kraju importu na walutę bazową wysłaną w żądaniu.
fees.description STRINGRóżne opisy opłaty, takie jak UPS Disbursement Fee, FedEx Advancement Fee i An Post Clearance Fee.
fees.formula STRINGWzór używany do obliczenia opłaty. Dla opłat jest to zazwyczaj stała kwota, procent od ceł i podatków lub inny wzór.
fees.item_id STRINGTwój unikalny identyfikator wysłany w żądaniu landed cost. Id jest podawane tylko wtedy, gdy typ to item.
fees.note STRINGDodatkowe szczegóły dotyczące opłaty, jeśli to konieczne.
fees.type STRINGOpłata jest stosowana do type. Możliwe wartości to advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country i other.
messages HASHLista niekrytycznych wiadomości, np. „Kwota za wysyłkę w żądaniu była pusta, co może wpłynąć na obliczenia.”
messages.message STRINGPrzydatna wiadomość związana z Twoim Landed Cost żądaniem i brakującymi informacjami niekrytycznymi.
messages.type STRINGTyp wiadomości. Możliwe wartości to price_adjustment, default_value_used, shipping_missing i item_weight_missing.
remittance HASHTablica zawierająca kwotę i szczegóły dotyczące tego, co należy przekazać do konkretnego kraju (np. Australii, Nowej Zelandii, Norwegii lub Wielkiej Brytanii).
remittance.amount DECIMALKwota pieniędzy, która musi być przekazana do konkretnego kraju.
remittance.description STRINGOpis, na co jest przeznaczona wpłata (np. VAT w Wielkiej Brytanii).
remittance.note STRINGNotatka dotycząca sposobu, w jaki podatek powinien być wpłacany (np. remit do HMRC kwartalnie).
removed_items LISTLista przedmiotów usuniętych z wniosku o obliczenie landed cost. Przedmioty Zobacz atrybuty podrzędne poniżej.
removed_items.id STRINGUnikalny identyfikator wysłany w wniosku.
removed_items.amount DECIMALKwota przedmiotu w walucie bazowej. Jest to kwota wysłana w wniosku dla tego przedmiotu.
removed_items.country_of_origin STRINGKraj produkcji, w którym przedmiot lub artykuł został wyprodukowany. Reprezentowany przez dwu-literowy kod ISO. Zobacz dokument o cłach importowych, aby zrozumieć, jak kraj pochodzenia wpływa na obliczenie landed cost.
removed_items.country_or_origin_source STRINGŹródło kraju pochodzenia. Możliwe wartości to zonos_catalog, api_request oraz account_default platform.
removed_items.description_customs STRINGSugerowany opis towarów na fakturze handlowej. Ten opis zazwyczaj różni się od opisu detalicznego i zazwyczaj zawiera ogólny opis tego, czym jest, z czego jest wykonany i do czego jest używany.
removed_items.description_retail STRINGOpis detaliczny przedmiotu.
removed_items.hs_code STRINGZharmonizowany kod taryfowy używany do określenia stawki cła rate w obliczeniach landed cost.
removed_items.hs_code_source STRINGŹródło używanego zharmonizowanego kodu taryfowego, które może być ustawione przez Zonos. Możliwe wartości to zonos_catalog, api_request, platform, zonos_classified, account_default oraz hs_correction.
removed_items.note STRINGDodatkowe szczegóły dotyczące odprawy przedmiotu lub kodu HS, jeśli dotyczy. Przykład dla Indii: Zgodnie z indyjskimi wytycznymi importowymi dla przesyłek osobistych, Twój kod HS został skorygowany do 9804.90.00.
removed_items.quantity INTEGERIlość przedmiotu wysłana w wniosku.
taxes HASHTablica podatków nałożonych na import. Suma kwot podatków jest równa amount_subtotal.taxes. Zobacz atrybuty podrzędne poniżej.
taxes.amount DECIMALKwota podatku od przedmiotu, wysyłki, cła lub opłaty.
taxes.description STRINGRóżne opisy nałożonego podatku, takie jak podatek, VAT, GST, PST, HST i inne.
taxes.formula STRINGWzór używany do obliczenia kwoty podatku zazwyczaj obejmuje podatek kraju importu; może to być również podatek stanowy (lub prowincjonalny) lub obniżony (lub zwiększony) podatek.
taxes.item_id STRINGUnikalny identyfikator wysłany w wniosku o landed cost. Id jest podawane tylko wtedy, gdy typ to item.
taxes.note STRINGDodatkowe szczegóły dotyczące podatku, w tym obniżone stawki podatkowe lub inne stosowne informacje dotyczące nałożonego podatku.
taxes.type STRINGPodatek jest nałożony na type. Możliwe wartości to item, duty i shipping, a także typy opłat advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country i other.

Przykładowe zapytanie

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
  "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
  "amount_subtotal": {
    "duties": 0,
    "fees": 15,
    "taxes": 12.25
  },
  "currency": {
    "id": "b5f06418-3",
    "base": "USD",
    "date": "2021-01-07T00:34:03.471+0000",
    "rates": [
      {
        "currency": "GBP",
        "rate": 0.8117
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 39.17,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Hoka One Running Shoe - Women's",
        "description_retail": "Hoka One Running Shoe - Women's",
        "hs_code": "6116.10",
        "hs_code_source": "api_request",
        "note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
        "quantity": 1
      },
      {
        "id": "294396",
        "amount": 7.83,
        "country_of_origin": "CN",
        "country_of_origin_source": "account_default",
        "description_customs": "Galaxy Quest Men's Tee Blue",
        "description_retail": "Galaxy Quest Men's Tee Blue",
        "hs_code": "6217.10",
        "hs_code_source": "api_request",
        "note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
        "quantity": 1
      }
    ],
    "shipping_amount": 14.23,
    "ship_to_country": "GB"
  },
  "de_minimis": [
    {
      "formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
      "method": "FOB",
      "note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
      "threshold": "below",
      "type": "duty"
    },
    {
      "formula": "(cost {'<='} 0 gbp)",
      "method": "FOB",
      "note": "Tax applies to all shipments",
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [],
  "fees": [
    {
      "amount": 15,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "item_id": null,
      "formula": "15 USD",
      "note": null,
      "type": "ddp_service_fee"
    }
  ],
  "remittance": [
    {
      "amount": 12.25,
      "description": "UK VAT",
      "note": "remit to HMRC quarterly"
    }
  ],
  "removed_items": [],
  "taxes": [
    {
      "amount": 7.83,
      "description": "VAT (Value-added tax)",
      "item_id": "294395",
      "formula": "20%",
      "note": null,
      "type": "item"
    },
    {
      "amount": 2.3719,
      "description": "VAT (Value-added tax)",
      "item_id": "294395",
      "formula": "20%",
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 1.57,
      "description": "VAT (Value-added tax)",
      "item_id": "294396",
      "formula": "20%",
      "note": null,
      "type": "item"
    },
    {
      "amount": 0.4741,
      "description": "VAT (Value-added tax)",
      "item_id": "294396",
      "formula": "20%",
      "note": null,
      "type": "shipping"
    }
  ]
}

Czy ta strona była pomocna?