rcv: Introduce DocumentoReferencias for improved data handling

[svillegas-cdd]

• Add a new DocumentoReferencias type to encapsulate the tipo_documento_referencia and folio_documento_referencia fields.
• This change enhances the data model by allowing multiple references to be stored in a structured format, improving the parsing and validation processes.

Ref: https://app.shortcut.com/cordada/story/17694/

[codecov]

Codecov Report

❌ Patch coverage is 91.48936% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 88.27%. Comparing base (09daad2) to head (f5e710d).

Files with missing lines	Patch %	Lines
src/cl_sii/rcv/data_models.py	82.60%	4 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #961      +/-   ##
===========================================
+ Coverage    88.19%   88.27%   +0.08%     
===========================================
  Files           40       40              
  Lines         3819     3846      +27     
  Branches       399      407       +8     
===========================================
+ Hits          3368     3395      +27     
  Misses         292      292              
  Partials       159      159              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

This PR refactors the data model for RCV (Registro de Compra y Venta) to improve handling of document references. Instead of storing document reference information in two separate fields (tipo_documento_referencia and folio_documento_referencia), the code now uses a single structured field that can hold multiple references.

Key changes:

• Introduced a new DocumentoReferencias TypedDict to encapsulate document reference data
• Replaced two separate fields with a single documento_referencias list field in RvDetalleEntry
• Added parsing logic to handle multiple document references from hyphen-separated folio values (e.g., "10370-10371")

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
src/cl_sii/rcv/data_models.py	Added DocumentoReferencias TypedDict and updated RvDetalleEntry to use documento_referencias field instead of separate tipo/folio fields
src/cl_sii/rcv/parse_csv.py	Updated CSV schema and added _parse_rv_documento_referencias function to parse and transform document references during CSV parsing
src/tests/test_rcv_parse_csv.py	Updated test expectations to use new documento_referencias field structure and added new test case for multiple document references
src/tests/test_rcv_data_models.py	Updated test fixture to use new documento_referencias field
src/tests/test_data/sii-rcv/RCV-venta-multiple-dte-referencias.csv	Added test data file with examples of multiple document references in hyphen-separated format

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[svillegas-cdd]

@jtrobles-cdd I updated the function get_documento_referencia_dte_natural_key to get_documento_referencia_dte_natural_keys to handle multiple references

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate failed

Failed conditions
14.9% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud