@accounter/shaam-uniform-format-generator 0.1.0 → 0.1.1

package/dist/cjs/generator/records/a000.js

@@ -0,0 +1,349 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A000InputSchema = exports.A000Schema = void 0;
+exports.encodeA000 = encodeA000;
+exports.parseA000 = parseA000;
+const zod_1 = require("zod");
+const constants_js_1 = require("../../constants.js");
+const key_generator_js_1 = require("../../utils/key-generator.js");
+const encoder_js_1 = require("../format/encoder.js");
+/**
+ * A000 Record Schema - INI.TXT file header record
+ * Fields 1000-1035 based on SHAAM uniform format specification
+ */
+exports.A000Schema = zod_1.z.object({
+    // Field 1000: Record Code (4) - Required - Alphanumeric
+    code: zod_1.z.literal('A000').describe('Record type code - always "A000"'),
+    // Field 1001: Reserved for Future Use (5) - Required - Alphanumeric
+    reservedFuture: zod_1.z.string().max(5).default('').describe('Reserved for future use'),
+    // Field 1002: Total Records in BKMVDATA (15) - Required - Numeric
+    totalRecords: zod_1.z.string().min(1).max(15).regex(/^\d+$/).describe('Total records in BKMVDATA file'),
+    // Field 1003: Tax ID (9) - Required - Numeric
+    vatId: zod_1.z.string().min(1).max(9).regex(/^\d+$/).describe('VAT identification number'),
+    // Field 1004: Primary Identifier (15) - Required - Numeric
+    primaryIdentifier: zod_1.z
+        .string()
+        .min(1)
+        .max(15)
+        .regex(/^\d+$/)
+        .describe('Fixed and unique primary identifier per file'),
+    // Field 1005: System Constant (8) - Required - Alphanumeric
+    systemConstant: zod_1.z.literal(constants_js_1.SHAAM_VERSION).describe(`System constant - always "${constants_js_1.SHAAM_VERSION}"`),
+    // Field 1006: Software Registration Number (8) - Required - Numeric
+    softwareRegNumber: zod_1.z
+        .string()
+        .min(1)
+        .max(8)
+        .regex(/^\d+$/)
+        .describe('Software registration number'),
+    // Field 1007: Software Name (20) - Required - Alphanumeric
+    softwareName: zod_1.z.string().min(1).max(20).describe('Software name'),
+    // Field 1008: Software Version (20) - Required - Alphanumeric
+    softwareVersion: zod_1.z.string().min(1).max(20).describe('Software version'),
+    // Field 1009: Vendor Tax ID (9) - Required - Numeric
+    vendorVatId: zod_1.z.string().min(1).max(9).regex(/^\d+$/).describe('Software vendor VAT ID'),
+    // Field 1010: Vendor Name (20) - Required - Alphanumeric
+    vendorName: zod_1.z.string().min(1).max(20).describe('Software vendor name'),
+    // Field 1011: Software Type (1) - Required - Numeric
+    softwareType: zod_1.z.enum(['1', '2']).describe('Software type: 1=Single-year, 2=Multi-year'),
+    // Field 1012: File Output Path (50) - Required - Alphanumeric
+    fileOutputPath: zod_1.z.string().min(1).max(50).describe('File output path'),
+    // Field 1013: Accounting Type (1) - Required - Numeric
+    accountingType: zod_1.z
+        .enum(['0', '1', '2'])
+        .describe('Accounting type: 0=N/A, 1=Single-entry, 2=Double-entry'),
+    // Field 1014: Balance Required Flag (1) - Required - Numeric
+    balanceRequired: zod_1.z.enum(['0', '1']).describe('Balance required flag'),
+    // Field 1015: Company Registrar ID (9) - Optional - Numeric
+    companyRegId: zod_1.z.string().max(9).regex(/^\d*$/).default('').describe('Company registrar ID'),
+    // Field 1016: Withholding File Number (9) - Optional - Numeric
+    withholdingFileNum: zod_1.z
+        .string()
+        .max(9)
+        .regex(/^\d*$/)
+        .default('')
+        .describe('Withholding file number'),
+    // Field 1017: Reserved Field (10) - Optional - Alphanumeric
+    reserved1017: zod_1.z.string().max(10).default('').describe('Reserved field'),
+    // Field 1018: Business Name (50) - Required - Alphanumeric
+    businessName: zod_1.z.string().min(1).max(50).describe('Business name'),
+    // Field 1019: Business Address - Street (50) - Optional - Alphanumeric
+    businessStreet: zod_1.z.string().max(50).default('').describe('Business address - street'),
+    // Field 1020: Business Address - House Number (10) - Optional - Alphanumeric
+    businessHouseNum: zod_1.z.string().max(10).default('').describe('Business address - house number'),
+    // Field 1021: Business Address - City (30) - Optional - Alphanumeric
+    businessCity: zod_1.z.string().max(30).default('').describe('Business address - city'),
+    // Field 1022: Business Address - ZIP (8) - Optional - Alphanumeric
+    businessZip: zod_1.z.string().max(8).default('').describe('Business address - ZIP code'),
+    // Field 1023: Tax Year (4) - Conditional - Numeric
+    taxYear: zod_1.z
+        .string()
+        .max(4)
+        .regex(/^\d*$/)
+        .default('')
+        .describe('Tax year (required if single-year software)'),
+    // Field 1024: Start/Cutoff Date (8) - Conditional - Numeric
+    startDate: zod_1.z
+        .string()
+        .max(8)
+        .regex(/^\d*$/)
+        .default('')
+        .describe('Start/cutoff date YYYYMMDD (required if multi-year)'),
+    // Field 1025: End/Cutoff Date (8) - Conditional - Numeric
+    endDate: zod_1.z
+        .string()
+        .max(8)
+        .regex(/^\d*$/)
+        .default('')
+        .describe('End/cutoff date YYYYMMDD (required if multi-year)'),
+    // Field 1026: Process Start Date (8) - Required - Numeric
+    processStartDate: zod_1.z
+        .string()
+        .length(8)
+        .regex(/^\d{8}$/)
+        .describe('Process start date YYYYMMDD'),
+    // Field 1027: Process Start Time (4) - Required - Numeric
+    processStartTime: zod_1.z
+        .string()
+        .length(4)
+        .regex(/^\d{4}$/)
+        .describe('Process start time HHMM'),
+    // Field 1028: Language Code (1) - Required - Numeric
+    languageCode: zod_1.z.enum(['0', '1', '2']).describe('Language code: 0=Hebrew, 1=Arabic, 2=Other'),
+    // Field 1029: Character Encoding (1) - Required - Numeric
+    characterEncoding: zod_1.z.enum(['1', '2']).describe('Character encoding: 1=ISO-8859-8-i, 2=CP-862'),
+    // Field 1030: Compression Software Name (20) - Optional - Alphanumeric
+    compressionSoftware: zod_1.z.string().max(20).default('').describe('Compression software name'),
+    // Field 1031: Reserved Field (0) - Deprecated - Alphanumeric
+    reserved1031: zod_1.z.string().max(0).default('').describe('Deprecated reserved field'),
+    // Field 1032: Base Currency Code (3) - Optional - Alphanumeric
+    baseCurrency: zod_1.z.string().max(3).default('ILS').describe('Base currency code (default: ILS)'),
+    // Field 1033: Reserved Field (0) - Deprecated - Alphanumeric
+    reserved1033: zod_1.z.string().max(0).default('').describe('Deprecated reserved field'),
+    // Field 1034: Branch Info Flag (1) - Required - Numeric
+    branchInfoFlag: zod_1.z.enum(['0', '1']).describe('Branch info flag: 0=No branches, 1=Has branches'),
+    // Field 1035: Reserved Field (46) - Optional - Alphanumeric
+    reserved1035: zod_1.z.string().max(46).default('').describe('Reserved field'),
+});
+/**
+ * A000 Input Schema - for user input (excludes auto-generated fields)
+ */
+exports.A000InputSchema = exports.A000Schema.omit({
+    code: true,
+    primaryIdentifier: true,
+    systemConstant: true,
+});
+/**
+ * Encodes an A000 record to fixed-width string format
+ * Total line width: 466 characters + CRLF
+ */
+function encodeA000(input) {
+    const primaryIdentifier = key_generator_js_1.defaultKeyGenerator.getPrimaryIdentifier();
+    const fullRecord = {
+        code: 'A000',
+        primaryIdentifier,
+        systemConstant: constants_js_1.SHAAM_VERSION,
+        ...input,
+    };
+    const fields = [
+        (0, encoder_js_1.formatField)(fullRecord.code, 4, 'left'), // Field 1000: Record code (4)
+        (0, encoder_js_1.formatField)(fullRecord.reservedFuture, 5, 'left'), // Field 1001: Reserved future (5)
+        (0, encoder_js_1.formatNumericField)(fullRecord.totalRecords, 15), // Field 1002: Total records (15)
+        (0, encoder_js_1.formatNumericField)(fullRecord.vatId, 9), // Field 1003: VAT ID (9)
+        (0, encoder_js_1.formatNumericField)(fullRecord.primaryIdentifier, 15), // Field 1004: Primary identifier (15)
+        (0, encoder_js_1.formatField)(fullRecord.systemConstant, 8, 'left'), // Field 1005: System constant (8)
+        (0, encoder_js_1.formatNumericField)(fullRecord.softwareRegNumber, 8), // Field 1006: Software reg number (8)
+        (0, encoder_js_1.formatField)(fullRecord.softwareName, 20, 'left'), // Field 1007: Software name (20)
+        (0, encoder_js_1.formatField)(fullRecord.softwareVersion, 20, 'left'), // Field 1008: Software version (20)
+        (0, encoder_js_1.formatNumericField)(fullRecord.vendorVatId, 9), // Field 1009: Vendor VAT ID (9)
+        (0, encoder_js_1.formatField)(fullRecord.vendorName, 20, 'left'), // Field 1010: Vendor name (20)
+        (0, encoder_js_1.formatNumericField)(fullRecord.softwareType, 1), // Field 1011: Software type (1)
+        (0, encoder_js_1.formatField)(fullRecord.fileOutputPath, 50, 'left'), // Field 1012: File output path (50)
+        (0, encoder_js_1.formatNumericField)(fullRecord.accountingType, 1), // Field 1013: Accounting type (1)
+        (0, encoder_js_1.formatNumericField)(fullRecord.balanceRequired, 1), // Field 1014: Balance required (1)
+        (0, encoder_js_1.formatNumericField)(fullRecord.companyRegId, 9), // Field 1015: Company reg ID (9)
+        (0, encoder_js_1.formatNumericField)(fullRecord.withholdingFileNum, 9), // Field 1016: Withholding file num (9)
+        (0, encoder_js_1.formatField)(fullRecord.reserved1017, 10, 'left'), // Field 1017: Reserved (10)
+        (0, encoder_js_1.formatField)(fullRecord.businessName, 50, 'left'), // Field 1018: Business name (50)
+        (0, encoder_js_1.formatField)(fullRecord.businessStreet, 50, 'left'), // Field 1019: Business street (50)
+        (0, encoder_js_1.formatField)(fullRecord.businessHouseNum, 10, 'left'), // Field 1020: Business house num (10)
+        (0, encoder_js_1.formatField)(fullRecord.businessCity, 30, 'left'), // Field 1021: Business city (30)
+        (0, encoder_js_1.formatField)(fullRecord.businessZip, 8, 'left'), // Field 1022: Business ZIP (8)
+        (0, encoder_js_1.formatNumericField)(fullRecord.taxYear, 4), // Field 1023: Tax year (4)
+        (0, encoder_js_1.formatNumericField)(fullRecord.startDate, 8), // Field 1024: Start date (8)
+        (0, encoder_js_1.formatNumericField)(fullRecord.endDate, 8), // Field 1025: End date (8)
+        (0, encoder_js_1.formatNumericField)(fullRecord.processStartDate, 8), // Field 1026: Process start date (8)
+        (0, encoder_js_1.formatNumericField)(fullRecord.processStartTime, 4), // Field 1027: Process start time (4)
+        (0, encoder_js_1.formatNumericField)(fullRecord.languageCode, 1), // Field 1028: Language code (1)
+        (0, encoder_js_1.formatNumericField)(fullRecord.characterEncoding, 1), // Field 1029: Character encoding (1)
+        (0, encoder_js_1.formatField)(fullRecord.compressionSoftware, 20, 'left'), // Field 1030: Compression software (20)
+        (0, encoder_js_1.formatField)(fullRecord.reserved1031, 0, 'left'), // Field 1031: Reserved (0)
+        (0, encoder_js_1.formatField)(fullRecord.baseCurrency, 3, 'left'), // Field 1032: Base currency (3)
+        (0, encoder_js_1.formatField)(fullRecord.reserved1033, 0, 'left'), // Field 1033: Reserved (0)
+        (0, encoder_js_1.formatNumericField)(fullRecord.branchInfoFlag, 1), // Field 1034: Branch info flag (1)
+        (0, encoder_js_1.formatField)(fullRecord.reserved1035, 46, 'left'), // Field 1035: Reserved (46)
+    ];
+    return (0, encoder_js_1.joinFields)(fields);
+}
+/**
+ * Parses a fixed-width A000 record line back to object
+ * Expected line length: 466 characters (excluding CRLF)
+ */
+function parseA000(line) {
+    // Remove CRLF if present
+    const cleanLine = line.replace(/\r?\n$/, '');
+    if (cleanLine.length !== 466) {
+        throw new Error(`Invalid A000 record length: expected 466 characters, got ${cleanLine.length}`);
+    }
+    let offset = 0;
+    // Extract fields at their fixed positions
+    const code = cleanLine.slice(offset, offset + 4).trim();
+    offset += 4; // Field 1000 (4)
+    const reservedFuture = cleanLine.slice(offset, offset + 5).trim();
+    offset += 5; // Field 1001 (5)
+    const totalRecords = cleanLine
+        .slice(offset, offset + 15)
+        .trim()
+        .replace(/^0+/, '') || '0';
+    offset += 15; // Field 1002 (15)
+    const vatId = cleanLine
+        .slice(offset, offset + 9)
+        .trim()
+        .replace(/^0+/, '') || '0';
+    offset += 9; // Field 1003 (9)
+    const primaryIdentifier = cleanLine
+        .slice(offset, offset + 15)
+        .trim()
+        .replace(/^0+/, '') || '0';
+    offset += 15; // Field 1004 (15)
+    const systemConstant = cleanLine.slice(offset, offset + 8).trim();
+    offset += 8; // Field 1005 (8)
+    const softwareRegNumber = cleanLine
+        .slice(offset, offset + 8)
+        .trim()
+        .replace(/^0+/, '') || '0';
+    offset += 8; // Field 1006 (8)
+    const softwareName = cleanLine.slice(offset, offset + 20).trim();
+    offset += 20; // Field 1007 (20)
+    const softwareVersion = cleanLine.slice(offset, offset + 20).trim();
+    offset += 20; // Field 1008 (20)
+    const vendorVatId = cleanLine
+        .slice(offset, offset + 9)
+        .trim()
+        .replace(/^0+/, '') || '0';
+    offset += 9; // Field 1009 (9)
+    const vendorName = cleanLine.slice(offset, offset + 20).trim();
+    offset += 20; // Field 1010 (20)
+    const softwareType = cleanLine.slice(offset, offset + 1).trim();
+    offset += 1; // Field 1011 (1)
+    const fileOutputPath = cleanLine.slice(offset, offset + 50).trim();
+    offset += 50; // Field 1012 (50)
+    const accountingType = cleanLine.slice(offset, offset + 1).trim();
+    offset += 1; // Field 1013 (1)
+    const balanceRequired = cleanLine.slice(offset, offset + 1).trim();
+    offset += 1; // Field 1014 (1)
+    const companyRegId = cleanLine
+        .slice(offset, offset + 9)
+        .trim()
+        .replace(/^0+/, '') || '';
+    offset += 9; // Field 1015 (9)
+    const withholdingFileNum = cleanLine
+        .slice(offset, offset + 9)
+        .trim()
+        .replace(/^0+/, '') || '';
+    offset += 9; // Field 1016 (9)
+    const reserved1017 = cleanLine.slice(offset, offset + 10).trim();
+    offset += 10; // Field 1017 (10)
+    const businessName = cleanLine.slice(offset, offset + 50).trim();
+    offset += 50; // Field 1018 (50)
+    const businessStreet = cleanLine.slice(offset, offset + 50).trim();
+    offset += 50; // Field 1019 (50)
+    const businessHouseNum = cleanLine.slice(offset, offset + 10).trim();
+    offset += 10; // Field 1020 (10)
+    const businessCity = cleanLine.slice(offset, offset + 30).trim();
+    offset += 30; // Field 1021 (30)
+    const businessZip = cleanLine.slice(offset, offset + 8).trim();
+    offset += 8; // Field 1022 (8)
+    const taxYear = cleanLine
+        .slice(offset, offset + 4)
+        .trim()
+        .replace(/^0+/, '') || '';
+    offset += 4; // Field 1023 (4)
+    const startDate = cleanLine
+        .slice(offset, offset + 8)
+        .trim()
+        .replace(/^0+/, '') || '';
+    offset += 8; // Field 1024 (8)
+    const endDate = cleanLine
+        .slice(offset, offset + 8)
+        .trim()
+        .replace(/^0+/, '') || '';
+    offset += 8; // Field 1025 (8)
+    const processStartDate = cleanLine.slice(offset, offset + 8).trim();
+    offset += 8; // Field 1026 (8)
+    const processStartTime = cleanLine.slice(offset, offset + 4).trim();
+    offset += 4; // Field 1027 (4)
+    const languageCode = cleanLine.slice(offset, offset + 1).trim();
+    offset += 1; // Field 1028 (1)
+    const characterEncoding = cleanLine.slice(offset, offset + 1).trim();
+    offset += 1; // Field 1029 (1)
+    const compressionSoftware = cleanLine.slice(offset, offset + 20).trim();
+    offset += 20; // Field 1030 (20)
+    const reserved1031 = cleanLine.slice(offset, offset + 0).trim();
+    offset += 0; // Field 1031 (0)
+    const baseCurrency = cleanLine.slice(offset, offset + 3).trim();
+    offset += 3; // Field 1032 (3)
+    const reserved1033 = cleanLine.slice(offset, offset + 0).trim();
+    offset += 0; // Field 1033 (0)
+    const branchInfoFlag = cleanLine.slice(offset, offset + 1).trim();
+    offset += 1; // Field 1034 (1)
+    const reserved1035 = cleanLine.slice(offset, offset + 46).trim(); // Field 1035 (46)
+    // Validate the code field
+    if (code !== 'A000') {
+        throw new Error(`Invalid A000 record code: expected "A000", got "${code}"`);
+    }
+    // Validate the system constant field
+    if (systemConstant !== constants_js_1.SHAAM_VERSION) {
+        throw new Error(`Invalid system constant: expected "${constants_js_1.SHAAM_VERSION}", got "${systemConstant}"`);
+    }
+    const parsed = {
+        code,
+        reservedFuture,
+        totalRecords,
+        vatId,
+        primaryIdentifier,
+        systemConstant: constants_js_1.SHAAM_VERSION,
+        softwareRegNumber,
+        softwareName,
+        softwareVersion,
+        vendorVatId,
+        vendorName,
+        softwareType: softwareType,
+        fileOutputPath,
+        accountingType: accountingType,
+        balanceRequired: balanceRequired,
+        companyRegId,
+        withholdingFileNum,
+        reserved1017,
+        businessName,
+        businessStreet,
+        businessHouseNum,
+        businessCity,
+        businessZip,
+        taxYear,
+        startDate,
+        endDate,
+        processStartDate,
+        processStartTime,
+        languageCode: languageCode,
+        characterEncoding: characterEncoding,
+        compressionSoftware,
+        reserved1031,
+        baseCurrency,
+        reserved1033,
+        branchInfoFlag: branchInfoFlag,
+        reserved1035,
+    };
+    // Validate against schema
+    return exports.A000Schema.parse(parsed);
+}

