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

  1. Go to

    Settings → Integrations → Connections

  2. Click the ➕ (Add) button

  3. Select Invoice123 as the integration type

  4. 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


  5. 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

  1. Go to

    Employees → Notifications → Periodic Notifications

  2. Click the ➕ (Add) button

  3. Select an Action

    • Choose: Invoice123 synchronization action


  4. Click Create


3. Configure Synchronization Frequency

After creating the periodic notification:

  1. Open the newly created Periodic Notification

  2. Select how often the synchronization should run, for example:

    • Every 5 minutes

    • Every 15 minutes

    • Every 30 minutes

    • Hourly


  3. Save the configuration

✅ The system will now automatically run Invoice123 synchronization at the selected interval.


4. What Happens During Synchronization

When the action runs:

  1. The system finds completed orders within the selected time period

  2. 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}/quantity
  1. If 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.0
  • Required API permission:

product:store
  • SKU 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