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