Pular para o conteúdo principal
POST
Create a field map

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication (format: "Bearer {token}")

Cabeçalhos

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency
string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.

Parâmetros de caminho

contextId
string<uuid>
obrigatório

The unique identifier of the reconciliation context. Context ID

sourceId
string<uuid>
obrigatório

The unique identifier of the reconciliation source. Source ID

Corpo

application/json

Field map creation payload

mapping
object
obrigatório

Field-mapping object that normalizes a source's raw columns to canonical transaction fields.

Resposta

Successfully created field map.

contextId
string
obrigatório

Identifier of the context this field map belongs to.

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

createdAt
string
obrigatório

Creation timestamp in RFC 3339 format.

Exemplo:

"2025-01-15T10:30:00Z"

id
string
obrigatório

Unique identifier of the field map.

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

mapping
object
obrigatório

Field-mapping object normalizing the source's raw columns to canonical transaction fields.

sourceId
string
obrigatório

Identifier of the source this field map normalizes.

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

updatedAt
string
obrigatório

Last update timestamp in RFC 3339 format.

Exemplo:

"2025-01-15T10:30:00Z"

version
integer<int64>
obrigatório

Monotonic mutation counter incremented server-side on each field-map change. Read-only on the write path and NOT honored for optimistic concurrency control.

Exemplo:

1