ご利用ガイド

thumbnail

NEXT ENGINE

NEXT ENGINGEのデータをALFタスクで呼び出して顧客に自動で案内できるアプリです。

このアプリでできること

NEXT ENGINEで連携している複数の販売チャネル（モール / 自社サイト）の在庫や受注状況をチャネルトークに連携して、ALFが自動で顧客対応できます。

  • 商品検索：商品名や商品コードから価格・在庫を確認

  • 在庫照会：商品コードから在庫数・引当数・フリー在庫を確認

  • 注文状況の確認：注文番号から状態・出荷日・追跡番号を確認

  • 注文履歴：電話番号やメールアドレスから該当顧客の注文履歴を表示

  • 注文キャンセル / 配送先変更 / 出荷保留 / 配送指定の変更（オプション）：チャット対応から受注伝票へ反映

事前準備

  • NEXT ENGINEの有料アカウント

    • 受注、商品、在庫の参照権限が必要です。

  • チャネルトークのオーナー権限

チャネルトークと連携する

NEXT ENGINEでの操作

NEXT ENGINE管理画面の [アプリを探す] でチャネルトークアプリを検索します。

[このアプリの詳細] をクリックし、[規約と情報の共有に同意して利用開始] を押すとNEXT ENGINE側でチャネルトークのアプリが有効化します。

NEXT ENGINEでチャネルトークアプリをインストールすると毎月3,300円（税込）がかかります。

チャネルトークでの操作

[チャネル設定] - [アプリストア] - [NEXT ENGINE] アプリをインストールします。

NEXT ENGINEアプリのインストール完了後、以下を対応します。

  1. [連携URL] をコピーしてブラウザで開きます。

  2. ログイン後に移動した先のURL全体を [連携コード] に貼り付けます。

  3. [保存] を押して設定を完了します。

連携コードは5分で失効します。取得したらすぐに貼り付けまで進めてください。失効した場合は、もう一度ログインし直すと新しいコードが取得できます。

ALFタスクで使用する

ALFタスクの「関数」ステップでNEXT ENGINEアプリを活用し、ALFが顧客の問い合わせに自動で応対することができます。

商品検索 getProduct

入力変数（どちらか一方）

項目

タイプ

説明

goodsId

String（任意）

商品コード（完全一致）

keyword

String（任意）

商品名キーワード（部分一致）

レスポンス

項目

タイプ

説明

found

boolean

1件以上見つかったか

count

number

ヒット件数（最大10件）

goods[].goodsId

string

商品コード

goods[].goodsName

string

商品名

goods[].price

number

売価（円）

goods[].stock

number

在庫数

summaryText

string

そのまま顧客に送信できる検索結果の文面

JSON

在庫照会 getInventory

入力変数

項目

タイプ

説明

goodsId

String（必須）

商品コード（完全一致）

レスポンス

項目

タイプ

説明

found

boolean

商品が見つかったか

stockQuantity

number

在庫数（総数）

allocationQuantity

number

引当数（受注に確保済みの数）

freeQuantity

number

フリー在庫数

（新規で販売可能な数）

summaryText

string

そのまま顧客に送信できる在庫案内の文面

JSON

注文状況の確認 getOrderStatus

入力変数

項目

タイプ

説明

orderNo

String（必須）

注文番号（店舗側）

レスポンス

項目

タイプ

説明

found

boolean

受注が見つかったか

orderNo

string

注文番号（店舗側）

statusName

string

受注状態の名称（例：新規受付 / 納品書印刷待ち / 出荷済み）

cancelled

boolean

キャンセル済みか

（案内の正として使用）

shipped

boolean

出荷済みか

shippedDate

string

出荷確定日（未出荷は空文字）

sendPlanDate

string

発送予定日（未設定は空文字）

trackingNumber

string

追跡番号（未発行は空文字）

summaryText

string

状況に応じて自動編集された案内文（キャンセル済み/発送済み＋追跡番号/発送予定日を出し分け）

JSON

  • キャンセル後も statusName は残ります。

  • 顧客への案内には cancelled と summaryText をお使いください。

追加のレスポンス項目

タスク側で状態を厳密に判定したい場合に使用します。

項目

タイプ

説明

statusId

string

受注状態の生ID。「印刷済みは受付不可」のような判定を、名称の文字列一致ではなくIDで安全に行える。

