1. 3PL SCM
  2. Data model
Reference

The tables behind 3PL SCM

3PL SCM ships with 13 tables, grouped here by the feature that uses them. Every record your team works with lives in one of them, and you can add fields and tables in Proto.

Tables
13
Features
7, plus shared settings
Change it
Add fields and tables in Proto

How the model is organised

Client scope

Organizations link team members, stock items and storage locations. Users link to team members.

Request and issue

Stock requests link organization, owner, item and location. Stock reservations claim item and location, with an optional lot.

Stock history

Stock lots belong to items. Stock movements link the request, item and location; a movement can reference a lot and another movement it reverses.

Review and billing

Client storage charges, review decisions, record attachments and operation receipts link to the parent stock requests record.

Every table, by feature

Client scope

5 tablesAbout this feature
  • Organizations

    Client organizations whose stock is held and billed.

  • Team members

    Staff members of client organizations and the 3PL operator.

    Linked to Organizations, Users
  • Stock items

    Client stock item master with base unit and lot tracking.

    Linked to Organizations
  • Stock lots

    Lot and expiry evidence for lot-tracked stock items.

    Linked to Stock items
  • Storage locations

    Warehouse and storage sites where client stock is held.

    Linked to Organizations

Stock requests

6 tablesAbout this feature
  • Stock requests

    Client stock requests that carry the operational lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Record attachments

    Evidence files attached to a stock request.

    Linked to Stock requests, Team members
  • Review decisions

    Independent review decisions recorded against a source revision.

    Linked to Stock requests, Team members
  • Organizations

    Client organizations whose stock is held and billed.

  • Stock items

    Client stock item master with base unit and lot tracking.

    Linked to Organizations
  • Storage locations

    Warehouse and storage sites where client stock is held.

    Linked to Organizations

Lot and availability

5 tablesAbout this feature
  • Stock items

    Client stock item master with base unit and lot tracking.

    Linked to Organizations
  • Stock lots

    Lot and expiry evidence for lot-tracked stock items.

    Linked to Stock items
  • Stock movements

    Posted signed stock movements appended by the movement workflow.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Stock reservations

    Reservations that claim eligible free stock without changing on-hand.

    Linked to Stock requests, Stock items, Storage locations, Stock lots
  • Storage locations

    Warehouse and storage sites where client stock is held.

    Linked to Organizations

Reservations

6 tablesAbout this feature
  • Stock reservations

    Reservations that claim eligible free stock without changing on-hand.

    Linked to Stock requests, Stock items, Storage locations, Stock lots
  • Stock requests

    Client stock requests that carry the operational lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Stock movements

    Posted signed stock movements appended by the movement workflow.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Stock items

    Client stock item master with base unit and lot tracking.

    Linked to Organizations
  • Stock lots

    Lot and expiry evidence for lot-tracked stock items.

    Linked to Stock items
  • Storage locations

    Warehouse and storage sites where client stock is held.

    Linked to Organizations

Movement evidence

5 tablesAbout this feature
  • Stock movements

    Posted signed stock movements appended by the movement workflow.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Stock requests

    Client stock requests that carry the operational lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Stock lots

    Lot and expiry evidence for lot-tracked stock items.

    Linked to Stock items
  • Stock reservations

    Reservations that claim eligible free stock without changing on-hand.

    Linked to Stock requests, Stock items, Storage locations, Stock lots
  • Operation receipts

    Durable receipts for every guarded operation, keyed for safe retries.

    Linked to Stock requests

Storage charges

6 tablesAbout this feature
  • Client storage charges

    Client storage statements submitted for independent review and approval.

    Linked to Stock requests, Organizations
  • Stock requests

    Client stock requests that carry the operational lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Organizations

    Client organizations whose stock is held and billed.

  • Record attachments

    Evidence files attached to a stock request.

    Linked to Stock requests, Team members
  • Review decisions

    Independent review decisions recorded against a source revision.

    Linked to Stock requests, Team members
  • Operation receipts

    Durable receipts for every guarded operation, keyed for safe retries.

    Linked to Stock requests

Review and reconciliation

6 tablesAbout this feature
  • Review decisions

    Independent review decisions recorded against a source revision.

    Linked to Stock requests, Team members
  • Operation receipts

    Durable receipts for every guarded operation, keyed for safe retries.

    Linked to Stock requests
  • Record attachments

    Evidence files attached to a stock request.

    Linked to Stock requests, Team members
  • Stock requests

    Client stock requests that carry the operational lifecycle.

    Linked to Organizations, Team members, Storage locations, Stock items
  • Stock movements

    Posted signed stock movements appended by the movement workflow.

    Linked to Stock requests, Stock items, Storage locations, Stock movements
  • Client storage charges

    Client storage statements submitted for independent review and approval.

    Linked to Stock requests, Organizations

Shared and settings

1 table
  • Users

    Users

    Linked to Users

Keys and references

Keep organization codes and item SK us distinct within the operating scope. A request record number identifies source work; its revision protects a guarded decision. Movement source effect keys and receipt operation keys identify effects across retries. Retain original movement IDs so compensating movements can use Reverses.

Migration order

  1. Import Organizations and Users, then team members.
  2. Import stock items and storage locations for their organizations.
  3. Import stock lots for relevant items.
  4. Import stock requests with organization, owner, item and location references.
  5. Import record attachments, review decisions and client storage charges against parent requests.
  6. Import stock reservations, posted stock movements and operation receipts with source identities and links. Reconcile signed quantities before use.

Set up 3PL SCM your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started