era_835_parser 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab71e41a87a2f73200361b1bedeb9740c6edc2451cee146057682484a3d3caf7
-  data.tar.gz: 9ed593d781b601484ac0c99019de108f6b4d15374059c1ef46d5a707d5dbec72
+  metadata.gz: 27c9972b427c29ab16fc6977570044045f0064db4e42cdd06e5ee02c2aaf8d05
+  data.tar.gz: 308eadea4e7c01d786898f52576b378e0caf62edf56fecc146bd569068badb4d
 SHA512:
-  metadata.gz: 260a869a1d17269a37c9e06177357b4e8a3c3ac3be88bc9605b9d58459c7bb2bb19be8752109d0640c81b7c7ece04307c9a652f4450d3c94bf198b91213d593c
-  data.tar.gz: fd110d86ad73c4a50f2578f0b65fb5f90c174408bde64f97b03b4682eb8615f44dee6e9790f0a6ff26886c39d603f5d6891a7c6aa3f54dc395a9943e4012989e
+  metadata.gz: d322bb6e647d262130e37069a05944f71f8befae9452516e54f0895fc9c43897844beab38f06ef76687de8054c1f9eec4d0b159760bd5ca168d8441c18ca3cea
+  data.tar.gz: 2abee925027773e179f967614b4cadb47ef9186708e208a3c3126b0fabc1f30b79996b2f89b54758843931a158a87efc7178392da0b0561939b740a3fca5a9bf

data/README.md

@@ -43,6 +43,17 @@ if !era[:checks].nil?
     puts check[:payer_tax_id] # Payer tax id
     puts check[:payer_edi_id] # Payer EDI id
     puts check[:date] # Check date (string mm/dd/yyyy)
+    # Provider level adjustments (PLB) attributed to this check
+    if !check[:provider_adjustments].nil?
+      check[:provider_adjustments].each do |adjustment|
+        puts adjustment[:adjustment_date] # Adjustment date (string mm/dd/yyyy)
+        puts adjustment[:provider_id] # Provider ID
+        puts adjustment[:reference_id] # Reference ID
+        puts adjustment[:adjustment_amount] # Adjustment amount (integer)
+        puts adjustment[:reason] # Reason
+        puts adjustment[:reason_code] # Reason code
+      end
+    end
     if !check[:eras].nil?
       check[:eras].each do |era_counter, individual_era|
         puts individual_era[:era_text] # ERA text

data/era_835_parser.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "bundler", ">= 1.7"
   spec.add_development_dependency "rake", ">= 12.3.3"
   spec.add_development_dependency "rspec"
 end

data/lib/era_835_parser/parser.rb

@@ -35,6 +35,11 @@ module Era835Parser
       adjustment_counter_a = -1
       svc_counter = 0
 
+      # PLB (provider level adjustment) segment state
+      plb_provider_id = ''
+      plb_adjustment_date = ''
+      plb_pair_open = false
+
       # trigger variables
       adjustments_start = false
       checks_start = false
@@ -677,121 +682,49 @@ module Era835Parser
                 case index
                 when 1
                   # Provider Identifier
-                  adjustment_counter_a += 1
-                  adjustment = Hash.new
-                  adjustment[:provider_id] = element.strip
+                  plb_provider_id = element.strip
+                  plb_pair_open = false
                 when 2
                   # Fiscal Period Date