confirmCheckId

string

確認区分ID。1 = 未確認(確認待ち = 出荷保留中) / 2 = 確認済み

shopId / shopName

string

店舗コードと店舗名。モール経由の注文かどうかの判断に使える。

errorCode

string

エラー時の機械判別コード

明細（受注数・引当数）を一緒に取得する

入力時に includeRows: true を指定すると明細ごとの受注数と引当数も返します。（規定はfalse）

項目

説明

rows[].quantity / allocationQuantity

明細ごとの受注数と引当数

allocationFulfilled

全明細の引当が充足しているか

（false は引当待ちを意味する）

JSON

受注状態が同じでも「引当待ち」と「印刷日待ち」は別の状態です。キャンセル受付の可否を分ける場合は allocationFulfilled 使用してください。明細の取得にAPIの呼び出しが1回追加されるため、必要に応じてtrueにすることをおすすめします。

注文履歴 getOrders

入力変数

項目

タイプ

説明

identifier.type

String

  • phone

  • email

identifier.value

String

電話番号・メールアドレス(受注伝票の登録値と完全一致)

since

String（任意）

この日時以降の受注に絞り込み

limit

Number（任意）

既定10

レスポンス

項目

説明

payment.state

入金状況を反映します。

  • pending（未入金）

  • partially_paid（一部入金）

  • paid（入金済み）

buyer

購入者情報（name / email / phone）。

本人確認の照合に使用できる。

shippingAddress

送り先情報（lastName / zipcode / address1 / address2 / phoneNumber）。

配送先確認に使用できる。

items[].state

キャンセル済みの注文は「キャンセル済み」と表示されます。キャンセル済みの伝票はNEXT ENGINA側で金額がクリアにされるため、payment.totalAmount は 0 になります。金額を案内する場合は items[].amount × quantity（明細は残ります）をご使用してください。

JSON

getOrdersとgetOrderStatusの使い分け

  • getOrders：「この顧客の注文は何がある？」

    — 電話番号やメールから注文履歴を確認する

  • getOrderStatus：「この注文番号は今どうなってる？」

    — 番号から状態・追跡番号を確認する

注文キャンセル cancelOrder

入力変数

項目

タイプ

説明

orderNo

string（必須）

注文番号

cancelTypeId

string（任意）

  • キャンセル区分

  • 省略時は「1: 顧客依頼によりキャンセル」

レスポンス

項目

タイプ

説明

success

boolean

処理が実行されたか。falseはエラーではなく「実行しなかった理由付きの正常応答」

orderNo

string

対象の注文番号

summaryText

string

実行結果または実行できない理由と代替案内。モールの注意書きを含む

  • 成功した場合

JSON

  • 失敗した場合

    • 実行失敗した場合はエラーではなく理由を含むレスポンスが返ってくる

    • 出荷済み・キャンセル済みの注文は自動的に拒否し、代替の案内を返す

JSON

success = false の主なパターン：受注が見つからない / 既にキャンセル済み / 出荷済み(返品案内) / 機能が未有効 / 無効なキャンセル区分(利用可能な区分一覧を返却)

モール経由の注文について

NEXT ENGINE上の更新のみでは、モール側の注文や返金は変更されません。モール注文のキャンセルは、モール側の手続きも併せて対応する必要があります。

（応答文にも常に注意書きが付きます）

キャンセル・配送先変更の機能は初期状態では無効です。

ご利用を希望される場合はチャネルトークまでお問い合わせください。

配送先変更 changeShippingAddress

入力変数

項目

タイプ

説明

orderNo

String（必須）

注文番号

zipCode

String（任意）

新しい郵便番号

address1

String（任意）

新しい住所1

（都道府県・市区町村）

address2

String（任意）

新しい住所2

（番地・建物）

  • 住所項目は1つ以上指定する必要があります。

  • 指定した項目だけが更新され、未指定の項目は元のまま残ります・

  • 出荷前の注文のみを変更できます。

レスポンス

JSON

配送指定の変更 changeDeliveryOption

配達希望日・時間帯・納品書印刷指示日・発送伝票備考を変更します。

「日時指定の変更」「置き配希望の追記」といった要望に対応できます。

入力変数

項目

タイプ

説明

