Suppliers

What it is

Supplier master data — name, currency, default lead time, and target stock days. Suppliers provide the defaults for procurement math: a Product without its own lead_time_days / target_stock_days inherits its supplier’s default_* values. Purchase Order Lines and products reference suppliers via supplier_id. Fully editable in the app; also ingest-enabled for syncing from an external system.

How it gets data

Ingest-enabled — POST /api/ingest/suppliers (see Ingest API):

POST /api/ingest/suppliers
Authorization: Bearer pk_...
Content-Type: application/json

One JSON record per request; unknown fields are dropped.
Idempotent upsert on (tenant_id, external_id) — use a stable supplier code as external_id.
tenant_id / workspace_id come from the API key context, never from the body.

Minimal example payload:

{
  "external_id": "SUP-001",
  "name": "Atelier Milano",
  "currency": "EUR",
  "default_lead_time_days": 60,
  "default_lead_time_buffer_days": 14,
  "default_target_stock_days": 120
}

Fields

Field	Label	Type	Writable	Description
`name`	Name	text	✓	Supplier display name
`external_id`	External ID	text	✓	Stable supplier code — the upsert key
`currency`	Currency	text	✓	Default purchasing currency
`default_lead_time_days`	Lead Time (days)	number	✓	Default lead time, inherited by products without their own
`default_lead_time_buffer_days`	Buffer (days)	number	✓	Default buffer on top of the lead time
`default_target_stock_days`	Target Stock (d)	number	✓	Default target coverage after replenishment
`comment`	Comment	text	✓	Free-text note (payment terms, contacts, quirks)
`id`	ID	text	read-only	Internal row id — referenced by `products.supplier_id` and `purchase_order_lines.supplier_id`
`created_at`	Created	datetime	read-only	Row creation time

Like every workspace table, suppliers also carry the system columns tenant_id, workspace_id, and updated_at — set automatically, never sent by integrations.

Query it

{
  "method": "tools/call",
  "params": {
    "name": "data_query",
    "arguments": {
      "view_slug": "suppliers",
      "select_fields": ["name", "currency", "default_lead_time_days", "default_target_stock_days"],
      "limit": 50
    }
  }
}

AI Operating Guide

Vertical Intelligence

Getting Started

Governance

Resources

Sales & Commerce

Procurement

Marketing & Outreach

What it is

How it gets data

Fields

Query it

​What it is

​How it gets data

​Fields

​Query it

What it is

How it gets data

Fields

Query it