SR013

Severity: error

Summary: ref value missing dot notation (expected resource.field)

What this means

A field’s ref: value does not contain a dot. Shaperail requires the format resource_name.field_name so it can identify both the target table and the target column unambiguously.

Example that triggers this

resource: items
version: 1
schema:
  id:     { type: uuid, primary: true, generated: true }
  org_id: { type: uuid, ref: organizations }

How to fix it

Use resource_name.field_name format for the ref value:

org_id: { type: uuid, ref: organizations.id }