Sync Config 페이지는 LedgerPort가 WooCommerce 데이터를 QuickBooks Online으로 처리하고 게시하는 방법을 제어합니다. 이 설정은 일반, 주문, 제품, 고객, 결제, 세금 및 기타의 7개 탭으로 구성됩니다.
페이지를 열려면 LedgerPort » Sync Config로 이동하세요.

변경 사항 저장
- 1. 변경 사항 저장을 클릭하여 변경 사항을 적용합니다. 변경 사항은 모든 향후 동기화에 즉시 적용됩니다.
- 2. 취소를 클릭하여 편집 내용을 마지막으로 저장된 상태로 되돌립니다.
저장 막대는 저장되지 않은 변경 사항이 있을 때만 나타납니다. 그렇지 않으면 페이지에 표시되지 않습니다.
일반 탭
일반 탭에는 자동 동기화 항목 및 동기화 제어 & 기록 동기화의 두 가지 카드가 있습니다.

자동 동기화 항목
각 동기화 방향에 포함되는 데이터 유형을 제어합니다.
WooCommerce에서 QuickBooks로:
| 항목 | 제어하는 내용 |
|---|---|
| 고객 | WooCommerce 고객을 QuickBooks로 자동 동기화 |
| 주문 | WooCommerce 주문을 QuickBooks로 자동 동기화 |
| 제품 | WooCommerce 제품을 QuickBooks로 자동 동기화 |
| 변형 | WooCommerce 제품 변형을 QuickBooks로 자동 동기화 |
| 결제 | WooCommerce 결제를 QuickBooks로 자동 동기화 |
QuickBooks에서 WooCommerce로:
| 항목 | 제어하는 내용 |
|---|---|
| 제품 | QuickBooks 제품을 WooCommerce로 자동 동기화 |
| 비용 | QuickBooks에서 WooCommerce로 비용 데이터를 자동 동기화 |
| 재고 | QuickBooks에서 WooCommerce로 재고 수준을 자동 동기화 |
| 가격 | QuickBooks에서 WooCommerce로 가격을 자동 동기화 |
동기화 제어 및 기록 동기화
| 설정 | 기능 |
|---|---|
| 자동 동기화 | WooCommerce와 QuickBooks 간의 자동 동기화를 활성화합니다. 비활성화 시 동기화는 수동 동기화 페이지에서 수동으로 트리거해야 합니다. |
| 동기화 빈도 | 자동 동기화가 실행되는 빈도입니다. 낮은 빈도는 더 높은 등급의 요금제가 필요할 수 있습니다. |
| 기록 동기화 | 과거 WooCommerce 데이터를 QuickBooks로 가져오려면 활성화하세요. |
| 시작 날짜 | 기록 동기화가 켜져 있을 때 표시됩니다. 이 날짜 이후에 생성된 데이터만 가져옵니다. |
주문 탭
주문 탭에는 동기화 방법, 동기화 트리거 및 필터링, 거래 옵션, 배송, 할인 등 다섯 개의 카드가 있습니다.

