SAP原価センターAPI(Draft版)
原価センターマスタ登録API(Draft版)
1. API 概要
API名: 原価センターマスタ登録API
目的: SAPから送信された原価センタマスタ情報をIPCに新規登録する。
概要: 本APIは、SAP(S/4HANA)より連携される原価センタマスタデータをIPC上に登録します。 SAPマスタとの同期を前提とし、SAP標準項目に準拠します。
2. リクエスト
2.1 リクエストURL
メソッド:POST
エンドポイント:/api/sap/master/cost-centers
2.2 リクエストヘッダー
| ヘッダー名 | 値 | 説明 |
|---|---|---|
| Content-Type | application/json | JSON形式 |
| Authorization | Bearer {access_token} | SAP連携用トークン |
2.3 リクエストボディ
例
{
"KOKRS": "1000",
"KOSTL": "CC00000001",
"DATBI": "9999-12-31",
"SPRAS": "JA",
"DATAB": "2024-01-01",
"KTEXT": "総務部",
"LTEXT": "総務部原価センタ",
"VERAK_USER": "USER01",
"VERAK": "山田太郎",
"ABTEI": "ADM",
"KOSAR": "01",
"KHINR": "AREA01",
"GSBER": "1000",
"FUNC_AREA": "FA001",
"WAERS": "JPY",
"PRCTR": "PC1000",
"MGEFL": "X",
"BKZKP": "X",
"BKZKS": "X",
"BKZER": "",
"PKZKP": "X",
"PKZKS": "X",
"PKZER": "",
"BKZOB": "",
"CPI_TEMPL": "",
"CPD_TEMPL": "",
"SCI_TEMPL": "",
"SCD_TEMPL": "",
"KALSM": "",
"USNAM": "SAPUSER",
"ERSDA": "2024-01-01"
}
2.4 パラメータ説明
| 項目名 | JSONキー | 型 | 必須 | 桁 | 説明 |
|---|---|---|---|---|---|
| 管理領域 | KOKRS | string | ○ | 4 | SAP管理領域 |
| 原価センタ | KOSTL | string | ○ | 10 | 原価センタコード(主キー) |
| 有効終了日 | DATBI | date | ○ | - | YYYY-MM-DD |
| 言語キー | SPRAS | string | ○ | 2 | JA/EN |
| 有効開始日 | DATAB | date | ○ | - | YYYY-MM-DD |
| 一般名称 | KTEXT | string | ○ | 20 | 短名称 |
| テキスト | LTEXT | string | - | 40 | 長名称 |
| 責任ユーザ | VERAK_USER | string | - | 12 | SAPユーザID |
| 責任者 | VERAK | string | - | 20 | 責任者名称 |
| 部署 | ABTEI | string | - | 12 | 部署コード |
| 原価センタカテゴリ | KOSAR | string | - | 1 | カテゴリ区分 |
| 階層エリア | KHINR | string | - | 12 | 標準階層ID |
| 事業領域 | GSBER | string | - | 4 | 事業領域 |
| 機能領域 | FUNC_AREA | string | - | 16 | 機能領域 |
| 通貨コード | WAERS | string | - | 5 | ISO通貨 |
| 利益センタ | PRCTR | string | - | 10 | 利益センタ |
| 数量必須 | MGEFL | string | - | 1 | Xのみ |
| 実績一次原価 | BKZKP | string | - | 1 | Xのみ |
| 実績二次原価 | BKZKS | string | - | 1 | Xのみ |
| 実績収益 | BKZER | string | - | 1 | Xのみ |
| 計画一次原価 | PKZKP | string | - | 1 | Xのみ |
| 計画二次原価 | PKZKS | string | - | 1 | Xのみ |
| 計画収益 | PKZER | string | - | 1 | Xのみ |
| 未確定債務更新 | BKZOB | string | - | 1 | Xのみ |
| 原価計算表 | KALSM | string | - | 6 | 原価計算表コード |
| 登録者 | USNAM | string | ○ | 12 | SAP登録ユーザ |
| 日付 | ERSDA | date | ○ | - | 作成日 |
3. レスポンス
3.1 成功時
201 Created
{
"KOKRS": "1000",
"KOSTL": "CC00000001"
}
3.2 失敗時
400 / 409 / 500
原価センターマスタ更新API
1. API 概要
SAPから連携された原価センタ情報を更新する。
2. リクエスト
メソッド:PUT
エンドポイント:/api/sap/master/cost-centers/{KOKRS}/{KOSTL}
成功時
204 No Content
失敗時
400 / 404 / 500
原価センターマスタ削除API
1. API 概要
SAP上で削除された原価センタをIPC上で論理削除する。
2. リクエスト
メソッド:DELETE
エンドポイント:/api/sap/master/cost-centers/{KOKRS}/{KOSTL}
成功時
204 No Content
失敗時
404 / 500
Procurement Cloudを
ご検討される方へ
自社の要件にかなうかどうかを
直接聞きたい方へ
概要資料のダウンロード
クラウド型調達・購買システム 「intra-mart Procurement Cloud」のサービス概要資料をダウンロードできます。BSMで解決できることを知りたいといった方にもおすすめの資料です。
デモをご希望の方はこちら
クラウド型調達・購買システム 「intra-mart Procurement Cloud」のデモンストレーションを行っています。資料よりも機能や操作性をご覧になりたい方はこちらから予約を行ってください。