Landed Cost•

ДомойСправочник API REST API Landed Cost Запросите landed cost

Запросите landed cost

Найдите пары ключ/значение в запросе landed cost.

Хотя Zonos Landed Cost может предоставить точный landed cost только на основе описания товара, чем больше информации будет предоставлено, тем точнее будет расценка landed cost. Ниже приведены ОБЯЗАТЕЛЬНЫЕ и НЕОБЯЗАТЕЛЬНЫЕ поля, но рекомендуется заполнить как можно больше НЕОБЯЗАТЕЛЬНЫХ полей.

Код HS настоятельно рекомендуется. В отличие от базового landed cost, полный landed cost будет включать детализированную информацию о ставках пошлин по коду HS на уровне товара.

Атрибуты

Пары ключ/значение JSON в теле запроса

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

HEADER zonos-version: 2019-11-21

Заголовок выше является обязательным вводом для успешного выполнения этого запроса landed cost.

Поле	Примечания
`currency` ОБЯЗАТЕЛЬНО	Строка базовой валюты, представленная трехбуквенным ISO кодом.
`discounts` НЕОБЯЗАТЕЛЬНО	Информация, связанная с любыми скидками, включая идентификатор, сумму и любые детали.
`discounts.id` НЕОБЯЗАТЕЛЬНО	Уникальный идентификатор скидки для продавца или экспортера.
`discounts.amount` НЕОБЯЗАТЕЛЬНО	Десятичное значение с суммой скидки в долларах и центрах.
`discounts.detail` НЕОБЯЗАТЕЛЬНО	Дополнительные характеристики, атрибуты или описания скидки.
`items` ОБЯЗАТЕЛЬНО	Список товаров, которые экспортируются. `hash`
`items.id` ОБЯЗАТЕЛЬНО	Уникальный идентификатор товара для продавца или экспортера.
`items.amount` ОБЯЗАТЕЛЬНО	Десятичное значение с общей стоимостью одного товара в долларах и центрах.
`items.amount_discount` НЕОБЯЗАТЕЛЬНО	Сумма скидки, применимой к товару.
`items.brand` НЕОБЯЗАТЕЛЬНО	Бренд товара, например, "Leatherman.”
`items.category` НЕОБЯЗАТЕЛЬНО	Описание категории товара, например, "Одежда."
`items.color` НЕОБЯЗАТЕЛЬНО	Цвет товара.
`items.country_of_origin` НЕОБЯЗАТЕЛЬНО	Страна производства или изготовления, представленная двухбуквенным ISO кодом. Это рекомендуется для наиболее точных котировок. Если страна происхождения не указана, используется режим наибольшего благоприятствования (MFN) rate.
`items.description_customs` НЕОБЯЗАТЕЛЬНО	Рекомендуемое описание товаров для коммерческого счета-фактуры. Это описание обычно отличается от розничного и обычно включает общее описание того, что это такое, из чего оно сделано и для чего используется.
`items.description_retail` НЕОБЯЗАТЕЛЬНО	Розничное описание товара.
`items.detail` НЕОБЯЗАТЕЛЬНО	Дополнительные характеристики, атрибуты или описания товара.
`items.dimensions` НЕОБЯЗАТЕЛЬНО	Размер отправления. Это рекомендуется для получения наиболее точных котировок в страны, где тарифы зависят от размеров товара. `hash`
`items.dimensions.height` НЕОБЯЗАТЕЛЬНО	Десятичное значение для высоты товара.
`items.dimensions.length` НЕОБЯЗАТЕЛЬНО	Десятичное значение для длины товара.
`items.dimensions.unit` НЕОБЯЗАТЕЛЬНО	Единица измерения для размеров товара. Возможные значения: `inch`, `centimeter`, `millimeter` и `null`. При `null` будет использоваться `inch`.
`items.dimensions.width` НЕОБЯЗАТЕЛЬНО	Десятичное значение для ширины товара.
`items.duty_tax_fee_free` НЕОБЯЗАТЕЛЬНО	Строка для указания, следует ли исключить товар из расчета landed cost. Когда `exclude` отправляется в запросе, товар появится в `removed_items` в ответе API.
`items.hs_code` НЕОБЯЗАТЕЛЬНО	HS код товара, от 2 до 10 цифр.
`items.image_url` НЕОБЯЗАТЕЛЬНО	URL изображения.
`items.quantity` ОБЯЗАТЕЛЬНО	Целое число с количеством товара.
`items.upc_code` НЕОБЯЗАТЕЛЬНО	Строка UPC кода для товара.
`items.weight` НЕОБЯЗАТЕЛЬНО	Десятичное значение для веса товара.
`items.weight_unit` НЕОБЯЗАТЕЛЬНО	Строка единицы измерения для веса. Возможные значения: `pound`, `ounce`, `kilogram` и `null`. При `null` будет использоваться `pound`.
`landed_cost` OPTIONAL	Тип запроса для landed cost. Возможные значения включают `delivery_duty_paid` и `delivery_duty_unpaid`. Плата за landed cost может различаться в зависимости от того, отправляется ли она DDP или DDU. Если `null`, будет предполагаться запрос DDP. Если сделан запрос DDP и DDP недоступен, будет возвращена ошибка 400 с сообщением о том, что DDP недоступен для предоставленного уровня сервиса. DDP и DDU обычно доступны в каждом уровне сервиса, поэтому убедитесь, что это можно настроить на уровне каждого сервиса, а не на уровне аккаунта.
`sale_type` OPTIONAL	Индикатор типа продажи. Возможные значения включают `not_for_resale` и `for_resale`. Если `null`, будет предполагаться запрос `not_for_resale`.
`ship_from_country` REQUIRED	Строка страны отправления, представленная двухбуквенным ISO кодом.
`ship_to` REQUIRED	Адрес назначения. `hash`
`ship_to.city` OPTIONAL*	Строка для города, населенного пункта, района, пригородной зоны или деревни клиента. В зависимости от страны импорта это поле может быть ОБЯЗАТЕЛЬНЫМ.
`ship_to.country` REQUIRED	Строка для страны назначения, в которой находится банковский счет, представленная двухбуквенным ISO кодом.
`ship_to.postal_code` OPTIONAL*	Строка для почтового кода назначения. Это поле может быть обязательным, когда отправка осуществляется между Северной Ирландией и Европейским Союзом.
`ship_to.state` OPTIONAL*	Строка для кода штата назначения, если доступно. Если страна импорта - Бразилия или Канада, это поле обязательно.
`shipping` REQUIRED	Детали доставки, такие как сумма, сумма скидки и уровень сервиса с перевозчиком. `hash`
`shipping.amount` REQUIRED	Десятичное значение для общей суммы затрат на доставку в долларах и центрах.
`shipping.amount_discount` OPTIONAL	Десятичное значение для суммы скидки, применяемой к доставке.
`shipping.service_level` REQUIRED	Уровень сервиса с перевозчиком. См. документацию перевозчика для полного списка доступных уровней сервиса по перевозчику.

