stable本次发布有变化全部展示
来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 How do I upload the tax type to use the TW Tax-Free feature?
The rule of uploading the value of tax_type could follow below rules:
- Request
| Name | Type | Require | Sample | Description |
|---|---|---|---|---|
| tax_info | Object | |||
| ┗tax_type | Int | True (for WL Fresh item)False (for WL Book or non-WL item) | 1 | Indicate the item is tax-able or tax-free (Only for TW local)Shopee will refer to "tax_type" when issuing e-receipts to buyers on behalf of sellers. All variations of the same item share the same "tax_type". 1: taxable2: tax-free |
- Validation logic : if the developer inputs the value of "tax_type" for items
| Case | is Tax-Free WL? | Required | Remark |
|---|---|---|---|
| 1WL Fresh | Y | True | Return error for following cases:not input tax type for Fresh item Tax type out of range The format of tax_type is invalid |
| 2WL Book | Y | False | No tax type Input considered as not input tax type value，no tax type in the responseInput " tax type = [num]"Return Error if caller input tax type value for item"tax type is invalid, this item/category cannot be set tax type" |
| 3 Non-WL | N | False | No tax type Input considered as not input tax type value，no tax type in the responseInput " tax type = [num not 0]"Return Error if caller input tax type value for item"tax type is invalid, this item/category cannot be set tax type" |
- Response
| is Tax-Free WL? | type | what will return in response |
|---|---|---|
| Y | (book) | Input&Return1:error:"tax type is invalid, this item/category cannot be set tax type"2:error:"tax type is invalid, this item/category cannot be set tax type""":""invalid:error:"tax type is invalid, this item/category cannot be set tax type" |
| Y | (Fresh) | Input&Return1:12:2"":error: "tax type is mandatory for this item, please input tax type."invalid:error: "tax type is invalid" |
| N | N | Input&Return1:error:"tax type is invalid, this item/category cannot be set tax type"2:error:"tax type is invalid, this item/category cannot be set tax type""":""invalid:error:"tax type is invalid, this item/category cannot be set tax type" |
- Update Tax type when Update category
if you call v2.product.update_item to update category, we need to check if new category is tax-free whitelist:
| is Tax-Free WL? | type | logic |
|---|---|---|
| Y | (book) | get tax_type from Shopee internal ISBN API and write into item info |
| Y | (Fresh) | If you don't provide new tax type, sys return errorIf you provide new tax type ,sys will update tax type = new tax type |
| N | N | If the item's new category is not in the tax-free WL, sys will write tax_type = 0 into item info |
- Update Tax type when Update ISBN
| is Tax-Free WL? | type | |
|---|---|---|
| Y | (book) | get tax_type from Shopee internal ISBN API and write into item info |
| Y | (Fresh) | sys do nothing |
| N | N | sys will write tax_type = 0 |
- If you request to Update Tax type and Update category together
if you call v2.product.update_item to update category and tax type together, we need to check if new category is tax-free whitelist first
| is Tax-Free WL? | type | logic |
| Y | (book) | If you request to update tax typeReturn Error if caller input tax type value for item"tax type is invalid, this item/category cannot be set tax type" |
| Y | (Fresh) | If you request to update tax typesys will update tax type = new tax type |
| N | N | not tax-free WL, If you request to update tax typesys return error "tax type is invalid, this item/category cannot be set tax type" |
变化记录
相对上一发布版本，本文内容有变化。
本版没有改过这篇（或它是新增页），没有可比的上一版。