§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"
