회계freee와 다음 엔진의 합작 이야기

개시하다
여름제 기획에 참여한 기사다.
프리에이피에 관한 팁을 올려주세요!
이쪽 주제에 참가해.
회계freee가 뭐예요?
클라우드 컴퓨팅 소프트웨어freee
기업과 개인 사업주 금전 주위의 도구를 지원하다
기업의 가계 수지가 적은 존재
다음 엔진은 무엇입니까?
다음 엔진
인터넷 쇼핑몰 운영 배후 지원 도구
롯데와 아마존 등 대형 카트의 협업이 수월해진다.
주문, 입고, 재고 관리 가능
회계freeex 다음 엔진

다음 엔진을 통해 관리하는 구매정보, 주문정보를 회계freee에 보내면 회계freee에서 판매관리 등을 할 수 있다.
회계freee와 다음 엔진에 API가 존재합니다
다음 엔진에서 API를 통해 주문 정보 얻기 →freee API를 통해 회계에게 보내기
이것은 기본 절차다.
freeeAPI Tips
freee API 참조
기본적인 사용 방법과 절차는 정식 문서를 볼 때 매우 상세하게 쓰여 이해하기 쉽다.
freeAPI 자습서
이 페이지를 참고하여 프로그램을 등록하고 방문 영패를 발행하십시오.
방문 영패만 받으면 보통 끝점을 두드려 다양한 처리를 할 수 있다.

企業情報の取得
$ curl -i -X GET -H "Authorization:Bearer 発行されたアクセストークン" -H "Content-Type:application/json" 'https://api.freee.co.jp/api/1/companies'
取引一覧の取得
$ curl -i -X GET -H "Authorization:Bearer 発行されたアクセストークン" -H "Content-Type:application/json" 'https://api.freee.co.jp/api/1/deals?company_id=上で取得した企業ID'
account_item_id一覧
$ curl -i -X GET -H "Authorization:Bearer 発行されたアクセストークン" -H "Content-Type:application/json" 'https://api.freee.co.jp/api/1/account_items?company_id=上で取得した企業ID'
tax_code一覧
$ curl -i -X GET -H "Authorization:Bearer 発行されたアクセストークン" -H "Content-Type:application/json" 'https://api.freee.co.jp/api/1/taxes/codes'
取引情報のPOST
$ curl -i -X POST -H "Authorization:Bearer 発行されたアクセストークン" -H "Content-Type:application/json" 'https://api.freee.co.jp/api/1/deals' -d '{"company_id" : "上で取得した企業ID", "type" : "expense", "issue_date" : "2020-06-25", "details" : [{"amount" : "777", "account_item_id" : "169898529", "tax_code" : "2"}]}'

내가 이 개발을 진행할 때 API의 정비를 따라잡지 못해서 커널이 많이 했는데 지금은 참고 페이지에서'Try it out'부터 실행할 수 있어서 매우 편리해졌다.
참고로 이 문서의 페이지 업데이트 빈도가 상당히 높아서 볼 때마다 w를 업데이트합니다
학습회도 빈번하게 열리는 것 같아서 프리 씨가 API에 힘을 쏟은 것 같아요.
액세스 토큰 업데이트
freee API의 방문 영패의 유효기간은 1일입니다.
하루가 지나면 사용할 수 없기 때문에 리셋 영패로 업데이트합니다.
그나저나 리셋 영패는 유효기간이 없는 것 같습니다.

アクセストークンの有効期限(1日)が切れた際の再発行
$ curl -i -X POST -H "Content-Type:application/x-www-form-urlencoded" -d "grant_type=refresh_token" -d "client_id=自分のclient_id" -d "client_secret=自分のclient_secret" -d "refresh_token=自分のリフレッシュトークン" 'https://api.freee.co.jp/oauth/token'
再発行されたアクセストークン/リフレッシュトークン
{"access_token":"新しいアクセストークン","token_type":"bearer","expires_in":86400,"refresh_token":"新しいリフレッシュトークン","scope":"read write"}

이번 협업의 뒷면에는 추후 일괄 처리가 있어 방문 토큰이 끊기지 않도록 매일 리셋한다.
나 여기 되게 신경 쓰여.
create_deal: 거래 제작 단점
details는 40개만 수용할 수 있습니다.
또한details의 바깥쪽 issue날짜가 있어 거래일 당일 최대 40건까지 동시 제작이 가능하다.
따라서 예를 들어 1월 1일, 2일, 3일의 3거래는 API를 3회 호출해야 한다.
(이 근처도 한 번의 호출로 만들 수 있는 종점이 되겠지)
이를 실현하기 위해 뒷면에 주문 정보를 받아 다음과 같은 느낌을 준다.
· 거래일별 통계
· 같은 날 거래가 40건 이상일 경우 40건씩 분할

     * 例:
     * 2020年1月30日:85件、2020年1月31日:6件の場合
     * array(
     *      '2020-01-30' => array(
     *                         array[40],
     *                         array[40],
     *                         array[5]
     *                      ),
     *      '2020-01-31' => array(
     *                         array[6]
     *                      )
     * )
     * 計4回のAPIコールが必要

나는 많은 거래를 하는 것이 좀 불편하다고 생각한다.
get_account_items: 과목 일람 취득 단점
또 회계 과목과 관련해서는 모두 취득해야 선택할 수 있다.
많은 회계 과목의 선택이 있는데 회계 Free에서'사용/미사용'을 선택할 수 있고 화면에서'사용'옵션만 선택할 수 있다.
API에서도'사용'만 따고 싶은 회계과목 수요가 있는데 아쉽게도 그건 안 될 것 같다.
이 결승점을 선택할 수 있다면 사용하는 회계 과목만 얻을 수 있기 때문에 더욱 좋아질 것이다.
API를 통해 거래를 조작할 수 없는 등록 방법
프리의 화면에는'등록하는 방법'이라는 항목이 있지만 API에서는 변경할 수 없는 항목이다.
'다음 엔진에서 등록된'으로 설정하려고 했는데 아쉽네요.
다음 엔진 API Tips
이 보도는 프리의 이야기를 위주로 하기 때문에 다음 엔진에서는 사랑을 끊을 것이다.
다음은 참조입니다.
다음 엔진 API 사용 기반(개발 환경 구축 편)
다음 엔진 API 사용 방법(설치 편 적용)
끝말
회계freee와 다음 엔진은 모두 매우 편리한 도구입니다. 꼭 사용하세요!