Wavis の使い方。
つなぐところ以外は、画面だけで運用できます。

1. 3分で開始する

「決済が通るたびに適格請求書が自動で出る」状態を、3ステップで作ります。コードは0行です。

wavis.xyz/app.html

2. だれが何をする？

役割を分けると迷いません。エンジニアがいなくても、最初の配線だけ依頼すれば運用できます。

2.5 用語と制度のしくみ（はじめての方へ）

Wavis が自動化する制度と用語を、ひとことずつ。すでにご存じの方は読み飛ばして構いません。

3. 自動発行を設定する

ダッシュボード →「自動発行」での操作です。保存すると受信URLが表示されます。

wavis.xyz/app.html · 自動発行

4. Webhook をつなぐ（自動作成なら1クリック）

ここが唯一の「つなぐ」作業です。おすすめは自動作成（約10秒）。手動でも一度きり・約5分です。

wavis.xyz/app.html · 設定 · 接続

手動で設定する場合：Stripe の画面はこのようになります（受信URLを貼り、下のイベントにチェック）。

dashboard.stripe.com · 開発者 · Webhook

5. 自社ブランド（ロゴ・角印・色）

ダッシュボード →「自社ブランド」。編集すると右の見本（実際の発行PDFと同じ描画）がその場で更新されます。

• ブランド色：見出し・表ヘッダ・合計欄・罫線の色。プリセットから選ぶか HEX を入力。
• ロゴ：PNG / JPG / SVG・1MB以内。請求書の左上に表示。
• 角印：社名から自動生成、または画像をアップロード。印刷→押印→スキャンの手間がゼロに。

wavis.xyz/app.html · 自社ブランド

6. 取引先マスタ

ダッシュボード →「取引先」。宛名・登録番号・敬称・締め日・既定税率を登録しておくと、自動発行で正式名称と敬称が自動で当たり、表記ゆれが消えます。

• メール（紐付けキー）：決済の買い手メールと一致した取引先の情報が、自動発行に反映されます。
• 敬称：御中／様／なし。買い手区分に合わせて宛名を整えます。
• 締め日・既定税率：月末締めやこの取引先への発行で使われます。

wavis.xyz/app.html · 取引先

7. 発行済みの確認・PDFダウンロード

ダッシュボード →「請求書」。決済のたびに、ここへ自動で並びます。

• 各行で番号・発行日・宛先・税込金額・配送状態（送付済／保存）を確認できます。
• 「PDFを開く」で実物をダウンロード。すべての発行は常に Wavis に保存されています。
• API で取得するなら GET /v1/invoices/stored → 開発者向け。

wavis.xyz/app.html · 請求書

8. 月末締めでまとめて発行

掛売り（BtoB）向け。決済を月内に蓄積し、取引先ごとに月1通の適格請求書へ集約します。

9. 帳簿・検索（電子帳簿保存法）

ダッシュボード →「帳簿・検索」。電帳法が求める取引年月日・金額・取引先での検索と、月次まとめの保存に対応します。

• 検索：取引日 from/to、税込金額の下限/上限、取引先（部分一致）で絞り込み。
• 月次 zip ダウンロード：対象月を選んで書き出すと、PDF一式＋index.csv（取引日・金額・取引先の索引）が入った zip が得られます。年度末の提出・保存にそのまま使えます。

10. 会計連携（仕訳CSV）

ダッシュボード →「レポート・会計」。発行台帳を複式簿記の仕訳に変換し、会計ソフトへ手入力ゼロで取り込みます。

仕訳の作られ方

• 借方＝売掛金、貸方＝売上高（税抜方式では仮受消費税等を分離）。
• 返金（適格返還請求書）は逆仕訳で相殺します。
• 税区分は課税売上 10% / 8%（軽減）。勘定科目・税区分は取込後に各社の科目マスタへ読み替え可。

形式を選んでダウンロード

経理方式は「税込」（既定・保存値そのまま）／「税抜」（売上と仮受消費税を分離）を選べます。対象月は売上レポートの月指定に従います（未指定は全期間）。

wavis.xyz/app.html · レポート・会計

11. freee へ直接送る（CSV取込なし）

freee会計と接続すると、発行した仕訳をCSVのダウンロード・取込なしで freee に直接登録できます。「決済 → 請求書 → 台帳 → 仕訳」の最後のひと手間が消えます。ダッシュボードの「売上・会計連携」から操作します。

連携の方法（接続する）

基本的な操作（仕訳を送る）

