Invoice123
Invoice123 Integration – How It Works
This integration synchronizes product stock quantities with Invoice123 automatically, based on completed sales in the system.
The synchronization runs periodically, according to a schedule you define.
1. Connect Invoice123
Get the api key from the invoice123:
https://help.invoice123.com/lt/article/kaip-susieti-saskaita123-su-eprekybos-sistemomis-api-c4vpb2/
Step-by-step
Go to
Settings → Integrations → Connections
Click the ➕ (Add) button
Select Invoice123 as the integration type
Enter your Invoice123 API token
The token must be generated in the Invoice123 API module
The API key must have product:store and product:index permissions
Click Create
✅ The Invoice123 connection is now saved
ℹ️ The system automatically stores:
Integration type: invoice123
Name: invoice123
API token (securely)
No additional configuration is required.
2. Enable Automatic Synchronization
Invoice123 stock synchronization is executed via Periodic Notifications.
Step-by-step
Go to
Employees → Notifications → Periodic Notifications
Click the ➕ (Add) button
Select an Action
Choose: Invoice123 synchronization action
Click Create
3. Configure Synchronization Frequency
After creating the periodic notification:
Open the newly created Periodic Notification
Select how often the synchronization should run, for example:
Every 5 minutes
Every 15 minutes
Every 30 minutes
Hourly
Save the configuration
✅ The system will now automatically run Invoice123 synchronization at the selected interval.
4. What Happens During Synchronization
When the action runs:
The system finds completed orders within the selected time period
For each sold product:
The product SKU is taken from the product code
The system retrieves the current stock quantity from Invoice123
The sold quantity is subtracted
The new quantity is sent to Invoice123 using:
PATCH /api/v1.0/products/sku/{sku}/quantityIf a product cannot be synchronized:
The error reason is saved for debugging
Other products continue syncing
5. Technical Notes (for reference)
Authentication: Bearer Token
API Base URL:
https://app.invoice123.com/api/v1.0Required API permission:
product:storeSKU source: Product code
Stock update method: PATCH
Quantity is always sent as an absolute value
6. Common Issues
Product not found
→ Ensure the SKU in Invoice123 matches the product code exactly
Unauthorized (401)
→ Check that the API token is valid and has product:store permission
No synchronization happening
→ Verify that:
Periodic notification is enabled
Orders are marked as completed
Invoice123 connection exists
7. Get all product from the invoice 123
to integrate with SmartOn system you need that the code in invoice 123
to be the same like code in the article in SmartOn
8. Turn on Allow negative warehouse balance
The SmartOn will not be able to writeoff the quantity to - if this option is not turned on
English