-                  adjustment[:adjustment_date] = element.strip[4..5] + "/" + element.strip[6..7] + "/" + element.strip[0..3]
-                when 3
-                  element.split(":").each_with_index do |subelement, i|
-                    case i
-                    when 0
-                      # PROVIDER ADJUSTMENT REASON CODE
-                      # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
-                      adjustment[:reason_code] = subelement.strip
-                      adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
-                    when 1
-                      # Provider Adjustment Identifier
-                      # puts "Provider Adjustment Identifier: #{subelement}"
-                      adjustment[:reference_id] = subelement.strip
-                    end
-                  end
-                when 4
-                  # Provider Adjustment Amount
-                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i
-                when 5
-                  adjustment_counter_a += 1
-                  element.split(":").each_with_index do |subelement, i|
-                    case i
-                    when 0
-                      # PROVIDER ADJUSTMENT REASON CODE
-                      # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
-                      adjustment[:reason_code] = subelement.strip
-                      adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
-                    when 1
-                      # Provider Adjustment Identifier
-                      # puts "Provider Adjustment Identifier: #{subelement}"
-                      adjustment[:reference_id] = subelement.strip
-                    end
-                  end
-                when 6
-                  # Provider Adjustment Amount
-                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i
-                when 7
-                  adjustment_counter_a += 1
-                  element.split(":").each_with_index do |subelement, i|
-                    case i
-                    when 0
-                      # PROVIDER ADJUSTMENT REASON CODE
-                      # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
-                      adjustment[:reason_code] = subelement.strip
-                      adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
-                    when 1
-                      # Provider Adjustment Identifier
-                      # puts "Provider Adjustment Identifier: #{subelement}"
-                      adjustment[:reference_id] = subelement.strip
-                    end
-                  end
-                when 8
-                  # Provider Adjustment Amount
-                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i
-                when 9
-                  adjustment_counter_a += 1
-                  element.split(":").each_with_index do |subelement, i|
-                    case i
-                    when 0
-                      # PROVIDER ADJUSTMENT REASON CODE
-                      # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
-                      adjustment[:reason_code] = subelement.strip
-                      adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
-                    when 1
-                      # Provider Adjustment Identifier
-                      # puts "Provider Adjustment Identifier: #{subelement}"
-                      adjustment[:reference_id] = subelement.strip
-                    end
-                  end
-                when 10
-                  # Provider Adjustment Amount
-                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i
-                when 11
-                  adjustment_counter_a += 1
-                  element.split(":").each_with_index do |subelement, i|
-                    case i
-                    when 0
-                      # PROVIDER ADJUSTMENT REASON CODE
-                      # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
-                      adjustment[:reason_code] = subelement.strip
-                      adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
-                    when 1
-                      # Provider Adjustment Identifier
-                      # puts "Provider Adjustment Identifier: #{subelement}"
-                      adjustment[:reference_id] = subelement.strip
+                  plb_adjustment_date = element.strip[4..5] + "/" + element.strip[6..7] + "/" + element.strip[0..3]
+                when 3, 5, 7, 9, 11, 13
+                  # Start of an adjustment reason/amount pair (PLB03-04 through PLB13-14).
+                  # A single PLB segment carries up to 6 pairs; each pair is its own adjustment.
+                  if element.strip.empty?
+                    plb_pair_open = false
+                  else
+                    plb_pair_open = true
+                    adjustment_counter_a += 1
+                    adjustment = Hash.new
+                    adjustment[:provider_id] = plb_provider_id
+                    adjustment[:adjustment_date] = plb_adjustment_date
+                    element.split(":").each_with_index do |subelement, i|
+                      case i
+                      when 0
+                        # PROVIDER ADJUSTMENT REASON CODE
+                        # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
+                        adjustment[:reason_code] = subelement.strip
+                        adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
+                      when 1
+                        # Provider Adjustment Identifier
+                        # puts "Provider Adjustment Identifier: #{subelement}"
+                        adjustment[:reference_id] = subelement.strip
+                      end
                     end
                   end
-                when 12
+                when 4, 6, 8, 10, 12, 14
                   # Provider Adjustment Amount
-                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i
-                when 13
-                  adjustment_counter_a += 1
-                  element.split(":").each_with_index do |subelement, i|
-                    case i
-                    when 0
-                      # PROVIDER ADJUSTMENT REASON CODE
-                      # puts "PROVIDER ADJUSTMENT REASON CODE: #{subelement}"
-                      adjustment[:reason_code] = subelement.strip
-                      adjustment[:reason] = PROVIDER_LEVEL_ADJUSTMENTS[subelement.strip]
-                    when 1
-                      # Provider Adjustment Identifier
-                      # puts "Provider Adjustment Identifier: #{subelement}"
-                      adjustment[:reference_id] = subelement.strip
-                    end
+                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i if plb_pair_open
+                end
+                if plb_pair_open && adjustment_counter_a > -1 && (adjustment != {} && !adjustment.nil?)
+                  adjustments[adjustment_counter_a] = adjustment
+                  # Attribute the adjustment to the check (TRN) it belongs to, so multi-check
+                  # files expose provider level adjustments per check.
+                  if check[:check_number]
+                    check[:provider_adjustments] = Array.new if check[:provider_adjustments].nil?
+                    check[:provider_adjustments] << adjustment unless check[:provider_adjustments].include?(adjustment)
                   end
