Maskeel / Maskeel AP API / 債務の連携

仕入先の請求書を、
そのまま債務へ。

照合が済んだ仕入先の請求書と、返品・値引・取消を「書類」のまま受け取り、債務管理のある会計ソフトの債務伝票として渡します。税額は再計算しません。支払予定と支払は、いつもの会計ソフトで。

変換の例

入力 / 仕入先請求書POST /v1/ap/documents
種類
supplier_invoice
仕入先の請求書番号
V-20261105
仕入先
サンプル部品(S0001)
日付・支払期日
11/05・12/31
明細
部品 200,000円(10%・税 20,000円)
外注加工 50,000円(10%・税 5,000円・適格請求書なし)
照合会計ソフトの一覧の写し
  1. 債務科目
    買掛金 → 305
  2. 購入科目
    仕入高 → 700・外注費 → 705
  3. 精算先
    S0001(業務側のコードのまま)

科目は名前で照合。税区分は税率と種類から決めます。

出力 / 債務伝票2026/11/05
購入部品 10%220,000
購入外注加工 10%・免税事業者等55,000
税額指定のまま25,000

摘要:Maskeel AP +書類ID V-20261105
適格請求書のない仕入はその区分を付け、控除割合は会計ソフトが決めます。

架空の例です。科目のコード・税区分は、お使いの会計ソフトの設定に合わせて照合します。

01

仕訳ではなく、請求書の単位で渡す。

債務管理のある会計ソフトは、買掛金を「どの請求書がいくら未払か」の単位で持ちます。AP APIは、その単位のまま渡します。

業務システムMaskeel Operations・既存ERP

Maskeel AP API

書類の受付仕入先請求書・返品・値引・赤伝票
照合科目・部門・取引先・税区分
債務伝票出力・突き合わせ
一致しない名前があるとき確認一度選べば次から自動
会計ソフト債務の管理・支払予定・支払・仕訳
業務システムから仕入先請求書・返品・値引・赤伝票を書類として受け取り、会計ソフトの一覧の写しで科目・部門・取引先・税区分を照合し、債務伝票の受入ファイルを出力します。会計ソフトがその伝票から仕訳を作り、支払予定を立て、支払います。
AP APIが渡すもの

債務の発生。照合済みの仕入先請求書、返品・値引、その取消(赤伝票)、切り替え時の残高移行。

会計ソフトが行うこと

債務伝票から仕訳を作る、精算先の支払条件から支払予定を立てる、支払う、残高を管理する。

GL APIとの関係

AP APIが受け持つ取引は、GL APIが仕訳にしません。入荷・諸掛・在庫はGL APIのままです。

部門ごとの業務システムを、共通の会計へ。

各部門の購買システムから届く照合済みの仕入先請求書を、共通の科目・部門の一覧で照合し、会計ソフトの債務へ。GL・AR・APを組み合わせ、会社の会計方針に沿って渡し方を揃えます。各システムの項目・取引先コードの整理と、接続の設定・検証が必要です。

全社共通の会計連携を見る →

02

たとえば、こんな使い方。

担当ごとの利用イメージです。

経理の担当者

請求書の入力を、確認の仕事に

いま
仕入先の請求書を、購買の照合とは別に会計ソフトの債務伝票として手で入力している。
AP APIで
照合が済んだ請求書がそのまま債務伝票の受入ファイルに。取り込んだあと、戻したファイルで漏れ・二重を確かめます。

支払の担当者

支払予定と支払は、これまでどおり

いま
会計ソフトの債務残高と購買側の請求書が、別々に育っていく。
AP APIで
請求書 1 枚が債務 1 件として会計ソフトに届く。支払予定・支払・残高の管理は会計ソフトに集約します。

情報システムの担当者

コードの対応表を、作らない

いま
科目コード・取引先コードの変換表を、両方のシステムの変更のたびに直している。
AP APIで
会計ソフトから書き出した一覧を取り込むだけ。名前で照合し、一致しないものだけ一度選びます。取引先は業務側のコードをそのまま使います。

いずれも想定の例です。

03

受け付ける書類は、4種類。

発生だけを渡します。支払・前渡金は会計ソフトの仕事なので、AP APIは渡しません。

  1. supplier_invoice

    仕入先請求書

    入荷と照合が済んだ請求書 1 枚が 1 件。採用した価格差異も同じ書類に。明細は税率ごとに税抜と確定税額。

  2. debit_note

    返品・値引

    マイナスの請求書。明細の種別(返品・値引)で区別し、科目は請求書と同じ。

  3. *.reversed

    赤伝票

    元の書類を全額打ち消します。一部の訂正は返品・値引で。元の記録は残ります。

  4. opening_balance

    残高移行

    切り替え時に、未払の仕入先請求書を 1 件ずつ。仕訳は作らず、債務の明細だけを作ります。

