2018年の仕様変更

  API全般

2018-9-13 リリース

商品APIに関する仕様変更

常時SSLが有効なショップ（常時SSL設定画面で「現在、常時SSLの状態です」と表示されている）場合、下記の各項目のURLが従来のhttpではなくhttpsで返却されます。

  • 商品ページURL
    product_page_url
  • 拡大画像URL
    zoom_image_url
  • 普通画像URL
    image_url
  • 縮小画像URL
    thumbnail_image_url
  • 追加商品画像1
    sub_image1_url
  • 追加商品画像2
    sub_image2_url
  • 追加商品画像3
    sub_image3_url

2018-8-30 リリース

商品登録APIに関する仕様変更

商品登録APIで利用できるCSVフォーマットについて、これまでサポートしていた過去のバージョン（2014年2月27日までの各バージョン）を廃止しました。
今後商品登録APIで利用できるのは以下のバージョンの何れかになります。

  • 最新のバージョン
  • ～2018年4月19日のバージョン
    （本APIドキュメントに商品一括登録の入力ファイルレイアウトとして掲載している内容）

2018-5-31 リリース

商品APIに関する仕様変更

商品APIで取得できる「商品更新日時」の更新条件が変更になります。

  • 変更内容

対象項目：No.10「商品更新日時」

変更前：
管理画面の「商品の登録/修正」画面、CSV、APIにより商品情報が更新された場合、「商品更新日時」が更新される。

変更後：
上記に加えて、管理画面から商品の以下の情報が更新された場合、「商品更新日時」が更新される。

  • 価格
  • 在庫　※商品購入による在庫の変動を含む
  • カテゴリー
  • ポイント
  • オプション
  • 画像
  • 表示可否
  • 商品グループ

2018-4-19 リリース

商品APIに関する仕様変更

1/25に行いましたモバイルショップ機能の廃止に伴い、商品APIおよび商品登録APIの項目からモバイル関連項目が削除されます。

  • 変更内容

以下項目を削除します。（削除後、列を詰めます）
No.117 「モバイル画像URL」
No.119 「追加商品画像モバイル表示1」
No.122 「追加商品画像モバイル表示2」
No.125 「追加商品画像モバイル表示3」
No.130 「モバイル商品説明」
No.133 「スマホ商品説明1にモバイル表示」

商品登録APIはリリース後しばらくは現在のフォーマットでもアップロード可能となります。

リリース後ご都合に合わせて新しいフォーマットへの切り替えをお願いいたします。

2018-3-29 リリース

商品APIおよび商品登録APIに関する仕様変更

3月29日に行いました価格コムプランの仕様変更に伴い、商品APIの価格コムプラン用項目の内容を変更いたしました。

  • 変更内容

【商品API】
変更項目：No.175 「[価格.com]送料区分名」
改修前：価格.comに予め登録した「送料区分名」を出力します。
改修後：「送料」「送料固定」「送料区分名」を以下の形式で出力します。

出力例）
送料(最大9桁)|送料固定(1桁 0/1)|送料区分名(最大10文字)

送料固定出力値
0 = 変動
1 = 固定

【商品登録API】
変更項目：No.100 「[価格.com]送料区分名」
改修前：価格.comに予め登録した「送料区分名」を設定します。
改修後：「送料」「送料固定」「送料区分名」を以下の形式で設定します。

指定例）
送料(最大9桁)|送料固定(1桁 0/1)|送料区分名(最大10文字)

送料固定指定値
0 = 変動
1 = 固定
※「[価格.com]送料区分名」を指定する場合、「送料」「送料固定」の値は必須です。

2018-2-1 リリース

注文APIに関する仕様変更

注文APIで共通エラーメッセージの文言が一部変更になります。

変更対象

  • A-6
– ID コード 判定条件 メッセージ
変更前 A-6 500 データベースに接続できない サービスで障害が発生しております。
変更後 A-6 500 データベースに接続できない データベースとの接続を確立できませんでした。時間をおいてから再度お試しください。

2018-1-25 リリース

注文APIに関する仕様変更

注文APIの出力にクーポン名とクーポンコードが追加されます。

クーポンが使われた注文のみ、orders.order.orderdetail.coupon の前に以下2点が出力されます。

  • クーポン名
    orders.order.orderdetail.couponname

  • クーポンコード
    orders.order.orderdetail.couponcode

出力例（APIから取り出す場合）

仕様変更前

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<orders>
    <order>
        <ordernum>P158990748134868019</ordernum>
        <status>1</status>
        <date>2018-01-18 14:38:50</date>
        <paymethod type="B">銀行振込</paymethod>
        <payment_status>0</payment_status>
        <ordermemo></ordermemo>
        <orderdetail>
            <commodities>
                <commodity>
                    <name>商品13</name>
                    <brandcode>000000000013</brandcode>
                    <orgcode></orgcode>
                    <jancode></jancode>
                    <dcrate>0</dcrate>
                    <price>530000</price>
                    <amount>1</amount>
                    <point type="shop" name="ショップポイント">0</point>
                    <point type="gmo" name="GMOとくとくポイント">0</point>
                    <consumption_tax_rate>8</consumption_tax_rate>
                    <nameoption></nameoption>
                </commodity>
            </commodities>
            <coupon>-171720</coupon>

仕様変更後

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<orders>
    <order>
        <ordernum>P158990748134868019</ordernum>
        <status>1</status>
        <date>2018-01-18 14:38:50</date>
        <paymethod type="B">銀行振込</paymethod>
        <payment_status>0</payment_status>
        <ordermemo></ordermemo>
        <orderdetail>
            <commodities>
                <commodity>
                    <name>商品13</name>
                    <brandcode>000000000013</brandcode>
                    <orgcode></orgcode>
                    <jancode></jancode>
                    <dcrate>0</dcrate>
                    <price>530000</price>
                    <amount>1</amount>
                    <point type="shop" name="ショップポイント">0</point>
                    <point type="gmo" name="GMOとくとくポイント">0</point>
                    <consumption_tax_rate>8</consumption_tax_rate>
                    <nameoption></nameoption>
                </commodity>
            </commodities>
            <couponname>3割引きクーポン</couponname>
            <couponcode>3waribiki</couponcode>
            <coupon>-171720</coupon>