BtoBプラットフォーム連携サービス

トップ -> 外部連携仕様 -> 機能仕様


  • BtoB プラットフォーム 受発注 for 製造業を、「BtoBプラットフォーム」と記載しています。
  • 発注業務を持ち、他システムとCSV形式で入出力できる仕組みがあるアプリケーションを「外部システム」と記載しています。


  • 新規の取引先を登録する

    [ 機能 ]
    • 外部システムで用意したCSV形式の取引先データを、BtoBプラットフォームにアップロードできます。
    • 外部システムの取引先コードで、BtoBプラットフォームと連携できるようになります。

    [ 仕様 ]
    • 連携キーは取引先コードです。
    • 取引先マスタの連携直後の、招待ステータスは「未招待」です。
    • 同一取引先コードの連携は、データ修正となります。取引先の招待ステータスにより変更項目に制限がかかります。
      [ 招待ステータス ]
      未招待 データ連携直後。すべて修正できます。
      招待中 相手企業を招待中。「メールアドレス」が修正できません。
      利用中 相手企業が利用開始後。修正できません。
    • 売買フラグは、一つの取引先コードに両方(売りも買いもする)を割当することはできません。
      [ 売買フラグ ]
      1:受注→発注 得意先を連携する場合に選択します。
      2:発注→受注 仕入先を連携する場合に選択します。「Link Client Agent」の発注連携はこちらが対象です
    • 取引先名は、連携値のキーワードで「法人格」と「会社名」に分けて登録します。
      法人格の指定がないときは、前株として連携します。
      環境依存文字(㈱、㈲など)は、法人格ワードと判断しません。
      [ 取引先名 ]
      取引先名(連携する値) 法人格 前後 会社名
      株式会社テクノア 株式会社 テクノア
      テクノア株式会社 株式会社 テクノア
      有限会社テクノア 有限会社 テクノア
      テクノア 株式会社 テクノア
      ㈱テクノア 株式会社 ㈱テクノア
    • 取引先担当者は、最初のスペースで「姓」と「名」に分けて登録します。
      スペースがない場合、「姓」に登録します。
      [ 取引先担当者 ]
      取引先担当者
      テクノア 太郎 テクノア 太郎
      テクノア花子 テクノア花子
    • 取引先E-mailは、取引先招待メールに使用します。
      未設定の状態での連携はできますが、取引先を招待する際に、BtoBプラットフォーム上で設定する必要があります。


  • 取引先コードの関連付けをする

    「新規の取引先を登録する」を使用して連携した場合は、連携時点で関連付けされていますので、この操作は不要です。

    [ 機能 ]
    • 外部システムで用意したCSV形式の取引先関連付けデータを、BtoBプラットフォームにアップロードできます。
    • BtoBプラットフォーム上で作成した取引先に対して、外部システムの発注書を連携できるようになります。

    [ 仕様 ]
    • BtoBプラットフォームの取引先ID(内部キー)と、外部システムの取引先コードとの変換表を作成します。
    • BtoBプラットフォームの取引先IDに対し、外部システムの取引先コードを関連付けします。
    • 関連付けされた外部システムの取引先コードは、他のBtoBプラットフォームの取引先IDと関連付けできません。
      BtoBプラットフォーム取引先ID 外部システム取引先コード チェック判定
      100 A ○:「100」と「A」を関連付け
      200 A ×:「A」は「100」と関連付けしているのでエラー
    • 関連付けされたBtoBプラットフォームの取引先IDは、他の外部システムの取引先コードに関連付けができます。
      最初に関連付けされていた外部システムの取引先コードとの関連付けは解除されます。
      関連付けが解除された外部システムの取引先コードは、別のBtoBプラットフォームの取引先IDとの関連付けに使用できます。
      BtoBプラットフォーム取引先ID 外部システム取引先コード チェック判定
      100 A ○:「100」と「A」を関連付け
      100 B ○:「100」と「B」を関連付け (100とAの関連付け解除)
      200 A ○:「200」と「A」を関連付け


  • 取引先一覧をダウンロード

    [ 機能 ]
    • BtoBプラットフォームの取引先一覧をCSVファイルでダウンロードできます。
    • BtoBプラットフォームの取引先IDを確認できます。

    [ 仕様 ]
    • BtoBプラットフォームの外部サービス取込で選択チェックした取引先を、CSVファイルでダウンロードします。
    • BtoBプラットフォームに取込完了通知を送信します。
      BtoBプラットフォーム上で外部サービス取込の選択チェックは外され、取込済に変更されます。


  • 発注書を登録(取消)する

    [ 機能 ]
    • 外部システムから発注データを出力し、BtoBプラットフォームにアップロードできます。
    • 発注データに対して、図面等の添付ファイルをアタッチすることができます。

    [ 仕様 ]
    • 発注伝票No.と発注明細No.が連携キーになります。
      発注伝票No.はシステム内で一意となり、発注明細No.は発注伝票No.内で一意に特定できる必要があります。
    • 1つの発注伝票No.に複数の明細を登録できます。最大200明細まで対応します。
    • 仕入先コードは、外部システムの取引先コードを指定します。
      事前に、取引先登録にてBtoBプラットフォームの取引先マスタと関連付けしておく必要があります。
    • 納期確定した発注明細を変更連携した場合は、変更発注として表現されます。
    • 連携区分によって、登録か取消か決定できます。
      取消は伝票単位で行い、CSV上の発注伝票No.以外の内容は読み取りません。
      0:登録 新規登録か修正をします。新規登録か修正かはBtoBプラットフォームが判断します。
      取引先にメールで通知されます。
      1:取消 取消します。取消はいつでも可。
      取消した発注伝票は、取引先にメール通知されます。
    • 1発注伝票No.に複数の明細を登録する場合、ヘッダはCSV先頭行の情報を使用します。
      以下例の場合、仕入先は「A社」となります。
      連携区分 発注伝票No. 仕入先 発注明細No. 品名 -
      1 0 1000 A社 1000-01 ASY01 ヘッダ情報に使用するCSV行
      2 0 1000 B社 1000-02 ASY02
    • 連携処理の時系列はCSVファイルの行順です。
      発注伝票No.が変わるタイミングで1つの発注データとします。
      1つのCSVファイルに同一発注伝票No.が複数回連携することもできます。
      連携区分 発注伝票No. 仕入先 発注明細No. 品名 -
      1 0 1000 A社 1000-01 ASY01 発注伝票No.1000の新規登録
      2 0 1000 A社 1000-02 ASY02
      3 0 2000 B社 2000-01 ASY01 発注伝票No.2000の新規登録
      4 1 1000 - - - 発注伝票No.1000の取消
      5 0 2000 B社 2000-01 ASY01-upd 発注伝票No.2000の修正
    • 発注伝票No.内の明細追加及び一部明細の取消は、
      差分ではなく該当発注伝票No.内の発注データ全体を連携してください。
      [新規作成]
      連携区分 発注伝票No. 仕入先 発注明細No. 品名 -
      1 0 1000 A社 1000-01 ASY01 発注伝票No.1000の新規登録
      2 0 1000 A社 1000-02 ASY02
      [更新 / 発注明細No.1000-02内容変更、1000-03追加]
      連携区分 発注伝票No. 仕入先 発注明細No. 品名 -
      1 0 1000 A社 1000-01 ASY01 変更がなくても連携する
      2 0 1000 A社 1000-02 ASY02-02 内容変更
      3 0 1000 A社 1000-03 ASY03 追加明細
      [更新 / 発注明細No.1000-02削除、1000-04追加]
      連携区分 発注伝票No. 仕入先 発注明細No. 品名 -
      1 0 1000 A社 1000-01 ASY01 変更がなくても連携する
      2 0 1000 A社 1000-03 ASY03 変更がなくても連携する
      3 0 1000 A社 1000-04 ASY04 追加明細
    • 伝票課税区分は、課税単位区分が伝票の場合に使用します。
      0:外税 伝票発注金額を元に、外税計算します。
      1:内税 伝票発注金額を元に、内税計算します。
      2:非課税 税計算対象外です。
      3:免税 税計算対象外です。
    • 税端数処理区分は、税計算結果に対する小数第一位の端数処理に使用します。
    • 課税単位区分は、税計算を行う範囲決めに使用します。
      0:伝票単位 発注伝票の集計に対して、税計算します。
      1:明細単位 発注伝票内の各明細毎に、税計算します。
      2:請求単位 締月単位の集計で1回、税計算します。各発注伝票での税額計算は行いません。
    • 金額端数処理区分は、数量×単価による小数第一位の端数処理に使用します。
    • 伝票発注金額、伝票外税金額、伝票内税金額、伝票金額は、明細金額の積上げで再計算されます。
      伝票発注金額に連携する値は参考値です。
    • 伝票納期は、参考値です。取引先が回答するのは、明細の納期に対してとなります。
    • FAX送信フラグは、取引先にFAX通知するかどうかを決めます。
      0:FAX送信なし 取引先にFAX通知しません。(メール通知のみ)
      1:FAX送信する 取引先にFAXで通知します。(メール+FAX通知)
      取引先がFAX通知サービスを利用していない場合は、FAX通知されません。
    • 伝票添付ファイル1~5は、発注伝票に対して添付するファイルをフルパスで指定します。
      一つのファイルで、20MB以下にしてください。上限を超えた場合は、アップロードエラーとなります。
      以下の拡張子は、添付ファイルに使用することができません。
      .ade .adp .apk .bat .chm .cmd .com .cpl .dll .dmg .exe .hta .ins .isp .jar .js .jse .lib .lnk  .mde .msc .msi .msp .mst .nsh .pif .scr .sct .shb .sys .vb .vbe .vbs .vxd .wsc .wsf .wsh .cab
    • 伝票添付ファイル1に設定した添付ファイルは、FAX送信フラグ「FAX送信する」場合に、FAX送信対象ファイルとなります。
      発注データを、FAX送信で通知するが、添付ファイルはFAX送信したくない場合は、伝票添付ファイル2以降を使用してください。
    • 非公開リザーブ1~5は、取引先に表示されないリザーブ項目です。社内用のメモに使用できます。
    • 公開リザーブ1~20は、取引先に表示されるリザーブ項目です。標準項目で不足する場合に使用します。
    • 発注行No.は、BtoBプラットフォーム上での表示順となります。
      必ずしも連番である必要はありませんが、数値の若い順に並びます。
    • 発注単価区分は、仮単価の運用がある場合に使用します。
      0:確定 正式単価の発注です。
      1:未確定 仮単価発注になります。未定理由、決定予定日を合わせて設定します。
    • 発注金額は連携値を使用します。発注数×単価で再計算されません。
    • 課税区分は、課税単位区分が明細の場合に使用します。
      0:外税 発注金額を元に、外税計算します。
      1:内税 発注金額を元に、内税計算します。
      2:非課税 税計算対象外です。
      3:免税 税計算対象外です。
    • 軽減税率区分は参考値です。税率には適切な数値を設定してください。
    • 支給区分は参考値です。加工依頼の場合に設定してください。
    • 希望納期は取引先に希望する納期です。
      BtoBプラットフォームでは、取引先が希望納期を元に納期回答します。
    • 明細添付ファイル1~3は、発注明細に対して添付するファイルをフルパスで指定します。
      添付ファイルの制限は、伝票添付ファイル1~5と同様です。
    • 発注回答納期1~5と発注回答数量1~5は、取引先の納期回答に使用します。
      発注回答納期1と発注回答数量1以外は、取引先の分納回答に使用します。
      発注回答納期1~5と発注回答数量1~5は、発注登録時には未使用項目となりますので、値を設定しても無効となります。
    • 明細非公開リザーブ1~10は、取引先に表示されないリザーブ項目です。社内用のメモに使用できます。
    • 明細公開リザーブ1~20は、取引先に表示されるリザーブ項目です。標準項目で不足する場合に使用します。


  • 発注書を取消する

    [ 機能 ]
    • 外部システムから発注伝票No.を指定し、発注書を取消します。
    • 発注書を登録するの機能で、連携区分=取消を使う場合と同一の仕様です。

    [ 仕様 ]
    • 指定した発注伝票No.を取消します。取消のタイミングに制限はありません。
      取消した発注伝票は、取引先にメール通知されます。


  • 発注状況を登録する

    [ 機能 ]
    • 外部システムの発注伝票№、明細№を指定し、発注状況を更新します。
      状況の更新のみで、実際の受入データ、検収データが作成されるわけではありません。

    [ 仕様 ]
    • 連携キーは、発注伝票No.と発注明細No.です。
    • 指定した発注伝票No.の発注明細毎に、納入状況、検収状況を登録します。
      どの状況であっても、いつでも更新することができます。
    • 累計納入数は、発注明細に対する合計納入数を設定してください。
    • 納入完了区分は「途中完了」か「完了」に変更された時点で、納期確定になります。
      納期確定後は、発注伝票の更新・削除ができなくなります。変更する場合は取引先で納期回答を再度していただく必要があります。
    • 納入完了区分は、以下を指定します。
      0:未完了 発注直後。発注済の未納入
      1:一部完了 分割納品中
      2:途中完了 打切り。累計納入数が0の打切り可。
      3:完了 納入済
    • 納入完了日は、納入完了区分「途中完了」か「完了」の場合に設定してください。
    • 累計検収数は、発注明細に対する合計検収数を設定してください。
    • 検収完了区分は、以下を指定します。
      0:未完了 発注直後。発注済の未検収
      1:一部完了 分割検収中
      2:途中完了 打切り。累計検収数が0の打切り可。
      3:完了 検収済
    • 検収完了日は、検収完了区分「途中完了」か「完了」の場合に設定してください。


  • 発注回答納期をダウンロード

    [ 機能 ]
    • BtoBプラットフォームの発注一覧をCSVファイルでダウンロードできます。
    • 外部システムから連携した発注データの他、BtoBプラットフォーム上で取引先が入力した、回答納期、単価などを取得します。

    [ 仕様 ]
    • BtoBプラットフォームの外部サービス取込で選択チェックした発注一覧を、CSVファイルでダウンロードします。
    • 発注伝票No.毎にダウンロードするため、外部サービス取込の選択チェック行かどうかは、「対象区分」で判断してください。
    • BtoBプラットフォームに取込完了通知を送信します。
      取込完了通知にて、BtoBプラットフォーム上で外部サービス取込の選択チェックは外され、取込済に変更されます。


  • 受入情報を登録する

    [ 機能 ]
    • 外部システムから発注伝票No.を指定し、受入情報を登録します。

    [ 仕様 ]
    • 連携キーは、発注伝票No.と発注明細No.です。
    • 発注数を上回る受入数を登録した場合、自動的に受入完了の状態になります。
    • 外部システムの受入データと紐付けする為、外部受入ID(外部システム一意)または外部受入番号を登録できます。
    • 出荷金額を指定することにより、同時に【出荷情報の登録】させる事もできます。
      (受注側で作成するデータを発注側から作ることになるためお勧めしません)
    • 完了区分を指定することにより、同時に【受入完了】させる事もできます。
    • 受入完了後の受入情報の修正は
       [完了区分]=「2」(受入解除)
       [受入数]=マイナス値
      で赤処理で連携後、
       [完了区分]=「0」 or 「1」
       [受入数]=正しい値
      として黒処理で連携をしてください。
    • 検収単価、検収金額、検収取引メッセージ、外部検収ID、外部検収番号のいずれかを指定することにより、
      同時に【検収情報の登録】させる事もできます。


  • 受入を終わらせる

    [ 機能 ]
    • 外部システムから発注伝票No.を指定し、受入完了状態を更新します。

    [ 仕様 ]
    • 連携キーは、発注伝票No.と発注明細No.です。
    • 発注数に満たない受入数で、受入完了としたり、受入完了を取り消したりできます。


  • 受入情報をダウンロード

    [ 機能 ]
    • BtoBプラットフォームの受入情報をCSVファイルでダウンロードできます。

    [ 仕様 ]
    • BtoBプラットフォーム上で登録した受入情報(状態:変更あり)をCSVファイルでダウンロードできます。
    • 正常にダウンロード、CSVファイルが保存されると取込完了通知が行われ、対象データの状態が【変更なし】に更新されます。
    • 最終受入日、最終受入数、最終受入単価、最終受入単価区分、最終受入単価区分名は
      最後に登録した受入データの値となります。(受入処理都度の値ではありませんのでご注意ください)
    • 受入完了した場合、受入完了明細を未完了にした場合(「受入処理に戻す」)の
      納入ステータスが変わった場合もダウンロード対象となります。
      どちらの場合も最終受入日、最終受入数、最終受入単価、最終受入単価区分、最終受入単価区分名は
      前回受入登録したデータの値のままとなります。
    • 受入数の算出は、合計受入数、納入ステータスを貴社システム内で保持していただき、
      BtoBプラットフォームからダウンロードされる合計受入数と貴社システムに保持されている合計受入数を比較し、
      差数を算出していただくような形をお勧めします。
      貴社システムとBtoBプラットフォーム両方の合計受入数が同じである場合は、
      納入ステータスの変更があるかを比較し、完了状況に変更が発生しているかも合わせてご確認ください。
    • 手動ダウンロードの場合は条件として【最終受入日】範囲、【最終出荷日】範囲を指定できます。


  • 出荷情報をダウンロード

    [ 機能 ]
    • BtoBプラットフォームで仕入先様が処理した出荷情報をCSVファイルでダウンロードできます。

    [ 仕様 ]
    • BtoBプラットフォーム上で登録された出荷情報(状態:変更あり)をCSVファイルでダウンロードできます。
    • 正常にダウンロード、CSVファイルが保存されると取込完了通知が行われ、対象データの状態が【変更なし】に更新されます。
    • 出荷明細番号、出荷日時、出荷日、出荷単価、出荷単価区分、出荷単価区分名、出荷単位名、出荷金額、出荷数量は
      最後に登録した出荷データの値となります。(出荷処理都度の値ではありませんのでご注意ください)
    • 出力対象が上記条件のため、出荷数の算出は、合計出荷数を貴社システム内で保持していただき、
      BtoBプラットフォームからダウンロードされる合計出荷数と貴社システムに保持されている合計出荷数を比較し、
      差数を算出していただくような形をお勧めします。
    • 手動ダウンロードの場合は条件として【最終出荷日】範囲を指定できます。


  • 検収情報を登録する

    [ 機能 ]
    • 外部システムから発注伝票No.を指定し、検収情報を登録します。

    [ 仕様 ]
    • 連携キーは、発注伝票No.と発注明細No.です。
    • 外部システムの検収データと紐付けする為、外部検収ID(外部システム一意)または外部検収番号を登録できます。


  • 検収情報の関連付けをする

    [ 機能 ]
    • 外部システムの検収データと紐付けする為、外部検収ID(外部システム一意)または外部検収番号を登録します。

    [ 仕様 ]
    • 連携キーは、BtoBプラットフォームの検収番号です。


  • 検収を確定する

    [ 機能 ]
    • 外部システムから外部検収ID(外部システム一意)を指定し、検収状態を更新します。

    [ 仕様 ]
    • 連携キーは、外部検収ID(外部システム一意)または、BtoBプラットフォームの検収番号です。
    • 検収確定、または検収確定取消できます。
    • 更新前に連携キーが存在するかチェックするかを指定できます。


  • 検収情報をダウンロード

    [ 機能 ]
    • BtoBプラットフォームの検収情報をCSVファイルでダウンロードできます。

    [ 仕様 ]
    • BtoBプラットフォーム上で登録した検収情報(状態:変更あり)をCSVファイルでダウンロードできます。
    • 正常にダウンロード、CSVファイルが保存されると取込完了通知が行われ、対象データの状態が【変更なし】に更新されます。
    • ダウンロード条件として【検収日】範囲を指定できます。