cyclone

tyler/cyclone

Fork 0

Commit Graph

Author	SHA1	Message	Date
Tyler	2c0afbe9c5	feat(sp10): 277CA parser + Payer-Rejected Inbox lane - Add cyclone.parsers.models_277ca + parse_277ca (X12 005010X214) - Per-Patient HL ClaimStatus with REF1K (PCN), REFEJ (tax ID), STC category code, amount, service date - STC classifier: A1-A3 accepted, A4/A6/A7 rejected, A8/A9 pended, P1-P5 paid, anything else unknown - Multiple STCs per Patient HL: last wins (canonical pattern for 'first pended, then paid' acknowledgments) - Subscriber-level STCs surface in unscoped_statuses - Add apply_277ca_rejections — stamps Claim.payer_rejected_* fields on matching rows (lookup by patient_control_number, mirrors 999 path) - New /api/parse-277ca, /api/277ca-acks, /api/277ca-acks/{id} endpoints - New two77ca_acks table + Two77caAck ORM model - New Claim columns: payer_rejected_at, _reason, _status_code, _by_277ca_id - New payer_rejected lane in /api/inbox/lanes (distinct from 999 envelope rejected lane) - New PayerConfig277CA block in config/payers.yaml + Pydantic model - Migration 0008 bumps user_version to 8 Tests: 654 -> 688 (parser 22 + apply 6 + API 8 + config 6 + adjustments). All 688 backend tests pass; 1 pre-existing skipped test class unaffected.	2026-06-20 23:41:01 -06:00
Tyler	ec9eae7a2c	feat(sp8): resubmit endpoint supports ?download=zip for regenerated 837s Add an optional ``?download=true`` query param to ``POST /api/inbox/rejected/resubmit`` that returns the same operation result as a ZIP archive of regenerated 837P files (one ``claim-{id}.x12`` per successfully resubmitted claim) rather than the JSON envelope. Why: operators who mass-resubmit rejected claims want to hand the files straight to their clearinghouse; round-tripping through copy- paste is error-prone. Implementation notes: * Uses ``serialize_837_for_resubmit`` so each X12 file in the bundle gets a unique interchange/group control number (back-to-back resubmits would otherwise collide on ISA13/GS06 = "000000001"). * Conflicts and missing ids are deliberately excluded from the ZIP — the user already saw them in the JSON path on prior calls; the download is the "give me the files I asked for" payload. * Empty resubmit + download returns 200 with an empty ZIP so the UI can still hand the user a downloadable artifact. Tests (test_inbox_endpoints.py): 2 new tests covering the success shape (one .x12 per accepted claim) and the conflict-exclusion contract.	2026-06-20 20:49:08 -06:00
Tyler	f4baceb574	feat(sp6): inbox endpoints — lanes, match, dismiss, resubmit, csv export T7-T10 combined (single edit: all endpoints share a section). - GET /api/inbox/lanes — four lanes in one call - POST /api/inbox/candidates/{remit_id}/match — 409 on conflict - POST /api/inbox/candidates/dismiss — session-scoped dismissed set - POST /api/inbox/rejected/resubmit — 200 with conflicts list - GET /api/inbox/export.csv?lane=<lane> — streams CSV Also adds module-level imports (db, Claim, ClaimState, Remittance, csv, io, datetime) that the new endpoints need; cleans up the duplicated local imports in the parse-999 SP6 T4 block.	2026-06-20 18:34:09 -06:00

Author

SHA1

Message

Date

Tyler

2c0afbe9c5

feat(sp10): 277CA parser + Payer-Rejected Inbox lane

- Add cyclone.parsers.models_277ca + parse_277ca (X12 005010X214)
  - Per-Patient HL ClaimStatus with REF*1K (PCN), REF*EJ (tax ID),
    STC category code, amount, service date
  - STC classifier: A1-A3 accepted, A4/A6/A7 rejected, A8/A9 pended,
    P1-P5 paid, anything else unknown
  - Multiple STCs per Patient HL: last wins (canonical pattern for
    'first pended, then paid' acknowledgments)
  - Subscriber-level STCs surface in unscoped_statuses
- Add apply_277ca_rejections — stamps Claim.payer_rejected_* fields on
  matching rows (lookup by patient_control_number, mirrors 999 path)
- New /api/parse-277ca, /api/277ca-acks, /api/277ca-acks/{id} endpoints
- New two77ca_acks table + Two77caAck ORM model
- New Claim columns: payer_rejected_at, _reason, _status_code, _by_277ca_id
- New payer_rejected lane in /api/inbox/lanes (distinct from 999
  envelope rejected lane)
- New PayerConfig277CA block in config/payers.yaml + Pydantic model
- Migration 0008 bumps user_version to 8

Tests: 654 -> 688 (parser 22 + apply 6 + API 8 + config 6 + adjustments).
All 688 backend tests pass; 1 pre-existing skipped test class unaffected.

2026-06-20 23:41:01 -06:00

Tyler

ec9eae7a2c

feat(sp8): resubmit endpoint supports ?download=zip for regenerated 837s

Add an optional ``?download=true`` query param to
``POST /api/inbox/rejected/resubmit`` that returns the same operation
result as a ZIP archive of regenerated 837P files (one
``claim-{id}.x12`` per successfully resubmitted claim) rather than the
JSON envelope.

Why: operators who mass-resubmit rejected claims want to hand the
files straight to their clearinghouse; round-tripping through copy-
paste is error-prone.

Implementation notes:
  * Uses ``serialize_837_for_resubmit`` so each X12 file in the bundle
    gets a unique interchange/group control number (back-to-back
    resubmits would otherwise collide on ISA13/GS06 = "000000001").
  * Conflicts and missing ids are deliberately excluded from the ZIP
    — the user already saw them in the JSON path on prior calls; the
    download is the "give me the files I asked for" payload.
  * Empty resubmit + download returns 200 with an empty ZIP so the UI
    can still hand the user a downloadable artifact.

Tests (test_inbox_endpoints.py): 2 new tests covering the success
shape (one .x12 per accepted claim) and the conflict-exclusion
contract.

2026-06-20 20:49:08 -06:00

Tyler

f4baceb574

feat(sp6): inbox endpoints — lanes, match, dismiss, resubmit, csv export

T7-T10 combined (single edit: all endpoints share a section).

- GET /api/inbox/lanes — four lanes in one call
- POST /api/inbox/candidates/{remit_id}/match — 409 on conflict
- POST /api/inbox/candidates/dismiss — session-scoped dismissed set
- POST /api/inbox/rejected/resubmit — 200 with conflicts list
- GET /api/inbox/export.csv?lane=<lane> — streams CSV

Also adds module-level imports (db, Claim, ClaimState, Remittance,
csv, io, datetime) that the new endpoints need; cleans up the
duplicated local imports in the parse-999 SP6 T4 block.

2026-06-20 18:34:09 -06:00

3 Commits