Logistics and warehouse on Databricks

Cycle count exception on Databricks

Turns a count that differs from the book quantity by more than the tolerance into a case: recount, investigate the movements, post the adjustment from the floor.

SCREENSDATA HANDLERSDATABRICKS · READ IN PLACES01 Count listS02 DifferencesS03 InvestigationS04 RecountS05 PostingS06 Boarddh_stock_positionStock positionsilver.stock_position · gold.stock_dailydh_goods_receiptGoods receiptsilver.goods_movementdh_material_masterMaterial mastersilver.materialdh_deliveryDeliverysilver.deliveryWRITE BACK TO DATABRICKSStock position → MERGE INTO gold.lima_app_decisionsrows stay in Databricks · access rules applied at read time · each write acknowledged and logged
The screens of the app, the data handler behind each, and the Databricks object it reads in place. Writes below the line go through MERGE into a Lima-owned table, with the operational write to the ERP of record.
4
objects read in place from Databricks
catalogue
6
screens on those rows
catalogue
4 days
to production-grade
estimate
1
objects written back
catalogue
0
rows copied to build it
product
What the app reads

The Databricks objects behind each handler

Delta tables in Unity Catalog are read in place through a SQL warehouse: the app sends only the filter and the columns it needs. The Backbone landing model (bronze, silver and gold) is the usual source, so history and aggregates are already prepared and lineage is registered in Unity Catalog.

ObjectRead fromFields the app usesFreshness
Stock positionsilver.stock_position · gold.stock_dailyon_hand_qty (on hand) · stock_value (value) · material_id (material) · plant (plant)prepared by the Backbone; refreshed on its schedule
Goods receiptsilver.goods_movementdocument_id (document) · po_number (po) · material_id (material) · qty (qty)prepared by the Backbone; refreshed on its schedule
Material mastersilver.materialmaterial_type (type) · material_id (id) · description (desc) · plant (plant)prepared by the Backbone; refreshed on its schedule
Deliverysilver.deliverydelivery_id (number) · customer_id (customer) · planned_gi_date (planned gi) · actual_gi_date (actual gi)prepared by the Backbone; refreshed on its schedule
The trigger

The start criterion in Databricks's own fields

In plain words: A count entered on the mobile screen that differs from the book quantity by more than the tolerance for the material's value class; illustrative tolerances are 2 percent in quantity or 250 in value.

The criterion runs in Databricks through the data handler, so only the matching rows return. The editor shows the rows it selects, and their count, as it is written.

# start criterion in Databricks fields
abs(counted_qty - on_hand_qty) > tolerance_qty(material_type) or abs(counted_qty - on_hand_qty) * unit_value(stock_value) > 250

# the same criterion in canonical fields
abs(counted_qty - {stock.on_hand}) > tolerance_qty({material.type}) or abs(counted_qty - {stock.on_hand}) * unit_value({stock.value}) > 250
What the app writes back

Through MERGE and the system of record

Decisions are recorded in a Lima-owned gold table with MERGE INTO, so notebooks and dashboards see them next to the history. The operational write goes to the system of record through its released interface, and the app records the acknowledgement. For this app the operational change (difference posted as an inventory adjustment through the goods movement interface (movement types 701 and 702) with reason code and cost center, or a transfer between bins when the goods are found elsewhere) goes to SAP S/4HANA or Oracle Fusion through its released interface, and the pair pages for those systems show the exact call.

ObjectWhat changesInterface
Stock positiondifference posted as an inventory adjustment through the goods movement interface (movement types 701 and 702) with reason code and cost center, or a transfer between bins when the goods are found elsewhereMERGE INTO gold.lima_app_decisions
Acknowledged and logged

Each write stores the identifier Databricks returns beside the decision, the person and the time, so the log answers who changed what, and the reconciliation shows it arrived.

Access and prerequisites

What is in place before the first build

Unity Catalog grants and row filters are mapped to Lima access policies once, so a person sees the same rows in the app that they see in a notebook.

  • A service principal with SELECT on the silver and gold schemas and MODIFY on the Lima decision schema
  • A SQL warehouse (a small serverless warehouse serves most screens)
  • The Backbone landing model in place for the objects the app uses, or your own silver tables registered
  • The system of record connected for the operational write
Register the handlers4 objects from the catalog; each shows its rows at once.
Why the lake

History and aggregates, read where they land

This app reads stock position from Databricks because the screens need history at scale: months of rows, aggregates by period, several versions. The Backbone lands the objects in the conformed model and refreshes them on a schedule, and the handler reads them in place with the filter and the columns pushed down. The person's grants in Databricks decide what they see.

The operational rows the person acts on can come live from the ERP in the same app: one handler per object per system, and a screen that shows both.

Readsconformed and history tables, in placeDatabricks
Decision recordMERGE into a Lima-owned tablebeside the history
Operational writeto the ERP of record through its interfaceacknowledged
GrantsDatabricks roles and row policies honouredat read time
Nearby

This app on other systems, and other apps on Databricks

Cycle count exception on

Other apps on Databricks

Terms on this page

Cycle countCounting a small set of bins each day, so that every location is counted several times a year.
ToleranceThe difference in quantity or value below which a count is accepted as it is.
Read in placeThe rows stay in Databricks; the handler sends the filter and the columns and Databricks returns the matching rows.
Questions

Does this app copy data out of Databricks?

The screens read through handlers that leave the rows in Databricks. The conformed tables it reads were landed there by the Backbone from the ERP; the app reads them there.

What does Databricks need to allow?

The prerequisites above: an integration identity with read rights on the objects listed and write rights on the interfaces named, connectivity, and the scopes agreed with the process owner.

Can I run it on another system as well?

Yes. The screens, criteria and roles stay; the handlers are re-bound to the other system's objects, and the app's other system pages show them.

See this app on your data

Bring the process and the systems it touches. In the first session we register the data handlers, draw the levels or the lanes and run the first screen on your live rows.