掲載日：2023年11月01日
アップロード用ファイルを作成する
このページでは、注文処理実績アップロードでアップロードするアップロードファイル（CSVファイル）の作成方法を説明します。アップロードファイルはテキストエディター（メモ帳、MKエディタなど）や表計算ソフト（エクセルなど）で編集します。
| ◆Yahoo!オークション併売商品の場合 | |
| Yahoo!オークション併売商品の注文処理は「注文管理［Yahoo!オークション併売］」も併せてご確認ください。 |
※本マニュアルの掲載内容は、予告なく変更される場合があります。
※システム仕様に変更があった場合は、「ストアクリエイターPro」トップページでお知らせいたします。「ストアクリエイターPro」トップページを頻繁にご覧になることをおすすめいたします。
注文処理実績アップロードファイルのフィールド一覧
注文アップロードファイルのフィールドの内容と入力ルールなどは以下のとおりです。
- 重要注文処理実績アップロードファイル作成時の注意事項
- ファイル形式は、必ずCSV形式にしてください。
- データの1行目のフィールド名（半角英数字）は正確に入力してください。
- 半角カナ、特殊記号、機種依存文字は入力できません。また、各項目ごとに入力可能文字種が異なりますのでご注意ください。
- 改行コードはCR+LFに変換してください。
- 文字コードは必ずshift-JISコードに変換してください。
- アップロード前に、データに不要な改行やスペースが含まれていないかを確認ください。MKエディタなど、文字制御コードが表示されるテキストエディターを使用すると確認が容易です。
- 必須となっている項目はフィールドとして省略不可能な項目です。
- 参照ツールマニュアル
- ファイルの作成例について>>「注文処理実績アップロードファイルの作成例」
- アップロードファイルの作成について>>「アップロードファイルを作成する」
- 注文処理実績をアップロード>>「注文処理実績をFTPでアップロードする」
|
注文情報更新ファイル
| ファイル名 | odstats_order.csv |
|---|---|
| 形式 | CSV |
| 文字コード | Shift_JIS |
| 改行 | CR+LF |
| フィールド名 | 名称 | 必須 | 内容 | 最大長 | サンプル | |
|---|---|---|---|---|---|---|
| OrderId | 注文ID | ○ | 該当注文の注文IDを指定。 | 10バイト | 最大 | 9999999999 |
| OrderStatus | 注文ステータス | 更新したい注文ステータス（出荷や入金ステータスではない）を指定。 予約中、処理中、保留、完了、キャンセル のいずれかの文字列を指定する。 |
10バイト | 最大 | 完了 | |
| ShipMethod | お届け方法 | 「postage2」などのお届け方法キーを指定します。 お届け方法キーはカート設定ツールで配送方法を設定した際に付与されます。 |
9バイト | 最大 | postage2 | |
| ShipCompanyCode | 配送会社 | 配送会社コード一覧に記載の4桁の値を入力します。（*1） |
4バイト | 1001 | ||
| ShipInvoiceNumber1 | 配送伝票番号1 | 配送会社の送り状NOを指定します。半角英数字とハイフンのみ。半角30文字。 | 30バイト | 最大 | 9999-9999-9999-9999 | |
| ShipInvoiceNumber2 （*2） |
配送伝票番号2 | 配送会社の送り状NOを指定します。半角英数字とハイフンのみ。半角30文字。 | 30バイト | 最大 | 9999-9999-9999-9999 | |
| ShipInvoiceNumberEmptyReason | 配送伝票番号なし理由 | 配送伝票番号がない理由を以下から選択指定します。 101：メーカー等の在庫元からの直送品のため 102：発送不要の商品のため 103：店頭受け取り商品のため 104：配送会社から直接ご連絡のため 105：伝票番号が発行されない（追跡できない）配送方法のため |
3バイト | 最大 | 105 | |
| ShipUrl | 配送会社URL | 配送会社の荷物追跡用URL | 100バイト | 最大 | http～ | |
| ShipDate | 出荷日 | yyyy/mm/dd 形式で指定。yyyy-mm-dd もしくはyyyymmdd でも可。 | 10バイト | 最大 | 2014/01/01 | |
| ShipCharge | 送料 | 変更したい金額を指定。半角数字。 （完了、保留、キャンセル時は変更NG） |
10バイト | 最大 | 500 | |
| PayCharge | 手数料 | 変更したい金額を指定。半角数字。 （完了、保留、キャンセル時は変更NG） |
10バイト | 最大 | 210 | |
| GiftWrapCharge | ギフト包装料 | 変更したい金額を指定。半角数字。 （完了、保留、キャンセル時は変更NG） |
10バイト | 最大 | 100 | |
| Discount | 値引き | 変更したい金額を指定。半角数字。 （完了、保留、キャンセル時は変更NG） |
10バイト | 最大 | 500 | |
| ShipStatus | 出荷ステータス | 1：出荷可 2：出荷処理中 3：出荷完了 4：着荷完了 |
1バイト | 最大 | 4 | |
| PayStatus | 入金ステータス | 0:入金待ち 1:入金済み |
1バイト | 最大 | 1 | |
| StoreStatus | ストアカスタムステータス | 1～10 | 2バイト | 最大 | 4 | |
| Suspect | いたずら解除注文 | いたずら解除時のみ指定可能 2：悪戯解除済注文 |
1バイト | 最大 | 2 | |
| CancelReason | キャンセル理由 |
▼注文者都合 100:キャンセル 110:返品 120:未入金 130:住所不明 140:受取拒否 150連絡不通 160重複注文 170決済審査不可 180その他 ▼ストア都合 200:決済方法都合 210:欠品 220:販売中止 230:その他 ※値なしの場合、お客様への自動キャ ンセルメールに「ストア都合：欠品」と記載されます。 |
3バイト | 最大 | 230 | |
| CancelReasonDetail | キャンセル理由詳細 | ○ （*3） |
注文キャンセル時に 入力した理由を表示 |
200文字 | 最大 | 天災により商品をお届けすることができなくなったためキャンセル |
| Adjustments | 調整額 | 調整額の入力したい数字を入力 「-200」等と表示 |
10バイト | 最大 | -200 | |
（*1）「お届け方法（ShipMethod）」、「配送会社（ShipCompanyCode ）」を同時に変更すると、設定によっては意図しない「配送会社」となる場合があります。詳細はこちらをご参照ください。
（*2）「配送伝票番号2（ShipInvoiceNumber2）」で登録した内容は、「注文管理画面」から確認できません。注文データ（CSV形式）をダウンロードすることで確認できます（マニュアル）。詳細はよくある質問をご参照ください。
また、Yahoo!デベロッパーネットワークで開発者様向けに提供している注文詳細APIでも確認可能です。
（*3）「フィールド名：CancelReasonDetail」は、「フィールド名：CancelReason」で「ストア都合 その他（230）」を選択の場合、入力が必須です。10～200文字の理由詳細を入力ください。
- キャンセル理由「ストア都合 その他（230）」のみ理由を入力できます。
- 「フィールド名：CancelReasonDetail」の内容はお客様へ配信される「自動キャンセルメール」に表記されます。
- お客様の個人情報は記載しないようお願いします。
項目設定パターン
| フィールド名 | 名称 | 注文 ステータス 更新時 |
出荷 ステータス 更新時 |
入金 ステータス 更新時 |
金額変更 | いたずら 注文 解除時 |
|---|---|---|---|---|---|---|
| OrderId | 注文ID | 必須 | 必須 | 必須 | 必須 | 必須 |
| OrderStatus | 注文ステータス | 必須 | 更新不可 | 更新不可 | 更新不可 | 更新不可 |
| ShipMethod | お届け方法 | 更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| ShipCompanyCode | 配送会社 | 更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| ShipInvoiceNumber1 | 配送伝票番号1 | 更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| ShipInvoiceNumber2 | 配送伝票番号2 | 更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| ShipInvoiceNumberEmptyReason | 配送伝票番号なし理由 | 更新可能 | 更新可能 | 更新可能 | 更新不可 | 更新不可 |
| ShipUrl | 配送会社URL | 更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| ShipDate | 出荷日 | 更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| ShipCharge | 送料 | 更新不可 | 更新不可 | 更新不可 | 更新可能 | 更新不可 |
| PayCharge | 手数料 | 更新不可 | 更新不可 | 更新不可 | 更新可能 | 更新不可 |
| GiftWrapCharge | ギフト包装料 | 更新不可 | 更新不可 | 更新不可 | 更新可能 | 更新不可 |
| Discount | 値引き | 更新不可 | 更新不可 | 更新不可 | 更新可能 | 更新不可 |
| ShipStatus | 出荷ステータス | 更新不可 | 必須 | 更新不可 | 更新不可 | 更新不可 |
| PayStatus | 入金ステータス | 更新不可 | 更新不可 | 必須 | 更新不可 | 更新不可 |
| StoreStatus | ストアカスタム ステータス |
更新可能 | 更新可能 | 更新可能 | 更新可能 | 更新不可 |
| Suspect | いたずら解除注文 | 更新不可 | 更新不可 | 更新不可 | 更新不可 | 必須 |
| CancelReason | キャンセル理由 | 更新可能 | 更新不可 | 更新不可 | 更新不可 | 更新不可 |
| CancelReasonDetail | キャンセル理由詳細 | 必須 （CancelReason が230の場合） |
更新不可 | 更新不可 | 更新不可 | 更新不可 |
| Adjustments | 調整額 | 更新可能 | 更新不可 | 更新不可 | 更新可能 | 更新不可 |
明細情報更新ファイル
| ファイル名 | odstats_item.csv |
|---|---|
| 形式 | CSV |
| 文字コード | Shift_JIS |
| 改行 | CR+LF |
| フィールド名 | 名称 | 必須 | 内容 | 最大長 | サンプル | |
|---|---|---|---|---|---|---|
| OrderId | 注文ID | ○ | 注文ID（※削除できません） | 10 | 最大 | 9999999999 |
| LineId | ラインID | ○ | Line（明細）ID （※削除できません） | 2 | 最大 | 1 |
| Quantity | 数量 | 商品ごとの購入数量 | 3 | 最大 | 2 | |
| ReleaseDate | 発売日 | 変更したい日付をyyyy/mm/dd 形式で指定。 yyyy-mm-dd もしくは yyyymmdd でも可。 変更日＜変更後発売日＜注文日365日後のレンジ のみ指定可。 （注文ステータスが「予約中」の場合のみOK） |
99 | 最大 | 2014/12/24 | |
明細情報追加ファイル
| ファイル名 | odstats_addItem.csv |
|---|---|
| 形式 | CSV |
| 文字コード | Shift_JIS |
| 改行 | CR+LF |
- 重要
- 商品情報を引用するか、しないかにより、必須項目が変わりますのでご注意ください。
また、Yahoo!ショッピングのデータ上の在庫が0の商品も明細情報として追加できますのでご注意ください。
| フィールド名 | 名称 | 必須項目 | 内容 | 最大長 | サンプル | ||
|---|---|---|---|---|---|---|---|
| 商品情報を 引用する場合 （※1） |
商品情報を 引用しない 場合（※2） |
||||||
| OrderId | 注文ID | ○ | ○ | 10バイト | 最大 | 10000234 | |
| LineId | ラインID | ○ | ○ | 同一注文ID内で単一の値とすること。 連番にすること。 |
2バイト | 最大 | 12 |
| ItemId | 商品ID | ○ | ○ | 99バイト | 最大 | prdct12345 | |
| Title | 商品名 | × | ○ | 商品情報から引用するので IsQuotation=true の場合は指定しないこと。 |
225バイト | 最大 | 掃除機 サイクロン掃除機 人気クリーナー サンプル品 |
| IsQuotation | 商品ごと商品情報の引用 | ○ （true） |
○ （false） |
文字列true/falseを指定すること。 ※ご注意 引用して商品追加した場合はポイント付与対象となりますが、引用しなかった場合はポイント付与対象となりません。 |
true/ false |
固定 | false |
| SubCode | 商品サブコード | × | ○ | 商品オプションの項目の組み合わせから逆引きして一致するサブコードを設定する。
一致するものがない場合は何も設定しない。 引用しない場合は任意の値を設定可能。 |
99バイト | 最大 | sub-prdct56789 |
| ItemOptionIndex | 商品オプションの表示順 | 〇 ※ItemOptionを設定する場合、 ItemOptionIndex ItemOptionName ItemOptionValue 3項目すべての設定が必須。 |
× | 連番にすること。 ItemOptionを 設定する場合 ItemOptionIndex, ItemOptionName ItemOptionValue は必須とする。 1商品に対する商品オプションとインスクリプションは合わせて20個までとする。 区切り文字は「；」。 末尾にはつけないこと。 |
2バイト | 最大 | 1;2;3 |
| ItemOptionName | 商品オプションの項目名 | × | ItemOptionを設定する場合、 ItemOptionIndex, ItemOptionName ItemOptionValue は必須とする。 1商品に対する商品オプションとインスクリプションは合わせて20個までとする。 区切り文字は「；」。 末尾にはつけないこと。 |
桁数指定なし 整合性チェックのみ |
★オプション(1);★オプション(2);★オプション(3) | ||
| ItemOptionValue | 商品オプションの値 | × | 桁数指定なし 整合性チェックのみ |
不要;必要;必要 | |||
| InscriptionIndex | インスクリプションの表示順 | 〇 ※Inscriptionを設定する場合、 InscriptionIndex InscriptionName InscriptionValue 3項目すべての設定が必須。 |
× | 連番にすること。 Inscriptionを設定する場合、 InscriptionIndex, InscriptionName, InscriptionValue は必須とする。 1商品に対する商品オプションとインスクリプションは合わせて20個までとする。 区切り文字は「；」。 末尾にはつけないこと。 |
2バイト | 最大 | 1;2;3;4 |
| InscriptionName | インスクリプションの項目名 | × | Inscriptionを設定する場合、 InscriptionIndex, InscriptionName, InscriptionValue は必須とする。 1商品に対する商品オプションとインスクリプションは合わせて20個までとする。 区切り文字は「；」。 末尾にはつけないこと。 |
桁数指定なし 整合性チェックのみ |
★インスクリプション(1);★インスクリプション(2);★インスクリプション(3);★インスクリプション(4) | ||
| InscriptionValue | インスクリプションの値 | × | 桁数指定なし 整合性チェックのみ |
株式会社サンプル;営業本部;営業1課;矢風 太郎様 | |||
| UnitPrice | 商品単価（税抜） | × | ○ | 商品情報から引用するので IsQuotation=true の場合は指定しないこと。 |
10バイト | 最大 | 50000 |
| Quantity | 数量 | ○ | ○ | 1以上の値を必ず指定 | 3バイト | 最大 | 123 |
