매핑은 LedgerPort가 WooCommerce 데이터를 QuickBooks Online으로 변환하는 방법을 알려줍니다. 첫 동기화 전에 WooCommerce 엔터티(제품, 고객, 세금 코드, 결제 방법)를 QuickBooks 회사에 있는 해당 계정 또는 항목에 매핑해야 합니다.
이 가이드에서는 매핑 페이지를 여는 방법, 자동 매핑 사용 방법, 플랫폼에서 매핑을 동기화하는 방법, 개별 매핑을 수동으로 조정하는 방법을 다룹니다.
시작하기 전에
- LedgerPort가 설치되어 WooCommerce 및 QuickBooks Online에 모두 연결되어 있어야 합니다. 아직 연결하지 않았다면 LedgerPort 설치 및 QuickBooks Online 연결을 참조하세요.
- WooCommerce 거래에 사용할 수입 및 지출 계정으로 QuickBooks Online 계정 원장이 설정되어 있어야 합니다. LedgerPort는 기존 QuickBooks 계정에 매핑하며, 새 계정을 생성하지 않습니다.
매핑 페이지 열기
- WordPress 관리자에서 LedgerPort » Mappings로 이동하세요.

매핑 페이지에는 QuickBooks에 매핑해야 하는 WooCommerce 엔터티 목록이 표시됩니다. 엔터티는 유형별로 구성됩니다. 매핑 상태(매핑됨, 매핑되지 않음, 전체)별로 필터링하고 이름으로 검색할 수 있습니다.
플랫폼에서 매핑 동기화
수동으로 매핑을 설정하기 전에 동기화를 실행하여 최신 엔터티를 WooCommerce 및 QuickBooks에서 LedgerPort로 가져옵니다. 이렇게 하면 현재 모든 제품, 고객 및 계정을 매핑에 사용할 수 있습니다.
- 1. 매핑 페이지에서 매핑할 제품을 선택하고 변경 사항 저장을 클릭합니다.
- 2. LedgerPort가 WooCommerce 및 QuickBooks Online에서 최신 데이터를 가져옵니다.
- 3. 매핑이 완료될 때까지 기다립니다. 제품 카탈로그가 큰 스토어의 경우 최대 1~2분이 걸릴 수 있습니다.

매핑 목록을 최신 상태로 유지하려면 어느 한 플랫폼에 새 제품이나 계정을 추가할 때마다 동기화를 실행하세요.
자동 매핑 사용
자동 매핑은 이름 유사성을 기반으로 WooCommerce 엔터티를 QuickBooks 엔터티와 자동으로 일치시키려고 시도합니다. 새 연결에서 매핑을 구성하는 가장 빠른 방법입니다.
- 매핑 페이지에서 자동 매핑을 클릭합니다.
- LedgerPort가 두 플랫폼의 엔터티 이름을 비교하고 일치 항목을 제안합니다.
- 제안된 매핑을 검토합니다. 자동 매핑된 항목은 확인하거나 재정의할 수 있도록 표시됩니다.

자동 매핑은 WooCommerce 제품 이름과 QuickBooks 항목 이름이 일관될 때 가장 잘 작동합니다. 자동으로 일치시킬 수 없는 엔터티는 매핑되지 않은 상태로 남아 수동으로 설정할 수 있습니다.
엔터티 수동 매핑
자동 매핑이 일치시키지 못한 엔터티 또는 자동 매핑 제안을 수정하려면:
- 목록에서 매핑되지 않은 엔터티를 찾습니다.
- 엔터티 행을 클릭하여 확장하거나(또는 편집 아이콘 클릭)
- QuickBooks 필드에서 드롭다운 메뉴에서 일치하는 QBO 계정 또는 항목을 선택합니다.
- Save를 클릭합니다.
매핑되지 않은 각 엔터티에 대해 반복합니다. 목록을 필터링하여 매핑되지 않은 항목만 표시하면 효율적으로 작업할 수 있습니다.
매핑 일괄 업데이트
여러 매핑을 한 번에 업데이트하려면:
- 드롭다운 메뉴에서 매핑할 제품을 선택합니다.
- 모두 선택한 후 저장을 클릭하여 변경 사항을 적용할 수 있습니다.
엔터티가 매핑되지 않은 경우
매핑되지 않은 개체(아직 매핑되지 않은 새 제품 등)가 포함된 WooCommerce 주문이 들어오면 LedgerPort는 감사 로그에 동기화 오류를 기록합니다. 매핑이 해결될 때까지 주문은 QuickBooks에 게시되지 않습니다.
이 문제를 해결하려면:
- LedgerPort » Mappings으로 이동하여 누락된 개체를 매핑합니다.
- LedgerPort » Manual Sync으로 이동하여 영향을 받은 주문을 다시 보냅니다.
- 항목이 QuickBooks에 나타나는지 확인합니다.

자주 묻는 질문
모든 제품을 개별적으로 매핑해야 하나요? 예, 각 WooCommerce 제품 또는 제품 카테고리는 QuickBooks 수입 계정 또는 서비스 항목에 매핑되어야 합니다. 제품이 많은 경우 먼저 자동 매핑을 사용하여 대부분을 처리한 다음, 나머지 매핑되지 않은 항목을 수동으로 처리하십시오.
설정 후 WooCommerce에 새 제품을 추가하면 어떻게 되나요? 새 제품은 자동으로 매핑되지 않습니다. WooCommerce에서 새 제품이 생성되면 LedgerPort » Mappings으로 돌아가서 동기화를 실행하여 새 제품을 가져온 다음 적절한 QBO 계정에 매핑하십시오.
여러 WooCommerce 제품을 동일한 QuickBooks 계정에 매핑할 수 있나요? 예. 여러 WooCommerce 제품을 동일한 QuickBooks 수입 계정에 매핑할 수 있습니다. 이는 모든 제품 수익을 단일 판매 계정으로 그룹화하는 상점에서 일반적입니다.
개체가 매핑되지 않음으로 표시되는 경우 무엇을 의미하나요? 매핑되지 않음은 주문을 동기화할 때 해당 개체에 사용할 QuickBooks 계정 또는 항목을 LedgerPort가 알지 못함을 의미합니다. 매핑되지 않은 개체가 포함된 주문은 오류를 기록하며 매핑이 설정될 때까지 QuickBooks에 게시되지 않습니다.
동기화가 시작된 후 매핑을 변경할 수 있나요? 예. 매핑은 언제든지 업데이트할 수 있습니다. 변경 사항은 향후 동기화에 적용됩니다. 이미 QuickBooks에 게시된 거래를 소급하여 업데이트하지는 않습니다.
문제가 발생하면 여기를 클릭하여 문의해 주세요. 저희 지원팀에서 도와드리겠습니다.