이카운트 API 연동 예제

이카운트 ERP API 연동을 위한 실전 예제 코드와 활용 가이드를 제공합니다.
아래 예제는 실제 API 호출 흐름과 JSON 구조, 주요 사용법을 쉽게 이해할 수 있도록 구성되어 있습니다.

1. Zone API 호출 예제

// 회사코드로 ZONE 조회
fetch('/api/ecount/zone', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ COM_CODE: '회사코드' })
})
  .then(res => res.json())
  .then(data => {
    // data.data.ZONE 사용
    console.log('ZONE:', data.data.ZONE);
  });

※ 실제로는 회사코드(COM_CODE)를 입력해야 하며, 응답에서 ZONE 값을 추출합니다.

2. 로그인 API 호출 예제

// ZONE, 회사코드, 사용자ID, API Key로 세션ID 발급
fetch('/api/ecount/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    COM_CODE: '회사코드',
    USER_ID: '사용자ID',
    API_CERT_KEY: 'API Key',
    ZONE: 'ZONE',
    LAN_TYPE: 'ko-KR'
  })
})
  .then(res => res.json())
  .then(data => {
    // data.data.SESSION_ID 사용
    console.log('SESSION_ID:', data.data.SESSION_ID);
  });

※ ZONE, 회사코드, 사용자ID, API Key를 모두 입력해야 하며, 응답에서 SESSION_ID를 추출합니다.

3. 품목 조회 API 예제

// 품목 리스트 조회 (SESSION_ID 필요)
fetch('/api/ecount/products/list', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    SESSION_ID: '세션ID',
    ZONE: 'ZONE',
    DOMAIN: 'sboapi' // 또는 oapi
  })
})
  .then(res => res.json())
  .then(data => {
    // data.data.Result 배열 사용
    console.log('품목 목록:', data.data.Result);
  });

※ SESSION_ID, ZONE, DOMAIN 값을 정확히 입력해야 하며, 결과는 Result 배열로 반환됩니다.

4. 판매 등록 API 예제

// 판매 데이터 등록 (SESSION_ID 필요)
fetch('/api/ecount/sales', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    SESSION_ID: '세션ID',
    ZONE: 'ZONE',
    DOMAIN: 'sboapi',
    SaleList: [
      {
        BulkDatas: {
          WH_CD: '100',
          PROD_CD: '1',
          QTY: 1
        }
      }
    ]
  })
})
  .then(res => res.json())
  .then(data => {
    // data.data.SuccessCnt 등 사용
    console.log('등록 성공 건수:', data.data.SuccessCnt);
  });

※ 실제 등록 시에는 품목코드, 창고코드, 수량 등 실제 데이터를 입력해야 합니다.

5. 기타 참고

API 호출 시 Content-Type은 항상 application/json으로 지정해야 합니다.
실제 서비스 연동 시에는 API Key와 Test Key의 구분, ZONE 값, SESSION_ID 관리에 주의하세요.
API 응답 구조는 data 객체 내부에 실제 데이터가 포함되어 있습니다.
API 호출 실패 시 message 필드에 오류 메시지가 반환됩니다.