このセクションの記事

本記事では、ソアスクの請求データをD3Workerを用いて会計フリー（会計freee）へ登録する方法をご紹介します。

支払データを登録する方法については【TECH COLUMN】ソアスクと会計フリーを連携する（仕入編）をご覧ください。

 

目次 

 

事前準備

請求データ

納品レコードに紐づく請求レコードを使用してください。

bill_screen.PNG

 

以下の項目値を、会計フリーとの連携で使用します。
項目名が「-」となっているものについては、D3Workerのエンベロープパラメータに空の値を渡します。

 項目名  対応する取引データのパラメータ
 -  出入金明細.出入金額
 -  出入金明細.口座ID
 -  出入金明細.口座区分
 -  出入金明細.日付
 -  収支明細.セグメント１ID
 -  収支明細.セグメント２ID
 -  収支明細.セグメント３ID
 -  収支明細.メモタグID
 請求明細.納品明細.備考  収支明細.備考
 請求明細.納品明細.科目マスタ.会計システム勘定科目ID*  収支明細.勘定科目ID
 請求明細.納品明細.金額 + 請求明細.納品明細.税額*  収支明細.取引金額
 請求明細.納品明細.品目マスタ.会計システム品目ID  収支明細.品目ID
 請求明細.納品明細.税額  収支明細.消費税額
 請求明細.納品明細.税率マスタ.会計連携用税区分コード*  収支明細.税区分コード
 請求明細.納品明細.納品.部門.会計システム部門ID  収支明細.部門ID
 income (固定値)*  取引ヘッダー.収支区分
 請求.請求番号  取引ヘッダー.取引の識別子
 請求.請求先.会計システム取引先ID  取引ヘッダー.取引先ID
 -  取引ヘッダー.取引先コード
 請求.支払期日  取引ヘッダー.期日
 請求.請求書発行日*  取引ヘッダー.発生日
 請求.請求番号  取引ヘッダー.管理番号

※末尾に「*」が付いている項目は連携において必須の項目ですので、値が入っていることを確認した上で会計フリーにデータを連携してください。
※会計システム勘定科目ID、会計システム品目ID、会計連携用税区分コード、会計システム部門ID、会計システム取引先IDの情報は、会計フリーに登録されているマスタデータのIDと同じものを入力してください。

 

各種マスタのデータは、「会計フリー 取引登録」サービス設定画面から確認可能です。

master_data_list.PNG

目次に戻る

 

D3Workerの設定

サービスの設定

 「ダミー文書」サービス と「会計フリー 取引登録」サービス、「Salesforce Files [配送]」サービスを使用します。
各サービスの設定方法は、以下の記事をご参照ください。

 Salesforce Files [配送] サービスでは、会計フリー連携に関する請求レコードの項目を更新します。

salesforce_delivery_service_settings.PNG

項目のAPI参照名には請求オブジェクトの「会計システム連携済み」項目のAPI参照名「appsfs__fs_AccountingCooperated__c」と「会計システム連携日時」項目のAPI参照名「appsfs__fs_AccountingCooperationDate__c」を入力します。

 

エンベロープの設定

エンベロープの名称とメモを入力し、お好みで属性を指定したら、文書化サービスに「ダミー文書」を基に作成したサービスを、配送サービスに「会計フリー 取引登録」を基に作成したサービスと「Salesforce Files [配送] 」を基に作成したサービスを指定します。

・文書化サービス

envelope_document.PNG

・配送サービス

envelope_delivery.png

「会計フリー 取引登録」を基に作成したサービスを選択したら、「エンベロープパラメータの一括設定」をクリックして各項目のエンベロープパラメータを作成します。

 

envelope_salesforce_delivery.PNG

「Salesforce Files [配送] 」を基に作成したサービスを指定したら、オブジェクトのAPI参照名、オブジェクトレコードのID、項目部分を入力します。
「appsfs__Billing__c」「{Salesforce請求ID}」「{連携日時}」「true」については、文字を変えずにこの通り入力してください。
また、ファイルの添付は「しない」に設定します。

 

ワークの設定

 名称とメモを入力したら、「エンベロープ」タブに移動します。

「エンベロープパラメータからデータソースを構築」をクリックすることで、エンベロープパラメータに対応するデータソースのフィールドが自動で生成され、それらがエンベロープパラメータの値として挿入されます。

work_envelope.png

 

以下のデータソースが作成されます。

work_datasource.PNG

  

※エンベロープの文書化サービスはダミー文書サービスを基に作成されているので、「文書とデータのマッピング」タブでの設定事項はありません。

目次に戻る

 

ViewFramerの設定

ここでは大まかな設定方法のみ紹介します。
D3Workerと連携するためのViewFramerの設定の詳細については、こちらの記事をご参照ください。

 

ビューの作成

リレーション設定

使用するオブジェクトのリレーション設定は以下です。

view_relation_upper.PNGview_relation_lower.PNG

 

出力項目設定

選択した各オブジェクトについて、以下の項目をD3Workerへの連携対象とします。

view_output_upper.PNGview_output_lower.PNG

 

