> ## Documentation Index
> Fetch the complete documentation index at: https://betterdatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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