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-Typeapplication/jsonJSON形式
AuthorizationBearer {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キー必須説明
管理領域KOKRSstring4SAP管理領域
原価センタKOSTLstring10原価センタコード(主キー)
有効終了日DATBIdate-YYYY-MM-DD
言語キーSPRASstring2JA/EN
有効開始日DATABdate-YYYY-MM-DD
一般名称KTEXTstring20短名称
テキストLTEXTstring-40長名称
責任ユーザVERAK_USERstring-12SAPユーザID
責任者VERAKstring-20責任者名称
部署ABTEIstring-12部署コード
原価センタカテゴリKOSARstring-1カテゴリ区分
階層エリアKHINRstring-12標準階層ID
事業領域GSBERstring-4事業領域
機能領域FUNC_AREAstring-16機能領域
通貨コードWAERSstring-5ISO通貨
利益センタPRCTRstring-10利益センタ
数量必須MGEFLstring-1Xのみ
実績一次原価BKZKPstring-1Xのみ
実績二次原価BKZKSstring-1Xのみ
実績収益BKZERstring-1Xのみ
計画一次原価PKZKPstring-1Xのみ
計画二次原価PKZKSstring-1Xのみ
計画収益PKZERstring-1Xのみ
未確定債務更新BKZOBstring-1Xのみ
原価計算表KALSMstring-6原価計算表コード
登録者USNAMstring12SAP登録ユーザ
日付ERSDAdate-作成日

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を
ご検討される方へ

自社の要件にかなうかどうかを
直接聞きたい方へ