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 wymaganym wejściem do pomyślnego ukończenia tego żądania wyceny kosztów celnych.
| Pole↕ | Uwagi↕ |
|---|---|
currency WYMAGANE | Ciąg znaków waluty bazowej, reprezentowany przez kod ISO trech liter. |
discounts OPCJONALNE | Informacje związane z jakimikolwiek rabatami, w tym identyfikator, kwotę i wszelkie szczegóły. |
discounts.id OPCJONALNE | Unikatowy identyfikator rabatu dla handlowca lub eksportera. |
discounts.amount OPCJONALNE | Liczba dziesiętna z kwotą rabatu w dolarach i centach. |
discounts.detail OPCJONALNE | Dodatkowe cechy, atrybuty lub opisy rabatu. |
items WYMAGANE | Lista artykułów będących przedmiotem eksportu. hash |
items.id WYMAGANE | Unikatowy identyfikator artykułu dla handlowca lub eksportera. |
items.amount WYMAGANE | Liczba dziesiętna z sumą jednego artykułu w dolarach i centach. |
items.amount_discount OPCJONALNE | Kwota rabatu, która dotyczy artykułu. |
items.brand OPCJONALNE | Marka artykułu, np. Leatherman. |
items.category OPCJONALNE | Opis kategorii artykułu, np. Odzież. |
items.color OPCJONALNE | Kolor artykułu. |
items.country_of_origin OPCJONALNE | Kraj produkcji lub wytworzenia, reprezentowany przez kod ISO dwóch liter. Jest to zalecane dla najdokładniejszych wycen. Jeśli nie zostanie podany kraj pochodzenia, używana jest stawka Najwyższej Nacji (MFN). |
items.description_customs OPCJONALNE | Sugerowany opis towarów dla faktury handlowej. Ten opis zwykle różni się od opisu detalicznego i zwykle zawiera ogólny opis, z czego jest wykonany i do czego służy. |
items.description_retail OPCJONALNE | Opis detaliczny artykułu. |
items.detail OPCJONALNE | Dodatkowe cechy, atrybuty lub opisy artykułu. |
items.dimensions OPCJONALNE | Rozmiar przesyłki. Jest to zalecane, aby uzyskać najdokładniejsze wyceny do krajów, w których podatki celne zależą od wymiarów artykułu. hash |
items.dimensions.height OPCJONALNE | Liczba dziesiętna dla wysokości artykułu. |
items.dimensions.length OPCJONALNE | Liczba dziesiętna dla długości artykułu. |
items.dimensions.unit OPCJONALNE | Jednostka miary wymiarów artykułu. Możliwe wartości to inch, centimeter, millimeter i null. Gdy null, będzie użyty inch. |
items.dimensions.width OPCJONALNE | Liczba dziesiętna dla szerokości artykułu. |
items.duty_tax_fee_free OPCJONALNE | Ciąg znaków określający, czy artykuł nie powinien być uwzględniony w obliczeniu kosztów celnych. Gdy w żądaniu wysłane zostanie exclude, artykuł pojawi się w removed_items w odpowiedzi API. |
items.hs_code OPCJONALNE | Kod HS artykułu, 2 do 10 cyfr. |
items.image_url OPCJONALNE | URL obrazu. |
items.quantity WYMAGANE | Liczba całkowita z ilością artykułu. |
items.upc_code OPCJONALNE | Kod UPC ciągu znaków dla artykułu. |
items.weight OPCJONALNE | Liczba dziesiętna dla wagi artykułu. |
items.weight_unit OPCJONALNE | Ciąg znaków jednostki miary wagi. Możliwe wartości to pound, ounce, kilogram i null. Gdy null, będzie użyty pound. |
landed_cost OPCJONALNE | Typ żądania wyceny kosztów celnych. Możliwe wartości to delivery_duty_paid i delivery_duty_unpaid. Opłaty za wycenę kosztów celnych mogą się różnić w zależności od tego, czy wysłane są DDP czy DDU. Jeśli null, zakładane będzie żądanie DDP. Jeśli wysłane zostanie żądanie DDP, a DDP nie jest dostępne, zwrócony zostanie błąd 400 z komunikatem stwierdzającym, że DDP nie jest dostępne dla podanego poziomu serwisu. DDP i DDU są zwykle dostępne w każdym poziomie serwisu, więc upewnij się, że można to skonfigurować na poziomie serwisu, a nie na poziomie konta. |
sale_type OPCJONALNE | Wskaźnik typu sprzedaży. Możliwe wartości to not_for_resale for_resale. Jeśli null, zakładane będzie żądanie not_for_resale. |
ship_from_country WYMAGANE | Ciąg znaków kraju wysyłki, reprezentowany przez kod ISO dwóch liter. |
ship_to WYMAGANE | Adres docelowy. hash |
ship_to.city OPCJONALNE* | Ciąg znaków dla miasta, miasta, dzielnicy, przedmieścia lub wioski adresu dostawcy. W zależności od kraju importu to pole może być WYMAGANE. |
ship_to.country WYMAGANE | Ciąg znaków dla kraju docelowego, w którym znajduje się rachunek bankowy, reprezentowany przez kod ISO dwóch liter. |
ship_to.postal_code OPCJONALNE* | Ciąg znaków dla kodu pocztowego docelowego. To pole może być wymagane, gdy przesyłka jest między Irlandią Północną a Unią Europejską. |
ship_to.state OPCJONALNE* | Ciąg znaków dla kodu stanu docelowego, jeśli jest dostępny. Jeśli krajem importu jest Brazylia lub Kanada, to pole jest wymagane. |
shipping WYMAGANE | Szczegóły wysyłki, takie jak kwota, kwota rabatu i poziom serwisu u przewoźnika. hash |
shipping.amount WYMAGANE | Liczba dziesiętna dla całkowitej sumy kosztów wysyłki w dolarach i centach. |
shipping.amount_discount OPCJONALNE | Liczba dziesiętna dla kwoty rabatu dotyczącej wysyłki. |
shipping.service_level WYMAGANE | Poziom serwisu u przewoźnika. Zapoznaj się z dokumentacją przewoźnika, aby uzyskać pełną listę dostępnych poziomów serwisu u przewoźnika. |
*To pole jest opcjonalne w zależności od wymagań pola adresu dla kraju importu.
1
{2
"currency": "USD",3
"discounts": [4
{5
"id": "sale124",6
"amount": 43,7
"detail": null8
}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": 1127
},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": 1149
},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
}
Zażądaj wyceny kosztów celnych
Znajdź pary klucz/wartość w żądaniu wyceny kosztów celnych.Chociaż Zonos Landed Cost jest w stanie dostarczyć dokładną wycenę kosztów celnych na podstawie samego opisu artykułu, im więcej podanych informacji, tym bardziej dokładna będzie wycena kosztów celnych. Poniżej znajdują się dane WYMAGANE i OPCJONALNE, ale zaleca się wypełnienie jak wielu pól OPCJONALNYCH, ile to możliwe.