Manual document entry for partners without back-end integration: an operator

pastes a raw inbound interchange and the gateway processes it through the normal pipeline (validation → translation → acknowledgment), recording it as…

POST /v1/documents/manual

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/documents/manual' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY"

200

{
  "ack_997": "string",
  "ack_contrl": "string",
  "ack_ta1": "string",
  "documents": [
    {
      "control_number": "string",
      "error": "string",
      "parsed": {},
      "reference": "ORD-10042",
      "status": "pending",
      "transaction_set": "string"
    }
  ],
  "error": "string",
  "events_queued": 1,
  "interchange_control_number": "string",
  "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending"
}

pastes a raw inbound interchange and the gateway processes it through the normal pipeline (validation → translation → acknowledgment), recording it as operator-entered. Idempotent like any inbound; a duplicate control number is rejected.

Response

InboundResult

ack_997 · string

Serialized 997 interchange acknowledging what we received. None when the inbound interchange only contained FA groups or was rejected.

ack_contrl · string

Serialized EDIFACT CONTRL acknowledgment, for inbound EDIFACT interchanges.

ack_ta1 · string

Serialized TA1 interchange rejection, when envelope validation failed.

documents · InboundDocument[] · required

Show InboundDocument

control_number · string · required

error · string

parsed · object

reference · string · required

status · string · required

transaction_set · string · required

error · string

events_queued · integer · required

interchange_control_number · string · required

partner_id · string · required

status · string · required

processed or interchange_rejected.

Status codes

Code	Meaning
200	Processing result with acknowledgment
403	Admin credential required
409	Duplicate interchange control number

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/documents/manual' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY"

200

{
  "ack_997": "string",
  "ack_contrl": "string",
  "ack_ta1": "string",
  "documents": [
    {
      "control_number": "string",
      "error": "string",
      "parsed": {},
      "reference": "ORD-10042",
      "status": "pending",
      "transaction_set": "string"
    }
  ],
  "error": "string",
  "events_queued": 1,
  "interchange_control_number": "string",
  "partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending"
}