Home

Summary

This site contains Reference Implementation (RI) for Postable remittance IG developed by Athenahealth.

The Postable Remittance IG defines FHIR API which allows retrieving a copy of a previously issued remittance documents. Rather than going to a number of different payer/clearinghouse portals or making phone calls to payers, this API is intended to make it simpler for providers/vendors to retrieve a copy of the already issued remittance​

In scenarios where remits are missing due to any reasons, providers/vendors can request a copy of an already issued 835 or paper remit via the API, and payers/clearinghouses will respond with an attachment which is the copy of the HIPAA compliant 835 or pdf of a paper remit that the payer/clearinghouse already issued​.

All data in this implementation are mock data. Contact amouradian@athenahealth.com or cmiao@athenahealth.com for comments on this Reference Implementation

Running the service

Overview

Posting remittance service is built with Springboot framework and can be easily deployed locally. It's using Postgres 16 for storing mock data. We are using h2 in-memory database for unit and integration tests.

You can follow step by step instructions and bring up postable remittance service locally. It has initial data seed defined by flyway db framework and additional data for different use cases can be loaded into your local Postgres DB by following the steps below.

Running locally or from foundry

To run postable remittance service, follow steps outlined in Getting started. Depending on the method you choose, you'll either do a build locally or bring the service image from the Foundry. When you run your service pointing to a local Postgres DB, it will create postable_remittance schema along with tables in the postgres database.

Local data

We created an excel file to help us generate insert statements, which can be used to populate Postgres DB. If you want to add additional data you can add them to excel file in their corresponding tables which will generate "insert" statements in test-data.xlsx. Once you have generated insert statements, you can copy them into a sql file under src/main/resources/db/seeds/ directory and restart the service.