Cosmos.Types.Empresas 1.0.0

dotnet add package Cosmos.Types.Empresas --version 1.0.0
                    
NuGet\Install-Package Cosmos.Types.Empresas -Version 1.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="Cosmos.Types.Empresas" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Cosmos.Types.Empresas" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Cosmos.Types.Empresas" />
                    
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 Cosmos.Types.Empresas --version 1.0.0
                    
#r "nuget: Cosmos.Types.Empresas, 1.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 Cosmos.Types.Empresas@1.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=Cosmos.Types.Empresas&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Cosmos.Types.Empresas&version=1.0.0
                    
Install as a Cake Tool

Cosmos.Types.Empresas

NuGet

La empresa del tenant para el ERP Cosmos, en dos Value Objects:

  • FichaEmpresa — la ficha tal como la entrega la plataforma (razón social, tipo y número de identificación sin dígito de verificación, país, moneda funcional) con su versión. Guarda códigos de texto sin validar: una ficha con datos que no se pueden leer se conserva igual, para que un envío corregido la reemplace.
  • Empresa — la empresa validada que usan los procesos: razón social, IdentificacionLegal, Pais y la moneda funcional (enum Moneda).

Contrato de negocio: erp-definiciones/integraciones/entre-dominios/contrato-empresa-del-tenant.md.

Instalación

dotnet add package Cosmos.Types.Empresas

Uso

using Cosmos.Types.Empresas;

var ficha = new FichaEmpresa
{
    RazonSocial = "SINCOSOFT SAS",
    TipoIdentificacion = "NIT",
    Identificacion = "830021894",   // sin dígito de verificación: lo deriva IdentificacionLegal
    Pais = "CO",
    MonedaFuncional = "COP",
    Version = 3
};

// Regla de versión: reemplaza a la guardada si su versión es mayor o igual (o si no hay guardada).
if (ficha.Reemplaza(fichaGuardada))
    Guardar(ficha);

// Lectura: convierte los códigos en la Empresa validada, sin lanzar.
var resultado = ficha.Leer();
if (resultado.EsExitoso)
    UsarEmpresa(resultado.Valor);
else
    foreach (var error in resultado.Errores)
        Console.WriteLine(error.Codigo);

FichaEmpresa.Leer() reporta todos los problemas que encuentra, no solo el primero:

Código Significado
V01 El país no existe en el catálogo o no está activo.
V02 El tipo de identificación no existe (o no está activo) para el país.
V03 El número de identificación no es válido para su tipo; el mensaje incluye los errores de IdentificacionLegal.
V04 La moneda funcional no está soportada por enum Moneda.
V05 La razón social está vacía.

Las advertencias de IdentificacionLegal (si las hay) acompañan a la empresa leída.

Empresa.Crear(razonSocial, identificacion, monedaFuncional) compone valores ya tipados y valida solo lo suyo: V01 identificación nula, V02 razón social vacía y V03 moneda fuera del enum. El país se deriva de la identificación. La razón social se guarda recortada y con los espacios colapsados.

Forma serializada

{
  "razonSocial": "SINCOSOFT SAS",
  "identificacion": { "tipoDocumento": "NIT", "numero": "830021894", "pais": { "codigo": "CO" }, "digitoVerificacion": "…" },
  "pais": { "codigo": "CO" },
  "monedaFuncional": "COP"
}

La moneda funcional viaja con su código ISO 4217 (no con el número del enum). FichaEmpresa serializa sus seis campos tal como llegaron (razonSocial, tipoIdentificacion, identificacion, pais, monedaFuncional, version). Las claves son camelCase ancladas con [JsonPropertyName].

Rehidratación (deserialización)

No requiere setup. Los dos VO se rehidratan crudos ([JsonConstructor]), sin validar: una empresa guardada con datos que hoy ya no cumplen las reglas igual se rehidrata.

Dependencias

  • Cosmos.Types (enum Moneda)
  • Cosmos.Types.Abstractions (kernel: Result<T>)
  • Cosmos.Types.Paises
  • Cosmos.Types.IdentificacionesLegales

Requiere net10.0.

Documentación

Licencia

Uso interno del ERP Cosmos.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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 (1)

Showing the top 1 NuGet packages that depend on Cosmos.Types.Empresas:

Package Downloads
ObligacionesPorPagar.TenantProvisioning.Contratos

Contratos que publica el worker de tenant provisioning de Obligaciones por Pagar hacia los demás servicios de OXP: la ficha de la empresa de cada tenant.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 132 11/9/2026