LedgerPort는 WooCommerce 스토어를 QuickBooks Online(QBO)에 연결하고 자동으로 동기화 상태를 유지합니다. WooCommerce에서 주문이 생성, 업데이트 또는 완료되면 LedgerPort는 수동 내보내기, CSV 업로드, 중복 데이터 입력 없이 실시간으로 해당 데이터를 QuickBooks 회사로 보냅니다.
이 가이드에서는 LedgerPort가 수행하는 작업, 설치 전에 필요한 사항, 처음부터 끝까지 설정 프로세스가 어떻게 진행되는지 설명합니다.
LedgerPort의 기능
LedgerPort는 웹훅을 사용하여 WooCommerce 스토어를 모니터링하고 LedgerPort SaaS 플랫폼을 통해 QuickBooks Online으로 데이터를 전달합니다. 다음 데이터가 동기화됩니다.
| WooCommerce 데이터 | 동기화 방향 |
|---|---|
| 주문(생성, 업데이트, 삭제) | WooCommerce – QuickBooks Online |
| 제품(생성, 업데이트, 삭제) | WooCommerce – QuickBooks Online |
| 제품 변형 | WooCommerce – QuickBooks Online |
| 고객(생성, 업데이트, 삭제) | WooCommerce – QuickBooks Online |
| 환불 | WooCommerce – QuickBooks Online |
WooCommerce에서 이벤트가 발생하면 실시간으로 자동으로 동기화됩니다. 언제든지 LedgerPort 관리 메뉴에서 수동 동기화를 트리거할 수도 있습니다.
작동 방식
LedgerPort는 두 부분으로 구성된 시스템입니다.
- WordPress 플러그인 – WooCommerce 스토어에 설치됩니다. WooCommerce API 자격 증명 및 웹훅을 프로비저닝하고 스토어와 LedgerPort 플랫폼 간의 브리지 역할을 합니다.
- LedgerPort SaaS 플랫폼 – app.ledgerport.com에 호스팅됩니다. 이곳에서 QuickBooks Online 연결을 관리하고, 계정 매핑을 저장하며, 동기화 로직을 실행하고, 감사 로그를 보관합니다.
플러그인은 WordPress 측에서 발생하는 모든 작업을 처리합니다. SaaS 플랫폼은 QuickBooks 측을 처리합니다. WordPress 내의 LedgerPort 관리 메뉴에서 두 가지 모두를 관리합니다.
요구 사항
LedgerPort를 설치하기 전에 환경이 다음을 충족하는지 확인하십시오.
| 요구 사항 | 최소 |
|---|---|
| WordPress | 6.0 이상 |
| PHP | 8.0 이상 |
| WooCommerce | 설치 및 활성화됨 (최신 버전) |
| HTTPS | 필수 – 사이트는 SSL을 사용해야 합니다. |
| LedgerPort 계정 | ledgerport.com의 활성 계정 |
| QuickBooks Online | LedgerPort 계정에 연결된 활성 QBO 회사 |
HTTPS is required. LedgerPort will not allow you to complete the connection flow on a site that is not using SSL/HTTPS. If your site is on HTTP only, enable SSL before proceeding. Most hosting providers offer free SSL via Let’s Encrypt.
Currency must match. Your WooCommerce store currency and your QuickBooks Online company’s home currency must be the same. LedgerPort does not convert currencies. If there is a mismatch, the connection will not activate.
The LedgerPort Admin Menu
Once the plugin is installed and connected, these pages are available under the LedgerPort menu in your WordPress admin:
| Page | What it shows |
|---|---|
| Dashboard | Connection status, last sync time, recent errors |
| Connection | Connection details, QuickBooks account, plan and usage, disconnect |
| Mappings | Map WooCommerce products, customers, and accounts to QuickBooks entities |
| Manual Sync | Trigger an immediate sync to QuickBooks |
| Audit Logs | Full sync history with filtering by type, entity, status, and date |
| Sync Config | Configure what gets synced and how |
| Debug Logs | Plugin-level diagnostic logs |
Setup Overview
Setting up LedgerPort takes about five minutes. Here is what the process looks like:
- Install the LedgerPort plugin on your WordPress site (from WordPress.org or by uploading the zip).
- The plugin opens the Setup Wizard automatically after activation.
- In the Setup Wizard, click Connect to start the connection flow.
- You are redirected to app.ledgerport.com to log in and authorize the connection.
- 인증 후 워드프레스 사이트로 다시 리디렉션됩니다.
- LedgerPort는 자동으로 WooCommerce REST API 키를 생성하고 웹훅을 등록합니다.
- 연결이 확인되면 대시보드로 이동합니다.
- WooCommerce 데이터가 QuickBooks 계정 원장에 올바르게 매핑되도록 계정 매핑을 구성하십시오.
자주 묻는 질문
LedgerPort가 HPOS(고성능 주문 저장소)와 함께 작동하나요? 예. LedgerPort는 WooCommerce의 고성능 주문 저장소(사용자 지정 주문 테이블)와 완벽하게 호환됨을 선언합니다. 추가 구성이 필요하지 않습니다.
플러그인을 설치하기 전에 LedgerPort 계정이 필요한가요? 예. 연결을 완료하려면 ledgerport.com에서 활성 계정이 필요합니다. 계정이 없는 경우 설정 중에 계정을 만들 수 있습니다.
하나의 LedgerPort 계정에 여러 WooCommerce 스토어를 연결할 수 있나요? 이는 LedgerPort 요금제에 따라 다릅니다. 연결된 각 스토어는 하나의 연결로 계산됩니다. 요금제의 연결 제한은 관리 메뉴의 연결 페이지에 표시됩니다.
LedgerPort가 WooCommerce 구독을 지원하나요? LedgerPort는 표준 WooCommerce 주문 및 고객 데이터를 동기화합니다. 구독 갱신 주문은 WooCommerce에서 생성될 때 일반 주문으로 동기화됩니다.
내 사이트가 인터넷 액세스를 잃거나 LedgerPort API를 일시적으로 사용할 수 없는 경우 어떻게 되나요? LedgerPort는 실시간 동기화를 위해 WooCommerce 웹훅을 사용합니다. 웹훅 전송에 실패하면 WooCommerce가 자동으로 다시 시도합니다. 필요에 따라 수동 동기화 페이지를 사용하여 데이터를 푸시할 수도 있습니다.
문제가 발생하면 여기를 클릭하여 문의해 주세요. 저희 지원팀에서 도와드리겠습니다.