동기화 방법
| 설정 | 기능 |
|---|---|
| 동기화 방식 | WooCommerce 주문이 QuickBooks에 표시되는 방식입니다. 판매 영수증은 결제된 주문에 가장 적합합니다. 송장은 결제가 필요한 주문용입니다. 견적은 견적용입니다. |
| $0 주문 제외 | 총액이 $0인 주문은 QuickBooks로 동기화되지 않습니다. |
동기화 트리거 및 필터링
| 설정 | 기능 |
|---|---|
| 자동 동기화 주문 상태 | 동기화를 트리거하는 WooCommerce 주문 상태(처리 중, 완료, 보류 중, 대기 중, 취소됨, 환불됨, 실패). 주문은 선택한 상태로 전환될 때 동기화됩니다. |
| 날짜 이전 동기화 안 함 | 이 날짜 이전에 배치된 주문은 건너뜁니다. |
| 주문 ID 이전 동기화 안 함 | 이 값보다 낮은 ID의 주문은 건너뜁니다. |
| 취소된 주문에 대해 QB 주문 무효화 | WooCommerce 주문이 취소되면 해당 QuickBooks 거래를 무효화합니다. QuickBooks에 이미 동기화된 주문만 무효화됩니다. 동기화 전에 취소된 주문은 건너뜁니다. |
거래 옵션
거래 옵션에는 네 개의 하위 섹션이 있습니다.
번호 매기기 및 날짜
| 설정 | 기능 |
|---|---|
| 번호 매기기 소스 | WooCommerce 주문 번호 또는 QuickBooks 자동 번호 매기기를 사용하여 거래를 처리하세요. |
| 날짜 소스 | QuickBooks 거래에 사용할 날짜: 주문 날짜, 결제 날짜, 완료 날짜 또는 동기화 날짜. |
| 만기일 오프셋(일) | 거래 날짜로부터 며칠 후에 만기일로 설정할지 결정합니다 (송장의 경우). |
| 서비스 날짜에 주문 날짜 사용 | WooCommerce 주문 날짜를 QuickBooks 항목의 서비스 날짜로 사용합니다. |
메모 및 설명
| 설정 | 기능 |
|---|---|
| 주문 메모 대상 | WooCommerce 주문 메모가 QuickBooks의 어디에 표시될지 선택: 없음, 고객 메모, 개인 메모 또는 항목. |
| 배송 방법을 메모에 포함 | WooCommerce 배송 방법을 주문 메모에 추가합니다. |
| 항목 설명 소스 | QuickBooks 항목 설명에 사용할 텍스트: WooCommerce 상품명, WooCommerce 상품 설명, QuickBooks 상품 설명 또는 없음. |
| 사용자 지정 주문 항목 메타 포함 | 사용자 지정 WooCommerce 주문 항목 메타 필드를 항목 설명에 추가합니다. |
| 첫 번째 줄 설명을 개인 메모로 사용 | 첫 번째 항목 설명을 QuickBooks 개인 메모로 사용합니다. |
결제 및 청구
| 설정 | 기능 |
|---|---|
| 결제 참조 번호 소스 | WooCommerce 주문 번호 또는 결제 게이트웨이 거래 ID를 QuickBooks 결제 참조 번호로 사용합니다. |
| 청구 주소 소스 | QuickBooks 거래에 주문 청구 주소 또는 QB 고객 청구 주소를 사용합니다. |
| 기존 QB 고객 청구 주소 사용 | 주문 청구 주소로 덮어쓰는 대신 QuickBooks에 저장된 청구 주소를 유지합니다. |
송장 옵션
이 설정은 동기화를 송장으로 설정한 경우에 적용됩니다.
| 설정 | 기능 |
|---|---|
| 인쇄 상태 | QuickBooks 송장의 인쇄 상태 설정: 설정 안 함, 인쇄 필요 또는 인쇄 완료. |
| 나중에 QuickBooks에서 보낼 수 있도록 대기열에 추가 | QuickBooks에서 송장을 보낼 준비 완료로 표시합니다. QuickBooks에서 대량으로 송장을 수동으로 보내야 합니다. |
| 온라인 결제 허용 | QuickBooks 송장에서 신용카드 및 ACH 결제를 사용 설정합니다. |
| 기본 고객 메시지 사용 | QuickBooks의 기본 고객 메시지를 송장에 포함합니다. |
배송
| 설정 | 기능 |
|---|---|
| 배송을 라인 항목으로 동기화 | 배송비를 QuickBooks 거래의 별도 라인 항목으로 추가합니다. |
| 배송 상품 | 배송 라인 항목에 사용할 QuickBooks 상품/서비스 항목입니다. 서비스 및 재고 없음 상품만 표시됩니다. |
| $0 배송 라인 건너뛰기 | 배송비가 $0일 때 배송 라인 항목을 추가하지 않습니다. |
할인
| 설정 | 기능 |
|---|---|
| 할인 동기화 방법 | QuickBooks에서 할인이 기록되는 방식: 할인된 가격 라인 항목은 각 라인 항목의 가격을 줄이거나, 별도 라인 항목은 음수 할인 라인 항목을 추가합니다. |
| 할인 라인 항목 상품 | 할인 라인 항목에 사용할 QuickBooks 상품입니다. 할인 동기화 방법이 별도 라인 항목으로 설정된 경우에만 표시됩니다. |
| 판매세 위에 할인 적용 | 판매세가 계산되기 전에 할인을 적용합니다. |
제품 탭
상품 탭은 QuickBooks에서 WooCommerce 상품이 생성, 일치 및 동기화되는 방식을 제어합니다.