一度に送れるのは 200 件までです（1件ずつ freee へ登録するため）。多い場合は対象月を指定して月ごとに送ってください。多くの中小企業は月内に収まります。

連携の解除（接続を解除する）

• 「接続を解除」を押すと、保存したトークン・科目マッピング・投入済みの記録を削除します。以降の自動投入は行われません。
• 解除後に再接続すれば、最初からやり直せます（投入済み記録もリセットされます）。
• freee 側でも、設定 → アプリ連携から Wavis の連携を解除できます。

11.5 freee/MF と併用する（どの仕訳をどちらが持つか）

freee/MF の Stripe ネイティブ連携をすでに使っている方向けの、二重計上を防ぐ運用ガイドです。Wavis は会計ソフトを置き換えません——持ち分を最初に決めるのが唯一のルールです。

• 迷ったらこの構成：freee のStripe口座連携（自動取込）を停止し、売上・入金・手数料・カバレッジ・源泉を Wavis の統合投入に一本化 → freee は経費・給与・申告に専念。
• freee 連携を残す構成：Wavis は「発行（交付）・検知（月次残高突合）・源泉・電帳法保存」だけを使い、Wavis からの売上/入金投入はオフのまま運用（検知が freee 側の取込漏れを毎月見張る役になります）。
• どちらの構成でも、月次残高突合（検知）が最後の砦：Stripe残高の変動と帳簿の変動がズレたら毎月メールで気づけます。

12. 入金消込（銀行明細 × 売掛）

月初の「どの入金がどの請求書？」を消します。ネットバンキングの入金明細を貼り付けると、未消込の請求書（月末締めなどの請求書タイプ）と自動で突き合わせます。ダッシュボードの「入金消込」から操作します。

wavis.xyz/app.html · 入金消込

使い方

Stripe入金の消込（手数料の仕訳まで自動）

Stripe の銀行入金は複数決済の純額（売上−手数料）束ねで、振込名義は「ストライプジヤパン（カ」——名義でも金額でも売掛と突き合いません。Wavis は入金（payout）の内訳を決済ID単位で取得し、発行済みの請求書と確定一致で消し込み、入金仕訳（借方 普通預金＋支払手数料／貸方 売掛金）まで自動で起こします。

チャージバック・入金失敗（自動で帳簿を守る）

Webhook に charge.dispute.* と payout.failed を追加（自動作成なら設定済み）すると：異議申立の発生を台帳にマークしてメールで通知し、敗訴が確定したときだけ取消の適格返還請求書を自動発行（保存のみ・相手には送りません）。入金失敗はその入金で消し込んだ売掛を自動で未消込へ巻き戻し、取消の逆仕訳まで組み立てます——「消込済みなのに現金が無い」状態を防ぎやすくします。

Stripe手数料の証憑（仕入税額控除の適格請求書）

月次パッケージ（この zip で月の経理が終わり）

「レポート・会計」タブの月次パッケージは、仕訳CSV・入金/手数料一覧・未入金（エイジング）・手数料証憑の突合・サマリを1つのzipにまとめます。消費税集計CSV（課税売上10%/8%・返還・純額・手数料）と未着のStripe入金（期ズレ）の一覧も同じ場所から出せます（申告書そのものは作りません——申告は税理士または本人の判断で）。

12.5 Stripe特化レポート（決済ネイティブの費目分解）

freee／MF／弥生は一般に確定した決済の純額を取り込む設計のため、Stripeの費目データ（手数料の種類・通貨換算・Connect・チャージバック・サブスクの役務期間）の分解は標準では範囲外になりがちです（2026年6月時点の各社公開仕様に基づく当社調べ）。Wavisは突合で控えた balance_transaction からこれらを取り出し、税区分のたたき台を出します（最終判断は税理士へ）。各タブで対象月を選び、必要なら仕訳CSVを会計ソフトへ。

wavis.xyz/app.html · 手数料税区分

wavis.xyz/app.html · 収益認識

wavis.xyz/app.html · 来歴トレース（家系図）

12.6 Wavis の役割の終わり（どこから税理士の判断か）

Wavisが自動で担うのは事実の集約と仕訳のたたき台までです。次は仕組み上断定せず、最終判断は事業者・税理士に委ねます——出力はβ・参考値で、提出・申告の前に公式手段での検証を前提とします。

