item_reconciliation API

完整接口目录 · 库存与物品用法 · 工具包下载

模块说明

Compare retained native slot observations; never submit/replay or settle a receipt.

Fingerprints are opaque server digests of typed protocol stacks. JSON item values
are display-only and must not be reconstructed into a replacement item.

compare_transfer

def compare_transfer(
    *,
    source_before,
    destination_before,
    source_after,
    destination_after,
    count,
)

SDK 说明：

Return only whether observed attribute/quantity deltas match one transfer.

Caller must retain original operation/session IDs and collect independent, fresh
before/after observations of the same slots. Cache/ACK data, concurrent activity,
missing observations or a reconnect cannot prove causality. A True result does
not change an unknown receipt or authorize resubmission, refunds or settlement.

compare_container_unchanged

def compare_container_unchanged(
    *,
    before,
    after,
    changed_slots,
    session_before,
    session_after,
)

SDK 说明：

Check native-content shape and slots outside the declared operation.

Host labels are an additional namespace check. Native continuity uses the
adapter-bound connection_id/connected_at captured before opening and checked
after close, never the supplied Host session. Old/unbound snapshots fail.
This complements compare_transfer; it does not check the declared changed
slots, inventory cache, action causality or transactional settlement.