mcpField
P
procurement-summarization

procurement-summarization

github.com/happy-technologies-llcデータ・データベース4141 回インストール2 日前に更新
リポジトリ

procurement-summarization について

procurement-summarizationは、調達マネージャーやアナリスト向けのServiceNow調達業務要約スキルです。調達ケース、承認、発注書、請求依頼、請求書のデータを集約し、支出や進捗、ボトルネックを整理します。

主な機能

  1. 01調達ケースと状態を要約
  2. 02ベンダーとの連絡と承認経路を整理
  3. 03ベンダー別・カテゴリ別に支出を分析
  4. 04請求依頼、発注書、請求書の状況を集約
  5. 05承認や履行のボトルネックを特定

活用シーン

  1. 01週次の調達業務概要を作成
  2. 02ベンダー紛争ケースの連絡履歴を要約
  3. 03調達パイプラインと支出のレポートを作成

MCP 対応

ServiceNowのMCPツールで調達ケース、発注書、請求依頼、請求書、承認、連絡記録を検索し、構造化した要約を作成します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/happy-technologies-llc/happy-platform-skills --skill procurement-summarization

インストール後、Claude Code で/procurement-summarizationを入力して読み込まれたか確認します。

詳細

調達の概要作成

概要

このスキルでは、ServiceNow Sourcing and Procurement Operations における調達業務を要約するための体系的な方法を提供します。次のことに役立ちます。

  • sn_proc_case から調達ケースの詳細を取得し、統合する
  • ベンダーとのやり取り、承認経路、ケースの進捗を要約する
  • proc_po と sn_proc_invoice を使用して、ベンダー、カテゴリ、期間ごとの支出を分析する
  • 各段階の購買申請、PO、請求書を示すパイプラインレポートを作成する
  • 承認ワークフロー、ベンダーの応答、調達におけるボトルネックを特定する

使用する場面: 調達マネージャーがケースの作業量、支出の傾向、パイプラインの健全性を把握したい場合や、調達業務に関する経営層向けレポートを作成する場合に使用します。

前提条件

  • ロール: sn_procurement.manager、sn_procurement.analyst、または procurement_admin
  • プラグイン: com.sn_procurement(Sourcing and Procurement Operations)が有効化されていること
  • アクセス権: sn_proc_case、proc_po、proc_po_item、sn_spo_requisition、sn_proc_invoice、core_company への読み取りアクセス
  • 知識: 組織の調達ワークフローの各段階と承認階層に精通していること

手順

手順 1:調達ケースを取得する

アクティブな調達ケースを照会し、現在の作業量とステータスの分布を把握します。

MCP を使用する場合(Claude Code/Desktop):

Tool: SN-Query-Table
Parameters:
  table_name: sn_proc_case
  query: active=true^ORDERBYDESCsys_updated_on
  fields: sys_id,number,short_description,state,priority,category,vendor,assigned_to,assignment_group,opened_at,sys_updated_on,approval,requested_by
  limit: 50

日付範囲またはカテゴリで絞り込むには:

Tool: SN-Query-Table
Parameters:
  table_name: sn_proc_case
  query: opened_at>=javascript:gs.beginningOfLast30Days()^category=contract_request
  fields: sys_id,number,short_description,state,priority,category,vendor,assigned_to,opened_at
  limit: 50

REST API を使用する場合:

GET /api/now/table/sn_proc_case?sysparm_query=active=true^ORDERBYDESCsys_updated_on&sysparm_fields=sys_id,number,short_description,state,priority,category,vendor,assigned_to,assignment_group,opened_at,sys_updated_on,approval,requested_by&sysparm_limit=50&sysparm_display_value=true
手順 2:ケースのやり取りと作業メモを取得する

ジャーナルエントリを取得し、ベンダーとのやり取りと社内メモを要約します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: sys_journal_field
  query: element_id=[case_sys_id]^element=work_notes^ORelement=comments^ORDERBYDESCsys_created_on
  fields: sys_id,element,value,sys_created_on,sys_created_by
  limit: 30

REST API を使用する場合:

GET /api/now/table/sys_journal_field?sysparm_query=element_id=[case_sys_id]^element=work_notes^ORelement=comments^ORDERBYDESCsys_created_on&sysparm_fields=sys_id,element,value,sys_created_on,sys_created_by&sysparm_limit=30
手順 3:承認状況を確認する

承認レコードを照会し、保留中の承認とボトルネックを特定します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: sysapproval_approver
  query: document_id=[case_sys_id]^ORDERBYDESCsys_updated_on
  fields: sys_id,approver,state,sys_updated_on,comments,source_table,group
  limit: 20

保留中の承認をパイプライン全体で確認するには:

Tool: SN-Query-Table
Parameters:
  table_name: sysapproval_approver
  query: state=requested^source_table=sn_proc_case^ORDERBYsys_created_on
  fields: sys_id,approver,document_id,state,sys_created_on,group
  limit: 50

