「楽楽販売」と「楽楽明細」のAPI連携における項目の紐付け(マッピング)は、項目名の一致ではなく、「項目の並び順(左からの順番)」によって行われる仕組みです。
そのため、どのデータがどこに連携されるかを確認するには、連携を実行するメニューの裏側にある画面設定を開き、項目の配置順序を特定する必要があります。
この仕様を理解せずに「楽楽販売」側の項目名だけを変更しても、連携先の項目は切り替わりません。必ず「楽楽販売」と「楽楽明細」双方の「並び順」を突き合わせて確認してください。
【設定箇所】現場の環境でどの項目が紐づいているかを正確に特定するための手順は以下の通りです。
1. 「楽楽販売」で連携に使用しているメニューと画面設定を特定する
・ 「楽楽販売」の「データベース設定(スパナマーク)」>「基本設定」>「メニュー設定」を開きます。
・ 「楽楽明細」連携を実行している対象メニュー(レコード一覧タイプ)の「設定」ボタンをクリックします。
・ 「全体設定」の「設定」ボタンをクリックし、「一覧画面設定の初期選択」でどの画面設定(例:明細連携用画面、など)が選ばれているかを確認します。
2. 「楽楽販売」側の項目の並び順を確認する
・ 「データベース設定」>「表示設定」>「レコード一覧画面設定」を開きます。
・ 手順1で特定した画面設定の「設定」ボタンをクリックします。
・ 画面下部の項目リストに並んでいる順番(上から下への順)が、実際の連携時に「左から右への列順」として「楽楽明細」へ送られます。この順番をメモまたはキャプチャします。
3. 「楽楽明細」側の取込順序と照らし合わせる
・ 「楽楽明細」の管理画面にログインし、対象の帳票設定(または顧客CSV取込設定)のCSVレイアウト設定画面を開きます。
・ 「楽楽明細」側で定義されている項目の順番(1列目、2列目...)と、手順2で確認した「楽楽販売」側の項目の順番を順番通りに並べて比較します。
例:「楽楽販売」のリストで3番目にある「売上金額」は、「楽楽明細」側の設定で3番目に定義されている項目に流し込まれます。
画面上での一時的な表示項目の変更は反映されません
レコード一覧画面のユーザー操作で、一時的に表示項目を変更しても、API連携で送信されるデータの順番には影響しません。
データの正確性を保つための仕組み上、必ず「レコード一覧画面設定」の「設定」画面内にあるマスターの並び順が適用されます。
紐付けを変更したい場合は、必ず設定画面から項目の順序を上下に移動させてください。
項目名が異なっていても連携されます
「楽楽販売」側の項目名が「単価」で、「楽楽明細」側の項目名が「商品単価」のように名称が異なっていても、並び順(列番号)さえ一致していればデータは正常に転記されます。
名称ではなく「何番目の項目か」を重視して管理してください。
非表示項目は連携対象外です
「レコード一覧画面設定」で「非表示」にしている項目は、API連携のデータにも含まれません。
特定の項目を連携対象から外したい場合は、対象の画面設定でその項目を非表示に設定してください。
詳細な仕様の違いや作成手順については、下記記事をご確認ください。
連携を実行する際の具体的な操作手順や、一度に連携できるレコード数の上限などの仕様について解説しています。
「楽楽明細」連携オプション:実行方法
連携順序の基準となる、一覧画面での項目の追加・削除や並び順の変更方法について詳しく解説しています。
レコード一覧画面設定
(記事ID:2902)