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

# 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…

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`

<ResponseField name="ack_997" type="string">
  Serialized 997 interchange acknowledging what we received. `None` when the inbound interchange only contained FA groups or was rejected.
</ResponseField>

<ResponseField name="ack_contrl" type="string">
  Serialized EDIFACT CONTRL acknowledgment, for inbound EDIFACT interchanges.
</ResponseField>

<ResponseField name="ack_ta1" type="string">
  Serialized TA1 interchange rejection, when envelope validation failed.
</ResponseField>

<ResponseField name="documents" type="InboundDocument[]" required>
  <Expandable title="InboundDocument">
    <ResponseField name="control_number" type="string" required />

    <ResponseField name="error" type="string" />

    <ResponseField name="parsed" type="object" />

    <ResponseField name="reference" type="string" required />

    <ResponseField name="status" type="string" required />

    <ResponseField name="transaction_set" type="string" required />
  </Expandable>
</ResponseField>

<ResponseField name="error" type="string" />

<ResponseField name="events_queued" type="integer" required />

<ResponseField name="interchange_control_number" type="string" required />

<ResponseField name="partner_id" type="string" required />

<ResponseField name="status" type="string" required>
  `processed` or `interchange_rejected`.
</ResponseField>

### Status codes

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

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://edi.stateset.com/v1/documents/manual' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ack_997": "string",
    "ack_contrl": "string",
    "ack_ta1": "string",
    "documents": [
      {
        "control_number": "string",
        "error": "string",
        "parsed": {},
        "reference": "string",
        "status": "string",
        "transaction_set": "string"
      }
    ],
    "error": "string",
    "events_queued": 1,
    "interchange_control_number": "string",
    "partner_id": "string",
    "status": "string"
  }
  ```
</ResponseExample>