When exporting invoices from Uku to your bookkeeping software, sometimes errors can occur that prevent successful transfer. These issues are typically related to integration connectivity, customer setup, or product configuration problems.
1. Check Integration Connection
First, verify that your integration is active and working properly:
Method 1 - Through Settings:
Go to Settings
Find your Integration name (e.g., e-conomic, Xero, etc.)
Check the API keys/ID inserted.
Another option to click "Import" to check that UKU can request information details from your accounting software.
Method 2 - Through Client Menu:
Open the Client menu
From custom fields, select Integration
Check whether there is a key icon or the name of the integration.
If the connection test fails, you'll need to reconnect your integration before proceeding.
Read here how to connect with integration.
2. Verify Customer Setup
Check how the customer was created in your system:
Was the customer created manually? If yes, this might cause export issues
Was the customer imported from the bookkeeping software? This is the preferred method for seamless integration
3: Review Invoice Lines and Products
The most common cause of export failures is incorrect product information:
Check each invoice line:
Ensure every line is linked to a product
Verify that products have correct codes set
Confirm that products were exported from your bookkeeping software (not created manually in Uku)
Product code requirements: Your bookkeeping software expects the correct product code to be set for exports to work properly. If a product was created manually in Uku instead of being imported from your bookkeeping software, it may lack the proper integration codes.
Step 4: Common Solutions
Re-import the customer from your bookkeeping software if they were created manually
Update product codes to match those in your bookkeeping software
Replace manually created products with ones imported from your bookkeeping software
Check product mapping to ensure all items have the required integration fields
Step 5: Test the Export Again
After making the necessary corrections:
Test the integration connection again
Attempt to export the invoice
Monitor for any new error messages
Still Having Issues?
If the problem persists after following these steps, contact Uku support with the following information:
The specific error message you received
Details about the steps you've already taken
Information about your integration setup
The invoice number that's failing to export
Uku support can provide additional troubleshooting assistance and help identify any integration-specific issues that may be causing the export failure.