Field Map中堅エンジニアの地図

外に出す書類(帳票)と、ほかの会社のシステムとのデータの受け渡しです。
形と文字と運用を先に決めて、仕様書に書きます。帳票の改ページ・文字化けの見分け・全銀協の固定長のレコード・二重の取り込みの照合を押して試します。

なぜ難しいか

相手のシステムが読める形でなければ、1 件も届きません。CSV の基本の決まりは業務システムの設計「CSV と外部とのつなぎ」にあるので、ここでは帳票の作りと、受け渡しを仕様書に落とす所を見ます。

帳票(PDF)の設計

請求書・納品書・見積書・支払の通知などです。書く事項(適格請求書の記載事項)は販売管理の決まりにあります。ここでは、改ページ・合計と端数・写しと再発行・版・印影を、作る側から見ます。下の道具は、販売管理のタブと同じ 10 月の納品(作り物)の請求書です。1 ページの行数と税額の出し方を変えてください。

1 ページの行数

税額の出し方

Excel で開かれるとき

CSV を渡すと、相手はダブルクリックで Excel で開くことが多いです。Excel は、開くときに値を変えることがあります。見え方を切り替えて、セルを押してください。変わり方は Microsoft と OWASP の説明にあるものです。

文字と形式

文字コードの基本と、Excel で CSV が文字化けする話は、新人向けの Stack Map「つまずきやすい点」(文字)にあります。ここでは、取引先との受け渡しで「何を決めて、仕様書に書くか」を見ます。

仕様書に書くこと 考え方のヒント

練習: 文字化けを見て、取り違えを当てる

取引先とのやり取りで起きた場面です(作り物)。見え方は、このブラウザの文字の変換で、その場で作っています。原因を選んでください。

全銀協の形式(固定長のレコード)

銀行に振込を頼むファイルの形は、全国銀行協会が決めています(13 版・令和 8 年 10 月)。振込の流れは銀行「振込の流れ」に、名義のカナの道具は銀行「落とし穴」にあり、ここでは総合振込のレコードの作りを読みます。

試す: データ・レコードを組み立てる・読む

あおば商事(作り物)が、11 月 10 日に経費を振り込むファイルです。銀行(こもれび銀行・あけぼの銀行)と、支店・口座の番号は作り物です。組み立てると 120 バイトの 1 行ができ、読むと項目ごとに分けて確かめます。

ファイル全体(ヘッダー・データ 3 件・トレーラ・エンド)

EDI(企業の間のデータ交換)

業界ごとに、データの書き方と通信の決まりの標準があります。取引先に合わせて 1 社ずつ作るより、標準に乗るほうが、相手が増えても作り直しが減ります。

API・Webhook とファイルの比べ方 考え方のヒント

API と Webhook の基本は Stack Map「API の種類を比べる」に、同じ知らせが 2 回届くときの受け方は決済「通知(Webhook)」にあります。ここでは、業務のデータの受け渡しに、どれを選ぶかを比べます。

練習: どれで受け渡すか

受け渡しの運用(時刻・送り直し・二重・照合・取り消し)

形が合っても、運用で事故が起きます。みどり文具センター(作り物)から、注文のファイルが毎日届きます(11 月の例)。1 つずつ「取り込む」か「止めて確かめる」かを選ぶと、取り込んだ注文の台帳が変わります。

受け渡しの仕様書 考え方のヒント

上の注文のファイルの仕様書の下書き(作り物)です。決まっていない・足りない項目を押して選び、「答え合わせ」を押してください。要件の聞き方は要件を決める「聞き方」へ。

    落とし穴

    帳票と受け渡しで、よく起きることです。

    AI 時代の帳票と外部連携

    パーサーや変換のコードは、AI が速く書きます。桁と文字コードと照合の決まりは、テストと仕様書で守ります。

    チェックリスト

    帳票と受け渡しの仕組みを見直したら、チェックを付けてください(この端末にだけ残ります)。考え方のヒント