curl --request GET \
--url 'https://edi.stateset.com/v1/connectors/{name}' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"category": "string",
"delimiters": {
"component": ">",
"element": "*",
"repetition": "string",
"segment": "~"
},
"display_name": "string",
"inbound_sets": [
"string"
],
"name": "string",
"notes": "string",
"outbound_sets": [
"string"
],
"partner_isa_qualifier": "string",
"validation": {
"accepted_inbound": [
"string"
],
"conditional_rules": [
{
"equals": null,
"require_element": null,
"require_segment": null,
"when_element": null,
"when_segment": null
}
],
"count_checks": {},
"element_constraints": [
{
"allowed": null,
"element": null,
"format": null,
"max_len": null,
"min_len": null,
"required": null,
"segment": null
}
],
"required_qualified": {},
"required_references": {},
"required_segments": {},
"segment_cardinality": {}
},
"version": "string"
}
Returns one retailer connector, including its starter validation guide.
Connector profile
GET
/
v1
/
connectors
/
{name}
curl --request GET \
--url 'https://edi.stateset.com/v1/connectors/{name}' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"category": "string",
"delimiters": {
"component": ">",
"element": "*",
"repetition": "string",
"segment": "~"
},
"display_name": "string",
"inbound_sets": [
"string"
],
"name": "string",
"notes": "string",
"outbound_sets": [
"string"
],
"partner_isa_qualifier": "string",
"validation": {
"accepted_inbound": [
"string"
],
"conditional_rules": [
{
"equals": null,
"require_element": null,
"require_segment": null,
"when_element": null,
"when_segment": null
}
],
"count_checks": {},
"element_constraints": [
{
"allowed": null,
"element": null,
"format": null,
"max_len": null,
"min_len": null,
"required": null,
"segment": null
}
],
"required_qualified": {},
"required_references": {},
"required_segments": {},
"segment_cardinality": {}
},
"version": "string"
}
Path parameters
string
required
Connector name, e.g. walmart
Response
Connector
string
Retail vertical, e.g.
beauty, department, club, off-price. Lets
callers narrow the catalog (a beauty vendor wants the beauty channels).string
required
string[]
required
Transaction sets the retailer sends us (we parse and acknowledge).
string
required
Stable lookup key, e.g.
walmart.string
required
string[]
required
Transaction sets we send the retailer.
string
required
The retailer’s typical ISA interchange ID qualifier (01 DUNS,
08 UCC/EAN, 12 phone, ZZ mutually defined). Override per relationship.
PartnerValidation
required
Show PartnerValidation
Show PartnerValidation
string[]
If non-empty, inbound transaction sets not in this list are rejected
(e.g.
['850', '860'] for a partner that only sends orders).ConditionalRule[]
If-then rules, e.g. ‘when BEG02 is SA, a DTM segment is required’.
object
Count-balancing rules per inbound transaction set —
CTT01 must equal
the number of PO1 segments and friends. Checked only when the counter
segment is present (pair with required_segments to mandate it).ElementConstraint[]
Element-level constraints applied to matching segments anywhere in an
inbound document — e.g. pin PO1-03 (unit of measure) to an allowed set.
Show ElementConstraint
Show ElementConstraint
string[]
If non-empty, the element must be one of these values.
integer
required
1-based element position, e.g.
3 for the PO1 unit of measure.object
integer
Maximum length (in characters) when the element is present.
integer
Minimum length (in characters) when the element is present.
boolean
If true, the element must be present (non-empty).
string
required
Segment tag, e.g.
PO1.object
Qualified-segment requirements per inbound transaction set — the guide
staple
required_references can’t reach beyond REF: ‘a DTM*002
(delivery date) must be present’, ‘an N1 loop with N101=ST’. The '*'
key applies to every set.object
REF qualifiers that must be present per inbound transaction set, e.g.
{'850': ['DP']} to require a department-number reference on every PO.object
Segment tags that must be present per inbound transaction set, e.g.
{'850': ['DTM', 'REF']} to require a date and reference on every PO.
The '*' key applies to every inbound set.object
Occurrence bounds per inbound transaction set, e.g.
{'850': [{'segment': 'BEG', 'min': 1, 'max': 1}]} for ‘exactly one
BEG’ or a guide’s ‘max 200 PO1 lines’. The '*' key applies to every
set; a set-specific rule for the same segment takes precedence.string
required
GS08 version/release, e.g.
004010.Status codes
| Code | Meaning |
|---|---|
200 | Connector profile |
403 | Admin credential required |
404 | Unknown connector |
curl --request GET \
--url 'https://edi.stateset.com/v1/connectors/{name}' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"category": "string",
"delimiters": {
"component": ">",
"element": "*",
"repetition": "string",
"segment": "~"
},
"display_name": "string",
"inbound_sets": [
"string"
],
"name": "string",
"notes": "string",
"outbound_sets": [
"string"
],
"partner_isa_qualifier": "string",
"validation": {
"accepted_inbound": [
"string"
],
"conditional_rules": [
{
"equals": null,
"require_element": null,
"require_segment": null,
"when_element": null,
"when_segment": null
}
],
"count_checks": {},
"element_constraints": [
{
"allowed": null,
"element": null,
"format": null,
"max_len": null,
"min_len": null,
"required": null,
"segment": null
}
],
"required_qualified": {},
"required_references": {},
"required_segments": {},
"segment_cardinality": {}
},
"version": "string"
}