메일/그룹웨어 매뉴얼
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: 적요