このセクションの記事

「請求データと入金データの照合作業が面倒...」と感じたことはありませんか？

バージョン2.17以降のソアスクでは、入金消込サービス「V-ONEクラウド」へデータを連携できるようになりました！

そこで本記事では、ソアスクの納品データをViewFramer・D3Workerを経由してV-ONEクラウドへ登録する方法をご紹介します。

 V-ONEクラウドの詳細はこちら

 

目次 

本記事は内容量が多いため、目次に細かい階層を用意しています。

 

事前準備

カスタム項目の作成

ViewFramerでレコードを抽出する条件として使用するため、納品・請求明細リレーションオブジェクトに以下のカスタム項目を作成します。

どちらもデータ型は数式(テキスト)です。ページレイアウトに追加する必要はありません。

 

納品・請求明細リレーションオブジェクト

「納品ID」項目（API参照名：OutboundDeliveryId__c）

CASESAFEID(appsfs__fs_Delivery_Detail__r.appsfs__fs_OutboundDelivery__c)

「請求ID」項目（API参照名：BillingId__c）

CASESAFEID(appsfs__fs_Bill_Detail__r.appsfs__fs_Billing__c)

 

納品データ

請求済みの納品データを使用してください。
(バージョン2.17以降で請求データを作成した納品レコードが対象です)

outbound_order_detail.PNG
outbound_order_related_list.PNG

 

納品明細レコードの以下の項目値を、V-ONEクラウドとの連携で使用します。

 納品明細レコードの項目名

 対応する請求/得意先データのパラメータ
V-ONEの請求データのための項目
 納品.請求先.取引先番号  得意先コード
 請求明細.請求.請求書発行日  請求日
 金額 + 税額  請求金額
 請求明細.請求.支払期日  入金予定日
 納品.部門.債権管理連携ID  請求部門
 計上日  売上日
 請求明細.請求.請求番号  請求書番号
 請求明細.請求.請求締日  請求締日
 納品.主担当者.債権管理連携ID  担当者
 任意の項目  備考
 任意の項目  備考
 任意の項目  備考
 任意の項目  備考
V-ONEの得意先データのための項目
 納品.請求先.取引先番号  得意先コード
 納品.請求先.取引先名  得意先名
 納品.請求先.取引先名カナ  得意先名カナ
 納品.請求先.手数料負担区分  手数料負担区分
 納品.請求先.請求先：締日  締日
 納品.請求先.回収方式  回収方法
 納品.請求先.請求先：支払月  回収予定（月）
 納品.請求先.請求先：支払日  回収予定（日）
 -  回収予定（都度請求）
 請求先.主担当者.債権管理連携ID  営業担当者
 任意の項目  備考

※「任意の項目」もしくは「-」と記載されている項目以外は連携において必須の項目ですので、値が入っていることを確認した上でV-ONEにデータを連携してください。
※請求先（取引先）や部門、主担当者（要員マスタ）の情報は、V-ONEに登録されている得意先マスタ、請求部門マスタ、営業担当者マスタと同じものを入力してください。
※請求締日が請求日より前の日付であったり、入金予定日が請求締日より前の日付であった場合、V-ONEにデータを連携する際にエラーとなります。ご注意ください。

 

請求取込パターン 

上の表の「V-ONEの請求データのための項目」のカラム順でCSVデータがV-ONEクラウドに連携されます。

これに合わせてV-ONEクラウドの請求フリーインポーターの取込設定でパターンを設定してください。（そのパターンNo.をD3Workerのサービス設定6.の[請求取込パターン]で指定します）

また、パターンでは「取込開始行」は1に、「最終行を取込処理しない」と「得意先マスターを自動生成する」はオフに設定してください。

 

得意先取込パターン 

上の表の「V-ONEの得意先データのための項目」のカラム順でCSVデータがV-ONEクラウドに連携されます。

これに合わせてV-ONEクラウドの得意先マスターの取込設定でパターンを設定してください。
（そのパターンNo.をD3Workerのサービス設定6.の[得意先取込パターン]に指定します）

また、パターンでは「取込開始行」は1に、「最終行を取込処理しない」はオフに設定してください。

目次に戻る

 

D3Workerの設定①

ここでは、V-ONEの請求データとしてソアスクの納品明細データを送るための設定をします。

 

サービスの設定

 「ダミー文書」サービス と「V-ONEクラウド 請求データ登録」サービスを使用します。

 