필드 동기화
| 설정 | 기능 |
|---|---|
| 원가 동기화 | WooCommerce의 원가를 QuickBooks로 동기화합니다. |
| 가격 동기화 | 상품 가격을 동기화합니다. |
| 설명 동기화 | 상품 설명을 동기화합니다. |
| 이미지 동기화 | 상품 이미지를 동기화합니다. |
| 상품 유형을 카테고리로 동기화 | WooCommerce 상품 유형을 QuickBooks 상품 카테고리에 매핑합니다. |
매칭 및 미매칭 처리
| 설정 | 기능 |
|---|---|
| 매칭 방법 | SKU 또는 이름으로 WooCommerce 상품을 QuickBooks 항목에 매칭합니다. |
| 미매칭 처리 | QuickBooks 매칭을 찾을 수 없을 때 수행할 작업: 새 항목을 자동으로 생성하거나, 일반 상품을 만능으로 사용하거나, 상품이 수동으로 매핑될 때까지 기다렸다가 오류를 기록합니다. |
| 일반 상품 | 미매칭 처리가 일반 상품으로 설정된 경우 모든 미매칭 상품에 사용되는 QuickBooks 항목입니다. |
| 라인 항목 설명 사용 | 상품 이름 대신 미매칭 상품에 대한 WooCommerce 라인 항목 설명을 사용합니다. |
자동 생성 설정
미매칭 처리가 생성으로 설정된 경우 적용됩니다.
| 설정 | 기능 |
|---|---|
| 상품 유형 | 새 QuickBooks 항목을 재고 없음, 재고 있음 또는 서비스로 생성합니다. |
| 자산 계정 | 재고 유형 상품에 대한 QuickBooks 자산 계정입니다. |
| 수익 계정 | 새 상품에 할당할 QuickBooks 수익 계정입니다. |
| 비용 계정 | 새 상품에 할당할 QuickBooks 비용 계정입니다. |
| 기본 세금 코드 | 새로 생성된 상품에 적용되는 QuickBooks 세금 코드입니다. |
재고 및 변형
| 설정 | 기능 |
|---|---|
| 재고 시작 날짜 | 이 날짜 이후에 생성된 재고 데이터만 동기화합니다. |
| 재고 조정 계정 | 재고 조정 항목에 사용되는 QuickBooks 계정입니다. |
| 변형에 QuickBooks 필드 표시 | WooCommerce 가변 상품 변형 편집 화면에 QuickBooks 매핑 필드를 표시합니다. |
설명 동기화
WooCommerce와 QuickBooks 간에 제품 이름과 설명을 번역하는 방법을 제어합니다.
WooCommerce에서 QuickBooks로:
| 필드 | 소스 옵션 |
|---|---|
| 제품 이름 | WooCommerce 제품 이름, WooCommerce 제품 설명 또는 QuickBooks 제품 설명 |
| 제품 설명 | WooCommerce 제품 이름, WooCommerce 제품 설명 또는 QuickBooks 제품 설명 |
| 구매 설명 | WooCommerce 제품 이름, WooCommerce 제품 설명 또는 QuickBooks 제품 설명 |
QuickBooks에서 WooCommerce로:
| 필드 | 소스 옵션 |
|---|---|
| 제품 이름 | QuickBooks 제품 이름, QuickBooks 제품 설명 또는 QuickBooks 제품 SKU |
고객 탭
고객 탭은 WooCommerce 고객을 QuickBooks와 일치시키거나 생성하는 방법을 제어합니다.

