EDI Converter 2.14.8 Release

We’re pleased to announce version 2.14.8 of our EDI Converter.

This release adds the remaining fields for 834 (benefits and enrollment) transactions, bringing our 834 JSON/object model to 100% coverage of 834 EDI fields in the JSON output.

The release also introduces an improved OpenAPI schema with custom “x-edi” properties to make it easier to track changes between releases.

Finally, we’ve updated the CLI tool to support multiple input files and glob patterns.

You can view all changes in GitHub diff format here.
Scroll down to “openapi/components/schemas/model” to see the schema changes.

New JSON Fields, 834 Transaction

View the complete schema here.

Member Coverage Object

  • medicarePlanCode, EDI Element: INS06-1
  • medicareEligibilityReasonCode, EDI Element: INS06-2
  • deathDate, EDI Element: INS12

Member Object

  • ethnicityCodes, list of Strings. EDI Element: DMG05
  • languages, list of LanguageInfo objects. EDI Element: LUI

CoordinationOfBenefits Object

  • serviceTypeCodes, list of Strings. EDI Element: COB04

Address Object

  • locationQualifier. EDI Element: N405
  • locationIdentifier. EDI Element: N406
  • countrySubdivisionCode. EDI Element: N407

New CSV Fields, 834 Transaction

View the complete CSV data dictionary here.

  • MedicarePlanCode. EDI Element: INS06-1
  • MedicareEligibilityReasonCode. EDI Element: INS06-2
  • DeathDate. EDI Element: INS12
  • MemberEthnicityCode. Repeats 3 times. EDI Element: DMG05
  • HealthCoverageCob*ServiceTypeCode. Repeats 3 times. EDI Element: COB04

CLI Changes

  • You can now specify multiple input files and glob patterns as input.
  • If the output ends with a slash, the converter will now create the output directory. Previously, the output directory had to exist.
  • The converter no longer truncates “837P” and “837I” extensions when generating output file names.

AWS Lambda Function

We’ve added support for Java 25 runtime.

Improved OpenAPI Schemas

The OpenAPI schemas have been cleaned up. We’ve changed HTML descriptions to plain text.

We’ve also introduced a number of custom extensions to OpenAPI schemas:

  • x-edi-elt-designators: The EDI element reference designator for the field.
  • x-edi-qualifiers: The qualifier code for the field, if applicable.
  • x-edi-seg-ids: The EDI segment name for the object.
  • x-edi-loop-ids: The EDI loop identifier for the object.
  • x-since: The version of the EDI converter that introduced the field.

Note that all “x-edi” properties are lists, since JSON fields can be mapped to multiple EDI elements.

How to Upgrade

API Docker container

If using Docker Compose, update the image tag to repo.datainsight.health/ediconvert:2.14 and pull the new image:

docker compose pull

The latest Docker Compose file is always available in our GitHub repo.

Without Docker Compose:

docker pull repo.datainsight.health/ediconvert:2.14

Check the version via the API:

curl http://localhost:5080/api/about

CLI tool

  1. Download the new version.
  2. Unzip and replace your existing installation files (including lib and conf folders).
  3. Do not delete your license file.
  4. Run: 
    ediconvert -V
    The output should include ediconvert 2.14.8.

EDI Parser for Java

Update your Gradle or Maven dependency:

implementation "hdi:edi:2.14.8"

AWS Lambda Function

Update the Lambda deployment:

aws lambda update-function-code --function-name <your function name> --zip-file fileb://./edi/build/distributions/ediconvert-lambda-2.14.zip

You can also use this Terraform file to update the function.