Qeasy Cloud
Get Started
POSThttp://api.guanyierp.com/rest/erp_open (method=gy.erp.trade.get)appkey + sessionkey + MD5 签名

Trade Query (gy.erp.trade.get)

管易云订单查询接口,按时间窗口与店铺、单据状态分页拉取订单头与明细,是订单出数到 ERP/财务对账的标准入口。

## Overview gy.erp.trade.get pages through orders inside GuanYi C-ERP, returning headers, item lines, amounts and statuses. GuanYi also ships gy.erp.trade.history.get (archived orders) and gy.erp.trade.detail.get (per-order detail) — the three together cover full order extraction. ### Request essentials 1. Build appkey/sessionkey/method/sign per the call convention and submit business parameters in the same JSON body. 2. Pagination: page_no (1-based) and page_size; the total field gives the full count under current conditions for paging. 3. Common filters: start_date/end_date (confirm whether the window means created or modified), shop_code, order_state and code for pinpoint lookup. 4. Line items live in the order's details array: item_code, sku_code, qty, price, amount. ### Integration scenarios - Orders → ERP sales orders: GuanYi as the order hub pushes into Kingdee/Yonyou sales orders and receivables. - Reconciliation: three-way match of paid amount, freight and discount against marketplace statements. - After-sales: returns flow through gy.erp.trade.return.get separately and join to the original order number. ### Idempotency Qeasy keys on order code + line sequence, so re-pulls and replays never create duplicate downstream documents. ### Backfilling archived orders Older orders are archived and invisible to gy.erp.trade.get — use gy.erp.trade.history.get for that range. On a first-time full backfill, run the history API before switching to incremental so the timeline has no gaps. The archived API mirrors the online field structure but responds more slowly, so keep backfill concurrency low and checkpoint progress for resumability.

Code examples

curl
curl -X POST "http://api.guanyierp.com/rest/erp_open" \
  -H "Content-Type: application/json; charset=UTF-8" \
  -d '{"appkey":"AK","sessionkey":"SK","method":"gy.erp.trade.get","page_no":1,"page_size":100,"start_date":"2026-06-01 00:00:00","end_date":"2026-06-01 01:00:00","sign":"SIGN"}'

Error codes

CodeMessageMeaning
Base Param error / ErrorSessionKey基本参数错误sessionkey 失效,重新授权
Sign error签名错误重算 sign