cbs-4px-merchant-cli 0.0.9 → 0.0.12

package/dist/types/index.d.ts

@@ -47,23 +47,43 @@ export interface LabelPrintDTO {
 }
 export interface ShipperConsigneeVO {
     orderId: number;
+    shipperName: string | null;
+    shipperCompany: string | null;
+    shipperAddress1: string | null;
+    shipperAddress2: string | null;
+    shipperPostcode: string | null;
+    shipperTelephone: string | null;
+    shipperMobile: string | null;
+    shipperEmail: string | null;
+    shipperCountry: string | null;
+    shipperCity: string | null;
+    shipperProvince: string | null;
     consigneeName: string | null;
+    consigneeFirstName: string | null;
+    consigneeLastName: string | null;
+    consigneeCompany: string | null;
     consigneeAddress1: string | null;
     consigneeAddress2: string | null;
+    consigneeStreet: string | null;
+    consigneeDoorNo: string | null;
     consigneePostcode: string | null;
     consigneeTelephone: string | null;
     consigneeMobile: string | null;
+    consigneeMail: string | null;
     consigneeCountry: string | null;
     consigneeCity: string | null;
     consigneeProvince: string | null;
-    shipperName: string | null;
-    shipperCountry: string | null;
+    consigneeVatNo: string | null;
 }
 export interface DeclareInvoiceVO {
     orderId: number;
     invoiceId: number;
     ename: string | null;
     cname: string | null;
+    pcs: number | null;
+    unitPrice: number | null;
+    hscode: string | null;
+    weight: number | null;
     totalPrice: number | null;
     currency: string | null;
 }
@@ -77,11 +97,66 @@ export interface BillingFeeItemDetailVO {
     currencyCode: string | null;
     billingSuccessDateStr: string | null;
 }
