プリンターステータスコード

プリンターステータスコードは http ステータスコードに似ていますが互換性はありません。
3桁または4桁のエラーコードでそのあとにエラーの説明が続きます。
エラーの説明はログ用であり、クライアントによって異なる場合があります。
エラーコードは必要に応じて追加されますが、サーバーは全てのエラーコードを認識する必要はありません。
例えば、"2" から始まる全てのコード(200、211 など)はプリンターがオンラインであることを意味し、"4" から始まる全てのコードはプリンターエラーを示します。
プリンターステータスコードは、以下の箇所で利用されます。

サーバーポーリング (POST)

プリンターから発行されるMQTTメッセージ

2xx

Code

Description

2xx

プリンターはオンライン

20x

プリンターはオンラインで印刷可能

200

OK、プリンターはオンラインで印刷可能です

201 (*1)

排紙口の用紙は取られ、プリンターは印刷可能です

211

用紙が少ない

22x (*1)

用紙保持検出が可能なプリンターはオンラインですが、印刷中、または出力した用紙が排紙口に残っているためプリンターがビジー状態です

220 (*1)

印刷中です

221 (*1)

出力した用紙が排紙口にあります

23x (*2)

清掃時期やパーツ交換時期の通知に関連します

230 (*2)

清掃時期の通知

231 (*2)

パーツ交換時期の通知

(*1) このステータスコードは、TSP650IISK (IFBD-HI01X), mC-Label3, TSP100IV SKにてサポートされております。
(*2) このステータスコードは、mC-Label3にてサポートされております。

4xx

Code

Description

4xx

プリンターエラー : 4 から始まるコードはプリンターエラーに起因するエラーに関連します

41x

用紙エラー

410

用紙切れ

411 (*1)

用紙詰まり

412 (*2)

用紙位置エラー

42x

カバーオープンエラー

420

カバーが開いている

(*1) このステータスコードは、mC-Label3, TSP100IV SKにてサポートされております。
(*2) このステータスコードは、mC-Label3にてサポートされております。

5xx

Code

Description

5xx

クライアントエラー : 5 から始まるコードはクライアントに起因するエラーに関連します

51x

メディア互換エラー

510

非互換メデイアタイプ, クライアントはサーバーの発行するデータをサポートしていない

511

メディアデコードエラー このメデイアタイプをサポートしているが、デコードに失敗した
例:データの損傷またはメデイアフォーマットのバージョン違い

512

サポートされていないメデイアのバージョンである、メデイアタイプはサポートされているが、サーバーより発行されたバージョンが互換でない。
例: クライアントが PDF1.4 までをサポートしているが 1.5 をサポートしていない場合など

52x

ジョブダウンロードエラー

520

タイムアウト。クライアントが内部のタイムアウト時間内にジョブをダウンロードできなかった

521

ジョブサイズエラー。
ジョブデータがクライアントのダウンロードバッファに対して大き過ぎる、または指定の上限を超えた
プリンターが受信したMQTTメッセージのサイズがバッファに対して大きすぎる
プリンターが受信したMQTTメッセージ print-jobprintData キーの値がバッファに対して大きすぎる (jobType キーの値が "raw" の場合)

1xxx

Code

Description

1xxx

CloudPRNTサーバーから受け取った情報に起因するエラーに関連します

10xx

サーバー設定情報取得リクエスト (GET) のサーバーレスポンスに起因するエラー

1000

受信したレスポンスBodyのJSONフォーマットに誤りが存在する

1001

受信したレスポンスBodyのJSONに必須キーがない、または必須キーの値が不正

11xx

サーバーMQTTメッセージエラー

1100

受信したMQTTメッセージのトピックが定義されていないメソッド名である

1101

受信したMQTTメッセージのペイロードJSONフォーマットに誤りが存在する

1102

受信したMQTTメッセージのペイロードJSONに必須キーがない、または必須キーの値が不正

12xx

サーバーMQTTメッセージ print-job 関連エラー

1200

プリンターは現在印刷中のため、受け取った print-job は印刷できない

1201

jobToken キーが指定されていない

1202

指定した jobToken キーの値は直近で既に利用されている。プリンターは過去10件分を記憶。