해외 물류 플랫폼에서 들어오는 반품 주문을 사내 시스템이 자동으로 받도록 연동한 프로젝트입니다. [기존 상황] 글로벌 물류사 플랫폼에서 반품 주문이 발생해도 사내 시스템으로 자동 전달되는 경로가 없었습니다. 반품 처리가 지연되고 누락되는 건이 생기는 구조였습니다. [작업 내용] 반품 접수, 반품 취소, 반품 주소 조회 연동을 개발했습니다. 상대 플랫폼의 규격서를 해석해 요청 형식을 맞추고, 전자서명(digest) 검증으로 위변조를 차단했습니다. 운송장 번호를 기준으로 중복 주문을 걸러내 같은 건이 두 번 적재되지 않게 했습니다. [운영 안정성] 모든 요청과 응답을 이력으로 남기고, 로그를 일자별로 분리 저장했습니다. 문제가 생기면 어느 요청에서 무엇이 잘못됐는지 바로 추적할 수 있습니다. 연동은 한 번 만들고 끝나는 게 아니라 상대 시스템이 바뀔 때마다 원인을 찾아야 하는데, 그 시간을 줄이는 것이 목적이었습니다. [기술] Node.js, Express, MS SQL, Knex, Winston [이런 경우에 필요합니다] - 거래처나 플랫폼에서 주는 규격서는 있는데 어디서부터 손대야 할지 모를 때 - 기존 연동이 자꾸 끊기거나 장애 원인을 못 찾을 때 - 주문, 반품, 정산 데이터를 아직 수기로 옮기고 있을 때

반품 주문 연동 흐름 - 요청 수신, 전자서명 검증, 중복 차단, 주문 처리, 이력 기록으로 이어지는 과정입니다.