고객 전략
| 설정 | 기능 |
|---|---|
| 전략 유형 | 개별: 각 WooCommerce 고객은 별도의 QuickBooks 고객으로 동기화됩니다. 일반: 모든 주문은 단일 일반 QuickBooks 고객에게 게시됩니다. |
| 일반 고객 | 모든 주문에 사용할 QuickBooks 고객 (전략 = 일반인 경우). |
고객 일치
| 설정 | 기능 |
|---|---|
| 매칭 방법 | 이메일 주소 또는 이름으로 고객을 일치시킵니다. |
| 대체 방법 | 기본 방법이 일치 항목을 찾지 못하는 경우 보조 일치 방법입니다. |
| 찾을 수 없는 경우 생성 | 일치 항목을 찾을 수 없을 때 새 QuickBooks 고객을 자동으로 생성합니다. |
| 표시 이름으로 일치 | 일치시킬 때 WooCommerce 고객 표시 이름을 사용합니다. |
| 배송 회사로 재정의 | 배송 회사 이름을 사용하여 QuickBooks에서 고객을 식별합니다. |
| 청구 회사로 재정의 | 청구 회사 이름을 사용합니다. |
| 청구 이름/성으로 재정의 | 계정 이름 대신 청구 이름과 성을 사용합니다. |
자동 생성 설정
QuickBooks에서 새 고객이 생성될 때 적용됩니다.
| 설정 | 기능 |
|---|---|
| 표시 이름 형식 | QuickBooks 고객 표시 이름을 구성하는 데 사용되는 형식입니다. |
| 기본 결제 조건 | 새로 생성된 QuickBooks 고객에게 할당된 결제 조건입니다. |
| 기본 결제 방법 | 새 고객에게 할당된 QuickBooks 결제 방법입니다. |
| 중복 시 사용자 ID 추가 | 이름 충돌이 발생하면 WooCommerce 사용자 ID를 추가하여 표시 이름을 고유하게 만듭니다. |
추가 고객 옵션
| 설정 | 기능 |
|---|---|
| QuickBooks 고객 이메일 사용 | 주문 청구 이메일 대신 QuickBooks에 저장된 이메일 주소를 사용합니다. |
| QuickBooks 고객 청구 주소 사용 | 주문 청구 주소 대신 QuickBooks에 저장된 청구 주소를 사용합니다. |
결제 탭
결제 탭은 WooCommerce 결제 게이트웨이를 QuickBooks 정산 계정 및 결제 방법과 매핑합니다.

LedgerPort는 WooCommerce 스토어에서 활성화된 결제 게이트웨이를 감지하고 여기에 나열합니다. 각 게이트웨이에 대해 다음을 구성할 수 있습니다.
| 설정 | 기능 |
|---|---|
| 활성화됨 | 이 게이트웨이의 거래를 동기화에 포함합니다. |
| 환불 활성화 | 이 게이트웨이를 통해 처리된 환불을 동기화합니다. |
| 정산 계정 | 이 게이트웨이의 결제가 입금되는 QuickBooks 은행 또는 정산 계정입니다. |
| 결제 방법 | 이 게이트웨이의 거래에 할당할 QuickBooks 결제 방법입니다. |
| 환불 번호 매기기 – 접두사 | QuickBooks의 환불 참조 번호 앞에 붙는 텍스트입니다. |
| 환불 번호 매기기 – 접미사 | 참조 번호에 추가되는 텍스트입니다. |
| WooCommerce 환불 ID 사용 | 사용자 지정 접두사/접미사 형식 대신 WooCommerce 환불 ID를 QuickBooks 참조 번호로 사용합니다. |
기본 정산 계정은 자체 정산 계정이 구성되지 않은 모든 게이트웨이에 대한 대체로 설정할 수 있습니다.
세금 탭
세금 탭은 WooCommerce 세금 금액이 QuickBooks 거래에 표시되는 방식을 구성합니다.

