* fix(invoices): reminders, AR ledger, AR reconciliation and deadlines only read fakturor The overdue-reminder run, the kundreskontra, the 1510 reconciliation and the deadlines page selected invoices by status alone. A sent proforma past its due date was chased with a betalningspaminnelse and flipped to 'overdue', and it appeared as a receivable. All four now filter document_type = 'invoice', which is also the precondition for adding quotes (offert): a quote carries a date but never a receivable. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * feat(invoices): offert (quote) document type with its own OF-series, decisions and conversion Adds document_type 'quote' with valid_until, quote_status (open / accepted / declined; expired is derived from valid_until, never stored) and quote_decided_at. Quotes are numbered OF-nnn at insert from company_settings.next_quote_number via generate_quote_number(), the same pattern as delivery notes, so a declined quote never leaves a hole in the F-series the way a proforma does. The column next_quote_number already existed on prod and staging without a migration; the migration adopts it. Engine: build-invoice-write writes the quote columns and keeps remaining_amount at 0; the draft editor refuses accepted or declined quotes; PATCH refuses changing a quote's or delivery note's document type since the number belongs to the series; mark-paid refuses quotes. New POST /api/invoices/[id]/quote-status records the decision and locks once an invoice exists. Conversion is extracted into lib/invoices/convert-to-invoice.ts (one implementation for the route and the MCP staged commit, which had drifted): a converted quote stays and flips to accepted, the invoice links back via converted_from_id and gets its due date from the customer's payment terms; a declined or already invoiced quote is refused. next-number previews the OF-series for quotes. Migration applied to the staging branch and registered as 20260902140000; the pg test runs in CI (pg-real). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * feat(invoices): quote PDF, email and filename surfaces The customer-facing surfaces get a quote sibling for every proforma branch: PDF title OFFERT / QUOTE with Offertdatum and Giltig till instead of the due date, a notice that the document is not an invoice or a payment request, and no payment box, OCR, bankgiro, Swish, QR or payment link. The email says the quote is attached and valid until the expiry, drops the payment details and pay-online button, and asks about the quote rather than the invoice. Filenames read "Offert nr OF-001". Seller VAT number and payment accounts are skipped for quotes as for proformas: a quote is not a faktura under ML 17 kap. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * feat(invoices): offert in the editor, list and detail pages Editor: "Offert" document type with a required "Giltig till" field (default today + 30 days) in place of the due date; the wire body mirrors it into due_date so the shared schema is satisfied. Payment link, ROT/RUT, periodisering and the bank box are already gated on real invoices. The type cannot be switched on an existing quote (its OF-number belongs to the series). List: an Offerter tab beside Proforma, "Ny offert" in the split button, and a status column that shows the decision or the derived expiry: Utgången and Avböjd are exception chips, Öppen and Accepterad muted text. Detail: Acceptera and Skapa faktura in the header, Avböj in the overflow menu; an expired quote asks before accepting or invoicing (bypassable); once an invoice exists the page links to it as Fakturerad and hides the decision actions. Strings in both sv and en. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * feat(mcp,v1): expose offert on the MCP tools and the v1 REST surface MCP: create_invoice takes document_type quote with a required valid_until and allocates the OF-number at insert; the convert tool keeps its id and accepts quotes with the registry refusal codes; new set_quote_status; list_invoices and get_invoice expose valid_until and the effective quote status, including a derived expired filter. The tools/list payload stays under its ceiling without a ledger change. The MCP staged convert now uses the shared converter. v1: POST /invoices/{id}/quote-status (registered in the endpoint registry, scope map and route loader), valid_until and quote_status in the list, create and detail shapes, and a quote_status list filter. Skill atoms mention offert. Decision log lines for the own number series, derived expiry, accepted-not-cancelled conversion and the header action layout. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * test(invoices): pass route params and period id in the new quote tests Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * refactor(invoices): literal update payloads in the converter so the phantom-column guard can read them Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W45yD8NfQ97JhyYaXpzN56 * fix(invoices): close the quote review findings in one pass Skeptics (correctness, compliance, regression) and CodeRabbit on #2163: - quote_status is no longer a write-builder output, so a v1 PATCH or MCP update_invoice can never reset a recorded accept/decline; new quotes are opened by the invoices_quote_defaults trigger (20260902141000), which also keeps due_date and valid_until equal. v1 PATCH and the MCP update executor now use the shared editable-draft predicate. - One live invoice per converted source, enforced by a partial unique index; the converter maps 23505 to INVOICE_QUOTE_ALREADY_INVOICED and both quote-status routes compare-and-set on the decision they read. - MCP-created quotes carry remaining_amount 0; mark-paid, transaction match and voucher link refuse non-invoices on the MCP staging tools, the executors and the dashboard link route. - Conversion of a foreign-currency source refetches the rate for the conversion day (ML 8 kap 21-23 paragraphs) and fails closed without one; 0-day payment terms mean due on receipt. - bulk-create refuses quotes per item; list_invoices rejects a quote_status filter combined with another document_type; an omitted document_type on PATCH means unchanged. - attention, push notifications, open-AR count, FX revaluation, year-end and accrual auto-detect and bank-match suggestions only read fakturor. - Quote PDF and email print Summa / Total instead of Att betala. - Regenerated skills/accounted-api for the new v1 endpoint. Declined with reasons in DECISIONS.md: NOT VALID + VALIDATE and CONCURRENTLY on the migrations (repo precedent, 13.8k rows, transactional apply); re-validating VAT treatment at conversion (the converted invoice is a draft the user reviews; follow-up). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0111fYAUxKtpxU1BHiBioqzs * fix(invoices): second review round: migration versions, order links, batch allocation, races - Migrations renamed to 20260902220000 / 20260902221000: #2166 shipped its own 20260902141000 to prod while this PR was in review and prod's head moved past both files; below-head versions are skipped by branching, which would have left the quote trigger off prod. Staging rows renamed. - Quote lines never carry sales_order_item_id (an offer must not count as invoiced kundorder quantity); the converter carries a proforma line's order link onto the invoice. - Converter compare-and-sets the source (proforma cancel, quote accept): a concurrent cancel, proforma-to-order conversion or decision removes the orphan invoice with INVOICE_CONVERT_SOURCE_CHANGED instead of a second document for the same sale. - MCP set_quote_status gets the same compare-and-set as the HTTP routes; 0-row updates report INVOICE_QUOTE_CHANGED_CONCURRENTLY everywhere. quote-status (dashboard, v1, MCP) accepts valid_until so an expired sent quote can be reopened, as the docs promised. - MCP mark-paid refuses only quotes, parity with the dashboard route (a sent proforma marked paid is a supported prepayment record). - Batch allocation (dashboard route and MCP tool) refuses non-invoices before the RPC, which gates on status alone. - Customer AR drill-down, v1 customer open invoices and archive guard, and the calendar feed read fakturor only. - Draft quote PDF says "UTKAST" instead of "not a valid invoice"; the editor locks the document type on existing quotes and delivery notes. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0111fYAUxKtpxU1BHiBioqzs * chore(invoices): use roundOre in the quote MCP summaries and FX test after main tightened the guard baseline Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0111fYAUxKtpxU1BHiBioqzs * fix(invoices): third review round: atomic decision lock, viewer gate, lookup errors, quote payment terms - 20260902222000: BEFORE UPDATE trigger locks an accepted quote while a live converted invoice exists (the compare-and-set in the three decision writers could still be beaten by a conversion landing in between); the routes and the MCP tool map the raise to 409 INVOICE_QUOTE_ALREADY_INVOICED. generate_quote_number now also requires a non-viewer membership so a viewer's session token cannot burn OF-numbers through PostgREST. - Converter checks quote eligibility before the Riksbanken call and treats a failed company_settings read as a failure instead of a 30-day default. - Re-sending the same decision keeps quote_decided_at (idempotent). - gnubok_find_voucher_candidates_for_invoice refuses non-invoices like its write sibling; the dashboard link route surfaces a failed lookup. - Late-fee and credit-term texts never print on a quote. Applied and registered on staging; pg tests added. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0111fYAUxKtpxU1BHiBioqzs * fix(invoices): review nits: fail-closed batch lookup, dry-run expiry, quote heading, quote-date CHECK - match-batch surfaces a failed document lookup instead of allocating. - v1 quote-status dry-run preview carries the new valid_until. - Quote PDF heading reads Offertinformation / Quote information. - 20260902222000 also pins the date invariants the trigger maintains as a CHECK: a quote always has valid_until = due_date, nothing else has one. Applied on staging. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0111fYAUxKtpxU1BHiBioqzs --------- Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
487 lines
17 KiB
TypeScript
487 lines
17 KiB
TypeScript
import { createServerClient } from '@supabase/ssr'
|
|
import { getEmailService } from '@/lib/email/service'
|
|
import { getSenderForCompany, getBaseUrlForBrand } from '@/lib/email/brand-sender'
|
|
import { resolveInvoiceSender, type InvoiceSenderIdentity } from '@/lib/email/invoice-sender'
|
|
import {
|
|
generateReminderEmailHtml,
|
|
generateReminderEmailText,
|
|
generateReminderEmailSubject,
|
|
reminderPrincipal,
|
|
getReminderDaysConfig,
|
|
type ReminderDaysConfig,
|
|
} from '@/lib/email/reminder-templates'
|
|
import { calculateLatePaymentInterest } from '@/lib/invoices/late-payment-interest'
|
|
import {
|
|
hasUsableInvoicePaymentAccount,
|
|
resolveInvoicePaymentAccount,
|
|
} from '@/lib/invoices/payment-accounts'
|
|
import { createReminderFeeEntry } from '@/lib/bookkeeping/reminder-fee-entries'
|
|
import { createLogger } from '@/lib/logger'
|
|
import type { Invoice, Customer, CompanySettings } from '@/types'
|
|
|
|
const log = createLogger('reminder-processor')
|
|
|
|
// Create a service client for cron jobs (no cookie access needed)
|
|
function createServiceClient() {
|
|
return createServerClient(
|
|
process.env.NEXT_PUBLIC_SUPABASE_URL!,
|
|
process.env.SUPABASE_SERVICE_ROLE_KEY!,
|
|
{
|
|
cookies: {
|
|
getAll() { return [] },
|
|
setAll() { }
|
|
}
|
|
}
|
|
)
|
|
}
|
|
|
|
export interface ReminderResult {
|
|
invoiceId: string
|
|
invoiceNumber: string
|
|
customerEmail: string
|
|
reminderLevel: 1 | 2 | 3
|
|
success: boolean
|
|
error?: string
|
|
}
|
|
|
|
export interface ProcessRemindersResult {
|
|
processed: number
|
|
sent: number
|
|
failed: number
|
|
results: ReminderResult[]
|
|
}
|
|
|
|
/**
|
|
* Determine which reminder level should be sent based on days overdue
|
|
* Returns null if no reminder should be sent
|
|
*/
|
|
export function determineReminderLevel(
|
|
daysOverdue: number,
|
|
existingLevels: number[],
|
|
config: ReminderDaysConfig = getReminderDaysConfig(),
|
|
): 1 | 2 | 3 | null {
|
|
// Check the highest eligible level first, preserving the existing behavior
|
|
// when a previous cron run was missed.
|
|
if (daysOverdue >= config[3] && !existingLevels.includes(3)) {
|
|
return 3
|
|
}
|
|
|
|
if (daysOverdue >= config[2] && !existingLevels.includes(2)) {
|
|
return 2
|
|
}
|
|
|
|
if (daysOverdue >= config[1] && !existingLevels.includes(1)) {
|
|
return 1
|
|
}
|
|
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* Calculate days overdue from due date
|
|
*/
|
|
export function calculateDaysOverdue(dueDate: string): number {
|
|
const due = new Date(dueDate)
|
|
const now = new Date()
|
|
const diffTime = now.getTime() - due.getTime()
|
|
const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24))
|
|
return diffDays
|
|
}
|
|
|
|
/**
|
|
* Surcharges computed before sending the reminder. These are passed to the
|
|
* email template and persisted on the invoice_reminders row for audit.
|
|
*/
|
|
export interface ReminderSurcharges {
|
|
/** Dröjsmålsränta: a share of the invoice total, so it carries the INVOICE currency. */
|
|
interestAmount: number
|
|
interestRate: number
|
|
interestFromDate: string
|
|
interestDays: number
|
|
/**
|
|
* Lagstadgad påminnelseavgift, always in SEK (Lag 1981:739; booked 1510/3990
|
|
* in SEK). Deliberately NOT summed with the invoice-currency amounts here:
|
|
* the template derives the per-currency amount to pay via
|
|
* calculateReminderAmounts().
|
|
*/
|
|
reminderFee: number
|
|
}
|
|
|
|
/**
|
|
* Send a single reminder email
|
|
*/
|
|
export async function sendReminder(
|
|
invoice: Invoice & { customer: Customer },
|
|
company: CompanySettings,
|
|
reminderLevel: 1 | 2 | 3,
|
|
actionToken: string,
|
|
surcharges: ReminderSurcharges,
|
|
sender?: InvoiceSenderIdentity,
|
|
): Promise<{ success: boolean; error?: string }> {
|
|
const customer = invoice.customer
|
|
|
|
if (!customer.email) {
|
|
return { success: false, error: 'Customer has no email' }
|
|
}
|
|
|
|
// Backstop for direct callers: processOverdueReminders applies this same
|
|
// gate BEFORE booking the fee and inserting the reminder row. A reminder
|
|
// with no payment account for the invoice currency would print nothing to
|
|
// pay to, or (before this gate) the SEK account's IBAN on a EUR invoice.
|
|
const currency = invoice.currency
|
|
if (!hasUsableInvoicePaymentAccount(resolveInvoicePaymentAccount(company, currency), currency)) {
|
|
log.warn('Skipping reminder: no payment account configured for invoice currency', {
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
currency,
|
|
})
|
|
return { success: false, error: `INVOICE_PAYMENT_ACCOUNT_MISSING:${currency}` }
|
|
}
|
|
|
|
const daysOverdue = calculateDaysOverdue(invoice.due_date)
|
|
|
|
// Brand mail (WL-13): the action link points at the company's home domain
|
|
// and the mail rides the brand's verified sender domain, while the COMPANY
|
|
// stays the displayed sender exactly as today. No brand = canonical URL
|
|
// and today's From header.
|
|
const brandSender = await getSenderForCompany(invoice.company_id)
|
|
const baseUrl = getBaseUrlForBrand(brandSender.brand)
|
|
const actionUrl = `${baseUrl}/invoice-action/${actionToken}`
|
|
|
|
const emailData = {
|
|
invoice,
|
|
customer,
|
|
company,
|
|
reminderLevel,
|
|
daysOverdue,
|
|
actionUrl,
|
|
...surcharges,
|
|
}
|
|
|
|
const result = await getEmailService().sendEmail({
|
|
to: customer.email,
|
|
subject: generateReminderEmailSubject(emailData),
|
|
html: generateReminderEmailHtml(emailData),
|
|
text: generateReminderEmailText(emailData),
|
|
replyTo: company.email || undefined,
|
|
fromName: company.company_name || undefined,
|
|
...(brandSender.fromAddress ? { fromAddress: brandSender.fromAddress } : {}),
|
|
// The company's own verified sender wins over the brand address
|
|
// (buildFromHeader gives `from` precedence).
|
|
from: sender,
|
|
})
|
|
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* Process all overdue invoices and send reminders
|
|
* This is the main function called by the cron job
|
|
*/
|
|
export async function processOverdueReminders(): Promise<ProcessRemindersResult> {
|
|
const supabase = createServiceClient()
|
|
const results: ReminderResult[] = []
|
|
|
|
// Company schedules can start as early as one day overdue. Fetch that
|
|
// bounded candidate set, then apply each company's thresholds below.
|
|
const cutoffDate = new Date()
|
|
cutoffDate.setDate(cutoffDate.getDate() - 1)
|
|
|
|
// Positive allowlist: inherently excludes 'paid', 'partially_paid', 'cancelled', 'credited'.
|
|
// Including 'overdue' ensures level-2 / level-3 reminders re-fire after the first reminder
|
|
// flips status to 'overdue' (see status update below).
|
|
const { data: overdueInvoices, error: invoiceError } = await supabase
|
|
.from('invoices')
|
|
.select(`
|
|
*,
|
|
customer:customers(*),
|
|
credit_notes:invoices!credited_invoice_id(id, status, creation_complete)
|
|
`)
|
|
.in('status', ['sent', 'overdue'])
|
|
// Only fakturor are payment requests. A sent proforma or quote past its
|
|
// date is not overdue and must never receive a betalningspåminnelse or
|
|
// be flipped to 'overdue' below.
|
|
.eq('document_type', 'invoice')
|
|
.is('credited_invoice_id', null)
|
|
.lte('due_date', cutoffDate.toISOString().split('T')[0])
|
|
.order('due_date', { ascending: true })
|
|
|
|
if (invoiceError) {
|
|
log.error('Error fetching overdue invoices:', invoiceError)
|
|
return { processed: 0, sent: 0, failed: 0, results: [] }
|
|
}
|
|
|
|
if (!overdueInvoices || overdueInvoices.length === 0) {
|
|
log.info('No overdue invoices found')
|
|
return { processed: 0, sent: 0, failed: 0, results: [] }
|
|
}
|
|
|
|
log.info(`Found ${overdueInvoices.length} overdue invoices to process`)
|
|
|
|
// Process each invoice
|
|
for (const invoice of overdueInvoices) {
|
|
const activeCreditNotes = ((invoice as { credit_notes?: Array<{
|
|
status: string
|
|
creation_complete?: boolean
|
|
}> }).credit_notes ?? []).filter(
|
|
(creditNote) => creditNote.status !== 'cancelled' && creditNote.creation_complete !== false,
|
|
)
|
|
if (activeCreditNotes.length > 0) {
|
|
log.info(`Skipping invoice ${invoice.invoice_number}: active credit note exists`)
|
|
continue
|
|
}
|
|
|
|
const customer = invoice.customer as Customer
|
|
|
|
// Skip if customer has no email
|
|
if (!customer?.email) {
|
|
log.info(`Skipping invoice ${invoice.invoice_number}: customer has no email`)
|
|
continue
|
|
}
|
|
|
|
// Get existing reminders for this invoice
|
|
const { data: existingReminders } = await supabase
|
|
.from('invoice_reminders')
|
|
.select('reminder_level, response_type')
|
|
.eq('invoice_id', invoice.id)
|
|
|
|
// Skip if customer already responded (marked paid OR disputed): they've
|
|
// told us they don't want another reminder. The business owner still needs
|
|
// to record the actual payment (mark-paid / match-invoice) to flip status
|
|
// and post the journal entry; we don't do that here because the customer
|
|
// action is unauthenticated and posting a JE without a verified payment
|
|
// would put the books out of sync.
|
|
const customerResponded = existingReminders?.some(r => r.response_type !== null)
|
|
if (customerResponded) {
|
|
log.info(`Skipping invoice ${invoice.invoice_number}: customer already responded via reminder link`)
|
|
continue
|
|
}
|
|
|
|
const existingLevels = existingReminders?.map(r => r.reminder_level) || []
|
|
const daysOverdue = calculateDaysOverdue(invoice.due_date)
|
|
|
|
// Get company settings for this user
|
|
const { data: company, error: companyError } = await supabase
|
|
.from('company_settings')
|
|
.select('*')
|
|
.eq('company_id', invoice.company_id)
|
|
.single()
|
|
|
|
if (companyError || !company) {
|
|
log.error(`Skipping invoice ${invoice.invoice_number}: company settings not found`)
|
|
const fallbackLevel = determineReminderLevel(daysOverdue, existingLevels)
|
|
if (fallbackLevel) {
|
|
results.push({
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
customerEmail: customer.email,
|
|
reminderLevel: fallbackLevel,
|
|
success: false,
|
|
error: 'Company settings not found',
|
|
})
|
|
}
|
|
continue
|
|
}
|
|
|
|
// Per-company kill switch (settings → Fakturering → "Skicka automatiska påminnelser")
|
|
if (company.send_invoice_reminders === false) {
|
|
log.info(`Skipping invoice ${invoice.invoice_number}: automatic reminders disabled for company ${invoice.company_id}`)
|
|
continue
|
|
}
|
|
|
|
const reminderConfig = getReminderDaysConfig(company as CompanySettings)
|
|
const reminderLevel = determineReminderLevel(daysOverdue, existingLevels, reminderConfig)
|
|
|
|
if (!reminderLevel) {
|
|
log.info(`Skipping invoice ${invoice.invoice_number}: no reminder needed (${daysOverdue} days overdue, existing levels: ${existingLevels.join(', ')})`)
|
|
continue
|
|
}
|
|
|
|
// Payment-account gate, BEFORE any write: the fee journal entry and the
|
|
// invoice_reminders row below must not exist for a reminder that never
|
|
// goes out (that would book a 60 kr fee and burn the level for an email
|
|
// the customer never got). Same rule as invoice send: no usable account
|
|
// for the invoice currency means no reminder until the user configures
|
|
// one under Inställningar; the level stays open and fires next run.
|
|
const invoiceCurrency = invoice.currency
|
|
if (
|
|
!hasUsableInvoicePaymentAccount(
|
|
resolveInvoicePaymentAccount(company as CompanySettings, invoiceCurrency),
|
|
invoiceCurrency,
|
|
)
|
|
) {
|
|
log.warn('Skipping reminder: no payment account configured for invoice currency', {
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
currency: invoiceCurrency,
|
|
})
|
|
results.push({
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
customerEmail: customer.email,
|
|
reminderLevel,
|
|
success: false,
|
|
error: `INVOICE_PAYMENT_ACCOUNT_MISSING:${invoiceCurrency}`,
|
|
})
|
|
continue
|
|
}
|
|
|
|
// Race-window guard: re-check invoice status immediately before sending.
|
|
// The cron runs at 08:00; a payment match arriving during the run shouldn't
|
|
// produce a reminder for an already-paid invoice.
|
|
const { data: currentInvoice } = await supabase
|
|
.from('invoices')
|
|
.select('status, credit_notes:invoices!credited_invoice_id(id, status, creation_complete)')
|
|
.eq('id', invoice.id)
|
|
.eq('company_id', invoice.company_id)
|
|
.single()
|
|
|
|
const currentCreditNotes = ((currentInvoice as { credit_notes?: Array<{
|
|
status: string
|
|
creation_complete?: boolean
|
|
}> } | null)?.credit_notes ?? []).filter(
|
|
(creditNote) => creditNote.status !== 'cancelled' && creditNote.creation_complete !== false,
|
|
)
|
|
if (
|
|
!currentInvoice ||
|
|
!['sent', 'overdue'].includes(currentInvoice.status as string) ||
|
|
currentCreditNotes.length > 0
|
|
) {
|
|
log.info(`Skipping invoice ${invoice.invoice_number}: status changed to ${currentInvoice?.status ?? 'unknown'} mid-run`)
|
|
continue
|
|
}
|
|
|
|
// Compute statutory late-payment interest (Räntelagen §6) using the
|
|
// company override if set, else Riksbankens referensränta + 8 pp.
|
|
const asOfDate = new Date().toISOString().split('T')[0]
|
|
// Interest accrues on what the customer actually owes: the invoice's
|
|
// "Att betala" (öre-rounded total minus any ROT/RUT-avdrag), never on the
|
|
// Skatteverket share sitting on 1513.
|
|
const interest = calculateLatePaymentInterest({
|
|
overdueAmount: reminderPrincipal(invoice as Invoice, company as CompanySettings),
|
|
dueDate: invoice.due_date,
|
|
asOfDate,
|
|
overrideRate: company.reminder_interest_rate_override,
|
|
})
|
|
|
|
// Determine the lagstadgad påminnelseavgift (Lag 1981:739, max 60 kr).
|
|
// Clamp at 60 kr: the statute caps the fee even if company_settings
|
|
// somehow holds a higher value (defense in depth against a stale DB row).
|
|
const reminderFee = company.reminder_fee_enabled
|
|
? Math.min(60, Math.round((company.reminder_fee_amount ?? 60) * 100) / 100)
|
|
: 0
|
|
|
|
// Book the fee as a journal entry. Booked BEFORE creating the
|
|
// invoice_reminders row so we can persist fee_journal_entry_id.
|
|
// Failure to book the fee is logged but does not abort the reminder
|
|
// send: the customer still needs to receive the notification.
|
|
let feeJournalEntryId: string | null = null
|
|
if (reminderFee > 0) {
|
|
try {
|
|
const feeResult = await createReminderFeeEntry(supabase, {
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
companyId: invoice.company_id,
|
|
userId: invoice.user_id,
|
|
feeAmount: reminderFee,
|
|
asOfDate,
|
|
})
|
|
feeJournalEntryId = feeResult?.journal_entry_id ?? null
|
|
} catch (feeError) {
|
|
log.error(
|
|
`Failed to book reminder fee for invoice ${invoice.invoice_number}:`,
|
|
feeError as Error,
|
|
)
|
|
// Continue: surcharge still appears in the email, but no JE is linked.
|
|
}
|
|
}
|
|
|
|
// No "totalDue" scalar is computed here on purpose: invoice.total and
|
|
// interest.amount are in the invoice currency while reminderFee is a
|
|
// statutory SEK amount. Summing them would produce a nonsense figure for a
|
|
// EUR/USD invoice. The email template splits the amount to pay per currency.
|
|
|
|
// Create reminder record first (to get action token), persisting the
|
|
// computed surcharges so the public action page + audit trail show them.
|
|
const { data: reminderRecord, error: reminderError } = await supabase
|
|
.from('invoice_reminders')
|
|
.insert({
|
|
invoice_id: invoice.id,
|
|
user_id: invoice.user_id,
|
|
company_id: invoice.company_id,
|
|
reminder_level: reminderLevel,
|
|
email_to: customer.email,
|
|
interest_amount: interest.amount,
|
|
interest_rate: interest.rate,
|
|
interest_from_date: interest.fromDate,
|
|
interest_days: interest.days,
|
|
reminder_fee: reminderFee,
|
|
fee_journal_entry_id: feeJournalEntryId,
|
|
})
|
|
.select('action_token')
|
|
.single()
|
|
|
|
if (reminderError || !reminderRecord) {
|
|
log.error(`Failed to create reminder record for invoice ${invoice.invoice_number}:`, reminderError)
|
|
results.push({
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
customerEmail: customer.email,
|
|
reminderLevel,
|
|
success: false,
|
|
error: 'Failed to create reminder record'
|
|
})
|
|
continue
|
|
}
|
|
|
|
// Send the reminder email
|
|
const sendResult = await sendReminder(
|
|
invoice as Invoice & { customer: Customer },
|
|
company as CompanySettings,
|
|
reminderLevel,
|
|
reminderRecord.action_token,
|
|
{
|
|
interestAmount: interest.amount,
|
|
interestRate: interest.rate,
|
|
interestFromDate: interest.fromDate,
|
|
interestDays: interest.days,
|
|
reminderFee,
|
|
},
|
|
await resolveInvoiceSender(supabase, invoice.company_id, company.company_name),
|
|
)
|
|
|
|
if (sendResult.success) {
|
|
log.info(`Sent level ${reminderLevel} reminder for invoice ${invoice.invoice_number} to ${customer.email}`)
|
|
|
|
// Update invoice status to overdue if not already
|
|
if (invoice.status === 'sent') {
|
|
await supabase
|
|
.from('invoices')
|
|
.update({ status: 'overdue' })
|
|
.eq('id', invoice.id)
|
|
}
|
|
} else {
|
|
log.error(`Failed to send reminder for invoice ${invoice.invoice_number}:`, sendResult.error)
|
|
}
|
|
|
|
results.push({
|
|
invoiceId: invoice.id,
|
|
invoiceNumber: invoice.invoice_number,
|
|
customerEmail: customer.email,
|
|
reminderLevel,
|
|
success: sendResult.success,
|
|
error: sendResult.error
|
|
})
|
|
}
|
|
|
|
const sent = results.filter(r => r.success).length
|
|
const failed = results.filter(r => !r.success).length
|
|
|
|
return {
|
|
processed: results.length,
|
|
sent,
|
|
failed,
|
|
results
|
|
}
|
|
}
|