仕入先マスタ

プロパティ

プロパティ 説明
id [読取専用] ID
仕入先マスタをユニークに識別するための数値です。主に、APIでのアクセスに使用します。仕入先コードとは異なります。
code 仕入先コード
name [必須] 仕入先名
name_kana 仕入先名かな
post_code 郵便番号
prefecture 都道府県
address1 住所1
address2 住所2
address3 住所3
phone 電話番号
fax FAX番号
email メールアドレス
representative 担当者名
representative_kana 担当者名かな
comment コメント
attr1 フリー項目1
attr2 フリー項目2
attr3 フリー項目3
attr4 フリー項目4
attr5 フリー項目5
attr6 フリー項目6
attr7 フリー項目7
attr8 フリー項目8
attr9 フリー項目9
attr10 フリー項目10
keyword 検索用キーワード
created_at [読取専用] 登録日時 - Y-m-d H:i:s形式 (例 : 2018-01-01 23:59:59)
updated_at [読取専用] 更新日時 - Y-m-d H:i:s形式 (例 : 2018-01-01 23:59:59)

エンドポイント

仕入先マスタの一覧を取得

リクエスト

GET /api/v1/merchant/#{merchant_id}/suppliers

パラメーター 説明
limit 取得する結果の数 - デフォルトは 20 最大値は 100
page ページ - デフォルトは 1
code 仕入先コード

レスポンス

HTTP/1.1 200

{
  "data":[
    {
      "id": "12345",
      "code": "supplier-1",
      "name": "仕入先(1)",
      "created_at": "2018-02-07 22:11:16",
      "updated_at": "2018-02-07 22:11:16"
    }
  ],
  "current_page": 1,
  "limit": 20,
  "total_count": 1
}

仕入先マスタを登録

リクエスト

POST /api/v1/merchant/#{merchant_id}/suppliers/new

{
  "article": {
    "code": "supplier-1",
    "name":"仕入先(1)"
  }
}

レスポンス

HTTP/1.1 201 Created

{
  "id": "12345",
  "code": "supplier-1",
  "name": "仕入先(1)",
  "created_at": "2018-02-07 22:11:16",
  "updated_at": "2018-02-07 22:11:16"
}

仕入先マスタを編集

リクエスト

PUT /api/v1/merchant/#{merchant_id}/suppliers/{id}

{
  "article": {
    "name":"仕入先(1)_編集"
  }
}

レスポンス

HTTP/1.1 200

{
  "id": "12345",
  "code": "supplier-1",
  "name": "仕入先(1)_編集",
  "created_at": "2018-02-07 22:11:16",
  "updated_at": "2018-02-07 22:11:16"
}