Jushuitan ERP

Jushuitan ERP

Operate Jushuitan ERP through your OOMOL-connected account. This skill calls the jushuitan connector with the oo CLI; OOMOL injects credentials server-side, so you never handle raw tokens.

Running an action

Assume the user has already installed the oo CLI, signed in, and connected Jushuitan ERP. Do not run oo auth login or open the connection URL proactively — just run the action. Fall back to First-time setup only when a command actually fails with an auth or connection error.

1. Inspect the contract to get the authoritative input/output schema before building a payload:

oo connector schema "jushuitan" --action ""

2. Run the action with a JSON payload that matches the input schema:

oo connector run "jushuitan" --action "" --data '' --json

• --data takes a JSON object string or @path/to/file.json; omit it to send {}.
• The response is { "data": ..., "meta": { "executionId": "..." } }; the execution id lives under meta.executionId.

Each action is listed below with a one-line description; actions that change state carry a [write] or [destructive] tag. Before constructing --data, fetch the action's live schema with oo connector schema to get its authoritative input fields.

Jushuitan request conventions

Actions follow the current OpenWeb business schemas. Endpoints whose official biz root is an array accept that array in the action's items field; the connector restores the root-array payload before signing and sending it. List actions return one upstream page and expose the endpoint's documented page, time-window, or incremental cursor fields instead of silently fetching every page.

The standard order, outbound, after-sale, and logistics actions only expose data available through Jushuitan OpenWeb. Taobao data that requires Qimen, Pinduoduo data that requires Fangzhou, and platform-restricted recipient fields are not emulated by these actions.

Available actions

