Product API

@
1. How does a seller obtain all the products in his store through the API?
You can obtain it by calling taobao.items.onsale.get (items on sale in the store) and taobao.items.inventory.get (items in the store warehouse).

2. What is the reason why the interface taobao.items.onsale.get cannot query products by seller_cids?
There is a prerequisite for obtaining products under custom categories in this way: when calling the interface taobao.sellercats.list.get to obtain custom categories, the category type must be manual classification. (i.e. type=manual_type). If it is not classified manually, you cannot query the products under the corresponding category.

3. Why can’t the interface taobao.items.inventory.get get all the items in the warehouse?
By default, this API does not query all products in the warehouse. If you need to query all products, you must enter the parameter banner (all types are entered). For details, please see the description of the banner field in the API.

4. Why can’t market sellers search for products on taobao.products.get?
This is an API for searching products, not products. Market sellers have no concept of products. It is only needed when Tmall merchants release products before releasing them.

5. Why is the sku color displayed on the page as light blue, but the actual blue color is obtained through taobao.item.get (fields returns sku)?
The page displays aliases, corresponding to the property_alias field in the API. Not the properties_name field in the sku.

6. Where do taobao.item.add get the cid and props attribute parameters when adding products?
Obtained through category-related APIs taobao.itemcats.get and taobao.itemprops.get. In addition, attribute tools are also available, which can be used in conjunction with the API during development and testing for easier understanding.

7. Using SDK, how to add pictures through image when adding products?
Add pictures in the following format, where "fileLocation" is the local picture file path.
java: FileItem fItem = new FileItem(new File("fileLocation")); req.setImage(fItem);
PHP: $req->setImage(@fileLocation);
.NET: FileItem fItem = new FileItem("fileLocation");
Note: If sdk is not used, the image needs to be added by converting it into a binary stream. It is recommended to use SDK to simplify the API calling process.
8. When uploading products, only the main image of the product can be added. How to add other images to the product?
Call taobao.item.img.upload to add

9. taobao.item.update Do all fields need to be filled in when modifying the product? If not, will the fields that are not filled in be filled in? modified?
Not all fields need to be filled in, and those that are not filled in will not be updated.

10. This error occurs when calling the interface taobao.item.update. What is the problem with isv.invalid-parameter:desc?
It is recommended that the desc description should not be too long, otherwise the data packets sent to the server are likely to be lost, resulting in signature errors.

11. Why is the page still displayed after deleting product details?
Usually it is caused by the merchant citing the Wangpu decoration template in the product details, and the merchant needs to cancel it by himself.

12. Does the system automatically add and remove products from the shelves? Will it affect the product’s window recommendation status? Does the messaging service push messages?
Does not affect . No push messages.

13. When listing products on taobao.item.update.listing, the following error is displayed. How to deal with it?
"Remote service error "Popular Style Name" attribute error: Category attribute does not exist in the standard attribute: Popular Style Name"
This is the product "Popular Style Name" This If the attribute is not added, an error will be reported when it is put on the shelf. This attribute is a required attribute. Please go to the page to edit and add this attribute, and then try to modify it using the API. The interface listing is fully verified. If a certain attribute of the product is wrong, the listing will fail and a prompt will be thrown.

14. What is the reason for the following error when calling taobao.item.get?

<br> Error: <code>7</code><msg>App Call Limited</msg><sub_code>accesscontrol.limited-by-app-api-access -count</sub_code><sub_msg>This ban will last for 23452 more seconds</sub_msg>

Applying to the official environment testing phase, in addition to the 5000/day traffic limit. There are also traffic restrictions for certain APIs. For example, taobao.item.get cannot be called more than 10 times, otherwise it will prompt "This ban will last for 23452 more seconds", and after an error, it cannot be called again, and you need to wait 23452 seconds before continuing. transfer. For more detailed instructions, please refer to the instructions at http://dev.open.taobao.com/bbs/read.php?tid=24648

15. How to add baby wireless through the taobao.item.add interface Details?
This interface does not support adding baby wireless details. You can use the schema interface. For how to use the schema interface, please refer to //open.taobao.com/doc/detail.htm?spm=a219a.7386797.1998343897.4.dPcIAf&id= 102602

16. How to add a product through the API?
To add a product, you need to first call the category api to obtain the product category and attributes, and then call taobao.item.add to add the product. For details, please refer to //open.taobao.com/doc/detail.htm?id=121

Trading API

@
1. What are the general steps to obtain an order? Which APIs are needed?
Generally, three interfaces for transaction acquisition orders are used together. The details are as follows:
I: First use taobao.trades.sold.get - to obtain online orders sold within three months, suitable for users Used during initialization, ISV should not use this interface to obtain incremental orders. It is not recommended to use this interface or use it as little as possible.
II: Use taobao.trades.sold.increment.get again - to obtain incremental orders. It is suitable for orders that have been changed in incremental synchronization after user initialization. ISV should not use this interface to obtain orders within three months. .
III: The above two batch acquisition order interfaces only return some fields of the order. If you need to obtain all fields of the order, you need to use it in conjunction with taobao.trade.fullinfo.get (get single order details).
For more detailed instructions, please refer to: //open.taobao.com/doc/detail.htm?id=1029

