Cosmos.Impuestos.Contratos 0.1.3-beta

Cosmos.Impuestos.Contratos

Mensajes y servicios gRPC públicos de Cosmos Impuestos: distribuye los archivos .proto (impuestos.proto, perfil_fiscal.proto) para que un consumidor compile sus propios stubs y se integre con los servicios desde otro bounded context.

Este paquete distribuye .proto fuente, no stubs precompilados. El consumidor compila los protos en su propio proyecto.

Instalación

Ambos paquetes son obligatorios:

<PackageReference Include="Cosmos.Impuestos.Contratos" Version="0.1.3-beta" />
<PackageReference Include="Cosmos.Impuestos.Grpc.Types" Version="0.1.0-beta" />
<PackageReference Include="Grpc.Net.Client" Version="2.80.0" />
<PackageReference Include="Grpc.Tools" Version="2.80.0">
    <PrivateAssets>all</PrivateAssets>
</PackageReference>

Cosmos.Impuestos.Grpc.Types provee DecimalValue (con conversión implícita a/desde decimal) y los enums comunes (PaisProto, MonedaProto, etc.). No se hereda transitivamente desde Contratos — debe declararse explícitamente.

Compilar los .proto consumidos

<ItemGroup>
    <Protobuf Include="$(CosmosImpuestosContratosProtoPath)Protos\impuestos.proto"
              GrpcServices="Client" />
    <Protobuf Include="$(CosmosImpuestosContratosProtoPath)Protos\perfil_fiscal.proto"
              GrpcServices="Client" />
</ItemGroup>

Las variables MSBuild $(CosmosImpuestosContratosProtoPath) y $(CosmosImpuestosGrpcTypesProtoPath) apuntan al directorio de los .proto empaquetados. El .props de Cosmos.Impuestos.Grpc.Types añade automáticamente su path como AdditionalImportDirs, así que import "Protos/tipos_comunes.proto" resuelve sin configuración adicional.

Namespaces

using Cosmos.Impuestos.Comandos.Grpc;   // ImpuestosService, SolicitudCalculoRequest, etc.
using Cosmos.Impuestos.Consultas.Grpc;  // PerfilFiscalService, PerfilTributarioResponse, etc.
using Cosmos.Impuestos.Grpc.Types;      // DecimalValue, PaisProto, MonedaProto, enums

Servicios

Registro en DI

builder.Services
    .AddGrpcClient<ImpuestosService.ImpuestosServiceClient>(o =>
        o.Address = new Uri("https://impuestos-comandos:PORT"))
    .AddGrpcClient<PerfilFiscalService.PerfilFiscalServiceClient>(o =>
        o.Address = new Uri("https://impuestos-consultas:PORT"));

Inicio rápido — flujo Calcular → Confirmar

Calcular

var request = new SolicitudCalculoRequest
{
    IdentificacionEmisora       = new IdentificacionFiscalCalculoProto { Numero = "900123456", TipoDocumento = "NIT", Pais = PaisProto.Co },
    IdentificacionContraparte   = new IdentificacionFiscalCalculoProto { Numero = "800987654", TipoDocumento = "NIT", Pais = PaisProto.Co },
    Ubicaciones                 = new UbicacionesTransaccionProto { SedeEmisora = "SEDE-001", SedeContraparte = "SEDE-002" },
    DireccionFiscal             = DireccionFiscalProto.Gasto,
    FechaTransaccion            = "2026-05-07",   // ISO 8601
    Moneda                      = MonedaProto.Cop
};
request.Conceptos.Add(new ConceptoCalculoProto
{
    Id = Guid.CreateVersion7().ToString(),
    ClasificacionTributaria = "BIEN",
    Monto = 1_000_000m           // decimal → DecimalValue implícito
});

var resultado = await _impuestosClient.CalcularAsync(request, cancellationToken: ct);

Leer resultado

foreach (var linea in resultado.Aplicados)
{
    decimal valor = linea.Valor;   // DecimalValue → decimal implícito
    Console.WriteLine($"{linea.NombreTributo}: {valor:C}");
}

LineaDescartadaProto.Tarifa y Valor son optional: verificar HasTarifa / HasValor antes de leer cuando el motivo de exclusión puede no tener tarifa asociada.

Confirmar

var confirmar = new ConfirmarRegistroRequest
{
    Contexto = new ContextoTransaccionalProto
    {
        SubDominio      = SubDominioProto.Oxp,
        TransaccionId   = Guid.CreateVersion7().ToString(),
        DireccionFiscal = DireccionFiscalProto.Gasto,
        EfectoFiscal    = EfectoFiscalProto.Gravamen
    },
    FechaTransaccion        = "2026-05-07",
    Moneda                  = MonedaProto.Cop,
    IdentificacionEmisora   = request.IdentificacionEmisora,
    IdentificacionContraparte = request.IdentificacionContraparte,
    Ubicaciones             = request.Ubicaciones
};
confirmar.DesgloseConfirmado.AddRange(resultado.Aplicados);
confirmar.Conceptos.AddRange(request.Conceptos);

await _impuestosClient.ConfirmarAsync(confirmar, cancellationToken: ct);

Perfil fiscal

var perfil = await _perfilClient.ResolverPerfilFiscalAsync(
    new ResolverPerfilFiscalRequest { Numero = "900123456", TipoDocumento = "NIT", Pais = PaisProto.Co },
    cancellationToken: ct);

foreach (var atributo in perfil.Atributos)
{
    string fuente = atributo.HasFuenteDeAutoridad ? atributo.FuenteDeAutoridad.Tipo : "sin fuente";
    Console.WriteLine($"{atributo.Nombre} = {atributo.Valor} ({fuente})");
}

Tipos de referencia (provistos por Cosmos.Impuestos.Grpc.Types)