• 手数料・dispute の控除＝「本則課税・適格請求書の保存が前提の見込み」。簡易課税・2割特例は実額控除がないため控除0で計上します。インボイス（StripeはダッシュボードからDL）の保存は利用者側の対応です。「発行プロフィール」で課税方式を設定すると、見込みが正しく切り替わります。
• リバースチャージ＝課税売上割合95%以上・簡易課税は当分の間「なかったものとみなす」経過措置で申告不要。該当判定は税理士へ。
• 収益認識＝日数按分は合理的な一例です。「収益認識に関する会計基準」は中小企業には強制適用されません。計上月は請求作成日と仮定します。
• 媒介者交付特例＝3要件（双方が適格・事前通知・写しの交付保存）を確認したチェックを入れたときだけ代理交付します。委託者の登録番号は国税庁「適格請求書発行事業者公表システム」でご確認ください。
• 申告書の作成・税務代理は行いません（集計・様式データの生成まで）。月次・年次の判断は税理士または本人が行います。

12.8 税理士・会計事務所：事務所コックピット

freee・マネーフォワード・弥生はそのままで結構です。Stripeを使う顧問先の帳簿だけ、網羅性監査の層を足します——全顧客のStripe残高の抜け漏れを1画面でトリアージし、月次突合をワンクリックで一括、封緘した網羅性監査証明書（事業者自身の自己点検）まで。決済ネイティブでないと取りにくいStripeの「1円のズレ」を、事務所の作業として抑えます。

wavis.xyz/cockpit.html · 全顧客を一括で締める

3ステップで始める

wavis.xyz/cockpit.html

顧客の発行 / 招待（本人の承認で開始）

「+ 新規顧客を発行」または「+ 既存顧客を招待」から。顧客の平文キーは事務所へは返さず、顧客本人の承認を経て有効化されます（同意なくアクセスしない設計）。未承認・未接続の顧客は一覧で可視化され、オンボーディングの停滞点を追えます。

wavis.xyz/cockpit.html · 新規顧客を発行

要対応ワークリスト（1円のズレを潰す）

突合で見つかった未計上の資金移動（チャージバック損/勝・為替差・返金失敗・調整など）と売上の記帳漏れ（決済はあるのに請求書なし）を顧客ごとに開けます。記帳漏れは来歴トレース（家系図）で決済→入金→仕訳まで1円単位で辿れ、その場で顧客へ差し戻し依頼を送れます。判断が割れるものは自動投入せず「要確認」で人に回します。

wavis.xyz/cockpit.html · 要対応

申告準備（消費税・源泉を顧客横断で）

全顧客の課税売上（10%/8%）と消費税・源泉徴収（当月・未納）を1表に集約し、CSVで書き出せます（申告書ではなく、課税取引金額計算表への転記用）。手数料の税区分・為替差損益・収益認識（前受金）・Connect・チャージバック手数料も顧客ごとに横断確認できます。

wavis.xyz/cockpit.html · 申告準備

守秘と透明性（顧客側の承認・アクセス記録）

顧客は自分のダッシュボードの「事務所アクセス」でリンクを承認/取消でき、誰がいつ何をしたかの記録が残ります。事務所の操作（突合・証明書発行・閲覧）はすべて監査来歴に記録され、顧客が確認できます＝預かりデータの守秘と監査の透明性を両立します。

wavis.xyz/app.html · 事務所アクセス（顧客側）

料金

事務所コックピットは完全無料です。税理士は顧問先のStripe経理を巻き取るWavisの推薦チャネル——事務所には一切課金しません。収益は顧問先自身のプラン（Standard/Pro）から。事務所が連れてきた顧問先は90日間 無料で試せ、その後も使い続けたい顧問先が各自で契約します。導入も解約も顧客単位・縛りなし。大手の事務所プログラムと競合せず「足すだけ」＝小さく始められます。

13. 30日トライアルと Founding 特典

どなたでも、メールアドレスだけで今すぐ始められます：登録フォーム→確認メールのリンク→その場でAPIキー発行。発行から30日間は全機能（自動化スイート・入金消込を含む）を無料で試せます（カード登録不要・トライアル中は月500件まで）。そのうえで、先着の創業メンバー向けに：

• Founding メンバー（先着10社）：Pro を Founding 価格 月額 ¥4,900（税込）——解約まで据え置きで適用します。トライアル中いつでも申し込めます。
• 創業メンバー特典：ロードマップ優先・新API先行アクセス・優先サポート。
• トライアルが終わると自動的に現在のプランのゲートへ戻ります（発行済みの控え・台帳・エクスポートはそのまま使えます。勝手に課金されることはありません）。
• すでに早期アクセスにご登録済みの方には、従前のご案内どおりの特典をそのまま履行します。

