コンテンツにスキップ

SMILEマスタデータ(フィクスチャ)リファレンス

目的

  • SMILE連携で使用する検証用フィクスチャのヘッダーを整理し、列の役割を明確化する。
  • 仕様判断は /docs/specifications/ 内の元仕様書を正とする。
  • 用語対応は docs/glossary.md の「システム用語対照表(SMILE連携マッピング)」に従う。
  • 本ドキュメント内の 商品コード は、用語集の 商品コード(SKU) に対応する。

対象ファイル

インポートデータ

import/: SMILE → Vendure の取り込み対象データ

  • apps/vendure-server/tests/integration/fixtures/smile/import/tanka.txt(単価マスタ:掛率分類別)
  • apps/vendure-server/tests/integration/fixtures/smile/import/suryou-tanka.txt(数量別単価マスタ:商品ごとの数量別価格)
  • apps/vendure-server/tests/integration/fixtures/smile/import/suryou-tanka-tokuisaki.txt(数量別単価マスタ顧客先別:顧客単体の数量別価格)
  • apps/vendure-server/tests/integration/fixtures/smile/import/suryou-tanka-bunrui.txt(数量別単価マスタ分類別:顧客分類(グループ)ごとの数量別価格)
  • apps/vendure-server/tests/integration/fixtures/smile/import/tokuisaki.txt(得意先マスタ)
  • apps/vendure-server/tests/integration/fixtures/smile/import/shouhin.csv(商品マスタ)
  • apps/vendure-server/tests/integration/fixtures/smile/import/nouhinsaki.txt(納品先マスタ)

エクスポートデータ

export/: Vendure → SMILE への出力で期待されるデータ

  • apps/vendure-server/tests/integration/fixtures/smile/export/jutyu.txt(出力受注データ)
  • apps/vendure-server/tests/integration/fixtures/smile/export/nouhinsaki.txt(出力納品先データ)

文字コード・区切り

ファイル 文字コード 区切り 読み方例
tanka.txt UTF-16LE CSV(カンマ) iconv -f UTF-16LE -t UTF-8 apps/vendure-server/tests/integration/fixtures/smile/import/tanka.txt
suryou-tanka.txt UTF-16LE CSV(カンマ) iconv -f UTF-16LE -t UTF-8 apps/vendure-server/tests/integration/fixtures/smile/import/suryou-tanka.txt
suryou-tanka-tokuisaki.txt UTF-16LE CSV(カンマ) iconv -f UTF-16LE -t UTF-8 apps/vendure-server/tests/integration/fixtures/smile/import/suryou-tanka-tokuisaki.txt
suryou-tanka-bunrui.txt UTF-16LE CSV(カンマ) iconv -f UTF-16LE -t UTF-8 apps/vendure-server/tests/integration/fixtures/smile/import/suryou-tanka-bunrui.txt
tokuisaki.txt UTF-16LE TSV(タブ) iconv -f UTF-16LE -t UTF-8 apps/vendure-server/tests/integration/fixtures/smile/import/tokuisaki.txt
nouhinsaki.txt UTF-16LE TSV(タブ) iconv -f UTF-16LE -t UTF-8 apps/vendure-server/tests/integration/fixtures/smile/import/nouhinsaki.txt
shouhin.csv UTF-8(BOM) CSV(カンマ) sed '1q' apps/vendure-server/tests/integration/fixtures/smile/import/shouhin.csv

ヘッダー対応表

数量別単価の判定ルール(数量単価系)

数量単価系ファイル(suryou-tanka*.txt)は、 / 数量(上限) / 数量別単価 の組で段階単価を定義する。

数量(上限) 数量別単価 判定
1 23 3000 1〜23個は3000円
2 99999 2400 24個以上は2400円

列名の説明(共通・解釈できるもの)

以下はヘッダー名から意味が特定できるもののみを補足する。判断不能なものは無理に説明しない。

列名 説明
得意先コード 得意先コード(用語集の customerCode)
請求先コード 請求先コード(用語集の billingCustomerCode)
納品先コード 納品先コード(用語集の shipToCode)
商品コード 商品コード(用語集の SKU)
単価マスター区分 単価マスタの区分
単価種類 単価の種類(適用単位の違い)
単価種別 単価の計算種別
単価 単価(金額)
単価掛率 単価に適用する掛率
単価変更日付 単価変更の基準日
変更後単価使用区分 変更後単価の適用可否区分
期間単価対象日付 期間単価の対象日
数量(上限) 段階単価の上限数量
数量別単価 数量段階ごとの単価
郵便番号 郵便番号
住所1/住所2/住所3 住所情報
電話番号 電話番号
FAX番号 FAX番号
通貨コード 通貨コード
通貨略称 通貨の略称
標準売上単価 標準の売上単価
上代単価 上代(定価)単価
注文単位数量 注文の最小単位数量