REST API を使用する場合:

GET /api/now/table/sysapproval_approver?sysparm_query=document_id=[case_sys_id]^ORDERBYDESCsys_updated_on&sysparm_fields=sys_id,approver,state,sys_updated_on,comments,source_table,group&sysparm_limit=20&sysparm_display_value=true
手順 4:ベンダーとカテゴリごとに支出を分析する

発注書を照会し、支出の概要を作成します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: proc_po
  query: ordered_date>=javascript:gs.beginningOfLast90Days()^state!=cancelled
  fields: sys_id,number,vendor,total_cost,state,ordered_date,currency,category
  limit: 200

ベンダーごとに集計するには:

Tool: SN-Query-Table
Parameters:
  table_name: proc_po
  query: ordered_date>=javascript:gs.beginningOfLastQuarter()^state!=cancelled^vendor=[vendor_sys_id]
  fields: sys_id,number,total_cost,state,ordered_date
  limit: 100

REST API を使用する場合:

# All POs from last 90 days
GET /api/now/table/proc_po?sysparm_query=ordered_date>=javascript:gs.beginningOfLast90Days()^state!=cancelled&sysparm_fields=sys_id,number,vendor,total_cost,state,ordered_date,currency,category&sysparm_limit=200&sysparm_display_value=true

# Spend for a specific vendor
GET /api/now/table/proc_po?sysparm_query=vendor=[vendor_sys_id]^ordered_date>=javascript:gs.beginningOfLastQuarter()^state!=cancelled&sysparm_fields=number,total_cost,state,ordered_date&sysparm_limit=100&sysparm_display_value=true
手順 5:パイプラインレポートを作成する

購買申請、PO、請求書を横断して照会し、調達パイプラインを示します。

MCP を使用する場合:

Tool: SN-Query-Table
Parameters:
  table_name: sn_spo_requisition
  query: state!=cancelled^sys_created_on>=javascript:gs.beginningOfLast30Days()
  fields: sys_id,number,state,requested_by,total_estimated_cost,sys_created_on,approval
  limit: 50
Tool: SN-Query-Table
Parameters:
  table_name: sn_proc_invoice
  query: state!=cancelled^sys_created_on>=javascript:gs.beginningOfLast30Days()
  fields: sys_id,number,state,vendor,invoice_amount,due_date,po_number
  limit: 50

REST API を使用する場合:

# Requisitions in pipeline
GET /api/now/table/sn_spo_requisition?sysparm_query=state!=cancelled^sys_created_on>=javascript:gs.beginningOfLast30Days()&sysparm_fields=sys_id,number,state,requested_by,total_estimated_cost,sys_created_on,approval&sysparm_limit=50&sysparm_display_value=true

# Invoices in pipeline
GET /api/now/table/sn_proc_invoice?sysparm_query=state!=cancelled^sys_created_on>=javascript:gs.beginningOfLast30Days()&sysparm_fields=sys_id,number,state,vendor,invoice_amount,due_date,po_number&sysparm_limit=50&sysparm_display_value=true
手順 6:調達の概要を作成する

データを構造化レポートにまとめます。

=== PROCUREMENT OPERATIONS SUMMARY ===
Period: [start_date] to [end_date]

CASE WORKLOAD:
Total Active Cases: [count]
By State: New [n] | In Progress [n] | Pending Approval [n] | Resolved [n]
By Priority: P1 [n] | P2 [n] | P3 [n] | P4 [n]
Avg Case Age: [days] days

APPROVAL BOTTLENECKS:
Pending Approvals: [count]
Oldest Pending: [case_number] - waiting [days] days for [approver_name]
Top Delayed Approvers:
  1. [approver] - [count] pending, avg [days] days
  2. [approver] - [count] pending, avg [days] days

PIPELINE STATUS:
Requisitions: [count] open ($[total_value])
Purchase Orders: [count] open ($[total_value])
Invoices: [count] pending ($[total_value])

SPEND ANALYSIS (Last 90 Days):
Total PO Spend: $[amount]
Top Vendors:
  1. [vendor_name] - $[amount] ([count] POs)
  2. [vendor_name] - $[amount] ([count] POs)
  3. [vendor_name] - $[amount] ([count] POs)

KEY OBSERVATIONS:
- [bottleneck or risk identified]
- [trend noted]
- [action recommended]

ツールの使用方法

MCP ツールのリファレンス
ツール使用する場面
SN-Query-Tableケース、PO、購買申請、請求書、承認を照会する
SN-Natural-Language-Search自然言語で検索する(例:「先週の調達ケースをすべて表示」)
SN-Get-Recordsys_id を指定して、単一のケースまたは PO レコードを取得する
REST API のリファレンス
エンドポイントメソッド目的
/api/now/table/sn_proc_caseGET調達ケースを照会する
/api/now/table/proc_poGET支出分析用に発注書を取得する
/api/now/table/sn_spo_requisitionGETパイプライン内の購買申請を照会する
/api/now/table/sn_proc_invoiceGET支払い追跡用に請求書を照会する
/api/now/table/sysapproval_approverGET承認状況を確認する
/api/now/table/sys_journal_fieldGETケースの作業メモとコメントを取得する
/api/now/table/core_companyGETベンダーの詳細情報

