kf ingestion
Open, submit, and commit ingestion runs and source authorities.
kf ingestion commit-batch
Apply a staged ingestion batch to inventory truth.
Apply a staged ingestion batch to inventory truth. Writes inventory_levels, movements, and channel_availabilities inside one transaction.
| Flag | Required | Description |
|---|---|---|
--tenant <id> | yes | Target tenant id. |
--environment <id> | no | Target environment id; defaults to the active profile environment. |
--actor-type <type> | yes | Actor type (USER, SYSTEM, CONNECTOR, AGENT, SERVICE). |
--actor-id <id> | yes | Actor id. |
--idempotency-key <key> | no | Idempotency key for safe retries. Generated when omitted. |
--ingestion-run-id <value> | yes | Ingestion run id. |
--ingestion-batch-id <value> | yes | Ingestion batch id. |
Example
kf ingestion commit-batch --tenant tnt_demo --actor-type USER --actor-id usr_sam --ingestion-run-id <value> --ingestion-batch-id <value>kf ingestion start-run
Open an ingestion run so a connector can stream batches against it.
Open an ingestion run so a connector can stream batches against it. Used for snapshot, delta, event, and replay imports from external systems.
| Flag | Required | Description |
|---|---|---|
--tenant <id> | yes | Target tenant id. |
--environment <id> | no | Target environment id; defaults to the active profile environment. |
--actor-type <type> | yes | Actor type (USER, SYSTEM, CONNECTOR, AGENT, SERVICE). |
--actor-id <id> | yes | Actor id. |
--idempotency-key <key> | no | Idempotency key for safe retries. Generated when omitted. |
--connector-key <value> | yes | Connector key. |
--source-system <value> | yes | Source system. |
--run-type <value> | yes | Run type. |
--observed-from <value> | no | ISO date/time |
--observed-to <value> | no | ISO date/time |
--checkpoint-ref <value> | no | Checkpoint ref. |
--raw-payload-ref <value> | no | Raw payload ref. |
--summary <value> | no | Summary. |
Example
kf ingestion start-run --tenant tnt_demo --actor-type USER --actor-id usr_sam --connector-key <value> --source-system <value> --run-type <value>kf ingestion submit-batch
Submit a normalized batch of records to a running ingestion run.
Submit a normalized batch of records to a running ingestion run. Records are staged for commit; no inventory state is mutated yet.
| Flag | Required | Description |
|---|---|---|
--tenant <id> | yes | Target tenant id. |
--environment <id> | no | Target environment id; defaults to the active profile environment. |
--actor-type <type> | yes | Actor type (USER, SYSTEM, CONNECTOR, AGENT, SERVICE). |
--actor-id <id> | yes | Actor id. |
--idempotency-key <key> | no | Idempotency key for safe retries. Generated when omitted. |
--ingestion-run-id <value> | yes | Ingestion run id. |
--batch-ref <value> | no | Batch ref. |
--classification <value> | yes | Classification. |
--records <value> | yes | Records. |
--summary <value> | no | Summary. |
Example
kf ingestion submit-batch --tenant tnt_demo --actor-type USER --actor-id usr_sam --ingestion-run-id <value> --classification <value> --records <value>