Checkout 사용자를 위한 다운로드 가능한 report

다운로드 가능한 report에서 필요한 데이터를 가져오는 방법을 알아보세요.

다운로드 가능한 report는 Checkout merchant에게 대조 및 분석에 필요한 데이터를 제공합니다. USD로 제공되며 date range를 원하는 대로 지정할 수 있는 이 report는 세금 신고, 주문 확인, charge 분석, 비즈니스 인사이트 확보와 같은 일반적인 사용 사례를 지원합니다. 모든 report의 날짜와 시간은 UTC 기준입니다.

Report 유형

이용 가능한 report는 다음과 같습니다.

Report↕	Description↕	Use cases↕
Payout summary	각 payout에서 제공되는 Payout summary report와 동일한 구조이며, date range를 선택할 수 있습니다. 이 report를 참조하는 매핑을 업데이트할 수 있도록 2025년 7월 31일까지는 레거시 버전도 계속 제공됩니다.	payout 내 주문을 높은 수준에서 분석하며, 각 주문이 한 행으로 표시됩니다. transaction fee와 merchant fee를 확인할 수 있습니다.
Payout detail	각 payout에서 제공되는 Payout detail report와 동일한 구조이며, date range를 선택할 수 있습니다. 이 report를 참조하는 매핑을 업데이트할 수 있도록 2025년 7월 31일까지는 레거시 버전도 계속 제공됩니다.	payout이 은행 계좌로 전송되기 전에 보류된 금액을 포함해 payout의 세부 내역을 확인합니다.
Invoice summary	각 invoice에서 제공되는 Invoice summary report와 동일한 구조이며, date range가 있습니다.	invoice로 청구된 charge의 요약을 확인합니다.
Invoice detail	각 invoice에서 제공되는 Invoice detail report와 동일한 구조이며, date range가 있습니다. CSV에서 각 개별 charge가 한 행으로 표시됩니다.	청구된 모든 charge의 세부 내역을 확인합니다.
Orders	품목별 세부 정보 없이 주문에 대한 주요 정보를 모두 표시합니다.	주문을 분석하여 매출을 예측하고, 지역별 trend를 파악하며, 계절적 패턴을 식별합니다.
Orders with item details	주문 내 모든 품목을 나열합니다(각 품목이 한 행으로 표시). 수량, SKU, 치수, HS code 등 품목 정보를 포함합니다.	주문을 분석하여 국가별로 어떤 상품이 가장 잘 팔리는지 파악합니다.
Landed Cost breakdown	관세, 세금, 수수료 breakdown으로 landed cost 계산을 감사합니다.	정기 세금 신고, landed cost 계산 감사.

Report 내보내기

구조

제공 정보(요약)

↕	Payout summary↕	Payout detail↕	Orders↕	Orders with item details↕	Landed Cost breakdown↕
고객 정보 및 tracking number
Payout 정보
Transaction fee 및 merchant fee
관세, 세금, 수수료 세부 정보
품목 세부 정보(Name, SKU, HS code 등)
주문 품목 수 및 무게

사용 가능한 모든 field

다음은 각 report에서 사용 가능한 field입니다.