突き合わせの結果(例)2026年11月
書類会計ソフトの伝票No.結果
V-20261105000301記帳確認済み
V-20261106—漏れ(出力したのに会計ソフトにない)
V-20261107000303・000304二重
  1. 1出力前のチェック一致しない名前・未登録の取引先があれば、出す前に止まります。
  2. 2受入ファイルを出力保存版として残し、会計ソフトで取り込みます。
  3. 3戻して突き合わせ会計ソフトから書き出した債務伝票を戻すと、書類ごとに伝票No.と確認の結果が付きます。
実画面・サンプル会社の架空データ 債務連携の書類を確認し、出力前のチェックを実行する。画面上の吹き出しで説明・自動進行・音声なし。GIFを保存
04

技術仕様

GL APIと同じ基盤の上に、独立したAPIとして提供します。

受け付けるもの

書類

POST /v1/ap/documents。種類(supplier_invoice・debit_note・opening_balance・*.reversed)、日付、支払期日、仕入先の請求書番号、取引先コード、明細(購入科目・部門・税区分・税率・税抜金額・確定税額)。

Maskeel Operationsから

仕入先請求の照合(採用した価格差異を含む)・仕入返品・仕入値引・それぞれの取消を、業務と同じトランザクションで自動的に書類にします。

設定

PUT /v1/ap/settings(AR APIと共通)。会計ソフトへの渡し方、受け持ち始める月、債務科目、他システムから届く債務のイベントの種類。

出すもの

債務伝票の受入ファイル(債務管理のある会計ソフト向け)対応
出力前のチェック・保存版・突き合わせの結果対応
支払伝票・支払予定・支払方法渡さない
項目仕様
二重の防止同じ送信元・同じ伝票番号・同じ種類の書類は一度だけ受け付けます。同じ内容の再送は同じ結果を返し、内容が違えば受け付けません(Idempotency-Key と組み合わせ)。
税額送信元が確定した税額を必須で受け取り、再計算しません。会計ソフトにも再計算させない書き方(税込金額+税額の直接指定)で出します。
税区分送信元の税区分名から、種類(課税仕入・非課税仕入・対象外など)と税率を決め、会計ソフトの区分コードにします。適格請求書のない仕入はその区分を付け、控除割合は会計ソフトに任せます。
科目・部門会計ソフトが正。会計ソフトから書き出した一覧を写しとして取り込み、名前で照合します。対応表は作りません。一致しないものだけ一度選べば、次から自動です。
取引先業務側が正。業務側のコードをそのまま会計ソフトの取引先コードにします。未登録の取引先は、受入ファイルを出して先に会計ソフトへ登録します。
伝票番号会計ソフトが採番します。書類IDを摘要に入れ、戻した伝票との突き合わせで会計ソフトの伝票No.を記録します。
訂正赤伝票(全額)と返品・値引(一部)。元の書類は書き換えません。締めた月の日付の書類は受け付けません。
GL APIとの分担渡し方を「GLと債権・債務」にした月から、AP APIが受け持つ取引(仕入先請求の照合・仕入返品・仕入値引・支払など)はGL APIが仕訳にしません。入荷・諸掛・在庫・原価差異はGL APIのままです。
記録書類・出力・突き合わせはすべて追記で残し、監査の記録に載ります。業務システムの表は参照しません。
認証・権限GL APIと同じAPIキー。スコープは ap:documents:read ap:documents:write ap:exports:write。設定の変更は承認者以上。

対応する会計ソフトの受入形式は、導入時に実機で検証します。債務管理のない会計ソフト(仕訳だけを受け取るもの)には、GL APIで仕訳を渡します。

よくある質問

GL APIと何が違いますか?

GL APIは仕訳を渡します。AP APIは請求書の単位で債務を渡し、仕訳は会計ソフトが伝票から作ります。債務管理のある会計ソフトではAP API、仕訳だけを受け取る会計ソフトではGL APIを使います。

支払予定や支払方法はどうなりますか?

会計ソフトが、精算先(仕入先)に登録した支払条件から支払予定を作り、支払処理・銀行連携を行います。AP APIは支払方法や支払予定を渡さず、支払の結果を業務システムに戻すこともしません。債務の残高は会計ソフトが正です。

入荷のたびに債務になりますか?

なりません。仕入先の請求書と入荷を照合したときに、請求書 1 枚が債務 1 件になります。入荷そのものは在庫の記録として、GL APIが仕訳にします。

切り替え前の未払の請求書はどうしますか?

残高移行の書類として 1 件ずつ渡します。会計ソフトには仕訳を作らず、債務の明細だけができるので、以後の支払を充てられます。

Maskeel Operationsがなくても使えますか?

使えます。既存のERPや購買システムから、仕入先請求書・返品・値引をAPIで送れます。

相談

仕入先の請求書を、
会計ソフトの債務へ。

次の3つが分かれば、具体的にご案内できます。

  1. 1仕入先の請求書を照合しているシステムの名前
  2. 2お使いの会計ソフトの名前(債務管理の有無)
  3. 3連携したいもの(請求書・返品・値引)