-                when 14
-                  # Provider Adjustment Amount
-                  adjustment[:adjustment_amount] = (element.to_f * 100).round().to_i
                 end
-                adjustments[adjustment_counter_a] = adjustment if adjustment_counter_a > -1 && (adjustment != {} && !adjustment.nil?)
               when "CAS"
                 case index
                 when 1

data/lib/era_835_parser/version.rb

@@ -1,3 +1,3 @@
 module Era835Parser
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/spec/era_835_parser_spec.rb

@@ -29,6 +29,9 @@ RSpec.describe Era835Parser::Parser do
           it 'returns the correct number of adjustment groups' do
             expect(@era[:checks]['70408535'][:eras][0][:line_items][0][:adjustment_groups].count).to eq(1)
           end
+          it 'returns no provider adjustments' do
+            expect(@era[:checks]['70408535'][:provider_adjustments]).to eq(nil)
+          end
         end
 
         context 'Check #70408535' do
@@ -1730,6 +1733,84 @@ RSpec.describe Era835Parser::Parser do
           end
         end
       end
+
+      context 'example_7.835' do
+        # Multi-check 835 where PLB segments carry multiple reason/amount pairs
+        # (PLB03-04 through PLB13-14). Each pair must parse as its own
+        # adjustment and be attributed to the check (TRN) it belongs to.
+        before :all do
+          @era = Era835Parser::Parser.new(file_path: "../era_835_parser/spec/example_7.835").parse
+        end
+
+        context 'Aggregate totals' do
+          it 'returns the correct number of checks' do
+            expect(@era[:checks].count).to eq(2)
+          end
+          it 'returns one adjustment per reason/amount pair across the file' do
+            expect(@era[:adjustments].count).to eq(5)
+          end
+        end
+
+        context 'Check #02790758 (zero payment, multi-pair PLB)' do
+          it 'returns the transaction handling code' do
+            expect(@era[:checks]['02790758'][:transaction_handling_code]).to eq('H')
+          end
+          it 'returns the check amount (integer)' do
+            expect(@era[:checks]['02790758'][:amount]).to eq(0)
+          end
+          it 'returns one provider adjustment per reason/amount pair' do
+            expect(@era[:checks]['02790758'][:provider_adjustments].count).to eq(4)
+          end
+          it 'returns the first pair' do
+            adjustment = @era[:checks]['02790758'][:provider_adjustments][0]
+            expect(adjustment[:reason_code]).to eq('FB')
+            expect(adjustment[:reason]).to eq('Forwarding Balance')
+            expect(adjustment[:reference_id]).to eq('926072000117048')
+            expect(adjustment[:adjustment_amount]).to eq(547904)
+            expect(adjustment[:provider_id]).to eq('0987654321')
+            expect(adjustment[:adjustment_date]).to eq('03/14/2026')
+          end
+          it 'returns the second pair' do
+            adjustment = @era[:checks]['02790758'][:provider_adjustments][1]
+            expect(adjustment[:reason_code]).to eq('FB')
+            expect(adjustment[:reference_id]).to eq('926073000032814')
+            expect(adjustment[:adjustment_amount]).to eq(-375852)
+          end
+          it 'returns the third pair' do
+            adjustment = @era[:checks]['02790758'][:provider_adjustments][2]
+            expect(adjustment[:reason_code]).to eq('WO')
+            expect(adjustment[:reason]).to eq('Overpayment Recovery')
+            expect(adjustment[:reference_id]).to eq('200200964A52')
+            expect(adjustment[:adjustment_amount]).to eq(11576)
+          end
+          it 'returns the fourth pair' do
+            adjustment = @era[:checks]['02790758'][:provider_adjustments][3]
+            expect(adjustment[:reason_code]).to eq('CS')
+            expect(adjustment[:reason]).to eq('Adjustment')
+            expect(adjustment[:reference_id]).to eq('200200964A52')
+            expect(adjustment[:adjustment_amount]).to eq(-11576)
+          end
+        end
+
+        context 'Check #99887766 (single-pair PLB)' do
+          it 'returns the transaction handling code' do
+            expect(@era[:checks]['99887766'][:transaction_handling_code]).to eq('I')
+          end
+          it 'returns the check amount (integer)' do
+            expect(@era[:checks]['99887766'][:amount]).to eq(10000)
+          end
+          it 'returns one provider adjustment' do
+            expect(@era[:checks]['99887766'][:provider_adjustments].count).to eq(1)
+          end
+          it 'returns the pair' do
+            adjustment = @era[:checks]['99887766'][:provider_adjustments][0]
+            expect(adjustment[:reason_code]).to eq('WO')
+            expect(adjustment[:reason]).to eq('Overpayment Recovery')
+            expect(adjustment[:reference_id]).to eq('926074000055521')
+            expect(adjustment[:adjustment_amount]).to eq(2500)
+          end
+        end
+      end
     end
 
     context 'Human readable' do

