売上実績表プラグイン

売上実績表プラグインは、kintoneの一覧画面に月別の売上推移表を表示し、売上・粗利の実績や目標達成状況をひと目で把握できるようにするプラグインです。

できること

• 指定した一覧画面の上部に「売上推移表」を表示します（その一覧では通常のレコード一覧は非表示になります）。
• 売上日をもとに、会計期（12ヶ月）で月別に自動集計します。
• 各月の 売上実績・粗利実績・売上累計・粗利累計・粗利率 を表示します。
• 前年同月／前年累計との対比（前年比）をワンクリックで表示・非表示できます。
• 売上・粗利の目標達成率（累計ベース）と、合計行での目標差を表示します。
• 複数の期を登録し、一覧画面のセレクタで切り替えて表示できます。
• 部門・担当者・店舗などのカテゴリ別に、目標設定・実績集計・達成率表示・絞り込みができます。
• 期間内のユニーク顧客数・平均売上金額・平均粗利金額をスコアカードで表示します。
• 任意の絞り込み条件で、集計対象のレコードを限定できます。

事前準備（対象アプリに用意するフィールド）

• 売上推移表を表示する一覧（ビュー）を1つ用意しておきます。
• カテゴリに組織・ユーザー・グループ選択を使う場合は、先頭の値がカテゴリ名として使われます。

設定手順

1. ライセンス設定：発行されたライセンスキー・シークレットキーを入力します（入力すると自動で有効性が確認され、有効期限・対象ドメインが表示されます）。
2. 基本設定：対象一覧／売上日／売上金額／仕入金額／顧客名フィールドを選択します。カテゴリフィールドは部門・担当者などで分けたい場合に選択します（未選択ならカテゴリ機能は無効）。絞り込み条件はkintoneのクエリ形式で除外条件を入力します（例：ステータス not in ("取消","無効")／空欄なら全件対象。売上日の期間は自動付与）。
3. 期間設定：期の開始月（会計年度の開始月。既定は4月）を選びます。
4. 期別目標設定：「＋期を追加」で期を登録し、期番号／開始年（西暦）／売上目標／粗利目標を入力します。「カテゴリ別目標」でカテゴリ名・売上目標・粗利目標を行追加できます（カテゴリ名はカテゴリフィールドの値と一致させます）。
5. 「保存」してアプリを更新します。

既定値

集計のルール

• 対象期間：選択した期の開始月／開始年から12ヶ月。売上日がこの範囲のレコードを集計します（前年分も自動取得して対比します）。
• 月割り目標：年間目標 ÷ 12 を毎月積み上げ、累計達成率＝累計実績 ÷ 累計目標。
• 粗利＝売上金額 − 仕入金額、粗利率＝粗利 ÷ 売上。
• 達成率の色分け：100%以上＝緑／80%以上＝黄／80%未満＝赤。
• 平均売上・平均粗利＝期間合計 ÷ ユニーク顧客数。
• カテゴリ別：目標を設定していないカテゴリも実績は集計されますが、目標・達成率・目標差は「—」表示になります。

一覧画面の使い方

• 期セレクタ：表示する期を切り替えます（切替時はカテゴリ選択がリセットされます）。
• カテゴリ選択／カテゴリ別実績の行クリック：特定カテゴリで月次推移を絞り込みます（同じ行を再クリックで全体に戻ります）。
• 前年表示トグル：前年売上・前年対比の列を表示／非表示します。
• スコアカード：顧客数・平均売上金額・平均粗利金額・売上目標・粗利目標を表示します。
• 合計行：売上／粗利の合計と、目標までの差額（プラス＝緑、マイナス＝赤）を表示します。

注意事項・うまく表示されないとき

• ご利用にはライセンス契約が必要です。ライセンスが未設定・無効の場合は売上推移表は表示されません。
• プラグインは設定した対象一覧でのみ動作し、その一覧では通常のレコード一覧は非表示になります。
• 表が表示されないときは、対象一覧の選択・必須フィールドの設定・ライセンスの有効性・対象期間にデータがあるかをご確認ください。
• カテゴリフィールドを選ばずにカテゴリ別目標を設定しても、カテゴリ機能は動作しません（保存時に警告が表示されます）。