ソフト開発 プログラミング 楽天RMS

RMS 楽天ペイ受注API(RakutenPayOrderAPI) searchOrderで注文番号を取得するPHPサンプル解説・使い方

投稿日:

RMS APIは楽天市場の店舗管理、商品管理の自動化を実現するAPIです。あまりサンプルがまとまっていないので、APIの全パターンを下記記事でまとめています。

楽天 RMS APIのPHPサンプル集・使い方 ほぼ全パターン(随時更新中)

今回は楽天ペイ受注API(RakutenPayOrderAPI)、searchOrderのサンプルを解説します。

APIを使用できる環境がない場合は、下記から出店申請をしてください。毎度言ってますが料金が高いので、APIを試すだけなら既に店舗アカウントを持っている人に頼んでテスト店舗を使わせてもらうのも手です。

APIを使用するための出店手続き・資料請求はこちら

 

サンプルソースコードは下記です。

searchOrderのサンプルソースコード



searchOrderの概要

searchOrderを使えば、店舗に入った注文の注文番号を取得することができます。

例えばステータス(orderProgress)が「100:注文確認待ち」になっている注文の注文番号を取得し、confirmOrderで楽天に決済を依頼するなどの使い方ができます。

 

searchOrderはREST APIです。エンドポイントにJSONパラメーターを添えてPOSTすると、指定の条件の注文をJSONで取得できます。

指定できる検索パラメータの例は下記です。

  • ステータスリスト
  • サブステータスIDリスト
  • 期間検索種別
  • 期間検索開始日時
  • 期間検索終了日時
  • 販売種別リスト
  • 支払方法名
  • 配送方法
  • 発送日未指定有無フラグ
  • お荷物伝票番号未指定有無フラグ
  • 検索キーワード種別
  • 検索キーワード
  • 注文メールアドレス種別
  • 注文者メールアドレス
  • 電話番号種別
  • 電話番号
  • 申込番号
  • 購入サイトリスト
  • あす楽希望フラグ
  • クーポン利用有無フラグ
  • 医薬品受注フラグ
  • 海外かご注文フラグ

取得できる注文の情報は下記です。

  • 注文番号

 

POST リクエスト例

下記のようなリクエストを送ります。

 

レスポンス例

下記のような感じで返ってきます。

 

ソースコード解説

やることは超簡単で下記。

  • POSTリクエストする検索条件を入力。JSONにして検索パラメータを作る
  • CURLで検索パラメータをぶち込んでPOSTする

POSTリクエストする検索条件を入力。JSONにして検索パラメータを作る

まずはリクエストとして設定する検索条件の変数を設定。

 

 

CURLで検索パラメータをぶち込んでPOSTする

jsonにした検索パラメータをcurlでPOSTする。

 

まとめ

searchOrderを使って、注文の入った注文番号を取得できます。注文の詳細までは取れないため、取得した注文番号リストを使って、getOrderを使って更に注文詳細情報を取得する流れをとります。

楽天ペイ受注API(RakutenPayOrderAPI) getOrderの詳細記事(準備中)

 

試してみたい方は是非下記から資料請求などをして準備をはじめてみてくださいね。

searchOrderのサンプルソースコード

APIを使用するための出店手続き・資料請求はこちら




  • この記事の筆者

Y平

札幌のWebデザイナー。オモコロライターも。Webデザイン、Web集客、コーダーできます。最近7年勤めた富士通を退職しました。1歳の娘いるのに年収下がっちゃう。仕事ください。

-ソフト開発, プログラミング, 楽天RMS

Copyright© バイラシー , 2018 All Rights Reserved.