> ## Documentation Index
> Fetch the complete documentation index at: https://help.owlery.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SOS Inventory Configuration Reference

> SKU source, display-name, synchronization, exact-refresh, and search behavior.

SOS Inventory has a focused configuration surface. Owlery inspects your item records and recommends an override only when the standard mapping does not match your operating model.

| Area                     | Available controls                                                                   |
| ------------------------ | ------------------------------------------------------------------------------------ |
| SKU source               | Use the standard `sku` field or another available item field                         |
| Display name             | When `name` is the SKU, choose the first usable descriptive field as the item label  |
| Full or incremental sync | Run a complete synchronization or retrieve changed orders                            |
| Exact refresh            | Refresh one Owlery order from its SOS source ID                                      |
| Search                   | Search supported fields such as order number, comment, customer PO, or customer name |

## SKU mapping

Owlery uses `sku` by default. Some accounts use another item field, such as `name`, as the operational SKU. Owlery can select that field without rewriting existing item records.

When `name` becomes the SKU, Owlery chooses a separate display name from the first populated full name, description, purchase description, or original name. The selected source field must be available on the SOS item response.

## Authentication details

An authorized user grants Owlery access through SOS Inventory OAuth 2.0. The account needs read permission for Items, units, sales orders, purchase orders, transfers, locations, customers, and vendors.

Owlery coordinates token refresh so concurrent requests do not replace the same refresh token.

## Read-only boundary

The current connector does not write back to SOS Inventory. If outbound updates are required, Owlery documents the event, target record, fields, and API behavior before proposing an extension.