API 를 사용하기 위해서는 키(key)를 발급받아야 한다. 'API인증현황 - 키발급' 메뉴를 통해 받을 수 있다.

위 키는 임시키이고, API 를 이용해서 프로그램 작성 후, 이카운트의 승인을 받아 정식 키를 받을 수 있다. 인증키는 모든 API 사용시 필요하기 때문에 기억해두어야 한다.

'API매뉴얼 - API 직접실행(사전테스트)' 메뉴를 클릭하면, 기본적인 API 를 테스트 할 수 있다.

Zone 은 이카운트에서 사용하는 회사코드(188477)를 입력하여 결과값을 얻는데 사용한다.

{
  "Data": {
    "EXPIRE_DATE": null,
    "COM_CODE": "188477",
    "DOMAIN": ".ecount.com",
    "STATUS": "E",
    "ZONE": "AC",               // 기억할 것
    "CS_COM_CODE": "246810",
    "ACCESS_ALL": null,
    "APP_DT_FROM": null,
    "APP_DT_TO": null,
    "MSG": "",
    "DB_CON_FLAG": "33",
    "EMPTY_ZONE": null,
    "SIP": "59455444430f081c020118151754"
  },
  "Status": "200",
  "Errors": null,
  "Error": null,
  "Timestamp": "2022-01-25 14:19:45.010",
  "RequestKey": null,
  "IsEnableNoL4": false,
  "RefreshTimestamp": "0",
  "AsyncActionKey": null
}

로그인을 해보자. ZONE, COM_CODE, USER_ID, API_CERT_KEY 의 값을 입력한다.

위의 입력값을 입력 후, 로그인이 정상적으로 되었다면, 아래와 같이 세션ID 가 반환된다.

SESSION_ID : 3138383437377c256561256239253830256563253961256230256563256132253835:AC-AOdd8aFXK6XVk

발주서를 조회할 수 있는 함수를 알아보자. 먼저 해당 함수에 대한 사용 설명과 예제를 확인해야한다. 왼쪽 메뉴들을 참고한다. 여기서 중요한 것은 Example Parameter 이다.

{
    "PROD_CD":"",
    "CUST_CD":"",
    "ListParam":{
                    "PAGE_CURRENT":1,
                    "PAGE_SIZE":100,
                    "BASE_DATE_FROM":"20190701",           // 조회 시작 기간
                    "BASE_DATE_TO":"20190730"              // 조회 끝 기간
                }
}

이제 실제 함수를 실행해보자.
API 에 '발주서조회' 를 선택한다. 그리고 위 코드를 복사하여 붙여넣고, 기간을 원하는 기간으로 수정한다. 그리고 '실행' 버튼을 누른다.

{
  "Data": {
    "EXPIRE_DATE": "",
    "QUANTITY_INFO": "시간당 연속 오류 제한 건수 : 0/30건, 1시간 허용량 : 5/30000건, 1일 허용량 : 5/100000건",
    "TotalCnt": 2,
    "Result": "[{"ORD_NO": 2, "ORD_DATE": "20220101", "WH_CD": "200", "WH_DES": "매장창고", "PJT_CD": "pj_00055", "PJT_DES": "괴산_로컬푸드직매장", "EMP_CD": "00003", "CUST_NAME": "정재한", "CUST": "20037", "CUST_DES": "정용희_매입_7", "FOREIGN_FLAG": "0", "EXCHANGE_TYPE": "", "CODE_DES": null, "EXCHANGE_RATE": "0.0000", "REF_DES": "괴산_로컬푸드직매장", "P_DES1": "", "P_DES2": "", "P_DES3": "", "P_DES4": "", "P_DES5": "", "P_DES6": "", "P_FLAG": "9", "IO_TYPE": "22", "SEND_FLAG": "0", "PROD_DES": "느타리버섯 [200g] 외 1건", "EDMS_DATE": "", "EDMS_NO": 0, "EDMS_APP_TYPE": null, "IO_DATE": "", "IO_NO": 0, "WRITER_ID": "정재한", "WRITE_DT": "2022-01-01T12:03:18.587", "LOGID": "차경식", "UPDATE_DATE": "2022-01-07 08:48:06.824", "UQTY": "0.0000000000", "QTY": "20.0000000000", "BUY_AMT": "23000.0000", "VAT_AMT": "0.0000", "BUY_AMT_F": "0.0000"}, {"ORD_NO": 1, "ORD_DATE": "20220101", "WH_CD": "200", "WH_DES": "매장창고", "PJT_CD": "pj_00055", "PJT_DES": "괴산_로컬푸드직매장", "EMP_CD": "00003", "CUST_NAME": "정재한", "CUST": "3038141549", "CUST_DES": "(주)신선촌", "FOREIGN_FLAG": "0", "EXCHANGE_TYPE": "", "CODE_DES": null, "EXCHANGE_RATE": "0.0000", "REF_DES": "괴산_로컬푸드직매장", "P_DES1": "", "P_DES2": "", "P_DES3": "", "P_DES4": "", "P_DES5": "", "P_DES6": "", "P_FLAG": "9", "IO_TYPE": "22", "SEND_FLAG": "0", "PROD_DES": "콩나물 [300g] 외 1건", "EDMS_DATE": "", "EDMS_NO": 0, "EDMS_APP_TYPE": null, "IO_DATE": "", "IO_NO": 0, "WRITER_ID": "정재한", "WRITE_DT": "2022-01-01T12:02:26.753", "LOGID": "김우종", "UPDATE_DATE": "2022-01-01 12:02:26.751", "UQTY": "0.0000000000", "QTY": "15.0000000000", "BUY_AMT": "18500.0000", "VAT_AMT": "0.0000", "BUY_AMT_F": "0.0000"}]"
  },
  "Status": "200",
  "Errors": null,
  "Error": null,
  "Timestamp": "2022-01-25 14:38:41.212",
  "RequestKey": null,
  "IsEnableNoL4": false,
  "RefreshTimestamp": "0",
  "AsyncActionKey": null
}