DOCS

Żądanie wyceny landed cost

Poznaj pary klucz/wartość w żądaniu landed cost.

Chociaż Zonos Landed Cost potrafi wyliczyć dokładny landed cost na podstawie samego opisu artykułu, im więcej informacji zostanie podanych, tym dokładniejsza będzie wycena landed cost. Poniżej znajdują się dane WYMAGANE i OPCJONALNE, ale zalecamy wypełnienie jak największej liczby pól OPCJONALNYCH.

Kod HS jest wysoce zalecany. W przeciwieństwie do podstawowego landed cost, pełny landed cost zawiera szczegóły na poziomie artykułu ze stawkami celnymi dla każdego kodu HS.

Atrybuty 

Pary klucz/wartość JSON w treści żądania

POST | https://api.zonos.com/v1/landed_cost

NAGŁÓWEK zonos-version: 2019-11-21

Powyższy nagłówek jest wymagany, aby to żądanie landed cost zostało pomyślnie zrealizowane.

Pole↕Uwagi↕
currency WYMAGANECiąg znaków waluty bazowej, podany jako trzyliterowy kod ISO.
discounts OPCJONALNEInformacje dotyczące rabatów, w tym identyfikator, kwota i wszelkie szczegóły.
discounts.id OPCJONALNEUnikalny identyfikator rabatu nadany przez sprzedawcę lub eksportera.
discounts.amount OPCJONALNELiczba dziesiętna określająca kwotę rabatu w dolarach i centach.
discounts.detail OPCJONALNEDodatkowe cechy, atrybuty lub opisy rabatu.
items WYMAGANELista eksportowanych artykułów. hash
items.id WYMAGANEUnikalny identyfikator artykułu nadany przez sprzedawcę lub eksportera.
items.amount WYMAGANELiczba dziesiętna określająca wartość jednej sztuki artykułu w dolarach i centach.
items.amount_discount OPCJONALNEKwota rabatu dotyczącego artykułu.
items.brand OPCJONALNEMarka artykułu, np. Leatherman.
items.category OPCJONALNEOpis kategorii artykułu, np. Odzież.
items.color OPCJONALNEKolor artykułu.
items.country_of_origin OPCJONALNEKraj wytworzenia lub produkcji, podany jako dwuliterowy kod ISO. Zalecany, aby uzyskać najdokładniejsze wyceny. Jeśli kraj pochodzenia nie zostanie podany, stosowana jest stawka największego uprzywilejowania (MFN).
items.description_customs OPCJONALNESugerowany opis towaru do faktury handlowej. Opis ten zwykle różni się od opisu detalicznego i zazwyczaj zawiera ogólne informacje o tym, czym jest towar, z czego jest wykonany i do czego służy.
items.description_retail OPCJONALNEOpis detaliczny artykułu.
items.detail OPCJONALNEDodatkowe cechy, atrybuty lub opisy artykułu.
items.dimensions OPCJONALNEWymiary przesyłki. Zalecane, aby uzyskać najdokładniejsze wyceny dla krajów, w których stawki celne zależą od wymiarów artykułu. hash
items.dimensions.height OPCJONALNELiczba dziesiętna określająca wysokość artykułu.
items.dimensions.length OPCJONALNELiczba dziesiętna określająca długość artykułu.
items.dimensions.unit OPCJONALNEJednostka miary wymiarów artykułu. Możliwe wartości to inch, centimeter, millimeter i null. W przypadku null używana jest jednostka inch.
items.dimensions.width OPCJONALNELiczba dziesiętna określająca szerokość artykułu.
items.duty_tax_fee_free OPCJONALNECiąg znaków określający, czy artykuł ma zostać pominięty w obliczeniu landed cost. Gdy w żądaniu zostanie wysłana wartość exclude, artykuł pojawi się w removed_items w odpowiedzi API.
items.hs_code OPCJONALNEKod HS artykułu, od 2 do 10 cyfr.
items.image_url OPCJONALNEAdres URL obrazu.
items.quantity WYMAGANELiczba całkowita określająca ilość artykułu.
items.upc_code OPCJONALNECiąg znaków z kodem UPC artykułu.
items.weight OPCJONALNELiczba dziesiętna określająca wagę artykułu.
items.weight_unit OPCJONALNECiąg znaków z jednostką miary wagi. Możliwe wartości to pound, ounce, kilogram i null. W przypadku null używana jest jednostka pound.
landed_cost OPCJONALNETyp żądania landed cost. Możliwe wartości to delivery_duty_paid i delivery_duty_unpaid. Opłaty w ramach landed cost mogą się różnić w zależności od tego, czy przesyłka jest wysyłana w trybie DDP czy DDU. W przypadku null przyjmowane jest żądanie DDP. Jeśli zostanie wysłane żądanie DDP, a DDP nie jest dostępne, zwrócony zostanie błąd 400 z komunikatem, że DDP nie jest dostępne dla podanego poziomu usług. DDP i DDU są zazwyczaj dostępne w ramach każdego poziomu usług, dlatego upewnij się, że można to skonfigurować osobno dla każdego poziomu usług, a nie na poziomie konta.
sale_type OPCJONALNEWskaźnik typu sprzedaży. Możliwe wartości to not_for_resale for_resale. W przypadku null przyjmowane jest żądanie not_for_resale.
ship_from_country WYMAGANECiąg znaków z krajem nadania, podany jako dwuliterowy kod ISO.
ship_to WYMAGANEAdres docelowy. hash
ship_to.city OPCJONALNE*Ciąg znaków z miastem, miejscowością, dzielnicą, przedmieściem lub wsią w adresie klienta. W zależności od kraju importu to pole może być WYMAGANE.
ship_to.country WYMAGANECiąg znaków z krajem docelowym, w którym znajduje się rachunek bankowy, podany jako dwuliterowy kod ISO.
ship_to.postal_code OPCJONALNE*Ciąg znaków z docelowym kodem pocztowym. To pole może być wymagane, gdy przesyłka jest wysyłana między Irlandią Północną a Unią Europejską.
ship_to.state OPCJONALNE*Ciąg znaków z kodem docelowego stanu, jeśli jest dostępny. Jeśli krajem importu jest Brazylia lub Kanada, to pole jest wymagane.
shipping WYMAGANESzczegóły wysyłki, takie jak kwota, kwota rabatu i poziom usług przewoźnika. hash
shipping.amount WYMAGANELiczba dziesiętna określająca łączną sumę kosztów wysyłki w dolarach i centach.
shipping.amount_discount OPCJONALNELiczba dziesiętna określająca kwotę rabatu dotyczącego wysyłki.
shipping.service_level WYMAGANEPoziom usług (service_level) przewoźnika. Pełną listę dostępnych poziomów usług według przewoźnika znajdziesz w dokumentacji przewoźników.

