Files

91 lines
3.3 KiB
Markdown

---
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)