Field↕	Payout summary↕	Payout detail↕	Orders↕	Orders with item details↕	Landed Cost breakdown↕
`accountName`
`orderAdditionalTariffLines`
`addressLine1`
`addressLine2`
`amount`
`amountDiscount`
`amountDutiesTaxesFees`
`amountItem`
`amountShipping`
`amountTotal`
`arrivalDate`
`brokerage`
`city`
`country`
`countryCode`
`countryOfOrigin`
`countryOfOriginSource`
`currency`
`currencyCode`
`customerName`
`customsDescription`
`description`
`detailType`
`dimensionsUnit`
`discountOrder`
`dutyOrder`
`dutyTaxFeeOrder`
`fx`
`guarantee`
`height`
`hsCode`
`hsCodeSource`
`itemWeight`
`itemWeightUnit`
`itemOrder`
`landedCostGuarantee`
`length`
`merchantAdjustment`
`merchantSet`
`merchantFee`
`memo`
`name`
`orderDate`
`orderDuty`
`orderFeeAdvancement`
`orderFeeBrokerage`
`orderFeeCarrier`
`orderFeeShopper`
`orderFx`
`orderNumber`
`orderReference`
`orderStatus`
`orderTax`
`orderTotal`
`other`
`otherCarrierFee`
`packageWeight`
`packageWeightUnit`
`payee`
`payor`
`payoutDate`
`payoutNumber`
`payoutTotal`
`postalCode`
`processing`
`productId`
`quantity`
`referenceNumber`
`settled`
`shippingOrder`
`shippingService`
`sku`
`state`
`taxOrder`
`total`
`totalItems`
`totalItemWeight`
`trackingNumber`
`transactionDate`
`transactionFee`
`transactionId`
`transactionType`
`weightUnit`
`width`

Field 정의

다음은 report 내 각 field의 정의입니다.

