SAP指図コードAPI(Draft版)

指図コードマスタ登録API(Draft版)

1. API 概要

API名: 指図コードマスタ登録API

目的: SAPから連携された指図コード(内部指図)マスタをIPCに新規登録する。

概要: 本APIは、SAP(S/4HANA)内部指図マスタ(AUFK)より取得したデータをIPCへ登録します。 SAPマスタとの同期を前提とした受信APIです。


2. リクエスト

2.1 リクエストURL


メソッド:POST
エンドポイント:/api/sap/master/internal-orders

2.2 リクエストヘッダー

ヘッダー名説明
Content-Typeapplication/jsonJSON形式
AuthorizationBearer {access_token}SAP連携用トークン

2.3 リクエストボディ

{
  "MANDT": "100",
  "AUFNR": "4000000010",
  "AUART": "Z001",
  "KOKRS": "1000",
  "KTEXT": "設備投資案件A",
  "BUKRS": "1000",
  "PRCTR": "PC1000",
  "WAERS": "JPY",
  "AUTYP": "01",
  "ASTKZ": "",
  "PHAS0": "X",
  "PHAS1": "X",
  "PHAS2": "",
  "PHAS3": "",
  "LOEKZ": "",
  "DATUM": "2024-01-01",
  "UZEIT": "101500",
  "UNMAE": "SAPUSER"
}

2.4 パラメータ説明

項目名JSONキー必須説明
クライアントMANDTstring3SAPクライアント
指図番号AUFNRstring12内部指図番号(主キー)
指図タイプAUARTstring4指図タイプ
管理領域KOKRSstring4管理領域
テキストKTEXTstring40指図名称
会社コードBUKRSstring4会社コード
利益センタPRCTRstring-10利益センタ
購買発注通貨WAERSstring-5ISO通貨コード
指図カテゴリAUTYPstring2内部指図カテゴリ
統計指図フラグASTKZstring-1X=統計指図
フェーズ 登録済PHAS0string-1X=登録済
フェーズ リリース済PHAS1string-1X=リリース済
フェーズ 技術的完了PHAS2string-1X=技術的完了
フェーズ 終了PHAS3string-1X=終了
削除フラグLOEKZstring-1X=削除
実行日付DATUMdate-更新日
実行時刻UZEITstring6HHMMSS
ユーザIDUNMAEstring12更新ユーザ

3. レスポンス

3.1 成功時

201 Created

{
  "AUFNR": "4000000010"
}

3.2 失敗時

400 Bad Request

409 Conflict(既存指図番号)

500 Internal Server Error


指図コードマスタ更新API

1. API 概要

SAPより連携された指図コードを更新する。

2. リクエスト


メソッド:PUT
エンドポイント:/api/sap/master/internal-orders/{AUFNR}

成功時

204 No Content

失敗時

400 / 404 / 500


指図コードマスタ削除API

1. API 概要

SAP上で削除された指図コードをIPC上で削除(論理削除)する。

2. リクエスト


メソッド:DELETE
エンドポイント:/api/sap/master/internal-orders/{AUFNR}

成功時

204 No Content

失敗時

404 / 500


Procurement Cloudを
ご検討される方へ

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