curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/documents/manual' \
--header "Authorization: Bearer $EDI_API_TOKEN"
{
"ack_997": "string",
"ack_contrl": "string",
"ack_ta1": "string",
"documents": [
{
"control_number": "string",
"document_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"error": "string",
"parsed": {},
"reference": "ORD-10042",
"rejection": [
{
"code": "string",
"component": 1,
"element": 1,
"message": "Two-person tent, green — replacement for damaged pole set.",
"recorded_severity": "error",
"segment": "string",
"segment_position": 1,
"value": "49.00",
"severity": "string",
"snip_level": 1,
"suggested_fix": "string"
}
],
"status": "pending",
"transaction_set": "string"
}
],
"error": "string",
"events_queued": 1,
"interchange_acknowledgments": [
{
"acknowledgment_code": "string",
"control_number": "string",
"date": "2026-08-31T14:22:05Z",
"note_code": "string",
"time": "string"
}
],
"interchange_control_number": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending"
}
Manual document entry for partners without back-end integration: an operator…
Processing result with acknowledgment
POST
/
v1
/
documents
/
manual
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/documents/manual' \
--header "Authorization: Bearer $EDI_API_TOKEN"
{
"ack_997": "string",
"ack_contrl": "string",
"ack_ta1": "string",
"documents": [
{
"control_number": "string",
"document_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"error": "string",
"parsed": {},
"reference": "ORD-10042",
"rejection": [
{
"code": "string",
"component": 1,
"element": 1,
"message": "Two-person tent, green — replacement for damaged pole set.",
"recorded_severity": "error",
"segment": "string",
"segment_position": 1,
"value": "49.00",
"severity": "string",
"snip_level": 1,
"suggested_fix": "string"
}
],
"status": "pending",
"transaction_set": "string"
}
],
"error": "string",
"events_queued": 1,
"interchange_acknowledgments": [
{
"acknowledgment_code": "string",
"control_number": "string",
"date": "2026-08-31T14:22:05Z",
"note_code": "string",
"time": "string"
}
],
"interchange_control_number": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending"
}
Response
InboundResult
string,null
Serialized 997 interchange acknowledging what we received.
None when the inbound interchange only contained FA groups or was rejected.string,null
Serialized EDIFACT CONTRL acknowledgment, for inbound EDIFACT interchanges.
string,null
Serialized TA1 interchange rejection, when envelope validation failed.
InboundDocument[]
required
Show InboundDocument
Show InboundDocument
string
required
string
The processed-document id (
GET /v1/documents/{id}) recorded for this transaction set. Empty on receipts stored before it was tracked.string,null
object,null
string
required
array,null
Structured, SNIP-classified guide findings: fatal errors on rejected transactions and advisory warnings on accepted transactions. The same findings the 999 reports, surfaced for operators and agents.
string
required
string
required
string,null
integer
required
Minimum:
0.InterchangeAcknowledgment[]
string
required
string
required
string
required
processed or interchange_rejected.Status codes
| Code | Meaning |
|---|---|
200 | Processing result with acknowledgment |
403 | Admin credential required |
409 | Duplicate interchange control number |
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 --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/documents/manual' \
--header "Authorization: Bearer $EDI_API_TOKEN"
{
"ack_997": "string",
"ack_contrl": "string",
"ack_ta1": "string",
"documents": [
{
"control_number": "string",
"document_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"error": "string",
"parsed": {},
"reference": "ORD-10042",
"rejection": [
{
"code": "string",
"component": 1,
"element": 1,
"message": "Two-person tent, green — replacement for damaged pole set.",
"recorded_severity": "error",
"segment": "string",
"segment_position": 1,
"value": "49.00",
"severity": "string",
"snip_level": 1,
"suggested_fix": "string"
}
],
"status": "pending",
"transaction_set": "string"
}
],
"error": "string",
"events_queued": 1,
"interchange_acknowledgments": [
{
"acknowledgment_code": "string",
"control_number": "string",
"date": "2026-08-31T14:22:05Z",
"note_code": "string",
"time": "string"
}
],
"interchange_control_number": "string",
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending"
}
Last modified on October 20, 2026