FaaST_Fintec_ResourcesDev 6.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package FaaST_Fintec_ResourcesDev --version 6.0.0
                    


                    

                
NuGet\Install-Package FaaST_Fintec_ResourcesDev -Version 6.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FaaST_Fintec_ResourcesDev" Version="6.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FaaST_Fintec_ResourcesDev" Version="6.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FaaST_Fintec_ResourcesDev" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FaaST_Fintec_ResourcesDev --version 6.0.0
                    


                    

                
#r "nuget: FaaST_Fintec_ResourcesDev, 6.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package FaaST_Fintec_ResourcesDev@6.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=FaaST_Fintec_ResourcesDev&version=6.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FaaST_Fintec_ResourcesDev&version=6.0.0
                    


                            Install as a Cake Tool

FaaST.Fintec.Resources.Library

Librería de recursos compartidos para operaciones de factoring en Latinoamérica.

Países Soportados

País Código Documento Impuesto Cliente Deudor Ubicación
Chile CL RUT IVA 19% Cliente Deudor Comuna / Región
Perú PE RUC IGV 18% Cedente Aceptante Distrito / Departamento
Colombia CO NIT IVA 19% Proveedor Aceptante Municipio / Departamento

Instalación

dotnet add package FaaST_Fintec_Resources

Uso Básico

using FaaST.Fintec.Resources.Library;

// Obtener estrategia por país
var strategy = ResourcesFactory.ObtenerEstrategia("CL"); // Chile
var strategy = ResourcesFactory.ObtenerEstrategia("PE"); // Perú
var strategy = ResourcesFactory.ObtenerEstrategia("CO"); // Colombia

// Usar el servicio
var service = new FactoringResourcesService(strategy);

// Validar documento
var resultado = await service.ValidarNumeroDocumento("12345678-9");

// Obtener persona por documento
var persona = await service.ObtenerPersonaPorNumeroDocumento("12345678-9");

// Calcular interés
var interes = await service.CalcularInteres(request);

Funcionalidades por País

Chile (CL)

Funcionalidad Estado
Validación RUT Disponible
Consulta SII Disponible
Documentos DTE Disponible
Cesiones electrónicas Disponible
Experian Disponible
Equifax Disponible
SBIF Disponible
EFA Disponible
TGR Disponible
Indicadores de cartera Disponible
Cálculo de interés Disponible

Perú (PE)

Funcionalidad Estado
Validación RUC Disponible
Consulta SUNAT Disponible
Sentinel Disponible
CAVALI (E04007-E04016) Disponible
Indicadores de cartera Disponible
Cálculo de interés Disponible

Colombia (CO)

Funcionalidad Estado
Validación NIT Disponible
Cálculo de interés Disponible
Redondeo de montos Disponible
Configuraciones país Disponible
Consulta DIAN No disponible
Indicadores de cartera No disponible
Burós de crédito No disponible
Validación de NIT Colombiano

La librería valida el NIT colombiano incluyendo el dígito de verificación:

var strategy = ResourcesFactory.ObtenerEstrategia("CO");

// NIT de 9 dígitos (sin DV) - Solo valida formato
strategy.ValidarNumeroDocumento("123456789");

// NIT de 10 dígitos (con DV) - Valida formato y dígito de verificación
strategy.ValidarNumeroDocumento("1234567890");

// Acepta formatos con puntos y guiones
strategy.ValidarNumeroDocumento("123.456.789-0");

El algoritmo de validación del dígito de verificación utiliza los números primos establecidos por la DIAN: [71, 67, 59, 53, 47, 43, 41, 37, 29, 23, 19, 17, 13, 7, 3].

Etiquetas Colombia
var configuraciones = strategy.ObtenerConfiguraciones();

// Etiquetas disponibles:
// ETIQUETA_IDENTIFICACION = "NIT"
// ETIQUETA_CLIENTE = "Proveedor"
// ETIQUETA_DEUDOR = "Aceptante"
// ETIQUETA_PAGADOR = "Pagador"
// ETIQUETA_PROVEEDOR = "Proveedor"
// ETIQUETA_IMPUESTO = "IVA"
// ETIQUETA_COMUNA = "Municipio"
// ETIQUETA_REGION = "Departamento"
// VALOR_IMPUESTO = "19"
Métodos No Disponibles para Colombia