data/spec/example_7.835

@@ -0,0 +1,48 @@
+ST*835*1234~
+BPR*H*0*C*NON************20260314~
+TRN*1*02790758*560894904~
+REF*F2*LCLA438D~
+DTM*405*20260310~
+N1*PR*BLUE CROSS AND BLUE SHIELD OF NORTH CAROLINA~
+N3*P O BOX 2291~
+N4*DURHAM*NC*27702~
+PER*CX*TE*8005554844~
+N1*PE*XYZ HEALTHCARE CORPORATION*XX*0987654321~
+N3*P O BOX XYZ~
+N4*CHARLOTTE*NC*28234~
+REF*TJ*123456789~
+LX*1~
+CLP*200200964A52*1*150*67.73*0*15*94151100100~
+NM1*QC*1*Dough*Mary****MI*YPB123456789001~
+DTM*050*20260310~
+SVC*HC:92507*150*67.73**1~
+DTM*472*20260301~
+CAS*CO*45*82.27~
+REF*6R*0001~
+AMT*B6*67.73~
+PLB*0987654321*20260314*FB:926072000117048*5479.04*FB:926073000032814*-3758.52*WO:200200964A52*115.76*CS:200200964A52*-115.76~
+SE*27*1234~
+ST*835*1235~
+BPR*I*100*C*CHK************20260314~
+TRN*1*99887766*560894904~
+REF*F2*LCLA439D~
+DTM*405*20260310~
+N1*PR*BLUE CROSS AND BLUE SHIELD OF NORTH CAROLINA~
+N3*P O BOX 2291~
+N4*DURHAM*NC*27702~
+PER*CX*TE*8005554844~
+N1*PE*XYZ HEALTHCARE CORPORATION*XX*0987654321~
+N3*P O BOX XYZ~
+N4*CHARLOTTE*NC*28234~
+REF*TJ*123456789~
+LX*1~
+CLP*300300964B63*1*125*100*0*15*94151100200~
+NM1*QC*1*Dough*John****MI*YPB123456789002~
+DTM*050*20260310~
+SVC*HC:92507*125*100**1~
+DTM*472*20260301~
+CAS*CO*45*25~
+REF*6R*0001~
+AMT*B6*100~
+PLB*0987654321*20260314*WO:926074000055521*25~
+SE*24*1235~

metadata

@@ -1,27 +1,26 @@
 --- !ruby/object:Gem::Specification
 name: era_835_parser
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Kevin S. Dias
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.7'
 - !ruby/object:Gem::Dependency
@@ -81,13 +80,13 @@ files:
 - spec/example_4.835
 - spec/example_5.835
 - spec/example_6.835
+- spec/example_7.835
 - spec/spec_helper.rb
 - spec/test_era.txt
 homepage: https://github.com/diasks2/era_835_parser
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -102,8 +101,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Electronic Remittance Advice (ERA) 835 parser
 test_files:
@@ -114,5 +112,6 @@ test_files:
 - spec/example_4.835
 - spec/example_5.835
 - spec/example_6.835
+- spec/example_7.835
 - spec/spec_helper.rb
 - spec/test_era.txt