feat(webshop-orders): Orders page with per-store, per-payment-method booking (#1525)
* feat(webshop-orders): schema, types and error codes for the orders surface webshop_orders (order/refund rows, financial-freeze trigger, member select/update RLS, no DELETE) + webshop_store_settings (per-store payment method -> account map), source_type 'webshop_order', multi-store index drop, customer_country, and a one-time woo cursor reset so the switch-over backfills and cross-marks existing feed rows. Tables classified in the full-archive export; pg-real coverage for RLS, freeze and CHECK. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(webshop-orders): core service (ingest, booking lines) upsertWebshopOrders: two-phase order/refund upsert with FX enrichment, legacy-feed cross-marking, frozen-row protection and field-wise jsonb comparisons (Postgres does not preserve object key order). Booking-line builder: per-rate VAT split with SIGNED buckets (discounts book as revenue reductions), refund mirroring, 3740 residual, per-store account prefill, and advisory export/EU + OSS warnings. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(webshop-orders): API routes for list, booking, invoicing and mapping Booking is draft -> atomic claim -> commit (conditional link-back closes the concurrent double-book race; a lost claim cancels the voucher-free draft). Legacy-feed guard honors transactions.is_ignored on both the book and create-invoice paths. Invoice conversion reuses buildInvoiceWriteData for an unnumbered draft with dominant-rate fallback and drift-safe unit prices. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(webshop-orders): Orders page, booking/invoice dialogs and gated nav /orders lists per-store orders with status tabs (server-side filters), exception chips and one action per row. Booking dialog prefills from the per-store payment-method mapping with an opt-in remember; invoice dialog converts to a draft kundfaktura. The Order nav item renders only for companies with an active WooCommerce connection or existing order rows (Shopify deliberately excluded until its sync writes webshop_orders). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(woocommerce): switch the order sync to webshop_orders, multi-store The sync maps rich wc/v3 payloads (billing, line/shipping/fee taxes, refund allocations with parent-prorated VAT fallback) and upserts order rows instead of transactions-inbox rows; already-imported feed rows stay bookable and get cross-marked. Multi-store: several active connections per company, per-store panel cards with the account-mapping editor. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(webshop-orders): decision log entries and ratchet baseline Baseline moves DOWN only: naive-ore-round 638 -> 637 via roundOre adoption; hand-rolled invariants stay at 115 (ACCOUNT_NUMBER_RE imported, not inlined). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(webshop-orders): resolve PR #1525 review findings and CI failures Review batch (Superagent, CodeRabbit, Swedish compliance review): - Mutual-exclusion claims: booking guards invoice_id, invoice link-back guards journal_entry_id AND treats zero matched rows as the conflict it is (409 + rollback), closing both TOCTOU races. - Freeze v2 migration (20260812124858): the link columns themselves are protected: invoice links immutable, journal links clearable only while the entry is still a draft (the booking rollback path). - Scraped orgnr no longer auto-written to customers.org_number; rate fallback applies only on single-VAT-bucket orders; refunds get their own WEBSHOP_ORDER_REFUND_NOT_CONVERTIBLE code; VAT advisories outrank the invoice-mode hint in the booking dialog. - Ingest compares every synced field (billing corrections no longer drop as unchanged); sync guards absent refunds arrays; /sync aggregates per-store results; panel disables all cards while a request runs; orders page separates load failure from empty; account field explains itself. CI: regenerated skills/accounted-api; pg tests restructured for transaction-abort/rollback semantics + freeze-link coverage; unresolvable- expression ceiling 375 -> 378 with documented reason (partial-update payloads in ingest, shapes covered by unit tests). Declined: CodeRabbit docstring-coverage advisory (house style: comments only where the code cannot say it). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Mattsson
co-authored by
Claude Fable 5
Claude Fable 5
parent
89cfa82f2f
commit
c35b2547fb
@@ -1690,6 +1690,7 @@ export type JournalEntrySourceType =
|
||||
| 'rot_rut_payout'
|
||||
| 'vat_settlement'
|
||||
| 'stripe_payout'
|
||||
| 'webshop_order'
|
||||
|
||||
// Journal entry status
|
||||
export type JournalEntryStatus = 'draft' | 'posted' | 'reversed' | 'cancelled'
|
||||
@@ -3958,6 +3959,99 @@ export interface IngestResult {
|
||||
shadow_date_drift_candidates?: number
|
||||
}
|
||||
|
||||
// ── Webshop orders (Orders page; synced by the woocommerce/shopify extensions) ──
|
||||
|
||||
export type WebshopPlatform = 'woocommerce' | 'shopify'
|
||||
export type WebshopOrderRowType = 'order' | 'refund'
|
||||
|
||||
/** One VAT rate bucket of an order, in the order's currency. */
|
||||
export interface WebshopVatBreakdownLine {
|
||||
/** Percent as a number (25, 12, 6, 0). */
|
||||
rate: number
|
||||
net: number
|
||||
tax: number
|
||||
}
|
||||
|
||||
/** One order line, in the order's currency. */
|
||||
export interface WebshopOrderLineItem {
|
||||
name: string
|
||||
quantity: number
|
||||
total: number
|
||||
total_tax: number
|
||||
/** Percent; null when the rate could not be resolved from tax_lines. */
|
||||
vat_rate: number | null
|
||||
}
|
||||
|
||||
/** Row shape of public.webshop_orders. */
|
||||
export interface WebshopOrder {
|
||||
id: string
|
||||
company_id: string
|
||||
user_id: string
|
||||
platform: WebshopPlatform
|
||||
/** Normalized store host(+path); the identity frozen into external_id. */
|
||||
store_scope: string
|
||||
store_label: string | null
|
||||
/** Soft pointer to the platform's *_connections row (no FK). */
|
||||
connection_id: string | null
|
||||
row_type: WebshopOrderRowType
|
||||
parent_order_id: string | null
|
||||
/** Frozen feed scheme: woo_{scope}_order_{id} / woo_{scope}_refund_{id}. */
|
||||
external_id: string
|
||||
platform_order_id: string
|
||||
order_number: string
|
||||
/** Raw platform status (pending/processing/completed/refunded/...). */
|
||||
status: string
|
||||
is_paid: boolean
|
||||
order_date: string
|
||||
paid_date: string | null
|
||||
currency: string
|
||||
/** Gross incl. tax and shipping; negative on refund rows. */
|
||||
total: number
|
||||
total_tax: number
|
||||
/** Null until the FX rate resolves; booking is blocked while null. */
|
||||
total_sek: number | null
|
||||
exchange_rate: number | null
|
||||
vat_breakdown: WebshopVatBreakdownLine[]
|
||||
line_items: WebshopOrderLineItem[]
|
||||
customer_name: string | null
|
||||
customer_company: string | null
|
||||
customer_email: string | null
|
||||
/** Best effort; must be user-confirmed before use in legal fields. */
|
||||
customer_orgnr: string | null
|
||||
/** Billing country, ISO 3166-1 alpha-2; drives the export/EU 0%-sale hint. */
|
||||
customer_country: string | null
|
||||
payment_method: string | null
|
||||
payment_method_title: string | null
|
||||
gateway_reference: string | null
|
||||
/** Order rows: informational sum of refunds seen so far. */
|
||||
refunded_total: number
|
||||
journal_entry_id: string | null
|
||||
invoice_id: string | null
|
||||
/** Same money event already imported by the legacy transactions feed. */
|
||||
legacy_transaction_id: string | null
|
||||
/** Financial delta arrived from the store after booking froze this row. */
|
||||
remote_changed_after_freeze: boolean
|
||||
created_at: string
|
||||
updated_at: string
|
||||
}
|
||||
|
||||
/** Per-payment-method booking policy in webshop_store_settings. */
|
||||
export type WebshopPaymentMethodPolicy =
|
||||
| { mode: 'book'; account: string }
|
||||
| { mode: 'invoice' }
|
||||
|
||||
/** Row shape of public.webshop_store_settings. */
|
||||
export interface WebshopStoreSettings {
|
||||
id: string
|
||||
company_id: string
|
||||
user_id: string
|
||||
platform: WebshopPlatform
|
||||
store_scope: string
|
||||
payment_method_account_map: Record<string, WebshopPaymentMethodPolicy>
|
||||
created_at: string
|
||||
updated_at: string
|
||||
}
|
||||
|
||||
// ── Invoice extraction (used by invoice-inbox extension and core utils) ──
|
||||
|
||||
export type ExtractedDocumentKind =
|
||||
|
||||
Reference in New Issue
Block a user