2017年の仕様変更

  API全般

2017-11-9 リリース

注文APIに関する仕様変更

2017年10月5日の仕様変更で複数の代金引換設定の併用が可能になりましたので、注文APIにて配送方法毎の手数料を出力するように仕様変更を行います。

carriageのプロパティにcommissionを追加し、当該注文の決済手段が代引の場合には代引手数料（手数料の金額）を出力するようになります。

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

<carriage name="日本郵便" price="200" commission="400">
    <commodity brandcode="000000000004" name="レディース半袖プリントTシャツXS　ヒョウ柄"/>
</carriage>
<carriage name="佐川急便" price="500" commission="200">
    <commodity brandcode="000000000008" name="メンズ半袖プリントTシャツXL　ヒョウ柄"/>
</carriage>

【代引決済の場合】代引手数料が0円の場合

<carriage name="日本郵便" price="200" commission="0">

【代引決済の場合】代引手数料が400円の場合

<carriage name="日本郵便" price="200" commission="400">

【代引決済以外の場合】

<carriage name="日本郵便" price="200" commission="">
  • 詳細注文画面から代引手数料を変更した場合はcommissionのpriceのみを変更しcarriageのcommissionは注文時の金額のままとなります
  • 配送方法が1つの場合も出力します

2017-10-26 リリース

注文APIに関する仕様変更

このリリースで注文者住所と送付先の住所のフォーマットが変更になります。
[都道府県]+[住所]だったフォーマットが[都道府県]+[市区町村]+[番地]に整理されます。

注文情報をXMLで取得する場合、既存のフォーマットに加えて[市区町村]<city>と[番地]<street>が新たに出力されるようになります。また注文者住所については都道府県単独の出力<area>が追加されます。

以下のデータを入力した場合
150-8512
東京都渋谷区桜丘町２６番１号　セルリアンタワー

入力フォーマット（ショップ画面から入力する内容）

仕様変更前

  • 都道府県（プルダウン・必須）：東京（23区内）
  • 住所（テキストフィールド・必須）：渋谷区桜丘町２６番１号　セルリアンタワー

仕様変更後

  • 都道府県（プルダウン・必須）：東京（23区内）
  • 市区町村（テキストフィールド・必須）：渋谷区桜丘町
  • 番地・建物名・部屋番号など（テキストフィールド・必須）：２６番１号　セルリアンタワー

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

仕様変更前

<buyer>
    <id>151021000001</id>
    <office_name>○○株式会社</office_name>
    <office_name_kana>○○カブシキガイシャ</office_name_kana>
    <department>○○部</department>
    <name>吉田敬</name>
    <kana>ヨシダタカシ</kana>
    <tel>03-0000-0000</tel>
    <tel2/>
    <email>yoshida.t@yahoo.co.jp</email>
    <zip>150-8512</zip>
    <address> 東京(23区外)渋谷区桜丘町２６番１号　セルリアンタワー</address>
    <membergroup>

<deliveries>
    <delivery id="1">
        <delivery_id>1</delivery_id>
        <office_name>××株式会社</office_name>
        <office_name_kana>××カブシキガイシャ</office_name_kana>
        <department>××部署</department>
        <name>中山太郎</name>
        <kana>ナカヤマタロウ</kana>
        <tel>03-0000-0000</tel>
        <zip>150-8512</zip>
        <area>東京(23区内)</area>
        <address>渋谷区桜丘町２６番１号　セルリアンタワー</address>
        <deliverydate>2017-09-28</deliverydate>

仕様変更後

<buyer>
    <id>151021000001</id>
    <office_name>○○株式会社</office_name>
    <office_name_kana>○○カブシキガイシャ</office_name_kana>
    <department>○○部</department>
    <name>吉田敬</name>
    <kana>ヨシダタカシ</kana>
    <tel>03-0000-0000</tel>
    <tel2/>
    <email>yoshida.t@yahoo.co.jp</email>
    <zip>150-8512</zip>
    <address> 東京(23区外)渋谷区桜丘町２６番１号　セルリアンタワー</address>
    <area>東京(23区内)</area>
    <city>渋谷区桜丘町</city>
    <street>２６番１号　セルリアンタワー</street>
    <membergroup>