「ダミー文書」サービス

設定方法については、以下の記事をご参照ください。

 

「V-ONEクラウド 請求データ登録」サービス

以下の手順でサービスを設定します。

  1. D3Workerへログインします。
  2. ログイン後、「サービス」タブを選択します。
  3. サービスを定義するため、「新規作成」を選択します。

    AWS000018.JPG
  4. サービスタイプの選択にて「V-ONEクラウド 請求データ登録」を選択します。

    v-one_service_type.png
    ※ご利用中のD3Workerテナントで当サービスが存在しない場合、オプロサポートにお問合せください。
  5. サービスの名称（作成した全サービス内で一意のもの）とメモ（任意）を入力します。

    name_and_memo.PNG
  6. V-ONEクラウドのAPIエンドポイントURL、アクセストークン、請求取込パターンNo.（事前準備で指定済みのもの）、得意先取込パターンNo.（事前準備で指定済みのもの）を入力し、「接続の確認」をクリックします。
    「接続に成功しました」と表示されたら、接続情報の入力は完了です。

    connection_check.png

  7. 画面を下にスクロールして、「請求データ登録後に実行するワーク」の情報を入力します。
    ここでの「請求データ登録後に実行するワーク」は、V-ONEへの連携が成功した納品明細レコードの債権連携に関するフラグの値を更新するワークを指します。

    「フィールド値」の横の+ボタンをクリックして行を2つ用意し、それぞれに「納品明細ID」「連携日時」と入力します。
    vone_service_successive_work.PNG
    以上の作業が終わったら、サービスを保存します。

目次に戻る 

 

エンベロープの設定

エンベロープの名称とメモを入力し、お好みで属性を指定したら、文書化サービスに「ダミー文書」を基に作成したサービスを、配送サービスに「V-ONEクラウド 請求データ登録」を基に作成したサービスを指定します。

・文書化サービス

envelope_document.PNG

・配送サービス

envelope_delivery_new.png

「V-ONEクラウド 請求データ登録」を基に作成したサービスを選択したら、「エンベロープパラメータの一括設定」をクリックして各項目のエンベロープパラメータを作成します。

 

画面を下にスクロールして、「請求データ登録後に実行するワーク」の情報を入力します。

ここでは、実行するワークに「納品明細の債権管理フラグを更新する」を、フィールド値に {納品明細ID}、{連携日時} の2つのエンベロープパラメータを使用します。

envelope1_successive_work.PNG

 

目次に戻る 

 

ワークの設定

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

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

work_envelope.png

 

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

work_datasource.PNG

 

再度「エンベロープ」タブに移動して、エンベロープフィールドに「納品明細ID」を指定します。

envelope_field.PNG

 

以上の設定が済んだら、ワークを保存します。

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

 

目次に戻る 

 

D3Workerの設定②

設定①に続き、ここではV-ONEの請求データとして登録できた納品明細について、債権管理連携に関わる項目の値を書き換えるための設定を行います。

 

サービスの設定

「ダミー文書」サービス と「Salesforce Files [配送]」サービスを使用します。

 

「ダミー文書」サービス

D3Workerの設定①で作成したサービスをそのまま使用するため、ここでの作業は不要です。

 

「Salesforce Files [配送] 」サービス

設定方法については、以下の記事をご参照ください。

V-ONEクラウド連携に関する納品明細レコードの項目を更新するための設定をします。

salesforce_delivery_service_settings.PNG

オブジェクトのAPI参照名には「納品明細」オブジェクトのAPI参照名「appsfs__OutboundDeliveryDetail__c」を、項目のAPI参照名には「債権管理連携済み」項目のAPI参照名「appsfs__fs_ReceivablesManagementCooperated__c」と「債権管理連携日時」項目のAPI参照名「appsfs__fs_ReceivablesManagementCooperationDate__c」を入力します。

 

目次に戻る 

 

エンベロープの設定

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

・文書化サービス

envelope_document.PNG

・配送サービス

envelope_delivery_2.png

「Salesforce Files [配送] 」を基に作成したサービスを指定したら、赤枠で囲んだ部分を入力します。
「{納品明細ID}」「{連携日時}」「true」については、文字を変えずにこの通り入力してください。

 

目次に戻る 

 

ワークの設定

「基本」タブで名称とメモを入力します。
ここでは、名称は「納品明細の債権管理フラグを更新する」とします。

work2_basic.PNG

