hashavshevet-data-tools
Hashavshevet Data Tools
Instructions
Important: use the official OPENFORMAT/BKMV export, not direct binary parsing.
Hashavshevet does NOT publish public per-byte offsets for its internal
.dat/.hsh/.mdbfiles. The publicly documented and ITA-mandated export from any Israeli bookkeeping software is OPENFORMAT (קובץ אחיד / BKMV). The export produces a ZIP of three files:INI.TXT(production summary, holds the leadingA000record plus per-record-type control-count summary records),BKMVDATA.TXT(the business data, with oneA100opening record, thenC100,D110,D120,B100,B110,M100records, then oneZ900closing record), andREADME.TXT(general production details for the user). OnlyINI.TXTandBKMVDATA.TXTare sent to the ITA or the CPA. Spec: https://www.misim.gov.il/TmbakmmsmlNew/Files/horaot_131.pdf. Hashavshevet's BKMV export guide: https://downloads.h-erp.co.il/files/general/bkmv7-erp.pdf. Validate output against the ITA simulator: https://www.misim.gov.il/TmbakmmsmlNew/frmCheckFiles.aspx.The fixed-width column maps below (HESHIN_COLUMNS / PKUDOT_COLUMNS) are best-guess heuristics for legacy Windows installations, not authoritative specifications. Use them only as a fallback when no OPENFORMAT export is available; never claim them as the canonical Hashavshevet format. For any ITA filing, CPA handoff, or PCN874 / Form 6111 generation, export via OPENFORMAT instead.
Hashavshevet בענן (H-WEB / Wizcloud) public REST API. The cloud version of Hashavshevet exposes a public REST API for documents, accounts, and transactions: https://home.wizcloud.co.il/help/apidocument/. Use this for ongoing two-way sync with Green Invoice / Rivhit / iCount instead of one-shot file dumps where possible.
SHAAM allocation-number context (2026). Sales-invoice journal entries created/imported through Hashavshevet for B2B amounts at or above the current threshold must carry an allocation number (mispar haktza'a). Threshold (VAT excluded): NIS 10,000 since January 2026. NIS 5,000 since 1 June 2026. An above-threshold tax invoice WITHOUT a valid allocation number cannot be used by the counterparty to deduct input VAT, so treat a missing allocation number as a hard validation error, not a soft "incomplete" warning. Hashavshevet בענן has built-in real-time SHAAM integration; the Windows version may need a separate workflow.
Step 1: Identify the Hashavshevet version and file format
Determine which version of Hashavshevet the user is working with and identify the relevant file formats: