...
Note on Intrum payment breakdown: The paidCapital/paidExpenses/paidInterest split requires the caller to compute how a lump payment is distributed across capital, expenses, and interest. This typically involves balance calculations at the placement date the invoice was sent to collection. The service does not compute this split — the caller must provide it.
Note on currentBalance: The balance calculation may differ by provider. For example, Svea uses a provider-specific calculation based on both the payment creation time and placement date. The caller is responsible for providing the correct balance per their business rules.
Response Contract
The service returns the generated file content. Format TBD — options:
- Raw bytes — the caller receives the file content and handles storage/delivery
- Base64-encoded string — file content as a JSON-friendly string with metadata (filename, content type, encoding)
Summary totals, record counts, and checksum records within the files are computed by the service — they are not part of the request schema.
...
Notes
- Summary totals, record counts, and checksum records within the files are computed by the service — they are not part of the request schema.
- All amounts in the JSON are standard decimals (e.g.,
12500.00). The service converts to the format required by each provider — fixed-width formats use öre (amount × 100, no decimals, e.g.,1250000).
...
Utility Type Mapping
The utility code identifies the energy commodity type. The common schema uses a 2-character code:
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"type": "payment",
"format": "INTRUM",
"timestamp": "2025-03-10T09:00:00Z",
"creditor": {
"id": "7654321",
"department": null,
"name": "Energibolaget AB",
"legalIdentity": "5561234567"
},
"payments": [
{
"invoiceRef": "2025005678",
"amount": 20000.00,
"date": "2025-03-08",
"currency": "SEK",
"type": "Payment",
"currentBalance": 25200.00,
"customerNumber": "K-800456",
"customerName": "Fastigheter i Norr AB",
"customerLegalIdentity": "5567891234",
"settledFromInvoiceRef": null,
"settledFromInvoiceDate": null,
"paidCapital": 19500.00,
"paidExpenses": 400.00,
"paidInterest": 100.00,
"remainingCapital": 24500.00,
"invoiceCredited": false,
"creditComment": null
},
{
"invoiceRef": "2025001111",
"amount": 5500.00,
"date": "2025-03-09",
"currency": "SEK",
"type": "Credit",
"currentBalance": 0,
"customerNumber": "K-800456",
"customerName": "Fastigheter i Norr AB",
"customerLegalIdentity": "5567891234",
"settledFromInvoiceRef": "2025002222",
"settledFromInvoiceDate": "2025-01-15",
"paidCapital": 5500.00,
"paidExpenses": 0,
"paidInterest": 0,
"remainingCapital": 0,
"invoiceCredited": true,
"creditComment": "Fakturan krediterad"
}
]
} |
Format Differences Summary
...