送り状CSV — Shopify向け配送データ生成アプリ
Shopifyの未発送注文からヤマトB2クラウド用の送り状CSVを生成するShopifyアプリ。
都道府県コード変換・姓名並べ替え・Shift_JIS変換・97列固定形式に対応。
Duration
短期開発
Team
1名
01 // OVERVIEW
プロジェクト概要
海外製配送アプリが日本の住所・氏名形式に対応していない問題を解決するShopifyアプリ。
Shopifyが返す都道府県ローマ字コードを日本語名に変換し、名→姓の順を姓→名に並べ替え、UTF-8をShift_JISに変換し、ヤマトB2クラウドが要求する97列固定・CRLF形式のCSVを生成する。
二重出力防止の履歴管理機能も備える。
02 // KEY FEATURES
主な機能
日本仕様の住所・氏名変換
Shopifyの`provinceCode`（例: JP-27）から都道府県名（大阪府）を引き直し、`name`フィールドの名→姓の順を姓→名に並べ替える。iconv-liteでUTF-8からShift_JISに変換し、97列固定・CRLF形式で出力する。
ヤマトB2クラウド対応CSV生成
使用しない列も空で埋めて97列を維持するフォーマット制御を実装。公式仕様書（97列）と第三者サイト（85列）の差異を確認した上で正確な実装を行っている。
二重出力防止と履歴管理
出力した注文をExportedOrderテーブルに記録し、一覧では既定で伏せることで同じ注文の送り状が二枚出力されるのを防ぐ。記録の削除で出し直しも可能。
03 // TECHNICAL DEEP-DIVE
技術的ハイライト
Solution
保護対象の顧客データへのアクセス申請
Shopifyの注文APIで氏名・住所・電話を取得するには「保護対象の顧客データ」のアクセス申請が必須で、開発ストアでも例外なく適用される。Partner Dashboardからの申請手順を整備し、審査通過を前提とした実装フローとした。
04 // IMPACT & RESULTS
成果
97列
ヤマトB2クラウドの仕様に完全準拠
Shift_JIS
日本語文字コードに自動変換
二重防止
出力済み注文を自動で管理