• add_package_serial_numbers — Add unique package serial numbers in batches. [write]
• add_product_serial_numbers — Add unique product serial numbers in batches. [write]
• adjust_inventory_by_count — Adjust product inventory through an inventory count operation.
• append_wms_workload — Append a WMS workload record.
• assign_order_shipping_warehouse — Assign a shipping warehouse to an order. [write]
• assign_wave_to_robot — Assign a picking wave to a specified warehouse robot. [write]
• batch_off_shelf_products — Move products off warehouse shelves in batches.
• batch_shelve_products — Place products onto warehouse shelves in batches.
• bind_seeding_bin_to_cart — Bind a seeding cabinet identifier to a seeding cart.
• bind_seeding_cart — Bind a seeding cart to a warehouse picking or seeding workflow.
• cancel_allocation — Cancel an inventory allocation document. [write]
• cancel_cost_upload_batch — Cancel a profitability data upload batch. [write]
• cancel_order_by_internal_id — Cancel an order by its Jushuitan internal order number. [write]
• cancel_purchase_receipt — Cancel a purchase receipt document. [write]
• cancel_purchase_return — Cancel a purchase return outbound document. [write]
• check_seeding_cart_availability — Check whether a seeding cart is currently available for use.
• complete_seeding_with_stock_out — Submit seeding results and complete the associated stock-out operation. [write]
• complete_seeding_without_stock_out — Submit seeding results without completing a stock-out operation. [write]
• confirm_after_sale — Confirm an after-sale document. [write]
• confirm_after_sale_goods_received — Confirm receipt of after-sale goods, including partial confirmations. [write]
• confirm_after_sale_receipt_by_serial_numbers — Confirm after-sale goods receipt in batches by product serial number. [write]
• confirm_allocation — Confirm an inventory allocation document. [write]
• create_allocation_difference — Create an allocation difference document. [write]
• create_cost_upload_batch — Create a batch identifier for profitability data uploads. [write]
• create_cross_border_first_leg — Create a first-leg cross-border logistics document. [write]
• create_cross_warehouse_allocation — Create a cross-warehouse inventory allocation. [write]
• create_intra_warehouse_allocation — Create an inventory allocation within a warehouse. [write]
• create_other_stock_movement — Create a miscellaneous inbound or outbound stock document. [write]
• create_production_batch — Create a production batch management record. [write]
• create_purchase_receipts — Create purchase receipt documents in batches. [write]
• create_purchase_returns — Create purchase return documents in batches. [write]
• create_virtual_warehouse_allocation — Create a virtual-warehouse inventory allocation document. [write]
• create_virtual_warehouse_operation — Create a virtual-warehouse allocation or return document. [write]
• force_confirm_and_stock_in_shortage_order — Force-confirm a single-item shortage order and receive it into inventory. [write]
• force_confirm_shortage_order_for_shipping — Force-confirm single-item shortage orders for shipment. [write]
• generate_fast_moving_labels — Generate unique labels for fast-moving products.
• get_allocation_first_leg_fee — Get first-leg logistics fees for an allocation document.
• get_cost_upload_batch_status — Get status information for a profitability data upload batch. [write]
• get_fast_delivery_order_count — Get the number of orders eligible for expedited shipment. [write]
• get_fast_moving_serial_number — Get unique serial-number information for a fast-moving product.
• get_product_by_sku — Get ordinary product details by SKU code.
• get_product_historical_cost — Get the historical cost price for a product at the requested point in time.
• get_recommended_bin_by_package — Get recommended warehouse bins for products in a specified package.
• get_recommended_product_bin — Get recommended warehouse bins for a product.
• get_returned_warehouse_package — Get return-to-warehouse information for a delivery package.
• get_robot_picking_wave — Get a picking wave available to a warehouse robot.
• get_seeding_wave — Get seeding wave information, including supported third-party warehouse data.
• get_serial_number_trace — Get tracking history for a unique product serial number.
• list_after_sale_receipts — List actual warehouse receipts for sales returns.
• list_after_sales — List after-sale return and refund records visible through OpenWeb.
• list_allocations — List inventory allocation documents.
• list_bundle_products — List bundle products and their component product definitions.
• list_company_users — List users belonging to the authorized Jushuitan merchant company.
• list_cost_upload_batch_errors — List rejected or invalid records from a profitability data upload batch. [write]
• list_cross_border_after_sales — List cross-border after-sale documents.
• list_cross_border_logistics_channels — List cross-border logistics providers and channels enabled for the merchant.
• list_cross_border_orders — List cross-border orders.
• list_drp_distributors — List distributors linked to the merchant in the Jushuitan distribution network.
• list_drp_suppliers — List suppliers linked to the merchant in the Jushuitan distribution network.
• list_express_registrations — List registered express shipment records.
• list_finance_projects — List finance expense projects configured for the merchant.
• list_inventory — List product inventory by warehouse and product filters.
• list_inventory_counts — List inventory count documents and their recorded quantities.
• list_logistics_companies — List logistics companies and carrier codes available to the merchant.
• list_manufacturing_orders — List manufacturing orders and their details.
• list_operating_expenses — List operating expense records from the Jushuitan finance module.
• list_orders — List orders visible through the standard Jushuitan OpenWeb channel.
• list_other_stock_movements — List miscellaneous inbound and outbound stock documents.
• list_package_bin_inventory — List inventory contained in packages and warehouse bins.
• list_payables — List payable documents from the Jushuitan finance module.
• list_payments — List payment documents from the Jushuitan finance module.
• list_picking_waves — List picking waves matching the requested filters.
• list_product_boms — List product bills of materials and their component relationships.
• list_product_categories — List product categories configured for the merchant.
• list_product_customs_declarations — List customs declaration information for products.
• list_product_historical_costs — List paginated historical cost-price records for products.
• list_product_models — List ordinary products grouped and filtered by product model.
• list_product_restore_history — List product operation history used to recover product data.
• list_product_suppliers — List supplier relationships configured for products.
• list_profit_statement_items — List available profit-statement cost and revenue items.
• list_purchase_bookings — List scheduled purchase receiving bookings.
• list_purchase_orders — List purchase orders and their line items.
• list_purchase_receipts — List purchase receipt documents and their line items.
• list_purchase_requests — List purchase requests across virtual and physical warehouses.
• list_purchase_returns — List purchase return outbound documents.
• list_sales_outbounds — List sales outbound documents visible through OpenWeb.
• list_serial_number_stock_movements — List inbound and outbound movements for unique product serial numbers.
• list_shipments — List shipment and logistics information visible through OpenWeb.
• list_shop_products — List shop product records and their mappings to Jushuitan products.
• list_shops — List shops available to the authorized Jushuitan merchant account.
• list_suppliers — List supplier master records.
• list_virtual_warehouse_allocations — List virtual-warehouse allocation documents with pagination.
• list_virtual_warehouse_inventory — List product inventory held in virtual warehouses.
• list_virtual_warehouse_operations — List virtual-warehouse allocation and return documents with pagination.
• list_virtual_warehouses — List virtual warehouses available to the merchant.
• list_warehouses — List warehouses available to the authorized merchant account.
• list_wms_stock_movements — List WMS inbound and outbound stock movement records.
• list_wms_work_logs — List WMS work logs for authorized warehouses.
• mark_orders_exception — Move orders into the exception-order workflow. [write]
• mark_orders_shipped — Mark orders as shipped and submit their shipment details. [write]
• pack_shipment — Record packing details for a shipment.
• recalculate_wave_inventory_reservation — Recalculate inventory reservations for a picking wave.
• record_fast_moving_arrival — Record arrival of fast-moving products in the WMS workflow.
• register_express_shipments — Register express shipment records in batches. [write]
• save_1688_product_mapping — Create or update mappings for products sourced from 1688. [write]
• save_packing_video_record — Save a packing-machine video record for a package or shipment. [write]
• save_product_categories — Create or update product categories in Jushuitan. [write]
• save_product_suppliers — Create or modify supplier relationships for products. [write]
• save_products_batch — Create or update ordinary product records in batches using the current API. [write]
• save_virtual_warehouse_purchase_request — Create or update a virtual-warehouse purchase request. [write]
• set_after_sale_labels — Set labels on after-sale documents. [write]
• ship_sales_outbounds — Complete shipment for sales outbound documents.
• split_order — Split an order into separate fulfillment orders. [write]
• unbind_outbound_from_seeding_cart — Unbind outbound documents from a seeding cart.
• unbind_wave_cart — Unbind a picking or seeding cart from a wave.
• uncancel_orders — Reverse cancellation for eligible orders.
• unconfirm_after_sale — Reverse confirmation of an after-sale document.
• update_cross_border_order_forwarding — Update cross-border forwarding and logistics information for an order. [write]
• update_last_mile_shipping_fee — Write back the last-mile shipping fee for a cross-border shipment. [write]
• update_order_invoice — Update invoice information attached to an order. [write]
• update_order_labels — Add or remove labels on orders. [write]
• update_order_logistics_company — Change the logistics company assigned to an order. [write]
• update_order_offline_note — Update an order note or offline remark by order number. [write]
• update_order_remark_flag — Update an order remark flag and synchronize the change to its platform. [write]
• update_order_seller_remark_by_internal_id — Update an order seller remark using the Jushuitan internal order number. [write]
• update_order_seller_remark_by_online_id — Update an order seller remark using its online order number. [write]
• update_other_stock_movement_status — Change the status of a miscellaneous inbound or outbound stock document. [write]
• update_product_bin_capacity — Update warehouse bin-capacity information for products. [write]
• update_product_invoice_profile — Update basic invoicing information for products. [write]
• update_product_mappings — Bind or unbind product mapping relationships. [write]
• update_product_models — Update product model information. [write]
• update_purchase_order — Modify an existing purchase order. [write]
• update_purchase_order_labels — Add or remove labels on purchase and manufacturing orders. [write]
• update_purchase_order_status — Change the business status of a purchase order. [write]
• update_self_store_order_recipient — Update recipient information for an order from a merchant-owned shop. [write]
• update_virtual_inventory — Import or update virtual inventory quantities in batches. [write]
• update_wave_picking_status — Update the picking status of a WMS wave. [write]
• upload_after_sales — Upload after-sale return or refund records. [write]
• upload_bundle_products — Upload bundle product definitions in batches. [write]
• upload_external_purchase_order_costs — Upload cost data for externally purchased orders. [write]
• upload_manufacturing_orders — Upload manufacturing orders to Jushuitan. [write]
• upload_order_expenses — Upload order expense data for profitability accounting. [write]
• upload_orders — Upload orders from merchant-owned shops or offline cross-border channels. [write]
• upload_product_boms — Upload product bill-of-material definitions. [write]
• upload_product_costs — Upload multiple product cost values for profitability accounting. [write]
• upload_product_historical_costs — Upload historical cost-price records for products. [write]
• upload_purchase_bookings — Upload scheduled purchase receiving bookings. [write]
• upload_purchase_orders — Upload purchase orders to Jushuitan. [write]
• upload_shop_products — Upload product records for a merchant-owned online shop. [write]
• upload_suppliers — Upload supplier master records to Jushuitan. [write]
• upload_unidentified_after_sales — Upload after-sale records for returned parcels without matching order information. [write]
• void_after_sale — Void an after-sale document.
• void_purchase_documents — Void purchase orders, manufacturing orders, or receiving bookings.
• weigh_sort_and_ship_orders — Record order weights, sort express parcels, and mark orders as shipped.

