Nightos Pos Adapter

NIGHTOS マルチPOS連携の新規アダプター作成テンプレート。 新POS対応時にこのスキルに従う。 トリガー: POS連携追加、新POS対応、POSアダプター、CSV取込追加、マルチPOS拡張 --- ## アーキテクチャ ``` batch/pos-adapters/ ├── base-adapter.js # 抽象基底（共通syncToDatabase） ├── registry.js # メタデータ（UI表示用） ├── dedup.js # 重複検出（pos_type + pos_slip_no） ├── customer-matcher.js # 顧客名ファジーマッチ+自動作成 ├── business-day.js # 営業日（バッチ用） ├── [posname]-adapter.js # 各POS実装 └── generic-csv-adapter.js # 汎用CSV（動的マッピング） ``` --- ## テンプレート: 新規アダプター ファイル: `batch/pos-adapters/[posname]-adapter.js` ```javascript const { BasePosAdapter } = require('./base-adapter') class [PosName]Adapter extends BasePosAdapter { get displayName() { return '[POS表示名]' } async fetchAndNormalize(params) { // CSV: fs.readFileSync(params.filePath) // API: fetch(endpoint, { headers: { Authorization: this.config.apiKey } }) return rows.map(row => ({ externalSlipNo: row['伝票No'], // 重複検出キー（必須） visitedAt: this._parseDate(row['日付']), // JST日時 customerName: (row['顧客名'] || '').trim(), castName: (row['担当'] || '').trim(), spendAmount: parseInt(row['金額'], 10) || 0, partySize: parseInt(row['人数'], 10) || 1, rawData: row, })) } async testConnection() { try { // 接続テストロジック return { success: true, message: '接続OK' } } catch (err) { return { success: false, message: err.message } } } _parseDate(dateStr) { if (!dateStr) return new Date() return new Date(dateStr.replace(/\//g, '-')) } } module.exports = { [PosName]Adapter } ``` --- ## registry.js に追加 ```javascript '[posname]': { displayName: '[POS名]', description: '[説明]', pattern: '*.csv', authMethod: 'csv_upload', // csv_upload | api_key | oauth features: { sales: true, visits: true, attendance: false, customers: false },

インストール

購入後にターミナルで実行してください。

正規購入者にはインストールコマンド再実行で最新版が配信されます。

評価とレビュー