Field↕	Definition↕
`accountName`	Zonos 계정 이름입니다.
`orderAdditionalTarriffLines`	customs entry에서 여러 tariff(HS) code를 관리하고 신고하는 추가 작업에 대한 customs broker fee입니다.
`addressLine1`	수령인 주소의 첫 번째 줄입니다.
`addressLine2`	수령인 주소의 두 번째 줄입니다(해당하는 경우).
`advancement`	고객을 대신하여 관세와 세금을 선납하는 데 대해 청구되는 수수료입니다.
`amount`	line item 또는 charge의 금액입니다.
`amountDiscount`	주문에 적용된 할인 금액입니다.
`amountDutiesTaxesFees`	주문에 적용된 관세, 세금, 수수료의 금액입니다.
`amountItem`	개별 품목의 금액입니다.
`amountShipping`	주문의 배송 금액입니다.
`amountTotal`	개별 품목의 금액에 수량을 곱한 값입니다.
`arrivalDate`	payout이 merchant의 은행 계좌에 도착한 날짜입니다.
`brokerage`	통관과 관련된 brokerage fee입니다.
`city`	수령인 주소의 도시입니다.
`country`	도착지의 ISO 2자리 국가 코드입니다.
`countryOfOrigin`	품목이 제조되거나 생산된 국가입니다.
`countryOfOriginSource`	원산지 정보의 출처입니다.
`currency`	거래에 사용된 통화입니다(ISO 3자리 형식).
`customerName`	주문한 고객의 이름입니다.
`customsDescription`	통관 신고에 사용되는 품목 설명입니다.
`description`	상품 설명입니다.
`detailType`	주문 금액에 대한 세부 사유입니다(예: 세금, brokerage fee, currency conversion fee, merchant processing fee 등).
`dimensionsUnit`	측정 단위입니다(예: inches, cm).
`discountOrder`	주문에 적용된 할인입니다.
`dutyOrder`	주문에 적용된 관세 금액입니다.
`dutyTaxFeeOrder`	주문에 적용된 관세, 세금, 수수료의 총액입니다.
`fx`	거래에 적용된 환율입니다.
`guarantee`	Zonos가 보증하는 금액입니다.
`height`	품목의 높이입니다.
`hsCode`	품목에 지정된 HS(품목분류) code입니다.
`hsCodeSource`	HS code 분류의 출처입니다.
`itemWeight`	주문 내 품목의 무게입니다.
`itemWeightUnit`	품목 무게의 측정 단위입니다(예: kg, lb).
`itemOrder`	주문 내 품목의 비용입니다.
`landedCostGuarantee`	landed cost guarantee 서비스 비용입니다($ 및 % 가격 구성 요소를 모두 포함).
`length`	품목의 길이입니다.
`merchantAdjustment`	merchant가 입력하거나 요청한 조정 금액입니다(일반적으로 rule을 통해 설정).
`merchantSet`	merchant가 설정한 buffer 또는 조정 금액입니다.
`merchantFee`	결제 처리 비용에 해당하는 Checkout 비용 부분입니다.
`memo`	payout 또는 거래에 대한 추가 참고 사항이나 세부 정보입니다.
`name`	상품 이름입니다.
`orderDate`	주문이 접수된 날짜입니다(UTC 기준).
`orderDuty`	주문의 관세 금액입니다.
`orderFeeAdvancement`	주문의 advancement fee입니다.
`orderFeeBrokerage`	주문의 brokerage fee입니다.
`orderFeeCarrier`	주문의 carrier fee입니다.
`orderFeeShopper`	쇼퍼에게 청구된 수수료입니다.
`OrderFx`	거래에 적용된 환율입니다.
`orderNumber`	Zonos 시스템에서 주문을 식별하는 고유 식별자입니다.
`orderReference`	주문과 연결된 추가 참조 번호입니다(일반적으로 ecommerce platform의 주문 번호).
`orderStatus`	주문의 현재 상태입니다.
`orderTax`	주문의 세금 금액입니다.
`orderTotal`	주문의 총액입니다.
`other`	거래와 관련된 기타 charge 또는 조정 금액입니다.
`otherCarrierFee`	배송 carrier가 청구하는 추가 수수료입니다(carrier가 shipping bill에 포함하는 선지급 수수료 등).
`packageWeight`	패키지의 총 무게입니다.
`packageWeightUnit`	패키지 무게의 측정 단위입니다.
`payoutDate`	merchant에게 payout이 지급된 날짜입니다.
`payee`	결제를 수령하는 주체입니다.
`payor`	결제를 지불하는 주체입니다.
`payoutNumber`	Stripe payout id와 일치합니다.
`payoutTotal`	merchant에게 지급된 총액입니다.
`postalCode`	수령인 주소의 우편번호입니다.
`processing`	통관 결제 처리 방식입니다. `TAX_REMITTANCE`(tax ID로 remit) 또는 `CUSTOMS_BILL`(customs bill 납부) 중 하나입니다.
`productId`	상품의 고유 식별자입니다.
`quantity`	주문 내 품목의 수량입니다.
`referenceNumber`	Payout 번호(예: `po_1QcGXkGbPRfOWRJBfaa90A1A`) 또는 Invoice 번호(예: `584184EA-0000`)를 참조합니다.
`settled`	merchant에게 settle된 거래 금액입니다.
`shippingOrder`	주문의 배송 비용입니다.
`shippingService`	배송에 사용된 shipping 방법 또는 서비스입니다.
`sku`	상품의 SKU(Stock Keeping Unit)입니다.
`state`	수령인 주소의 주(state) 또는 지역입니다.
`taxOrder`	주문에 적용된 세금 금액입니다.
`total`	주문 총액입니다(쇼퍼가 지불한 총액).
`totalItems`	주문 내 품목의 총 개수입니다.
`totalItemWeight`	주문 내 모든 품목의 총 무게입니다.
`trackingNumber`	배송의 추적 번호입니다.
`transactionDate`	거래가 기록된 날짜입니다(UTC 기준).
`transactionFee`	fraud protection을 포함한 Checkout 서비스 비용입니다. 결제 처리 비용은 포함되지 않습니다.
`transactionId`	거래의 고유 식별자입니다.
`transactionType`	가능한 유형: `ORDER`, `ORDER_REFUND`, `ORDER_CANCEL`, `CHARGE`, `CREDIT`입니다. Invoice에는 subscription cost, platform fee, CTP credit과 관련된 또 다른 유형인 `STRIPE`도 있습니다.
`weightUnit`	무게 값의 측정 단위입니다.
`width`	품목의 너비입니다.

사용 사례

Payout 대조 / 특정 payout을 은행 명세서와 일치시키기

두 payout report 중 하나를 사용해 은행 명세서와 대조할 수 있습니다. (date range를 선택해야 하는 Reports page보다) Payouts page에서 다운로드하면 해당 payout과 연결된 주문만 정확히 포함되어 가장 쉽습니다.

