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
<PackageReference Include="Cosmos.Types.Empresas" Version="1.0.0" />
<PackageVersion Include="Cosmos.Types.Empresas" Version="1.0.0" />
<PackageReference Include="Cosmos.Types.Empresas" />
paket add Cosmos.Types.Empresas --version 1.0.0
#r "nuget: Cosmos.Types.Empresas, 1.0.0"
#:package Cosmos.Types.Empresas@1.0.0
#addin nuget:?package=Cosmos.Types.Empresas&version=1.0.0
#tool nuget:?package=Cosmos.Types.Empresas&version=1.0.0
Cosmos.Types.Empresas
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,Paisy 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.PaisesCosmos.Types.IdentificacionesLegales
Requiere net10.0.
Documentación
Licencia
Uso interno del ERP Cosmos.
| Product | Versions 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. |
-
net10.0
- Cosmos.Types (>= 1.3.1)
- Cosmos.Types.Abstractions (>= 1.1.1)
- Cosmos.Types.IdentificacionesLegales (>= 2.0.0)
- Cosmos.Types.Paises (>= 1.1.1)
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 |