{"id":25911389,"url":"https://github.com/copyleftdev/x12-edi-tools","last_synced_at":"2025-07-01T07:05:04.374Z","repository":{"id":250786727,"uuid":"835521253","full_name":"copyleftdev/x12-edi-tools","owner":"copyleftdev","description":"A comprehensive set of tools for working with X12 EDI files","archived":false,"fork":false,"pushed_at":"2025-05-22T00:09:14.000Z","size":763,"stargazers_count":6,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-01T07:04:04.713Z","etag":null,"topics":["data-exploration","dental","x12","zuub"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/copyleftdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-07-30T02:31:37.000Z","updated_at":"2025-05-22T00:09:18.000Z","dependencies_parsed_at":"2024-07-30T04:32:38.049Z","dependency_job_id":"72d80ae1-d733-4c21-baf0-6d51f592bf0a","html_url":"https://github.com/copyleftdev/x12-edi-tools","commit_stats":null,"previous_names":["copyleftdev/x12-edi-tools"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/copyleftdev/x12-edi-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Fx12-edi-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Fx12-edi-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Fx12-edi-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Fx12-edi-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/copyleftdev","download_url":"https://codeload.github.com/copyleftdev/x12-edi-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Fx12-edi-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262916618,"owners_count":23383885,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-exploration","dental","x12","zuub"],"created_at":"2025-03-03T09:17:23.859Z","updated_at":"2025-07-01T07:05:04.312Z","avatar_url":"https://github.com/copyleftdev.png","language":"Python","readme":"# X12 EDI Tools\n\n![X12 EDI Tools Logo](logo.png)\n![Python](https://img.shields.io/badge/Python-3.9+-blue?logo=python)\n\n\n\nA comprehensive Python library for working with X12 EDI (Electronic Data Interchange) files, commonly used in healthcare for claims processing, eligibility verification, and other administrative transactions.\n\n## Installation\n\nInstall the X12 EDI Tools library using pip:\n\n```bash\npip install x12-edi-tools\n```\n\n## Key Components\n\n### X12Parser\nParses X12 files into Python objects.\n\n```python\nfrom x12_edi_tools.x12_parser import X12Parser\n\nparser = X12Parser()\nparsed_data = parser.parse(\"path/to/x12_file.edi\")\nprint(parsed_data)\n```\n\n### X12Generator\nGenerates X12 files from Python objects.\n\n```python\nfrom x12_edi_tools.x12_generator import X12Generator\n\ngenerator = X12Generator()\nx12_content = generator.generate(data_dict)\nwith open(\"output.edi\", \"w\") as f:\n    f.write(x12_content)\n```\n\n### X12Validator\nValidates X12 files against standard formats and custom rules.\n\n```python\nfrom x12_edi_tools.x_12_validator import X12Validator\n\nvalidator = X12Validator()\nis_valid, errors, warnings = validator.validate(\"path/to/x12_file.edi\")\n    print(\"Validation errors:\", errors)\n```\n\n### DentalClaimProcessor\nProcesses dental claims (837D transactions).\n\n```python\nfrom x12_edi_tools.dental_claim_processor import DentalClaimProcessor\n\nprocessor = DentalClaimProcessor()\nclaims = processor.process(\"path/to/837D_file.edi\")\nfor claim in claims:\n    print(f\"Claim ID: {claim.claim_id}, Patient: {claim.patient_name}\")\n```\n\n### EligibilityChecker\nHandles eligibility inquiries and responses (270/271 transactions).\n\n```python\nfrom x12_edi_tools.eligibility_checker import EligibilityChecker\n\nchecker = EligibilityChecker()\nrequest = checker.create_270_request(patient_data)\nresponse = checker.process_271_response(response_data)\nprint(f\"Patient eligible: {response.is_eligible}\")\n```\n\n### RemittanceAdviceParser\nParses remittance advice (835) transactions.\n\n```python\nfrom x12_edi_tools.remittance_advise_parser import RemittanceAdviceParser\n\nparser = RemittanceAdviceParser()\nremittance = parser.parse(\"path/to/835_file.edi\")\nprint(f\"Total paid: ${remittance.total_paid}\")\n```\n\n### X12Converter\nConverts X12 data to and from other formats like JSON and CSV.\n\n```python\nfrom x12_edi_tools.x_12_converter import X12Converter\n\nconverter = X12Converter()\njson_data = converter.to_json(\"path/to/x12_file.edi\")\ncsv_data = converter.to_csv(\"path/to/x12_file.edi\")\n```\n\n### X12Encryptor\nEncrypts and decrypts X12 data for secure transmission and storage.\n\n```python\nfrom x12_edi_tools.x_12_encryptor import X12Encryptor\n\nencryptor = X12Encryptor(\"your-secret-key\")\nencrypted_data = encryptor.encrypt(\"path/to/x12_file.edi\")\ndecrypted_data = encryptor.decrypt(encrypted_data)\n```\n\n### X12DatabaseIntegrator\nFacilitates integration of X12 data with databases.\n\n```python\nfrom x12_edi_tools.x_12_database_integrator import X12DatabaseIntegrator\n\nintegrator = X12DatabaseIntegrator(\"database_connection_string\")\nintegrator.store_transaction(\"path/to/x12_file.edi\")\ntransactions = integrator.retrieve_transactions(date_range)\n```\n\n### X12Logger\nProvides detailed logging of X12 operations for auditing and troubleshooting.\n\n```python\nfrom x12_edi_tools.x_12_logger import X12Logger\n\nlogger = X12Logger(\"path/to/log/directory\")\nlogger.log_parse(\"837\", \"path/to/837_file.edi\", parse_result)\nlogger.log_generate(\"835\", \"path/to/835_file.edi\", generation_data)\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n\n## License\nThis project is licensed under the [MIT License](LICENSE).\n\n## Contact\n\nDon Johnson - dj@codetestcode.io\n\nProject Link: [https://github.com/donjohnson/x12-edi-tools](https://github.com/donjohnson/x12-edi-tools)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcopyleftdev%2Fx12-edi-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcopyleftdev%2Fx12-edi-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcopyleftdev%2Fx12-edi-tools/lists"}