MCPとSDKで取引から請求書への自動化を構築

{
  "mcpServers": {
    "sanka": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.sanka.com/mcp",
        "--resource",
        "https://mcp.sanka.com/mcp"
      ]
    }
  }
}

過去7日間に更新された「成約」ステータスの取引をすべて見つけてください。
請求書が紐付けられていない各取引について：
1. 関連する連絡先の請求先住所を取得
2. 取引金額を1つの明細として請求書を作成
3. 請求書を取引に紐付け
4. 取引を請求済みとしてマーク

実行前に作成内容を表示してください。

pip install sanka-sdk

from sanka_sdk import Sanka
from datetime import datetime, timedelta

client = Sanka(api_key="sk_live_...")

# 過去7日間の成約取引を検索
seven_days_ago = (datetime.now() - timedelta(days=7)).isoformat()
deals = client.deals.list(
    filters={
        "status": "closed-won",
        "updated_at": {"gte": seven_days_ago}
    }
)

for deal in deals.data:
    # 請求書が既に存在するか確認
    existing_invoices = client.invoices.list(
        filters={"deal_id": deal.id}
    )

    if existing_invoices.data:
        print(f"取引 {deal.id} には既に請求書があります、スキップ")
        continue

    # 請求情報のため連絡先を取得
    contact = client.contacts.get(deal.contact_id)

    # 請求書を作成
    invoice = client.invoices.create({
        "contact_id": contact.id,
        "deal_id": deal.id,
        "due_date": (datetime.now() + timedelta(days=30)).isoformat(),
        "line_items": [
            {
                "description": deal.name,
                "quantity": 1,
                "unit_price": deal.amount
            }
        ],
        "billing_address": contact.billing_address,
        "status": "draft"
    })

    # 取引を請求済みとして更新
    client.deals.update(deal.id, {
        "custom_fields": {
            "invoiced": True,
            "invoice_id": invoice.id
        }
    })

    print(f"取引 {deal.name} の請求書 {invoice.id} を作成しました")

# Webhookハンドラーの例（Flask）
@app.route("/webhooks/deal-closed", methods=["POST"])
def handle_deal_closed():
    payload = request.json
    deal_id = payload["deal_id"]

    # 上記と同じロジック、ただし単一の取引に対して
    deal = client.deals.get(deal_id)
    if deal.status == "closed-won":
        create_invoice_for_deal(deal)

    return {"status": "ok"}