WooCommerce Tax
WooCommerce Tax는 세율 표를 직접 관리하는 대신 TaxJar를 통해 판매세를 자동으로 조회하는 WooCommerce 플러그인입니다. WCPOS는 이 플러그인과 함께 작동합니다. POS 판매에도 온라인 주문과 동일한 관할 구역 세율이 적용되며, WCPOS에서 따로 켜야 하는 항목은 없습니다.
작동 방식
WooCommerce Tax는 주문이 온라인 결제를 거치거나 WooCommerce 주문 화면에서 편집될 때만 TaxJar에 세율을 요청합니다. POS 주문은 두 경로 중 어느 쪽도 거치지 않으므로 WCPOS가 대신 요청합니다:
- POS가 진행 중인 주문을 저장하면 WCPOS는 해당 주문의 과세 위치에 적용되는 세율을 WooCommerce Tax에 요청합니다. 이 위치는 POS의 세금 계산 기준 설정을 따르며, 상점 기본 주소 또는 고객의 청구지 주소나 배송 주소가 됩니다.
- WooCommerce Tax는 온라인 주문에서와 똑같이 해당 세율을 관할 구역당 한 행씩 매장의 일반 세율 표에 기록합니다. 우편번호와 도시를 키로 하여
WP Admin > WooCommerce > Settings > Tax > Standard rates에서 확인할 수 있습니다. - WooCommerce는 그 행을 주문에 적용합니다. 주문에는 관할 구역마다 하나씩 세금 항목이 포함되며, WooCommerce Tax 자체 이름(예: CA STATE TAX, CA COUNTY TAX)이 사용됩니다.
- POS는 다음 변경 사항 확인 시(보통 1분 이내) 새 행을 다운로드하므로, 그 이후로는 로컬 총액이 매장과 일치합니다. 즉시 가져오려면 매장 상태 → 데이터베이스의 세율 행에서 지우고 다시 다운로드를 사용하세요.
진행 중인 POS 주문에서 항목을 추가하거나 제거하면 현재 항목을 기준으로 세금이 다시 계산됩니다. 주문이 결제되고 나면 WCPOS는 해당 주문을 그대로 두며, WooCommerce Tax는 다른 주문과 동일하게 동작합니다.
자동 세금이 꺼져 있으면 WCPOS는 특별한 작업을 하지 않으며, POS는 평소처럼 매장의 세율 표를 사용합니다.
설정
WooCommerce Tax 연결
WooCommerce Tax를 설치 및 활성화한 다음 WordPress.com에 연결합니다. WP Admin > WooCommerce > Status > WooCommerce Tax 에 WordPress.com에 연결됨이라고 표시되어야 합니다.
자동 세금 활성화
WP Admin > WooCommerce > Settings > Tax 에서 자동 세금을 자동 세금 활성화로 설정합니다. 매장이 WooCommerce Tax가 지원하는 국가에 있어야 합니다.
이 옵션을 켜면 직접 입력한 세율이 CSV 파일로 백업된 후 표에서 제거됩니다. 나중에 다시 필요할 수 있다면 WP Admin > WooCommerce > Status > WooCommerce Tax 에서 백업을 다운로드하세요.
POS에 설정 반영
POS에서 세금 설정을 열고 서버 설정 복원을 클릭합니다. 자동 세금이 켜져 있는 동안 WooCommerce Tax는 고객의 배송 주소를 기준으로 세금을 계산하고, 가격은 세금을 제외하고 입력·표시하도록 WooCommerce를 고정하므로, POS도 이를 반영해야 합니다.
방문 고객 판매를 위해 POS를 상점 기본 주소로 의도적으로 유지하는 경우, WCPOS는 매장에서 처리되는 POS 주문에도 동일한 기준을 사용하므로 양쪽은 계속 일치합니다.
테스트 판매 진행
표준 세금 클래스의 과세 대상 상품을 등록하고 주문을 저장합니다. WP Admin에서 확인해 보세요. 관할 구역 이름이 붙은 세금 항목이 있어야 하고, 해당 행이 표준 세율 아래에 생성되어 있어야 합니다. 다른 세금 클래스의 상품은 해당 클래스가 포함된 판매가 처음 발생할 때 그 클래스 아래에 행이 생성됩니다.
예상할 수 있는 사항
- 새 지역에서의 첫 판매는 한 번 일치하지 않을 수 있습니다. POS는 이미 다운로드한 세율 행으로 판매 총액을 계산합니다. 매장이 특정 주소에 한 번도 과세한 적이 없다면 아직 해당 행이 없으므로, 그 한 건의 판매에서 POS에 총액 알림이 표시될 수 있습니다. 기록되는 값은 매장의 수치입니다. 보통 1분 이내에 해당 행이 POS에 도달하고 나면 그 지역에서의 이후 판매는 일치합니다. 고객 주소를 기준으로 세금을 계산하면 새 우편번호마다 한 번씩 발생할 수 있고, 상점 기본 주소를 기준으로 하면 대개 맨 처음 판매에서만 발생합니다. 관할 구역이 세율을 변경하면 한 번 더 발생할 수 있습니다.
- 세율 행을 직접 추가하지 마세요. 특정 위치의 행은 그곳에서 첫 판매가 이루어질 때 생성됩니다. POS의 모든 세율 보기에서 어떤 위치가 비어 있어 보인다면, 그 위치로는 아직 판매가 이루어지지 않은 것입니다.
- 수수료는 TaxJar로 전송되지 않습니다. 과세 대상 수수료에는 해당 수수료의 세금 클래스에 대해 표에 이미 있는 세율이 적용되며, 이는 WooCommerce Tax가 자체 주문 화면에서 수수료를 처리하는 방식과 동일합니다.
- 조회에 실패해도 판매가 중단되지는 않습니다. TaxJar에 연결할 수 없거나 WooCommerce Tax가 주문 조회를 거부하는 경우(주소에 우편번호가 없거나, 면세 고객이거나, 매장에 넥서스가 없는 지역), 주문은 표에 이미 있는 세율로 저장됩니다. 서버의 POS 로그에는 어느 쪽이었는지 기록됩니다. 장애는 WooCommerce Tax rate priming failed, 거부는 WooCommerce Tax returned no rates for the POS order로 기록됩니다. 로그를 참조하세요.
- Stripe Tax는 다릅니다. Stripe Tax는 POS 주문에서 전혀 작동하지 않습니다. 플러그인 충돌을 참조하세요.