메일/그룹웨어 매뉴얼

Home > 메일/그룹웨어 > 개발자 센터 > 개발자 센터 이용하기

지출 결의 데이터 가져오기 지출 결의 데이터 가져오기

하이웍스의 많은 고객이 전자결재 '지출결의서' 양식을 이용하고 있습니다.  

업무처리 등을 위해 지출되는 비용 발생 시, 회계팀에 지출의 출납을 사전 승인하기 위한 절차를 위해서입니다.

 

지출 결의가 완료되면 [전자결재 > 회계 정보 관리 > 데이터 조회 > 지출결의, 송금요청]에 해당 비용 자료가 누적됩니다.

 

 

애플리케이션은 해당 회계 데이터를 API를 이용하여 가져 갈 수 있습니다. 해당 문서는 해당 프로세스 필요한 전반적인 가이드를 제공합니다.

 

 

 

코드 연동

 

지출결의 정보를 ERP 등에 연동하기 위해 가장 중요한 첫 번째 단계는 코드(거래처, 계정 과목, 코스트 센터) 동기화입니다. 

비용 정보를 전달한다고 하더라도 하이웍스 코드와 ERP 등 애플리케이션 코드가 다르면 결국 무용지물이기 때문입니다. 

 

ERP 등 대부분의 애플리케이션의 경우 자체적으로 거래처, 계정과목, 코스트 센터 등의 코드를 관리하고 있습니다. 

하이웍스는 외부 코드 정보를 하이웍스와 동기화할 수 있는 방식을 제공합니다(애플리케이션의 코드 정보를 하이웍스 코드 정보에 전달하는 방식). 

 

코스트 센터, 거래처, 계정과목 항목에 대한 추가/조회/수정/삭제 API를 제공하며,

헤더에 Office Token 인증을 포함하여 호출합니다. Office Token 발급 방식은 여기를 참고해 주세요.

 

 

1. 코스트 센터 CRUD Parameter 

 

1) department_code: 코스트 센터 코드

 

2) department_code: 코스트 센터 이름

 

3) ext_key: 외부 키

 

 

2. 거래처 CRUD Parameter

 

1) customer_code: 거래처 코드

 

2) customer_name: 거래처 이름

 

3) business_number: 사업자 등록번호

 

4) bank_name: 은행명

 

5) account_number: 계좌번호

 

6) account_holder: 예금주

 

7) ext_key: 외부 키

 

 

3. 계정 과목 CRUD Parameter

 

1) account_code: 계정과목 코드

 

2) account_name: 계정과목명

 

3) ext_key: 외부 키

 

 

코드가 연동되는 경우, 웹 화면에서 코드 관리가 제한됩니다.

 

 

지출 결의/송금 정보 연동

 

코드 동기화가 완료되었다면 이제 지출 결의 정보를 가져올 차례입니다. 

헤더에 Office Token 인증을 포함하여 호출합니다. Office Token 발급 방식은 여기를 참고해 주세요.

 

 

1. 요청 Parameter

 

1) fixed_date: 기준 월 (YYYYMM)

 

2) type: 개인, 법인 또는 전체를 선택 -- 전체(빈 값으로 전달), 개인(P), 법인 (C)

 

3) approval_status: 문서 결재 상태 -- 결재 중(P),결재 완료(C)

 

 

2. 요청 시 아래와 같은 Response를 받게 됩니다. 용도에 필요한 값을 파싱 처리하여 획득합니다.

 

1) document_code: 문서 코드(ex: 지결-20190327-0001)

 

2) document_no: 문서 번호(ex: 123456)

 

3) slip_number: 전표 번호

 

4) document_regdate: 기안일시

 

5) register_name: 작성자 이름

 

6) register_id: 작성자 아이디

 

7) register_company_num: 작성자 사번

 

8) spender_user_name: 지출자 이름

 

9) spender_user_id: 지출자 아이디 

 

10) spender_company_num: 지출자 사번

 

11) type: 구분 -- 개인 또는 법인

 

12) card_name: 법인카드 회사명

 

13) card_number: 법인카드번호

 

14) bank_name: 지출자 은행명

 

15) account_num: 지출자 계좌번호

 

16) fixed_date: 회계일자(YYMMDD)

 

17) updatedate: 문서 수정일

 

18) number: 입력번호

 

19) department_code: 코스트센터 코드

 

20) department_name: 코스트센터 이름

 

21) account_code: 계정과목 코드

 

22) account_name: 계정과목 이름

 

23) price: 공급가액

 

24) tax: 세액

 

25) expense_date: 금액

 

26) proof: 증빙

 

27) cash_receipts_num: 현금영수증

 

28) customer_code: 거래처 코드

 

29) customer_name: 거래처 이름

 

30) customer_company_num: 사업자 등록번호

 

31) accounting_no: 송금 정보 고유번호

 

32) brief: 적요 

  • 개발자 센터 이용하기

    • 오피스 토큰 생성하기

    • 애플리케이션에서 하이웍스로 알림 보내기

    • 애플리케이션에서 하이웍스 전자결재 기안하기

    • 문자(SMS) 보내기

    • 지출 결의 데이터 가져오기

    • 계정 연동(SSO) 구현하기

    • 하이웍스에서 외부 사이트로 SSO 연동하기

    • 외부 사이트에서 하이웍스로 계정 연동하기

    • 인트라넷 메뉴 SSO 연동하기

    • 전자결재 솔루션에서 오피스토큰 연동하기

    • LDAP 계정 연동 설정 및 계정 연동하기

    • Google Workspace 로그인 연동

    • Microsoft 365 로그인 연동