精算の登録
- 印刷する
- PDF
精算の登録
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
説明
件別の精算データを登録します。(人数以外に精算データの入力が必要な場合に使用)
リクエストヘッダ共通
| Header | Description |
|---|---|
| x-ncp-apigw-timestamp | * 1970年1月1日00::00::00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの * API Gatewayサーバとの時間差が5分以上の場合は、無効なリクエストとみなす |
| x-ncp-iam-access-key | * NAVERクラウドプラットフォームポータル{target=「_blank」}または Sub Accountから発行された Access Key ID |
| x-ncp-apigw-signature-v2 | * 上記例の Bodyを Access Key IDとマッピングされる Secret Keyで暗号化した署名 * HMAC暗号化アルゴリズムは HmacSHA256を使用 |
精算の登録 API
件別の精算データを登録します。
リクエスト URL
GET
https://workplace.apigw.ntruss.com/partner/apigw/v2/partner/{partnerId}/company/{company
Id}/metering
リクエスト Pathパラメータ
| パラメータ | タイプ | 容量 | 要否 | 説明 |
|---|---|---|---|---|
| partnerId | String | 15 | Y | WORKPLACEから提供されたパートナー ID |
| companyId | String | 36 | Y | 照会する顧客会社の連携キー(CompanyId) Developers > Default settings > Integration key |
リクエスト Bodyパラメータ
| パラメータ | タイプ | 容量 | 要否 | 説明 |
|---|---|---|---|---|
| companyId | String | 36 | Y | 顧客会社 company ID |
| empId | String | 36 | Y | 社員 ID |
| productCode | Map | Y | 商品コード | |
| productName | String | 100 | Y | 商品名 |
| productAmt | int | Y | 商品価格 | |
| billYmd | String | 100 | Y | 精算日時(YYYYMMDD) |
| applyYmdt | boolean | Y | 申請日時(YYYYMMDDHH24MISS) | |
| svcOrderKey | String | 10 | Y | 業務支援サービスの固有キー |
リクエスト例
POST https://workplace.apigw.ntruss.com/partner/apigw/v2/partner/{partnerId}/company/adc835a8-244c-46b4-8410-7421816d4808/metering
POST /partner/apigw/v2/partner/{partnerId}/company/adc835a8-244c-46b4-8410-7421816d4808/metering
HOST: workplace.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp: 1505290625682
x-ncp-apigw-api-key: DUxjP4HYTP8V7khBkgywdDHQjKuaYWGrppHKpvdv
x-ncp-iam-access-key: D78BB444D6D3C84CA38A
x-ncp-apigw-signature-v1: WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=
{
"companyId" : "187d83ad-4038-45b6-8e7c-59eca16fdc46",
"empId" : "7764286e-5d40-43e7-bff0-4a947e1437e1",
"productCode" : "AAA01",
"productName" : "商品名",
"productAmt" : "3500",
"billYmd" : "20220221",
"applyYmdt" : "20220219013125",
"svcOrderKey" : "5a5d9d7gg57x8x63de"
}
レスポンス例
HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2020 01:18:11 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 68d1o68pm4cr63gc3169gm4p34
レスポンス
HTTPステータスコードでリターンされ、 Body情報として転送します。
| HTTPステータスコード | レスポンスメッセージ | 説明 |
|---|---|---|
| 200 | OK | 一般的なリクエスト成功 |
| 201 | Created | リソース作成成功に対するレスポンスコード |
| 400 | Bad Request | 一般的なリクエスト失敗に使用 |
| 500 | Internal Server Error | - 一般的なサーバエラーに対するレスポンスコード 4XX番台のエラーコードが、クライアント側のエラーを表示するために使用され、 5XX番台のエラーコードは、サーバ側のエラーを表示するために使用される |
レスポンス例
{
"status": 400,
"code": -4020,
"errors": [],
"message": "parentDeptExternalKey is null"
}
この記事は役に立ちましたか?