Suppliers Field Mapping

Map source supplier fields to Better Data supplier fields.

Overview

Suppliers import creates or updates supplier master records for your organization. Today the endpoint validates externalId and uses it as the supplier code.

Quick Start

1. Build a suppliers[] payload.
2. POST to /api/import/suppliers.
3. 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 externalId updates 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.