なぜ難しいか
相手のシステムが読める形でなければ、1 件も届きません。CSV の基本の決まりは業務システムの設計「CSV と外部とのつなぎ」にあるので、ここでは帳票の作りと、受け渡しを仕様書に落とす所を見ます。
帳票(PDF)の設計
請求書・納品書・見積書・支払の通知などです。書く事項(適格請求書の記載事項)は販売管理の決まりにあります。ここでは、改ページ・合計と端数・写しと再発行・版・印影を、作る側から見ます。下の道具は、販売管理のタブと同じ 10 月の納品(作り物)の請求書です。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 が速く書きます。桁と文字コードと照合の決まりは、テストと仕様書で守ります。
チェックリスト
帳票と受け渡しの仕組みを見直したら、チェックを付けてください(この端末にだけ残ります)。考え方のヒント