세금 반올림
| 설정 | 기능 |
|---|---|
| 세금 반올림 사용 | WooCommerce와 QuickBooks 세금 계산 간의 센트 단위 차이를 보정하기 위해 반올림 조정 라인 항목을 추가합니다. |
| 반올림 제품 | 반올림 조정 라인에 사용되는 QuickBooks 제품/서비스 항목입니다. |
라인 항목 세금
| 설정 | 기능 |
|---|---|
| 라인 항목 세금 사용 | QuickBooks의 기본 세금 계산에 의존하는 대신 WooCommerce 세금을 QuickBooks 거래의 전용 라인 항목으로 동기화합니다. |
| 설명 | QuickBooks의 세금 라인 항목에 표시되는 레이블입니다. |
| 세금 계정 | 세금 금액이 게시되는 QuickBooks 부채 계정입니다. |
| 세금 제품 | 세금 라인에 사용되는 QuickBooks 제품/서비스 항목입니다. |
기타 탭
기타 탭에는 디버그 로깅 설정이 포함되어 있습니다. 이는 LedgerPort 지원팀과의 동기화 문제 해결 시 가장 유용합니다.

| 설정 | 기능 |
|---|---|
| 오류 요청/응답 기록 | 동기화 오류가 발생할 때 전체 API 요청 및 응답 페이로드를 디버그 로그에 기록합니다. |
| 성공 요청/응답 기록 | 성공적인 동기화의 전체 API 요청 및 응답 페이로드를 디버그 로그에 기록합니다. 로그 볼륨이 높으므로 임시로만 활성화하십시오. |
| 재고 가져오기 CDC 디버그 로그 사용 | 재고 동기화 작업에 대한 추가 진단 정보를 기록합니다. |
디버그 로그 항목은 LedgerPort » 디버그 로그에서 검토할 수 있습니다. 지침은 LedgerPort의 감사 로그 및 문제 해결을 참조하십시오.
자주 묻는 질문
동기화하기 전에 모든 탭을 구성해야 합니까? 아니요. LedgerPort는 모든 탭에 합리적인 기본값을 제공합니다. 대부분의 스토어는 연결 및 매핑을 완료한 후 동기화 구성을 전혀 건드리지 않고 동기화를 시작할 수 있습니다. 회계 설정과 가장 관련성이 높은 설정(특히 주문, 고객 및 결제)을 검토하고 필요한 대로 조정하십시오.
동기화 구성의 변경 사항이 기록 데이터에 적용됩니까? 아니요. 변경 사항은 향후 동기화에만 적용됩니다. 이미 QuickBooks에 게시된 거래는 소급하여 업데이트되지 않습니다.
일부 설정에서 “플랜 제한”이란 무엇을 의미합니까? 낮은 동기화 빈도와 같은 일부 설정은 상위 등급 LedgerPort 플랜에서만 사용할 수 있습니다. 설정에 업그레이드 배지가 표시되면 잠금을 해제하려면 플랜 업그레이드가 필요합니다. 플랜을 확인하고 업그레이드하려면 연결 페이지를 방문하십시오.
동기화 구성과 매핑의 차이점은 무엇입니까? 동기화 구성은 데이터가 QuickBooks로 처리되고 변환되는 방식(동기화 방법, 엔터티 유형, 날짜 설정 등)을 제어합니다. 매핑은 특정 WooCommerce 제품, 고객 및 계정이 특정 QuickBooks 엔터티에 해당하는 방식을 제어합니다. 완전한 설정을 위해서는 둘 다 구성해야 합니다.
변경했지만 저장 막대가 표시되지 않았습니다. 어떻게 된 일입니까? 저장 막대는 저장되지 않은 변경 사항이 있을 때만 나타납니다. 사라졌다면 변경 사항이 성공적으로 저장되었거나 '취소'를 클릭한 것입니다. 탭의 설정이 의도한 값으로 반영되는지 확인하십시오.
문제가 발생하면 여기를 클릭하여 문의해 주세요. 저희 지원팀에서 도와드리겠습니다.