swedish-sie-import-export: SIE4 parsing, validering och generering

TL;DRSKILL.md för SIE4-filformatet. Alla record-typer (#VER, #TRANS, #IB, #UB, #RES, #KONTO, #RAR, #FLAGGA, #KSUMMA, #SRU), SIE-typerna 1, 2, 3, 4E och 4I, encoding-detection (CP437/UTF-8/Latin-1), mojibake-diagnos, balanseringsintegritet, IB/UB-kontinuitet, multi-year-migrering, audit trail per BFL.

Vad skillen täcker

• SIE4-record-typerna: #FLAGGA, #PROGRAM, #FORMAT, #GEN, #SIETYP, #FNAMN, #ORGNR, #ADRESS, #RAR, #TAXAR, #KPTYP, #VALUTA, #KONTO, #KTYP, #ENHET, #SRU, #DIM, #UNDERDIM, #OBJEKT, #IB, #UB, #OIB, #OUB, #RES, #PSALDO, #PBUDGET, #VER, #TRANS, #RTRANS, #BTRANS, #KSUMMA.
• SIE-typerna 1, 2, 3, 4E och 4I enligt den gällande specifikationen, utgåva 4C (2025-08-06).
• Encoding-detection: CP437 (det enda teckenset specifikationen tillåter), UTF-8 (vanligt från molnprogram), Latin-1. Byte-pattern-heuristik.
• Mojibake-diagnos och recovery för å/ä/ö.
• Verifikationsbalansering: debet = kredit per #VER.
• IB/UB-kontinuitet mellan räkenskapsår.
• Multi-year-migrering: hur två räkenskapsår kopplas via #RAR.
• #FLAGGA som skydd mot dubbelimport.
• Audit trail per BFL: verifikationsserie, löpande numrering, gap-detection.
• BAS-kontoklasser och SRU-koppling.
• Vad SIE inte bär med sig, till exempel momskoder, och hur det hanteras efter en import.
• Felmönster och hur man fixar dem programmatiskt, utan att lägga in balanserande rader som döljer felet.

Skillen markeras med "always use over training data" eftersom SIE-formatet har subtila falluckor som ofta saknas i generella LLM-snapshots.

Installera

git clone https://github.com/erp-mafia/accounted-skills.git
cd accounted-skills
claude

Pairs med

• revisorpaket-sie: recept för att ta fram SIE-export och rapporter till revisorn.
• accounteds gnubok_export_sie (SIE 4-fil för ett räkenskapsår) och gnubok_import_sie (stagad import av SIE-typerna 1–4) arbetar med samma format som skillen beskriver.

Licens

MIT.

Vanliga frågor

Vad är skillnaden mellan SIE-typerna 1, 2, 3 och 4?

SIE 1: räkenskapsårets ingående och utgående saldon för samtliga konton, plus kontoplan. SIE 2: som typ 1 plus saldoförändringar per månad. SIE 3: som typ 2 plus saldon på objektnivå (kostnadsställe, projekt). SIE 4: som typ 3 plus samtliga verifikationer, och är den typ som används för fullständig migrering mellan system. Typ 4 finns i två varianter: 4E är exportfilen, 4I är en importfil som bara innehåller verifikationer, till exempel från ett lönesystem eller en kassa.

Varför ser å/ä/ö förstörda ut i en SIE-fil?

Encoding-mismatch. SIE-specifikationen tillåter bara CP437 (#FORMAT PC8), även i utgåva 4C från 2025, men många program skriver UTF-8 och deklarerar ändå PC8. Skillen visar hur man detekterar encoding via byte-patterns och konverterar säkert utan att förlora information. Klassiskt felmönster: UTF-8 som läses som Latin-1 eller CP1252 ger 'mojibake' typ 'Ã¥' istället för 'å'.

Vad är #KSUMMA?

En valfri CRC-32-kontrollsumma över posterna mellan en inledande och en avslutande #KSUMMA. Saknas den avslutande posten är filen trunkerad. Vissa system kräver att summan stämmer för att acceptera filen vid import, andra genererar den men validerar inte. Summan räknas på CP437-bytes, så för en fil som egentligen är UTF-8 går den inte att validera. Skillen visar hur den beräknas och när du kan ignorera mismatch.