単価種別の判定(単価マスタ)

単価種別 判定
0 単価列をそのまま使用
1 使用しない
2 使用しない
3 エンドユーザー向け価格 × 掛率

単価マスター区分の運用(単価マスタ)

  • 単価マスター区分は 0 固定。それ以外の値は考慮しない。

単価マスタの未使用ヘッダー

以下のヘッダーは使用しない。

  • 単価変更日付
  • 変更後単価使用区分
  • 期間単価対象日付
  • 変更後単価
  • 変更後単価掛率
  • 通貨コード
  • 通貨略称

価格適用の優先順位(顧客単体 vs 顧客分類)

  • 価格や顧客別設定は、顧客グループ(分類)よりも顧客単体を優先する。

import/tanka.txt(単価マスタ:掛率分類別)

列名 値/役割 用語対応
単価マスター区分 区分
単価マスター区分名 区分名
単価種類 種類
単価種類名 名称
取引先コード コード
取引先名 名称
売上掛率分類コード 掛率
売上掛率分類名 名称
商品コード コード SKU(商品コード)
商品名 名称
単価分類コード 単価
単価分類名 名称
単価種別 単価
単価種別名 名称
単価 単価
単価掛率 掛率
単価変更日付 未使用
変更後単価使用区分 未使用
期間単価対象日付 未使用
変更後単価 未使用
変更後単価掛率 未使用
通貨コード 未使用
通貨略称 未使用

import/suryou-tanka.txt(数量別単価マスタ:商品ごとの数量別価格)

列名 値/役割 用語対応
単価マスター区分 区分
単価マスター区分名 区分名
単価種類 種類
単価種類名 名称
取引先コード コード
取引先名 名称
売上掛率分類コード 掛率
売上掛率分類名 名称
商品コード コード SKU(商品コード)
商品名 名称
単価変更日付 単価
変更後単価使用区分 区分
期間単価対象日付 単価
単価区分 区分
単価区分名 区分名
未確認
数量(上限) 数量
数量別単価 単価
通貨コード コード
通貨略称 略称

import/suryou-tanka-tokuisaki.txt(数量別単価マスタ顧客先別:顧客単体の数量別価格)

列名 値/役割 用語対応
単価マスター区分 区分
単価マスター区分名 区分名
単価種類 種類
単価種類名 名称
取引先コード コード
取引先名 名称
売上掛率分類コード 掛率
売上掛率分類名 名称
商品コード コード SKU(商品コード)
商品名 名称
単価変更日付 単価
変更後単価使用区分 区分
期間単価対象日付 単価
単価区分 区分
単価区分名 区分名
未確認
数量(上限) 数量
数量別単価 単価
通貨コード コード
通貨略称 略称

import/suryou-tanka-bunrui.txt(数量別単価マスタ分類別:顧客分類(グループ)ごとの数量別価格)

列名 値/役割 用語対応
単価マスター区分 区分
単価マスター区分名 区分名
単価種類 種類
単価種類名 名称
取引先コード コード
取引先名 名称
売上掛率分類コード 掛率
売上掛率分類名 名称
商品コード コード SKU(商品コード)
商品名 名称
単価変更日付 単価
変更後単価使用区分 区分
期間単価対象日付 単価
単価区分 区分
単価区分名 区分名
未確認
数量(上限) 数量
数量別単価 単価
通貨コード コード
通貨略称 略称

import/tokuisaki.txt(得意先マスタ)

列名 値/役割 用語対応
得意先コード コード customerCode(得意先コード)
得意先名 名称
売上掛率分類コード 掛率
売上掛率分類名 名称
得意先分類1コード コード
得意先分類1名 名称
地区Noコード コード
地区No名 名称
特別分類コード コード
特別分類名 名称
担当ADVコード コード
担当ADV名 名称
重複得意先コード コード
重複得意先名 名称
得意先分類6コード コード
得意先分類6名 名称
得意先分類7コード コード
得意先分類7名 名称
導入状況コード コード
導入状況名 名称
金融機関コード コード
金融機関名 名称
納品先コード コード shipToCode(納品先コード)
納品先名 名称
納品先索引 索引
荷受け人名1 未確認
荷受け人名2 未確認
郵便番号 郵便番号
住所1 住所
住所2 住所
住所3 住所
カスタマバーコード コード
電話番号 電話番号
FAX番号 FAX番号
マスター検索表示区分 区分
マスター検索表示区分名 区分名
有効期間開始日 未確認
有効期間終了日 未確認

