Bukku Sync
Bukku sync keeps accounting records aligned with platform invoices and payments.
How to Sync to Bukku
- Open the invoice or payment record.
- Click Sync Bukku.
- Wait for the toast message.
- If sync fails, open the sync message.
- Correct missing account, contact, invoice, or allocation details.
- Retry sync.
Sync Scope
Bukku sync should cover:
- Contacts
- Invoices
- Payments
- Payment allocations where supported
- Income account mapping
- Deposit account requirements where required by Bukku
Income Account
Product setup should use the Bukku income account configured for the course, bundle, membership, or mentorship. Manual account ID entry should not be required in normal admin screens.
Payment Sync
Payment sync requires:
- Contact ID
- Payment date
- Currency
- Amount
- Payment method
- Deposit account where required by Bukku
- Reference number
- Remarks
- Allocations
When sync succeeds or fails, show a toast and record status.
Failure Handling
Common Bukku failures:
| Failure | Check |
|---|---|
| Missing deposit account | Verify account mapping sent in payload |
| Invalid contact | Verify Bukku contact ID |
| Invoice mismatch | Verify invoice number and Bukku invoice ID |
| Allocation error | Verify invoice balance and payment unallocated balance |
Finance should be able to retry failed sync jobs after correcting the underlying issue.