Orders Field Mapping

Map source order fields to Better Data order fields.

Overview

Orders import writes customer orders and order lines for fulfillment workflows. Each order requires an externalOrderId and at least one line.

Quick Start

1. Build orders[] with order headers and nested lines.
2. POST to /api/import/orders.
3. Poll /api/import/status/[jobId].

Header Fields

Better Data Field	Type	Required	Example	Description
externalOrderId	string	YES	SO-778901	Unique order ID (idempotent key).
lines	array	YES	[{...}]	Order line rows.

Line Fields (lines[])

Better Data Field	Type	Required	Example	Description
skuId	string	YES	SKU-001	Ordered SKU.
quantity	number	YES	2	Requested quantity.
locationId	string	YES	DC-EAST	Fulfillment location code.

Validation Rules

• orders[] must be present and non-empty.
• Header requires externalOrderId and non-empty lines[].
• Each line should include skuId, quantity, and locationId.

Common Errors

Error	Meaning	How to fix
orders[] is required	Missing order array.	Send { "orders": [ ... ] }.
required fields missing	Missing externalOrderId or no line rows.	Provide required header fields and at least one line.