Mattsson
6ea92f3152
Community PR #2416 by @olofpinzke, adopted and finished by maintainers (rebased so every commit is signed). Why the problem occurred: no Zettle integration; POS sales only reached the books as bank descriptors while Woo/Shopify already had order underlag via webshop_orders. The contributor's version also failed at the database (platform CHECKs listed only woocommerce/shopify), which the mocked unit tests never saw. What was simplified: reused the Orders/book/invoice path instead of a new inbox; Finance API payouts/fees deferred. Sales the one-account, revenue-per-rate model cannot book (split tender, gift cards, tips) import unbookable with a "bokför manuellt" title instead of guessing accounts. Reset parity uses the rename-and-wrap pattern instead of re-issuing the reset body. Why this solution: per-purchase rows give the radunderlag BFL verifikat need and the bulk-book path exists; daily kassarapport aggregation and Finance API fees/payouts are the follow-up (DECISIONS.md). Skeptic-refuted paths fixed before merge: concurrent refresh-token rotation (sync claim), cron offset paging (candidate snapshot), platform CHECKs, writer-role gate, migration-reset parity, white-label return origin re-validated at callback, VAT net from product rows. Not live until ZETTLE_CLIENT_ID / ZETTLE_CLIENT_SECRET / ZETTLE_CREDENTIALS_ENCRYPTION_KEY are set on Vercel and a Zettle developer app is registered with the callback redirect URI. Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WtYqzKPoTSRHskYYdf7MwB
73 lines
2.4 KiB
TypeScript
73 lines
2.4 KiB
TypeScript
/**
|
|
* The Zettle settings panel's server calls, each classified into exactly one
|
|
* outcome. Same doctrine as the Shopify/Stripe panels' settings-actions.
|
|
*/
|
|
|
|
import {
|
|
panelRequest,
|
|
type PanelRequestOptions,
|
|
type PanelRequestResult,
|
|
} from '@/lib/browser/panel-request'
|
|
|
|
export const ZETTLE_ACTION_TIMEOUT_MS = 15_000
|
|
export const ZETTLE_CONNECT_TIMEOUT_MS = 30_000
|
|
export const ZETTLE_SYNC_TIMEOUT_MS = 310_000
|
|
|
|
export type ZettleRequestResult<T> = PanelRequestResult<T>
|
|
export type ZettleRequestOptions = PanelRequestOptions
|
|
|
|
export { serverErrorMessage } from '@/lib/browser/panel-request'
|
|
|
|
export function zettleRequest<T>(options: ZettleRequestOptions): Promise<ZettleRequestResult<T>> {
|
|
return panelRequest<T>({ timeoutMs: ZETTLE_ACTION_TIMEOUT_MS, ...options })
|
|
}
|
|
|
|
export interface ZettleSyncPayload {
|
|
success?: boolean
|
|
transactions?: {
|
|
fetched?: number
|
|
refundsFetched?: number
|
|
inserted?: number
|
|
updated?: number
|
|
unchanged?: number
|
|
errors?: number
|
|
revoked?: boolean
|
|
deadlineReached?: boolean
|
|
needsReview?: number
|
|
} | null
|
|
}
|
|
|
|
type SyncCounts = {
|
|
fetched: number
|
|
imported: number
|
|
/** Sales imported unbookable (split tender, gift card, tip); see order-sync. */
|
|
needsReview: number
|
|
}
|
|
|
|
export type ZettleSyncOutcome =
|
|
| { reason: 'revoked' }
|
|
| { reason: 'empty' }
|
|
| { reason: 'partial'; values: SyncCounts & { errors: number } }
|
|
| { reason: 'errors'; values: SyncCounts & { errors: number } }
|
|
| { reason: 'feed'; values: SyncCounts }
|
|
| { reason: 'unknown' }
|
|
|
|
export function syncSummary(payload: ZettleSyncPayload | null): ZettleSyncOutcome {
|
|
const summary = payload?.transactions
|
|
if (!summary) return { reason: 'unknown' }
|
|
if (summary.revoked === true) return { reason: 'revoked' }
|
|
if (typeof summary.fetched !== 'number') return { reason: 'unknown' }
|
|
|
|
const fetched = summary.fetched
|
|
const imported = typeof summary.inserted === 'number' ? summary.inserted : 0
|
|
const errors = typeof summary.errors === 'number' ? summary.errors : 0
|
|
const needsReview = typeof summary.needsReview === 'number' ? summary.needsReview : 0
|
|
|
|
if (summary.deadlineReached === true) {
|
|
return { reason: 'partial', values: { fetched, imported, needsReview, errors } }
|
|
}
|
|
if (fetched === 0) return { reason: 'empty' }
|
|
if (errors > 0) return { reason: 'errors', values: { fetched, imported, needsReview, errors } }
|
|
return { reason: 'feed', values: { fetched, imported, needsReview } }
|
|
}
|