Files
accounted/components/parties/use-registry-autofill.ts
T
fcda4a75dd feat(parties): fill customer and supplier forms from the register on a valid org number (#2355)
The registry lookup was built for rows that already exist (the detail
page's "Hämta uppgifter" records facts on the row's party), so on the
create form people typed what SCB already knew. Org number now comes
first in both forms; a complete, check-digit valid number of a Swedish
legal person is looked up once and fills name, address, postal code,
city (and the VAT number where the form shows one) wherever nothing has
been typed. A typed value is never replaced; a corrected number replaces
only its own earlier fill. A personnummer never reaches the register
(client key and server gate), and an environment without SCB credentials
answers 503 once and the form stays quiet.

- GET /api/parties/registry?org_number=: read-only route over the same
  SCB client, credential gate and registrySummary reader as the enrich
  route; writes nothing.
- lib/parties/registry-form-fill.ts: registryLookupKey (one rule for
  what may be looked up) and registryFormFill (contactFill's untouched
  rule plus name and VAT number), pure and tested.
- components/parties/use-registry-autofill.ts + RegistryAutofillNote:
  debounced, once per distinct number, skips the number an edit dialog
  opened with, one muted line under the field.
- Adressrad 2 is now an input on both forms: the register's c/o goes on
  line 1 with the street on line 2, as on the row, and both edit dialogs
  already passed the column in.


Claude-Session: https://claude.ai/code/session_01LvMaHcTnwAfxzgYD1fGYX1

Co-authored-by: Jakob Wennberg <311770904+jakobwennberg-oss@users.noreply.github.com>
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-06 21:03:06 +02:00

105 lines
3.7 KiB
TypeScript

'use client'
import { useEffect, useRef, useState } from 'react'
import { registryLookupKey, type RegistryLookup, type RegistryLookupFound } from '@/lib/parties/registry-form-fill'
export type RegistryAutofillState =
| { status: 'idle' }
| { status: 'looking' }
/** A company was found and these form fields were set from it. */
| { status: 'filled'; name: string; fields: string[] }
/** A company was found but every field it knows was already typed. */
| { status: 'found'; name: string }
| { status: 'not_found'; orgNumber: string }
const DEBOUNCE_MS = 400
/**
* Looks a typed org number up in the register once it is complete and
* valid, and hands a found company to `apply`. One lookup per distinct
* number per form (answers are kept, so retyping a number costs nothing),
* none for the number the form opened with (an edit dialog must not fetch
* on open), none for a personnummer, and none at all once the environment
* has said it has no SCB credentials (503). A failed lookup leaves the form
* as it is: no toast, no spinner, the person keeps typing.
*/
export function useRegistryAutofill({
orgNumber,
enabled,
initialOrgNumber,
apply,
}: {
/** The org number field as typed. */
orgNumber: string | null | undefined
/** False while the row is not a Swedish company, or the person cannot write. */
enabled: boolean
/** The value the form opened with: only a change from it triggers a lookup. */
initialOrgNumber?: string | null
/** Sets form fields from a found company; returns the names of the fields it set. */
apply: (now: RegistryLookupFound, before: RegistryLookupFound | null) => string[]
}): RegistryAutofillState {
const [state, setState] = useState<RegistryAutofillState>({ status: 'idle' })
const applyRef = useRef(apply)
useEffect(() => {
applyRef.current = apply
}, [apply])
const answers = useRef(new Map<string, RegistryLookup>())
const unavailable = useRef(false)
const lastApplied = useRef<RegistryLookupFound | null>(null)
const opened = useRef(registryLookupKey(initialOrgNumber))
/** The key the current state describes; null while idle. */
const shown = useRef<string | null>(null)
const key = enabled ? registryLookupKey(orgNumber) : null
useEffect(() => {
if (key === shown.current) return
const quiet = () => {
shown.current = null
setState((s) => (s.status === 'idle' ? s : { status: 'idle' }))
}
if (!key || key === opened.current || unavailable.current) {
quiet()
return
}
const settle = (result: RegistryLookup) => {
shown.current = key
if (!result.found) {
setState({ status: 'not_found', orgNumber: result.orgNumber })
return
}
const fields = applyRef.current(result, lastApplied.current)
lastApplied.current = result
setState(fields.length > 0 ? { status: 'filled', name: result.name, fields } : { status: 'found', name: result.name })
}
const known = answers.current.get(key)
if (known) {
settle(known)
return
}
const ctrl = new AbortController()
const timer = setTimeout(async () => {
setState({ status: 'looking' })
try {
const res = await fetch(`/api/parties/registry?org_number=${encodeURIComponent(key)}`, { signal: ctrl.signal })
if (res.status === 503) unavailable.current = true
const json = res.ok ? ((await res.json()) as { data?: RegistryLookup }) : null
if (!json?.data) {
quiet()
return
}
answers.current.set(key, json.data)
settle(json.data)
} catch {
if (!ctrl.signal.aborted) quiet()
}
}, DEBOUNCE_MS)
return () => {
clearTimeout(timer)
ctrl.abort()
}
}, [key])
return state
}