TimeCard APIの月別給与明細取得にてPath Paramsの「store_id」が省けない
お世話になります
掲題の通り、月別給与明細取得にてPath Paramsの「store_id」を省いてリクエストを送ることができません。
仕様書を見る限りですと、「store_id」は必須()になっておりません。
https://timecard1.smaregi.dev/apidoc/#operation/getBudgetStatement
そのため、省けるものと考えたのですが、下記のパターンを試してみても「無効なリクエスト」である旨が返却されるのみです。
・https://api.smaregi.jp/{契約ID}/timecard/budgets/monthly/{スタッフID}?year=2021&month=09
・https://api.smaregi.jp/{契約ID}/timecard/budgets/monthly//{スタッフID}?year=2021&month=09
事業所を指定せず、総合的な給与詳細を取得することはできないのでしょうか。
答え
なお、事業所を指定した場合は取得できます。
@スマレジ中谷
こちら回答をお願いしてもよろしいでしょうか
もしくはPath Paramsの省略ができないとのことであれば、
TimeCardにて
給与 > 月別給与詳細 > (従業員の)明細 > 給与総合
に表示される明細をAPIで取得する場合、どのようなリクエストを投げればよろしいですか？
大変申し訳ございませんが「給与 > 月別給与詳細 > (従業員の)明細 > 給与総合」のデータをプラットフォームAPIで取得することができません。
掲題の通り、月別給与明細取得にてPath Paramsの「store_id」を省いてリクエストを送ることができません。
仕様書が誤っており大変申し訳ございません。
現状は「store_id」の入力が必須になります。
また現状給与明細を取得いただくAPIとしては「月別給与一覧取得」「月別給与明細取得」がございますが、
現状、以下のような違いがございます。
月別給与一覧取得：
事業所IDで指定してリクエストを行うと指定した事業所に実績がある場合
複数事業所の合算のデータが返却される
※取得できるデータが月別給与明細取得に比べて少ない
月別給与明細取得：
事業所IDで指定してリクエストを行うと、該当の事業所の給与明細データが返却される
またDMでご質問いただいておりました従業員は月給の為、
「月別給与明細取得」では事業所の給与明細が返却されており、
基本給が0円と返却されている状態です。
月給の場合、事業所ごとでは給与は発生せず、従業員単位で給与が発生するためです。
ただ、「月別給与明細取得」では事業所IDの指定が必須で給与（総合）が取得できません。
こちらの仕様に関しては不便であると弊社でも認識しておりますので改修も今後予定しております。
恐れ入りますが具体的なスケジュールに関しては調整中となりますので、
修正内容や目途がわかりましたらまたご連絡させていただきます。
@エクサ前田
月別給与明細取得で給与（総合）が取得できない件に関して
先日のサーバーアップデートで改善がされました。店舗IDに「0」をに指定すると、給与（総合）が取得できます。
仕様書の記載に関しては現在修正依頼中となり、近日中に修正予定となります。
取り急ぎご確認ください。
@エクサ前田
長らくお待たせして申し訳ございませんでした。
仕様書へ「月別給与明細取得」にて店舗IDに「0」をに指定すると、給与（総合）が取得できる旨、記載いたしましたのでまたご確認ください。
https://timecard1.smaregi.dev/apidoc/#operation/getBudgetStatement