Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ocular.dev/llms.txt

Use this file to discover all available pages before exploring further.

Ocular connects to Unicommerce (Uniware) using basic-auth credentials plus your tenant’s account code. The account code is the tenant subdomain in your Uniware URL.

What you need

Username, password, account code, and the facility codes you want to sync.

What it unlocks

SKU master across channels, inventory-aware reporting, returns and status reconciliation in the Fulfilment data model.
Unicommerce connector placeholder

​
Step 1 · Find your Account Code

Open Uniware

Log in to Uniware in your browser.

Read the URL

The address bar reads https://ACCOUNT_CODE.unicommerce.com/....

Copy the tenant string

Everything before .unicommerce.com is your Account Code. Copy it exactly — it is case-sensitive.

​
Step 2 · Create (or pick) an API-capable user

Open Users

Go to Settings (gear icon) → Users.

Add a dedicated user (recommended)

Click Add to create a fresh user (e.g., ocular_api) or select an existing one.

Set credentials and role

  • Enter a unique Username.
  • Set a strong Password.
  • Assign the Admin role, or explicit access to the facilities whose data you want to pull.
  • Click Save.
You can reset the password anytime from the same Users page. Older guides may mention API User under Integration — newer Uniware accounts use the standard user list, and both work as long as the user has the required permissions.

​
Step 3 · Plug the credentials into Ocular

Open the connector form

In Ocular, open Data Management → Connectors → Add connector → Unicommerce.

Fill the fields

Username

The Uniware username you just created or picked.

Password

The matching password.

Account Code

The tenant string from Step 1 (case-sensitive).

Start Date

YYYY-MM-DD — how far back to pull data.

Lookback Days

Default 30. Bump higher if returns or status changes commonly land further out.

Facility Codes

Click Fetch Facilities to pull every facility in your account, then pick which ones to sync. Leave empty to sync all.

Create the connector

Click Create Connector. Ocular sends a Basic-Auth request to Uniware’s /services/rest/v1/auth endpoint; on success you’ll see Connection successful.Click Create — credentials are encrypted in Ocular’s vault and the first incremental sync starts within minutes.

​
Troubleshooting

Re-check the account code (case-sensitive) and confirm the user is still active with a non-expired password. Reset the password in Uniware and retry.
The selected user must have explicit access to every facility you want to sync, or be an Admin. Open the user in Uniware and verify the facility list, then re-run Fetch Facilities in Ocular.
Increase Lookback Days above 30 — returns can be triggered several days after the original order. A 60- or 90-day lookback is common for brands with long return windows.
For ticket-writing format when filing a connector issue, see Working with the Ocular team → Connector-not-working tickets.