Ärendepaketet till inkasso

GET /fakturor/{fakturaId}/inkasso?format=pdf    # handlingen att bifoga
GET /fakturor/{fakturaId}/inkasso?format=json   # kontraktet nedan
GET /fakturor/{fakturaId}/inkasso?format=csv    # Excel-vyn

type CollectionCase = {
  schema: "debet-kredit/inkasso-arende"
  schemaVersion: 1
  preparedAt: string          // när paketet skapades (ISO 8601)

  creditor: {                 // borgenären — ur dina egna inställningar
    name: string
    orgNumber: string | null
    address: string | null; postalCode: string | null; city: string | null
    email: string | null; phone: string | null
    bankgiro: string | null; plusgiro: string | null; iban: string | null
    /** ditt borgenärsnummer hos partnern, när partnern gett ett */
    partnerAccount: string | null
  }

  debtor: {                   // gäldenären — ur fakturans FRYSTA snapshot
    name: string
    orgNumber: string | null; vatNumber: string | null
    address: string | null; postalCode: string | null; city: string | null
    country: string | null
    email: string | null; phone: string | null
    yourReference: string | null
  }

  invoice: {
    invoiceNo: number; ocr: string | null
    invoiceDate: string; dueDate: string; currency: string
    netAmount: number; vatAmount: number; rounding: number; totalAmount: number
    notes: string | null      // det som stod PÅ fakturan. Aldrig internal_notes.
    lines: {
      rowNo: number; description: string
      quantity: number; unit: string; unitPrice: number
      discountPct: number; vatRatePct: number
      lineAmount: number      // exkl. moms, efter rabatt
    }[]
  }

  /** DATUMET ÄR OBLIGATORISKT — utan det går räntan inte att räkna. */
  payments: { date: string; amount: number }[]
  reminders: { reminderNo: number; sentDate: string; fee: number }[]

  interest: {
    amount: number; days: number
    fromDate: string; toDate: string
    rateSource: "avtalad" | "rantelagen"
    agreedRatePct: number | null
    /** en delperiod per räntesats och per betalningsdag */
    segments: {
      from: string; to: string; days: number
      ratePct: number; balance: number; amount: number
    }[]
    /** sant = ett halvårs referensränta saknas. amount är då INTE fullständig. */
    incomplete: boolean
    missingPeriods: { from: string; to: string }[]
  }

  claim: {                    // delarna ska gå att summera till total för hand
    principal:    { amount: number; currency: string }
    interest:     { amount: number; currency: string }
    reminderFees: { amount: number; currency: string }
    total:        { amount: number; currency: string }
  }

  /** borgenären har själv bedömt fordran som tvistig. Varning, inte spärr. */
  disputed: boolean
}

// En adapter är en funktion. Ingenting mer.
//
// Hämta paketet ur din egen installation och översätt till partnerns format.
// Vad du INTE ska göra: räkna om räntan. Segmenten nedan är redan uppdelade
// per kalenderhalvår och per betalningsdag enligt räntelagen (1975:635)
// 6 och 9 §§, och en andra uträkning glider isär med den första.

const arende: CollectionCase = await fetch(
  `${MIN_INSTALLATION}/fakturor/${fakturaId}/inkasso?format=json`,
  { headers: { cookie: minSession } },
).then((r) => r.json());

if (arende.interest.incomplete) {
  // Referensräntan saknas för en delperiod. Skicka INTE — ett gissat
  // räntebelopp i ett betalningskrav är värre än ingen ränta.
  throw new Error(`Ofullständig ränta: ${JSON.stringify(arende.interest.missingPeriods)}`);
}

await minPartner.skapaArende({
  creditorNumber: arende.creditor.partnerAccount,
  debtor: {
    name:     arende.debtor.name,
    regNo:    arende.debtor.orgNumber,
    street:   arende.debtor.address,
    zip:      arende.debtor.postalCode,
    city:     arende.debtor.city,
  },
  invoiceNumber: String(arende.invoice.invoiceNo),
  invoiceDate:   arende.invoice.invoiceDate,
  dueDate:       arende.invoice.dueDate,
  capital:       arende.claim.principal.amount,
  interest:      arende.claim.interest.amount,
  fees:          arende.claim.reminderFees.amount,
  reminders:     arende.reminders.map((r) => ({ date: r.sentDate, fee: r.fee })),
  disputed:      arende.disputed,
});