テンプレート / CSV変換

CSV変換ルールJSONテンプレート

変換前CSVと取込先CSVの差分を、列対応表とJSONに落とし込むための公開テンプレートです。実装前の仕様整理や、個別設定代行のヒアリングにも使えます。

使うタイミング

会計ソフト、販売管理、在庫管理、ECモールなどへCSVを取り込む前に、毎回同じ修正をしている場合に使います。

列対応表

変換前カラム	変換後カラム	変換内容	注意点
注文日	date	yyyy/mm/ddへ変換	空欄は確認
合計金額	amount	カンマ、円記号、空白を除去	小数点以下0桁
郵便番号	postal_code	文字列として保持	先頭ゼロを消さない

変換ルールJSON

{
  "schemaVersion": 1,
  "name": "EC売上CSV_会計取込用",
  "input": {
    "encoding": "cp932",
    "delimiter": "comma",
    "hasHeader": true
  },
  "output": {
    "encoding": "utf-8-bom",
    "newline": "crlf",
    "delimiter": "comma"
  },
  "columns": [
    {
      "source": "注文日",
      "target": "date",
      "enabled": true,
      "order": 1,
      "transform": {
        "type": "date",
        "format": "yyyy/mm/dd"
      }
    },
    {
      "source": "合計金額",
      "target": "amount",
      "enabled": true,
      "order": 2,
      "transform": {
        "type": "currency",
        "removeComma": true,
        "removeCurrencySymbol": true,
        "trimWhitespace": true,
        "decimalPlaces": 0
      }
    }
  ],
  "fixedColumns": [
    {
      "target": "source",
      "value": "EC",
      "order": 3
    }
  ]
}

確認すべきこと

入力CSVの文字コードはUTF-8、UTF-8 BOM、Shift_JIS、CP932のどれか。
区切り文字はカンマ、タブ、セミコロンのどれか。
取込先CSVに必要なカラム名と列順は何か。
JAN、電話番号、郵便番号、会員番号など先頭ゼロ保持が必要な列はどれか。
日付、金額、数値の変換後形式は何か。