Japan Zengin Domestic Transfer File Generator
Build bank-ready 120-byte Zengin (全銀協規定フォーマット) transfer files - 総合振込 / 給与振込 / 賞与振込 - with automatic half-width kana name encoding. No gateway, no per-transaction fees, your data never leaves your database.
Upload directly to your bank's portal
Japanese banks accept payment instructions through the Zengin (全国銀行協会, Zengin-kyokai) fixed-width file format. This module turns the vendor payments, payroll or bonus runs you already manage in Odoo into a clean, validation-passing Zengin text file that you upload to your bank's cash-management portal. The format and encoding are produced entirely inside your database - nothing is transmitted to any third-party service.
Key features
120-byte fixed-width records
A complete file with a Header (ヘッダーレコード, データ区分 1), one Data record (データレコード, 2) per beneficiary, a Trailer (トレーラーレコード, 8) carrying the independent control totals, and an End record (エンドレコード, 9) - every record exactly 120 single-byte characters, padded to the published JBA column positions.
Half-width kana name encoding
Requestor, bank, branch and payee names are converted to the legal Zengin half-width katakana (半角カナ) character set automatically. Full-width katakana, hiragana and latin input are folded down; voiced and semi-voiced syllables (ガ, パ, ヴ) are decomposed into base kana plus the trailing ﾞ / ﾟ mark, exactly as the JIS half-width code page requires.
Three transfer kinds
Produce General / Accounts-Payable transfers (総合振込, 種別コード 21), Salary transfers (給与振込, 11) and Bonus transfers (賞与振込, 12) from the same screen - the kind code is written into the header and the bank routes the file accordingly.
Whole-yen amounts & control totals
Amounts are handled as whole yen (the Japanese yen has no minor unit in domestic transfers) and the trailer's total count and total value are computed exactly as the receiving bank re-derives them, so the file clears validation on the first upload.
Build from vendor bills
A one-click wizard turns selected posted vendor bills into a ready Zengin batch, grouping the amounts due per payee and pulling the bank code, branch code and account number from each vendor's bank account.
Bank-code validation & download
The 4-digit bank code (金融機関番号), 3-digit branch code (支店番号) and 7-digit account number (口座番号) are validated on the bank record and every entry, with well-known Japanese banks labelled automatically. The finished file downloads as a Shift_JIS text file ready for upload, with an in-app preview and full chatter audit trail.
Record layout
| Record | Division (データ区分) | Length | Carries |
|---|---|---|---|
| Header (ヘッダーレコード) | 1 | 120 bytes | Kind code, requestor code/name, transfer date, origin bank/branch and charge account. |
| Data (データレコード) | 2 | 120 bytes | Destination bank/branch, deposit type, account number, payee name (kana), amount, customer codes. |
| Trailer (トレーラーレコード) | 8 | 120 bytes | Total record count and total yen amount. |
| End (エンドレコード) | 9 | 120 bytes | File-end marker. |
Deposit & transfer codes
| Field | Codes |
|---|---|
| Transfer kind (種別コード) | 21 General / 11 Salary / 12 Bonus |
| Deposit type (預金種目) | 1 Ordinary / 2 Checking / 4 Savings / 9 Other |
| New code (新規コード) | 0 Unchanged / 1 First time / 2 Account changed |
| Transfer method (振込区分) | 7 Telegraphic / 8 Document |
How it works
- Enter your requestor code/name and origin bank, branch and charge account once in Settings.
- Add the Zengin bank code, branch code, deposit type and kana name on each payee's bank account.
- Create a transfer batch (or build one from posted vendor bills) and add the beneficiary entries.
- Click Generate Zengin File, review the in-app preview, then Download and upload the file to your bank.
Disclosure
This module only builds the Zengin transfer text file for you to upload to your own bank. It transmits nothing to any external service and does not act as a certified intermediary. Compatible with Odoo 18 and Odoo 19, Community and Enterprise.
Screenshots
Transfer Batches
Build From Bills
Update date: 2026-07-02