SAP S/4HANA

SAP S/4HANA Cloud OData API를 통한 비즈니스 파트너, 판매/구매 주문, 자재, 송장을 관리합니다.

개요

항목	내용
카테고리	연동
연동 필요	SAP S/4HANA Cloud OAuth2 인증
지원 리소스	비즈니스 파트너, 판매 주문, 구매 주문, 자재, 송장, 커스텀 OData

작업 종류

비즈니스 파트너

작업	설명
목록 조회	비즈니스 파트너 목록 조회
상세 조회	특정 비즈니스 파트너 정보 조회
생성	새 비즈니스 파트너 등록
수정	비즈니스 파트너 정보 수정
고객 목록	고객 유형 파트너만 조회
공급업체 목록	공급업체 유형 파트너만 조회
주소 조회	특정 파트너의 주소 정보 조회

판매 주문

작업	설명
목록 조회	판매 주문 목록 조회
상세 조회	특정 판매 주문 상세 정보
생성	판매 주문 생성
수정	판매 주문 수정
항목 조회	판매 주문의 라인 아이템 조회
항목 생성	판매 주문에 라인 아이템 추가

구매 주문

작업	설명
목록 조회	구매 주문 목록 조회
상세 조회	특정 구매 주문 상세 정보
생성	구매 주문 생성
수정	구매 주문 수정
항목 조회	구매 주문의 라인 아이템 조회

자재

작업	설명
목록 조회	자재 목록 조회
상세 조회	특정 자재 상세 정보
재고 조회	플랜트/저장 위치별 재고 조회
가용성 확인	자재 가용 수량 확인

송장

작업	설명
목록 조회	송장 목록 조회
상세 조회	특정 송장 상세 정보
생성	송장 생성
전기	송장 전기(Posting) 처리

커스텀 OData

작업	설명
조회 (GET)	사용자 정의 OData 서비스 조회
생성 (POST)	사용자 정의 엔티티 생성
수정 (PUT)	사용자 정의 엔티티 수정
삭제 (DELETE)	사용자 정의 엔티티 삭제

OData 쿼리 옵션

모든 리소스에서 아래 OData 쿼리 옵션을 사용할 수 있습니다.

옵션	설명	예시
$filter	필터 조건	`BusinessPartnerCategory eq '1'`
$select	반환할 필드	`BusinessPartner,BusinessPartnerName`
$expand	관련 엔티티 확장	`to_SalesOrderItem`
$orderby	정렬 기준	`CreationDate desc`
$top	최대 항목 수 (1~1000)	`100`
$skip	건너뛸 항목 수	`0`

설정 옵션

옵션	설명	필수
OData 버전	V2 또는 V4 선택
리소스	작업할 리소스 선택	✅
작업	리소스별 수행할 작업	✅

활용 예시

신규 고객 자동 등록

트리거: 데이터모델 - 행 생성 (고객 등록 요청)
액션 1: SAP S/4HANA - 비즈니스 파트너 생성
├── 카테고리: 개인
├── 파트너명: {{trigger.row.고객명}}
액션 2: 행 수정
└── SAP_ID: {{actions.sap.BusinessPartner}}

재고 부족 알림

트리거: 일정 (매일 오전 9시)
액션 1: SAP S/4HANA - 자재 재고 조회
├── 자재 ID: {{trigger.row.materialId}}
├── 플랜트: "1710"
액션 2: 조건 분기 (재고 < 안전재고)
액션 3: 슬랙 메시지
└── 메시지: "재고 부족: {{actions.sap.Material}} ({{actions.sap.AvailableStock}}개)"

판매 주문 → 송장 자동 생성

트리거: 웹훅 (판매 주문 배송 완료)
액션 1: SAP S/4HANA - 판매 주문 상세 조회
├── 판매 주문 ID: {{trigger.body.salesOrderId}}
액션 2: SAP S/4HANA - 송장 생성
└── 데이터: {{actions.sap.salesOrder}}

모범 사례

SAP S/4HANA Cloud는 OData 프로토콜을 사용합니다. API 버전(V2/V4)에 따라 지원되는 기능이 다를 수 있으니 SAP API Business Hub에서 확인하세요.

OData 버전 선택

V2: 기존 API와의 호환성이 높음. 대부분의 표준 API가 V2를 지원
V4: 최신 API. 더 풍부한 쿼리 기능 제공

에러 처리

SAP API 호출 실패 시 재시도하거나 관리자에게 알림을 보내세요.

On this page