14. 開発者向け：APIを直接叩く

対話的リファレンスは /docs（Swagger）・/redoc。全エンドポイントが用途別グループ・リクエスト/レスポンス例・エラーコード付きで並びます。

API の基礎

認証：/health 以外の全エンドポイントは Authorization: Bearer <APIキー> を要求します。キーはダッシュボードで発行・再発行（DBにはハッシュのみ保存）。制限付きキー rk_… は Webhook 自動作成・入金消込の読取専用に使い、秘密キー sk_… は預けません。

エラー：標準的な HTTP ステータスを返し、本文は {"detail":"理由"} です。

冪等性：自動発行（/v1/ingest/{token}）と課金 Webhook は冪等です。同じ決済イベントを複数回受信しても二重発行・二重課金しません（決済ID・イベントIDで重複排除）。レート制限：超過時は 429。バージョン：パスにメジャーを含み（/v1）、互換を壊す変更は新メジャーで提供します。

コードから1通生成する

決済オブジェクトをその場で渡して1通だけ生成します。$WAVIS_KEY はあなたのAPIキー。

# 決済オブジェクト（Stripe/PAY.JP/Square/任意JSON）から1通生成
curl https://api.wavis.xyz/v1/invoices/from_payment \
  -H "Authorization: Bearer $WAVIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issuer":"あなたの会社","registration_number":"T1234567890123",
       "provider":"stripe","payment_object":{"amount":11000,"currency":"jpy"}}' \
  -o receipt.pdf

# 決済オブジェクトから1通生成（requests）
import requests, os

r = requests.post(
    "https://api.wavis.xyz/v1/invoices/from_payment",
    headers={"Authorization": f"Bearer {os.environ['WAVIS_KEY']}"},
    json={
        "issuer": "あなたの会社",
        "registration_number": "T1234567890123",
        "provider": "stripe",
        "payment_object": {"amount": 11000, "currency": "jpy"},
    },
)
open("receipt.pdf", "wb").write(r.content)

// 決済オブジェクトから1通生成（Node 18+ / fetch）
import { writeFile } from "node:fs/promises";

const r = await fetch("https://api.wavis.xyz/v1/invoices/from_payment", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.WAVIS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    issuer: "あなたの会社",
    registration_number: "T1234567890123",
    provider: "stripe",
    payment_object: { amount: 11000, currency: "jpy" },
  }),
});
await writeFile("receipt.pdf", Buffer.from(await r.arrayBuffer()));

任意項目から組み立てるなら POST /v1/invoices（明細・税率・源泉徴収を指定）。専用SDKは不要——/openapi.json から好みの言語のクライアントを自動生成できます。対話実行は APIリファレンス（/docs）。

主なエンドポイント

Webhook イベント・カタログ

POST /v1/ingest/{token} が受け取る Stripe イベントと、Wavis の挙動。すべて冪等（再送で二重処理しません）。「Webhook自動作成」を使うと全イベント＋署名検証が一度に有効化されます。

レスポンス形式

• 発行系（/v1/invoices*・/v1/preview）：?format=pdf（既定・application/pdf）/ ?format=html。
• 一覧・レポート・消込：application/json。
• エクスポート（電帳法 zip・仕訳CSV・支払調書CSV）：application/zip ・ text/csv（Content-Disposition: attachment）。

15. トラブルシュート・FAQ

困ったときは、まず下の「症状別」から探してください。多くはここで解決します。

うまくいかないとき（症状別）

よくある質問

ダッシュボードを開く 困ったら相談する

16. 更新履歴

主な変更点。API バージョンは v1（パスに含む）。後方互換を壊す変更は新メジャーで提供し、既存の /v1 は維持します。破壊的変更は事前に告知します。

変更の詳細・不具合報告は hello@wavis.xyz へ。障害・メンテナンス情報は X @wavis_jp でお知らせします（稼働確認は APIヘルスチェック）。

17. 関連記事（制度・実務の背景）

このガイドが扱う制度面の背景は、実務記事で詳しく解説しています。

• Stripeの決済から適格請求書を出す——記載要件と落とし穴
• Stripe×freee併用で売上を二重計上しないための整理
• Stripe請求と源泉徴収（10.21%/20.42%）の実務
• Stripe決済の書類と電子帳簿保存法（検索要件・真実性）
• 媒介者交付特例——プラットフォームが代理で適格請求書を出す仕組み