Publish

Immutable revision published after regression fixtures pass

POST /v1/mappings/{partner_id}/{name}

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/mappings/{partner_id}/{name}' \
  --header "Authorization: Bearer $EDI_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "expected_version": 0,
  "definition": {
    "fields": [
      {
        "target": "order_number",
        "source": "/po_number",
        "required": true
      }
    ],
    "arrays": []
  },
  "fixtures": [
    {
      "name": "valid order",
      "input": {
        "po_number": "PO-123"
      },
      "expected": {
        "order_number": "PO-123"
      }
    },
    {
      "name": "missing order",
      "input": {},
      "error_contains": "Missing required source"
    }
  ],
  "note": "Reviewed order identity mapping and rejection fixture."
}'

Path parameters

partner_id · string · required

Partner

name · string · required

Mapping name

Request body

MappingPublish

definition · MappingDefinition · required

Show MappingDefinition

arrays · MappingArray[]

Show MappingArray

item · MappingDefinition · required

source · string · required

target · string · required

fields · MappingField[] · required

Show MappingField

default · any

factor · string,null

Exact multiplication for unit conversion; input must be a string.

lookup · object

Additional keys map to values of type any.

required · boolean

source · string · required

RFC 6901 JSON pointer, relative to this object/array row.

target · string · required

expected_version · integer (int64) · required

fixtures · MappingFixture[] · required

Show MappingFixture

error_contains · string,null

expected · any

input · any · required

name · string · required

note · string · required

Response

No response body. Immutable revision published after regression fixtures pass.

Status codes

Code	Meaning
200	Immutable revision published after regression fixtures pass
409	Head changed since review

Using this contract

Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/mappings/{partner_id}/{name}' \
  --header "Authorization: Bearer $EDI_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "expected_version": 0,
  "definition": {
    "fields": [
      {
        "target": "order_number",
        "source": "/po_number",
        "required": true
      }
    ],
    "arrays": []
  },
  "fixtures": [
    {
      "name": "valid order",
      "input": {
        "po_number": "PO-123"
      },
      "expected": {
        "order_number": "PO-123"
      }
    },
    {
      "name": "missing order",
      "input": {},
      "error_contains": "Missing required source"
    }
  ],
  "note": "Reviewed order identity mapping and rejection fixture."
}'