2. taobao.trades.sold.get or taobao.trades.sold Why can't the .increment.get interface get the order?
Generally this is caused by not adding type when querying orders (pay attention to the description of this field in the api document). By default, only a few types of orders are checked. If you need to query all types of orders, you need to pass all types. (If you query Tmall international orders, you need to enter the parameter type=tmall_i18n). In addition, you should also pay attention to the time period of the query order and confirm that the order being queried is within the query time range.

3. Does the transaction interface provide fields related to gold coins, bonus points, and red envelopes?
No relevant fields provided.

4. Why can’t taobao.trades.sold.get obtain the buyer’s message information in the order?
This interface only provides access to some fields of the order, which does not include buyer messages. When querying, you can use the field has_buyer_message of this interface to determine whether there is a message from the buyer. If it is true (indicating that the buyer has a message), use the taobao.trade.fullinfo.get interface to obtain the message from the buyer

5. Can batch acquisition order interfaces such as taobao.trades.sold.get obtain orders 3 months ago?
Unable to obtain, only orders in the past 3 months are available.

6. The taobao.trades.sold.get interface cannot press RATE_UNSELLER to find unrated orders?
There is no need for the seller to evaluate the order, and there is no unevaluated status by the seller. It cannot be queried by the unevaluated status.

7. sku_properties_name is incomplete and a part is missing. Why?
Now the skuid and sku description in the order are separated by "|". If you put "|" into the sku description, the sku description after "|" will not be available. It is recommended not to use "|" "To describe the sku

8. Cash on delivery related field description
buyer_cod_fee: The buyer's cash on delivery service fee is paid by the buyer to the logistics company.
seller_cod_fee: The seller’s cash on delivery service fee is paid by the seller to the logistics company.
cod_fee: Cash on delivery service fee, different logistics companies are different. If the buyer pays the service fee, then buyer_cod_fee=cod_fee; if the seller pays, then seller_cod_fee=cod_fee;
If the buyer and seller pay jointly, it is the sum of the two. Sellers can set who pays the cash on delivery service fee.
Cash on delivery service introduction reference: http://service.taobao.com/support/knowledge-847852.htm?spm=0.0.0.41.XRGCJF&dkey=searchview

9, Tmall International orders cannot be obtained using the following interface (taobao.trades.sold.get). How to deal with it?
When querying, pass type to tmall_i18n to return Tmall International orders. Type does not pass the default query, which does not include Tmall international orders. The API document has instructions. The same situation occurs when querying the taobao.trades.sold.increment.get interface.

10. When calling the transaction remarks interface, how to add remarks after an order that already has remarks?
It can’t be achieved. Remark modifications are overwritten, and the new remark content will overwrite the original old remark.

11. Why can’t the transaction interface taobao.trade.get obtain buyer_memo and buyer_message?
buyer_memo is the buyer's memo, which can only be seen by buyers and not by sellers (including using the API).
buyer_message is only provided by the order details interface. If the buyer leaves a message when placing the order, please use taobao.trade.fullinfo.get to obtain it

Logistics API

@
1. How to synchronize order status to Taobao through API?
Use the logistics delivery API to complete the synchronization. Such as taobao.logistics.offline.send or taobao.logistics.online.send

2. What is the difference between the self-contact interface (api) and the online ordering interface?
The only difference is the delivery method. Contacting yourself means that the seller (merchant) calls the logistics company to come to collect the goods; while online ordering means placing an order directly through the online system and notifying the logistics company to come to collect the goods.

3. What is the function of the shipping confirmation interface taobao.logistics.online.confirm?
When using the online ordering interface taobao.logistics.online.send to ship goods, if the waybill number is not entered when shipping, you need to cooperate with this interface to confirm the shipment.

4. How to split the order and ship it?
When using the logistics interface to ship goods, on the basis of the original input parameters (order number tid, waybill number out_sid, logistics company code company_code), add the two parameters sub_tid and is_split to complete the order splitting. sub_tid indicates the sub-order number of the transaction, which is oid, and is_split indicates whether to split the order.
For more instructions on order splitting, please refer to: //open.taobao.com/doc/detail.htm?id=101521

5. Is there any logistics information when the transaction is closed?
If the buyer closes the transaction without paying, there will be no logistics order information; if the buyer closes the transaction after paying, there will be logistics order information.

6. What is the reason why the Taobao backend page does not display the content after it is pushed through the warehouse and circulation information push interface?
This push interface is only valid when the "other (own logistics company name)" logistics company is used for shipment. If it is a logistics company that Taobao cooperates with, it is invalid and the page will not be displayed. In addition, if the logistics company at the time of delivery is not exactly the same as the logistics company at the time of push, the page will not display the pushed content. taobao.logistics.orderstore.push Logistics order warehouse information push interface (only supports other-others need to be entered by yourself below) Push)

