You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
78 lines
2.9 KiB
Markdown
78 lines
2.9 KiB
Markdown
## 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 | |
|
|
| -------- | --- |
|
|
|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|
|
|
|Analytics support| descriptive statistical analytics : distribution, various counts|
|
|
|Process Recovery| capable of recovering interrupted runs|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
pip install --upgrade git+https://hiplab.mc.vanderbilt.edu/git/lab/parse-edi.git
|
|
|
|
## Usage
|
|
|
|
**cli :**
|
|
|
|
1. signup to get parsing configuration
|
|
|
|
healthcare-io.py --signup <email> [--store <mongo|sqlite>]
|
|
|
|
2. parsing claims in a folder
|
|
|
|
healthcare-io.py --parse <claims|remits> --folder <path> [--batch <n>] [--resume]
|
|
|
|
with :
|
|
--parse tells the engine what to parse claims or remits
|
|
--folder location of the claims|remits
|
|
--batch number of processes to spawn to parse the files
|
|
--resume tells the parser to resume parsing
|
|
if all files weren't processed or new files were added into the folder
|
|
**dashboard**
|
|
|
|
There is a built-in dashboard that has features
|
|
|
|
healthcare-io.py --server <port> [--context <name>]
|
|
|
|
**Embedded in Code :**
|
|
|
|
Use **parse-edi** within your code base as a library and handle storing data in a data store of choice
|
|
|
|
import edi.parser
|
|
import json
|
|
import os
|
|
|
|
|
|
ROOT = 'data'
|
|
CLAIMS_FOLDER = os.sep.join([ROOT,'837']) #-- data/837 contains all 837 formatted files
|
|
CONFIG_FOLDER = os.sep.join([ROOT,'config'])#-- data/config contains 837.json or 835.json
|
|
|
|
|
|
files = os.listdir(CLAIMS_FOLDER)
|
|
filename = os.sep.join([CLAIM_FOLDER,files[0]]) #-- selecting the first file in the folder (it's an example)
|
|
conf = json.loads(open( os.sep.join([CONFIG_FOLDER,'837.json']) ).read())
|
|
info = edi.parser.get_content(file,conf) #-- array of objects claims/remits
|
|
|
|
## Credits
|
|
|
|
|
|
* [Khanhly Nguyen] (<khanhly.t.nguyen@gmail.com>)
|
|
* [Gaylon Stanley] (<gaylon.stanley@vanderbilt.edu>)
|
|
* [Cheng Gao] (<cheng.gao@vanderbilt.edu>)
|
|
* [Brad Malin] (brad.malin@vanderbilt.edu)
|
|
* [Steve L. Nyemba] (<steve.l.nyemba@vanderbilt.edu>)
|
|
|
|
|
|
|