Boomi Platform API Reference (1.0.0) - EDIFACTConnectorRecord
EDIFACT Connector Records correspond to the trading partner details of the Process Reporting page in the user interface. The EDIFACT Connector Record object contains EDIFACT-specific document information and user-defined tracked field information along with other fields.
Required Privileges
You need these privileges in the target environment:
Write access
- N/A
Read access
- API — Use the Boomi Platform API to access account data.
Queries for an EDIFACTConnectorRecord object(s)
- To filter by a customField, use the format customFields/fieldName as the filter property where fieldName is the element name of the custom field in the EDIFACT Connector Record structure. To get a list of the available custom fields, refer to Custom Tracked Field object.
- The STARTS_WITH operator accepts values that do not include spaces only.
For general information about the structure of QUERY filters, their sample payloads, and how to handle the paged results, refer to Query filters and Query paging.
Authorizations:
Request Body schema: optional
required | object | ||||||||||
| |||||||||||
Responses
Response Schema:
| numberOfResults | integer <int32> |
| queryToken | string By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request. |
Array of objects (EDIFACTConnectorRecord) |
Request samples
- Payload
{- "QueryFilter": {
- "expression": {
- "argument": [
- "execution-01234567-89ab-cdef-0123-456789abcdef-2018.08.08"
], - "operator": "EQUALS",
- "property": "executionId"
}
}
}Response samples
- 200
- 403
- 410
- 503
{- "numberOfResults": 100,
- "@type": "QueryResult",
- "result": [
- {
- "@type": "EDIFACTConnectorRecord",
- "ackStatus": "Accepted",
- "ackReport": "Message Reference #: 1 \n Acknowledgement Status: This level acknowledged, next lower level acknowledged if not explicitly rejected",
- "senderID": "12345",
- "receiverID": "67890",
- "interchangeControlReference": "4",
- "messageType": "INVOIC",
- "messageReferenceNumber": "1",
- "interchangeDate": "180808",
- "interchangeTime": "0624",
- "ackRequested": "1",
- "outboundValidationStatus": "Error - Message",
- "outboundValidationReport": "Message Reference #: 1 \n Validation Status: This level and all lower levels rejected \n Message: Missing \n Segment Position: 2 \n Message: Unspecified error Data Element Error for '' Position in Segment: 1 \n Message: notification that the length of the data element received exceeded the maximum length specified in the data element description.",
- "account": "account-123456",
- "executionId": "execution-01234567-89ab-cdef-0123-456789abcdef-2018.08.08",
- "atomId": "3456789a-bcde-f012-3456-789abcdef012",
- "dateProcessed": "2018-08-08T06:24:12Z",
- "id": "connector-abcdef01-2345-6789-abcd-ef0123456789",
- "actionType": "Send",
- "connectorType": "edifact",
- "connectorName": "Trading Partner",
- "operationName": "Sample EDIFACT Send Operation",
- "documentIndex": 0,
- "successful": true,
- "size": [
- "Long",
- 654
], - "customFields": [
- {
- "customNumber": 13,
- "customDate": "2018-08-08T10:53:59-0400",
- "customCharacter": "sample"
}
], - "version": "D"
}, - {
- "@type": "EDIFACTConnectorRecord",
- "ackStatus": "Accepted",
- "ackReport": "Message Reference #: 100 \n Acknowledgement Status: This level acknowledged, next lower level acknowledged if not explicitly rejected",
- "senderID": "54321",
- "receiverID": "67890",
- "interchangeControlReference": "4",
- "messageType": "INVOIC",
- "messageReferenceNumber": "1",
- "interchangeDate": "180808",
- "interchangeTime": "0625",
- "ackRequested": "1",
- "outboundValidationStatus": "Error - Message",
- "outboundValidationReport": "Message Reference #: 1 \n Validation Status: This level and all lower levels rejected \n Message: Missing \n Segment Position: 2 \n Message: Unspecified error Data Element Error for '' Position in Segment: 1 \n Message: notification that the length of the data element received exceeded the maximum length specified in the data element description.",
- "account": "account-123456",
- "executionId": "execution-01234567-89ab-cdef-0123-456789abcdef-2018.08.08",
- "atomId": "3456789a-bcde-f012-3456-789abcdef012",
- "dateProcessed": "2018-08-08T06:25:02Z",
- "id": "connector-bcdef012-3456-789a-bcde-f0123456789a",
- "actionType": "Send",
- "connectorType": "edifact",
- "connectorName": "Trading Partner",
- "operationName": "Sample EDIFACT Send Operation",
- "documentIndex": 49,
- "successful": true,
- "size": [
- "Long",
- 564
], - "customFields": [
- {
- "customNumber": 55,
- "customDate": "2018-08-08T10:57:14-0400",
- "customCharacter": "sample"
}
], - "version": "D"
}
]
}Retrieves additional results for an EDIFACTConnectorRecord query
To learn about using queryMore, refer to the topic Query paging.
Authorizations:
Request Body schema: text/plainrequired
Responses
Response Schema:
| numberOfResults | integer <int32> |
| queryToken | string By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request. |
Array of objects (EDIFACTConnectorRecord) |
Response samples
- 200
- 403
- 410
- 503
{- "numberOfResults": 100,
- "@type": "QueryResult",
- "result": [
- {
- "@type": "EDIFACTConnectorRecord",
- "ackStatus": "Accepted",
- "ackReport": "Message Reference #: 1 \n Acknowledgement Status: This level acknowledged, next lower level acknowledged if not explicitly rejected",
- "senderID": "12345",
- "receiverID": "67890",
- "interchangeControlReference": "4",
- "messageType": "INVOIC",
- "messageReferenceNumber": "1",
- "interchangeDate": "180808",
- "interchangeTime": "0624",
- "ackRequested": "1",
- "outboundValidationStatus": "Error - Message",
- "outboundValidationReport": "Message Reference #: 1 \n Validation Status: This level and all lower levels rejected \n Message: Missing \n Segment Position: 2 \n Message: Unspecified error Data Element Error for '' Position in Segment: 1 \n Message: notification that the length of the data element received exceeded the maximum length specified in the data element description.",
- "account": "account-123456",
- "executionId": "execution-01234567-89ab-cdef-0123-456789abcdef-2018.08.08",
- "atomId": "3456789a-bcde-f012-3456-789abcdef012",
- "dateProcessed": "2018-08-08T06:24:12Z",
- "id": "connector-abcdef01-2345-6789-abcd-ef0123456789",
- "actionType": "Send",
- "connectorType": "edifact",
- "connectorName": "Trading Partner",
- "operationName": "Sample EDIFACT Send Operation",
- "documentIndex": 0,
- "successful": true,
- "size": [
- "Long",
- 654
], - "customFields": [
- {
- "customNumber": 13,
- "customDate": "2018-08-08T10:53:59-0400",
- "customCharacter": "sample"
}
], - "version": "D"
}, - {
- "@type": "EDIFACTConnectorRecord",
- "ackStatus": "Accepted",
- "ackReport": "Message Reference #: 100 \n Acknowledgement Status: This level acknowledged, next lower level acknowledged if not explicitly rejected",
- "senderID": "54321",
- "receiverID": "67890",
- "interchangeControlReference": "4",
- "messageType": "INVOIC",
- "messageReferenceNumber": "1",
- "interchangeDate": "180808",
- "interchangeTime": "0625",
- "ackRequested": "1",
- "outboundValidationStatus": "Error - Message",
- "outboundValidationReport": "Message Reference #: 1 \n Validation Status: This level and all lower levels rejected \n Message: Missing \n Segment Position: 2 \n Message: Unspecified error Data Element Error for '' Position in Segment: 1 \n Message: notification that the length of the data element received exceeded the maximum length specified in the data element description.",
- "account": "account-123456",
- "executionId": "execution-01234567-89ab-cdef-0123-456789abcdef-2018.08.08",
- "atomId": "3456789a-bcde-f012-3456-789abcdef012",
- "dateProcessed": "2018-08-08T06:25:02Z",
- "id": "connector-bcdef012-3456-789a-bcde-f0123456789a",
- "actionType": "Send",
- "connectorType": "edifact",
- "connectorName": "Trading Partner",
- "operationName": "Sample EDIFACT Send Operation",
- "documentIndex": 49,
- "successful": true,
- "size": [
- "Long",
- 564
], - "customFields": [
- {
- "customNumber": 55,
- "customDate": "2018-08-08T10:57:14-0400",
- "customCharacter": "sample"
}
], - "version": "D"
}
]
}