物流会社を経営している、ちゃごです。社内システムは AI(Claude)にコードを書かせて自分で作っています(全記録はこちら)。
この記事は、NACCS(輸出入・港湾関連情報処理システム)の電文を全部ためて、貨物とコンテナが「いまどの段階か」を自動で出す台帳を作った話です。保税の倉庫で輸出貨物を扱っている会社向けの、かなり狭い話です。
困っていたこと
うちは保税地域で輸出貨物を扱っています。搬入の予定、搬入確認、輸出許可、バンニング(コンテナ積み)、搬出。その一つ一つが NACCS の電文として届きます。
- 電文は netNACCS の端末にテキストファイルでたまっていく。でも、「この貨物はいまどこまで進んだか」を見るには、電文を1つずつ開くしかない
- 以前、社内のシステムに NACCS の管理画面を作っていたが、取り込みが不安定だった。項目が落ちる、貨物と紐付かない、同じ電文が二重に入る
- しかも受注と紐付けるのが前提の作りで、紐付けないと使いにくかった
そこで、受注とは切り離した単独のアプリとして1から作り直しました。
決めた方針:電文が正
- 電文は全件、そのまま保存する。1件1行。中身が同じものは重複として弾く
- 貨物とコンテナの台帳は、電文から何度でも計算し直す。台帳を手で直すことはしない
- 人が書くのは「メモ」と「隠す」だけ。これは計算し直しても残る
- 元の電文ファイルは動かさない、消さない
前のシステムは、取り込むときに読み取った結果だけを保存していました。読み間違えると、元に戻れません。原文を残して、台帳はそこから作る形にしたことで、読み方を直せば過去の分も全部正しくなります。
状態の決め方
貨物(輸出管理番号ごと)の状態は、届いた電文の組み合わせで決めます。強いものから順に見ていきます。
| 状態 | 決め手になる電文 |
|---|---|
| 取消 | 取消の通知 |
| 搬出済 | 搬出確認(BOC) |
| バンニング済 | バンニング登録の完了(VAE、または紐付くコンテナの VAN) |
| バンニング情報受信 | バンニング情報(SAT1081)が来て、登録待ち |
| 許可済 | 輸出許可通知 |
| 搬入済 | 搬入確認(BIC) |
| 搬入予定 | 搬入予定の情報(SAT0051) |
うちでは「バンニング登録をしたら完了」と決めました。搬出は記録として残すだけです。
あわせて、「止まっている貨物」を注意として出すようにしました。搬入日を過ぎたのに搬入確認が無い、搬入から何日も許可が来ない、出港が近いのにバンニングしていない、など。何日で注意にするかは、設定で変えられます。
読み取りで分かったこと(前のシステムの誤りも)
電文の1行目は、決まった桁数で区切られたヘッダーです(業務の種類、業務コード、日時、番号など)。2行目からは、1行に1項目。日本語が入っていると Shift_JIS です。
- バンニング情報(SAT1081)の混載は「9行で1組」の繰り返し(B/L、輸出管理番号、区分、個数、荷姿、重量、単位、容積、単位)。前のシステムは8行と思い込んでいて、2件目以降の貨物を全部落としていました。取り込みが不安定だった原因の一つです
- 搬入予定の情報(SAT0051)には、自社の整理番号が入る行がある。受注とつなぐなら、この番号が使える
- 処理履歴の電文(SAL0261)には、搬入・許可などの処理の履歴が「業務・利用者・日付・時刻」の4行1組で入っている。手元に電文が無い時期の搬入確認も、ここから補える
- 検査の通知(SAE4771)も拾うようにした。検査に回った貨物は、すぐ分かるようにしている
読み取りを「型」で確かめる
行の位置で値を取るやり方は、電文の形が少し違うだけで、別の値を読んでしまいます。そこで、読んだ値が「それらしい形」かを確かめるようにしました。
- 輸出管理番号は「6で始まる10桁」、コンテナ番号は「英字4文字+数字7桁」、日付は8桁
- 形が合わなければ捨てて、電文の全行から形の合うものを探し直す
- それでも見つからない項目は「要確認」として残す。黙って落とさない
- 知らない業務コードの電文も、番号だけ拾って保存しておく
サンプルが1件しかなく、行の位置が確かめられない電文もあります。それは無理に読まず、「要確認」で保存しています。
保税台帳(管理資料の CSV)も重ねた
NACCS からは、搬出入の記録を管理資料として CSV で取り出せます。毎週取り出しているこの CSV が、事実上の電子台帳になっていました。これも取り込んで、電文から作った台帳に重ねています。
- この CSV は「在庫一覧」ではなく「搬出済みの記録」。全行に搬出日がある
- 同じ貨物が何週分も出てくるので、行の中身で重複を弾く
- 搬入日・搬出日・許可番号・荷送人などを、電文の台帳に補う
画面
- ボード:段階ごとの4列のカード、2週間のタイムライン、月別の搬出件数
- 今日:いま動いている貨物を「次にやること」別に。最初の画面は情報が多すぎて「何を見たらいいか分からない」と言われたので足した
- 貨物:状態・検索・コンテナでまとめる。詳細を開くと、その貨物の電文の流れと原文が見られる
- 週次まとめ:期間を指定すると、電文から件数・重量・容積を集計して、そのまま貼れる文章と表を作る
結果
手元の約1年分を取り込んだところ、電文1,125件のうち、読み取れなかったのは4件(要確認として保存)。貨物616件、コンテナ249本の台帳ができました。最初の取り込みは、共有ドライブからファイルを1件ずつ取ってくるので15分ほどかかりましたが、2回目からは新しい分だけなので一瞬です。
今はまだ私の PC の中で動かしている段階で、netNACCS の端末から自動で電文を持ってくる仕組みと、サーバーへの設置が残っています。
作ってみて思うこと
- 原文を残す。読み取った結果だけを残すと、読み方の間違いを直せない
- 読んだ値は形で確かめる。行の位置だけを信じない
- 落とした項目は、黙って捨てずに「要確認」で見せる
- 前のシステムのコードは、正しいとは限らない。「9行1組」を「8行」と読んでいたのは、作り直して初めて分かった
NACCS の電文の仕様は、業界の外にはほとんど情報がありません。AI もそれは同じで、実物の電文を何百件も読ませて、形を確かめながら作りました。業務コードの名前など、推定で付けているところもあります。
ほかに作ったものは「作ったもの」にまとめています。

コメント