Cosmos.Impuestos.Contratos 0.1.2-beta

Cosmos.Impuestos.Contratos

Stubs gRPC, mensajes Protobuf y tipos compartidos para integrarse con los servicios de Cosmos Impuestos desde otro bounded context.

El paquete incluye los clientes y el servidor generados (GrpcServices="Both"), los archivos .proto originales y la conversión implícita decimal ↔ DecimalValue. El consumidor no necesita Grpc.Tools ni compilar protos.

Instalación

<PackageReference Include="Cosmos.Impuestos.Contratos" Version="0.1.2-beta" />
<PackageReference Include="Grpc.Net.Client" Version="2.71.0" />

Namespace único

using Cosmos.Impuestos.Contratos;

Todos los tipos generados, clientes gRPC y DecimalValue viven en este namespace.

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)
{
    // FuenteDeAutoridad es optional: verificar HasFuenteDeAutoridad antes de leer
    string fuente = atributo.HasFuenteDeAutoridad ? atributo.FuenteDeAutoridad.Tipo : "sin fuente";
    Console.WriteLine($"{atributo.Nombre} = {atributo.Valor} ({fuente})");
}

DecimalValue

Conversiones implícitas bidireccionales incluidas — no se necesita código adicional:

decimal monto = lineaAplicada.Valor;   // DecimalValue → decimal
request.Monto = 500_000.50m;           // decimal → DecimalValue

Tipos de referencia

Archivos .proto

Los .proto fuente se incluyen en el paquete bajo build/native/include/Protos/ para referencia. La variable MSBuild $(CosmosImpuestosContratosProtoPath) apunta a ese directorio si se requiere reutilizar tipos en un proto propio.