package/dist/cjs/generator/records/a100.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A100InputSchema = exports.A100Schema = void 0;
+exports.encodeA100 = encodeA100;
+exports.parseA100 = parseA100;
+const zod_1 = require("zod");
+const constants_js_1 = require("../../constants.js");
+const key_generator_js_1 = require("../../utils/key-generator.js");
+const index_js_1 = require("../index.js");
+/**
+ * A100 Record Schema - Business opening record
+ * Fields 1100-1105 based on SHAAM 1.31 specification table
+ */
+exports.A100Schema = zod_1.z.object({
+    // Field 1100: Record code (4) - Required - Alphanumeric
+    code: zod_1.z.literal('A100').describe('Record type code - always "A100"'),
+    // Field 1101: Record number in file (9) - Required - Numeric
+    recordNumber: zod_1.z
+        .string()
+        .min(1)
+        .max(9)
+        .regex(/^\d+$/)
+        .describe('Sequential record number in BKMVDATA file'),
+    // Field 1102: Tax ID (9) - Required - Numeric
+    vatId: zod_1.z.string().min(1).max(9).regex(/^\d+$/).describe('VAT identification number'),
+    // Field 1103: Primary identifier (15) - Required - Numeric
+    primaryIdentifier: zod_1.z
+        .string()
+        .min(1)
+        .max(15)
+        .regex(/^\d+$/)
+        .describe('Fixed and unique primary identifier - see Note 2'),
+    // Field 1104: System constant (8) - Required - Alphanumeric - Value: &OF1.31&
+    systemConstant: zod_1.z
+        .literal(constants_js_1.SHAAM_VERSION)
+        .optional()
+        .describe(`System constant - always "${constants_js_1.SHAAM_VERSION}"`),
+    // Field 1105: Reserved field (50) - Optional - Alphanumeric
+    reserved: zod_1.z.string().max(50).default('').describe('Reserved field for future use'),
+});
+/**
+ * A100 Input Schema - for user input (excludes auto-generated fields)
+ * Field 1103 (primaryIdentifier) is automatically generated
+ */
+exports.A100InputSchema = exports.A100Schema.omit({
+    primaryIdentifier: true,
+    code: true,
+    systemConstant: true,
+});
+/**
+ * Encodes an A100 record to fixed-width string format
+ * Total line width: 95 characters + CRLF
+ */
+function encodeA100(input) {
+    const primaryIdentifier = key_generator_js_1.defaultKeyGenerator.getPrimaryIdentifier();
+    const fullRecord = {
+        code: 'A100',
+        primaryIdentifier,
+        systemConstant: constants_js_1.SHAAM_VERSION,
+        ...input,
+    };
+    const fields = [
+        (0, index_js_1.formatField)(fullRecord.code, 4, 'left'), // Field 1100: Record code (4) - Alphanumeric
+        (0, index_js_1.formatNumericField)(fullRecord.recordNumber, 9), // Field 1101: Record number (9) - Numeric, zero-padded
+        (0, index_js_1.formatNumericField)(fullRecord.vatId, 9), // Field 1102: VAT ID (9) - Numeric, zero-padded
+        (0, index_js_1.formatNumericField)(fullRecord.primaryIdentifier, 15), // Field 1103: Primary identifier (15) - Numeric, zero-padded
+        (0, index_js_1.formatField)(constants_js_1.SHAAM_VERSION, 8, 'left'), // Field 1104: System constant (8) - Alphanumeric
+        (0, index_js_1.formatField)(fullRecord.reserved, 50, 'left'), // Field 1105: Reserved (50) - Alphanumeric
+    ];
+    return (0, index_js_1.joinFields)(fields);
+}
+/**
+ * Parses a fixed-width A100 record line back to object
+ * Expected line length: 95 characters (excluding CRLF)
+ */
+function parseA100(line) {
+    // Remove CRLF if present
+    const cleanLine = line.replace(/\r?\n$/, '');
+    if (cleanLine.length !== 95) {
+        throw new Error(`Invalid A100 record length: expected 95 characters, got ${cleanLine.length}`);
+    }
+    // Extract fields at their fixed positions
+    const code = cleanLine.slice(0, 4).trim();
+    const recordNumber = cleanLine.slice(4, 13).trim().replace(/^0+/, '') || '0'; // Strip leading zeros
+    const vatId = cleanLine.slice(13, 22).trim().replace(/^0+/, '') || '0'; // Strip leading zeros
+    const primaryIdentifier = cleanLine.slice(22, 37).trim().replace(/^0+/, '') || '0'; // Strip leading zeros
+    const systemConstant = cleanLine.slice(37, 45).trim();
+    const reserved = cleanLine.slice(45, 95).trim();
+    // Validate the code field
+    if (code !== 'A100') {
+        throw new Error(`Invalid A100 record code: expected "A100", got "${code}"`);
+    }
+    // Validate the system constant field
+    if (systemConstant !== '&OF1.31&') {
+        throw new Error(`Invalid system constant: expected "&OF1.31&", got "${systemConstant}"`);
+    }
+    const parsed = {
+        code,
+        recordNumber,
+        vatId,
+        primaryIdentifier,
+        systemConstant: '&OF1.31&', // Always use the literal constant
+        reserved,
+    };
+    // Validate against schema
+    return exports.A100Schema.parse(parsed);
+}