Leina 
Wanta 
Review product stock
Review current listings and identify products needing a stock update.
/oo 1688: List my products and summarize their stock levels. Do not change stock.
Connect 1688 to Your AI Agent
Ask AI to inspect products and orders, prepare purchases, update listings and follow shipments in your 1688 account.
162 tools OAuth
Try a 1688 Task
Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.
oo Skill 1688
Prepare a purchase
Preview an order before deciding whether to place it.
/oo 1688: Preview an order for these product specifications and quantities: [items]. Summarize the price and availability.
Check shipment progress
Read an order and summarize available tracking updates.
/oo 1688: Check seller order [order ID] and summarize its shipment progress and latest tracking update.
Review refund requests
Summarize seller-side refund cases before taking action.
/oo 1688: List refund requests for [date range] and summarize their reasons and current status. Do not approve any requests.
Start Working with 1688
-
Install OOMOL
Set up oo CLI and the oo Skill in your agent.
Install OOMOL → -
Connect 1688
Authorize your 1688 account through the connection page.
Connect 1688 → -
Give Your Agent a Task
Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →
Choose Your Agent
- A 1688 account with access to the business data you want to use.
- Some APIs require additional 1688 application permissions or a relevant service subscription.
- Automatic event notifications are not available in this integration.
1688 Tools
Connect procurement and seller operations across product catalogs, stock, orders, refunds, invoices, media and logistics. Available operations depend on the permissions granted to the platform application and your account.
Products and sourcing
Find products, inspect categories, publish listings and manage stock.
Orders and after-sales
Preview and create orders, review order details, handle refunds and manage invoices.
Shipping and logistics
Arrange shipments, track deliveries and manage electronic waybills.
Account and shop operations
Manage albums and service subscriptions, inspect shop information and product quality.
Specialized fulfillment
Manage Tao Da Dian orders, electronic waybills, supply stock and AliExpress JIT pickup.
162 tools
Search Categories
Search leaf publishing categories by keyword.
1688.search_categories Get Category
Get a category and its children; use categoryID 0 to list root categories.
1688.get_category Get Product Schema
Get category-specific product publishing rules and current product data.
1688.get_product_schema Get Product Sub Schema
Get cascading component rules for a publishing component with supportLevelProp enabled.
1688.get_product_sub_schema Create Product
Publish a product using the current category schema returned by get_product_schema.
1688.create_product Query Product Publishing Data
Query publishing suggestions such as brands, categories and titles using the schema query type.
1688.query_product_publishing_data List Seller Products
List the authorized seller's products. Use ID sorting when traversing all products; simple products are excluded.
1688.list_seller_products Get Product
Get detailed information for a product owned by the authorized seller.
1688.get_product Get Products
Get the authorized seller's products by product ID list.
1688.get_products Check Products Modifiable
Check whether the specified products can be edited.
1688.check_products_modifiable Expire Products
Take the specified products off sale by marking them expired.
1688.expire_products Republish Products
Republish offline products, subject to the seller's daily publishing quota and category restrictions.
1688.republish_products Delete Product
Move a product to the recycle bin; permanent deletion or restoration is performed on the website.
1688.delete_product Edit Product
Edit a product using its current category publishing schema.
1688.edit_product Create User Category
Create a seller-defined product category; parentID 0 creates a root category.
1688.create_user_category Get User Category Enabled
Check whether a member has enabled seller-defined product categories.
1688.get_user_category_enabled Set User Category Enabled
Enable or disable the display of seller-defined product categories.
1688.set_user_category_enabled List User Categories
List the authorized user's seller-defined product categories.
1688.list_user_categories Get Product User Categories
Get seller-defined category IDs for the specified products.
1688.get_product_user_categories Add Products To Category
Add up to 50 products to a seller-defined category.
1688.add_products_to_category Remove Products From Category
Remove up to 50 product memberships from a seller-defined category without deleting the products.
1688.remove_products_from_category Get Member Categories
Get a supplier's seller-defined product categories.
1688.get_member_categories Get Video
Get a video from the authorized user's video center.
1688.get_video List Videos
List videos in the authorized user's video center.
1688.list_videos Upload Video
Upload a video of at most 50 MB to the video center using a public file URL.
1688.upload_video Check Video Capacity
Check video-center capacity for supported Work shop videos.
1688.check_video_capacity Update Video
Update a video-center video's title and description.
1688.update_video Delete Video
Delete a video from the 1688 video center.
1688.delete_video Find Supplier Products
Find a supplier's products by cargo number or product ID; the supplier ID is required.
1688.find_supplier_products Patch Product
Apply an incremental product edit using the category publishing schema.
1688.patch_product List Authorized Brands
List the seller's authorized brands for the specified leaf categories.
1688.list_authorized_brands Search Distribution Products
Search domestic distribution products by keyword and filters.
1688.search_distribution_products Update Product Stock
Update product stock incrementally or absolutely; the upstream default is incremental.
1688.update_product_stock Get Enterprise Sku Mapping
Map an authorized supplier's product IDs to enterprise procurement SKU IDs.
1688.get_enterprise_sku_mapping Update Quick Return Stock
Update a product's quick-return stock.
1688.update_quick_return_stock Get Processing Category
Get processing/customization categories and their children.
1688.get_processing_category Get Customization Services
Get customization services by category and optional product.
1688.get_customization_services Save Seller Customization Values
Save the seller's customization service values.
1688.save_seller_customization_values Get Relabeling Address
Get the seller's private-label and relabeling service address.
1688.get_relabeling_address Save Product Customization
Save standard customization services for the specified products.
1688.save_product_customization Upload Customization Image
Upload a customization-service image by passing the base64-encoded image URL to 1688.
1688.upload_customization_image Agree Refund Exchange
Agree to an exchange refund and provide the return address; only exchange disputes are supported.
1688.agree_refund_exchange Submit Exchange Tracking
Submit the replacement shipment tracking number for an exchange dispute.
1688.submit_exchange_tracking Agree Refund Reshipping
Agree to reship goods for a reshipping dispute.
1688.agree_refund_reshipping Submit Reshipping Tracking
Submit the tracking number for a reshipment.
1688.submit_reshipping_tracking Get Account
Get basic information for the authorized 1688 account.
1688.get_account Create Order
Create a wholesale or distribution purchase order. Omit tradeType to let 1688 select an available payment method; use outOrderId for idempotency.
1688.create_order Cancel Order
Cancel an eligible unpaid order as buyer or seller; orders less than ten seconds old may reject cancellation.
1688.cancel_order Get Buyer Order
Get buyer-side order details with selectable information fields using version 1.
1688.get_buyer_order Get Buyer Order V2
Get buyer-side order details using version 2.
1688.get_buyer_order_v2 List Buyer Orders
List the authorized buyer's orders; use order details for logistics and invoices.
1688.list_buyer_orders Update Order Price
Update shipping and line discounts relative to original order prices, replacing existing discounts.
1688.update_order_price Rate Orders
Submit seller-to-buyer ratings for at most ten orders; ratings below four stars require a comment.
1688.rate_orders Update Order Memo
Replace the authorized buyer's or seller's order memo.
1688.update_order_memo Get Mixed Batch Settings
Get a seller's mixed-batch purchasing settings.
1688.get_mixed_batch_settings Get Address Code
Get an address code and its immediate children.
1688.get_address_code List Address Codes
List child address codes; omit areaCode for the root level.
1688.list_address_codes Get Company
Get company information for a 1688 member.
1688.get_company Extend Order Confirmation
Extend the buyer's confirmation period as the seller.
1688.extend_order_confirmation List Buyer Refund Operations
List refund operation history from the buyer's perspective.
1688.list_buyer_refund_operations Agree Return Goods
Agree to a return-of-goods refund and provide the seller's return address.
1688.agree_return_goods List Shipping Addresses
List the authorized user's shipping addresses.
1688.list_shipping_addresses Parse Address Code
Resolve region codes from an address.
1688.parse_address_code Get Payment Urls
Get checkout links for orders; payment is completed by the user at checkout.
1688.get_payment_urls Get Seller Order
Get seller-side order details in the encrypted-data scenario.
1688.get_seller_order List Seller Orders
List seller-side orders in the encrypted-data scenario; details provide logistics and invoices.
1688.list_seller_orders Find Orders By Recipient
Find seller-side order IDs by recipient information.
1688.find_orders_by_recipient Get Seller Invoice
Get an order's invoice information in the encrypted-data scenario; partner permission is required.
1688.get_seller_invoice Decrypt Invoice
Get invoice information for an order authorized to the current user.
1688.decrypt_invoice List Seller Order Refunds
Get in-sale refunds for an order from the seller's perspective.
1688.list_seller_order_refunds Get Seller Refund
Get seller-side refund details and optional operation history.
1688.get_seller_refund List Buyer Order Refunds
Get in-sale refunds for an order from the buyer's perspective.
1688.list_buyer_order_refunds Get Buyer Refund
Get buyer-side refund details and optional operation history.
1688.get_buyer_refund List Seller Refunds
List seller-side refunds by order or filters; data may be delayed.
1688.list_seller_refunds Preview Order
Preview pricing, promotions, stock and purchasing eligibility for products from one supplier.
1688.preview_order Update Order Recipient
Update an order's receiving address as the seller.
1688.update_order_recipient Auto Refund Returned Order
Trigger an automatic refund after returned goods enter the warehouse.
1688.auto_refund_returned_order List Invoice Applications
List seller-side invoice applications by page.
1688.list_invoice_applications List Order Invoices
List invoices associated with a trade order through the seller-view endpoint.
1688.list_order_invoices Submit Invoice
Submit a seller's blue invoice.
1688.submit_invoice Submit Red Invoice
Submit a seller's red invoice.
1688.submit_red_invoice Retry Invoice
Retry a failed seller invoice submission.
1688.retry_invoice Delete Invoice
Delete a seller invoice.
1688.delete_invoice Get Repurchase Contract
Get a repurchase contract.
1688.get_repurchase_contract Get Invoice Related Orders
Find merged-order relationships by trade order or invoice application.
1688.get_invoice_related_orders Ship Order Offline
Ship orders using a carrier arranged by the seller, including supported merged or line-item shipments.
1688.ship_order_offline Get Seller Logistics Trace
Get seller-side logistics tracking; tracking updates may be delayed.
1688.get_seller_logistics_trace Get Buyer Logistics Trace
Get buyer-side logistics tracking; dedicated API permission is required and updates may be delayed.
1688.get_buyer_logistics_trace Get Freight Templates
Get the seller's freight template details; template 0 denotes a freight description and 1 seller-paid freight.
1688.get_freight_templates List Offline Carriers
List carriers supported for seller-arranged shipping.
1688.list_offline_carriers List Carriers
List all logistics companies.
1688.list_carriers Get Supplier Freight Templates
Get a supplier's freight templates for an established distribution relationship.
1688.get_supplier_freight_templates List Freight Templates
List freight templates; freight descriptions and seller-paid template 1 are not returned.
1688.list_freight_templates Get Seller Logistics
Get seller-side shipment details in the encrypted-data scenario.
1688.get_seller_logistics Decrypt Order Recipient
Resolve buyer recipient information using the authorized order ID and caid.
1688.decrypt_order_recipient Group Orders By Recipient
Group orders with matching recipient addresses by caid without modifying the orders.
1688.group_orders_by_recipient Set Waybill Enabled
Report whether the seller has enabled or terminated downstream electronic waybill service for a channel.
1688.set_waybill_enabled Ship Order Official
Request official logistics pickup for whole orders; merged and repeated partial shipments are unsupported.
1688.ship_order_official Recommend Carriers
Recommend logistics companies for a receiving location.
1688.recommend_carriers Upload Shipping Voucher
Upload a shipping voucher from a public file URL.
1688.upload_shipping_voucher Redeem Receiving Code
Redeem a goods-receipt verification code as the seller.
1688.redeem_receiving_code Request Receiving Code
Request a goods-receipt verification code as the seller.
1688.request_receiving_code Check Multi Package Shipping
Check support for multi-package shipping.
1688.check_multi_package_shipping List Logistics Exceptions
List logistics monitoring exceptions.
1688.list_logistics_exceptions Count Logistics Exceptions
Count logistics monitoring exceptions.
1688.count_logistics_exceptions Get Other Seller Product
Get another seller's product using specifically approved API permissions; Lingshoutong products are unsupported.
1688.get_other_seller_product Ship Order Without Logistics
Mark supported orders or order lines shipped without logistics, providing the applicable reason and evidence.
1688.ship_order_without_logistics List Legacy Orders
List orders through the deprecated internal business-assistant API; prefer list_seller_orders for new integrations.
1688.list_legacy_orders List Related Suppliers
Find suppliers related to the buyer through purchases or follows; dedicated API permission is required.
1688.list_related_suppliers Get Other Account
Get another account's basic information by login ID or shop domain; restricted to approved ISVs.
1688.get_other_account List Subscription Orders
List service-market subscription orders.
1688.list_subscription_orders Expire Offers
Mark the seller's specified offers expired using the legacy offer endpoint.
1688.expire_offers List App Orders
List service-market orders for the calling platform application.
1688.list_app_orders Get System Time
Get 1688 system time for clock synchronization.
1688.get_system_time List Expiring App Orders
List the application's service orders expiring around the specified date.
1688.list_expiring_app_orders Create Album
Create a photo album with private, public or password-protected access.
1688.create_album Delete Album
Delete a photo album.
1688.delete_album Update Album
Update the authorized user's photo album and optional access password.
1688.update_album Get Photo Storage
Get photo-album storage details.
1688.get_photo_storage List Albums
List photo albums.
1688.list_albums Delete Photos
Delete at most 20 photos in one request.
1688.delete_photos Delete Photo
Delete a photo.
1688.delete_photo Update Photo
Update photo information.
1688.update_photo List Photos
List photos in an album.
1688.list_photos Upload Photo
Upload a photo of at most 2 MB from a public URL. Supported formats: jpg, jpeg, gif, bmp and png; PNG transparency is not preserved by 1688.
1688.upload_photo Get Photos
Get photos by image IDs or URLs.
1688.get_photos Update Buyer Protection
Update a product's buyer-protection services; category and seller requirements still apply.
1688.update_buyer_protection Get Buyer Protection
Get buyer-protection services available or enabled for a product.
1688.get_buyer_protection Get Mybank Service
Get MyBank receiving-service enrollment status and information.
1688.get_mybank_service Create Seller Contract
Create a seller contract with payment, freight and order agreements.
1688.create_seller_contract Resolve Wangwang Nickname
Resolve an OpenUID solely for a user-initiated Wangwang launch. Automated bulk decryption or displaying plaintext for other purposes is prohibited by 1688.
1688.resolve_wangwang_nickname Encrypt Login Id
Convert a login ID to OpenUID for a manually initiated operation; 1688 prohibits automated batch use of this endpoint.
1688.encrypt_login_id Encrypt Login Ids
Batch-convert login IDs to OpenUIDs for ERP order management; null entries are ignored by 1688.
1688.encrypt_login_ids Get Product Quality Advice
Get product quality-star improvement advice when editing a product.
1688.get_product_quality_advice Get Products Quality Advice
Get quality-star improvement advice for at most 100 products.
1688.get_products_quality_advice List Potential Expert Products
List potential expert-selection products or products removed from expert selection.
1688.list_potential_expert_products List Expert Products
List expert-selection products or products facing removal for failing performance criteria.
1688.list_expert_products Get Fulfillment Data
Get the user's fulfillment data.
1688.get_fulfillment_data List Search Order Tags
List order tags available for search filtering.
1688.list_search_order_tags List Display Order Tags
List order tags available for display.
1688.list_display_order_tags List Tdd Orders
List Tao Da Dian orders.
1688.list_tdd_orders Get Tdd Order
Get a Tao Da Dian order.
1688.get_tdd_order List Tdd Shipping Addresses
List Tao Da Dian seller shipping addresses.
1688.list_tdd_shipping_addresses Get Tdd Logistics Trace
Get Tao Da Dian logistics tracking by order ID.
1688.get_tdd_logistics_trace List Tdd Carriers
List Tao Da Dian carriers.
1688.list_tdd_carriers Ship Tdd Order
Ship a Tao Da Dian order using seller-arranged logistics.
1688.ship_tdd_order List Waybill Templates
List electronic waybill print templates.
1688.list_waybill_templates Get Waybill Subscriptions
Query electronic waybill service subscriptions.
1688.get_waybill_subscriptions Create Waybill
Allocate a Cainiao electronic waybill number and print data.
1688.create_waybill Update Waybill
Update an electronic waybill.
1688.update_waybill Cancel Waybill
Cancel a Cainiao electronic waybill.
1688.cancel_waybill Get Waybills
Query waybill details by waybill numbers.
1688.get_waybills Get Order Waybills
Query waybill details by order identifiers.
1688.get_order_waybills Update Supply Stock
Update SKU stock for a supply product.
1688.update_supply_stock List Supply Products
List supply products by product, audit, bidding and supply-status filters.
1688.list_supply_products Create Ae Pickup Order
Create an AliExpress JIT pickup order for the specified trade orders.
1688.create_ae_pickup_order Get Ae Order Addresses
Get shipping and receiving addresses for an AliExpress JIT order.
1688.get_ae_order_addresses List Ae Shipping Addresses
List seller shipping addresses for AliExpress JIT.
1688.list_ae_shipping_addresses Cancel Ae Pickup Order
Cancel an AliExpress JIT pickup order.
1688.cancel_ae_pickup_order Check Ae Shipping Addresses
Check whether AliExpress JIT orders share the same shipping address.
1688.check_ae_shipping_addresses Get Ae Pickup Orders
Get pickup information for AliExpress JIT orders.
1688.get_ae_pickup_orders Print Ae Pickup Labels
Get pickup-order, carton or product label print data for AliExpress JIT.
1688.print_ae_pickup_labels No matching tools.
Frequently Asked Questions
Why is an operation unavailable?
1688 controls API access by application approval, account role and service subscription. Authorizing an account does not enable every API.
Does creating an order complete payment?
Order creation and payment are separate. Payment links open the 1688 checkout for the user to complete payment.