NACCS の電文を全部ためて、輸出貨物とコンテナの状態を自動で出す台帳を作った

物流会社を経営している、ちゃごです。社内システムは 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 の端末から自動で電文を持ってくる仕組みと、サーバーへの設置が残っています。

作ってみて思うこと

  1. 原文を残す。読み取った結果だけを残すと、読み方の間違いを直せない
  2. 読んだ値は形で確かめる。行の位置だけを信じない
  3. 落とした項目は、黙って捨てずに「要確認」で見せる
  4. 前のシステムのコードは、正しいとは限らない。「9行1組」を「8行」と読んでいたのは、作り直して初めて分かった

NACCS の電文の仕様は、業界の外にはほとんど情報がありません。AI もそれは同じで、実物の電文を何百件も読ませて、形を確かめながら作りました。業務コードの名前など、推定で付けているところもあります。

ほかに作ったものは「作ったもの」にまとめています。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

コメント

コメントする

目次