우리는 어떻게 Tango Gestión와 Interbanking을 통합하고 두 아르헨티나 기업에서 수동 조정을 없앨 수 있을까

발행: 7시간 전 (2026년 5월 9일 PM 12:17 GMT+9)

8 분 소요

원문: Dev.to

Source: Dev.to

위에 제공된 텍스트 외에 번역할 내용이 없습니다. 번역하고 싶은 본문을 알려주시면 한국어로 번역해 드리겠습니다.

해결해야 했던 문제

두 고객은 같은 문제를 공유했습니다: 회계와 공급업체 관리를 위해 Tango Gestión을 사용했지만, Interbanking을 통한 대량 결제 프로세스는 완전히 수동이었습니다.

통합 이전의 흐름은 대략 다음과 같았습니다:

관리 팀이 Tango에서 Excel 보고서를 내보냈습니다.
누군가가 이를 검토하고, 손으로 정리하고, 형식을 다시 맞췄습니다.
파일을 Interbanking 포털에 업로드했습니다.
확인을 기다린 뒤 Tango에서 다시 조정했습니다.

결제 사이클당 소요 시간: 3~5시간 사이.
인간 오류가 자주 발생하고, 핵심 인물에 대한 전적인 의존이 있었습니다.

솔루션: tango‑integration‑interapis

우리는 Node.js + NestJS 로 양쪽을 자동으로 연결하는 통합 레이어를 설계했습니다.

통합 흐름 작동 방식

Tango Gestión (reportería)
        ↓
API interna que lee y transforma los datos
        ↓
Generación automática del archivo de confección Interbanking
        ↓
Upload vía API a la plataforma bancaria
        ↓
Confirmación y registro automático en el sistema

주요 구성 요소

1️⃣ 탱고 보고서 추출기

Tango Gestión는 구성 가능한 보고서를 통해 데이터를 노출합니다. 우리는 이러한 보고서를 구조화된 형식으로 소비하고 다음 단계로 전달하기 위해 정규화하는 모듈을 구축했습니다.

2️⃣ Interbanking 형식 변환기

Interbanking은 특정 파일 형식을 가지고 있습니다 — 고정 길이 필드, 특수 인코딩, 헤더 및 제어 합계. 우리는 탱고 데이터를 은행 API가 기대하는 정확한 형식으로 변환하는 파서를 구축했습니다.

3️⃣ 사전 검증

파일을 전송하기 전에 시스템은 다음을 검증합니다:

올바른 CBU
한도 내 금액
합계 일관성
유효한 입금 날짜

무언가 실패하면 은행에 도달하기 전에 이메일로 알림이 전송됩니다.

4️⃣ Interbanking API와 통합

결제 배치를 구성하고 전송하는 작업은 Interbanking API를 통해 수행되며, 디지털 인증서 인증 및 일시적인 오류에 대한 재시도 처리를 포함합니다.

5️⃣ 기록 및 추적 가능성

각 작업은 상태, 타임스탬프 및 은행 참조와 함께 기록됩니다. 관리 팀은 실시간으로 어떤 결제가 처리되었고, 어떤 것이 보류 중이며, 어떤 것이 실패했는지 확인할 수 있습니다.

프로젝트의 실제 도전 과제

📄 Interbanking 문서는 공개되지 않음

API는 공개 문서가 없으며, 은행과의 상업적 계약을 통해 접근합니다. 고객의 기술팀과 협력해 사양 및 인증서를 확보하는 데 시간이 걸렸지만, 이는 불가피한 단계였습니다.

📂 파일 형식에 다양한 변형이 존재

Interbanking은 거래 유형(송금, 출금, 급여 지급)에 따라 서로 다른 형식을 사용합니다. 각 형식마다 고유한 규칙이 있습니다. 우리는 변환기를 모듈식으로 설계하여 각 거래 유형이 별도의 로직을 갖도록 하고 책임을 혼합하지 않았습니다.

🧹 Tango 데이터는 정제가 필요

Tango 보고서는 매우 풍부하지만 Interbanking이 기대하는 형태로 항상 정규화되어 있지는 않습니다. 공백이 포함된 CBU, 잘못된 형식의 금액, 비어 있는 선택 필드 등—전송 전에 이러한 경우를 감지하기 위해 검증 모듈이 핵심 역할을 했습니다.

🧪 제한된 테스트 환경

Interbanking에는 인증 환경이 있지만, 실제 운영 시나리오를 모두 재현하지는 못합니다. 최종 테스트의 일부는 소액 배치를 사용해 실제 운영에서 수행했으며, 수동 롤백을 준비했습니다.

결과

메트릭	이전	이후
사이클당 시간	3 – 5 시간	8 분
인간 오류	빈번함	없음
핵심 인력 의존도	높음	제거됨
추적 가능성	수동 스프레드시트	로그를 통한 자동화

두 고객은 오류가 잦고 인력에 의존하던 프로세스에서 완전 자동화된 파이프라인으로 전환되어 개입 없이 실행됩니다.

언제 이 통합을 하는 것이 의미가 있나요?

이 솔루션은 특히 다음과 같은 기업에 가치가 있습니다:

한 사이클에 20건 이상의 결제를 처리하는 경우 (공급업체, 급여, 수수료).
회계 시스템으로 Tango Gestión을 이미 사용하고 있는 경우.
주요 은행 플랫폼으로 Interbanking을 운영하는 경우.
파일 수동 업로드 과정에서 반복적인 오류가 발생하는 경우.
한 사람에게 의존하는 것을 없애고 싶을 때 (“어떻게 하는지 아는 사람”).

기술 스택

Backend: Node.js + NestJS
Integración Tango: 구성된 내보내기 모듈을 통한 보고
Integración Interbanking: 디지털 인증서 인증을 사용하는 API 구성
Notificaciones: 오류 또는 확인 시 자동 이메일
Infraestructura: 예약 실행을 위한 cron 작업이 포함된 VPS 배포

귀사의 기업도 같은 문제를 겪고 있나요?

Tango Gestión와 Interbanking을 사용하고 아직도 수동으로 결제를 처리하고 계시다면, 저희가 도와드릴 수 있습니다.

tolola.tech에서는 첫 번째 미팅을 무료로 진행하여 귀사의 상황을 이해하고 이 통합이 귀사 운영에 적용 가능한지 확인합니다.

📩 tololatech@gmail.com
💬 WhatsApp: +54 9 11 2724‑6517
🌐 www.tolola.tech

tolola.tech는 회계 및 은행 시스템 통합을 전문으로 하는 컨설팅 회사입니다.

API 통합, 자동화 및 AI에 특화된 소프트웨어 개발 서비스.
부에노스아이레스, 아르헨티나.