orderNo

string（必須）

注文番号

hopeDeliveryDate

string（任意）

配達希望日（YYYY-MM-DD）

hopeDeliveryTimeSlotId

string（任意）

配達希望時間帯の区分ID（例: 1 = 午前中）。発送方法により有効な値が異なります。

statementPrintingDate

string（任意）

納品書印刷指示日（YYYY-MM-DD）

deliveryNote

string（任意）

発送伝票備考欄に設定・追記する内容

noteMode

append / replace（任意）

備考の書き方。既定 append（既存の指示を消さずに追記）

レスポンス

JSON

納品書印刷指示日の「○営業日前」の計算は、休業日が企業ごとに異なるためタスク側で算出した日付を渡す設計です。

発送伝票備考は16文字までです。追記後の全体が16文字を超える場合は、切り詰めずに書き込みを中止し NE_NOTE_TOO_LONG と現在の備考内容を返します。（倉庫向けの既存指示が黙って欠けるのを防ぐため）

置き配などの指示は短い定型文を使用してください。

エラーコード

各機能の応答には summaryText （顧客向けの文面）に加えて errorCode が入ります。タスクの分岐条件には、文面の文字列一致ではなく errorCode を使用してください。

コード

意味

タスク側の推奨対応

NE_NOT_FOUND

注文・商品が見つからない

番号の再確認をご案内

NE_AMBIGUOUS

注文番号が複数の受注に一致し特定できない

有人対応へエスカレーション

NE_ALREADY_CANCELLED

既にキャンセル済み

その旨をご案内

NE_ALREADY_SHIPPED

既に出荷済み

返品・転送のご案内へ分岐

NE_ALREADY_HELD

既に保留中

受付済みとしてご案内

NE_WRITE_DISABLED

書き込み機能が未有効

担当者対応へ引き継ぎ

NE_INVALID_CANCEL_TYPE

指定したキャンセル区分が無効

区分の指定を見直し

NE_REAUTH_REQUIRED

連携が失効している

管理者へ再連携を依頼

NE_ERROR

その他のエラー

有人対応へエスカレーション

成功時はエラーコードを返しません。

success が false でも、それは「実行しなかった理由がある正常応答」です。

上記に加えて、書き込み系では次の2つを返すことがあります:

コード

意味

タスク側の推奨対応

NE_WRITE_NOT_APPLIED

更新はAPI上成功したが、再取得したら値が反映されていなかった

「完了」と案内せずに有人対応へエスカレーション

NE_NOTE_TOO_LONG

発送伝票備考が上限（16文字）を超えるため書き込まなかった

短い表記に変えて再試行するか、有人対応へ

書き込みは「書けたことを確かめてから」成功を返します。NEXT ENGINEの更新APIは変更が1件も起きなくても成功を返すため、本アプリは書き込み後に伝票を再取得し、期待した値になっている場合のみ success: true を返します。

連携の維持方法

  • 連携トークンの更新はすべて自動です。ご利用者様の操作は不要です。

  • 長期間（数日以上）使用がない場合、NEXT ENGINEの仕様により連携が失効することがあります。その場合、各機能は「連携が失効しています」という案内を返します。

  • 失効した場合は、上記の「チャネルトークでの操作」をもう一度行ってください。

よくある質問

NEXT ENGINEアプリで「連携が失効しています」と表示されます。

長期間の使用していないために表示される案内文です。

NEXT ENGINEガイドの「チャネルトークでの操作」部分をもう一度行ってください。

NEXT ENGINEアプリで連携保存時に「アプリ側の設定が未完了です」と表示されます。

この案内文が表示された場合は、お手数ですがチャネルトークにお問い合わせください。

NEXT ENGINEアプリで「uid/stateを読み取れませんでした」と表示されました。

チャネルトーク側のアプリ設定画面の「②連携コード」に入力するURLが不足しています。uid=とstate=を含む、URL全体を貼り付けてください。

NEXT ENGINEアプリを連携しても検索結果が常に0件になります。

連携時にログインしたアカウントが対象データを保有するアカウントであるかを確認してください。

NEXT ENGINEアプリを通じてキャンセルを実行しようとすると「実行しません」と表示されます。

こちらの案内文が表示された場合は、お手数ですがチャネルトークまでお問い合わせください。