x12 835 and 837 parser into JSON format (sqlite or mongodb) and export into any relational database with appropriate relationships
Go to file
Steve Nyemba 0d7b40cbd8 bug fix: write to SQL complex objects -> str 2024-02-19 22:10:26 -06:00
bin bug fix: executable 2024-02-05 22:01:34 -06:00
healthcareio bug fix: write to SQL complex objects -> str 2024-02-19 22:10:26 -06:00
meta version update 2024-02-09 10:14:00 -06:00
LICENSE Initial commit 2019-11-06 14:36:32 -06:00
README.md documentation & versioning 2024-02-06 11:16:10 -06:00
setup.py bug fix 2024-02-05 21:56:46 -06:00

README.md

About Healthcare/IO Parser

The Healthcare/IO parser is an Electronic Data Interchange (EDI) parser developed at Vanderbilt University Medical Center during Khanhly Nguyen's summer internship 2019. Built in a healthcare setting, the parser focuses (for now) on x12 claims (837) and remittances (835)

This code is intended to extract x12 837 and 835 and format them into portable and human readable format (JSON). This allows the claims to be stored in document data stores such as Mongodb, couchdb or databases that have support for JSON like PostgreSQL

We wrote this frame to be used in both command line or as a library within in your code. The framework is driven by configurations that derviced from X12 standards.

Features

Features Description
X12 claims/remits parsing of {x12} claims/remittances into JSON format with human readible attributes
Multi Processing capable of processing multiple files simultaneously to speed up processing
Process Recovery capable of recovering interrupted runs
Export to RDBMS exports data to relational format (NoSQL -> SQL) 8 supported industry standard databases
* PostgreSQL,
* Redshift,
* Neteeza,
* Mysql,
* Mariadb,
* bigquery,
* sqlite3
*databricks
Issues and Bug reports info@the-phi.com

For advanced features visit Healthcare/IO::Parser homepage

Installation

System requirements

- git (latest cli)
- python3+ (with virtualenv)
- mongodb (optional)

Installation command

pip install --upgrade git+https://hiplab.mc.vanderbilt.edu/git/hiplab/parser.git

Usage

Healthcare/IO is primarily intended to be used as a command line parser (for now). However it can be used as a library that you integrate into custom code. It is fully written in python 3+ under MIT License

Learning More

Known Limitations

  1. By default it does NOT come with all {X12} Segments.
  2. Renaming attributes requires writing plugins
  3. Upgrade configuration may require dropping tables
  4. For now can only read {x12} from disk (or s3 bucket)

There is support for additional features and attributes available at Healthcare/IO::Parser.

Credits

This project was realized thanks largely to the effort of Vanderbilt University Medical Center

 
- Khanhly Nguyen
- Heather Dunn
- Nina Thousand
- Byun Kang
- Gaylon Stanley
- Cheng Gao
- Thomas Brown
- Brad Malin
- Steve Nyemba