- 印刷する
- PDF
事業者登録証
- 印刷する
- PDF
Classic/VPC環境で利用できます。
特化モデルエンジンを使用して事業者登録証の入力情報(key-value)を認識し、抽出します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
POST | /biz-license |
リクエストヘッダ
CLOVA OCR APIで共通して使用されるヘッダの詳細は、CLOVA OCRのリクエストヘッダをご参照ください。
リクエストボディ
リクエストボディの説明は次の通りです。
Content-Type: application/json
の場合
リクエストヘッダのContent-Type
がapplication/json
の場合のリクエストボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
version | String | - | バージョン情報
|
requestId | String | Required | 任意の API呼び出しの UUID |
timestamp | Integer | Required | 任意の APIの呼び出し時刻(Timestamp) |
images | Array | Required | imagesの詳細情報 |
Content-Type: multipart/form-data
の場合
リクエストヘッダのContent-Type
がmultipart/form-data
の場合のリクエストボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
message | Object | Required | リクエストデータ情報 |
message.version | String | Required | バージョン情報
|
message.requestId | String | Required | 任意の API呼び出しの UUID |
message.timestamp | Integer | Required | 任意の APIの呼び出し時刻(Timestamp) |
message.images | Array | Required | imagesの詳細情報 |
file | File | Required | OCR認識画像ファイル |
images
images
の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
format | String | Required | 画像の形式
|
name | String | Required | 任意の画像名
|
data | String | Required | Base64でエンコードされた画像データ
|
リクエスト例
リクエストのサンプルコードは次の通りです。
Content-Type: application/json
の場合
リクエストヘッダのContent-Type
がapplication/json
の場合のリクエストのサンプルコードは次の通りです。
curl --location 'https://cbgrx5natw.apigw.ntruss.com/custom/v1/{DomainId}/{InvokeKey}/document/biz-license' \
--header 'Content-Type: application/json' \
--header 'X-OCR-SECRET: {アプリの登録時に発行された Secret Key}' \
--data '{
"version": "V2",
"requestId": "string",
"timestamp": 0,
"images": [
{
"format": "jpg",
"name": "bizlicense_test",
"data": "{Base64でエンコードされた画像データ}"
}
]
}'
Content-Type: multipart/form-data
の場合
リクエストヘッダのContent-Type
がmultipart/form-data
の場合のリクエストのサンプルコードは次の通りです。
curl --location --request POST 'https://cbgrx5natw.apigw.ntruss.com/custom/v1/{DomainId}/{InvokeKey}/document/biz-license' \
--header 'X-OCR-SECRET: {アプリの登録時に発行された Secret Key}' \
--header 'Content-Type: multipart/form-data' \
--form 'message="{\"version\": \"V2\", \"requestId\": \"1234\", \"timestamp\": 1724832750462, \"images\": [{\"format\": \"pdf\", \"name\": \"bizlicense_test\"}]}"' \
--form 'file=@"{file}"'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
version | String | - | バージョン情報
|
requestId | String | - | API呼び出し UUID |
timestamp | Integer | - | APIの呼び出し時刻(Timestamp) |
images | Array | - | imagesの詳細情報 |
images
images
の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
uid | String | - | 事業者登録証画像の UID
|
name | String | - | 事業者登録証の画像名
|
inferResult | String | - | 事業者登録証の画像認識結果
|
message | String | - | 結果メッセージ |
validationResult | Object | - | 有効性検査の結果情報 |
validationResult.result | String | - | 有効性検査の結果コード
|
validationResult.message | String | - | 有効性検査結果の詳細メッセージ
|
convertedImageInfo | Object | - | 変換後の画像情報
|
convertedImageInfo.width | Integer | - | 変換後画像の横長 |
convertedImageInfo.height | Integer | - | 変換後画像の縦長 |
convertedImageInfo.pageIndex | Integer | - | 変換後画像ページインデックス |
bizLicense | Object | - | 事業者登録証の詳細情報 |
bizLicense.meta | Object | - | メタ情報 |
bizLicense.meta.estimatedLanguage | String | - | OCR推定言語
|
bizLicense.result | Object | - | 事業者登録証の OCR認識結果 |
result
result
の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
bisAddress | Array | - | 事業場の住所情報
|
bisArea | Array | - | 事業場の所在地情報
|
bisItem | Array | - | 事業項目情報
|
registerNumber | Array | - | 事業者登録番号情報
|
bisType | Array | - | 業種情報
|
companyName | Array | - | 企業名
|
corpName | Array | - | 法人(企業)名
|
corpRegisterNum | Array | - | 法人(企業)の事業者登録番号
|
coRepSocialNum | Array | - | 共同代表者の住民登録番号
|
documentType | Array | - | 文書タイプのオブジェクト情報 |
headAddress | Array | - | 本社の住所情報
|
issuanceDate | Array | - | 発行日情報
|
issuanceReason | Array | - | 発行理由情報
|
openDate | Array | - | 事業開始日情報
|
repName | Array | - | 代表者名情報
|
socialNumber | Array | - | 住民登録番号情報
|
taxType | Array | - | 課税タイプ情報
|
共通オブジェクト情報
共通オブジェクト情報の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
text | String | - | 認識結果のテキスト |
keyText | String | - | 認識結果のテキストのキー |
confidenceScore | Float | - | 認識結果のテキストの信頼度
|
boundingPolys | Array | - | boundingPolyの詳細情報 |
文書タイプのオブジェクト情報
文書タイプのオブジェクト情報の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
text | String | - | 認識結果のテキスト |
formatted | Object | - | 認識結果のテキスト情報 |
formatted.value | String | - | 認識結果のテキストの値 |
keyText | String | - | 認識結果のテキストのキー |
confidenceScore | Float | - | 認識結果のテキストの信頼度
|
boundingPolys | Array | - | boundingPolyの詳細情報 |
maskingPolys | Array | - | maskingPolyの詳細情報 |
boundingPolys
boundingPolys
の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
vertices | Array | - | verticesの詳細情報 |
maskingPolys
maskingPolys
の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
vertices | Array | - | verticesの詳細情報 |
boundingPolyvertices
boundingPolyVertices
の説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
x | Float | - | X軸の座標 |
y | Float | - | Y軸の座標 |
レスポンスステータスコード
CLOVA OCR APIで共通して使用されるレスポンスステータスコードの詳細は、CLOVA OCRの共通レスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
成功
呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。
{
"version": "V2",
"requestId": "1234",
"timestamp": 1725247772348,
"images": [
{
"uid": "{uid}",
"name": "bizlicense_test",
"inferResult": "SUCCESS",
"message": "SUCCESS",
"validationResult": {
"result": "NO_REQUESTED"
},
"bizLicense": {
"meta": {
"estimatedLanguage": "ko"
},
"result": {
"bisAddress": [
{
"text": "ソウル特別市***",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 371.0,
"y": 547.0
},
{
"x": 479.0,
"y": 550.0
},
{
"x": 479.0,
"y": 569.0
},
{
"x": 371.0,
"y": 567.0
}
]
}
]
}
],
"bisItem": [
{
"text": "***",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 760.0,
"y": 695.0
},
{
"x": 783.0,
"y": 695.0
},
{
"x": 783.0,
"y": 716.0
},
{
"x": 760.0,
"y": 716.0
}
]
}
]
}
],
"registerNumber": [
{
"text": "***-**-*****",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 585.0,
"y": 338.0
},
{
"x": 636.0,
"y": 338.0
},
{
"x": 636.0,
"y": 370.0
},
{
"x": 585.0,
"y": 370.0
}
]
}
]
}
],
"bisType": [
{
"text": "製造・卸売",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 434.0,
"y": 695.0
},
{
"x": 460.0,
"y": 695.0
},
{
"x": 460.0,
"y": 716.0
},
{
"x": 434.0,
"y": 716.0
}
]
},
]
}
],
"corpName": [
{
"text": "株式会社***",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 367.0,
"y": 392.0
},
{
"x": 391.0,
"y": 392.0
},
{
"x": 391.0,
"y": 418.0
},
{
"x": 367.0,
"y": 418.0
}
]
}
]
}
],
"corpRegisterNum": [
{
"text": "******-*********",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 858.0,
"y": 512.0
},
{
"x": 902.0,
"y": 512.0
},
{
"x": 902.0,
"y": 530.0
},
{
"x": 858.0,
"y": 530.0
}
]
}
]
}
],
"documentType": [
{
"text": "事業者登録証",
"formatted": {
"value": "事業者登録証"
},
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 376.0,
"y": 220.0
},
{
"x": 449.0,
"y": 220.0
},
{
"x": 449.0,
"y": 287.0
},
{
"x": 376.0,
"y": 287.0
}
]
}
],
"maskingPolys": []
}
],
"headAddress": [
{
"text": "ソウル特別市***",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 368.0,
"y": 622.0
},
{
"x": 480.0,
"y": 622.0
},
{
"x": 480.0,
"y": 643.0
},
{
"x": 368.0,
"y": 643.0
}
]
}
]
}
],
"issuanceDate": [
{
"text": "2021年01月07日",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 454.0,
"y": 1299.0
},
{
"x": 520.0,
"y": 1299.0
},
{
"x": 520.0,
"y": 1325.0
},
{
"x": 454.0,
"y": 1325.0
}
]
}
]
}
],
"openDate": [
{
"text": "2001 08 16 日",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 367.0,
"y": 512.0
},
{
"x": 418.0,
"y": 512.0
},
{
"x": 418.0,
"y": 530.0
},
{
"x": 367.0,
"y": 530.0
}
]
}
]
}
],
"repName": [
{
"text": "イ**",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 368.0,
"y": 432.0
},
{
"x": 393.0,
"y": 432.0
},
{
"x": 393.0,
"y": 457.0
},
{
"x": 368.0,
"y": 457.0
}
]
}
]
}
],
"taxType": [
{
"text": "法人事業者",
"keyText": "",
"confidenceScore": 0.0,
"boundingPolys": [
{
"vertices": [
{
"x": 532.0,
"y": 282.0
},
{
"x": 564.0,
"y": 282.0
},
{
"x": 564.0,
"y": 328.0
},
{
"x": 532.0,
"y": 328.0
}
]
}
]
}
]
}
}
}
]
}
失敗
呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。
{
"code": "0011",
"message": "Request invalid: Request data() is invalid.",
"path": "{path}",
"traceId": "{traceId}",
"timestamp": 1725349186545
}