Maskeel / Maskeel AR API / 債権の連携

請求書を、
そのまま債権へ。

請求書・返品・値引・取消を「書類」のまま受け取り、債権管理のある会計ソフトの債権伝票として渡します。税額は再計算しません。入金と消込は、いつもの会計ソフトで。

変換の例

入力 / 請求書POST /v1/ar/documents
種類
invoice
請求書番号
INV000184
請求先
サンプル商事(C1024)
日付・期日
11/05・12/31
明細
保管料 128,000円(10%・税 12,800円)
梱包材 1,000円(8%・税 80円)
照合会計ソフトの一覧の写し
  1. 債権科目
    売掛金 → 135
  2. 売上科目
    売上高 → 500
  3. 請求先
    C1024(業務側のコードのまま)

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

出力 / 債権伝票2026/11/05
売上保管料 10%140,800
売上梱包材 8%1,080
税額指定のまま12,880

摘要:Maskeel AR +書類ID INV000184
会計ソフトがこの伝票から仕訳を作ります。

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

01

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

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

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

Maskeel AR API

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

債権の発生。請求書、返品・値引、その取消(赤伝票)、切り替え時の残高移行。

会計ソフトが行うこと

債権伝票から仕訳を作る、入金を受ける(銀行連携など)、消し込む、残高を管理する。

GL APIとの関係

AR APIが受け持つ取引は、GL APIが仕訳にしません。会計ソフトが伝票から仕訳を作るので、二重になりません。

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

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

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

02

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

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

経理の担当者

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

いま
業務システムの請求書を見ながら、会計ソフトの債権伝票を手で入力している。
AR APIで
請求書がそのまま債権伝票の受入ファイルに。取り込んだあと、戻したファイルで漏れ・二重を確かめます。

債権管理の担当者

入金と消込は、これまでどおり

いま
会計ソフトの債権残高と業務システムの請求書が、別々に育っていく。
AR APIで
請求書 1 枚が債権 1 件として会計ソフトに届く。入金・消込・残高の管理は会計ソフトに集約します。

情報システムの担当者

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

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

いずれも想定の例です。

03

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

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

  1. invoice

    請求書

    都度請求なら受注ごと、締め請求なら締め請求書 1 枚が 1 件。明細は税率ごとに税抜と確定税額。

  2. credit

    返品・値引

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

  3. *.reversed

    赤伝票

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

  4. opening_balance

    残高移行

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

突き合わせの結果(例)2026年11月
書類会計ソフトの伝票No.結果
INV000184000201記帳確認済み
INV000185—漏れ(出力したのに会計ソフトにない)
INV000186000203・000204二重
  1. 1出力前のチェック一致しない名前・未登録の取引先があれば、出す前に止まります。
  2. 2受入ファイルを出力保存版として残し、会計ソフトで取り込みます。
  3. 3戻して突き合わせ会計ソフトから書き出した債権伝票を戻すと、書類ごとに伝票No.と確認の結果が付きます。
AR APIの画面の操作の記録。今月の債権の書類の一覧から出力前のチェックを行い、債権伝票データの保存版を作る
実際の画面(架空のデータ) 今月の書類 → 出力前のチェック → 債権伝票データの保存版。Maskeel Operationsで請求した受注が、そのまま書類になっています。
04

技術仕様

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

受け付けるもの

書類

POST /v1/ar/documents。種類(invoice・credit・opening_balance・*.reversed)、日付、入金期日、送信元の伝票番号、取引先コード、明細(売上科目・部門・税区分・税率・税抜金額・確定税額)。

Maskeel Operationsから

売上計上・クレジットメモ・締め請求書・それぞれの取消を、業務と同じトランザクションで自動的に書類にします。

設定

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

出すもの

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

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

よくある質問

GL APIと何が違いますか?

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

入金や消込はどうなりますか?

会計ソフトで行います。銀行連携などで入金を受け、債権伝票に消し込みます。AR APIは入金伝票を渡さず、入金の結果を業務システムに戻すこともしません。債権の残高は会計ソフトが正です。

締め請求の売上はいつ立ちますか?

締めた(請求書を発行した)ときです。締め請求書 1 枚が債権伝票 1 件になります。月末以外の締日で、締日後の売上をその月に計上したい場合は、経理担当者が会計ソフトで振り替えます。末締め・末払いをおすすめしています。

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

残高移行の書類として 1 件ずつ渡します。会計ソフトには仕訳を作らず、債権の明細だけができるので、以後の入金を消し込めます。

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

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

相談

請求書を、
会計ソフトの債権へ。

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

  1. 1請求書を発行しているシステムの名前
  2. 2お使いの会計ソフトの名前(債権管理の有無)
  3. 3請求の締め方(都度・締め請求)