@comchatx/cx-amazon-claims-playbook 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,9 +6,6 @@ Some things you can ask:
6
6
  - Does Amazon pay for units lost in its warehouse without a claim?
7
7
  - Can filing many claims put my account at risk?
8
8
 
9
- To read stock states and money lines in depth, also install [Amazon Stock Playbook](https://www.npmjs.com/package/@comchatx/cx-amazon-stock-playbook) and [Amazon Finance Playbook](https://www.npmjs.com/package/@comchatx/cx-amazon-finance-playbook).
10
-
11
9
  ## What it uses
12
10
 
13
- - **Amazon SP-API:** your Amazon selling account, connected on the Amazon SP-API plugin. cx reads your inventory ledger, reimbursements, returns, removals, shipments and fees there.
14
- - **Amazon Seller Profile:** tells cx you sell on Amazon.
11
+ - **Your Amazon seller account:** cx reads your inventory ledger, reimbursements, returns, removals, shipments and fees there.
package/README.zh-CN.md CHANGED
@@ -6,9 +6,6 @@ cx 读你的亚马逊报告,核对亚马逊可能该赔你的货和钱:仓
6
6
  - 仓库里丢的货,亚马逊会自己赔吗?
7
7
  - 索赔提得多,会不会影响店铺?
8
8
 
9
- 如果想深入看库存状态和资金明细,再装上[亚马逊库存分析手册](https://www.npmjs.com/package/@comchatx/cx-amazon-stock-playbook)和[亚马逊财务分析手册](https://www.npmjs.com/package/@comchatx/cx-amazon-finance-playbook)。
10
-
11
9
  ## 用到的数据
12
10
 
13
- - **Amazon SP-API**:你的亚马逊卖家账户,在 Amazon SP-API 插件里连接。cx 在这里读取库存流水、赔偿、退货、移除、货件和费用。
14
- - **Amazon Seller Profile**:告诉 cx 你在亚马逊开店。
11
+ - **你的亚马逊卖家账户**:cx 在这里读取库存流水、赔偿、退货、移除、货件和费用。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@comchatx/cx-amazon-claims-playbook",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "Checks what Amazon may owe you, and says where to claim.",
5
5
  "license": "MIT",
6
6
  "author": "ComChatX",
@@ -43,16 +43,16 @@
43
43
  "claims-audit": {
44
44
  "zh": "查一遍亚马逊可能该赔的货和钱,以及各自去哪索赔。"
45
45
  },
46
- "inbound-shortfall": {
46
+ "shipment-claims": {
47
47
  "zh": "查最近几批入库有没有少收,差多少、要什么证据。"
48
48
  },
49
- "returns-check": {
49
+ "return-claims": {
50
50
  "zh": "找出退款了但没退回、或退回不对的订单。"
51
51
  },
52
- "fee-check": {
52
+ "fee-claims": {
53
53
  "zh": "查 FBA 费用有没有按错尺寸、重量或类目收。"
54
54
  },
55
- "reimbursement-value": {
55
+ "claim-value": {
56
56
  "zh": "看亚马逊的赔偿按什么价算、有没有被撤回的。"
57
57
  }
58
58
  },
@@ -63,15 +63,27 @@
63
63
  },
64
64
  {
65
65
  "on": "cx-amazon-seller",
66
- "need": "required"
66
+ "need": "optional",
67
+ "why": {
68
+ "en": "Tells cx from the start that you sell on Amazon.",
69
+ "zh": "用于让 cx 从第一条消息起就知道你在亚马逊开店。"
70
+ }
67
71
  },
68
72
  {
69
73
  "on": "@comchatx/cx-amazon-stock-playbook",
70
- "need": "optional"
74
+ "need": "optional",
75
+ "why": {
76
+ "en": "Shows stock costs and when to restock.",
77
+ "zh": "用于看清库存压着要花多少钱、什么时候该补货。"
78
+ }
71
79
  },
72
80
  {
73
81
  "on": "@comchatx/cx-amazon-finance-playbook",
74
- "need": "optional"
82
+ "need": "optional",
83
+ "why": {
84
+ "en": "Works out what each product earns after fees.",
85
+ "zh": "用于算出每个商品扣掉费用后赚了多少。"
86
+ }
75
87
  }
76
88
  ]
77
89
  },
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: claim-filing
3
- description: "How an Amazon FBA reimbursement claim or Seller Central case is filed and followed up, and what cx can and cannot read or do in one: each kind's entry point and where its window is stated, one claim per shipment, event or fee charge, evidence formats, proof of ownership and delivery, case states, replying and reopening, the conduct paragraph and deactivations for claim abuse, third-party reimbursement services and Chinese tools (领星, 船长BI), the automated-agent duties and the Agent Policy, the Support API on a restricted role, every claims report with its role, lag and look-back, reads outside the app's roles, how a News post's store is read, and an amount owed as a formula over the seller's own reads. For any question about filing, following up or paying someone to file an FBA claim, whether many claims put an account at risk, or what cx can do about a claim, rather than whether a particular loss, return or fee is owed."
3
+ description: "How an Amazon FBA reimbursement claim or Seller Central case is filed and followed up, and what cx can and cannot read or do in one: each kind's entry point and where its window is stated, one claim per shipment, event or fee charge, evidence formats, proof of ownership and delivery, case states, replying and reopening, the conduct paragraph and deactivations for claim abuse, third-party reimbursement services and Chinese tools (Lingxing, Captain BI), the automated-agent duties and the Agent Policy, the Support API on a restricted role, every claims report with its role, lag and look-back, reads outside the app's roles, how a News post's store is read, and an amount owed as a formula over the seller's own reads. For any question about filing, following up or paying someone to file an FBA claim, whether many claims put an account at risk, or what cx can do about a claim, rather than whether a particular loss, return or fee is owed."
4
4
  ---
5
5
 
6
6
  ## Where a claim is filed
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: claim-value
3
- description: "How much an Amazon FBA reimbursement is worth, not whether one is owed, and when Amazon takes a paid one back: the basis a reimbursed unit is valued on (sourcing cost since Amazon's 2025-03-31 change, Amazon's estimate where the seller entered none, the reduced estimate for unsellable units, sale price minus fees after an order and on customer-return claims, where Amazon's texts differ), Manage Your Sourcing Cost and its limits and invoices, Chinese invoices (发票) and Japan's 原価の管理, the per-unit cap by store, the valuation dispute and what its window counts from, amount-per-unit in GET_FBA_REIMBURSEMENTS_DATA, units put back instead of cash, cross-border currency, and Reimbursement_Reversal rows and found units. For any question about why a reimbursement looks low, what a lost unit should have paid, a sourcing cost entry, re-evaluating a value, or a reimbursement Amazon reversed."
3
+ description: "How much an Amazon FBA reimbursement is worth, not whether one is owed, and when Amazon takes a paid one back: the basis a reimbursed unit is valued on (sourcing cost since Amazon's 2025-03-31 change, Amazon's estimate where the seller entered none, the reduced estimate for unsellable units, sale price minus fees after an order and on customer-return claims, where Amazon's texts differ), Manage Your Sourcing Cost and its limits and invoices, Chinese invoices (fapiao) and Japan's sourcing-cost page (Genka no Kanri), the per-unit cap by store, the valuation dispute and what its window counts from, amount-per-unit in GET_FBA_REIMBURSEMENTS_DATA, units put back instead of cash, cross-border currency, and Reimbursement_Reversal rows and found units. For any question about why a reimbursement looks low, what a lost unit should have paid, a sourcing cost entry, re-evaluating a value, or a reimbursement Amazon reversed."
4
4
  ---
5
5
 
6
6
  ## What a loss is worth
File without changes
File without changes