7. Why is the type returned by "Hubei-Xiantao City" returned is 4?
Xiantao City is a county-level city directly under the jurisdiction of Hubei Province, and its regional type is the same as that of a county.

8. Some prefecture-level cities obtained do not have districts or counties under their jurisdiction, such as Zhongshan City, Guangdong. How to deal with it?
Just use the address area code of Zhongshan City to enter the parameters. For example, when using taobao.logistics.partners.get to query, the area code fields (source_id, target_id) are directly passed to the area code of Zhongshan City.

9. Remote service error address database information does not exist isv.logistics-offline-service-error:B101
The address database information is deleted, resulting in the seller not being able to be obtained during delivery. return shipping address. You can go to the "Seller Center - Logistics Tools" page to fill in the address and try again.

10. Can the waybill numbers of different sub-orders be modified to the same waybill number?
No, when modifying, the waybill numbers corresponding to each sub-order must be different.

11. When the order to be shipped is shipped using taobao.logistics.online.send, what is the reason for repeated shipment?
It should be caused by repeated shipment (the waybill number was not entered for the first time). If the waybill number is not entered for delivery, the interface will return success, but the order status will not change, and it is still waiting for delivery. At this time, you need to use taobao.logistics.online.confirm to confirm the shipment, and you cannot use taobao.logistics.online.send to send it again, otherwise the interface will prompt for repeated shipment.

Evaluation API

@
1. The buyer has evaluated, but why the interface cannot obtain evaluation data?
The evaluation can only be seen after the buyer and seller evaluate each other. If the seller does not reply after the buyer evaluates, the buyer's evaluation information (good reviews, neutral reviews, negative reviews) cannot be found

2. Can the new evaluation interface be used for Tmall merchants?
No, only market sellers are supported for now

3. What is the difference between taobao.traderate.add and taobao.traderate.list.add?
The former is to add a single evaluation, and the latter is to add batch evaluations. If there are three sub-orders in a transaction, taobao.traderate.add needs to be evaluated three times, while taobao.traderate.list.add only needs to be evaluated once.

4. What is the reason for the prompt "Main order not available" when evaluating? How to deal with it
I: Confirm whether the evaluation conditions are met (transaction successful, not evaluated, evaluation time has not exceeded)
II: Confirm whether the product is a special category ("other" category, check the cid through tid , and then use the category interface to check if cid is in another category. This category includes 6 subcategories of "order, gift, deposit, new product preview, postage, matching package")
III: There is a refund sub-order in trade, Cannot use taobao.traderate.list.add to evaluate (report unevaluable error)

5. In the transaction interface, it is displayed that the order has not been evaluated, but the evaluation interface can find the buyer's evaluation. Why is it?
If the buyer does not submit a rating when evaluating, then the evaluation is not completed at this time, and there will be a problem that the evaluation content can be seen, but the order evaluation status is still pending evaluation.

Refund API

@
1. Is the taobao.refunds.receive.get interface available? Inquiry about after-sales refund order?
The after-sales refund interface cannot be obtained, and the interface does not support obtaining it yet.

2. How to deal with store coupons when refunding?
Not shipped: The entire transaction order is canceled and closed or the application for a full refund is successful. The store coupon will be returned to the buyer and the validity period remains unchanged. If the validity period has expired when returned, the coupon will be invalid;
Already Delivery: If a transaction dispute occurs, the actual payment amount will be calculated, and store coupons will not be processed.

Wangwang API

@
1, taobao.wangwang.abstract.logquery query Chat history error, what's the reason?
<msg>Remote service error</msg><sub_code>isp.api-srv-error</sub_code>
Caused by not initializing the query chat interface, before calling First use taobao.wangwang.abstract.initialize to initialize (only needs to be initialized once)

2. Can taobao.wangwang.eservice.loginlogs.get obtain the login log of Wangwang Mobile?
No, only the login logs of PC users are supported.

3. How is the average waiting time of the customers received by Wangwangzhong calculated on that day?
Take the average waiting time of all customers, as follows:
If there are N customers in total, and the waiting time of each customer is Sn seconds, the average waiting time is: (S1 S2..... .Sn)/N
Waiting time rule: Only customer service S1 (S1 can be the main account or sub-account) replies to 1 message from B1, then the time interval between B1 sending a message and customer service S1 replying to the first message is The waiting time of S1 for B1 is an integer

4. When calling the Wangwang interface, the following error is reported. What is the reason and how to deal with it?
Exception in thread "main" java.lang.IllegalArgumentException: expected value at column 1
Change the format of the returned data to xml. Do not use the default json. The Wangwang interface cannot support json return.

User API

@
1. When using the online ordering application, the following error is reported when calling taobao.user.buyerer.get. What? reason?
11 Insufficient isv permissionsisv.permission-api-package-limits
The error message indicates that there is no api permission and cannot be called. Seller applications (such as product management) cannot adjust the buyer API (taobao.user.buyerer.get), which is for buyer applications. To obtain seller-related information, please call taobao.user.seller.get

FAQ

Is there a solution document for common problems in development