---
name: tongtool-workflows
description: "Tongtool (通途) ERP automation: login, CAPTCHA handling, TEMU shipping calculation, order remarking, and Y2 cheapest price scraping."
version: 1.0.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [tongtool, erp, temu, shipping, cross-border, automation, drissionpage]
    related_skills: [drissionpage-auto-login]
---

# Tongtool (通途) ERP Workflows

Automation workflows for Tongtool ERP — login, CAPTCHA solving, TEMU semi-managed order processing, shipping calculation, and order remarking.

## Workflow Overview

| Workflow | Purpose | Automation Tool |
|----------|---------|-----------------|
| **ERP Login** | Automated login with CAPTCHA solving | DrissionPage + ddddocr |
| **TEMU Shipping Calc** | Batch calculate lowest shipping for TEMU orders | Playwright + UI |
| **Y2 Cheapest Price** | Scrape TEMU Y2 lowest price, add remarks | DrissionPage |
| **Order Remark** | Add specific remark to an order | DrissionPage |

## Section 1: ERP Login & Navigation

Automated login to Tongtool with CAPTCHA solving via ddddocr. Navigates tabs, handles iframes and popups.

**When to use:** Starting any Tongtool workflow that requires authentication.

**Key patterns:**
- DrissionPage ChromiumPage for browser control
- ddddocr for image CAPTCHA recognition
- iframe navigation for embedded content
- Tab switching via `ele.click()` + waiting

**See:** `references/tongtool-erp-automation.md` for full login flow, CAPTCHA retry, and navigation patterns.

## Section 2: TEMU Shipping Calculation

Batch process TEMU semi-managed orders — filter pre-print orders, calculate cheapest shipping price via 仓储物流 → 邮寄方式解析 → TEMU平台接口试算, and write remarks.

**When to use:** Processing TEMU semi-managed orders to find cheapest shipping option.

**Key patterns:**
- Playwright for UI automation
- Filter orders without existing remarks
- Iterate through order list
- Parse shipping price from试算 results
- Write price remark (or error remark on failure)
- Support scheduled looping for continuous processing

**See:** `references/tongtool-temu-shipping-calc.md` for full workflow.

## Section 3: Y2 Cheapest Price Scraping

Login to Tongtool, filter products, scrape TEMU Y2 cheapest price data, and add order remarks.

**When to use:** Need to collect TEMU lowest prices from Tongtool and sync order remarks.

**Key patterns:**
- DrissionPage for navigation
- Product filtering and iteration
- Price extraction from TEMU data
- Batch remark writing

**See:** `references/tongtool-temu-y2-cheapest-scraper.md` for full workflow.

## Section 4: Single Order Remark

Log into Tongtool, search for a specific order by ID, and add a remark.

**When to use:** Adding a specific remark to a single known order.

**Key patterns:**
- Search by order ID
- Navigate to order detail
- Add text remark
- Verify remark saved

**See:** `references/tongtool-order-remark.md` for step-by-step.

## Common Pitfalls

1. **CAPTCHA failure** — retry up to 3 times before giving up; ddddocr accuracy varies
2. **iframe loading** — always wait for iframe content before interacting
3. **Tab switching** — use explicit waits after clicks
4. **Session timeout** — re-login if page shows login form unexpectedly
5. **Printed/shipped orders** — skip these in batch processing (check order status first)