TeamUp이 10월 30일 공개한 API 변경기록에서 청구서와 보고서, 스토어 주문에 반올림 조정액과 고객 표시용 가격을 다루는 항목을 추가했다. 이번 변경은 가격 계산 결과와 고객이 보는 금액을 연동 시스템에서 구분해 처리할 수 있도록 하는 데 초점을 맞췄다.
반올림 조정 항목을 별도로 식별
청구서 조회와 개별 청구서 조회 응답에는 항목 유형으로 price_rounding이 추가됐다. 청구서 항목을 조회하는 일반·그룹 보고서에도 같은 유형이 들어간다. 개발자는 이 값을 통해 일반 상품이나 서비스 항목과 반올림 조정 항목을 구별할 수 있다. 수수료 계산 API와 일괄 계산 API의 응답에는 rounding_amount가 필수 항목으로 추가돼 계산에 적용된 조정액을 확인하도록 했다.
배송 완료 요청에는 새 필수값
스토어 주문에서는 고객에게 표시하는 가격을 나타내는 price_for_display가 주문 항목 조회·생성·수정 응답에 추가됐다. 특히 배송 완료를 확인하는 요청에는 이 항목을 필수로 보내야 하며, 성공 응답에도 필수로 포함된다. 단순히 조회 결과에 정보가 늘어난 부분과 요청을 보내는 프로그램을 점검해야 하는 부분이 함께 있다는 뜻이다.
주문 보고서와 내보내기에는 고객 표시용 주문 합계를 뜻하는 total_price_for_display를 열로 선택할 수 있게 했다. 주문 보고서 응답의 해당 값은 선택 항목으로 명시돼 있다. 따라서 모든 응답에 무조건 같은 필드가 나타난다고 가정하기보다, 호출 종류와 열 선택 여부에 맞춰 처리할 필요가 있다.
관리자 권한과 테스트 환경 확인
공식 FAQ는 TeamUp API의 기본 주소가 v2 경로를 사용한다고 설명한다. API 접근 자체에 추가 요금은 없으며 무료 체험 계정도 API 애플리케이션을 만들 수 있다. 다만 애플리케이션을 생성·관리하려면 해당 사업체의 슈퍼 관리자 권한이 필요하다. 별도 샌드박스는 제공하지 않고 무료 체험 계정을 테스트 사업체로 활용하는 방식이 안내돼 있다.
이번 변경기록에는 별도의 새 숫자 버전이나 국가별 배포 일정, 베타 표시가 없다. 10월 30일자로 공개된 v2 API 변경으로 구분하는 것이 정확하다. 배송 완료 요청을 사용하는 연동 개발자는 필수 요청값 추가를 우선 확인하고, 청구서와 보고서 처리 코드는 새 항목 유형을 받아들일 수 있는지 점검할 필요가 있다. 해당 업데이트에 대한 독립적인 고객 평가나 업계 반응은 이번 조사에서 확인하지 못했다.
){kind=small}
){kind=small}
){kind=small}
){kind=small}