経理の担当者
請求書の入力を、確認の仕事に
- いま
- 仕入先の請求書を、購買の照合とは別に会計ソフトの債務伝票として手で入力している。
- AP APIで
- 照合が済んだ請求書がそのまま債務伝票の受入ファイルに。取り込んだあと、戻したファイルで漏れ・二重を確かめます。
照合が済んだ仕入先の請求書と、返品・値引・取消を「書類」のまま受け取り、債務管理のある会計ソフトの債務伝票として渡します。税額は再計算しません。支払予定と支払は、いつもの会計ソフトで。
変換の例
科目は名前で照合。税区分は税率と種類から決めます。
摘要:Maskeel AP +書類ID V-20261105
適格請求書のない仕入はその区分を付け、控除割合は会計ソフトが決めます。
返品・値引は、請求書と同じ科目で、明細の種別だけが変わります。
金額は絶対値、種別「返品」で債務を減らします。
取消は元の書類をそのまま打ち消す赤伝票です。
架空の例です。科目のコード・税区分は、お使いの会計ソフトの設定に合わせて照合します。
債務管理のある会計ソフトは、買掛金を「どの請求書がいくら未払か」の単位で持ちます。AP APIは、その単位のまま渡します。
Maskeel AP API
債務の発生。照合済みの仕入先請求書、返品・値引、その取消(赤伝票)、切り替え時の残高移行。
債務伝票から仕訳を作る、精算先の支払条件から支払予定を立てる、支払う、残高を管理する。
AP APIが受け持つ取引は、GL APIが仕訳にしません。入荷・諸掛・在庫はGL APIのままです。
各部門の購買システムから届く照合済みの仕入先請求書を、共通の科目・部門の一覧で照合し、会計ソフトの債務へ。GL・AR・APを組み合わせ、会社の会計方針に沿って渡し方を揃えます。各システムの項目・取引先コードの整理と、接続の設定・検証が必要です。
担当ごとの利用イメージです。
経理の担当者
支払の担当者
情報システムの担当者
いずれも想定の例です。
発生だけを渡します。支払・前渡金は会計ソフトの仕事なので、AP APIは渡しません。
supplier_invoice
入荷と照合が済んだ請求書 1 枚が 1 件。採用した価格差異も同じ書類に。明細は税率ごとに税抜と確定税額。
debit_note
マイナスの請求書。明細の種別(返品・値引)で区別し、科目は請求書と同じ。
*.reversed
元の書類を全額打ち消します。一部の訂正は返品・値引で。元の記録は残ります。
opening_balance
切り替え時に、未払の仕入先請求書を 1 件ずつ。仕訳は作らず、債務の明細だけを作ります。
GL APIと同じ基盤の上に、独立したAPIとして提供します。
受け付けるもの
POST /v1/ap/documents。種類(supplier_invoice・debit_note・opening_balance・*.reversed)、日付、支払期日、仕入先の請求書番号、取引先コード、明細(購入科目・部門・税区分・税率・税抜金額・確定税額)。
仕入先請求の照合(採用した価格差異を含む)・仕入返品・仕入値引・それぞれの取消を、業務と同じトランザクションで自動的に書類にします。
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は仕訳を渡します。AP APIは請求書の単位で債務を渡し、仕訳は会計ソフトが伝票から作ります。債務管理のある会計ソフトではAP API、仕訳だけを受け取る会計ソフトではGL APIを使います。
会計ソフトが、精算先(仕入先)に登録した支払条件から支払予定を作り、支払処理・銀行連携を行います。AP APIは支払方法や支払予定を渡さず、支払の結果を業務システムに戻すこともしません。債務の残高は会計ソフトが正です。
なりません。仕入先の請求書と入荷を照合したときに、請求書 1 枚が債務 1 件になります。入荷そのものは在庫の記録として、GL APIが仕訳にします。
残高移行の書類として 1 件ずつ渡します。会計ソフトには仕訳を作らず、債務の明細だけができるので、以後の支払を充てられます。
使えます。既存のERPや購買システムから、仕入先請求書・返品・値引をAPIで送れます。