Skip to content
background-image background-image

EdiNation - JSON to EDIFACT Converter

[ | version 3.0]


The connector is permitted for use of the platform background agent.

Connector processing type: Row by row!

Translates an EdifactInterchange object to a raw EDIFACT interchange and returns it as a stream.

For comprehensive details and additional configuration options, please refer to the EdiNation API documentation.


EdiNation - Edifact Connection

Base URL: The base URL for connecting to the EdiNation service.

Authorization token: A token for authorizing access to the EdiNation

EdiNation - JSON to Edifact settings

Error behavior

Fail and return response: The connector fails at the specified line but generates output with error details.

Fail without response: The connector fails - the error will be displayed only in the log.

Do not fail and return response: The connector does not fail but generates output records that may be marked with an error and detailed information.

  • Preserve whitespaces: Whether to preserve blank data elements so the output contains multiple delimiters instead of omitting any excess delimiters. The default is false.

  • Same repetition and data element: Sometimes the same delimiter is used to denote data element separator and repetition separator as in IATA transactions. By default, this is false.

  • Use eancom 3: The default syntax for EANCOM transactions. By default all EANCOM transactions will be translated and validated according to the rules of Syntax 4. Set this flag to true if you need Syntax 3 to be used. The default value is false.

Postfix: The postfix to be applied at the end of each segment, just after the segment separator. This is usually a carriage return (CR), line feed (LF), or both. By default, there is no postfix.

Input & Output Schema


JSON (ver. 1.0.0)

Column Data type Allow null Description
JSON JSON No Input/Output in JSON format


The input for this connector is a JSON object, which uses curly braces { } rather than square brackets [ ].


EdiNation - Convert JSON To EDIFACT Response

Column Data type Allow null Description
StatusCode Integer No A numerical response from the server to an HTTP request sent to an API (see below).
EDIFACT String Yes The resulting EDIFACT produced from the conversion of the JSON.
Message String Yes If the Status is "error," the error message is displayed.
Status String Yes The result of the JSON to EDIFACT conversion process

Status Code

  • 200 Success
  • 400 Bad request - When the file stream is invalid or the form-data is not set properly.
  • 500 Server error - Something went wrong on EdiNation's side.


The API will respond with HTTP 200 OK even if the contents of the file can't be translated.

Release notes


  • First release