@accounter/shaam-uniform-format-generator
Version:
Fully typed application that generates, parses, and validates SHAAM uniform format tax reports (INI.TXT and BKMVDATA.TXT).
83 lines (82 loc) • 3.39 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.Z900Schema = void 0;
exports.encodeZ900 = encodeZ900;
exports.parseZ900 = parseZ900;
const zod_1 = require("zod");
const index_js_1 = require("../format/index.js");
const constants_js_1 = require("../constants.js");
/**
* Helper function to format a field with specified width and alignment
*/
function formatField(value, width, align) {
if (align === 'left') {
return (0, index_js_1.padRight)(value, width);
}
return (0, index_js_1.padLeft)(value, width);
}
/**
* Z900 Record Schema - Closing record
* Fields 1150-1156 based on SHAAM 1.31 specification
*/
exports.Z900Schema = zod_1.z.object({
code: zod_1.z.literal('Z900').describe('Record type code - always "Z900"'),
recordNumber: zod_1.z.string().min(1).max(9).describe('Sequential record number'),
vatId: zod_1.z.string().min(1).max(9).describe('VAT identification number'),
uniqueId: zod_1.z.string().min(1).max(15).describe('Unique business identifier'),
totalRecords: zod_1.z.string().min(1).max(15).describe('Total number of records in file'),
reserved: zod_1.z.string().max(50).default('').describe('Reserved field for future use'),
});
/**
* Encodes a Z900 record to fixed-width string format
* Total line width: 110 characters + CRLF
*/
function encodeZ900(input) {
const fields = [
formatField(input.code, 4, 'left'), // Field 1150: Record code (4)
formatField(input.recordNumber, 9, 'right'), // Field 1151: Record number (9)
formatField(input.vatId, 9, 'left'), // Field 1152: VAT ID (9)
formatField(input.uniqueId, 15, 'left'), // Field 1153: Unique ID (15)
formatField(constants_js_1.SHAAM_VERSION, 8, 'left'), // Field 1154: SHAAM version (8)
formatField(input.totalRecords, 15, 'right'), // Field 1155: Total records (15)
formatField(input.reserved, 50, 'left'), // Field 1156: Reserved (50)
];
return fields.join('') + index_js_1.CRLF;
}
/**
* Parses a fixed-width Z900 record line back to object
* Expected line length: 110 characters (excluding CRLF)
*/
function parseZ900(line) {
// Remove CRLF if present
const cleanLine = line.replace(/\r?\n$/, '');
if (cleanLine.length !== 110) {
throw new Error(`Invalid Z900 record length: expected 110 characters, got ${cleanLine.length}`);
}
// Extract fields at their fixed positions
const code = cleanLine.slice(0, 4).trim();
const recordNumber = cleanLine.slice(4, 13).trim();
const vatId = cleanLine.slice(13, 22).trim();
const uniqueId = cleanLine.slice(22, 37).trim();
const systemCode = cleanLine.slice(37, 45).trim();
const totalRecords = cleanLine.slice(45, 60).trim();
const reserved = cleanLine.slice(60, 110).trim();
// Validate the code field
if (code !== 'Z900') {
throw new Error(`Invalid Z900 record code: expected "Z900", got "${code}"`);
}
// Validate the SHAAM version field
if (systemCode !== constants_js_1.SHAAM_VERSION) {
throw new Error(`Invalid SHAAM version: expected "${constants_js_1.SHAAM_VERSION}", got "${systemCode}"`);
}
const parsed = {
code,
recordNumber,
vatId,
uniqueId,
totalRecords,
reserved,
};
// Validate against schema
return exports.Z900Schema.parse(parsed);
}