Los siguientes métodos retornan respuestas dummy (StatusCode 200 con mensaje "Método no disponible para Colombia"):

  • DIAN: ObtenerPersonaPorNumeroDocumento, ValidarDocumentoElectronico, ObtenerIndicadoresTributarios
  • Indicadores de Cartera: Todos los métodos de indicadores
  • Documentos Electrónicos SII: ObtenerDocumentoElectronico, ObtenerDocumentoElectronicoCesion, etc.
  • Burós Chile: Experian, Equifax, SBIF, EFA, TGR
  • Burós Perú: Sentinel
  • CAVALI: E04007, E04008, E04009, E04011, E04012, E04013, E04016A, E04016B

Arquitectura

La librería implementa el Strategy Pattern para manejar las diferencias entre países:

IFactoringResources (Interface)
    ├── ChileFactoringStrategy
    ├── PeruFactoringStrategy
    └── ColombiaFactoringStrategy

Requisitos

  • .NET 8.0

Dependencias

  • HtmlAgilityPack
  • Nancy
  • Polly

Licencia

MIT

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
6.0.0 117 1/6/2026

v6.0.0
     - BREAKING CHANGE: Soporte exclusivo para .NET 8.0 (eliminado netcoreapp3.1)

     v5.2.3
     - Colombia: Ajuste de etiquetas.
     
     v5.2.0:
     - Colombia: Implementación de respuestas dummy para métodos no disponibles
     - Colombia: Métodos de indicadores de cartera retornan respuestas vacías (9 métodos)
     - Colombia: Métodos de documentos electrónicos SII retornan respuestas dummy (10 métodos)
     - Colombia: Métodos de burós de crédito Chile retornan respuestas dummy (7 métodos)
     - Colombia: Métodos de Sentinel Perú retornan respuestas dummy (1 método)
     - Colombia: Métodos CAVALI Perú retornan respuestas dummy (8 métodos)
     - Colombia: Métodos DIAN retornan respuestas dummy (3 métodos)
     - Los microservicios que usen Colombia no fallarán por métodos no implementados

     v5.1.0:
     - Agregado soporte para Colombia (CO)
     - Implementación de ColombiaFactoringStrategy
     - Validación de NIT colombiano con dígito de verificación
     - Configuraciones de etiquetas para Colombia (NIT, IVA 19%, Municipio, Departamento)
     - Métodos de indicadores de cartera para Colombia

     v5.0.11:
     - Agregado campo TipoCambio a ObtenerIndicadoresCarteraDeudor
     - Agregado campo TipoCambio a ObtenerIndicadoresCarteraPagador
     - Implementado método ValidarEnrolamientoContribuyente
     - Implementación de endpoints para obtener los detalles de indicador cartera.
     - Implementación de columnas en los detalles de los indicadores.
     - Implementación de indicador experian
     - Implementación de indicador SENTINEL
     - Implementación del campo AncladoResumen
     - Impementación de endpoints 4009 y 4007 de cavali
     - Implementación del campo code cache para congelar indicadores SUNAT y SENTINEL
     - Implementación del campo code cache consulta RUC
     - Implementación del campo code cache SENTINEL y SUNAT
     - Implementación para la homologación con CHILE
     - Implementación de cálculos de interés
     - Implementación proyecto de prueba
     - Implementación de indicadores para CHILE
     - Implementación para objetos con URLs
     - Implementación para obtener documentos Dte
     - Cambio en el retorno de variables públicas.
     - Implementación de etiquetas para pagador y proveedor.
     - Redondeo de montos.
     - Corrección de RUC x RUT.
     - Se incluye de forma dinámica los anclados.
     - Se incluye indicador para los deudores.
     - Implementación de nuevos endpoints para enrolamiento y verificación.
     - Implementación de ObtenerIndicadoresCarteraDeudor para Perú
     - Adición de campos en clase DteContribuyenteEntity
     - Implementación de ObtenerIndicadoresCarteraPagador