+/** 单条字段规则（长度/正则/必填等），来自规则库配置 */
+export interface FieldRule {
+    ruleType: string | null;
+    ruleTypeDesc: string | null;
+    ruleValue: string | null;
+}
+/** 某个下单字段的规则集合 */
+export interface OrderFieldRuleItem {
+    field: string | null;
+    /**
+     * 该字段在 order create/edit 的 JSON 里的路径，如 receiver.name、parcel.weight、
+     * declareItems[].qty。后端直接给出，不需要自己从 field 换算（两套命名不是驼峰转换）。
+     * null 表示该字段不能通过建单/改单接口设置。
+     */
+    requestPath: string | null;
+    fieldLabel: string | null;
+    fieldElabel: string | null;
+    required: boolean | null;
+    rules: FieldRule[];
+    placeholder: string[];
+    msg: string | null;
+}
+/**
+ * 跨字段联动约束。无法用「单字段必填」表达，必须单独判断。
+ */
+export interface FieldRuleLinkage {
+    iossOrVatEitherRequired: boolean | null;
+    hscodeRequiredWhenIoss: boolean | null;
+    idOrVatEitherRequired: boolean | null;
+    currencyCustoms: string | null;
+    currencyMustBeConsistent: boolean | null;
+}
+/**
+ * 下单字段规则全量清单。
+ *
+ * 必填性由规则库按 (产品, 目的国, 客户, 单据状态) 配置，不同产品结论不同 —— 这是
+ * 判断字段必填的唯一权威来源，不要在客户端另写一份清单。
+ */
+export interface OrderFieldRulesResp {
+    productCode: string | null;
+    country: string | null;
+    fields: OrderFieldRuleItem[];
+    linkage: FieldRuleLinkage | null;
+    chatReply: string | null;
+}
 export interface OrderDetailResp {
     orderDTO: OrderVO | null;
     shipperConsigneeDTO: ShipperConsigneeVO | null;
     declareList: DeclareInvoiceVO[];
     feeDetailList: BillingFeeItemDetailVO[];
+    batteryType: string | null;
+    iossNo: string | null;
+    orderNote: string | null;
+    customerWeight: number | null;
+    length: number | null;
+    width: number | null;
+    height: number | null;
+    dutyPayMode: string | null;
+    salesPlatform: string | null;
+    pieces: number | null;
     totalFee: string | null;
     weightFee: number | null;
     chatReplay: string | null;
@@ -93,6 +168,12 @@ export interface ProductRecommendRequest {
     postCode?: string;
     isBattery?: string;
     declareValue?: number;
+    /** 包裹长(cm)，体积重计费产品必传 */
+    length?: number;
+    /** 包裹宽(cm) */
+    width?: number;
+    /** 包裹高(cm) */
+    height?: number;
 }
 export interface RecommendProductItem {
     productName: string;
@@ -155,14 +236,23 @@ export interface OrderListRequest {
     statusName?: string;
     customerOrderNo?: string;
     fpxTrackNo?: string;
+    queryDateType?: string;
     queryStartDate?: string;
     queryEndDate?: string;
     productCode?: string;
     destinationCountry?: string;
+    consigneeName?: string;
+    buyerId?: string;
+    isPrint?: string;
+    odaConfirm?: string;
+    interceptStatus?: string;
+    changeNoStatus?: string;
+    isHistory?: string;
     pageNum?: number;
     pageSize?: number;
 }
 export interface OrderSummary {
+    orderId: number | null;
     fpxTrackNo: string | null;
     customerOrderNo: string | null;
     statusName: string | null;
@@ -180,19 +270,36 @@ export interface OrderListResp {
     total: number;
     list: OrderSummary[];
 }
+/** 地址类型：shipper 发件人 / consignee 收件人 / return 退件 / collect 揽收 */
+export type AddressType = 'shipper' | 'consignee' | 'return' | 'collect';
+export interface AddressBookListRequest {
+    addressType?: AddressType;
+    keyword?: string;
+    pageNum?: number;
+    pageSize?: number;
+}
 export interface AddressBookItem {
-    code: string | null;
-    contact: string | null;
-    contactPhone: string | null;
-    emergencyContact: string | null;
+    id: string | null;
+    addressType: string | null;
+    name: string | null;
+    company: string | null;
+    phone: string | null;
+    mobile: string | null;
+    email: string | null;
+    country: string | null;
     province: string | null;
     city: string | null;
-    county: string | null;
+    district: string | null;
     address: string | null;
-    containerStuffingLocation: string | null;
+    postcode: string | null;
+    /** 是否默认地址：Y/N */
+    isDefault: string | null;
 }
 export interface OrderAddressResp {
     list: AddressBookItem[];
+    total: number | null;
+    pageNum: number | null;
+    pageSize: number | null;
 }
 export interface CountryItem {
     code: string;
@@ -851,6 +958,24 @@ export interface PlatformOrderItem {
     createdTime: string | null;
     pushTime: string | null;
 }
+export interface PlatformOrderUpdateResp {
+    updatedIds: string[];
+    failed: {
+        id: string;
+        errMsg: string;
+    }[];
+}
+/**
+ * push 的失败明细（每个未能推送的订单一条）。
+ *
+ * 后端只回失败项：**空数组表示全部推送成功**。已推送的单会以
+ * "订单已推送…不能重复推送" 出现在这里 —— 后端按状态拒绝，防止重复建物流单。
+ */
+export interface PlatformOrderPushFailure {
+    id?: string | null;
+    customerOrderNo?: string | null;
+    errMsg?: string | null;
+}
 export interface PlatformOrderListResp {
     pageNum: number;
     pageSize: number;
@@ -908,11 +1033,39 @@ export interface CheckAuthCodeRequest {
     flowId: string;
     isAgent?: boolean;
 }
+/**
+ * 企业实名认证请求。
+ *
+ * 服务端 `startOrganRealNameAuth` 对除 `certTypeEnum` 外的字段全部做
+ * `requireNotBlank` 校验，缺一个就返回 PARAM_REQUIRED，因此这里大多为必填。
+ * `code`（客户编码）与 `creatorId` 由登录上下文填充，不接受调用方传入。
+ */
 export interface OrganAuthRequest {
     name: string;
     certNumber: string;
-    certType?: number;
-    agentAccountId?: string;
+    /** 企业证件类型：0 营业执照（统一社会信用代码）… 12 未知，服务端必填 */
+    certType: number;
+    /** 由 certType 推导，如 0 → CRED_ORG_USCC */
+    certTypeEnum?: string;
+    /** 0=企业四要素认证、1=组织机构三要素认证 */
+    authType: number;
+    /** 经办人账号 ID，来自 `auth code --agent` 的返回值 */
+    agentAccountId: string;
+    /** 法定代表人姓名 */
+    legalName: string;
+    /** 法定代表人证件号，authType=0（四要素）时服务端必填 */
+    legalCertNumber?: string;
+    /** 法定代表人证件类型：0 身份证，authType=0 时服务端必填 */
+    legalCertType?: number;
+    /** 国家数字编码，中国大陆为 485 */
+    countryCode: string;
+    /** 国家二字码，中国大陆为 CN */
+    alpha2Code: string;
+    country: string;
+    state: string;
+    city: string;
+    county: string;
+    address: string;
 }
 export interface OpenBrandRequest {
     serviceCode: string;
@@ -1017,7 +1170,10 @@ export interface OrderSenderInfo {
     name?: string;
     company?: string;
     phone?: string;
+    mobile?: string;
+    email?: string;
     address?: string;
+    address2?: string;
     country?: string;
     postcode?: string;
     city?: string;
@@ -1028,12 +1184,19 @@ export interface OrderReceiverInfo {
     company?: string;
     phone?: string;
     mobile?: string;
+    firstName?: string;
+    lastName?: string;
     address?: string;
+    address2?: string;
+    street?: string;
+    doorNo?: string;
     city?: string;
     province?: string;
     postcode?: string;
     country?: string;
     email?: string;
+    idCode?: string;
+    vatNo?: string;
 }
 export interface OrderParcelInfo {
     weight?: number;
@@ -1041,6 +1204,15 @@ export interface OrderParcelInfo {
     width?: number;
     height?: number;
     dutyPayMode?: string;
+    batteryType?: string;
+    iossNo?: string;
+    /** EORI 号（欧盟进口商登记号）。后端字段名为 tariffNo */
+    eoriNo?: string;
+    orderNote?: string;
+    salesPlatform?: string;
+    warehouseCode?: string;
+    codPrice?: number;
+    codCurrency?: string;
 }
 export interface OrderDeclareItemInfo {
     ename?: string;
@@ -1050,15 +1222,29 @@ export interface OrderDeclareItemInfo {
     currency?: string;
     weight?: number;
     hsCode?: string;
+    material?: string;
+    uses?: string;
+    url?: string;
+    brand?: string;
 }
-/** `P` = 预报（直接提交），`D` = 草稿（保存不提交）。后端默认 `P`。 */
+/**
+ * `P` = 预报（直接提交），`D` = 草稿（保存不提交）。后端默认 `P`。
+ *
+ * 后端已改用语义化的 `draft` 布尔，`status` 仅作兼容保留。订单 JSON 里两者都接受，
+ * CLI 会统一转成 `draft` 发出。
+ */
 export type OrderWriteStatus = 'P' | 'D';
 export interface CreateOrderRequest {
     productCode: string;
     destinationCountry: string;
     originCountry?: string;
+    /** 保存为草稿。与 status 二选一，同时存在时 draft 优先 */
+    draft?: boolean;
     status?: OrderWriteStatus;
     customerOrderNo?: string;
+    pieces?: number;
+    hasBattery?: string;
+    buyerId?: string;
     sender?: OrderSenderInfo;
     receiver?: OrderReceiverInfo;
     parcel?: OrderParcelInfo;
@@ -1071,7 +1257,8 @@ export interface CreateOrderResp {
     customerOrderNo: string | null;
 }
 export interface EditOrderRequest extends Partial<Omit<CreateOrderRequest, 'status'>> {
-    orderId: number;
+    /** 要编辑的订单单号（4px 物流单号或客户订单号）。后端按单号反查主键。 */
+    orderNo: string;
     status?: OrderWriteStatus;
 }
 export interface EditOrderResp {

package/dist/utils/run-command.d.ts

@@ -21,4 +21,10 @@ export interface RunCommandConfig<TData> {
  * empty branch at all): `consume` owns every output decision.
  */
 export declare function withClient<TData>(globalOptions: GlobalOptions, spinnerText: string, fetch: (client: ApiClient) => Promise<TData>, consume: (data: TData) => void): Promise<void>;
+/**
+ * 参数校验与文件读取发生在 `withClient` 之前，因此不会经过其统一错误
+ * 通道。本包装器确保这类失败仍输出 Agent 可解析的 JSON 错误信封，而不是
+ * 未处理的 Promise rejection。
+ */
+export declare function preflight<T>(fn: () => Promise<T>): Promise<T>;
 export declare function runCommand<TData>(globalOptions: GlobalOptions, config: RunCommandConfig<TData>): Promise<void>;

package/dist/utils/run-command.js

@@ -40,6 +40,19 @@ export async function withClient(globalOptions, spinnerText, fetch, consume) {
         handleError(error);
     }
 }
+/**
+ * 参数校验与文件读取发生在 `withClient` 之前，因此不会经过其统一错误
+ * 通道。本包装器确保这类失败仍输出 Agent 可解析的 JSON 错误信封，而不是
+ * 未处理的 Promise rejection。
+ */
+export async function preflight(fn) {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        handleError(e);
+    }
+}
 export async function runCommand(globalOptions, config) {
     await withClient(globalOptions, config.spinner, (client) => config.exec(client), (data) => {
         if (globalOptions.output === 'json') {

package/dist/utils/run-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/utils/run-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAc3D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAA4B,EAC5B,WAAmB,EACnB,KAA4C,EAC5C,OAA8B;IAE9B,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAA4B,EAC5B,MAA+B;IAE/B,MAAM,UAAU,CACd,aAAa,EACb,MAAM,CAAC,OAAO,EACd,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAC/B,CAAC,IAAI,EAAE,EAAE;QACP,IAAI,aAAa,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/utils/run-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAc3D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAA4B,EAC5B,WAAmB,EACnB,KAA4C,EAC5C,OAA8B;IAE9B,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAA4B,EAC5B,MAA+B;IAE/B,MAAM,UAAU,CACd,aAAa,EACb,MAAM,CAAC,OAAO,EACd,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAC/B,CAAC,IAAI,EAAE,EAAE;QACP,IAAI,aAAa,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbs-4px-merchant-cli",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "description": "Cbs merchant CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,12 @@
     "build:cainiao:test": "SITE=cainiao ENV=test npm run build",
     "build:cainiao:pre": "SITE=cainiao ENV=pre npm run build",
     "package:role-skills": "bash scripts/package-role-skills.sh",
+    "build:binary:4px": "node scripts/build-binary.mjs --site 4px --env prod",
+    "build:binary:cainiao": "node scripts/build-binary.mjs --site cainiao --env prod",
+    "build:binary:host": "node scripts/build-binary.mjs --site 4px --env prod --host",
+    "oss:upload": "node scripts/oss-upload.mjs",
+    "oss:upload:dry": "node scripts/oss-upload.mjs --dry-run",
+    "release:binary": "npm run build:binary:4px && npm run build:binary:cainiao && npm run oss:upload",
     "dev:4px:test": "SITE=4px ENV=test npm run build && node dist/index.js skill install",
     "dev:4px:pre": "SITE=4px ENV=pre npm run build && node dist/index.js skill install",
     "dev:cainiao:test": "SITE=cainiao ENV=test npm run build && node dist/index.js skill install",

package/skill/SKILL.md

@@ -119,7 +119,8 @@ description: >-
 用户提到"计费明细" → `fmc finance fee-detail`
 用户提到"地址簿/地址列表" → `fmc order address-book`
 用户提到"目的国/国家查询/搜索国家" → `fmc order country`
-用户提到"下单/开单/建单/寄一个包裹" → `fmc order create --draft`（**写**，先建草稿让用户核对）
+用户提到"哪些字段必填/要填什么/这个字段怎么填" → `fmc order field-rules --product-code <code> --country <cc>`
+用户提到"下单/开单/建单/寄一个包裹" → 先 `fmc order field-rules --required-only` 查必填，再 `fmc order create --draft`（**写**，先建草稿让用户核对）
 用户提到"改单/修改订单/改地址改重量" → `fmc order edit`（**写**，仅草稿与已取消单可改）
 用户提到"提交预报/发出去/确认发货" → `fmc order forecast`（**写**）
 用户提到"取消订单/不寄了/作废" → `fmc order cancel`（**写**）
@@ -141,11 +142,12 @@ description: >-
 用户提到"验证码/收到短信了" → `fmc onboarding auth code`（**写**）
 用户提到"企业实名/公司认证" → `fmc onboarding auth organ`（**写**）
 用户提到"港澳台/海外客户认证" → `fmc onboarding auth gat`（**写**）
-用户提到"对公打款/打款金额验证" → `fmc onboarding auth remit`（**写**）
+用户提到"对公打款/要不要打款" → 入驻流程已取消对公打款环节（`auth organ` 成功即认证完成），用 `fmc onboarding auth schedule` 佐证后告知"无需打款"
 用户提到"可开通品牌/有哪些品牌" → `fmc onboarding brand list`
 用户提到"开通品牌/申请合同" → `fmc onboarding brand open`（**写**）
+用户提到"重复入驻/账号重复注册/通知销售" → `fmc onboarding notify-saler`（**写**，仅在 `brand open` 报重复入驻时用，勿重复发送）
 用户提到"合同/我的合同" → `fmc onboarding contract list`
-用户提到"签合同/签署链接/下载合同" → `fmc onboarding contract url`
+用户提到"签合同/签署链接/下载合同" → `fmc onboarding contract url`（须带 `--status`，取自 `contract list`）
 用户提到"登录/配置key/认证" → `fmc auth login`
 用户提到"升级/更新/新版本" → `fmc update`
 
@@ -209,8 +211,8 @@ export BPORTAL_API_KEY=sk-xxxxx
 | `platform sync` | 提交拉单任务（异步） |
 | `platform order push` | 订单进入物流履约流程 |
 | `onboarding auth indiv` / `auth code` / `auth organ` / `auth gat` | 提交实名认证资料 |
-| `onboarding auth remit` | 消耗打款校验重试次数 |
 | `onboarding brand open` | 开通品牌并发起合同申请 |
+| `onboarding notify-saler` | 重复入驻时通知对应销售（勿重复发送） |
 
 执行规则：
 
@@ -225,8 +227,8 @@ export BPORTAL_API_KEY=sk-xxxxx
 
 1. `order create --file <json> --draft -y` → 拿到 `orderId`
 2. `order get <orderNo>` 把收件人、重量、申报品念给用户核对
-3. 有错就 `order edit --order-id <id> --file <json> --draft -y` 改，改到对
-4. 用户明确同意后 `order forecast --ids <id> -y` 提交预报
+3. 有错就 `order edit --orderNo <单号> --file <json> --draft -y` 改，改到对
+4. 用户明确同意后 `order forecast --orderNo <单号> -y` 提交预报
 5. `label get <orderNo>` 取面单
 
 只有用户明确说"直接下单/不用确认"时，才允许省掉 `--draft`。
@@ -252,14 +254,14 @@ fmc order list --status IN_TRANSIT
 
 # 下单（写操作）—— 先建草稿，用户核对无误后再预报
 fmc order create --file ./order.json --draft -y
-fmc order forecast --ids 1001 -y
+fmc order forecast --orderNo ORD-20260907-001 -y
 
 # 改草稿（写操作，只传要改的字段）
-fmc order edit --order-id 1001 --file ./patch.json --draft -y
+fmc order edit --orderNo ORD-20260907-001 --file ./patch.json --draft -y
 
 # 取消 / 拦截（写操作）
-fmc order cancel --ids 1001 --reason "客户取消" -y
-fmc order intercept --ids 1001 -y
+fmc order cancel --orderNo 4PX3003136946232CN --reason "客户取消" -y
+fmc order intercept --orderNo 4PX3003136946232CN -y
 
 # 获取推荐产品（寄美国）
 fmc product recommend --country US
@@ -292,9 +294,9 @@ fmc platform sync --seller-account-id 10086 \
 # 查询入驻进度
 fmc onboarding progress
 
-# 查询合同并获取签署链接
+# 查询合同并获取签署链接（--status 必填，取自 contract list）
 fmc onboarding contract list
-fmc onboarding contract url CT20260801001
+fmc onboarding contract url CT20260801001 --status 4
 ```
 
 ---

package/skill/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbs-4px-merchant-cli",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "description": "BPortal Merchant CLI (fmc) skill — BPortal",
   "files": [
     "SKILL.md",

package/skill/reference/auth.md

@@ -4,7 +4,8 @@
 
 | Command | Description |
 | --- | --- |
-| `fmc auth login` | 配置 API Key |
+| `fmc auth login` | 手动配置 API Key |
+| `fmc auth agentz` | 通过已登录的 agentz-cli 获取并配置 API Key（AgentZ / 数字员工环境） |
 | `fmc auth status` | 查看当前认证状态 |
 
 ## Command details
@@ -35,6 +36,24 @@
 fmc auth login --api-key sk-xxxxx
 ```
 
+### `fmc auth agentz`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `auth agentz` |
+| **Description** | 检测本机 `agentz-cli`，调用 `agentz-cli client token` 获取当前 AgentZ 客户端的 accessToken，再生成并保存商家 API Key |
+| **Usage** | `fmc auth agentz` |
+
+仅在已安装并登录 `agentz-cli` 的 AgentZ / 数字员工环境中使用。accessToken 仅在当前进程中用于生成 API Key，不会写入配置、终端输出或日志；成功生成的 API Key 会保存至 `~/.bportal/config.json`，输出仅展示脱敏值。
+
+若本机没有 `agentz-cli`、客户端未登录或生成失败，请改用原有 `fmc auth login --api-key <key>`，或由运行环境注入 `BPORTAL_API_KEY`。不要手动复制或提供 accessToken。
+
+#### Examples
+
+```bash
+fmc auth agentz
+```
+
 ### `fmc auth status`
 
 | Field | Value |

package/skill/reference/index.md

@@ -83,9 +83,9 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `fmc onboarding auth code` | 提交验证码完成实名认证（写） | [onboarding.md](onboarding.md) |
 | `fmc onboarding auth organ` | 发起企业实名认证（写） | [onboarding.md](onboarding.md) |
 | `fmc onboarding auth gat` | 提交港澳台/海外实名资料（写） | [onboarding.md](onboarding.md) |
-| `fmc onboarding auth remit` | 校验对公打款金额（写） | [onboarding.md](onboarding.md) |
 | `fmc onboarding brand list` | 查询可开通品牌 | [onboarding.md](onboarding.md) |
 | `fmc onboarding brand open` | 开通品牌并申请合同（写） | [onboarding.md](onboarding.md) |
+| `fmc onboarding notify-saler` | 重复入驻时通知对应销售（写） | [onboarding.md](onboarding.md) |
 | `fmc onboarding contract list` | 查询合同列表 | [onboarding.md](onboarding.md) |
 | `fmc onboarding contract url` | 获取合同签署/下载链接 | [onboarding.md](onboarding.md) |
 | `fmc update` | 升级 CLI 及对应 skill 到最新版本 | [update.md](update.md) |
@@ -111,7 +111,7 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `notice` | `list`, `detail`, `message list`, `message detail`, `message unread` | [notice.md](notice.md) |
 | `customs` | `cargo list`, `commodity list`, `commodity detail`, `hscode search`, `registration info` | [customs.md](customs.md) |
 | `platform` | `account list`, `sync`, `sync-record list`, `order list`, `order detail`, `order push` | [platform.md](platform.md) |
-| `onboarding` | `progress`, `customer-type`, `auth schedule`, `auth indiv`, `auth code`, `auth organ`, `auth gat`, `auth remit`, `brand list`, `brand open`, `contract list`, `contract url` | [onboarding.md](onboarding.md) |
+| `onboarding` | `progress`, `customer-type`, `auth schedule`, `auth indiv`, `auth code`, `auth organ`, `auth gat`, `brand list`, `brand open`, `notify-saler`, `contract list`, `contract url` | [onboarding.md](onboarding.md) |
 | `update` | (no subcommand) | [update.md](update.md) |
 | `skill` | `install`, `status`, `uninstall` | [update.md](update.md) |
 
@@ -130,7 +130,7 @@ Command **details** are in sibling `<group>.md` files in this directory.
 - `track get` 命令无需认证即可使用。
 - 其余大部分命令需要先配置 API Key：`fmc auth login --api-key <key>`。Key 是控制台生成的原串（常见前缀 `SK_` 或 `sk-`），原样传入，不要校验或改写。
 - 新增的 `problem`、`service`、`finance`、`pickup`、`notice`、`customs`、`platform`、`onboarding` 模块均需要 API Key 认证。`order` 模块下的 `address-book`、`country` 子命令也需要认证。
-- **写操作**（`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open`）默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则命令会拒绝执行并以退出码 1 结束。先用 `--dry-run` 可查看将发送的请求。
+- **写操作**（`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open`、`onboarding notify-saler`）默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则命令会拒绝执行并以退出码 1 结束。先用 `--dry-run` 可查看将发送的请求。
 - 实名认证会提交身份证号、银行卡号、验证码、手机号等敏感信息。这些参数在 `--verbose` / `--dry-run` 的**打印**里被遮蔽为 `****`，但真实值仍会随请求发送。
 - 配置文件位于 `~/.bportal/config.json`；升级状态缓存位于 `~/.bportal/update-state.json`。
 - 当检测到新版本可用时，stderr 会输出 `{"_notice":{"type":"update",...}}`；设置环境变量 `BPORTAL_NO_UPDATE_NOTIFIER=1` 可关闭。