Dashboard → Payouts로 이동합니다.
payout을 선택합니다.
오른쪽 상단의 Export transactions를 클릭한 다음, dropdown에서 Payout summary 또는 Payout detail을 선택합니다.

Payout summary와 Payout detail 모두에서 settled 열의 합계는 Dashboard에 표시된 총 payout 금액과 일치합니다.

환불된 주문 확인하기

Payout summary report를 사용해 주문과 해당 환불을 확인합니다.

Dashboard → Reports로 이동합니다.
Payout summary report 옆의 Generate를 클릭합니다.
원하는 date range를 선택합니다. 전체 내용을 확인하려면 주문 날짜와 환불 날짜가 모두 포함되도록 date range를 지정하세요.
Generate report를 클릭합니다.
해당 주문으로 report를 필터링합니다.

예시

한 주문을 예로 살펴보겠습니다. 다음은 전체 환불이 발생한 주문 1234를 기준으로 필터링한 Payout summary report CSV 다운로드의 스냅샷입니다.

`orderNumber` (I)↕	`transactionType` (L)↕	`itemOrder` (M)↕	`shippingOrder` (N)↕	`dutyTaxFeeOrder` (P)↕	`guarantee` (Q)↕	`transactionFee` (R)↕	`merchantFee` (S)↕	`settled` (U)↕
1234	`ORDER`	105.80	80.76	58.96	-58.96	-7.38	-9.88	169.30
1234	`ORDER_REFUND` (would show `ORDER_CANCEL` if this order had not shipped)	-105.80	-80.76	-58.96	58.96	7.37		-179.20

이 예시에서:

merchant가 Zonos의 Landed Cost guarantee를 사용하고 있습니다(열 Q, guarantee의 값).
주문 시점에 merchant는 itemOrder와 shippingOrder에서 Zonos의 수수료(transactionFee, merchantFee)를 제외한 금액을 지급받았습니다. 이 금액은 열 M부터 T까지의 합계이며, 열 U의 settled 값과 일치합니다.
- 관세, 세금, 수수료(dutyTaxFeeOrder)가 수금되었지만, merchant가 이를 Zonos가 처리하도록 선택했기 때문에 Zonos가 해당 금액을 보유하고 직접 관세를 납부합니다. 그 결과 dutyTaxFeeOrder와 guarantee는 서로 상쇄되어 순액이 0이 됩니다.
주문이 환불되었을 때 Zonos는 쇼퍼에게 환불하고 merchant로부터 itemOrder와 shippingOrder 금액을 회수했습니다. Zonos는 transactionFee도 환불했지만, 결제 provider로부터 merchant fee가 계속 청구되기 때문에 merchantFee는 회수하지 않았습니다.
- 관세, 세금, 수수료는 여전히 merchant의 책임이 아니므로 이 report에는 표시되지 않습니다. Zonos는 merchant의 환불 요청에 따라 쇼퍼에게 해당 금액을 환불했지만, 그 환불은 Zonos → 쇼퍼 간에 이루어졌기 때문에 여기에는 반영되지 않습니다.

Zonos가 보류한 금액과 주문에서 얻은 금액 확인하기

Payout detail report를 사용해 Zonos에 지불하는 금액과 쇼퍼가 지불하는 금액을 확인할 수 있습니다. 다만 report를 해석하는 방식은 Landed Cost guarantee를 사용하는지에 따라 달라집니다. 아래에서 사용 여부를 선택하세요.

기본적으로 쇼퍼는 landed cost guarantee 비용을 지불하고, merchant는 checkout 서비스 비용(결제 처리, fraud protection 등)을 지불합니다. Payout detail report는 주문의 각 부분을 누가 지불했는지 기록합니다.

본인과 쇼퍼가 각각 얼마를 지불했는지 확인하려면 먼저 report를 다운로드하세요.