*Это поле является необязательным в зависимости от требований к полям адреса для страны импорта.

Пример запроса

{
  "currency": "USD",
  "discounts": [
    {
      "id": "sale124",
      "amount": 43.0,
      "detail": null
    }
  ],
  "items": [
    {
      "id": "294395",
      "amount": 75,
      "amount_discount": 0,
      "brand": null,
      "category": "Women's Clothing",
      "color": null,
      "country_of_origin": "FR",
      "description_customs": null,
      "description_retail": "Hoka One Running Shoe - Women's",
      "detail": null,
      "dimensions": {
        "height": 4,
        "length": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": null,
      "hs_code": "6116.10.00",
      "image_url": "https://zonos.com/images/handbag.png",
      "quantity": 1,
      "upc_code": null,
      "weight": 10,
      "weight_unit": "pound"
    },
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "detail": null,
      "dimensions": {
        "height": 4,
        "lenght": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": "exclude",
      "hs_code": "6217.10",
      "image_url": null,
      "note": null,
      "quantity": 1,
      "upc_code": null,
      "weight": 1,
      "weight_unit": "pound"
    }
  ],
  "landed_cost": "delivery_duty_paid",
  "sale_type": "not_for_resale",
  "ship_from_country": "US",
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state": "SP"
  },
  "shipping": {
    "amount": 14.23,
    "amount_discount": 0,
    "service_level": "ups_express_saver"
  },
  "tariff_rate": "zonos_preferred"
}

Пример ответа

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

{
  "id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
  "amount_subtotal": {
    "duties": 27.74,
    "fees": 15.33,
    "taxes": 16.23
  },
  "currency": {
    "id": "curr_8fb20952-d",
    "base": "USD",
    "date": "2019-11-04T20:42:40.999+0000",
    "rates": [
      {
        "currency": "BRL",
        "rate": 0.2274
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 32.0,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Women's Tennis Shoe",
        "description_retail": "Hoka One Running Shoe - Women's",
        "detail": null,
        "dimensions": {
          "height": 4.0,
          "length": 6.0,
          "unit": "inch",
          "width": 11.0
        },
        "hs_code": "6116.10.00",
        "hs_code_source": "account_default",
        "image_url": "https://zonos.com/images/handbag.png",
        "note": null,
        "quantity": 1,
        "upc_code": null,
        "weight": 10.0,
        "weight_unit": "pound"
      }
    ],
    "ship_to_country": "BR",
    "shipping_amount": 14.23
  },
  "de_minimis": [
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "duty"
    },
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [
    {
      "amount": 19.2,
      "description": "duty",
      "formula": "60%",
      "item_id": "294395",
      "note": "Duty is 60% of the items total.",
      "type": "item"
    },
    {
      "amount": 8.54,
      "description": "Duty",
      "formula": "60%",
      "item_id": null,
      "note": null,
      "type": "shipping"
    }
  ],
  "fees": [
    {
      "amount": 22.0,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "formula": "15 USD",
      "item_id": null,
      "note": null,
      "type": "ddp_service_fee"
    },
    {
      "amount": 0.33,
      "description": "UPS Currency Conversion Fee",
      "formula": ".75% of the amount converted",
      "item_id": null,
      "note": null,
      "type": "currency_conversion_fee"
    }
  ],
  "removed_items": [
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "hs_code": "6217.10",
      "hs_code_source": "account_default",
      "note": null,
      "quantity": 1
    }
  ],
  "remittance": [],
  "taxes": [
    {
      "amount": 7.02,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": "294395",
      "note": null,
      "type": "item"
    },
    {
      "amount": 3.12,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 6.09,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "duty"
    }
  ]
}

Была ли эта страница полезной?

Вопросы?

Свяжитесь с нами.

Посмотреть Zonos

политики и соглашения