SCM SFTP 수신 완료 검수, 목록에 보이는 파일은 언제 읽을까

2026년 11월 기준, 완료 표식 방식은 SFTP 최종 파일과 같은 배치의 표식이 모이면 내려받습니다. 둘 중 하나가 없으면 대기합니다.

거래처가 주문 파일을 SFTP에 올리는 가상 상황입니다. 운영 화면이 먼저 보인 파일을 바로 읽으면 뒤에 전송될 주문 행이 빠질 수 있습니다. 이후 파일을 다시 읽더라도 이전 반영 내역과 구분하기 어려워집니다. 인수할 때는 목록에서 파일을 발견하는 시점과 완성본을 내려받아 검증할 시점을 나눕니다.

목록에 파일이 보이면 언제 내려받나요?#

송신자와 완료 표식 방식을 합의했다면, 같은 배치의 최종 파일과 표식이 둘 다 확인될 때 내려받습니다. 송신자는 임시 이름으로 업로드를 마치고 최종 파일을 확정한 뒤 표식을 공개합니다. 수신자는 내려받은 사본을 표식과 대조하고, 일치한 사본을 다음 검수로 넘깁니다.

Apache Camel SFTP의 tempPrefix는 임시 이름으로 기록한 뒤 쓰기를 마치면 최종 이름으로 바꾸는 송신 옵션입니다. doneFileName을 설정한 송신자는 원본을 쓴 뒤 같은 폴더에 빈 표식을 만들고, 수신자는 대응하는 표식이 있을 때 파일을 가져옵니다. 사용할 서버와 저장소에서 이 순서가 실제로 보이는지 인수 표본으로 확인합니다. Apache Camel SFTP 컴포넌트

받아온 파일이 송신 확정본인지 어떻게 확인하나요?#

송신자가 확정한 파일명·배치 키와, 내려받은 사본의 바이트 수·해시를 대조합니다. 일치하면 검증에 쓴 사본을 그대로 파서에 넘깁니다. 파일명이나 배치 키가 다르거나 해시가 어긋나면 운영 집계에 반영하기 전에 검토로 보냅니다.

아래 가상 계약에서 송신자는 orders-batch-a.csv를 확정한 뒤 orders-batch-a.csv.done에 확인값을 넣어 공개합니다. 표식도 임시 이름으로 쓴 뒤 닫고 최종 이름으로 공개합니다. 다음 코드는 가상 원본 바이트에서 표식의 내용을 계산합니다. Camel의 빈 표식과 별개로 두 팀이 합의한 형식입니다.

from hashlib import sha256
import json

payload = b"order_id,status\r\nORD-A,ready\r\n"

receipt = {
    "batchId": "batch-a",
    "file": "orders-batch-a.csv",
    "bytes": len(payload),
    "sha256": sha256(payload).hexdigest(),
}
print(json.dumps(receipt, indent=2))

처리 기록에는 송신 구분과 배치 키, 확인한 해시, 검증 결과, 업무 반영 여부를 남깁니다. 같은 송신자·배치 키는 한 작업만 처리하도록 하고, 앞선 작업이 중단됐다면 실제 반영 여부를 확인한 뒤 재개합니다. 검증 뒤 파싱할 때 원격 파일을 다시 열면 서로 다른 사본을 쓰게 될 수 있으므로, 검증한 사본을 같은 처리 단계에서 사용합니다. 예상한 배치가 애초에 오지 않은 문제는 송신 일정과 예상 배치 목록으로 따로 확인합니다.

전송 서비스의 완료 이벤트가 있으면 표식이 꼭 필요한가요?#

신뢰하는 전송 서비스가 완료 이벤트를 제공하고 그 이벤트를 해당 파일과 배치에 연결할 수 있다면 이벤트를 수신 신호로 쓸 수 있습니다. 그 뒤에도 파일 검증과 업무 반영 결과는 따로 확인합니다. 어떤 신호를 쓸지 합의할 때는 부분 업로드와 전송 실패도 같은 표본으로 검수합니다.

AWS Transfer Family는 SFTP 전송 완료·실패 이벤트를 구분하며, 부분 업로드 실패의 코드로 PARTIAL_UPLOAD를 설명합니다. 완료 이벤트가 뜻하는 범위는 전송입니다. 누락된 주문을 탐지하려면 기대 배치나 원천 레코드와 대조해야 합니다. AWS Transfer Family 전송 이벤트

받은 파일을 파싱하는 조건은 SCM CSV 레코드 경계 검수, API를 주기적으로 가져오는 조건은 SCM 증분 수집 체크포인트 검수, 저장 이후의 화면 숫자는 SCM 대시보드 조회 일관성 검수에서 다룹니다.

근거와 확인일#

Apache Camel 4.22.2 LTS는 2026년 10월 22일 공개됐습니다. 이 글은 2026년 11월 8일에 확인한 4.22.x SFTP 문서의 임시 파일·완료 표식과 같은 날 확인한 AWS Transfer Family 이벤트 문서를 참고했습니다. 표식의 배치 키·바이트·해시는 가상 인수 조건입니다. Apache Camel 4.22.2 공개 발표

알파카랩스는 원천별 API·파일 접근 조건, 갱신과 누락 표시, 원천 표본과 화면의 대조 및 운영 인수 범위를 공개 서비스에서 안내합니다. 확인일은 2026년 11월 8일입니다. SCM 운영대시보드 개발

SCM SFTP 수신 완료 검수 FAQ#

SFTP 수신 인수표 초안 협의#

첫 범위 협의에서 비식별 파일명과 완료 신호, 가상 실패 표본으로 대기·처리·검토 기준을 초안에 정리합니다. 소요 시간은 자료와 검수 범위를 확인한 뒤 협의합니다.