部門コードごとに売上金額を取得したい

APIを利用して、会計ソフトに連携する為に取引日時、店舗コード、部門コード(親)ごとに売上金額(税抜)を取得したいと考えています。どのように取得することが望ましいでしょうか?

◎質問背景

日々の売上金額を会計ソフトに連携することを考えています。当初はAPI[日次締め情報参照]を利用する予定でしたが、会計ソフトでは部門コード(カテゴリ)ごとに明細を作っていることからAPI[取引情報参照]を利用し、取引明細の部門コードで集計して連携する予定です。会計ソフトには税別の売上金額を連携したいのですが、取引明細の項目を見ると売上(税別)の合計に相当する項目がないように見受けられ、取得をどのようにすべきかわからず質問させていただきました。

答え

  • 補足すると、

    取引明細.値引き後計が売上(税別)の合計に相当する項目にも見えますが、認識あっていますでしょうか??

  • October 2021 編集されました

    @岸野拓也

    取引情報参照APIの利用を検討とのことですが、部門コード=部門IDという認識でよろしいでしょうか。

    スマレジにはID、コードの二種類の概念があり、部門コードは「取引一覧取得」では取得できません。

    また、部門コード(親)とのことですが取引情報を取得する場合、実際に販売した商品が紐づく部門IDが取引情報として取得されます。

    親子設定を行っている場合でも取得されるのは子部門のみになりますのでご注意ください。


    「取引一覧取得」を利用いただければ、「店舗コード」をレスポンスに含めることも可能ですし、店舗IDで事前に該当店舗のみに絞って情報を取得いただくのもよろしいかと思います。


    会計ソフトへの出力とのことですので、スマレジの日次処理、売上分析と数字を合わせていただくことになると思うので、

    『取引日時』ではなく、『締め日』で参照いただくのがおすすめです。

    取引日時/transactionDateTime

    実際に取引を行った日付と時間。変更不可。

    締め日/sumDate

    該当の取引をどの日の売上として扱うかという日付。販売後に変更可能。

    【参考】スマレジヘルプ

    【Q&A】精算・締め処理で使われる用語解説https://help.smaregi.jp/hc/ja/articles/360052971213

    取引履歴の締め日を変更するhttps://help.smaregi.jp/hc/ja/articles/360000315547


    税抜の売上に相当する項目は、値引き後計ではなく、「販売価格計(値引済)(税抜)」がおすすめです。

    ※値引き後計は小計値引き前の金額になるため、部門ごとの売上を集計いただく場合正確な値が取得できません

    「販売価格計(値引済/税抜)」はスマレジ管理画面から取引履歴CSVをダウンロードした場合は自動で出力できますが、

    プラットフォームAPIでは該当の項目がございません。

    お手数ですがこちらの回答を参照の上、算出いただければと存じます。

    販売価格計(値引済/税抜)https://community.smaregi.dev/discussion/comment/309