사내 시스템끼리 붙이기 — API 연동 자동화는 어디까지 되나

같은 숫자를 하루에 두 번씩 손으로 입력하는 회사가 생각보다 많다. 현장에서 생산 실적을 찍고, 같은 값을 사무실에서 ERP에 다시 넣는다. 두 시스템이 서로 말을 못 하니 사람이 중간에 앉아 통역 노릇을 한다.

여기서 연동 얘기가 나온다.

시스템 연동 개발이 되느냐 마느냐는 기술이 아니라 세 가지 조건에서 갈린다. 상대 시스템에 데이터를 꺼낼 통로가 있는지, 그 통로를 벤더가 열어 주는지, 두 쪽 데이터가 같은 대상을 같은 이름으로 부르는지다.

무엇부터 붙이는 게 맞나

연동은 전부 붙이느냐 아예 손대지 않느냐의 양자택일이 아니다.

데이터 한 줄기를 한 방향으로 흘려보내는 일부터 시작하는 게 보통이다. 생산 실적을 ERP로 올리는 일과, ERP의 단가를 현장 화면에서 읽어 오는 일은 난이도가 다르다.

읽기만 하는 연동은 위험이 작지만, 쓰기가 들어가는 순간 승인 절차와 되돌리기 규칙이 따라붙는다.

발주 전에 이 한 줄을 종이에 적어 보자. 어떤 데이터가 어디서 어디로, 하루에 몇 번이나 흘러야 하는가.

상대 시스템에 통로가 아예 없으면

의외로 자주 나온다.

십 년 넘게 쓴 관리 프로그램은 화면만 있고 바깥으로 내보내는 통로가 없는 경우가 있다. 그래도 방법이 없지는 않다.

다만 이런 우회 통로는 정식 길이 아니라 임시로 놓은 다리에 가깝다. 화면 자동화는 상대 쪽 화면이 한 번 바뀌면 그날로 동작을 멈춘다. 처음 만드는 수고에 비해, 이후 유지하는 수고가 훨씬 크게 든다.

표에서 맨 아래로 내려갈수록 구축은 빨라지고 운영은 무거워진다.

벤더가 열어 주지 않으면

통로가 멀쩡히 있는데도 계약 때문에 잠겨 있는 경우가 있다. 연동 기능이 상위 라이선스에만 붙어 있거나, 유지보수 계약을 유지해야 열어 주는 조건이 흔하다.

여기서 기간이 밀린다.

벤더 문의는 개발사가 아니라 발주사가 직접 넣는 편이 훨씬 빠르다. 벤더 입장에서 고객의 요청과 외부 업체의 요청은 무게가 다르다.

견적을 받기 전에 연동 가능 여부와 조건이 적힌 회신 한 통을 확보해 두자.

사람 손으로 들어간 데이터는 그대로 붙나

연동 프로젝트에서 실제 작업량이 가장 많이 숨어 있는 자리다. 두 시스템이 같은 거래처를 서로 다른 이름으로 부르는 일은 아주 흔하다. 한쪽은 정식 상호로 적고 다른 쪽은 담당자가 줄여 쓴 별칭이 남아 있다. 품번에 공백과 하이픈이 섞이고, 단위가 어디는 킬로그램이고 어디는 개수다. 날짜 기준이 출고일인지 마감일인지도 시스템마다 제각각이다. 거래처가 합병되면서 옛 코드와 새 코드가 함께 남아 있는 경우도 있다. 사람이 엑셀로 관리해 온 항목일수록 이런 흔적이 더 많이 남아 있다. 이 상태에서 통로만 뚫어 놓으면 엉킨 숫자가 그대로 양쪽에 쌓인다. 기계는 의심하지 않는다.

그래서 연동 프로젝트의 절반은 매칭표를 만드는 일에 가깝다.

두 시스템의 코드를 짝지어 두고, 짝이 없는 건은 사람이 확인하도록 남긴다. 한 지자체 사업에서는 여러 부서에 흩어져 있던 지역 데이터를 하나의 지도 서비스로 묶었다. 이런 통합에서 시간을 잡아먹는 쪽은 화면이 아니라 기준을 맞추는 작업이다.

권한과 보안 승인은 언제 시작하나

승인부터 먼저 넣어야 한다.

연동 계정 발급, 방화벽 정책 변경, 망 분리 구간 통과, 사내 보안 검토. 이 넷은 결재 라인을 타기 때문에 개발사가 아무리 빨라도 앞당겨지지 않는다. 착수일에 나란히 신청해 두면 개발이 끝날 즈음 얼추 맞아떨어진다.

사내 규정상 외부 접근이 아예 막혀 있다면 연동 방식 자체가 달라진다. 데이터를 내보내는 쪽을 사내에 두고, 바깥과는 정해진 창구로만 주고받는 구조로 설계한다.

설계 전에 정할 문제다.

운영 중에 끊기면 어떻게 되나

연동은 납품서에 도장을 찍는 순간 끝나는 그런 물건이 아니다. 상대 시스템은 정기 점검을 하고 패치를 받고 가끔은 재부팅도 한다. 그 몇 시간 동안 흘러야 할 데이터는 중간에서 그냥 갈 곳을 잃는다.

계약 전에 세 가지를 물어보자.

실패하면 몇 번까지 다시 시도하고, 그래도 안 되면 누구에게 알리는가. 그사이 밀린 건은 시스템이 복구된 뒤에 자동으로 다시 넘어가는가. 이 셋이 빠진 연동은 반년쯤 지나면 아무도 모르게 조용히 죽어 있다.

GrowSpace는 상담부터 설계와 구축, 운영까지 한 팀이 이어 맡는다. 현장의 사람·장비 위치를 실시간 데이터로 만들어 쓰던 시스템에 넣는 작업도 같은 방식으로 했다. 범위는 맞춤 운영 시스템에 정리해 뒀다.

→ 함께 읽기: MES 구축 비용과 기간

자주 묻는 질문

우리 시스템에 API가 있는지 어떻게 확인하나요? 벤더에 한 줄로 물으면 된다. “외부 시스템 연동용 인터페이스를 제공하는지, 조건이 어떻게 되는지” 정도면 답이 온다. 담당 영업이 아니라 기술 지원 창구로 보내는 편이 답이 정확하다.

그룹웨어나 메신저 같은 클라우드 서비스도 붙나요? 대체로 공식 통로가 열려 있어서 사내 구형 시스템에 비해 수월하다. 관리자 승인과 사용 범위, 이 둘만 미리 확인해 두면 대개 문제없다.

연동을 붙이면 기존 시스템 속도가 느려지지는 않나요? 조회 주기와 시간대를 조절해 상대 시스템의 부담을 피한다. 실시간이 꼭 필요한 데이터와 하루 한 번이면 되는 데이터를 나누는 게 먼저다.

붙일 수 있는지부터 묻지 말고, 어떤 데이터가 어디로 흘러야 하는지부터 적어 보자. 그 한 줄만 정해지면 붙이는 방법은 대개 그다음에 따라 나온다.

→ 우리 현장 기준으로 구축 범위 상담받기