「項目」の「項目ビルダー」をクリックしたときに表示される内容と、「出力項目名」の対応は以下です。

 「項目ビルダー」をクリックしたときに表示される内容

 出力項目名
 '' C1.出入金明細.出入金額
 '' C1.出入金明細.口座ID
 '' C1.出入金明細.口座区分
 '' C1.出入金明細.日付
 TitleMaster.appsfs__fs_AccountingAccountTitleId__c C1.収支明細.勘定科目ID
 '' C1.収支明細.セグメント１ID
 '' C1.収支明細.セグメント２ID
 '' C1.収支明細.セグメント３ID
 '' C1.収支明細.メモタグID
 OutboundDeliveryDetail.appsfs__fs_Note__c C1.収支明細.備考
 FORMAT_NUMBER( OutboundDeliveryDetail.appsfs__fs_Amount__c + OutboundDeliveryDetail.appsfs__fs_Tax__c , '0' ) C1.収支明細.取引金額
 Product.appsfs__fs_AccountingProductId__c C1.収支明細.品目ID
 FORMAT_NUMBER( OutboundDeliveryDetail.appsfs__fs_Tax__c, '0' ) C1.収支明細.消費税額
 TaxRateMaster.appsfs__fs_AccountingCooperationTaxCode__c C1.収支明細.税区分コード
 Sector.appsfs__fs_AccountingSectorId__c C1.収支明細.部門ID
 'income' P.取引ヘッダー.収支区分
 Billing.Name P.取引ヘッダー.取引の識別子
 Account.appsfs__fs_AccountingAccountId__c P.取引ヘッダー.取引先ID
 '' P.取引ヘッダー.取引先コード
 FORMAT_DATE( Billing.appsfs__fs_PaymentDate__c, 'yyyy/MM/dd' ) P.取引ヘッダー.期日
 FORMAT_DATE( Billing.appsfs__fs_BillDate__c, 'yyyy/MMdd' ) P.取引ヘッダー.発生日
 Billing.Name P.取引ヘッダー.管理番号
 FORMAT_DATE( NOW(), 'yyyy/MM/dd HH:mm:ss' )  連携日時
 Billing.Id  Salesforce請求ID

後の設定のため、ビューの「出力項目名」は、ワークのデータソースフィールド名と同じにしてください。

 

出力条件設定

  • 請求.会計システム連携済がオフ
  • 請求.会計システム連携日時が空値

である請求レコードのみを会計フリーへのデータ連携対象とするために、出力条件を以下のように設定します。
条件設定をするのは請求明細（BillingDetail）、請求（Billing）、納品明細（OutboundDeliveryDetail）、納品（OutboundDelivery）、取引先（Account）です。

view_condition_updated.PNG

※「パラメーター」の

  • BillingIds
  • OutboundDeliveryIds
  • BillingAccountIds

は、ViewFramerがレコードを効率的に取得するためのパラメーターになります。

目次に戻る

 

マッピングの作成

作成したビューをD3Workerのワークに紐づけます。

帳票タイプに「一覧型」を選択し、「取得」をクリックします。最大件数には500000を指定します。

以上が済んだら「次へ」をクリックします。

mapping_basic.png

 

「D3Worker」タブをクリックし、「URL」に以下のURLを入力したら、作成したワークを選択します。

https://d3w.ap.oproarts.com/d3w/api/{お客様用テナント}/

choose_work.png

 

選択したワークのデータソースにビューの項目を対応させたら、「配備」をクリックしてマッピングを使用可能な状態にします。

「自動マッピング」をクリックすることで、ワークのデータソースフィールドにビューの出力項目が自動で対応付けられます。

mapping_d3w.png

※「自動マッピング」をするためにはビューの出力項目名とワークのデータソースフィールド名を同じにする必要があります。

目次に戻る

 

取引登録ボタンの設置

請求データを会計フリーに登録するためのアクションボタンを作成します。

本記事最下部に添付されているVisualforceページ雛形をダウンロードし

 mappingNm:'マッピング名',

の「マッピング名」を作成したマッピング名（この記事で言うと「freee_sales_mapping」）で置き換えたVisualforceページを作成します。

編集したVisualforceページを基にリストボタンを作成し、請求オブジェクトのリストビューに設置してください。

 

請求レコードのリストビューで対象レコードにチェックを入れ、作成したボタンをクリックすると、、、

button.png

 

会計フリーに取引データが登録されました。

sales_deal_registered.PNG

 

請求レコードの「会計システム連携済み」項目、「会計システム連携日時」項目も更新されています。

cooperated_flag_checked.png

 

注意点 

  • 上の画像では請求レコードは1件のみでしたが、リストビューで複数の請求にチェックを入れればチェックを入れた全ての請求についてデータの連携が行われます。
  • 「会計システム連携済み」がオフかつ「会計システム連携日時」が空である請求のみが会計フリーへ連携されます。
  • 登録後は「会計システム連携済み」がオンに、「会計システム連携日時」がViewFramerへリクエストした日時に更新されるため、同じ請求データを再度連携してしまうことを防ぐことができます。

目次に戻る

 

おわりに

クラウド会計サービスとのシームレスな連携が実現されたことにより、ソアスクのデータを更に柔軟に活用することができるようになりました。

本記事がソアスクと会計フリーを連携する際の参考になれば幸いです。

 

関連記事