※名称は、1つ目のエンベロープ設定で「実行するワーク」として入力した値と同じにしてください。

 

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

1つ目のワーク同様「エンベロープパラメータからデータソースを構築」をクリックして、データソースのフィールドを自動作成します。

work2_envelope.PNG

 

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

work2_datasource.PNG

 

再度「エンベロープ」タブに移動して、エンベロープフィールドに「納品明細ID」を指定します。

envelope_field.PNG

 

以上の設定が済んだら、ワークを保存します。

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

 

目次に戻る 

 

ViewFramerの設定

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

 

ビューの作成

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

view_relation_updated.PNG
 

以下の項目を出力項目とします。

view_output_updated.PNG

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

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

 出力項目名
 Sector.appsfs__fs_ReceivablesManagementCooperationId__c  請求部門コード
 Account.AccountNumber  得意先コード
 Account.Name  得意先名
 Account.appsfs__fs_AccountNameKana__c  得意先名カナ
 Account.appsfs__fs_FeeBurdenClass__c  得意先/手数料負担区分コード
 Account.appsfs__fs_CollectionType__c  得意先/回収区分コード
 FORMAT_NUMBER(Account.appsfs__fs_PaymentMonth__c,'0')  得意先/回収予定（月）
 IF(FORMAT_NUMBER(Account.appsfs__fs_PaymentDay__c,'#,##0')='0' ,'99', FORMAT_NUMBER(Account.appsfs__fs_PaymentDay__c,'#,##0'))  得意先/回収予定（日）
 IF(FORMAT_NUMBER( Account.appsfs__fs_CloseDay__c ,'#,##0')='0' ,'99', FORMAT_NUMBER(Account.appsfs__fs_CloseDay__c,'#,##0'))  得意先/締日
 FORMAT_DATE(OutboundDeliveryDetail.appsfs__fs_RecordDate__c,'yyyy/MM/dd')  請求/売上日
FORMAT_NUMBER( OutboundDeliveryDetail.appsfs__fs_Amount__c + OutboundDeliveryDetail.appsfs__fs_Tax__c, '0' )  請求金額
 FORMAT_DATE(NOW(),'yyyy-MM-dd HH:mm:ss')  連携日時
 MainOwner.appsfs__fs_ReceivablesManagementCooperationId__c  得意先/営業担当者コード
 FORMAT_DATE( Billing.appsfs__fs_CloseDate__c , 'yyyy/MM/dd')  請求締日
 Billing.Name  請求書番号
 FORMAT_DATE(Billing.appsfs__fs_PaymentDate__c, 'yyyy/MM/dd')  請求/入金予定日
 OutboundDeliveryDetail.Id  納品明細ID
 FORMAT_DATE(Billing.appsfs__fs_BillDate__c, 'yyyy/MM/dd')  請求日
 ''  得意先/回収予定（都度請求）
 MainOwner.appsfs__fs_ReceivablesManagementCooperationId__c  請求/担当者コード
 ''  得意先/備考
 ''  請求/備考1
 ''  請求/備考2
 ''  請求/備考3
 ''  請求/備考4

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

 

  • 親納品の「請求済み」にチェックが付いており
  • 「 債権管理連携済み」がOFFであり
  • 「 債権管理連携日時」が空である

納品明細に限りV-ONEにデータを連携する設定にするため、出力条件を以下のように設定します。

view_condition_updated.PNG

※「パラメーター」の

  • OutboundDeliveryIds
  • BillingAccountIds

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

目次に戻る

 

マッピングの作成

ここでは、ビューをD3Workerのワークに紐づけます。

帳票タイプに「一覧型」を選択し、「取得」をクリックします。

最大件数には500000を指定します。

mapping_basic.png

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

 

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

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

mapping_d3w_select_work.png

 

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

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

mapping_d3w.png

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

目次に戻る 

 

請求データ登録ボタンの設置

請求データをV-ONEに登録するためのアクションボタンを作成します。

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

 mappingNm:'マッピング名',

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

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

 

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

output_button.png

 

V-ONEクラウドに請求データが登録されました。

v-one_record_registered.PNG

 

納品明細レコードの「債権管理連携済み」項目、「債権管理連携日時」項目も更新されています。

outbound_delivery_detail_updated.png

 

注意点 

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

目次に戻る 

 

おわりに

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

本記事がソアスクとV-ONEクラウドを連携する際の参考になれば幸いです。

 

関連記事