Overview
Suppliers import creates or updates supplier master records for your organization. Today the endpoint validatesexternalId and uses it as the supplier code.
Quick Start
- Build a
suppliers[]payload. - POST to
/api/import/suppliers. - Poll
/api/import/status/[jobId]for completion.
Field Reference
| Better Data Field | Type | Required | Example | Description | Source System Analog |
|---|---|---|---|---|---|
externalId | string | YES | SUP-ACME | Supplier key used for idempotent upsert. | ERP vendor ID |
Validation Rules
suppliers[]must be present and non-empty.- Each row must include
externalId. - Re-importing
externalIdupdates the same supplier record.
Common Errors
| Error | Meaning | How to fix |
|---|---|---|
suppliers[] is required | Missing supplier array. | Send { "suppliers": [ ... ] }. |
externalId required | A row omitted supplier identifier. | Provide non-empty externalId. |