대부분의 동기화 오류는 소수의 범주에 속하며 명확한 해결 방법이 있습니다. 이 가이드에서는 고객이 가장 자주 접하는 오류, 오류 발생 원인 및 각 오류에 대한 정확한 해결 방법을 다룹니다.
오류를 먼저 어디서 찾아야 할지 확실하지 않다면, 감사 로그 읽기 및 필터링으로 시작하여 실패한 특정 레코드를 찾으십시오.
오류 상태 한눈에 보기
특정 오류에 대해 자세히 알아보기 전에 감사 로그의 각 상태가 무엇을 의미하는지 살펴보겠습니다.
- 동기화됨: 레코드가 QuickBooks로 성공적으로 전송되었습니다.
- 오류: 동기화 시도가 실패했습니다. 로그 항목에 이유가 포함됩니다.
- 대기 중: 레코드가 대기열에 있으며 아직 처리되지 않았습니다.
- 보류 중: 레코드가 동기화 트리거 조건(예: 결제 또는 이행 상태 요구 사항)이 충족될 때까지 기다리고 있습니다.
아래의 모든 오류는 로그에 오류 상태로 표시됩니다.
1. QuickBooks에서 고객을 찾을 수 없음
의미: LedgerPort가 Shopify 고객을 기존 QuickBooks 고객과 일치시키려고 했지만 찾을 수 없었습니다. 고객을 연결할 수 없었기 때문에 주문을 동기화할 수 없었습니다.
해결 방법:
옵션 A: 고객을 수동으로 매핑합니다.
- 왼쪽 사이드바에서 매핑으로 이동합니다.
- 고객을 클릭합니다.
- 고객을 찾아 드롭다운에서 일치하는 QuickBooks 레코드를 선택합니다.
- 수동 동기화 » 주문으로 이동하여 영향을 받은 주문을 다시 동기화합니다.
옵션 B: 일반 고객 모드로 전환합니다. QuickBooks에서 고객별 추적이 필요하지 않은 경우 일치하지 않는 모든 고객을 단일 일반 QuickBooks 고객으로 라우팅할 수 있습니다.
- 동기화 구성 » 고객으로 이동합니다.
- 고객 전략을 일반으로 변경합니다.
- 수동 동기화 » 주문에서 영향을 받은 주문을 다시 동기화합니다.
2. 제품이 매핑되지 않음
의미: LedgerPort가 주문의 하나 이상의 제품에 대한 일치하는 QuickBooks 항목을 찾을 수 없었습니다. 이는 일반적으로 제품이 Shopify에 있지만 아직 QuickBooks에서 매핑되거나 생성되지 않은 경우 발생합니다.
해결 방법:
옵션 A: 자동 매핑을 실행합니다.
- 매핑 » 제품으로 이동합니다.
- 자동 매핑을 클릭합니다. LedgerPort는 SKU 또는 이름으로 제품을 일치시키려고 시도합니다.
- 아직 매핑되지 않은 항목을 검토하고 수동으로 처리합니다.
옵션 B: 수동으로 매핑합니다.
- 매핑 » 제품으로 이동합니다.
- 매핑되지 않은 제품을 찾아 드롭다운에서 올바른 QuickBooks 항목을 선택합니다.
옵션 C: 기본 제품 대체 설정을 지정합니다. 매핑되지 않은 제품이 실패하는 대신 자리 표시자 항목을 사용하여 동기화되도록 하려면 다음을 수행합니다.
- Sync Config » Products로 이동하세요.
- 일치하지 않는 항목 처리에서 기본 제품 사용을 선택하고 대체 QuickBooks 항목을 선택하세요.
3. QuickBooks 연결 비정상 / 인증 오류
의미: LedgerPort가 QuickBooks 계정에 대한 액세스 권한을 잃었습니다. 일반적으로 QuickBooks 액세스 토큰이 만료되었기 때문입니다. 가장 일반적인 동기화 오류이며 수정이 간단합니다.
해결 방법:
- 왼쪽 사이드바에서 연결로 이동하세요.
- QuickBooks Online에서 다시 연결을 클릭하세요.
- QuickBooks에 로그인하고 권한 부여를 클릭하세요.
- 다시 연결되면 연결이 끊긴 기간 동안 실패한 주문을 수동 동기화 » 주문에서 다시 동기화하세요.
4. QuickBooks 중복 항목
의미: LedgerPort가 QuickBooks에 거래를 생성하려고 했지만 해당 주문 번호와 동일한 레코드가 이미 존재합니다. 주문이 수동으로 동기화된 후 다시 자동 동기화되거나 이전 동기화가 부분적으로 완료된 경우 발생할 수 있습니다.
해결 방법:
먼저 QuickBooks를 확인하세요. 거래가 존재하고 올바르다면, 다시 동기화하지 않고 감사 로그에서 해결됨으로 표시할 수 있습니다.
중복 항목이 오류로 생성된 경우:
- QuickBooks에서 중복 거래를 삭제하세요.
- 수동 동기화 » 주문으로 이동하여 주문을 찾고 다시 동기화하세요.
향후 이 문제가 발생하지 않도록 하려면 자동 동기화 대기열에 이미 있는 주문에 대한 수동 동기화를 실행하지 마세요.
의미: Shopify 주문에 적용된 세금 요율이 LedgerPort에 일치하는 구성이 없습니다. QuickBooks에서 세금을 기록할 위치를 결정할 수 없었기 때문에 동기화가 중지되었습니다.
해결 방법:
- Sync Config » Accounting으로 이동하세요.
- 세금 구성을 검토하세요. 항목별 세금을 사용하는 경우 모든 Shopify 세금 요율에 해당 QuickBooks 세금 코드가 매핑되어 있는지 확인하세요.
- QuickBooks가 세금 계산을 자동으로 처리하도록 하려면 동일한 탭에서 QuickBooks 자동 판매세로 전환하세요.
- 수동 동기화 » 주문에서 영향을 받은 주문을 다시 동기화합니다.
6. 잘못된 계정
의미: 동기화 구성에서 참조된 QuickBooks 계정(예: 수입 계정, 매출 원가 계정 또는 청산 계정)이 QuickBooks에 더 이상 존재하지 않거나 이름이 변경되거나 삭제되었습니다.
해결 방법:
- QuickBooks에 로그인하고 계정 원장을 확인하여 활성 계정을 확인하세요.
- LedgerPort에서 Sync Config로 이동하여 결제, 제품 및 회계 탭에서 오래된 계정 참조가 있는지 검토하세요.
- 영향을 받는 필드를 올바른 활성 계정을 가리키도록 업데이트하세요.
- 영향을 받는 레코드를 수동 동기화에서 다시 동기화하세요.
7. QuickBooks API 시간 초과
의미: LedgerPort가 QuickBooks에 요청을 보냈지만 제시간에 응답을 받지 못했습니다. 이는 일반적으로 구성 문제가 아니라 QuickBooks 측의 일시적인 속도 저하로 인해 발생합니다.
해결 방법:
몇 분 기다렸다가 동기화를 다시 시도하세요.
- 수동 동기화로 이동하여 실패한 엔티티 유형(주문, 제품 등)을 선택하세요.
- 영향을 받는 레코드를 선택하고 선택 항목 동기화를 클릭하세요.
여러 시간 동안 계속 시간 초과가 발생하는 경우 QuickBooks Online 상태 페이지를 확인하여 알려진 서비스 문제가 있는지 확인하십시오.
8. 속도 제한 초과
의미: LedgerPort가 짧은 시간 내에 QuickBooks API에 너무 많은 요청을 보냈습니다. QuickBooks는 속도 제한을 적용하며, 이 오류는 일시적으로 제한에 도달했음을 의미합니다. 한 번에 많은 양의 주문을 동기화할 때 가장 흔하게 발생합니다.
해결 방법:
구성 변경이 필요하지 않습니다. LedgerPort는 속도 제한된 요청을 자동으로 다시 시도합니다. 대량 수동 동기화를 수행하는 경우 15~30분 정도 기다렸다가 로그를 다시 확인하십시오. 속도 제한 기간이 재설정되면 일반적으로 레코드가 자체적으로 동기화됩니다.
9. 주문 보류 중
의미: 주문이 Shopify에 존재하지만 구성된 동기화 트리거 조건을 충족하지 않아 아직 동기화가 트리거되지 않았습니다. 예를 들어, 동기화가 결제된 주문에 대해서만 실행되도록 설정되어 있고 주문이 아직 결제 대기 중인 경우, 결제가 처리될 때까지 보류 상태로 유지됩니다.
해결 방법:
일반적으로 예상되는 동작입니다. 동기화 트리거 설정을 확인하십시오:
- 동기화 구성 » 주문으로 이동하십시오.
- 동기화 트리거로 설정된 결제 상태 및 배송 상태를 검토하십시오.
- 주문이 동기화되었어야 하는 경우, Shopify에서 해당 주문의 상태가 트리거 기준과 일치하는지 확인하십시오.
주문 상태에 관계없이 즉시 동기화하려면 수동 동기화 » 주문으로 이동하여 주문을 찾은 다음 수동으로 동기화하십시오.
10. 필수 필드 누락
의미: QuickBooks에서 거래를 생성하는 데 필요한 정보가 주문 또는 레코드에 누락되었습니다. 일반적인 예로는 청구 주소 누락, 빈 고객 이름 또는 가격이 없는 제품 등이 있습니다.
해결 방법:
- Shopify에서 주문을 열고 누락된 정보(고객 이름, 주소 등)를 추가하십시오.
- LedgerPort로 돌아가서 수동 동기화 » 주문으로 이동하십시오.
- 주문을 찾아 다시 동기화하십시오.
문제가 QuickBooks 측에 있는 경우(예: 필수 사용자 지정 필드), QuickBooks에 로그인하여 거래 템플릿에 LedgerPort가 채울 수 없는 필수 필드가 없는지 확인하십시오.
위의 방법으로 오류가 해결되지 않으면 감사 로그의 전체 오류 메시지가 일반적으로 특정 원인을 가리킵니다. 실패한 레코드의 자세한 오류 메시지를 찾고 읽으려면 감사 로그 읽기 및 필터링을 참조하십시오.
로그 보존 알림: 감사 로그를 볼 수 있는 기간은 요금제에 따라 다릅니다. 무료는 7일, Growth는 30일, Scale은 90일, Enterprise는 무기한으로 로그를 보관합니다. 이전 로그에 액세스하려면 요금제를 업그레이드할 수 있습니다.
문제가 계속 해결되지 않으면 영향을 받은 주문 번호와 감사 로그의 오류 스크린샷을 첨부하여 문의해 주십시오. 저희 지원팀에서 도와드릴 수 있습니다.
