fbp-yamato-csv

name: fbp-yamato-csv description: Implement or maintain Yamato Transport B2送り状 CSV export in FBP apps, including the Yamato shipping origin/settings note, B2 basic layout column order, db_additionals export dialogs, Shift_JIS CSV output, cool/frozen row splitting, and delivery address validation.

fbp-yamato-csv

trigger conditions

• ヤマト運輸 / クロネコヤマト / Yamato B2 の送り状CSVを出力する。
• 「配送元情報」「ヤマト配送情報」ノートを作る、または項目を確認する。
• B2基本レイアウトのCSV列順、出力値、Shift_JIS/CRLF、クール区分を扱う。

companion skills

• fbp-csv-media: CSV download実装と検証。
• fbp-db: yamato_shipping_setting のDB/項目追加。
• fbp-standard-screen + fbp-dialog: 受注画面上部の db_additionals ボタンとプレビューダイアログ。
• fbp-cli: db_tables_list / db_fields_list / screen_fields_list / app_call 検証。

shipping settings note

単純マスタなので Standard Screen でよい。配送元情報ノート名は、実装上は次を基本にする。

• table: yamato_shipping_setting
• menu_name: ヤマト配送情報
• description: ヤマトB2 CSV出力用の発送元・請求先設定
• show_menu=1, screen_build_type=0, dropdown_item=name, show_id=1

項目:

画面項目:

• list: name, billing_customer_code, fare_management_number, shipper_name
• add/edit: 全項目

export dialog

受注画面の上部ボタンにする。

• db_additionals.tb_name: customer_order
• button_title: ヤマトCSV出力
• class_name: <order_table>_yamato_csv_additional
• function_name: run
• place=0, close_button=2, dialog_width=1000

プレビューでは対象件数、配送先、住所、配送方法を表示し、yamato_shipping_setting を選択させる。出荷予定日はCSV出力時に入力する。

<button type="button" class="download-link"
  data-class="customer_order_yamato_csv_additional"
  data-function="download_csv_exe"
  data-filename="yamato_export.csv">CSVダウンロード</button>

target orders

appごとにステータス値は調整する。今回の運用では次を配送CSV対象にした。

• customer_order.delivery_type == 0: 配送。店頭受取は除外。
• customer_order.order_status == 4: 発送準備済み。

配送先側に最低限必要な項目:

• shipping_name
• shipping_tel
• shipping_zip
• shipping_prefecture
• shipping_address
• 任意: gift_memo

B2 basic layout

B2基本レイアウトは95列固定。array_fill(0, 95, "") で空行を作り、必要列だけ埋める。列番号はヤマト仕様上は1始まり、PHP配列は0始まりなのでずれに注意する。

全ヘッダ順は references/yamato-b2-basic-layout.md を読む。

主な出力列:

temperature splitting

受注明細の配送方法が冷凍/冷蔵で混在する場合は、1受注を温度帯別に複数CSV行へ分割する。

• 冷凍: customer control no suffix F, クール区分1
• 冷蔵/クール: customer control no suffix R, クール区分2
• 温度帯が1種類だけなら管理番号は受注IDのみ。
• 明細がない場合は冷蔵扱いで1行出す。

validation and formatting

• yamato_shipping_setting 未選択、出荷予定日なし、対象受注なしはCSV出力前に止める。
• ヤマトB2は配送先都道府県が実質必須。prefecture_opt のラベルを shipping_address の先頭へ連結する。住所がすでに都道府県から始まる場合は二重連結しない。
• shipping_address 空、都道府県未設定かつ住所先頭にも都道府県がない受注は出力前にエラーにする。
• 改行、タブはスペースへ正規化する。
• 名称や記事は mb_strimwidth() でバイト幅上限に丸める。

CSV response

ヤマトB2向けは Shift_JIS / CRLF 固定にする。

while (ob_get_level() > 0) {
    ob_end_clean();
}
header("Content-Type: text/csv; charset=Shift_JIS");
header("Content-Disposition: attachment; filename=\"yamato_export_" . date("Ymd") . ".csv\"");
$ctl->res_csv($headers, "sjis-win", "\r\n");
foreach ($rows as $row) {
    $ctl->res_csv($row, "sjis-win", "\r\n");
}
exit;

download-link のエラーは通常のHTML再描画ではなく、HTTP 400 + JSONで返す。

header("Content-Type: application/json; charset=UTF-8");
header("X-FBP-Download-Error: 1");
header("X-FBP-Download-Error-Title: " . rawurlencode("CSV出力エラー"));
echo json_encode(["title" => "CSV出力エラー", "message" => $message], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
exit;

verification

• php -l for additional class PHP.
• php <app-root>/fbp/cli.php db_tables_list
• php <app-root>/fbp/cli.php db_fields_list --json='{"db_id":<yamato_shipping_setting db_id>}'
• php <app-root>/fbp/cli.php screen_fields_list --json='{"tb_name":"yamato_shipping_setting","screen_name":"list"}'
• php <app-root>/fbp/cli.php app_call --json='{"class":"customer_order_yamato_csv_additional","function":"run"}'
• CSV downloadはCLIの output_file で保存し、ヘッダ列数が95、文字コードがShift_JIS、改行がCRLFであることを確認する。