Community

コミュニティをご利用の際は 【ガイドライン】を確認・同意いただいた上でご利用ください。

  • 投稿

    アバターmicrowave

    複合仕訳のAPI連携について

    お世話になります。

    現在、基幹システム内にて仕訳を行っており、別ベンダーの会計パッケージへ連携を行っております。
    大幅なシステムリプレイスの動きがあり、会計パッケージは 会計freee を使う事となりましたが、同様に、基幹システム側で作成した仕訳データを 会計freee 側へ連携する必要があります。
    そこで、以下の様な複合仕訳が発生しており、その場合、APIを用いてどのように連携するべきか、御指南いただきたく存じ上げます。
    使用する API は、Deals: 取引(収入/支出)を考えております。
    Deals を使用する場合、貸借の勘定科目が必須項目であるため、その点がクリアになればよいかと存じます。
    以下、パターンとなります。

    (パターン1)
    伝票NO  行NO    借方      金額    貸方        金額
    001     1     交通費     1,364    現金        1,500
    001     2     消費税      136

    (パターン2)
    伝票NO  行NO    借方     金額     貸方      金額
    002     1    支払手数料   35,851   支払手数料   67,400
    002     2    支払手数料    2,869
    002     3    支払手数料    2,868
    002     4    支払手数料   25,812

    ご回答の程、よろしくお願い申し上げます。

    回答

    アバターyakumo

    パターン1, 2 のような取引を登録したいがその時の API の実行方法がわからない?
    といった質問ですか?

    上記だとすると。

    1. 利用する勘定科目を確認する
    GET /api/1/account_items
    を利用して利用したい勘定科目のidを調べる

    2. 明細行を複数指定して、任意のパラメータで取引を作成する
    上記、勘定科目ID等を利用して、
    POST /api/1/deals
    を実行して取引を作成する。

    といった形かと思います。
    詳細なパラメータはリファレンスを確認いただければと。

    相手勘定科目に関してはこちらのヘルプが参考になると思います。
    勘定科目の設定・追加を行う

    アバターmicrowave

    ご回答ありがとうございます。

    APIの実装方法は分かっており、借方/貸方の両方に該当する勘定科目がセットされている通常の仕訳について、基幹システムから会計freeeに仕訳データを連携するような仕組みは、既に作っております。

    今回、ご質問させていただいた件は、例に挙げたような複合仕訳(借方/貸方の勘定科目が N:1 のデータ)が発生した場合、APIにどのようにデータをセットするべきかが分からないため、こちらに質問を挙げさせていただいております。
    Deals API を使った場合、借方と貸方の両方に勘定科目をセットすることが必須であると思っております。

    (パターン1)
    交通費 1,364 円 / 現金 1,500 円
    消費税 136 円

    パターン1 の場合、以下の様なAPIを実行することで実現できるかと思っているのですが、貸方の {勘定科目} ? 円 に何をセットしてよいのか不明です。
    1. POST /deals を利用し [交通費 1,364 円 / 現金 1,500 円] を登録
    2. POST /deals/{id}/renews を利用し [消費税 136 円 / {勘定科目} ? 円]を登録

    (パターン2)
    支払手数料 35,851 円 / 支払手数料 67,400 円
    支払手数料 2,869 円
    支払手数料 2,868 円
    支払手数料 25,812 円

    パターン2 の場合、以下の様なAPIを実行することで実現できるかと思っているのですが、パターン1 同様、貸方の {勘定科目} ? 円 に何をセットしてよいのか不明です。
    1. POST /deals を利用し [支払手数料 35,851 円 / 支払手数料 67,400 円] を登録
    2. POST /deals/{id}/renews を利用し [支払手数料 2,869 円 / {勘定科目} ? 円]を登録
    3. POST /deals/{id}/renews を利用し [支払手数料 2,868 円 / {勘定科目} ? 円]を登録
    4. POST /deals/{id}/renews を利用し [支払手数料 25,812 円 / {勘定科目} ? 円]を登録

    非常にお手数ではございますが、ご回答の程、よろしくお願い申し上げます。

    アバターyakumo

    deals は収入取引、支出取引の選択のみなので片方しか登録出来ないと思います。
    複数行に関しては details に複数登録すれば登録できます。
    相手勘定科目は一行にまとめられると思います。
    ※ 実際にリクエストを投げていただくとわかるかと思います。

    相手勘定科目に関しては、前回の投稿のリンクを確認ください。
    また、一度 freee の取引は振替伝票とは異なるのでこちらもヘルプを確認いただくとよいのかなと思います。

    https://support.freee.co.jp/hc/ja/articles/360019714252–%E5%8F%96%E5%BC%95-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6