더 편리한 세상을 위해 하이웍스 API를 공유합니다.
\n하이웍스 API는 HTTP 요청으로 활용할 수 있는 REST API 형태로 제공하므로 HTTP를 처리할 수 있는 많은 언어에서 사용 가능합니다.
\n하이웍스 API 문서 페이지에서는 Postman을 이용하여 API를 테스트할 수 있는 환경을 제공합니다.
우측 상단의 Run in Postman을 클릭하여 API를 확인해 주세요.
하이웍스 API는 크게 2가지로 분류됩니다.
\n1. 서비스 API: 푸시 알림, 전자결재 기안하기, 메일 발송하기 등 하이웍스 서비스의 전반적인 기능을 이용할 수 있는 API입니다.
\n2. 계정 연동 API: 하이웍스 화면을 아이프레임을 이용해 인트라넷에 삽입하는 SSO와 인트라넷의 조직 정보를 하이웍스 인사 계정에 넣는 조직 API로 구성되어 있습니다.
\n하이웍스 API를 이용하기 위해서는 인증이 필요하며 Token(a.k.a API KEY)을 통해 인증을 수행합니다.
토큰은 Office Token, Access Token(OAuth) 총 2가지로 분류됩니다.
[오피스 관리 > 오피스 API] 페이지에서 officeToken을 발급할 수 있습니다. 자세한 내용은 여기에서 확인할 수 있습니다.
officeToken을 비밀번호처럼 사용해 주십시오.
관리자, 개발자 외에 해당 토큰을 공유하지 마십시오.
\n해당 토큰을 코드에 삽입하거나 URL에 포함하지 마십시오.
\n\n\n\n
officeToken을 이용한 보다 폭 넓은 API 연동을 원할 경우 제휴 문의로 연락해주시기 바랍니다.
Outh 2.0 방식을 통해 사용자 정보에 접근할 수 있는 accessToken을 획득합니다.
단, accessToken의 신규 발급은 현재 지원하지 않습니다.
Authorization Code 발급을 위해 URL을 호출합니다.
API를 이용해 accessToken 발행을 요청합니다.
API를 호출할 때는 반드시 헤더에 발급받은 officeToken 또는 accessToken을 포함해야 합니다.
HTTP method(GET, POST)에 따라 API를 호출하는 방식이 다르며, 일반적으로 GET의 경우 parameter로 전달하고, POST/PUT/DELETE 방식은 HTTP BODY 영역에 값을 포함합니다.
\n# GET 방식의 호출 \nhttps://api.hiworks.com/office/v2/sms/count?user_id=admin&{{ref_key}}\n\n# POST 방식의 호출 \n{\n \"list\":\n [\n {\n \"department_code\": \"001\",\n \"department_name\": \"코스트센터001\",\n \"ext_key\": \"center001\"\n },\n {\n \"department_code\": \"002\",\n \"department_name\": \"코스트센터002\",\n \"ext_key\": \"center002\"\n }\n ]\n}\n\naccessToken을 이용하는 경우, 애플리케이션 당 최대 1,000건/일의 API Call(성공 기준)이 가능합니다.officeToken을 이용하는 경우, 오피스 당 최대 1,000건/일의 API Call(성공 기준)이 가능합니다.
이 외에도 애플리케이션 측에서 악의적으로 API를 이용한다고 판단되는 경우, 악용하는 경우 Hiworks API 플랫폼 보호를 위해 이용을 제한할 수 있습니다.
\n해당 쿼리를 초과하거나, API를 활용한 사업적 파트너 제휴가 필요할 경우 제휴 문의로 연락해주시기 바랍니다.
\nAPI에 관련한 정책 및 문의 사항은 개발자 포럼에 글을 남기거나 developers@gabia.com로 연락해주시기 바랍니다. Hiworks API에 대한 다양한 제안 등 다양한 목소리도 환영합니다.
\nAccess Token 발급에 필요한 파라미터인 Authorization Code를 요청합니다.
\n","urlObject":{"path":["open","auth","authform"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"필수 / Client ID를 입력합니다. / String
\n","type":"text/plain"},"key":"client_id","value":"{{client_id}}"},{"description":{"content":"필수 / online 또는 offline(refresh token이 필요한 경우 offline) / String
\n","type":"text/plain"},"key":"access_type","value":"offline"}],"variable":[]}},"response":[],"_postman_id":"0d759fd7-e136-467b-8c26-2c31fda3de57"},{"name":"Access Token 요청 (deprecated)","event":[{"listen":"test","script":{"id":"37fa2909-80f4-4910-987c-026eebdb8ce7","exec":[""],"type":"text/javascript"}}],"id":"a50178c2-f920-4857-a437-56a63730c9dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"description":"필수 / 발급받은 Client ID를 입력합니다 / String
\n","key":"client_id","type":"text","value":"{{client_id}}"},{"description":"필수 / 발급받은 Client Secret을 입력합니다 / String
\n","key":"client_secret","type":"text","value":"{{client_secret}}"},{"description":"필수 / 인증 형태로 'authorization_code' 로 지정합니다. / String
\n","key":"grant_type","type":"text","value":"authorization_code"},{"description":"필수 / 발급받은 Authorization Code를 입력합니다 / String
\n","key":"auth_code","type":"text","value":"{{auth_code}}"},{"description":"필수 / refresh_token 발급 여부를 선택합니다. refresh_token 발급을 원하면 'offline', access_token 발급만을 원하면 'online'을 입력합니다. / String
\n","key":"access_type","type":"text","value":"offline"}]},"url":"{{hiworks_api_url}}/open/auth/accesstoken","description":"API 접근을 위해 필요한 'accessToken'을 발급합니다.
API 호출 시 'client_secret'은 노출되면 안되는 값이므로 서버에서 API를 호출해 주시기 바랍니다.
필수 / 발급받은 Client ID를 입력합니다 / String
\n","key":"client_id","type":"text","value":"{{client_id}}"},{"description":"필수 / 발급받은 Client Secret을 입력합니다 / String
\n","key":"client_secret","type":"text","value":"{{client_secret}}"},{"description":"필수 / 인증 형태로 'refresh_token' 으로 지정합니다. / String
\n","key":"grant_type","type":"text","value":"refresh_token"},{"description":"필수 / access token 발급시 전달받은 refresh_token를 입력합니다 / String
\n","key":"refresh_token","type":"text","value":"{{refresh_token}}"},{"description":"필수 / refresh_token 발급 여부를 선택합니다. refresh_token 발급을 원하면 'offline', access_token 발급만을 원하면 'online'을 입력합니다. / String
\n","key":"access_type","type":"text","value":"offline"}]},"url":"{{hiworks_api_url}}/open/auth/accesstoken","description":"API 접근을 위해 필요한 'Access Token'은 발급 후, 1시간 동안만 유효합니다.
이후 시간에는 해당 'Access Token'은 만료되어 더는 사용할 수 없습니다.
Access Token 발급 시 전달받은 'refresh_token'을 이용하여, 새로운 'Access Token'을 발급받으시길 바랍니다.
Oauth2.0란?
\n애플리케이션(Third party)에서 사용자의 권한으로 하이웍스 서비스를 접근할 때 사용되는 인증 방식입니다.
정상적으로 인증 시, 하이웍스 API는 'accessToken'을 발급합니다.
bearer 뒤에 공백 한칸하고 accessToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/user/v2/me","description":"내 정보를 조회합니다.
\n","urlObject":{"path":["user","v2","me"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"8ea603b6-879f-4e09-bfc4-475947fb0c1b","name":"내 정보 조회","originalRequest":{"method":"GET","header":[{"description":"oAuth Token, scope: open.oauth.user","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{access_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/user/v2/me"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 05:43:53 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"63"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"no\": \"1234567\",\n \"user_id\": \"admin\",\n \"name\": \"홍길동\"\n}"}],"_postman_id":"0ab2671e-465b-4ff5-938b-6c6c7516e31a"}],"id":"24b9ec3e-a345-41c4-97f3-055623227f5a","description":"내 정보 조회는 사용자에 대한 사용자 No, 사용자 이메일 아이디, 사용자 이름 정보 등을 가져오는 기능입니다. 정상적인 로그인 후 발급받는 Access Token 인증을 통해 해당 기능을 사용할 수 있습니다.
기안하기 기능은 팝업 페이지 형태로 제공됩니다. 브라우저 새 창에서 해당 화면을 호출합니다.
\nRequest Body
\nAPI로 기안한 문서의 결재 상태 변경 시 지정하신 callback_url로 아래와 같은 GET 요청이 전송됩니다.
\nGET {CALLBACK_URL}?office_id={OFFICE_ID}&approval_key={APPROVAL_KEY}&approval_id={APPROVAL_ID}&approval_code={APPROVAL_CODE}&state={STATE}&request_hash={REQUEST_HASH}\n\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/approval/v2/documents/{{문서 번호}}","description":"기안하기 Callback URL Message에 포함된 문서 번호를 이용하여 문서 상태를 조회할 수 있습니다.
\n","urlObject":{"path":["approval","v2","documents","{{문서 번호}}"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"229c4419-128e-47a3-b218-0d9aa5d001a1","name":"문서 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.approval","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{url}}.hiworks.com/approval/v2/documents/173504"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:00:14 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"1628"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"type\": \"documents\",\n \"id\": \"1232345\",\n \"attributes\": {\n \"state\": \"complete\"\n }\n }\n}"}],"_postman_id":"bfcc3970-372b-4a71-8aa2-d6a9055f0e9a"}],"id":"94ded7ef-ae90-4f07-b858-5a26fe09dbda","event":[{"listen":"prerequest","script":{"id":"264f5b4d-0ec1-4e48-855e-0d4a4a66379d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"44da2909-76f0-4e03-a238-7ffb5943b01e","type":"text/javascript","exec":[""]}}],"_postman_id":"94ded7ef-ae90-4f07-b858-5a26fe09dbda","description":""},{"name":"전자결재 회계 정보 연동","item":[{"name":"코드 정보 연동","item":[{"name":"코스트 센터","item":[{"name":"코스트 센터 추가","id":"db4f9eb7-55fe-4492-b7ed-c55e52c8eeff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","type":"text","description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"list\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"department_code\": \"001\",\n\t\t\t\t\"department_name\": \"코스트센터001\",\n\t\t\t\t\"ext_key\": \"center001\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"department_code\": \"002\",\n\t\t\t\t\"department_name\": \"코스트센터002\",\n\t\t\t\t\"ext_key\": \"center002\"\n\t\t\t}\n\t\t]\n}\n"},"url":"{{hiworks_api_url}}/open/office/accounting/department","description":"코스트 센터를 추가합니다.
\nOffice Token, scope: office.accounting
\n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"list\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"department_code\": \"001\",\n\t\t\t\t\"m_department_code\": \"001m\",\n\t\t\t\t\"m_department_name\": \"코스트센터001수정\",\n\t\t\t\t\"m_ext_key\": \"center001m\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"department_code\": \"002\",\n\t\t\t\t\"m_department_code\": \"002m\",\n\t\t\t\t\"m_department_name\": \"코스트센터002수정\",\n\t\t\t\t\"m_ext_key\": \"center002m\"\n\t\t\t}\n\t\t]\n}\n"},"url":"{{hiworks_api_url}}/open/office/accounting/department","description":"코스트 센터를 수정합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"department_code\": \"3001, 3002, 3003\"\n}"},"url":"{{hiworks_api_url}}/open/office/accounting/department","description":"코스트 센터를 삭제합니다.
\n","urlObject":{"path":["open","office","accounting","department"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"0341a455-d115-4449-9197-ac2f28d98b8a","name":"코스트 센터 삭제","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"{{Bearer}} {{Bearer_token}}","description":"Office Token, scope: office.accounting"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"department_code\": \"3001, 3002, 3003\"\n}"},"url":"{{url}}.hiworks.com/open/office/accounting/department"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:10:20 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"317"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"code\": \"SUC\",\n \"department_code\": \"3001\",\n \"msg\": \"부서를 삭제했습니다.\"\n },\n {\n \"code\": \"SUC\",\n \"department_code\": \"3002\",\n \"msg\": \"부서를 삭제했습니다.\"\n },\n {\n \"code\": \"SUC\",\n \"department_code\": \"3003\",\n \"msg\": \"부서를 삭제했습니다.\"\n }\n]"}],"_postman_id":"bb98f450-3645-406e-83a5-ffad5af01967"},{"name":"코스트 센터 조회","id":"d74892fc-997f-4bf5-974a-284e6aec2c82","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","type":"text","description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{hiworks_api_url}}/open/office/accounting/department","description":"코스트 센터 목록을 조회합니다.
\n","urlObject":{"path":["open","office","accounting","department"],"host":["{{hiworks_api_url}}"],"query":[{"disabled":true,"key":"code","value":"000001"}],"variable":[]}},"response":[{"id":"3f666975-f7ad-45ab-bcae-2d87cb9c4251","name":"코스트 센터 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.accounting"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{url}}.hiworks.com/open/office/accounting/department","host":["{{url}}","hiworks","com"],"path":["open","office","accounting","department"],"query":[{"key":"code","value":"000001","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:10:31 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"2014"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"data\": [\n {\n \"basic_info_no\": \"123123\",\n \"no\": \"238\",\n \"code\": \"001m\",\n \"name\": \"코스트센터001수정\",\n \"use_flag\": \"Y\",\n \"ext_key\": \"center001m\",\n \"updatedate\": \"2019-04-01 15:09:01\"\n },\n {\n \"basic_info_no\": \"123123\",\n \"no\": \"239\",\n \"code\": \"002m\",\n \"name\": \"코스트센터002수정\",\n \"use_flag\": \"Y\",\n \"ext_key\": \"center002m\",\n \"updatedate\": \"2019-04-01 15:09:01\"\n }\n ],\n \"msg\": \"부서를 조회했습니다.\"\n}"}],"_postman_id":"d74892fc-997f-4bf5-974a-284e6aec2c82"}],"id":"084a37fe-f7b8-47ff-8faa-40d26cee6f48","_postman_id":"084a37fe-f7b8-47ff-8faa-40d26cee6f48","description":""},{"name":"거래처","item":[{"name":"거래처 추가","id":"5f52d413-c34c-437f-862c-4497430f11f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","value":"{{authorization_bearer}} {{office_token}} "},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"list\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"customer_code\": \"001\",\n\t\t\t\t\"customer_name\": \"거래처001\",\n\t\t\t\t\"business_number\":\"12345678901\",\n\t\t\t\t\"bank_name\":\"국민은행\",\n\t\t\t\t\"account_number\":\"12345678901\",\n\t\t\t\t\"account_holder\":\"거래처1\",\n\t\t\t\t\"ext_key\":\"customer001\"\n\t\t\t}\n\t\t]\n}"},"url":"{{hiworks_api_url}}/open/office/accounting/customer","description":"거래처를 추가합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"list\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"customer_code\": \"001\",\n\t\t\t\t\"m_customer_code\": \"001m\",\n\t\t\t\t\"m_customer_name\": \"거래처001m\",\n\t\t\t\t\"m_business_number\":\"09876543210\",\n\t\t\t\t\"m_bank_name\":\"신한은행\",\n\t\t\t\t\"m_account_holder\":\"거래처1m\",\n\t\t\t\t\"m_account_number\":\"09876543210\",\n\t\t\t\t\"m_ext_key\":\"customer001m\"\n\t\t\t}\n\t\t]\n}\n"},"url":"{{hiworks_api_url}}/open/office/accounting/customer","description":"거래처를 수정합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\"customer_code\": \"1112, 003code\"\n}"},"url":"{{hiworks_api_url}}/open/office/accounting/customer","description":"거래처를 삭제합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{hiworks_api_url}}/open/office/accounting/customer","description":"거래처 목록을 조회합니다.
\n","urlObject":{"path":["open","office","accounting","customer"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"6290f5e2-83b8-4dea-aa32-7b451befcf28","name":"거래처 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.accounting"},{"key":"Content-Type","value":"application/json"}],"url":"{{url}}.hiworks.com/open/office/accounting/customer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:16:21 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"2208"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"data\": [\n {\n \"basic_info_no\": \"123123\",\n \"no\": \"1234\",\n \"code\": \"001code\",\n \"name\": \"name001\",\n \"company_num\": \"1234512412\",\n \"bank_name\": \"국민은행\",\n \"account_num\": \"1525215123\",\n \"account_holder\": \"test\",\n \"use_flag\": \"Y\",\n \"ext_key\": \"\",\n \"updatedate\": \"2018-11-12 10:19:54\"\n },\n {\n \"basic_info_no\": \"123123\",\n \"no\": \"1235\",\n \"code\": \"001m\",\n \"name\": \"거래처001m\",\n \"company_num\": \"09876543210\",\n \"bank_name\": \"신한은행\",\n \"account_num\": \"09876543210\",\n \"account_holder\": \"거래처1m\",\n \"use_flag\": \"Y\",\n \"ext_key\": \"customer001m\",\n \"updatedate\": \"2019-04-01 15:14:43\"\n }\n ],\n \"msg\": \"거래처를 조회했습니다.\"\n}"}],"_postman_id":"2c9efe55-3d98-4028-8704-f56f608d60d1"}],"id":"f71bd6db-9814-4675-a162-75864b6fa72c","_postman_id":"f71bd6db-9814-4675-a162-75864b6fa72c","description":""},{"name":"계정과목","item":[{"name":"계정과목 추가","id":"595bd3fc-610c-4a1d-aa1d-fb69769b5000","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"list\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"account_code\": \"001\",\n\t\t\t\t\"account_name\": \"계정과목명001\",\n\t\t\t\t\"ext_key\": \"account001\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"account_code\": \"002\",\n\t\t\t\t\"account_name\": \"계정과목명002\",\n\t\t\t\t\"ext_key\": \"account002\"\n\t\t\t}\n\t\t]\n}"},"url":"{{hiworks_api_url}}/open/office/accounting/account","description":"계정 과목을 추가합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"list\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"account_code\": \"001\",\n\t\t\t\t\"m_account_code\": \"001m\",\n\t\t\t\t\"m_account_name\": \"계정과목명001m\",\n\t\t\t\t\"m_ext_key\": \"account001m\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"account_code\": \"002\",\n\t\t\t\t\"m_account_code\": \"002m\",\n\t\t\t\t\"m_account_name\": \"계정과목명002m\",\n\t\t\t\t\"m_ext_key\": \"account002m\"\n\t\t\t}\n\t\t]\n}"},"url":"{{hiworks_api_url}}/open/office/accounting/account","description":"계정 과목을 수정합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"account_code\": \"0111, 1111\"\n}"},"url":"{{hiworks_api_url}}/open/office/accounting/account","description":"계정 과목을 삭제합니다.
\nbearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","value":"application/json"}],"url":"{{hiworks_api_url}}/open/office/accounting/account","urlObject":{"path":["open","office","accounting","account"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"df731b06-3a0f-4198-bbd5-542d69e3d301"}],"id":"4aad66b8-43f6-495d-9d14-5400a8bc5af1","_postman_id":"4aad66b8-43f6-495d-9d14-5400a8bc5af1","description":""}],"id":"aca8b3e6-2c3d-43b5-9c2b-f2758e9eedbf","description":"ERP 등 외부 애플리케이션의 경우 자체적으로 거래처, 계정과목, 코스트 센터 등의 코드를 관리하고 있습니다. 하이웍스는 외부 코드 정보를 하이웍스와 동기화할 수 있는 방식을 제공합니다(애플리케이션의 코드 정보를 하이웍스 코드 정보에 전달하는 방식).
\n","event":[{"listen":"prerequest","script":{"id":"d0929c42-748f-4dc1-9599-d5c1b08d9f24","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b0ccaab6-d7f4-4c92-8be4-9ed086e3457f","type":"text/javascript","exec":[""]}}],"_postman_id":"aca8b3e6-2c3d-43b5-9c2b-f2758e9eedbf"},{"name":"지출결의 데이터 조회","id":"3699375a-d194-45e1-9f87-dbab44969a9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.accounting
\n"},{"key":"Content-Type","value":"application/json"}],"url":"{{hiworks_api_url}}/open/office/accounting/spending_report?fixed_date=201902&type=P&approval_status=C","urlObject":{"path":["open","office","accounting","spending_report"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"필수 / 기준월을 입력합니다. YYYYMM 형태로 조회할 수 있습니다.
\n","type":"text/plain"},"key":"fixed_date","value":"201902"},{"description":{"content":"개인(P), 법인 (C) 여부를 설정합니다. 전체 조회를 희망할 경우 입력하지 않습니다.
\n","type":"text/plain"},"key":"type","value":"P"},{"description":{"content":"문서 결재 상태에 따라 조회할 수 있습니다. 결재 중(P),결재 완료(C) 전체 조회를 희망할 경우 입력하지 않습니다.
\n","type":"text/plain"},"key":"approval_status","value":"C"},{"disabled":true,"description":{"content":"문서 회계 처리 상태 대기 중(W), 처리완료(C)
\n","type":"text/plain"},"key":"accounting_status","value":"W"},{"disabled":true,"description":{"content":"회계상태별칭
\n","type":"text/plain"},"key":"alias","value":""}],"variable":[]}},"response":[{"id":"097c0986-1dc4-400c-9a3c-8c3777e946bc","name":"지출결의 데이터 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.accounting"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{url}}.hiworks.com/open/office/accounting/spending_report?fixed_date=201902&type=P&approval_status=C&accounting_status=W&alias=","host":["{{url}}","hiworks","com"],"path":["open","office","accounting","spending_report"],"query":[{"key":"fixed_date","value":"201902","description":"필수) 기준월 (YYYYMM)"},{"key":"type","value":"P","description":"구분 전체(기본), 개인(P), 법인 (C)"},{"key":"approval_status","value":"C","description":"문서 결재 상태 결재 중(P),결재 완료(C)"},{"key":"accounting_status","value":"W","description":"문서 회계 처리 상태 대기 중(W), 처리완료(C)"},{"key":"alias","value":"","description":"회계상태별칭"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:20:26 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"1853"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"data\": [\n {\n \"document_code\": \"지결-20190327-1234\",\n \"document_no\": \"1231233\",\n \"slip_number\": \"1903272c644\",\n \"document_regdate\": \"2019-03-27 20:27:51\",\n \"register_name\": \"홍길동\",\n \"register_id\": \"admin\",\n \"register_company_num\": \"\",\n \"spender_user_name\": \"홍길동\",\n \"spender_user_id\": \"admin\",\n \"spender_company_num\": \"\",\n \"type\": \"P\",\n \"card_name\": \"\",\n \"card_number\": \"\",\n \"bank_name\": \"국민은행\",\n \"account_num\": \"123123-1231231\",\n \"fixed_date\": \"2019-02-28\",\n \"alias\": \"test1\",\n \"accounting_status\": \"W\",\n \"updatedate\": \"2019-03-27 21:15:09\",\n \"number\": \"1\",\n \"department_code\": \"3002\",\n \"department_name\": \"테스트2002\",\n \"account_code\": \"0111\",\n \"account_name\": \"test0111\",\n \"price\": \"1111\",\n \"tax\": \"\",\n \"expense_date\": \"2019-02-01\",\n \"proof\": \"receipt\",\n \"cash_receipts_num\": \"\",\n \"customer_code\": \"\",\n \"customer_name\": \"asdfasdf\",\n \"customer_company_num\": \"\",\n \"accounting_no\": \"7693\",\n \"brief\": \"asdf\"\n },\n {\n \"document_code\": \"지결-20190227-1231\",\n \"document_no\": \"1231234\",\n \"slip_number\": \"19023227ee0\",\n \"document_regdate\": \"2019-02-27 11:56:56\",\n \"register_name\": \"홍길동\",\n \"register_id\": \"admin\",\n \"register_company_num\": \"\",\n \"spender_user_name\": \"홍길동\",\n \"spender_user_id\": \"admin\",\n \"spender_company_num\": \"\",\n \"type\": \"P\",\n \"card_name\": \"\",\n \"card_number\": \"\",\n \"bank_name\": \"국민은행\",\n \"account_num\": \"123123-1231231\",\n \"fixed_date\": \"2019-02-28\",\n \"alias\": \"\",\n \"accounting_status\": \"W\",\n \"updatedate\": \"0000-00-00 00:00:00\",\n \"number\": \"1\",\n \"department_code\": \"dept0002\",\n \"department_name\": \"name0002\",\n \"account_code\": \"asdfasd\",\n \"account_name\": \"123\",\n \"price\": \"12312\",\n \"tax\": \"1231\",\n \"expense_date\": \"2019-02-06\",\n \"proof\": \"tax_bill\",\n \"cash_receipts_num\": \"\",\n \"customer_code\": \"12345\",\n \"customer_name\": \"name12345\",\n \"customer_company_num\": \"11234012\",\n \"accounting_no\": \"7068\",\n \"brief\": \"123\"\n }\n ],\n \"msg\": \"지출결의 내역을 조회했습니다.\"\n}"}],"_postman_id":"3699375a-d194-45e1-9f87-dbab44969a9e"},{"name":"지출결의 데이터 수정","id":"f1900668-c691-47b8-8d0c-e5453dfda708","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"description":"Office Token, scope: office.accounting
\n","key":"Authorization","value":"{{authorization_bearer}} {{Bearer_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"list\":\n [\n {\n \"document_no\": \"181913\",\n \"m_accounting_status\": \"W\",\n \"m_alias\":\"alias001m\"\n }\n\t]\n}\n"},"url":"{{hiworks_api_url}}/open/office/accounting/spending_report","urlObject":{"path":["open","office","accounting","spending_report"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"b204731d-e3b4-4d4c-8a3a-0a8aa8b230a4","name":"지출결의 데이터 수정","originalRequest":{"method":"PUT","header":[{"key":"Authorization","value":"{{Bearer}} {{Bearer_token}}","description":"Office Token, scope: office.accounting"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"list\":\n [\n {\n \"document_no\": \"181913\",\n \"m_accounting_status\": \"W\",\n \"m_alias\":\"alias001m\"\n }\n\t]\n}\n"},"url":"{{url}}.hiworks.com/open/office/accounting/spending_report"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:21:14 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"166"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"document_no\": \"181913\",\n \"m_accounting_status\": \"W\",\n \"m_alias\": \"alias001m\",\n \"code\": \"SUC\",\n \"msg\": \"처리 상태를 수정했습니다.\"\n }\n]"}],"_postman_id":"f1900668-c691-47b8-8d0c-e5453dfda708"}],"id":"c8099135-35df-406c-986b-11bd8cd0de21","description":"전자결재 지출결의서를 이용해 누적된 지출/송금 데이터를 조회할 수 있습니다.
\n","event":[{"listen":"prerequest","script":{"id":"31a58429-ccb6-400c-be65-0a77637f9955","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3536dbd4-d136-4b83-a085-7a1b320023b6","type":"text/javascript","exec":[""]}}],"_postman_id":"c8099135-35df-406c-986b-11bd8cd0de21"}],"id":"07add76d-d3c4-418e-b406-9ab99585eada","description":"여러분의 애플리케이션에 결재 프로세스를 포함할 수 있습니다.
\n하이웍스 지출결의서 데이터 내역을 조회할 수 있습니다.
\n","event":[{"listen":"prerequest","script":{"id":"15cee5fd-2c89-4ca3-aaee-c12790b0da84","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7d9ac221-79b6-440d-ad12-c959748f1aa3","type":"text/javascript","exec":[""]}}],"_postman_id":"07add76d-d3c4-418e-b406-9ab99585eada"},{"name":"인사관리","item":[{"name":"조직도 조회","id":"70b8ab2d-a43d-4d7d-aea0-d9d6d5403750","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{hiworks_api_url}}/hrm/v2/organizations","description":"조직도 전체 목록을 조회합니다.
\n","urlObject":{"path":["hrm","v2","organizations"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"c888b609-76c9-4039-8481-e816f91cb552","name":"조직도 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.hrm","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{url}}.hiworks.com/hrm/v2/organizations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:26:19 GMT"},{"key":"Server","value":"Apache"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"node_id\": \"12312\",\n \"name\": \"하이웍스\",\n \"entries\": [\n {\n \"is_admin\": \"Y\",\n \"is_construction_admin\": \"N\",\n \"mail_id\": \"admin\",\n \"name\": \"홍길동\",\n \"email\": \"\",\n \"phone\": \"\",\n \"cell\": \"\",\n \"node_id\": \"12312\",\n \"user_no\": \"1232345\"\n },\n {\n \"is_admin\": \"N\",\n \"is_construction_admin\": \"N\",\n \"mail_id\": \"kcs\",\n \"name\": \"김철수\",\n \"email\": \"\",\n \"phone\": \"\",\n \"cell\": \"\",\n \"node_id\": \"12312\",\n \"user_no\": \"2343456\"\n },\n {\n \"is_admin\": \"N\",\n \"is_construction_admin\": \"N\",\n \"mail_id\": \"kyh\",\n \"name\": \"김영희\",\n \"email\": \"\",\n \"phone\": \"\",\n \"cell\": \"\",\n \"node_id\": \"12312\",\n \"user_no\": \"3454567\"\n }\n ],\n \"nodes\": [\n {\n \"node_id\": \"23434\",\n \"name\": \"하이웍스 마케팅\",\n \"parent_no\": \"12312\",\n \"entries\": [\n {\n \"is_admin\": \"N\",\n \"is_construction_admin\": \"N\",\n \"mail_id\": \"kkd\",\n \"name\": \"김길동\",\n \"email\": \"\",\n \"phone\": \"\",\n \"cell\": \"\",\n \"node_id\": \"23434\",\n \"user_no\": \"4565678\"\n },\n {\n \"is_admin\": \"N\",\n \"is_construction_admin\": \"N\",\n \"mail_id\": \"khs\",\n \"name\": \"김희선\",\n \"email\": \"\",\n \"phone\": \"\",\n \"cell\": \"\",\n \"node_id\": \"23434\",\n \"user_no\": \"5676789\"\n }\n ]\n }\n ]\n}"}],"_postman_id":"70b8ab2d-a43d-4d7d-aea0-d9d6d5403750"},{"name":"사용자 조회","id":"30bf5a5c-657f-43ab-b9de-179ea6c05a0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/hrm/v2/users","description":"사용자 전체 목록을 조회합니다.
\n","urlObject":{"path":["hrm","v2","users"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"4a180f4f-ba38-4352-89f1-378b3f8d1c8e","name":"사용자 조회","originalRequest":{"method":"GET","header":[{"description":"Office Token, scope: office.user","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{url}}.hiworks.com/user/v2/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 05:40:15 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"6307"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"no\": \"1231234\",\n \"user_id\": \"admin\",\n \"name\": \"홍길동\"\n },\n {\n \"no\": \"2345678\",\n \"user_id\": \"kcs\",\n \"name\": \"김철수\"\n },\n {\n \"no\": \"3454567\",\n \"user_id\": \"kyh\",\n \"name\": \"김영희\"\n }\n]"}],"_postman_id":"30bf5a5c-657f-43ab-b9de-179ea6c05a0f"}],"id":"7d8e01e9-0146-4b9c-babb-416ba3655427","event":[{"listen":"prerequest","script":{"id":"37e2c521-bb51-4695-b031-80e7b89212f8","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2c43fb9a-b514-42ae-98f9-4e4b1c8b1018","type":"text/javascript","exec":[""]}}],"_postman_id":"7d8e01e9-0146-4b9c-babb-416ba3655427","description":""},{"name":"알림","item":[{"name":"알림 발송","id":"51399382-24d6-4377-bb92-7c9fe01df9cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"user_list\":[\n \"admin\"\n ],\n \"message\":\"메시지\",\n \"link\":\"https://developers.hiworks.com\",\n \"mlink\":\"https://m.hiworks.com\",\n \"solution_name\":\"알림제목림\",\n \"solution_image_url\":\"https://www.hiworks.com/static/images/logo.png\"\n}"},"url":"{{hiworks_api_url}}/office/v2/notify","description":"사용자에게 알림을 발송할 수 있습니다.
\n실시간으로 발송되는 메신저 알림으로 업무를 효율적으로 처리할 수 있습니다. \n사용 방법은 여기를 확인해 주세요.
\n","event":[{"listen":"prerequest","script":{"id":"3dccf411-e2d7-4cf9-a529-869c44899ec9","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"44c9f9fe-fb30-4ea8-b6fc-93f136644ffa","type":"text/javascript","exec":[""]}}],"_postman_id":"5ace9f8f-0fac-4253-98da-92d9e46cf235"},{"name":"메일","item":[{"name":"메일 발송","id":"03c73005-4788-4b24-ae65-96cf933cb4ee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"bearer 뒤에 공백 한칸하고 OfficeToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"Bearer {{office_token}}"}],"body":{"mode":"formdata","formdata":[{"key":"to","value":"{{mail_address}}","type":"text","description":"필수 / 받는 사람을 입력합니다. / String
\n"},{"key":"user_id","value":"{{user_id}}","description":"필수 / 보낸는 사람 하이웍스 사용자 계정 ID를 입력합니다. / String
\n","type":"text"},{"key":"cc","value":"{{mai_cc_address}}","type":"text","description":"참조자를 입력합니다. / String
\n","disabled":true},{"key":"bcc","value":"{{mail_bcc_address}}","type":"text","description":"숨은 참조를 입력합니다. / String
\n","disabled":true},{"key":"subject","value":"{{mail_subject}}","type":"text","description":"메일 제목을 입력합니다. / String
\n"},{"key":"content","value":"{{mail_content}}","type":"text","description":"필수 / 메일 본문을 입력합니다. / String
\n"},{"key":"save_sent_mail","value":"Y","type":"text","description":"필수 / 보낸 편지함에 저장 여부를 입력합니다. / Y 또는 N
\n"}]},"url":"{{hiworks_api_url}}/office/v2/webmail/sendMail","description":"사용자에게 메일을 발송합니다.
\nbody는 form-data로 전송하셔야 합니다.
\n","urlObject":{"path":["office","v2","webmail","sendMail"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"63dc5eb1-88bd-4381-b4ac-345e70169675","name":"메일 발송","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.mail.send"},{"key":"","value":"","disabled":true},{"key":"Content-Type","value":"","disabled":true}],"body":{"mode":"formdata","formdata":[{"key":"to","value":"{{mail_address}}","type":"text","description":"필수 / 받는 사람"},{"key":"user_id","value":"{{user_id}}","description":"필수 / 보낸는 사람 하이웍스 사용자 계정 ID를 입력합니다.","type":"text"},{"key":"cc","value":"{{mai_cc_address}}","type":"text","description":"참조자"},{"key":"bcc","value":"{{mail_bcc_address}}","type":"text","description":"숨은 참조"},{"key":"subject","value":"{{mail_subject}}","type":"text","description":"필수 / 메일 제목"},{"key":"content","value":"{{mail_content}}","type":"text","description":"필수 / 메일 본문"},{"key":"save_sent_mail","value":"N","type":"text","description":"필수 / 보낸 편지함에 저장 여부 /Y 또는 N"}]},"url":"{{hiworks_api_url}}/office/v2/webmail/sendMail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 09 Apr 2019 07:56:36 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"143"},{"key":"Connection","value":"close"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"result\": {\n \"successList\": [\n \"to@test.com\",\n \"cc@test.com\",\n \"bcc@test.com\"\n ],\n \"dupList\": [],\n \"wrongList\": []\n }\n}"}],"_postman_id":"03c73005-4788-4b24-ae65-96cf933cb4ee"}],"id":"2ef769c9-35cc-4605-8e20-4b16a2d1d275","description":"하이웍스 메일을 애플리케이션과 연동할 수 있습니다. 안전한 메일 수/발신 환경을 위해 아래 내용을 숙지한 후 이용해주시기 바랍니다.
\nOffice Token, scope: office.sms
\n"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_id\": \"admin\",\n\t\"sms_type\": \"S\",\n\t\"sender\": \"01011112222\",\n\t\"receiver\": \"01033334444\",\n\t\"subject\" : \"제목\",\n\t\"message\": \"본문\",\n\t\"send_date\": \"2019-04-01 15:40:11\",\n\t\"file\": \"\"\n}"},"url":"{{hiworks_api_url}}/office/v2/sms/send","urlObject":{"path":["office","v2","sms","send"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"dea9b95e-3e6e-48cc-9d96-33dcf3737a6b","name":"문자 발송","originalRequest":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_id\": \"admin\",\n\t\"sms_type\": \"S\",\n\t\"sender\": \"01011112222\",\n\t\"receiver\": \"01033334444\",\n\t\"subject\" : \"제목\",\n\t\"message\": \"본문\",\n\t\"send_date\": \"2019-04-01 15:40:11\",\n\t\"file\": \"\"\n}"},"url":"https://api.hiworks.com/office/v2/sms/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:39:09 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"157"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"result\": {\n \"success\": 1,\n \"fail\": 0,\n \"refkey\": \"NzQwODg21zZWMyOWQ1NTI0OTMxNmQ0ZGFh23DU2Mzk=\",\n \"BEFORE_SMS_QTY\": 291,\n \"AFTER_SMS_QTY\": 290\n }\n}"}],"_postman_id":"7af1b3b8-cf1a-4833-a526-d556a2bea579"},{"name":"문자 발송(팝업)","id":"38d5df25-3924-426a-992e-3bcb17186158","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{hiworks_api_url}}/{오피스주소}/sms/popup/write","urlObject":{"path":["{오피스주소}","sms","popup","write"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"38d5df25-3924-426a-992e-3bcb17186158"},{"name":"문자 잔여 건수 조회","event":[{"listen":"test","script":{"id":"e51f9b96-3dab-4342-9fdc-d254cd21912a","exec":[""],"type":"text/javascript"}}],"id":"927ad4a7-c6a8-40e4-802d-04295dff5bb5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms
\n"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/office/v2/sms/count?user_id=admin","urlObject":{"path":["office","v2","sms","count"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"필수) 사용자 아이디
\n","type":"text/plain"},"key":"user_id","value":"admin"}],"variable":[]}},"response":[{"id":"089b6256-e93d-45fc-8c0d-6d384fe06001","name":"문자 잔여 건수 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.hiworks.com/office/v2/sms/count?user_id=admin","protocol":"https","host":["api","hiworks","com"],"path":["office","v2","sms","count"],"query":[{"key":"user_id","value":"admin","description":"필수) 사용자 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:34:47 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"93"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"result\": {\n \"shared\": 291,\n \"assign\": 0,\n \"shared_ars\": 0,\n \"assign_ars\": 0\n }\n}"}],"_postman_id":"927ad4a7-c6a8-40e4-802d-04295dff5bb5"},{"name":"전송 내역 조회","id":"fcf03956-7676-4ef4-af8f-f1eade56cedb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms
\n"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/office/v2/sms/result?user_id=admin&ref_key=SMS 전송 리턴키","urlObject":{"path":["office","v2","sms","result"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"필수) 사용자 아이디
\n","type":"text/plain"},"key":"user_id","value":"admin"},{"description":{"content":"필수) SMS 전송 리턴키 / 문자 발송 시, 리턴값('refkey')
\n","type":"text/plain"},"key":"ref_key","value":"SMS 전송 리턴키"}],"variable":[]}},"response":[],"_postman_id":"fcf03956-7676-4ef4-af8f-f1eade56cedb"},{"name":"문자 사용 건수 조회","id":"bfa07758-c820-4f03-8f8e-8a6cd3411d85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"{{hiworks_api_url}}/office/v2/sms/usage?user_id=admin","urlObject":{"path":["office","v2","sms","usage"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"필수) 사용자 아이디
\n","type":"text/plain"},"key":"user_id","value":"admin"}],"variable":[]}},"response":[{"id":"d0a47673-7fd7-423f-85fa-516522366a8c","name":"문자 사용 건수 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"https://api.hiworks.com/office/v2/sms/usage?user_id=admin","protocol":"https","host":["api","hiworks","com"],"path":["office","v2","sms","usage"],"query":[{"key":"user_id","value":"admin","description":"필수) 사용자 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:37:01 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"119"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"result\": {\n \"sms_use_count\": 18,\n \"lms_use_count\": 2,\n \"mms_use_count\": 3,\n \"period\": \"LAST 6 MONTHS\"\n }\n}"}],"_postman_id":"bfa07758-c820-4f03-8f8e-8a6cd3411d85"},{"name":"예약 발송 수정","id":"c3b5ddc8-6354-4203-a132-a6bc4860f9ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms
\n"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_id\": \"admin\",\n\t\"ref_key\": \"NzQwODgzZWMyOWQ1NTI0OTMxNmQ0ZGFhMWQ2NDU2Mzk=\",\n\t\"send_date\": \"2019-04-02 14:30:00\"\n}"},"url":"{{hiworks_api_url}}/office/v2/sms/reserve","urlObject":{"path":["office","v2","sms","reserve"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"a08fe733-cfd1-4185-a1b4-f969781b9e6c","name":"예약 발송 수정","originalRequest":{"method":"PUT","header":[{"key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_id\": \"admin\",\n\t\"ref_key\": \"NzQwODgzZWMyOW123Q1NTI0OTM4Mzk=\",\n\t\"send_date\": \"2019-04-02 14:30:00\"\n}"},"url":"https://api.hiworks.com/office/v2/sms/reserve"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:39:30 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"28"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\"\n}"}],"_postman_id":"c3b5ddc8-6354-4203-a132-a6bc4860f9ac"},{"name":"예약 발송 취소","id":"99aa3d74-529a-4fd6-8283-e09d962d2c3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"description":"Office Token, scope: office.sms
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_id\": \"admin\",\n\t\"ref_key\": \"NzQwODgzZWMyOWQ1NTI0OTMxNmQ0ZGFhMWQ2NDU2Mzk=\"\n}"},"url":"{{hiworks_api_url}}/office/v2/sms/reserve","urlObject":{"path":["office","v2","sms","reserve"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[{"id":"ba8c24ae-1d1d-46af-bf3d-3bc52c94a069","name":"예약 발송 취소","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}","description":"Office Token, scope: office.sms"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_id\": \"admin\",\n\t\"ref_key\": \"NzQwODgzZWMyOWQ112312NTI0OTMxNmQ042Mzk=\"\n}"},"url":"https://api.hiworks.com/office/v2/sms/reserve"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:39:41 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"28"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\"\n}"}],"_postman_id":"99aa3d74-529a-4fd6-8283-e09d962d2c3f"}],"id":"b53309d4-bd86-4ee1-a016-d0ae0930b0f0","_postman_id":"b53309d4-bd86-4ee1-a016-d0ae0930b0f0","description":""},{"name":"카카오 알림톡","item":[{"name":"알림톡 발송하기","id":"e050f696-2f5f-4540-ad33-553eeab87c80","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}","description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\t\"data\" : {\r\n \t\"type\" : \"kakao_messages\",\r\n \t\"attributes\" : {\r\n \t\t\"user_id\" : \"test\",\r\n \t\t\"to\" : \"82101234567\",\r\n \t\t\"template_name\" : \"회원 가입\",\r\n \t\t\"message\" : \"안녕하세요.\\n 회원가입이 완료되었습니다.\",\r\n \t\t\"date_to_send\": \"2019-07-01 09:00:00\",\r\n \t\t\"re_send\": \"Y\",\r\n \t\t\"re_send_subject\": \"회원 가입 안내\",\r\n \t\t\"re_send_from\": \"15444370\"\r\n \t}\r\n\t}\r\n}\r\n\r\n"},"url":"{{hiworks_api_url}}/kakao/v2/messages/","description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/kakao/v2/balance?filter[user_id]=%오피스아이디%","description":"카카오 알림톡 잔여 건수를 확인할 수 있습니다.
\n","urlObject":{"path":["kakao","v2","balance"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"필수) 오피스아이디
\n","type":"text/plain"},"key":"filter[user_id]","value":"%오피스아이디%"}],"variable":[]}},"response":[],"_postman_id":"87a77347-0c81-40c1-99db-370422099925"},{"name":"전송 내역 조회","id":"43492a17-6083-4375-8e73-a9bd54e966c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"bearer 뒤에 공백 한칸하고 officeToken을 포함합니다.
\n","key":"Authorization","type":"text","value":"{{authorization_bearer}} {{office_token}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"{{hiworks_api_url}}/kakao/v2/messages/%ID%","description":"발송 요청된 카카오 알림톡의 전송 내역을 조회할 수 있습니다.
\nHeader
Authorization: bearer office_token
bearer 뒤에 스페이스(공백) 후, officeToken을 포함합니다.
Content-Type: application/json
\nURI
%ID% -> 알림톡을 발송한 후, 리턴된 kakao_messages의 ID를 URI에 포함합니다.
JSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n"},{"key":"Office-Authorization","value":"{{Office-Authorization}}","description":"(필수)생성하신 office api token 정보를 입력합니다
\n"},{"key":"Bill-Access-Authorization","value":"{{Bill-Access-Authorization}}","description":"(필수)세금계산서 api token 정보를 입력합니다
\n"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"information\": {\r\n \"issueDate\": \"2021-01-01\",\r\n \"memo\": \"메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"111-111\",\r\n \"description\": \"\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"220\",\r\n \"totalSupplyPrice\": \"200\",\r\n \"totalTax\": \"20\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"A\",\r\n \"typeCode\": \"A\"\r\n },\r\n \"invoicer\": \"123-45-12345\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"123-45-12345\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"공급받는자 사업자 명\",\r\n \"companyAddress\": \"공급받는자 사업자 주소\",\r\n \"ceoName\": \"대표자명\",\r\n \"bizType\": \"\",\r\n \"bizClassification\": \"\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"10\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"10\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ],\r\n \"tempFileIds\" : [100, 101],\r\n \"officeFileIds\" : [1, 3, 5]\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/invoices","description":"세금계산서에서 과세 세금계산서를 작성합니다.
\nBody내 입력값 중 invoiceType에서 typeCode를 A로, taxType을 A로 명시합니다.
JSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"(필수)생성하신 office api token 정보를 입력합니다
\n","key":"Office-Authorization","type":"text","value":""},{"description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","key":"Bill-Access-Authorization","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"information\": {\r\n \"issueDate\": \"2021-01-01\",\r\n \"memo\": \"메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"111-111\",\r\n \"description\": \"\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"0\",\r\n \"totalSupplyPrice\": \"200\",\r\n \"totalTax\": \"0\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"B\",\r\n \"typeCode\": \"A\"\r\n },\r\n \"invoicer\": \"123-45-12345\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"123-45-12345\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"공급받는자 사업자 명\",\r\n \"companyAddress\": \"공급받는자 사업자 주소\",\r\n \"ceoName\": \"대표자명\",\r\n \"bizType\": \"\",\r\n \"bizClassification\": \"\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"0\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"0\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ],\r\n \"tempFileIds\" : [],\r\n \"officeFileIds\" : [1, 3, 5]\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/invoices","description":"세금계산서에서 과세 세금계산서를 작성합니다.
\nBody내 입력값 중 invoiceType에서 typeCode를 A로, taxType을 B로 명시합니다.
JSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"(필수)생성하신 office api token 정보를 입력합니다
\n","key":"Office-Authorization","type":"text","value":""},{"description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","key":"Bill-Access-Authorization","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"information\": {\r\n \"issueDate\": \"2021-01-01\",\r\n \"memo\": \"메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"111-111\",\r\n \"description\": \"\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"0\",\r\n \"totalSupplyPrice\": \"200\",\r\n \"totalTax\": \"0\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"B\",\r\n \"typeCode\": \"B\"\r\n },\r\n \"invoicer\": \"123-45-12345\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"123-45-12345\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"공급받는자 사업자 명\",\r\n \"companyAddress\": \"공급받는자 사업자 주소\",\r\n \"ceoName\": \"대표자명\",\r\n \"bizType\": \"\",\r\n \"bizClassification\": \"\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"0\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"0\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ],\r\n \"tempFileIds\" : [103],\r\n \"officeFileIds\" : []\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/invoices","description":"세금계산서에서 면세 계산서를 작성합니다.
\nBody내 입력값 중 invoiceType에서 typeCode를 B로, taxType을 B로 명시합니다.
taxType을 A로 명시할 시 검증 과정에서 오류가 발생합니다.
JSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"(필수)생성하신 office api token 정보를 입력합니다
\n","key":"Office-Authorization","type":"text","value":""},{"description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","key":"Bill-Access-Authorization","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"information\": {\r\n \"issueDate\": \"2021-01-01\",\r\n \"memo\": \"메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"111-111\",\r\n \"description\": \"\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"0\",\r\n \"totalSupplyPrice\": \"200\",\r\n \"totalTax\": \"0\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"B\",\r\n \"typeCode\": \"D\"\r\n },\r\n \"invoicer\": \"123-45-12345\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"123-45-12345\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"공급받는자 사업자 명\",\r\n \"companyAddress\": \"공급받는자 사업자 주소\",\r\n \"ceoName\": \"대표자명\",\r\n \"bizType\": \"\",\r\n \"bizClassification\": \"\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"0\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"0\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ],\r\n \"tempFileIds\" : [100, 101],\r\n \"officeFileIds\" : [1, 3, 5]\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/invoices","description":"거래명세서를 작성합니다.
\nBody내 입력값 중 invoiceType에서 typeCode를 D로 명시합니다.
거래명세서는 간편서명이 적용되지 않습니다.
\nJSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"(필수)생성하신 office api token 정보를 입력합니다
\n","key":"Office-Authorization","type":"text","value":""},{"description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","key":"Bill-Access-Authorization","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"easySign\" : \"Y\",\r\n \"information\": {\r\n \"issueDate\": \"2021-01-01\",\r\n \"memo\": \"메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"111-111\",\r\n \"description\": \"\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"220\",\r\n \"totalSupplyPrice\": \"200\",\r\n \"totalTax\": \"20\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"A\",\r\n \"typeCode\": \"A\"\r\n },\r\n \"invoicer\": \"123-45-12345\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"123-45-12345\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"공급받는자 사업자 명\",\r\n \"companyAddress\": \"공급받는자 사업자 주소\",\r\n \"ceoName\": \"대표자명\",\r\n \"bizType\": \"\",\r\n \"bizClassification\": \"\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"10\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"10\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ]\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/invoices","description":"API에서 문서 작성 후 바로 국세청 전송이 가능한 간편 서명 기능이 도입됩니다.
\n간편 서명은 공인인증서를 등록하면 자동으로 서명 인증 절차가 진행되어 세금계산서 발급 및 국세청 전송이 곧바로 이뤄집니다.
\n간편 서명은 하이웍스 전자세금계산서에 공인인증서 인증 정보를 등록한 후 이용할 수 있습니다.
\n사용 가능한 인증서는 가비아 전용 공인인증서만 등록, 이용할 수 있습니다.
\n(세금)계산서 생성 시, 간편 서명에 필요한 value값 'Y'(대문자만 사용)가 포함되어야 간편 서명이 이루어집니다.
\n{\n \"data\": {\n \"easySign\": \"Y\",\n \"information\" : {...},\n ...\n},\n수정 (세금)계산서 생성 시, data 아래 positive, negative와 같은 단계에서 간편 서명 value값이 존재해야합니다.
\n{\n \"data\": {\n \"easySign\":\"Y\",\n \"amendment\" : {...},\n \"positive\" : {...},\n \"negative\" : {...}\n }\n}\nJSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"(필수)생성하신 office api token 정보를 입력합니다
\n","key":"Office-Authorization","type":"text","value":""},{"description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","key":"Bill-Access-Authorization","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"amendment\": {\r\n \"originalIssueId\": \"{원본 세금계산서의 당초승인번호}\",\r\n \"modifyType\": \"1\"\r\n },\r\n \"negative\": {\r\n \"information\": {\r\n \"issueDate\": \"2021-01-01\",\r\n \"memo\": \"메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"124-123\",\r\n \"description\": \"remark\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"0\",\r\n \"totalSupplyPrice\": \"-200\",\r\n \"totalTax\": \"-20\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"A\",\r\n \"typeCode\": \"M\"\r\n },\r\n \"invoicer\": \"214-86-39239\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"214-86-39239\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"가비아\",\r\n \"companyAddress\": \"경기도 성남시 분당구 대왕판교로 660\",\r\n \"ceoName\": \"김가비아\",\r\n \"bizType\": \"전산\",\r\n \"bizClassification\": \"전산\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"-100\",\r\n \"supplyPrice\": \"-100\",\r\n \"tax\": \"-10\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"-100\",\r\n \"supplyPrice\": \"-100\",\r\n \"tax\": \"-10\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ]\r\n },\r\n \"positive\": {\r\n \"information\": {\r\n \"issueDate\": \"2020-01-01\",\r\n \"memo\": \" 수정된 세금계산서의 메모 입니다\",\r\n \"bookNo\": \"\",\r\n \"serial\": \"124-123\",\r\n \"description\": \"remark\",\r\n \"cash\": \"0\",\r\n \"check\": \"0\",\r\n \"draft\": \"0\",\r\n \"uncollected\": \"0\",\r\n \"totalSupplyPrice\": \"200\",\r\n \"totalTax\": \"20\"\r\n },\r\n \"invoiceType\": {\r\n \"transactionType\": \"S\",\r\n \"purposeType\": \"C\",\r\n \"taxType\": \"A\",\r\n \"typeCode\": \"M\"\r\n },\r\n \"invoicer\": \"214-86-39239\",\r\n \"invoicee\": {\r\n \"companyNumber\": \"214-86-39239\",\r\n \"taxNumber\": \"\",\r\n \"companyName\": \"가비아\",\r\n \"companyAddress\": \"경기도 성남시 분당구 대왕판교로 660\",\r\n \"ceoName\": \"김가비아\",\r\n \"bizType\": \"전산\",\r\n \"bizClassification\": \"전산\",\r\n \"partyTypeCode\": \"01\",\r\n \"primaryContact\": {\r\n \"name\": \"수정된 공급받는자1\",\r\n \"email\": \"noreaply@gabia.com\",\r\n \"cell\": \"02-000-0000\",\r\n \"phone\": \"010-0000-0000\"\r\n },\r\n \"secondaryContact\": {\r\n \"name\": \"수정된 공급받는자2 \",\r\n \"email\": \"noreply@gabia.com\",\r\n \"cell\": \"02-0000-0002\",\r\n \"phone\": \"010-0000-0002\"\r\n }\r\n },\r\n \"items\": [\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"수정된 항목이름1\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"10\",\r\n \"description\": \"항목 비고란1\"\r\n },\r\n {\r\n \"month\": \"01\",\r\n \"day\": \"01\",\r\n \"subject\": \"수정된 항목이름2\",\r\n \"unit\": \"EA\",\r\n \"quantity\": \"1\",\r\n \"unitPrice\": \"100\",\r\n \"supplyPrice\": \"100\",\r\n \"tax\": \"10\",\r\n \"description\": \"항목 비고란2\"\r\n }\r\n ]\r\n },\r\n \"tempFileIds\" : [100, 101],\r\n \"officeFileIds\" : [1, 3, 5]\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/invoices/amendment","description":"수정세금계산서, 수정계산서를 작성합니다.
\nBody내 입력값 중
수정 세금계산서는 invoiceType에서 typeCode를 M로 명시하며
수정 계산서는 invoiceType에서 typeCode를 N로 명시합니다.
국세청에서는 수정세금계산서 작성을 위한 수정 사유를 6가지로 구분합니다.
\n수정세금계산서 발행 시, 수정 사유와 원본 세금계산서 당초 승인번호를 반드시 부여해야 합니다.
\namendment 내부에서 originalIssueId에 수정세금계산서를 발행할 원본 세금계산서의 당초 승인번호를 입력하고
modifyType에 수정 사유 코드를 기입합니다.
\n\n수정 사유에 따라 세금계산서 발행 장수가 다름에 주의하세요.
\n
공급가액 변동 : 02
\n환입 : 03
\n계약의 해제 : 04
\n착오에 의한 이중 발급 : 06
\n기재사항 착오변동 : 01
\n내국 신용장 사후 개설 : 05
\n\n\n발행한 금액 만큼 부(-)의 세금계산서를 발행하고, 정(+)의 세금계산서를 영세율로 발행합니다.
\n
수정 세금계산서 작성을 위해 입력하는 Body는 다음과 같이 구성됩니다. tempFileIds와 officeFileIds에 입력된 파일은 정과 부의 세금계산서 양쪽에 첨부됩니다.
\n{\n \"data\": {\n \"amendment\":{}, //수정세금계산서 정보\n \"negative\": {}, //부(-)의 세금계산서 생성 정보\n \"positive\" : {}, //정(+)의 세금계산서 생성 정보\n \"tempFileIds\" : [], // 첨부할 임시 파일 id 목록\n \"officeFileIds\" : [] // 첨부할 공용 파일 id 목록\n }\n}\n\n세금계산서 생성은 크게 다음과 같은 형태의 스키마로 구성됩니다
\n{\n \"data\": {\n \"information\": {}, // 세금계산서 정보 객체\n \"invoiceType\": {}, // 세금계산서 타입 객체\n \"invoicer\" : {}, // 세금계산서 공급자 정보 객체\n \"invoicee\" : {}, // 세금계산서 공급받는자 정보 객체\n \"items\" : [\n {} // 세금계산서 항목 객체\n ],\n \"tempFileIds\" : [], // 첨부할 임시 파일 id 목록\n \"officeFileIds\" : [] // 첨부할 공용 파일 id 목록\n }\n}\n\n공급자의 경우, 하이웍스 오피스에 등록된 사업자 번호를 입력하면 등록된 사업자 정보로 API에서 자동으로 맵핑하여 작성합니다.
\n{\n \"data\": {\n \"information\": {}, // 세금계산서 정보 객체*\n \"invoiceType\": {}, // 세금계산서 타입 객체*\n \"invoicer\" : \"123-45-12345\", // 하이웍스에 등록된 사업자 번호*\n \"invoicee\" : {}, // 세금계산서 공급받는자 정보 객체*\n \"items\" : [\n {} // 세금계산서 항목 객체*\n ],\n \"tempFileIds\" : [], // 첨부할 임시 파일 id 목록\n \"officeFileIds\" : [] // 첨부할 공용 파일 id 목록\n }\n}\n\n\n\n공급자 정보 자동 맵핑을 사용하시는경우,
\n\\d{3}-\\d{2}-\\d{5}형식의 구조를 지켜주셔야 합니다.
Content-Type은 application/json 으로 명시되어야 합니다.
Body에 들어가는 모든 네이밍 항목은 camelCase를 사용하고 있습니다.
\ntypeCode는 A,B,D 중 하나로 지정해야 합니다.
A : 세금계산서
\nB : 계산서
\nD : 거래명세서
\ntaxType은 과세인 경우 \"A\", 영세인 경우 \"B\"로 지정해야 합니다.
purposeType은 청구인 경우 \"C\", 영수인 경우 \"R\"로 지정해야 합니다.
transactionType은 매출 타입만 작성이 가능하며 \"S\"로 지정해야 합니다.
현재 매입세금계산서는 지원되지 않습니다.
tempFileIds은 POST /v4/temp-files로 첨부한 임시 파일의 id 목록을 입력합니다. id가 입력된 파일 전체가 작성한 문서에 첨부됩니다. 첨부 대상이 없는 경우 생략 가능합니다.
\nofficeFileIds은 GET /v4/office-files에서 조회한 공용 파일 중 첨부할 파일의 id 목록을 입력합니다. 첨부 대상이 없는 경우 생략 가능합니다.
\n가비아 리셀러 이신 경우, 교부 받으신 리셀러 코드를 HTTP 헤더에 X-Reseller-Code 로 기입합니다.
(필수)생성하신 office api token 정보를 입력합니다
\n","key":"Office-Authorization","type":"text","value":""},{"description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","key":"Bill-Access-Authorization","type":"text","value":""}],"url":"https://bill-api.hiworks.com/v4/invoices/{{문서번호}}","description":"{{문서번호}} 로 명시된 부분에 하이웍스에 세금계산서를 작성 할 시 수신하는 문서번호를 입력합니다.
세금계산서 조회 결과에 대한 스키마는 다음과 같이 구성됩니다.
\n{\n \"data\": {\n \"information\": {},\n \"invoiceType\": {},\n \"invoicee\": {},\n \"invoicer\": {},\n \"items\": [\n {}\n ],\n \"amendment\": {},\n \"mail\": {},\n \"status\": {},\n \"linkedDocument\": {},\n \"files\": []\n },\n \"meta\": {}\n}\n\n기작성된 세금계산서 수정 기능은 현재 정합성 유지를 위해 정책상 허용되지 않습니다.
\n발급되지 않은 문서의 수정이 필요하신 경우, 문서 삭제 후 재 작성해주시기 바랍니다.
\n","_postman_id":"12a316e2-6550-4141-8c95-72b446a73b61"},{"name":"세금계산서 삭제","item":[{"name":"세금계산서, 계산서, 거래명세서 삭제","id":"616c9bd9-7494-4b97-8fcd-258d489f5b98","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Office-Authorization","value":"","type":"text","description":"(필수)생성하신 office api token 정보를 입력합니다
\n"},{"key":"Bill-Access-Authorization","value":"","type":"text","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n"}],"url":"https://bill-api.hiworks.com/v4/invoices/{{문서번호}}","description":"{{문서번호}} 로 명시된 부분에 하이웍스에 세금계산서를 작성 할 시 수신하는 문서번호를 입력합니다.
\n국세청으로 발행 중, 발행 된 문서는 삭제가 불가능합니다.
\n","urlObject":{"protocol":"https","path":["v4","invoices","{{문서번호}}"],"host":["bill-api","hiworks","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"616c9bd9-7494-4b97-8fcd-258d489f5b98"}],"id":"4dcf50cd-d553-4099-ab57-c0b791108f14","_postman_id":"4dcf50cd-d553-4099-ab57-c0b791108f14","description":""},{"name":"Data Type","item":[{"name":"세금계산서 생성, 조회 공용","item":[{"name":"information","id":"ef0eb323-d1ea-4fe5-9a2d-b95f91a30256","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DATA","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"","description":"계산서, 세금계산서의 일반 정보 객체입니다.
\n필수 값만 입력되는 경우
\n{\n \"information\": {\n \"issueDate\": \"2020-04-23\",\n \"totalSupplyPrice\": \"200\",\n \"totalTax\": \"20\"\n }\n}\n전체 값을 입력하는 경우
\n{\n \"information\": {\n \"issueDate\": \"2020-04-23\",\n \"memo\": \"메모 입니다\",\n \"bookNo\": \"-\",\n \"serial\": \"124-123\",\n \"description\": \"remark\",\n \"cash\": \"100\",\n \"check\": \"200\",\n \"draft\": \"300\",\n \"uncollected\": \"400\",\n \"totalSupplyPrice\": \"200\",\n \"totalTax\": \"20\"\n }\n}\n0000-00-00 구조를 지켜주셔야 합니다.현금, 어음, 수표, 외상 미수금 등 결제 수단이 입력되는 경우 총 공급가액, 총 세액 값의 합이 결제수단의 합과 일치해야합니다.총 세액, 총 공급가액은 항목에 있는 세액, 공급가액의 합계액과 일치해야합니다계산서, 세금계산서 타입
\n{\n \"invoiceType\": {\n \"typeCode\": \"A\",\n \"transactionType\": \"S\",\n \"purposeType\": \"C\",\n \"taxType\": \"A\"\n }\n}\ntypeCode 입력시 세금계산서는 A, 계산서는 B, 거래명세서는 D를 입력합니다.A, B 로 입력합니다. 조회 시 수정 세금계산서, 계산서는 M, N 타입으로 조회됩니다.typeCode 를 B로, taxType은 B가 되어야합니다(면세)typeCode 를 A로 , taxType은 B로 지정되어야합니다.하이웍스에 등록된 사업자 번호를 입력합니다.
\n{\n \"invoicer\": {\n \"companyNumber\": \"214-86-39239\",\n \"companyName\": \"(주) 가비아\",\n \"ceoName\": \"김홍국\",\n \"primaryContact\": {\n \"name\": \"gabia\",\n \"email\": \"noreply@gabia.com\",\n }\n }\n}\n{\n \"invoicer\": {\n \"companyNumber\": \"214-86-39239\",\n \"taxNumber\": \"\",\n \"companyName\": \"(주) 가비아\",\n \"companyAddress\": \"경기도 성남시 분당구 대왕판교로 660(삼평동, 유스페이스1, B동 401호, 501호)\",\n \"ceoName\": \"김홍국\",\n \"bizType\": \"서비스, 도매 및 소매업, 소매, 서비스\",\n \"bizClassification\": \"소프트웨어 개발업\",\n \"primaryContact\": {\n \"name\": \"gabia\",\n \"email\": \"noreply@gabia.com\",\n \"cell\": \"010-0000-0000\",\n \"phone\": \"02-0000-0000\"\n }\n }\n}\nInvoicer 항목에 사업자 번호를 입력하시는 경우 하이웍스 오피스에 등록된 사업자 정보로 자동으로 맵핑합니다.Invoicer 항목에 해당 객체를 지정하시는 경우, API로 전달하신 사업자 등록 번호가 하이웍스 오피스에 등록된 사업자 번호와 동일해야합니다.공급받는자 정보
\n{\n \"invoicee\": {\n \"companyNumber\": \"214-86-39239\",\n \"companyName\": \"가비아\",\n \"ceoName\": \"김가비아\",\n \"partyTypeCode\" : \"01\",\n \"primaryContact\": {\n \"name\": \"공급받는자1\",\n \"email\": \"noreaply@gabia.com\",\n }\n }\n}\n{\n \"invoicee\": {\n \"companyNumber\": \"214-86-39239\",\n \"taxNumber\": \"\",\n \"companyName\": \"가비아\",\n \"companyAddress\": \"경기도 성남시 분당구 대왕판교로 660\",\n \"ceoName\": \"김가비아\",\n \"bizType\": \"전산\",\n \"bizClassification\": \"전산\",\n \"partyTypeCode\" : \"01\",\n \"primaryContact\": {\n \"name\": \"공급받는자1\",\n \"email\": \"noreaply@gabia.com\",\n \"cell\": \"010-0000-0000\",\n \"phone\": \"02-000-0000\"\n },\n \"secondaryContact\": {\n \"name\": \"공급받는자2 \",\n \"email\": \"noreply@gabia.com\",\n \"cell\": \"010-0000-0002\",\n \"phone\": \"02-0000-0002\"\n }\n }\n}\npartyTypeCode 입력 값에 따라 companyNumber에 기입하신 사업자 번호를 체크합니다.
companyNumber 에 사업자 등록번호를 입력합니다companyNumber 에 개인 주민번호 13자리를 입력합니다 companyNumber 에 9999999999999 (숫자 9 13자리)를 입력한 후 information 의 description 항목에 여권번호 또는 외국인번호를 입력합니다.공급받는자 제 2연락처 (secondaryContact)의 경우, 비필수 항목이지만 null, undefined가 아닌 내부 객체 선언이 있다면 입력 하시려고 하던 값의 누락으로 판단하여 검증 에러가 발생합니다.
연락처 정보
\n{\n \"name\": \"담당자\",\n \"email\": \"noreaply@gabia.com\",\n}\n{\n \"name\": \"담당자\",\n \"email\": \"noreaply@gabia.com\",\n \"cell\": \"010-0000-0000\",\n \"phone\": \"02-000-0000\"\n}\n항목 정보
\n{\n \"items\": [\n {\n \"month\": \"01\",\n \"day\": \"01\",\n \"supplyPrice\": \"100\",\n \"tax\": \"10\"\n }\n ]\n}\n{\n \"items\": [\n {\n \"month\": \"01\",\n \"day\": \"01\",\n \"subject\": \"항목이름\",\n \"unit\": \"EA\",\n \"quantity\": \"1\",\n \"unitPrice\": \"100\",\n \"supplyPrice\": \"100\",\n \"tax\": \"10\",\n \"description\": \"항목 비고란\"\n }\n ]\n}\n공급가액, 세액의 합은 information 의 총 공급가액, 총 세액과 일치해야합니다.월, 일 은 information의 작성일자 이후로 기입 될 수 없습니다. (선발행 오류)수정세금계산서 정보
\n{\n \"amendment\": {\n \"originalIssueId\": \"\",\n \"modifyType\": \"\"\n }\n}\n국세청에서는 수정세금계산서 작성을 위한 수정 사유를 6가지로 구분합니다.\n수정세금계산서 발행 시, 수정 사유와 원본 세금계산서 당초 승인번호를 반드시 부여해야 합니다.
\n세금계산서 발급전 승인요청, 발급 안내 메일에 대한 정보입니다.
\n{\n \"mails\": {\n \"readStatus\": \"C\",\n \"sendDate\": \"\",\n \"sendResultCode\": \"0\",\n \"sendResultMessage\": \"\"\n }\n}\n{\n \"status\": {\n \"approvalStatus\": \"W\",\n \"declareStatus\": \"0\",\n \"declareStatusCode\": \"\",\n \"issueId\": \"\"\n }\n}\n연결 문서정보
\n{\n \"status\": {\n \"amendmentOriginal\": \"W\",\n \"statementPair\": \"0\",\n }\n}\n세금계산서 첨부 파일에 대한 정보입니다.
\n{\n \"files\": [\n {\n \"id\": 1,\n \"type\": \"DOCUMENT\",\n \"name\": \"첨부파일.xlsx\",\n \"size\": 10000\n }\n ]\n}\n\n세금계산서 작성에는 사용되지 않으며, 조회 시 사용되는 객체들에 대한 설명입니다
\n","_postman_id":"dda830e2-53aa-4311-ab85-dd1d0d690fe9"}],"id":"6ceb3d79-effe-4e00-bc3a-658ff0b0ff80","description":"세금계산서 생성, 조회에 사용되는 데이터 타입입니다
\n","_postman_id":"6ceb3d79-effe-4e00-bc3a-658ff0b0ff80"}],"id":"984be7cc-8650-4360-a5a3-2e3748b0d14c","description":"전자세금계산서 API를 이용하기 위해서는 인증이 필요하며, Token(a.k.a API KEY)을 통해 인증을 수행합니다.
\n인증을 위해 필요한 Token은 오피스(OFFICE_TOKEN)와 전자세금계산서 사용자(BILL_ACCESS_TOKEN) Key가 필요합니다.
OFFICE_TOKEN: 오피스>오피스관리>API 관리에서 토큰 생성이 가능하며, 생성 시 반드시 전자세금계산서를 설정해야 정상적으로 사용할 수 있습니다. [오피스토큰 생성하기 매뉴얼 바로가기]
\nBILL_ACCESS_TOKEN: 오피스>전자세금계산서>API 연동에서 확인할 수 있습니다.
\nOFFICE_URL: 전자세금계산서 API 호출을 위한 주소로 https://bill-api.hiworks.com 을 입력해야 정상적으로 사용할 수 있습니다.
\nJSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","type":"text"},{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다
\n","type":"text"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","type":"text"}],"url":"https://bill-api.hiworks.com/v4/check/{{사업자번호}}","description":"휴폐업 조회시 사업자 번호는 10자리 숫자만 허용합니다.\n하이픈('-')이 포함되지 않도록 주의하시기 바랍니다.
\nex) 1234512345
다음과 같은 예시는 허용하지 않습니다.
\nex) 123-45-12345
반환 값에는 해당 사업자의 휴폐업 상태를 포함한 추가 정보가 반환됩니다.
\n\n\n반환 예시
\n
{\n \"data\": {\n \"idn\": \"1234512345\", // 사업자 번호\n \"status\": \"계속사업자\", // 사업자 상태\n \"statusCode\": \"01\", // 사업자 상태 코드\n \"taxType\": \"부가가치세 일반과세자\", // 사업자 과세 유형\n \"taxTypeCode\": \"01\", // 사업자 과세 유형 코드\n \"endDate\": \"\", // 폐업일\n \"utcc\": \"N\", // 단위 과세 전환 폐업 여부\n \"taxTypeChangeDate\": \"\", // 최근 과세 유형 전환 일자\n \"invoiceApplyDate\": \"\" // 세금계산서 적용 일자\n },\n \"meta\": {}\n}\n세금계산서 발급 시, 휴폐업 여부를 미리 검증할 수 있어 휴폐업 사실 미통보로 인한 수정 발행과 같은 불필요한 업무를 간소화할 수 있습니다.
\n","_postman_id":"eaf90117-d1fe-4db1-b870-33fee52ada5b"},{"name":"첨부 파일","item":[{"name":"공용 첨부 파일 조회","id":"e9a3e5ef-5152-444a-aa10-e0b70bac28b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다
\n"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n"}],"url":"https://bill-api.hiworks.com/v4/office-files","description":"오피스 공용으로 사용하는 첨부 파일 목록을 조회합니다. isFileUsed = \"Y\"인 파일의 id를 문서 작성 시 officeFileIds 필드에 입력하여 첨부 가능합니다.
\n","urlObject":{"protocol":"https","path":["v4","office-files"],"host":["bill-api","hiworks","com"],"query":[],"variable":[]}},"response":[{"id":"aa0e5049-3be2-4a96-a005-38eaa3665ac8","name":"공용 첨부 파일 조회","originalRequest":{"method":"GET","header":[{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다"}],"url":"https://bill-api.hiworks.com/v4/office-files"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"id\": 1,\r\n \"fileName\": \"통장사본.gif\",\r\n \"fileSize\": 1234,\r\n \"isFileUsed\": \"Y\"\r\n },\r\n {\r\n \"id\": 2,\r\n \"fileName\": \"사업자등록증.gif\",\r\n \"fileSize\": 5678,\r\n \"isFileUsed\": \"N\"\r\n }\r\n ]\r\n}"}],"_postman_id":"e9a3e5ef-5152-444a-aa10-e0b70bac28b3"},{"name":"임시 첨부 파일 생성","id":"dd9af953-a729-428a-ada1-f03a195ea6a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다
\n"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7a0863d0-08b9-4302-a15a-78e395b561d9","value":null}]},"url":"https://bill-api.hiworks.com/v4/temp-files","description":"클라이언트의 파일을 서버로 임시 업로드합니다(multipart/form-data). 반환된 tempFileId 값을 문서 작성 시 tempFileIds 필드에 추가하여 첨부할 수 있습니다.
\n","urlObject":{"protocol":"https","path":["v4","temp-files"],"host":["bill-api","hiworks","com"],"query":[],"variable":[]}},"response":[{"id":"4d886e4c-c84b-48d9-b677-07bb9e655103","name":"임시 첨부 파일 생성","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"7934d2eb-5a07-4738-bd37-03b04d4708b3","src":"/D:/hiworks.svg"}]},"url":"https://bill-api.hiworks.com/v4/temp-files"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"tempFileId\": 1234\r\n }\r\n}"}],"_postman_id":"dd9af953-a729-428a-ada1-f03a195ea6a8"},{"name":"첨부 파일 다운로드","id":"3f3c66c1-ef76-4166-a060-2e1fefc4f45d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다
\n"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n"}],"url":"https://bill-api.hiworks.com/v4/invoices/{{문서번호}}/attached-files/{{파일 id}}","description":"{{문서번호}} 로 명시된 부분에 문서번호, {{파일 id}}로 명시된 부분에 문서 조회 시 취득 가능한 첨부 파일 id(files.*.id)를 입력하여 파일을 다운로드합니다.
\n","urlObject":{"protocol":"https","path":["v4","invoices","{{문서번호}}","attached-files","{{파일 id}}"],"host":["bill-api","hiworks","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"3f3c66c1-ef76-4166-a060-2e1fefc4f45d"}],"id":"2d273f44-ce31-4846-8f1d-160212051df3","_postman_id":"2d273f44-ce31-4846-8f1d-160212051df3","description":""},{"name":"사업자등록정보 진위 검증","item":[{"name":"사업자등록정보 진위 검증","id":"df475496-5406-4644-b947-7ee5447355b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","description":"JSON 타입을 명시하지 않는 경우 에러가 발생합니다
\n","type":"text"},{"key":"Office-Authorization","value":"","description":"(필수)생성하신 office api token 정보를 입력합니다
\n","type":"text"},{"key":"Bill-Access-Authorization","value":"","description":"(필수)세금계산서 페이지에서 생성하신 사용자의 세금계산서 api token 정보를 입력합니다
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"data\": {\r\n \"idn\": \"1234512345\",\r\n \"startDate\": \"20210101\",\r\n \"representative\": \"가비아\",\r\n \"representative2\": \"\",\r\n \"companyName\": \"\",\r\n \"corporationNo\": \"\",\r\n \"sector\": \"\",\r\n \"type\": \"\"\r\n }\r\n}"},"url":"https://bill-api.hiworks.com/v4/validate","description":"사업자 번호, 개업일자, 대표자 명은 필수값입니다. 해당 값이 누락될 경우 정상적인 진위 검증이 실행되지 않습니다.
\n필수값을 제외한 모든 값은 비 필수값입니다. 비 필수값은 기재해도 무방하나 올바르게 기재하지 않을 경우 정상적인 진위 검증이 진행되지 않습니다.
\n비 필수값을 입력하지 않을 경우 필드를 비우거나 빈값으로 처리하여 요청합니다.
\n거래를 위해 수신한 사업자등록증의 사업자등록정보의 진위 검증을 통해 해당 사업자의 유효성을 판별하고 사업자의 현재 상태를 조회합니다.
\n","_postman_id":"06089797-c889-4329-a9ef-3faea9d4093e"},{"name":"간편 서명","item":[],"id":"d7f5d1f7-714f-45e0-8aaf-7501e79ffa11","description":"API에서 문서 작성 후 바로 국세청 전송이 가능한 간편 서명 기능이 도입됩니다.
\n간편 서명은 공인인증서를 등록하면 자동으로 서명 인증 절차가 진행되어 세금계산서 발급 및 국세청 전송이 곧바로 이뤄집니다.
\n간편 서명은 하이웍스 전자세금계산서에 공인인증서 인증 정보를 등록한 후 이용할 수 있습니다.
\n사용 가능한 인증서는 가비아 전용 공인인증서만 등록, 이용할 수 있습니다.
\n(세금)계산서 생성 시, 간편 서명에 필요한 value값 'Y'(대문자만 사용)가 포함되어야 간편 서명이 이루어집니다.
\n{\n \"data\": {\n \"easySign\": \"Y\",\n \"information\" : {...},\n ...\n},\n수정 (세금)계산서 생성 시, data 아래 positive, negative와 같은 단계에서 간편 서명 value값이 존재해야합니다.
\n{\n \"data\": {\n \"easySign\":\"Y\",\n \"amendment\" : {...},\n \"positive\" : {...},\n \"negative\" : {...}\n }\n}\n전자세금계산서 API 리셀러는 API를 통해 발급하는 전자세금계산서 유료 발급 건수에 대해 일정 수익을 돌려드리는 제도입니다.
\n실적 조회와 수익 정산은 [리셀러 전용 관리툴]에서 편리하게 확인할 수 있습니다.
\n전자세금계산서 정산 대상은 API 문서 생성 시, Header 부분에 아래 내용이 포함되어야 정상적으로 정산 대상으로 규정합니다.
\n--header 'X-Reseller-Code: {{리셀러ID}}'
\n직위를 추가합니다.
\n직위를 수정합니다.
\n직위를 삭제합니다.
\n직위 등급
\n","type":"text/plain"},"key":"level","value":""},{"description":{"content":"직위 외부키
\n","type":"text/plain"},"key":"extKey","value":null}],"variable":[]}},"response":[],"_postman_id":"7a081893-65a0-4a1f-a46f-0581e942eaf7"}],"id":"084f3b97-62ab-4853-8991-cf6b3e6668dd","description":"직위은 사원, 대리, 차장, 과장 등으로 분류되며 직무의 종류, 난이도, 권한과 역할, 책임의 정도에 따라 분류됩니다. 하이웍스 오피스에서는 등급별로 여러 개의 직위를 관리할 수 있으며(최대 30개), 직위 API를 이용해 고객 인트라넷의 직위 정보를 하이웍스 오피스와 연동할 수 있습니다.
\n","event":[{"listen":"prerequest","script":{"id":"77a67a4a-c611-418f-a847-7a224779dec2","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f8fc4ed8-c37b-4ec6-a5d1-90bd6cf92ea2","type":"text/javascript","exec":[""]}}],"_postman_id":"084f3b97-62ab-4853-8991-cf6b3e6668dd"},{"name":"직무","item":[{"name":"직무 추가","id":"c883f507-d8e1-43e6-a50e-0b97ee107ffe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{linkAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"duty_list\":[\n {\n \"name\":\"직무명1\",\n \"extKey\":\"직무 외부키1\",\n \"order\":\"정렬1\"\n },\n {\n \"name\":\"직무명2\",\n \"extKey\":\"직무 외부키2\",\n \"order\":\"정렬2\"\n }\n ]\n}"},"url":"{{hiworks_api_url}}/office/org/duty","description":"직무를 추가합니다.
\n직무를 수정합니다.
\n직무를 삭제합니다.
\n직무를 조회합니다.
\n","urlObject":{"path":["office","org","duty"],"host":["{{hiworks_api_url}}"],"query":[{"description":{"content":"직무 외부키
\n","type":"text/plain"},"key":"extKey","value":null}],"variable":[]}},"response":[{"id":"01901867-bb1e-49f0-aa4d-d99d570ba7dc","name":"직무 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{linkAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{url}}.hiworks.com/office/org/duty?extKey","host":["{{url}}","hiworks","com"],"path":["office","org","duty"],"query":[{"key":"extKey","value":null,"description":"직무 외부키"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 06:57:36 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"411"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"data\": [\n {\n \"extKey\": \"수정할 직무 외부키2\",\n \"name\": \"수정할 직무명2\",\n \"order\": \"0\"\n },\n {\n \"extKey\": \"수정할 직무 외부키1\",\n \"name\": \"수정할 직무명1\",\n \"order\": \"1\"\n },\n {\n \"extKey\": \"수정할 직무 외부키3\",\n \"name\": \"수정할 직무명3\",\n \"order\": \"2\"\n }\n ]\n}"}],"_postman_id":"e51f9df6-bfc6-4e86-8475-fab9d6820187"}],"id":"a9744015-21e5-4501-9181-4e39052ed01d","description":"직무는 각 구성원이 직책이나 직업상에서 책임을 지고 담당한 업무입니다. 직무는 기획, 관리, 영업, 생산 등으로 분류됩니다. 직무 API를 이용해 고객 인트라넷의 직무 정보를 하이웍스 오피스와 연동할 수 있습니다.
\n","event":[{"listen":"prerequest","script":{"id":"d5bf8eeb-7d79-4f7b-807f-fa74c67d326e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c6df9ad4-4828-4965-b673-0fdafe0a83eb","type":"text/javascript","exec":[""]}}],"_postman_id":"a9744015-21e5-4501-9181-4e39052ed01d"},{"name":"조직","item":[{"name":"조직 추가","id":"5775ae45-85a6-4dfb-9919-11fa9eb2e150","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{linkAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"extKey\":\"조직 외부키1\",\n \"parentExtKey\":\"ext001\",\n \"name\":\"조직명1\"\n}"},"url":"{{hiworks_api_url}}/office/org/organization","description":"조직을 추가합니다.
\n조직을 수정합니다.
\n조직을 삭제합니다.
\n조직을 조회합니다.
\n조직 등급
\n","type":"text/plain"},"key":"level","value":null},{"description":{"content":"조직 외부키
\n","type":"text/plain"},"key":"extKey","value":null}],"variable":[]}},"response":[{"id":"29c9c09a-bd87-4b6b-a3c6-a9c1b450e5cb","name":"조직 조회","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{linkAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{url}}.hiworks.com/office/org/organization?level&extKey","host":["{{url}}","hiworks","com"],"path":["office","org","organization"],"query":[{"key":"level","value":null,"description":"조직 등급"},{"key":"extKey","value":null,"description":"조직 외부키"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 01 Apr 2019 07:01:23 GMT"},{"key":"Server","value":"Apache"},{"key":"Content-Length","value":"266"},{"key":"Keep-Alive","value":"timeout=2, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"SUC\",\n \"message\": \"\",\n \"data\": [\n {\n \"extKey\": \"ext001\",\n \"name\": \"api테스트\",\n \"regDate\": \"2018-09-27\"\n },\n {\n \"extKey\": \"ext002\",\n \"name\": \"api테스트2\",\n \"regDate\": \"2018-09-27\"\n },\n {\n \"extKey\": \"api_scope_test001\",\n \"name\": \"api_scope_test001\",\n \"regDate\": \"2018-10-10\"\n }\n ]\n}"}],"_postman_id":"e531398d-78cf-4725-94d8-49c96d7677ec"}],"id":"aceee59c-ba1e-4bac-a715-30b619f375e0","description":"조직은 부서, 팀, 실 등 목표 달성을 위한 협동 체계를 의미합니다. 조직 구조가 전문화되고 세분화되면서 조직도는 다양하고 복잡한 네트워크 형태를 갖추게 됩니다. 조직 API를 이용해 고객 인트라넷과 하이웍스 오피스를 연동함으로써 이중으로 작업하는 번거로움을 줄일 수 있습니다.
\n","event":[{"listen":"prerequest","script":{"id":"76515034-fb1d-4b7d-ae45-3ba2b0d03b9c","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7b091d72-3ca9-493f-bf38-4d274053039e","type":"text/javascript","exec":[""]}}],"_postman_id":"aceee59c-ba1e-4bac-a715-30b619f375e0"},{"name":"구성원","item":[{"name":"구성원 추가","id":"214672cc-77e2-4436-86af-3529332ec8b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{linkAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"user_list\" : [\n\t\t{\n\t\t\t\"user_id\" : \"user_id001\",\n\t\t\t\"user_name\" : \"이름\",\n\t\t\t\"user_pass\" : \"123qweasdzxc\",\n\t\t\t\"extKey\" : \"extkey001\",\n\t\t\t\"orgExtKey\" : \"\",\n\t\t\t\"positionExtKey\" : \"\",\n\t\t\t\"dutyExtKey\" : \"\",\n\t\t\t\"email\" : \"email@email.com\",\n\t\t\t\"phone\" : \"010-3333-3333\",\n\t\t\t\"cell\" : \"010-4444-4444\",\n\t\t\t\"company_num\" : \"사번\",\n\t\t\t\"birthday\" : \"1980-01-01\",\n\t\t\t\"birthday_type\" : \"M\",\n\t\t\t\"zip_code\" : \"01234\",\n\t\t\t\"address\" : \"성남시 분당구 판교동\",\n\t\t\t\"introduce\" : \"메모\"\n\t\t}\n\t]\n}"},"url":"{{hiworks_api_url}}/office/org/member","description":"구성원을 추가합니다.
\n구성원을 수정합니다.
\n구성원을 삭제합니다.
\n구성원을 조회합니다.
\n인트라넷의 구성원과 하이웍스에 추가된 기존 구성원을 연동합니다.
\n구성원 API를 이용해 고객 인트라넷에 있는 각 구성원의 정보를 하이웍스 오피스와 연동할 수 있습니다.
\n","event":[{"listen":"prerequest","script":{"id":"1a3ad2f9-943e-43d6-a89b-865fc8d51af6","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"477ad66f-fba3-4f74-be15-20ee82b0c441","type":"text/javascript","exec":[""]}}],"_postman_id":"3423f015-a979-4e4d-a079-44380c6c96e2"}],"id":"be571767-87dd-4a1a-9bf5-ae1ba6457f79","description":"직책/직급/조직/구성원 정보가 오피스와 동기화 됩니다. 조직개편, 인사 등 정보가 변경되었을 때에도 간편하게 업데이트할 수 있습니다. 단, 오피스 관리를 이용한 구성원 및 조직관리 기능은 이용할 수 없습니다.
\n","event":[{"listen":"prerequest","script":{"id":"5759e7cf-5de8-4d3b-aeab-8bf0b0f4674e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"668d1cc3-a050-4a69-8915-5704ee45cd09","type":"text/javascript","exec":[""]}}],"_postman_id":"be571767-87dd-4a1a-9bf5-ae1ba6457f79"},{"name":"Single Sign On (SSO) 연동","item":[{"name":"SSO 외부로 연동","item":[{"name":"외부로 연동 토큰 조회","id":"f804d871-24c1-4369-b3e3-2da0126f8801","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://link-api.hiworks.com/v4/tokens/{{token}}","description":"Response
\n{\n \"data\": { \n \"user-no\" : \"사용자 고유 식별 번호 (UNIQUE)\",\n \"user-id\": \"사용자 계정 ID\",\n \"user-name\": \"사용자 이름\",\n \"employee-no\": \"사용자 사번\"\n }\n}\n\n하이웍스에 외부 애플리케이션을 연동하고 싶은 경우 사용됩니다.
\n계정 연동에 필요한 파라미터 중 하나인 임시키를 발급합니다.
\n","urlObject":{"path":["office","sso","validate","tmpkey"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"36dfab2f-0557-4fea-b489-de64d93d0cd1"},{"name":"로그인","id":"ca9f8eef-a867-4d49-b42f-9e876972e3d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{accountAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"partner_id\":\"고객사 아이디\",\n\t\"tmp_key\":\"임시키\",\n\t\"rd_url\":\"메뉴 URL\"\n}"},"url":"{{hiworks_api_url}}/office/sso/validate","urlObject":{"path":["office","sso","validate"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ca9f8eef-a867-4d49-b42f-9e876972e3d7"},{"name":"로그아웃","id":"4398f784-8e64-4344-9838-6fe7333df330","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{authorization_bearer}} {{accountAuth_token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"tmp_key\":\"임시키\",\n\t\"rd_url\":\"메뉴 URL\"\n}"},"url":"{{hiworks_api_url}}/office/sso/validate/logout","urlObject":{"path":["office","sso","validate","logout"],"host":["{{hiworks_api_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4398f784-8e64-4344-9838-6fe7333df330"}],"id":"336411b7-1378-4f6d-a440-99ed9c45f505","description":"애플리케이션 내에 하이웍스 서비스를 포함하고 싶은 경우 사용됩니다.
\nhttps://api.hiworks.com/office/sso/validate/main 오피스 메인
\nhttps://api.hiworks.com/office/sso/validate/mail 메일
\nhttps://api.hiworks.com/office/sso/validate/approval 전자결재
\nhttps://api.hiworks.com/office/sso/validate/ea (구)전자결재
\nhttps://api.hiworks.com/office/sso/validate/board 게시판
\nhttps://api.hiworks.com/office/sso/validate/shared 공용메일
\nhttps://api.hiworks.com/office/sso/validate/sms 메시징
\nhttps://api.hiworks.com/office/sso/validate/schedule 일정관리
\nhttps://api.hiworks.com/office/sso/validate/addr 주소록
\nhttps://api.hiworks.com/office/sso/validate/bill 전자세금계산서
\nhttps://api.hiworks.com/office/sso/validate/booking 예약
\n\n\n","event":[{"listen":"prerequest","script":{"id":"95e086de-fa72-48ae-b28a-2bd344cae75a","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"349b8338-eb5d-47fc-ac43-0daf54773e90","type":"text/javascript","exec":[""]}}],"_postman_id":"336411b7-1378-4f6d-a440-99ed9c45f505"}],"id":"102e1758-94a8-42da-bd23-f577df5af73a","event":[{"listen":"prerequest","script":{"id":"e8ba804c-08ed-44c9-a7d9-29d6c624ab52","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"1230b447-12c9-445e-a1d6-f52025cf96c0","type":"text/javascript","exec":[""]}}],"_postman_id":"102e1758-94a8-42da-bd23-f577df5af73a","description":""}],"event":[{"listen":"prerequest","script":{"id":"114b7d32-ed31-4924-8759-6cc2aaa25d59","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"fd6cf54d-4c45-4286-871d-9bf6c22088ee","type":"text/javascript","exec":[""]}}]}