Amazon Store Management (ERPNext)

Enterprise Amazon connector for ERPNext - products, orders, customers, inventory with honest sync reporting

Enterprise Amazon connector for ERPNext by ECOSIRE — products, orders, customers, inventory with honest sync reporting.

Status

Implemented and grounded on platform-api-intelligence/platforms/amazon/contract.json (SP-API, verified 2026-04-17). NO fabricated endpoints.

Authentication

Login with Amazon (LWA). The stored refresh token + LWA client id/secret are exchanged at https://api.amazon.com/auth/o2/token (grant_type=refresh_token) for a short-lived access token, sent on every call as x-amz-access-token.

The contract declares auth.type = "oauth2_lwa_sigv4". Modern SP-API authorizes most calls with the LWA token alone; AWS SigV4 request signing is intentionally NOT shipped as a fabricated signer — it is a clearly-marked extension point (AmazonClient._maybe_sign, SIGV4_TODO) to be implemented if a seller account returns a signature error.

Endpoints used (all present in the contract)

| Op | Method + path | Category | |----|---------------|----------| | Connection test | GET /sellers/v1/marketplaceParticipations | seller_performance | | Products / inventory read | GET /fba/inventory/v1/summaries (nextToken) | inventory_stock | | Orders | GET /orders/v0/orders (CreatedAfter, MarketplaceIds, NextToken) | orders | | Order lines | GET /orders/v0/orders/{orderId}/orderItems (NextToken) | orders | | Inventory write | PATCH /listings/2021-08-01/items/{sellerId}/{sku} (fulfillment_availability) | products_catalog |

Limitations (honest, by design)

- Pricing: FBA inventory summaries carry no price; SP-API price is behind the rate-limited Pricing API (out of pilot scope). Items are created with standard_rate = 0 and a documented note — never an invented price. - Buyer PII: name/email/address (.../buyerInfo, .../address) are RDT-restricted and createRestrictedDataToken is not in scope. Customers are derived from the non-PII order (BuyerInfo.BuyerEmail when permitted, else a per-order guest keyed on AmazonOrderId). - FBA inventory is read-only — quantity writes go through the Listings Items PATCH path (FBM / fulfillment_availability), which requires seller_id. - Orders with a foreign currency, an unmapped SellerSKU, or a line missing a SellerSKU are skipped with a reason (honest envelope), never partial.

Requirements

• ERPNext v15 or v16 (Frappe Framework)
• ECOSIRE Connect (ecosire_connect) — included foundation app
• ECOSIRE License Client (ecosire_license_client) — included foundation app