This is not a general fulfillment or receipt write-back feature for every carrier. Owlery documents any additional outbound workflow separately.
Supported behavior
When the supported tender workflow returns a tracking number, Owlery can:- Read the current Katana sales-order rows and quantities
- Create a
PACKEDfulfillment when none exists - Add the carrier tracking number, tracking URL, and carrier name
- Update only the tracking fields on one existing fulfillment
- Treat already-matching tracking data as a successful no-op
- Record a separate success or failure for every Katana order in a consolidated shipment
Safe writes by design
Owlery does not overwrite a different tracking number or guess when Katana returns multiple fulfillments. If a create request fails after Katana may have accepted it, Owlery queries the fulfillment again before returning an error. This recovery check reduces duplicate records after a timeout.- Fulfillment creates include the source sales-order rows and quantities.
- Existing records receive tracking-only updates.
- Per-order audits preserve actionable results.
- Matching tracking values do not generate unnecessary updates.