ForHosting KIT · PDF・文書ツール

用途に適したバーコード規格を選ぶ

バーコード選びで重要なのは、模様の見た目ではありません。適切なシンボル体系は、誰が読み取るか、どの識別子を格納するか、どの業界規格が業務を定めているかによって決まります。この決定的な推奨ツールは、小売商品、配送ラベル、在庫追跡、図書館の本という 4 つの一般的な用途に、通常使われる一次元バーコードを対応付けます。選択の根拠となる識別子と規格も説明するため、業界標準と、単に読み取り可能なだけの方式を区別していただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

図柄ではなく読み取り環境からお考えください

バーコードのシンボル体系は、文字をバーと空白で表す方法を定めます。ただし、技術的に符号化できるだけでは運用に成功しません。小売店のレジは GS1 規則に従って管理された識別子を想定しますが、社内倉庫では短い独自コードだけで足りる場合があります。まず、誰がデータを割り当てるか、どこで読み取るか、個別契約なしに別組織が内容を理解する必要があるかをご確認ください。小売商品では、GTIN-13 を格納し、世界の販売時点情報管理で広く認識される EAN-13 が一般的です。12 桁の GTIN が中心の市場では UPC-A も広く使われ、同じ GS1 識別体系に属します。そのため、本ツールは通常の規格を示しますが、国、取引先、読取機器の要件がすべて同じだとは想定しません。量産前にデータの管理者と取引先仕様をご確認ください。正しく読み取れる記号でも、未承認の識別子、不適切な寸法、誤った配置であれば業務上は使用できません。

データ構造とバーコード媒体を分けてお考えください

識別子と印刷される媒体は関係しますが、同じものではありません。Code 128 は幅広い文字を効率よく符号化できる汎用シンボル体系です。GS1-128 はその媒体に、先頭のファンクション文字や、データの意味と長さを示すアプリケーション識別子などの GS1 規則を加えます。この違いにより、配送ラベルには GS1-128、社内在庫管理には通常の Code 128 を推奨します。物流ラベルでは、SSCC、日付、ロット番号など、受取側が一貫して解釈できる構造化項目が必要になることがあります。社内ラベルでは自社定義の SKU や資産番号だけで十分な場合が多く、Code 128 のほうが簡潔で広く対応できます。プリンターに機能があるという理由だけで GS1 構文を追加しないでください。GS1 識別子には正しい割当てと形式が必要です。一方、運送会社、小売業者、顧客が GS1 データを指定している場合は、構造のない Code 128 文字列を使用しないでください。

規格選定の出発点として結果をご利用ください

結果には、選択された用途で一般的な方式、規格、格納する識別子、推奨理由が表示されます。図書館の本には ISBN-13 を格納した EAN-13、通称 Bookland EAN を推奨します。これは出版された版を識別するものであり、図書館は貸出システムで個々の所蔵資料を識別する別のバーコードを追加する場合があります。他の用途にも同様の例外があります。在庫制度では、顧客要件や印字面積により、GS1 識別子、特定業界規格、二次元シンボルが必須になることがあります。運送会社が汎用コード 1 個ではなく、複数記号を含む所定のラベルを要求する場合もあります。小売包装では、方式のほかに印刷品質、クワイエットゾーン、倍率、色、配置の要件も満たす必要があります。本結果を通常の規格群を選ぶ手掛かりとし、読取機器会社、印刷会社、取引先、規格団体へ具体的にご確認ください。導入前には正確なデータ形式と寸法を確認し、実機で試験し、正規の機関から識別子を取得してください。

活用例

小売用パッケージを設計する

消費者向け商品の図面に領域を確保したり GTIN を申請したりする前に、一般的な GS1 の媒体をご確認いただけます。

業務ラベルを作成する

構造化された GS1 物流データと、社内在庫だけで使う独自の Code 128 識別子を区別していただけます。

図書館資料にラベルを付ける

ISBN-13 の一般的な媒体を確認し、貸出用の各資料に別のコードが必要な場合も検討できます。

よくある質問

推奨結果の料金はいくらですか？

API の各リクエスト料金は $0.002 です。同じ決定的な照会をブラウザーでも実行できます。

小売商品に EAN-13 が推奨されるのはなぜですか？

EAN-13 は GS1 の GTIN-13 を格納する一般的な媒体で、世界の販売時点情報管理に対応します。UPC 中心の市場では GTIN-12 に UPC-A も広く使われます。

Code 128 と GS1-128 は何が違いますか？

Code 128 はシンボル体系です。GS1-128 は GS1 の形式規則とアプリケーション識別子を加え、取引先が構造化項目を解釈できるようにします。

図書館の本には ISBN のコードだけで十分ですか？

必ずしも十分ではありません。ISBN-13 は出版された版を示しますが、図書館では個々の貸出資料を示す別コードを追加する場合があります。

運送会社や小売業者のラベル仕様に代えられますか？

いいえ。本結果は広い用途に一般的な方式を示します。取引先が識別子、寸法、配置、印刷品質、追加記号を指定する場合があります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/doc/barcode-symbology-recommend

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/doc/barcode-symbology-recommend \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"use_case":"retail_product"}'

const res = await fetch("https://api.kit.forhosting.com/doc/barcode-symbology-recommend", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "use_case": "retail_product"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/doc/barcode-symbology-recommend",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "use_case": "retail_product"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/barcode-symbology-recommend", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"use_case":"retail_product"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"use_case":"retail_product"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/barcode-symbology-recommend", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "use_case": "retail_product"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.barcode_symbology_recommend",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_mb`	25
`max_pages`	200

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →