- Notifications
You must be signed in to change notification settings - Fork15
Internal Revenue Service (IRS) Filing Information Returns Electronically (FIRE)
License
moov-io/irs
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
IRS implemented a reader, writer, and HTTP server for IRS electronicFiling Information ReturnsElectronically (FIRE). Our tools and library operate at higher levels (JSON) which makes it easier for developers to leverage over the raw bytes (ASCII).
| Input | Output |
|---|---|
| JSON | JSON |
| ASCII FIRE | ASCII FIRE |
| PDF Form | |
| SQL |
Docs:Project |API Endpoints
We are just getting started!
- 1099-MISCAbout Form 1099-MISC
- 1099-NECAbout Form 1099-NEC
... more to come, open an issue or pull request!
Irs has command line interface to manage irs files and to lunch web service.
irs --helpUsage: [command]Available Commands: convert Convert irs file format help Help about any command print Print irs file validator Validate irs file web Launches web serverFlags: -h, --help help for this command --input string input file (default is $PWD/irs.json)Use " [command] --help" for more information about a command.Each interaction that the library supports is exposed in a command-line option:
| Command | Info |
|---|---|
convert | The convert command allows users to convert from a irs file to another format file. Result will create a irs file. |
print | The print command allows users to print a irs file with special file format (json, irs). |
validator | The validator command allows users to validate a irs file. |
web | The web command will launch a web server with endpoints to manage irs files. |
irs convert --helpUsage: convert [output] [flags]Flags: --format string format of irs file(required) (default "json") -h, --help help for convertGlobal Flags: --input string input file (default is $PWD/irs.json)The output parameter is the full path name to convert new irs file.The format parameter is supported 2 types, "json" and "irs".The generate parameter will replace new generated trailer record in the file.The input parameter is source irs file, supported raw type file and json type file.
example:
irs convert output/output.json --input testdata/packed_file.json --format jsonirs print --helpUsage: print [flags]Flags: --format string print format (default "json") -h, --help help for printGlobal Flags: --input string input file (default is $PWD/irs.json)The format parameter is supported 2 types, "json" and "irs".The input parameter is source irs file, supported raw type file and json type file.
irs validator --helpUsage: validator [flags]Flags: -h, --help help for validatorGlobal Flags: --input string input file (default is $PWD/irs.json)The input parameter is source irs file, supported raw type file and json type file.
example:
irs validator --input testdata/packed_file.datError: is an invalid value of TotalConsumerSegmentsJ1irs validator --input testdata/packed_file.jsonirs web --helpUsage: web [flags]Flags: -h, --help help for web -t, --test test serverGlobal Flags: --input string input file (default is $PWD/irs.json)The port parameter is port number of web service.
irs webWeb server have some endpoints to manage irs file
| Method | Endpoint | Content-Type | Info |
|---|---|---|---|
POST | /convert | multipart/form-data | convert irs file. will download new file. |
GET | /health | text/plain | check web server. |
POST | /print | multipart/form-data | print irs file. |
POST | /validator | multipart/form-data | validate irs file. |
web page example to use irs web server:
<!doctype html><html lang="en"><head> <meta charset="utf-8"> <title>Single file upload</title></head><body><h1>Upload single file with fields</h1><form action="http://localhost:8208/convert" method="post" enctype="multipart/form-data"> Format: <input type="text" name="format"><br> Files: <input type="file" name="file"><br><br> <input type="submit" value="Submit"></form></body></html>You can run themoov/irs Docker image which defaults to starting the HTTP server.
docker run -p 8208:8208 moov/irs:latestRead through theproject docs over here to get an understanding of the purpose of this project and how to run it.
| channel | info |
|---|---|
| Project Documentation | Our project documentation available online. |
| Twitter@moov | You can follow Moov.io's Twitter feed to get updates on our project(s). You can also tweet us questions or just share blogs or stories. |
| GitHub Issue | If you are able to reproduce a problem please open a GitHub Issue under the specific project that caused the error. |
| moov-io slack | Join our slack channel (#irs) to have an interactive discussion about the development of the project. |
- 64-bit Linux (Ubuntu, Debian), macOS, and Windows
Yes please! Please review ourContributing guide andCode of Conduct to get started! Checkout ourissues for first time contributors for something to help out with.
This project usesGo Modules and uses Go 1.14 or higher. SeeGolang's install instructions for help setting up Go. You can download the source code and we offertagged and released versions as well. We highly recommend you use a tagged release for production.
Improving test coverage is a good candidate for new contributors while also allowing the project to move more quickly by reducing regressions issues that might not be caught before a release is pushed out to our users. One great way to improve coverage is by adding edge cases and different inputs to functions (orcontributing and running fuzzers).
Apache License 2.0 SeeLICENSE for details.
About
Internal Revenue Service (IRS) Filing Information Returns Electronically (FIRE)