Safety

• Untagged actions are reads (get / list / search) — safe to run directly.
• Actions tagged [write] change Jushuitan ERP state — confirm the exact payload and effect with the user before running.
• Actions tagged [destructive] remove or overwrite data — always confirm the target and get explicit approval first.
• Treat actions that upload, overwrite, ship, cancel, confirm, audit, allocate, bind, unbind, shelve, or change business status as high impact. Verify merchant, shop, warehouse, order, SKU, quantities, and current document state before running them.
• Do not assume recipient or other platform-sensitive fields are complete across every e-commerce channel. Standard OpenWeb access does not replace Qimen, Fangzhou, or each marketplace's data-governance requirements.

First-time setup

These are one-time steps — do not repeat them on every call. Run a step only when a command fails for the matching reason.

• oo: command not found — install the oo CLI (other platforms: ):

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• Not signed in / authentication error — sign in to your OOMOL account once:

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Jushuitan ERP is not connected, or the connection expired or lacks a scope. Connect once (auth type: OAuth2) at:

  https://console.oomol.com/app-connections?provider=jushuitan
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — billing stop. Recharge at https://console.oomol.com/billing/token-recharge before retrying.

• Connect with the merchant's primary Jushuitan ERP account. The application App Key and App Secret are platform-managed system OAuth client configuration, not values that merchants paste into an action.

• Connector refreshes expiring service-provider tokens through Jushuitan's official refreshToken endpoint. Reconnect only when Jushuitan rejects both the saved token and its refresh token.

Resources

• Jushuitan ERP homepage: https://www.jushuitan.com/