<deliveries>
    <delivery id="1">
        <delivery_id>1</delivery_id>
        <office_name>××株式会社</office_name>
        <office_name_kana>××カブシキガイシャ</office_name_kana>
        <department>××部署</department>
        <name>中山太郎</name>
        <kana>ナカヤマタロウ</kana>
        <tel>03-0000-0000</tel>
        <zip>150-8512</zip>
        <area>東京(23区内)</area>
        <address>渋谷区桜丘町２６番１号　セルリアンタワー</address>
        <city>渋谷区桜丘町</city>
        <street>２６番１号　セルリアンタワー</street>
        <deliverydate>2017-09-28</deliverydate>

仕様変更以前に受注した注文を仕様変更後のXMLフォーマットで取得した場合について

注文者住所

  • 新設された「都道府県」項目には都道府県の情報を出力
  • 新設された「市区町村」項目には市区町村とそれ以降の情報を出力
  • 新設された「番地」項目には何も出力しない

送付先

  • 新設された「市区町村」項目には市区町村とそれ以降の情報を出力
  • 新設された「番地」項目には何も出力しない

2017-8-31 リリース

注文APIに関する仕様変更

BtoBオプション法人名入力機能で、これまでは注文者側にのみ会社名 会社名フリガナ 部署名項目をご利用いただいておりましたが、今後は送付先側にも会社名 会社名フリガナ 部署名をご利用いただけるようになります。
そのため注文取得の際のパラメーターに下記の追加があります。

変更後の仕様

  • deliveryに新たなパラメーターoffice_name office_name_kana departmentを追加。

XMLの出力例

<deliveries>
    <delivery id="1">
        <delivery_id>1</delivery_id>
        <office_name>××株式会社</office_name>
        <office_name_kana>××カブシキガイシャ</office_name_kana>
        <department>××部署</department>
        <name>中山太郎</name>
        <kana>ナカヤマタロウ</kana>
        <tel>03-0000-0000</tel>
        <zip>160-0022</zip>
        <area>東京(23区内)</area>
        <address>新宿区新宿</address>
        <deliverydate>2017-08-28</deliverydate>
        <deliverytime>指定なし</deliverytime>
        <commodities>
            <commodity>
                <name>普通の商品</name>
                <brandcode>000000000001</brandcode>
                <orgcode></orgcode>
                <price>500</price>
                <point>0</point>
                <amount>1</amount>
                <consumption_tax_rate>8</consumption_tax_rate>
                <nameoption></nameoption>
            </commodity>
        </commodities>
        <delivery_status>0</delivery_status>
        <scheduled_shipping_date></scheduled_shipping_date>
        <shipping_date></shipping_date>
        <delivery_order>0</delivery_order>
        <carrier></carrier>
        <daliverynum></daliverynum>
        <carriage name="標準配送" price="0"></carriage>
    </delivery>
</deliveries>

2017-6-8 リリース

注文APIに関する仕様変更

FREX B2B後払いのサービス名称がNP掛け払いに変更になりましたので、注文データ取得の際のpaymethodの出力名も同様に変更になります。

変更後の仕様

  • paymethodのE1の名称をNP掛け払いに変更。

2017-5-26 臨時メンテナンス

SSL証明書の入れ替えについて

26日18時頃にMaksShopのSSL証明書の入れ替えを行っております。
その際にDV証明書からEV証明書に証明書の種別が変更になりましたので、APIに影響が予想されます。

念のためルート証明書の更新をお勧めいたします（下記より対応のものを取得可能かと思います）。
リポジトリ・利用約款｜GMOグローバルサイン

2017-5-25 リリース

商品APIに関する仕様変更

商品データの登録・取得の際のパラメーターoption_layout_typeの種類に追加があります。

変更後の仕様

  • option_layout_typeに3項目ごとに買い物かごを表示するを追加。

2017-4-20 リリース

注文APIに関する仕様変更

注文データ取得の際のパラメーターpaymethodと、注文状態変更のエラー種類に追加があります。

変更後の仕様

  • paymethodにG1楽天ペイを追加。
  • エラーメッセージにC-8を追加。

2017-3-30 リリース

注文APIに関する仕様変更

2017年2月22日をもってAmazonペイメントのサービス名称がAmazon Payに変更になりましたので、注文データ取得の際のpaymethodの出力名も同様に変更になります。

変更後の仕様

  • paymethodのD1の名称をAmazon Payに変更。