ベストプラクティス

  • 表示値を使用する: ベンダー名とユーザー名を読みやすくするため、REST 呼び出しには必ず sysparm_display_value=true を含めます
  • 期間を限定する: 過剰なデータの取得を避けるため、必ず日付範囲を指定して照会します
  • 状態ごとにグループ化する: ケースと PO を状態ごとに要約し、作業が滞っている箇所をすばやく特定します
  • 経過時間を追跡する: SLA のしきい値(例:5 営業日)を超えたケースや承認にフラグを付けます
  • 通貨を統一する: ベンダー間の支出を集計する際は、すべての金額が同じ通貨であることを確認します
  • 定期的に更新する: 調達パイプラインは急速に変化するため、一定の間隔で概要を再生成します

トラブルシューティング

「調達ケースが見つかりません」

原因: 組織でカスタムケーステーブルを使用している場合、sn_proc_case テーブルにデータが入力されていない可能性があります。 解決策: 正しいテーブル名を管理者に確認してください。調達ケース用に task を直接拡張している組織もあります。

「支出合計が正しくないようです」

原因: キャンセル済みまたは重複した PO が含まれているか、通貨換算が必要な可能性があります。 解決策: クエリで state=cancelled を除外していることを確認してください。currency フィールドを確認し、合計する前に基準通貨に換算してください。

「承認レコードが見つかりません」

原因: 承認が sysapproval_approver テーブルではなく、ワークフローを介して処理されている可能性があります。 解決策: ケースに関連付けられたワークフローベースの承認について、wf_context テーブルと wf_executing テーブルを確認してください。

「購買依頼データを利用できません」

原因: com.sn_sourcing プラグインが有効化されていない可能性があります。 解決策: プラグインが有効化されていることを確認してください。購買依頼データには com.sn_sourcing または com.sn_procurement が必要です。

例

例 1:週次調達ダッシュボード

シナリオ: 調達マネージャーが週次のステータス概要を必要としています。

手順:

  1. すべての有効なケースをクエリする:有効なケース 42 件、承認待ち 8 件
  2. 過去 7 日間の PO をクエリする:新規 PO 15 件、合計 $234,500
  3. 承認待ちを確認する:5 日以上待機している承認 3 件
  4. 請求書をクエリする:照合待ちの請求書 12 件、合計 $89,200

出力:

WEEKLY PROCUREMENT SUMMARY (Mar 12-19, 2026)

CASES: 42 active (8 new this week)
  Pending Approval: 8 | In Progress: 22 | Awaiting Vendor: 12

BOTTLENECK ALERT:
  3 approvals stalled 5+ days - Finance VP approval queue

PIPELINE:
  Requisitions: 18 open ($412,000 estimated)
  Purchase Orders: 15 new this week ($234,500)
  Invoices: 12 pending match ($89,200)

SPEND THIS WEEK: $234,500 across 6 vendors
  Top: TechSupply Inc - $98,000 (3 POs)
例 2:ベンダーとのコミュニケーションの概要

シナリオ: アナリストがベンダーとの紛争案件に関するすべてのコミュニケーションを要約する必要があります。

Tool: SN-Query-Table
Parameters:
  table_name: sn_proc_case
  query: number=PROC0005678
  fields: sys_id,number,short_description,state,vendor,category,opened_at,assigned_to
  limit: 1

次に、作業メモとコメントを取得します。

Tool: SN-Query-Table
Parameters:
  table_name: sys_journal_field
  query: element_id=[case_sys_id]^element=work_notes^ORelement=comments^ORDERBYDESCsys_created_on
  fields: element,value,sys_created_on,sys_created_by
  limit: 50

出力:

CASE PROC0005678 - VENDOR COMMUNICATION SUMMARY
Vendor: Global Parts Ltd | Category: Price Dispute | State: In Progress

TIMELINE:
Mar 18 - [Analyst] Vendor agreed to credit $2,400 for overcharge
Mar 16 - [Vendor] Responded: pricing error on catalog item SKU-4421
Mar 14 - [Analyst] Sent formal dispute letter with PO and invoice evidence
Mar 12 - [System] Case created from invoice exception INVCASE0001234

RESOLUTION PATH: Credit memo expected by Mar 25

関連スキル

  • procurement/invoice-management - 請求書の照合と例外処理
  • procurement/purchase-order-summarization - PO の詳細なステータスと納品状況の追跡
  • procurement/sourcing-summarization - ソーシングイベントと入札の分析
  • procurement/supplier-recommendation - ベンダーのパフォーマンス評価
  • reporting/executive-dashboard - 経営幹部向けダッシュボードの構築

コメント