Tools & integrations

Purpose-specific tools replace unrestricted database access

Each tool has an authorized purpose, explicit input, authoritative source, deterministic failure behavior and audit output.

ToolPurposeKey control
get_order(orderId)Retrieve authoritative order header, customer, status, dates and totalsUnique order resolution
get_order_lines(orderId)Retrieve ordered, allocated, fulfilled and outstanding quantitiesCurrent line versions
check_inventory(sku)Return warehouse-level on-hand, reserved, allocated and available quantitiesAvailable calculated by service
get_warehouse_allocation(orderId)Resolve line-to-warehouse allocations and stateNo mutation
get_incoming_stock(sku)Retrieve confirmed relevant purchase orders and expected datesFuture stock labelled future
get_customer_rules(customerId)Retrieve effective partial shipment, backorder and substitution policyEffective-date validation
get_order_history(orderId)Retrieve meaningful holds, releases and status changesRead-only history
run_order_exception_rules(orderId)Run versioned deterministic exception rulesModel does not recreate rules
prepare_resolution(orderId,type)Create proposed action with evidenceNo execution
execute_approved_resolution(actionId)Execute bounded approved actionAuthorization + revalidation + idempotency
Tool contract standard: Purpose → Authorized Role → Input → Authoritative Source → Processing → Output → Validation → Failure Behaviour → Audit Fields.
Reference artifact SOAI-E02 Operating control model

Order-to-fulfilment authority and control matrix

Maps Orders, Inventory, Warehouse, Purchase Orders, customer rules and fulfilment actions to permitted AI assistance and retained human authority.

Read boundary
Role + resource scope
Write boundary
Separate action tools
Approval
Required for protected action
Revalidation
Required before execution
Execution trace SOAI-E04 Execution trace

SO-12547 order exception trace

Synthetic trace showing five fully allocatable lines and one WH-4821 line with 12 ordered, 8 allocatable and a four-unit shortfall, plus confirmed incoming stock and a partial-shipment rule.

Order
SO-12547
SKU
WH-4821
Ordered
12
Allocatable
8
Shortfall
4
Incoming PO
PO-8841 · 20 · expected 19-Sep
Partial shipment
Permitted
Write action
NONE

Primewayz AI enablement for enterprise operations

Explore a governed AI workflow around your order, inventory, warehouse and fulfilment systems.

Discuss an AI-Enabled Order Workflow
TO TOP