*To pole jest opcjonalne w zależności od wymagań dotyczących pól adresu w kraju importu.

1{
2 "currency": "USD",
3 "discounts": [
4 {
5 "id": "sale124",
6 "amount": 43,
7 "detail": null
8 }
9 ],
10 "items": [
11 {
12 "id": "294395",
13 "amount": 75,
14 "amount_discount": 0,
15 "brand": null,
16 "category": "Women's Clothing",
17 "color": null,
18 "country_of_origin": "FR",
19 "description_customs": null,
20 "description_retail": "Hoka One Running Shoe - Women's",
21 "detail": null,
22 "dimensions": {
23 "height": 4,
24 "length": 6,
25 "unit": "inch",
26 "width": 11
27 },
28 "duty_tax_fee_free": null,
29 "hs_code": "6116.10.00",
30 "image_url": "https://zonos.com/images/handbag.webp",
31 "quantity": 1,
32 "upc_code": null,
33 "weight": 10,
34 "weight_unit": "pound"
35 },
36 {
37 "id": "294396",
38 "amount": 15,
39 "country_of_origin": "CN",
40 "country_of_origin_source": "account_default",
41 "description_customs": "Men's t-shirt 100% polyester",
42 "description_retail": "Galaxy Quest Men's Tee Blue",
43 "detail": null,
44 "dimensions": {
45 "height": 4,
46 "lenght": 6,
47 "unit": "inch",
48 "width": 11
49 },
50 "duty_tax_fee_free": "exclude",
51 "hs_code": "6217.10",
52 "image_url": null,
53 "note": null,
54 "quantity": 1,
55 "upc_code": null,
56 "weight": 1,
57 "weight_unit": "pound"
58 }
59 ],
60 "landed_cost": "delivery_duty_paid",
61 "sale_type": "not_for_resale",
62 "ship_from_country": "US",
63 "ship_to": {
64 "city": "Campinas",
65 "country": "BR",
66 "postal_code": "75828-000",
67 "state": "SP"
68 },
69 "shipping": {
70 "amount": 14.23,
71 "amount_discount": 0,
72 "service_level": "ups_express_saver"
73 },
74 "tariff_rate": "zonos_preferred"
75}

Czy ta strona była pomocna?