Uniware scripts

Interactive and scripted helpers for Unicommerce / Uniware (OMS, inventory exports, picklists, handling units, pick buckets).

Install

From this directory:

pip install -e .

This installs the uni command (see pyproject.toml).

Credentials & state

1. Copy uniware/secrets.example.py to uniware/secrets.py (gitignored) and set USERS passwords. Keys are user names (sushant, aditya, alpha).

2. Cached bearer tokens and last-used module + user are stored under ~/.uniware/state.json.

3. Pick a module (tenant + facility + allowed users) via interactive menu, uni config --select, or --module / --user on the CLI.

Optional OAuth client override: edit Settings.resolve / config.py if your tenant uses a non-default client id.

Usage

• Interactive menu (default):

  uni
  # or
  python uniware.py
  # or
  python -m uniware

• Global options (apply to subcommands):

  uni --module picking --user aditya order --code SO123 --sku sku2:3

• Subcommands:

  uni config
  uni config --all
  uni config --select
  uni auth refresh
  uni auth token
  
  uni inv -n 80 --good --min 200
  uni inv -i
  
  uni order --code SO123 --sku sku2:3 --b2b
  uni order --multi -n 2 --code A1 --code A2 --sku x:1
  
  uni allocate SO1 SO2
  uni picklist SO1 SO2 --b2c
  uni picklist --sku "sku1 2; sku2; sku3 4" --code SO99
  
  uni enable-handheld
  uni enable-handheld --b2c
  
  uni hu
  uni hu --free
  uni hu --all
  uni hu print -n 5
  uni hu print --hu BOX001,BOX002
  uni hu create -n 5
  
  uni pb
  uni pb -n 50
  uni pb --all
  uni pb --every-status
  uni pb create -n 5

• Module:

  python -m uniware

Layout

• uniware/cli.py — Typer entry + interactive menu wiring
• uniware/config.py — tenants, modules, Settings.resolve
• uniware/store.py — ~/.uniware/state.json
• uniware/workflows.py — orchestration only (no Rich)
• uniware/api/ — HTTP calls via UniwareClient
• uniware/prompts.py / uniware/views.py — prompts and Rich tables/spinners

Legacy single-file behaviour is preserved through the shim uniware.py.