Leina 
Wanta 
检查商品库存
查看在售商品，找出需要更新库存的商品。
/oo 1688: 列出我的商品并汇总库存情况，先不要修改库存。
试试这些 1688 任务
将提示词复制到已安装 oo Skill 的 Agent，补充页面链接和原始笔记后执行。
oo Skill 1688
准备采购
先预览订单价格及可购情况，再决定是否下单。
/oo 1688: 按这些规格和数量预览订单：[商品清单]。汇总价格与可购情况。
检查发货进度
读取订单并汇总已有物流轨迹。
/oo 1688: 查询卖家订单 [订单号]，汇总发货进度与最新物流轨迹。
检查退款申请
汇总卖家侧退款申请，辅助后续处理。
/oo 1688: 查询 [日期范围] 的退款申请，汇总原因及当前状态，先不要同意退款。
开始使用 1688
-
安装 OOMOL
在 Agent 中配置 oo CLI 和 oo Skill。
安装 OOMOL → -
连接 1688
在连接页面授权你的 1688 账户。
连接 1688 → -
向 Agent 交代任务
使用 /oo，说明要读取的页面、修改的内容和保存位置。
连接指南 →
选择你的 Agent
- 拥有可访问所需业务数据的 1688 账户。
- 部分接口需要额外的 1688 应用权限或相关服务订购。
- 本集成暂不提供自动事件通知。
1688 工具
覆盖采购与卖家运营中的商品、库存、订单、退款、发票、素材及物流业务。可使用的操作取决于平台应用权限和账户权限。
商品与采购
查找商品、查看类目、发布商品及维护库存。
订单与售后
预览并创建订单，查看订单详情、处理售后及管理发票。
发货与物流
安排发货、查询物流轨迹及管理电子面单。
账户与店铺运营
管理相册与服务订购，查询店铺信息及商品质量建议。
专项履约
处理淘大店订单、电子面单、供货库存及速卖通 JIT 揽收。
162 个工具
Search Categories
根据关键字搜索发布类目，发布类目都是叶子类目
1688.search_categories Get Category
类目查询。如果需要获取所有1688类目信息，需要从根类目开始遍历获取整个类目树。即：先传0获取所有一级类目ID，然后在通过获取到的一级类目ID遍历获取所二级类目，最后通过遍历二级类目ID获取三级类目。注意：1688类目仅三级，三级类目即发布商品所需的叶子类目。
1688.get_category Get Product Schema
获取商品发布规则和详情
1688.get_product_schema Get Product Sub Schema
当商品发布组件中的supportLevelProp属性为true时，可以通过该接口来获取商品发布级联子组件规则。
1688.get_product_sub_schema Create Product
新版商品发布
1688.create_product Query Product Publishing Data
商品发布异步信息查询，包含品牌数据查询，类目推荐、标题推荐等。
1688.query_product_publishing_data List Seller Products
卖家根据条件分页查询商品列表信息。目前无法查询简易商品。如需遍历所有商品是只能使用ID排序
1688.list_seller_products Get Product
由商品ID获取商品详细信息，请注意：只能查询自己所有的产品。
1688.get_product Get Products
根据商品ID列表获取卖家的商品。
1688.get_products Check Products Modifiable
产品是否可以修改
1688.check_products_modifiable Expire Products
商品转为过期
1688.expire_products Republish Products
未上架商品重新上架。请注意：会员每天最多上架400条，非诚信通或者买家保障会员，食品美容行业如果有限制，则不能上架，橡塑现货条数限制，已上网最多200条。
1688.republish_products Delete Product
将某个商品删除到回收站中，可在网站手工清除或恢复。此API为国际站与1688通用。
1688.delete_product Edit Product
新版商品编辑
1688.edit_product Create User Category
在1688中文中，创建用户的自定义类目。如果是一级类目，父类目Id传值0。如果是子类目，父类目传上一级类目的id。创建成功的话，会返回新的类目的id
1688.create_user_category Get User Category Enabled
获取阿里巴巴中国网站会员是否已经开启自定义分类功能
1688.get_user_category_enabled Set User Category Enabled
阿里巴巴中国网站会员开启或关闭自定义分类功能
1688.set_user_category_enabled List User Categories
获取授权用户的1688商品自定义分类列表
1688.list_user_categories Get Product User Categories
本接口实现通过数据接口的形式，批量获取指定产品所属的自定义分类ID
1688.get_product_user_categories Add Products To Category
批量添加多个商品到一个自定义分类下，一次最多操作50个商品
1688.add_products_to_category Remove Products From Category
批量移除自定义分类下的商品，一次最多操作50个商品
1688.remove_products_from_category Get Member Categories
获取指定会员（供应商）的自定义商品分类信息
1688.get_member_categories Get Video
获取单个视频
1688.get_video List Videos
分页查询获取用户视频中心的视频列表，默认返回第一页，每一页十条记录
1688.list_videos Upload Video
通过视频地址，将视频上传到用户的视频中心。 视频最大为50M
1688.upload_video Check Video Capacity
视频制作检测，目前只有视频制作后上传到1688店铺时有数量的限制。 同时保持扩展兼容，扩展其他相关服务的限制。 当前api只兼容了work工作台中视频类型的旺铺视频，其他类型的视频本api不支持。
1688.check_video_capacity Update Video
修改视频中心视频
1688.update_video Delete Video
删除1688视频中心的指定视频
1688.delete_video Find Supplier Products
根据卖家的货号或商品ID查找商品，卖家ID必传
1688.find_supplier_products Patch Product
增量编辑商品
1688.patch_product List Authorized Brands
针对实力商家，1688平台上有授权的品牌信息，商家发布商品时只能选择有授权的品牌； 通过指定商品叶子类目，查询该类目下绑定的的授权品牌列表信息，如果没有授权，返回信息为空
1688.list_authorized_brands Search Distribution Products
国内分销词搜选品
1688.search_distribution_products Update Product Stock
修改产品库存该接口支持增量修改和全量修改，通过入参控制，默认为增量修改
1688.update_product_stock Get Enterprise Sku Mapping
根据商家商品ID查询企业采购大店的对应skuId，API需要进行商家授权，即仅可以查询经过授权的商家对应的商品。
1688.get_enterprise_sku_mapping Update Quick Return Stock
修改商品快返库存
1688.update_quick_return_stock Get Processing Category
加工定制类目查询，需要从根类目开始遍历获取整个类目树。即：先传0获取所有一级类目ID，然后在通过获取到的一级类目ID遍历获取所二级类目，最后通过遍历二级类目ID获取三级类目。
1688.get_processing_category Get Customization Services
根据商家、商品、类目获取定制服务
1688.get_customization_services Save Seller Customization Values
保存商家定制服务V值
1688.save_seller_customization_values Get Relabeling Address
查询贴牌换标地址
1688.get_relabeling_address Save Product Customization
保存商品标准定制服务
1688.save_product_customization Upload Customization Image
新增/修改定制项V值-上传图片
1688.upload_customization_image Agree Refund Exchange
卖家同意换货，并填写退货地址信息。注意：只有换货的售中或者售后退款单，才可以调用这个接口。
1688.agree_refund_exchange Submit Exchange Tracking
卖家上传换货单号
1688.submit_exchange_tracking Agree Refund Reshipping
卖家同意补寄。注意：只有补寄的售中或者售后退款单，才可以调用这个接口。
1688.agree_refund_reshipping Submit Reshipping Tracking
卖家上传补寄单号
1688.submit_reshipping_tracking Get Account
获取授权用户的基本信息
1688.get_account Create Order
快速创建1688大市场订单和1688代销订单，订单一步创建，不需要先调用订单预览，接口参数简单，地址参数传省市区街道的文本名，不需要额外查询地址码，系统默认选择最优惠下单方式，默认支付宝担保交易方式，详细地址必须不超过200个字，不要用地址做其他用途，需要留言或备注的有专门字段，留言和备注都支持500字
1688.create_order Cancel Order
买家或者卖家取消交易，注意只有特定状态的交易才能取消，1688可用于取消未付款的订单。 当订单从创建到关闭时间小于10s的时候，会报“CLOSE_ORDER_TOO_FAST”错误。
1688.cancel_order Get Buyer Order
获取单个交易明细信息，仅限买家调用。该API需要向阿里巴巴开放平台申请权限才能使用。Get a single transaction detail, only for users to call.
1688.get_buyer_order Get Buyer Order V2
获取单个交易明细信息，仅限买家调用。该API需要向阿里巴巴开放平台申请权限才能使用
1688.get_buyer_order_v2 List Buyer Orders
获取买家的订单列表，也就是用户的memberId必须等于订单里的买家memberId。该接口仅仅返回订单基本信息，不会返回订单的物流信息和发票信息；如果需要获取物流信息，请调用获取订单详情接口；如果需要获取发票信息，请调用获取发票信息的API
1688.list_buyer_orders Update Order Price
修改订单价格，注意：订单价格修改逻辑同1688后台页面，是在订单原价的基础之上计算总价，不是在原先的折扣后的总价基础之上再增加或减少价格，对于订单已经存在在折扣是覆盖的。 entryDiscounts不需要已经关闭的子订单信息。
1688.update_order_price Rate Orders
此接口支持多笔订单（暂定最多10笔每次）同时提交评价，并且只支持卖家向买家的评价，目前当某笔订单存在多个商品时,只能为这笔订单的这些商品提交相同的评价内容。
1688.rate_orders Update Order Memo
授权用户为卖家修改卖家备忘，授权用户为买家修改买家备忘 注意：该接口可重复调用，备注内容将覆盖前一次调用
1688.update_order_memo Get Mixed Batch Settings
查询卖家混批设置。Query seller settings for mixed batch.
1688.get_mixed_batch_settings Get Address Code
获取交易地址代码表，该API会返回输入code的详情和该code的下一级地区code.
1688.get_address_code List Address Codes
获取交易地址的下一级信息，如果code不输入，返回最上层的地址列表
1688.list_address_codes Get Company
获取阿里巴巴中国网站会员的公司库信息
1688.get_company Extend Order Confirmation
延迟订单确认时间。
1688.extend_order_confirmation List Buyer Refund Operations
该API为买家使用，卖家查询请使用alibaba.trade.refund.OpQueryOrderRefund.sellerView，买方退款操作记录
1688.list_buyer_refund_operations Agree Return Goods
卖家同意退货，并填写退货地址信息。注意：只有退货的售中或者售后退款单，才可以调用这个接口。
1688.agree_return_goods List Shipping Addresses
我的发货地址列表
1688.list_shipping_addresses Parse Address Code
根据地址信息，解析地区码
1688.parse_address_code Get Payment Urls
通过ERP付款时，可以通过本API获取批量支付的收银台的链接。 单个订单返回1688收银台地址，多个订单返回支付宝收银台地址。 ERP可以引导用户跳转到收银台链接完成支付动作，支付前会校验用户在1688的登陆状态。
1688.get_payment_urls Get Seller Order
获取单个交易明细信息，仅限卖家调用
1688.get_seller_order List Seller Orders
获取卖家订单列表，也就是用户的memberId必须等于订单的sellerMemberId。该接口仅仅返回订单基本信息，不会返回订单的物流信息和发票信息；如果需要获取物流信息，请调用获取订单详情接口；如果需要获取发票信息，请调用获取发票信息的API
1688.list_seller_orders Find Orders By Recipient
根据收件人信息（订单创建时间、姓名、手机号、电话）查询1688订单号(卖家视角)
1688.find_orders_by_recipient Get Seller Invoice
获取订单的发票信息, 该接口需要特定的合作伙伴才能申请使用
1688.get_seller_invoice Decrypt Invoice
根据授权用户订单号获取发票信息
1688.decrypt_invoice List Seller Order Refunds
根据订单号实时查询退款单列表，目前只能查询到售中的退款单
1688.list_seller_order_refunds Get Seller Refund
查询退款单详情，同时可以查询到退款操作列表。 该API需要向阿里巴巴申请权限才能访问。
1688.get_seller_refund List Buyer Order Refunds
该API为买家使用，卖家查询请使用alibaba.trade.refund.OpQueryBatchRefundByOrderIdAndStatus.sellerView，根据订单号实时查询退款单列表，目前只能查询到售中的退款单
1688.list_buyer_order_refunds Get Buyer Refund
该API为买家使用，卖家查询请使用alibaba.trade.refund.OpQueryOrderRefund.sellerView，查询退款单详情，同时可以查询到退款操作列表。 该API需要向阿里巴巴申请权限才能访问。
1688.get_buyer_refund List Seller Refunds
根据订单号或退款单列表查询退款单列表，有可能有延迟。
1688.list_seller_refunds Preview Order
订单创建只允许购买同一个供应商的商品。本接口返回创建订单相关的优惠等信息。 1、校验商品数据是否允许订购。 2、校验代销关系 3、校验库存、起批量、是否满足混批条件
1688.preview_order Update Order Recipient
卖家修改订单的收货地址
1688.update_order_recipient Auto Refund Returned Order
退货入仓自动退
1688.auto_refund_returned_order List Invoice Applications
分页查询发票申请列表（卖家视角）
1688.list_invoice_applications List Order Invoices
查询交易单下关联的所有开具的发票信息（买家视角）
1688.list_order_invoices Submit Invoice
商家上传蓝票
1688.submit_invoice Submit Red Invoice
商家上传红票
1688.submit_red_invoice Retry Invoice
商家重试失败发票
1688.retry_invoice Delete Invoice
商家删除发票
1688.delete_invoice Get Repurchase Contract
查询商品是否支持复购合约，复购合约是买卖家签署的复购优惠合约，卖家会给与复购用户特殊的价格、保障。复购合约需要通过特定的交易flow进行下单。
1688.get_repurchase_contract Get Invoice Related Orders
卖家基于交易单 orderId或发票申请单outbizid查询合单关联关系； 如果同时传入，以outbizid为准； 如果查询出不是合并开票，那么mergeInvoice会返回false
1688.get_invoice_related_orders Ship Order Offline
1688大市场订单，卖家自己联系物流发货，支持合并发货，即：多个订单一次发货；支持子订单(orderEntry)级别的发货，不支持按数量发货。
1688.ship_order_offline Get Seller Logistics Trace
获取卖家的订单的物流跟踪信息。该接口能查能根据物流单号查看物流单跟踪信息。由于物流单录入的原因，可能跟踪信息的API查询会有延迟。
1688.get_seller_logistics_trace Get Buyer Logistics Trace
该接口需要获取订单买家的授权，获取买家的订单的物流跟踪信息，在采购或者分销场景中，作为买家也有获取物流详情的需求。该接口能查能根据物流单号查看物流单跟踪信息。由于物流单录入的原因，可能跟踪信息的API查询会有延迟。该API需要向开放平台申请权限才能访问。In the procurement or distribution scenario, buyers can obtain information on logistics tracking. The interface can view the logistics tracking information according to the logistics tacking number. Depending on the logistics information entry time, there may be a delay in API queries regarding the information tracking.
1688.get_buyer_logistics_trace Get Freight Templates
根据物流模版ID获取卖家的物流模板。运费模板ID为0表示运费说明，为1表示卖家承担运费
1688.get_freight_templates List Offline Carriers
查询自己联系物流的物流公司列表
1688.list_offline_carriers List Carriers
获取所有的物流公司名称
1688.list_carriers Get Supplier Freight Templates
代销商获取供应商的运费模版，用来计算代销商品的运费信息，需要先建立代销关系才能查询
1688.get_supplier_freight_templates List Freight Templates
获取运费模板列表。1688有两类特殊运费模板，不在此接口返回：不传运费模板表示使用运费说明；传入1表示卖家承担运费
1688.list_freight_templates Get Seller Logistics
获取卖家的订单的物流详情。该接口能查能根据物流单号查看物流详情，包括发件人，收件人，所发货物明细等。由于物流单录入的原因，可能跟踪信息的API查询会有延迟，加密场景使用。
1688.get_seller_logistics Decrypt Order Recipient
输入caid和订单id，用以获取买家收件人信息
1688.decrypt_order_recipient Group Orders By Recipient
输入caidBase合订单号，收件人地址相同的订单号会归成一组
1688.group_orders_by_recipient Set Waybill Enabled
卖家是否开通下游电子面单 1）要求接入一次性传入历史开通电子面单的卖家和渠道，后面有新增增量信息&修改信息传入。 2）若一个商家支持多渠道，需传不同渠道，分别调用多次接口，渠道名称按规范要求传。目前会校验平台支持的渠道。 3) 如果有商家解除签约电子面单，需要传入N。 4）调用需判断接口是否成功，关注业务成功字段，即result.result的值是否为true
1688.set_waybill_enabled Ship Order Official
1688大市场订单，官方物流提货，支持主单发货；暂不支持合并发货以及子单维度多次发货。
1688.ship_order_official Recommend Carriers
根据商家收货地进行物流推荐
1688.recommend_carriers Upload Shipping Voucher
发货凭证上传
1688.upload_shipping_voucher Redeem Receiving Code
商家核销收货码
1688.redeem_receiving_code Request Receiving Code
商家索要收货码
1688.request_receiving_code Check Multi Package Shipping
校验多包裹发货支持
1688.check_multi_package_shipping List Logistics Exceptions
查询物流监控异常列表
1688.list_logistics_exceptions Count Logistics Exceptions
查询物流监控异常数量统计
1688.count_logistics_exceptions Get Other Seller Product
由商品ID获取商品详细信息，接口能获取非授权用户的商品信息。 该接口需要向阿里巴巴申请权限才能访问。注意：该接口不能查询零售通商品。 注意：该接口存在风险，请在确认业务场景是否合理的情况下使用。
1688.get_other_seller_product Ship Order Without Logistics
1688大市场订单，无需物流，支持合并发货，即：多个订单一次发货；支持子订单(orderEntry)级别的发货，不支持按数量发货。
1688.ship_order_without_logistics List Legacy Orders
商机助理订单同步（内部），已弃用，请尽早换新API：com.alibaba.trade-alibaba.trade.getSellerOrderList
1688.list_legacy_orders List Related Suppliers
推荐搜索跟采购商有关的供应商列表，比如查看该买家有过交易记录的卖家，或者关注过的卖家等。该接口需要像开放平台申请权限才能访问
1688.list_related_suppliers Get Other Account
该接口本身需要授权，但可以查看他人的用户信息，主要使用在一些分销，采购场景。该接口由平台所招募的特定ISV可申请使用。
1688.get_other_account List Subscription Orders
订购的订单列表
1688.list_subscription_orders Expire Offers
通过本接口实现阿里巴巴中文站已登录卖家会员批量的设置指定offerID产品信息为过期商品的功能；转为过期的业务规则现有网站的业务逻辑保持一致；
1688.expire_offers List App Orders
获取调用该api的app在服务市场被订购的订单列表。appkey唯一表示一个app
1688.list_app_orders Get System Time
获取系统时间，从而跟本地时间进行校准
1688.get_system_time List Expiring App Orders
ISV获取自己名下的应用最近一个月的到期的订单信息列表。 只会状态是服务中或者待发布的才有到期时间
1688.list_expiring_app_orders Create Album
创建相册，
1688.create_album Delete Album
删除相册
1688.delete_album Update Album
修改授权用户自身的相册
1688.update_album Get Photo Storage
获取相册详情
1688.get_photo_storage List Albums
获取相册列表
1688.list_albums Delete Photos
批量删除图片
1688.delete_photos Delete Photo
删除图片
1688.delete_photo Update Photo
修改图片信息
1688.update_photo List Photos
获取指定相册中图片列表
1688.list_photos Upload Photo
选择的图片单张大小不超过2MB，支持jpg,jpeg,gif,bmp,png。其中不支持png图片透明色，透明处理后可能为白色或黑色。
1688.upload_photo Get Photos
根据图片ID或者URL获取图片信息
1688.get_photos Update Buyer Protection
更新买家保障中的服务，针对实力商家，“材质保障”、“发货服务”、“包换服务”三项为必选服务，类目不支持等特殊情况除外
1688.update_buyer_protection Get Buyer Protection
查询该商品开通了买家保障中的哪些服务
1688.get_buyer_protection Get Mybank Service
融易收服务开通状态和信息查询
1688.get_mybank_service Create Seller Contract
卖家创建合约
1688.create_seller_contract Resolve Wangwang Nickname
Openuid转换解密为旺旺昵称接口。该接口进行风控，仅可使用于用户需要唤起旺旺，不允许自动化批量操作，不允许作为解密接口将明文展示给用户。旺旺支持加密后回收，请勿使用于其他场景。
1688.resolve_wangwang_nickname Encrypt Login Id
用户loginId加密转换为Openuid接口。该接口进行风控，不允许批量操作，仅允许商家手动触发，比如：搜索用户订单、设置规则等功能
1688.encrypt_login_id Encrypt Login Ids
用户LoginId批量加密转换为Openuid接口
1688.encrypt_login_ids Get Product Quality Advice
（修改商品场景）根据商品id获取质量星级建议
1688.get_product_quality_advice Get Products Quality Advice
（修改商品场景）根据商品id列表获取质量星级优化建议
1688.get_products_quality_advice List Potential Expert Products
该接口可以查询行家选潜力商品，和从行家选商品退回到潜力品的商品。
1688.list_potential_expert_products List Expert Products
该接口可查询行家选商品，和考核未达标面临汰换的行家选商品。
1688.list_expert_products Get Fulfillment Data
获取用户的履约相关数据
1688.get_fulfillment_data List Search Order Tags
用户订单筛选的订单标信息查询接口
1688.list_search_order_tags List Display Order Tags
用户订单筛选的订单标信息查询接口
1688.list_display_order_tags List Tdd Orders
淘大店订单列表查询
1688.list_tdd_orders Get Tdd Order
淘大店订单详情查询
1688.get_tdd_order List Tdd Shipping Addresses
淘大店商家发货地址查询
1688.list_tdd_shipping_addresses Get Tdd Logistics Trace
根据订单id查询物流轨迹
1688.get_tdd_logistics_trace List Tdd Carriers
淘大店物流公司列表查询
1688.list_tdd_carriers Ship Tdd Order
订单发货-自联发货
1688.ship_tdd_order List Waybill Templates
获取所有物流模板
1688.list_waybill_templates Get Waybill Subscriptions
面单订购查询
1688.get_waybill_subscriptions Create Waybill
菜鸟打单取号
1688.create_waybill Update Waybill
更新电子面单
1688.update_waybill Cancel Waybill
菜鸟面单取消
1688.cancel_waybill Get Waybills
面单详情查询（根据面单号查询）
1688.get_waybills Get Order Waybills
根据订单号查询面单信息
1688.get_order_waybills Update Supply Stock
供货产品更新库存
1688.update_supply_stock List Supply Products
供货产品查询
1688.list_supply_products Create Ae Pickup Order
AE JIT订单-创建揽收单
1688.create_ae_pickup_order Get Ae Order Addresses
查询AE JIT订单发货和收货地址
1688.get_ae_order_addresses List Ae Shipping Addresses
查询商家发货地址列表
1688.list_ae_shipping_addresses Cancel Ae Pickup Order
AEJIT订单发起关单
1688.cancel_ae_pickup_order Check Ae Shipping Addresses
检查订单发货地址是否一致
1688.check_ae_shipping_addresses Get Ae Pickup Orders
查询订单揽收信息
1688.get_ae_pickup_orders Print Ae Pickup Labels
AEJIT订单打印揽收单/箱唛/货品标签
1688.print_ae_pickup_labels 没有匹配的工具。
常见问题
为什么某些操作不可用？
1688 根据应用审批、账户角色及服务订购控制接口权限。授权账户不代表开通全部接口。
创建订单会完成付款吗？
创建订单与付款是独立步骤。付款链接会打开 1688 收银台，由用户完成付款。