export/nouhinsaki.txt(納品先マスタ)

列名 値/役割 用語対応
得意先コード コード customerCode(得意先コード)
得意先名1 未確認
得意先名2 未確認
得意先名略称 略称
得意先名索引 索引
郵便番号 郵便番号
住所1 住所
住所2 住所
住所3 住所
カスタマバーコード コード
電話番号 電話番号
FAX番号 FAX番号
売上掛率分類コード 掛率
売上掛率分類名 名称
得意先分類1コード コード
得意先分類1名 名称
地区Noコード コード
地区No名 名称
特別分類コード コード
特別分類名 名称
担当ADVコード コード
担当ADV名 名称
重複得意先コード コード
重複得意先名 名称
得意先分類6コード コード
得意先分類6名 名称
得意先分類7コード コード
得意先分類7名 名称
導入状況コード コード
導入状況名 名称
金融機関コード コード
金融機関名 名称
請求先コード コード billingCustomerCode(請求先コード)
請求先名 名称
請求先区分 区分
請求先区分名 区分名
売上掛率分類コード 掛率
売上掛率分類名 名称
請求先分類1コード コード
請求先分類1名 名称
地区Noコード コード
地区No名 名称
特別分類コード コード
特別分類名 名称
担当ADVコード コード
担当ADV名 名称
重複得意先コード コード
重複得意先名 名称
請求先分類6コード コード
請求先分類6名 名称
請求先分類7コード コード
請求先分類7名 名称
導入状況コード コード
導入状況名 名称
金融機関コード コード
金融機関名 名称
担当者コード コード
担当者名 名称
ブロックコード コード
ブロック名 名称
形態コード コード
形態名 名称
職種コード コード
職種名 名称
担当者分類3コード コード
担当者分類3名 名称
担当者分類4コード コード
担当者分類4名 名称
担当者分類5コード コード
担当者分類5名 名称
担当者分類6コード コード
担当者分類6名 名称
担当者分類7コード コード
担当者分類7名 名称
担当者分類8コード コード
担当者分類8名 名称
担当者分類9コード コード
担当者分類9名 名称
締日1 未確認
締日2 未確認
締日3 未確認
入金日1 未確認
入金日2 未確認
入金日3 未確認
入金サイクル1 未確認
入金サイクル名1 未確認
入金サイクル2 未確認
入金サイクル名2 未確認
入金サイクル3 未確認
入金サイクル名3 未確認
入金条件1 未確認
入金条件名1 未確認
入金条件2 未確認
入金条件名2 未確認
入金条件3 未確認
入金条件名3 未確認
与信限度額 未確認
単価掛率区分 区分
単価掛率区分名 区分名
単価掛率 掛率
単価ランク 単価
単価処理区分 区分
単価処理区分名 区分名
単価処理単位 単価
金額処理区分 区分
金額処理区分名 区分名
課税対象区分 区分
課税対象区分名 区分名
売上単価設定区分 区分
売上単価設定区分名 区分名
消費税通知区分 区分
消費税通知区分名 区分名
消費税計算区分 区分
消費税計算区分名 区分名
消費税計算単位 未確認
消費税分解区分 区分
消費税分解区分名 区分名
請求書出力タイプ 未確認
請求書出力タイプ名 名称
請求書出力形式 未確認
請求書出力形式名 名称
得意先台帳出力形式 未確認
得意先台帳出力形式名 名称
請求消費税算出単位 未確認
請求消費税算出単位名 名称
回収管理区分 区分
回収管理区分名 区分名
回収管理単位 未確認
回収管理単位名 名称
期首売掛残高 未確認
前回請求残高 未確認
相殺仕入先コード コード
相殺仕入先名 名称
日付印字区分 区分
日付印字区分名 区分名
相手先担当者名 名称
取引 未確認
取引名 名称
マスター検索表示区分 区分
マスター検索表示区分名 区分名
売上伝票出力区分 区分
売上伝票出力区分名 区分名
変換コード売上伝票出力区分 区分
変換コード売上伝票出力区分名 区分名
変換コード見積書出力区分 区分
変換コード見積書出力区分名 区分名
変換コード請求書出力区分 区分
変換コード請求書出力区分名 区分名
入力処理モード 未確認
入力処理モード名 名称
個別設定入力行数 未確認
契約区分 区分
契約区分 区分
運送代金 未確認
運送代金 未確認
金額印字 未確認
金額印字 未確認
回収方法 未確認
回収方法 未確認
得意先Mail 未確認
代表者名 名称
郵便番号 郵便番号
住所1 住所
住所2 住所
電話番号 電話番号
伝票等敬称 未確認
敬称 未確認
コード コード
運送会社名 名称
FAX番号 FAX番号
請求書回収方法 未確認
請求書回収方法 未確認
ADV番号 番号
ADV名 名称
代理注意 未確認
備考1 未確認
備考2 未確認
備考3 未確認
請求備考 未確認
売上日付区分(出荷) 日付
売上日付区分名(出荷) 日付
指定請求書使用区分 区分
指定請求書使用区分名 区分名
指定請求書番号 番号
指定請求書番号2 番号
マスター連携区分 区分
マスター連携区分名 区分名
EB入金手数料区分 区分
EB入金手数料区分名 区分名
EB入金手数料算出方法 未確認
EB入金手数料算出方法名 名称
EB入金回収消込方法 未確認
EB入金回収消込方法名 名称
有効期間開始日 未確認
有効期間終了日 未確認
売上検収区分 区分
売上検収区分名 区分名
出荷伝票出力区分 区分
出荷伝票出力区分名 区分名
変換コード出荷伝票出力区分 区分
変換コード出荷伝票出力区分名 区分名
複数回収設定 未確認
複数回収設定名 名称
回収設定切替額 未確認
回収設定方法1 未確認
回収設定方法名1 未確認
回収設定1 入金区分1 未確認
回収設定1 入金区分名1 未確認
回収設定1 入金率1 未確認
回収設定1 入金区分2 未確認
回収設定1 入金区分名2 未確認
回収設定1 入金率2 未確認
回収設定1 入金区分3 未確認
回収設定1 入金区分名3 未確認
回収設定1 入金率3 未確認
回収設定1 入金区分4 未確認
回収設定1 入金区分名4 未確認
回収設定1 入金率4 未確認
回収設定1 単位額設定 入金方法1 未確認
回収設定1 単位額設定 入金方法名1 未確認
回収設定1 単位額設定 基準単位額 未確認
回収設定1 単位額設定 入金方法2 未確認
回収設定1 単位額設定 入金方法名2 未確認
回収設定1 基準額設定 入金方法1 未確認
回収設定1 基準額設定 入金方法名1 未確認
回収設定1 基準額設定 基準額 未確認
回収設定1 基準額設定 基準額判断区分 区分
回収設定1 基準額設定 基準額判断区分名 区分名
回収設定1 基準額設定 入金方法2 未確認
回収設定1 基準額設定 入金方法名2 未確認
回収設定方法2 未確認
回収設定方法名2 未確認
回収設定2 入金区分1 未確認
回収設定2 入金区分名1 未確認
回収設定2 入金率1 未確認
回収設定2 入金区分2 未確認
回収設定2 入金区分名2 未確認
回収設定2 入金率2 未確認
回収設定2 入金区分3 未確認
回収設定2 入金区分名3 未確認
回収設定2 入金率3 未確認
回収設定2 入金区分4 未確認
回収設定2 入金区分名4 未確認
回収設定2 入金率4 未確認
回収設定2 単位額設定 入金方法1 未確認
回収設定2 単位額設定 入金方法名1 未確認
回収設定2 単位額設定 基準単位額 未確認
回収設定2 単位額設定 入金方法2 未確認
回収設定2 単位額設定 入金方法名2 未確認
回収設定2 基準額設定 入金方法1 未確認
回収設定2 基準額設定 入金方法名1 未確認
回収設定2 基準額設定 基準額 未確認
回収設定2 基準額設定 基準額判断区分 区分
回収設定2 基準額設定 基準額判断区分名 区分名
回収設定2 基準額設定 入金方法2 未確認
回収設定2 基準額設定 入金方法名2 未確認
取引パターン 未確認
取引パターン名 名称
販売外貨取引区分 区分
販売外貨取引区分名 区分名
通貨コード コード
通貨略称 略称
期首売掛残高(外貨) 未確認
初期表示レート種類 種類
初期表示レート種類名 名称
外貨入金サイクル 未確認
法人番号 番号
登録番号売上伝票出力 番号
登録番号売上伝票出力名 名称
登録番号請求書出力 番号
登録番号請求書出力名 名称
自社負担手数料入金後売上値引 未確認
自社負担手数料入金後売上値引名 名称

import/shouhin.csv(商品マスタ)

列名 値/役割 用語対応
商品コード コード SKU(商品コード)
商品名 名称
標準売上単価 単価 通常の顧客向け卸価格(ベース)
上代単価 単価 一般販売価格(希望小売価格相当)
部門コード コード
部門名 名称
用途コード コード
用途名 名称
消費税率区分 区分
新税率 税率
正式品名 名称
規格 未確認
注文単位数量 数量