nexscope-ai/nexscope-ecommerce-skills / ecommerce-1688-procurement
ecommerce-1688-procurement
VerifiedAssist with authorized 1688 procurement through Nexscope, including OAuth authorization, addresses, SKUs, order previews, confirmed order creation, payment links, order status, logistics, cancellation, receipt confirmation and invoices. Use when users ask to buy on 1688, manage a 1688 order, authorize a buyer account or request an invoice. Use ecommerce-1688-search-by-image for product discovery.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.9 KB |
| manifest.json | config | 941 B |
| references/1688-authorization-reference-en.png | binary | 1.1 MB |
| references/api.md | markdown | 15.5 KB |
| references/workflow.md | markdown | 3.4 KB |
| scripts/_alibaba1688_common.py | script | 21.4 KB |
| scripts/authorize_url.py | script | 124 B |
| scripts/authorized_stores.py | script | 128 B |
| scripts/cancel_order.py | script | 123 B |
| scripts/confirm_receive.py | script | 126 B |
| scripts/create_order.py | script | 123 B |
| scripts/invoice_amount.py | script | 125 B |
| scripts/invoice_apply.py | script | 124 B |
| scripts/logistics.py | script | 121 B |
| scripts/logistics_trace.py | script | 126 B |
| scripts/order_preview.py | script | 124 B |
| scripts/order_status.py | script | 123 B |
| scripts/payment_url.py | script | 122 B |
| scripts/receive_address_list.py | script | 130 B |
| scripts/sku.py | script | 115 B |
references/workflow.md
View on GitHub# Procurement workflow
This is a guide, not an automatically executed sequence. Existing authorized orders may start at the relevant step.
1. **Authorize:** inspect `authorizedStores`; otherwise request `authorizeUrl` with `accountName`. Let the buyer complete browser OAuth and recheck for an active, unexpired store. Remind the buyer to bind Alipay to that same 1688 buyer account on 1688 before previewing or placing an order; an active store does not confirm this binding. Do not infer success from a redirect or expose internal expiry times.
2. **Select goods:** use the separate image-search Skill if needed, then `sku` for a selected offer. Establish the exact specification, selling unit and quantity. Do not interpret quantities measured in metres or watts as individual pieces.
3. **Select address:** call `receiveAddressList`. Present enough masked recipient/address information for selection; do not guess a default.
4. **Preview:** call `orderPreview` with address and cargo items. Display product, specifications, quantity, unit price, goods total, freight, order total, buyer message and warnings. Totals are in cents; item unit prices/amounts are in yuan. Inspect every `previewResults[]` group. On `status=false` or an unknown group status, stop and explain the result; review minimum order quantity, units, SKU and address. If 1688 reports `BUYER_NOT_BIND_ALIPAY`, direct the buyer to bind Alipay on 1688 before another preview.
5. **Create:** summarize the exact preview and obtain separate confirmation in English. Then call `createOrder` with the same business parameters and `confirmCreateOrder: true`. Inspect `orderList[]` and `failedOfferList[]` even when overall `success=false`. Retain every successful child `orderId` for tracking and payment; a top-level `orderId` may be null. Reconcile partial results before considering another confirmed attempt.
6. **Payment:** separately confirm retrieving the payment URL. Call `paymentUrl` with `confirmGetPaymentUrl: true`, then return the link for manual opening. Never pay automatically.
7. **Track:** use `orderStatus`, `logistics` and `logisticsTrace` on request, without continuous polling. Select a returned `logisticsId` when there are multiple shipments; display trace time in Asia/Shanghai.
8. **Cancel:** determine order status first. Only unpaid/pending-payment orders enter cancellation confirmation. Paid or shipped orders require after-sales/refund handling on 1688, and already cancelled orders need no repeat. After separate confirmation, use `cancelOrder` and `confirmCancel: true`; success does not promise a refund.
9. **Receipt:** verify the buyer has received the goods, restate the exact order and consequences, obtain separate confirmation, then call `confirmReceive` with `confirmReceive: true`.
10. **Invoice:** call `invoiceAmount` for the requested completed orders. Match amounts and `retCodes` per order. Keep the amount in cents unchanged; skip ineligible orders. Confirm invoice type, title, taxpayer details and amount, then call `invoiceApply` with `confirmApplyInvoice: true`. Inspect all successful/failed rows; `INVOICE_ALREADY_APPLIED` means already invoiced. A mixed result must not trigger a batch replay. Invoice reversal requires contacting the seller.
If any mutation times out or returns an uncertain result, stop. Query the relevant state and reconcile before any separately approved retry. Neither a successful HTTP response nor a successful platform envelope is proof of business success.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |