Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

会計freee API相関図 レコード作成編

1,292 views

Published on

会計freee APIのレコードデータの相関図資料です。

Published in: Technology
  • Be the first to comment

  • Be the first to like this

会計freee API相関図 レコード作成編

  1. 1. freee 株式会社
 会計freee API相関図
 レコード作成編
 v20200619

  2. 2. 凡例と読み方
 2 色と記載内容に応じて読み進めてください
 事業所 GET Companies 発生日 issue_date アクセストークン取得した ユーザーに取引の作成権 限がない CompaniesというEndpointをGETメソッドでコールして、情報を取得します。取 得できたIDや値を利用してください。
 issue_dateというプロパティにAPIリファレンスにある型に応じた値を入れてくだ さい。
 入力必須のパラメータとなります。
 エラーの説明と解決策へのリンクを含んでいます。権限には大きくわけて二つ あり、freeeのアカウント、ユーザーに紐づく権限と、アプリ(APIをコールする Oauthクライアント)のOauth2.0におけるスコープによる権限があります。
 item_idというfreeeをより便利につかうための任意で利用できるプロパティで す。APIリファレンスにある型に応じた値を入れてください。
 品目 item_id <freee基本用語> 取引とは 口座とは タグとは

  3. 3. freee APIで取引の作成をする
 取引を作成するまでの流れとAPIリファレンスへのリンク集 
 deals API 取引作成 POST 詳細>勘定科目 GET Account Items 取引先 partner_id/code 支払行一覧>口座ID GET Walletables 品目 item_id メモタグ(Tags) tag_ids ファイルボックス receipts_id 事業所ID? 部門 section_id セグメントタグ(Segments) segment_#_tag_id 取引作成 指定した事業所が正しくな い アクセストークンが無効 /有 効期限切れ アプリのスコープに事業所 の参照、取引の参照、作成 がない アクセストークン取得した ユーザーに取引の作成権 限がない 事業所 GET Companies 上記エラー別に確認を行い、リト ライしてください より便利に使え る情報追加? (任意) 必須項目取 得済? 税区分 GET Taxes YES
 YES
 Status code
 403
 Status code:401
 ⓘ 緑四角や最後のアクションのところからAPIリファレンスやWebページにリンクを張っています 発生日 issue_date 収支区分 type 詳細>取引金額 details > amount 支払行一覧>支払金額 payments > amount 支払行一覧>口座区分 GET Walletables 支払行一覧>支払日 payments > date <freee基本用語> 取引とは 口座とは タグとは
 任意情報取 得、追加

  4. 4. freee APIで請求書を作成する
 請求書を作成するまでの流れとAPIリファレンスへのリンク集
 invoices API 請求書作成 POST 請求内容>順序 invoice_contents > order ステータス invoice_status 請求内容>行の種類 invoice_contents > type 請求書作成 請求書名 title ⓘ 緑四角や最後のアクションのところからAPIリファレンスやWebページにリンクを張っています 指定した事業所が正しくな い アクセストークンが無効 /有 効期限切れ アプリのスコープに事業所 の参照、請求書の参照、作 成がない アクセストークン取得した ユーザーに請求書の作成 権限がない 上記エラー別に確認を行い、リト ライしてください Status code
 403
 Status code:401
 品目 item_id メモタグ(Tags) tag_ids 事業所ID? セグメントタグ(Segments) segment_#_tag_id 事業所 GET Companies より便利に使え る情報追加? (任意) 必須項目取 得済? YES
 ● normal
 ● discount
 右の必須項目取得と指定
 type? YES
 text
 請求内容>数量 invoice_contents > qty 請求内容>単価 invoice_contents. > unit_price 勘定科目 GET Account Items 税区分 GET Taxes 部門 section_id 取引先 partner_id/code 請求書に表示する取引先名 partner_display_name 敬称 partner_title 任意情報取 得、追加

  5. 5. freee APIで見積書を作成する
 見積書を作成するまでの流れとAPIリファレンスへのリンク集
 quotations API 見積書作成 POST 見積内容>順序 quotation_contents > order ステータス quotation_status 見積内容>行の種類 quotation_contents > type 品目 item_id メモタグ(Tags) tag_ids 事業所ID? セグメントタグ(Segments) segment_#_tag_id 見積書作成 事業所 GET Companies より便利に使え る情報追加? (任意) 必須項目取 得済? 見積書名 title YES
 任意情報取 得、追加
 ⓘ 緑四角や最後のアクションのところからAPIリファレンスやWebページにリンクを張っています 取引先 partner_id/code 指定した事業所が正しくな い アクセストークンが無効 /有 効期限切れ アプリのスコープに事業所 の参照、見積書の参照、作 成がない アクセストークン取得した ユーザーに見積書の作成 権限がない 上記エラー別に確認を行い、リト ライしてください Status code
 403
 Status code:401
 見積書に表示する取引先名 partner_display_name 敬称 partner_title type? YES
 text
 見積内容>数量 quotation_contents > qty 見積内容>単価 quotation_contents. > unit_price 勘定科目 GET Account Items 税区分 GET Taxes 部門 section_id ● normal
 ● discount
 右の必須項目取得と指定

  6. 6. freee APIで振替伝票を作成する
 振替伝票を作成するまでの流れとAPIリファレンスへのリンク集
 manual_journals API 振替伝票 POST 事業所ID? 振替伝票作成 指定した事業所が正しくな い アクセストークンが無効 /有 効期限切れ アプリのスコープに事業所 の参照、振替伝票の参照、 作成がない アクセストークン取得した ユーザーに振替伝票の作 成権限がない 上記エラー別に確認を行い、リト ライしてください より便利に使え る情報追加? (任意) 必須項目取 得済? 詳細>税区分 GET Taxes YES
 YES
 Status code
 403
 Status code:401
 ⓘ 緑四角や最後のアクションのところからAPIリファレンスやWebページにリンクを張っています 取引先 partner_id/code 詳細>勘定科目 GET Account Items 発生日 issue_date 貸借 details > entry_side 詳細>取引金額 details > amount 事業所 GET Companies 品目 item_id メモタグ(Tags) tag_ids 部門 section_id セグメントタグ(Segments) segment_#_tag_id任意情報取得、 追加

  7. 7. freee APIで各種申請を作成する
 各種申請レコードを作成するまでの流れとAPIリファレンスへのリンク集
 approval_requests API 各種申請作成 POST 申請日 application_date 申請フォーム GET Approval_requests/forms 事業所ID? 各種申請作成 事業所 GET Companies より便利に使え る情報追加? (任意) 必須項目取 得済? 承認者 GET Approval flow routes YES
 申請経路 GET Approval flow routes 申請中で作成/下書きで作成 draft 親申請 parent_id 項目>項目ID GET Approval_requests/forms 項目>項目タイプ GET Approval_requests/forms 項目>項目の値 request_items > value 申請フォーム別 の必須項目? YES
 承認者の指定 が必要な申請 経路? 承認者を取得
NO
 指定した事業所が正しくな い アクセストークンが無効 /有 効期限切れ アプリのスコープに事業所 の参照、各種申請の参照、 作成がない アクセストークン取得した ユーザーに各種申請の作 成権限がない 上記エラー別に確認を行い、リト ライしてください Status code
 403
 Status code:401
 必須項目を取得
 [APIで申請レコードを登録する前に]
 以下に沿って流れをつかむ、必要情報を理解することを推奨します
 1. 会計freee Webで[APIテスト用の]各種申請フォーム作成、申請経路作成、申請レコード作成する
 ○ APIとレスポンスの関係をつかみやすくするため
 2. 各種申請レコードの取得API(Show):作成した個別の申請をGETして、レスポンスを確認する
 ○ 申請フォーム、申請経路、承認者などの関係性を把握
 3. ここまでのステップで把握できた内容をもとに新しい各種申請レコードを作成してみましょう
 会計freeeエンタープライズプランのみ利用可
 任意情報取得、追加 
 <freee各種申請APIの使い方> 用語とユースケース別の使い方のポイント
  8. 8. 8 スモールビジネスを、世界の主役に


×