아마존 SP-API 정산 리포트 Flat File V2 전환(11월 11일)

SP-API 정산 리포트로 ERP 전표나 사내 대사 파일을 만드는 팀은 아직 기존 형식을 부르는 곳이 남아 있는지 바로 확인해야 합니다. 수정할 항목은 reportType과 앱 역할, 금액을 읽는 파서입니다. V2는 가격과 수수료 종류별로 따로 있던 열을 amount-type, amount-description, amount 세 열로 합쳤습니다. 열 이름만 바꿔서는 기존 매핑이 동작하지 않습니다.

11월 11일에 없어진 리포트

이 제거는 모든 마켓에 적용됐습니다. 제거일은 처음에 2026년 3월 25일이었다가 2026년 3월 공지로 11월 11일로 미뤄졌습니다.

셀러센트럴 화면에서 직접 받는 경우, 미국 도움말 가운데 내려받기 안내에는 11월 11일 뒤에도 XML과 Flat File 버튼이 나오고, 지난 정산서 안내에는 Flat File V2만 나옵니다(11월 12일 확인). EU와 일본 셀러 포럼에는 2022년 3월 31일부터 두 형식을 중단한다는 공지가 있었습니다. 11월 11일 제거는 SP-API 변경 공지와 지원 중단 일정에 나온 내용이므로 연동 설정부터 확인합니다.

연동 수정 항목

1. getReports로 찾는 reportType을 GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2로 바꿉니다. 정산 리포트는 요청하거나 예약할 수 없고 아마존이 자동으로 생성하므로, 수정할 대상은 리포트를 조회해 내려받는 호출입니다.
2. 앱 역할에 Finance and Accounting이 있는지 확인합니다. V2는 이 역할로만 받을 수 있습니다. 기존 Flat File은 Amazon Fulfillment 역할로도 받을 수 있었으므로, 11월 10일까지 정산 리포트를 문제없이 받던 앱이라도 이 역할이 없으면 V2를 받지 못합니다.
3. 파서를 새로 작성합니다. 탭으로 구분된 24개 열이고, 금액은 행마다 amount 열 하나에 들어갑니다. 그 금액의 종류는 amount-type과 amount-description에 나옵니다. 예전 transaction-type은 V2에서 transaction-type이나 amount-description으로 나뉘어 들어가고, 따로 나오던 금액이 하나로 합쳐지기도 합니다. 계정과목 매핑은 amount-type과 amount-description 값의 조합으로 새로 만듭니다.

EU 파일은 금액을 95,00처럼 현지 표기로 쓰므로 쉼표를 소수점으로 읽어야 합니다. 날짜는 posted-date(MM/DD/YY)와 posted-date-time(UTC) 두 형식으로 나옵니다. API로 받은 리포트는 최대 90일까지만 보관되므로, 월마감 증빙으로 쓸 파일은 생성될 때마다 내려받아 저장합니다.

셀러센트럴에서 내려받기

예전 화면은 Payments의 All Statements, 새 화면은 Finance Report에서 정산 기간별로 내려받습니다. 아직 종료되지 않은 정산 기간은 받을 수 없습니다. 지난 기간 옆의 Request Report 버튼으로 리포트를 다시 만들 수 있고, 만든 리포트는 90일 동안 내려받을 수 있습니다.

V2 주요 열

나머지 일곱 열은 merchant-order-id, merchant-order-item-id, merchant-adjustment-item-id, order-item-code, marketplace-name, promotion-id, fulfillment-id입니다. fulfillment-id로 판매자 배송(MFN)인지 아마존 배송인지 구분합니다.

주문 1건이 여러 행으로 나오는 이유

정산 리포트는 주문 상품마다, 환불 상품마다 행을 따로 만듭니다. V2는 행 하나에 금액을 하나만 기록하므로 판매 금액과 수수료도 서로 다른 행으로 나오고, 주문 1건의 금액을 보려면 같은 order-id 행을 합산해야 합니다.

공식 문서의 값 목록에 없는 값도 들어옵니다. 새 수수료나 거래 유형이 생기면 값이 늘어납니다. 마켓이 걷는 세금은 공제 항목으로 나옵니다. 매핑 표는 받은 파일에 실제로 나온 값으로 채우고, 처음 보는 값은 기타로 분류하지 말고 별도로 표시합니다.

정산 합계와 주문 금액·입금액 차이 원인

주문 행을 모두 합산해도 total-amount와 맞지 않으면 아래 다섯 가지를 차례로 확인합니다.

1. 유보 행: 반품과 환불에 대비해 이번 기간에 유보한 Current Reserve Amount와 지난 리포트에서 이월된 Previous Reserve Amount Balance가 각각 한 행으로 나옵니다. 주문 행만 합산하면 이 두 행이 빠집니다.
2. 배송일 기준 유보(DD+7): 기본 유보 기간은 배송일부터 7일이고 계정에 따라 늘어날 수 있습니다. 추적 정보가 없으면 가장 늦은 예상 배송일(EDD)을 기준으로 합니다. 정산 기간 말에 배송된 주문은 다음 리포트에 반영될 수 있습니다.
3. 수수료 유보: 추천 수수료나 FBA 출고 수수료처럼 주문에 포함된 수수료는 주문 대금과 함께 유보됐다가 지급될 때 청구됩니다. 유보 금액을 계산할 때 매출만 빼고 수수료를 그대로 두면 수수료만큼 차이가 납니다.
4. 지급 기준: 정산 리포트에는 지급(release)된 거래만 포함됩니다. 거래가 반영된 날 기준으로 뽑은 리포트와는 같은 주문도 기간이 다를 수 있습니다.
5. 입금 시점: 지급이 시작된 뒤 은행 계좌에 반영되기까지 최대 5영업일이 걸릴 수 있어서, 통장 입금일이 deposit-date보다 늦을 수 있습니다.

BATI CIS는 아마존 정산 리포트를 주문, 실제 출고, 반품과 맞춥니다. 유보와 지급 시점 때문에 마감 월과 맞지 않는 금액은 마감 전에 별도로 찾아 재무팀이 확인할 수 있게 합니다(아마존 정산 연동, 정산 대사).

마감 전 확인 순서

1. 이번 달에 입금된 정산 건의 리포트를 모두 내려받습니다. 정산 기간은 보통 14일 단위라(셀러센트럴 도움말 기준) 달력의 월 경계와 맞지 않습니다.
2. 리포트마다 total-amount를 통장 입금액과 맞춥니다. 날짜가 며칠 차이 나면 입금 시점부터 확인합니다.
3. ACCS로 원화를 받는 계정은 송금 당일 환율과 1.5% 고정 수수료가 적용됩니다. 통장의 원화 금액과 total-amount의 차이를 환율과 수수료로 나눠 맞춥니다.
4. order-id별로 행을 합산해 주문과 맞춥니다. 차이가 나면 유보 행과 DD+7을 먼저 확인합니다.
5. 월 매출과 비용은 기간별(Date Range) 리포트로 집계합니다. 보통 거래가 반영된 날 기준이고, 한 번에 최대 365일, 2012년 자료까지 만들 수 있습니다.
6. 아직 지급되지 않은 금액은 Finances API의 listTransactions(2024-06-19)로 조회합니다. 정산 기간이 종료되기 전에도 거래별로 DEFERRED, RELEASED 같은 상태를 보여 주며, 최근 48시간 주문은 아직 포함되지 않을 수 있습니다. 예전 listFinancialEvents(v0)는 유보 거래를 지급될 때까지 보여 주지 않고, 2027년 8월 27일에 제거될 예정입니다.