Dashboard → Reports로 이동합니다.
Payout detail report 옆의 Generate를 클릭합니다.
원하는 date range를 선택합니다.
Generate report를 클릭합니다.

report에서 확인하려는 내용에 따라 필터링하세요.

쇼퍼가 주문에 대해 지불한 금액을 확인하려면 Payor(열 O)를 SHOPPER로, Payee(열 N)를 MERCHANT로 필터링합니다. 관세나 세금 같은 passthrough cost는 포함되지 않습니다.
Zonos에 직접 지불한 금액을 확인하려면 Payor(열 O)를 MERCHANT로, Payee(열 N)를 ZONOS로 필터링합니다. 해당 값들을 합산합니다.
주문에서 얻은 금액을 확인하려면 해당 주문의 모든 행을 합산합니다(위 두 합계의 차이와 일치합니다).

예시

한 주문을 예로 살펴보겠습니다. 다음은 단일 주문(0123)에 해당하는 모든 행을 살펴본 Payout detail report CSV 다운로드의 스냅샷입니다.

`orderNumber` (I)↕	`detailType` (M)↕	`payee` (N)↕	`payor` (O)↕	`amount` (P, all in USD)↕
0123	ITEM	MERCHANT	SHOPPER	96.85
0123	SHIPPING	MERCHANT	SHOPPER	30.63
0123	MERCHANT_PROCESSING	ZONOS	MERCHANT	-6.72
0123	TRANSACTION_PERCENT	ZONOS	MERCHANT	-4.94

이 세부 내역을 이해하기 위해 gains와 fees로 구분해 보겠습니다.

Gains: Zonos가 쇼퍼로부터 수금한 후 merchant에게 지급한 금액입니다.

품목 소계, 이 예시에서는 $96.85 (ITEM).
배송 비용, $30.63 (SHIPPING).

Fees: Zonos가 merchant로부터 수금하는 비용으로, 쇼퍼가 checkout에서 지불한 금액에는 포함되지 않습니다.

merchant processing fee $6.72 (MERCHANT_PROCESSING).
transaction fee $4.94 (TRANSACTION_PERCENT).

분기별 데이터(특정 기간 내 payout) 확인하기

payout report는 각 payout마다 제공되지만, 예를 들어 지난 분기 내 모든 payout을 대조하고 싶을 수 있습니다. 여러 payout report를 다운로드하는 대신, 원하는 date range로 하나의 report를 손쉽게 다운로드할 수 있습니다.

원하는 date range로 Payout summary 또는 Payout detail CSV report를 다운로드하려면:

Dashboard → Reports로 이동합니다.
원하는 report 옆의 Generate를 클릭합니다.
분기 시작일부터 분기 종료일까지의 date range를 선택합니다.
Generate report를 클릭합니다.

Dashboard 주문이 ecommerce platform 주문과 일치하는지 확인하기

최근 변경 사항이 있었다면, Zonos Dashboard의 모든 주문이 ecommerce platform에도 표시되는지 확인하고 싶을 수 있습니다. 확인 방법:

Orders CSV report를 다운로드합니다.
1. Dashboard → Reports로 이동합니다.
2. Orders report 옆의 Generate를 클릭합니다.
3. 확인하려는 date range를 선택합니다.
4. Generate report를 클릭합니다.
이 주문들을 ecommerce platform에서 보이는 내용과 비교합니다.

주문에 문제가 있으면 support team에 문의하세요.

Landed cost 계산 감사하기

Landed Cost Breakdown report를 사용하면 vertical table 없이 landed cost 계산의 세부 내역을 살펴볼 수 있습니다. 이 report는 주문의 총 landed cost에 기여하는 각 개별 비용을 표시하며, 모든 구성 요소가 각자의 열에 나열됩니다.

Landed cost breakdown report를 다운로드하려면:

Dashboard → Reports로 이동합니다.
Landed cost breakdown report 옆의 Generate를 클릭합니다.
carrier bill과 일치하는 date range를 선택합니다.
Generate report를 클릭합니다.

데모 예약하기