Better Data

Import

Suppliers Field Mapping

Edit this page

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. |