Cosmos.Types.TributosDeAutoridad 1.0.0

dotnet add package Cosmos.Types.TributosDeAutoridad --version 1.0.0
                    
NuGet\Install-Package Cosmos.Types.TributosDeAutoridad -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.TributosDeAutoridad" 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.TributosDeAutoridad" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Cosmos.Types.TributosDeAutoridad" />
                    
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.TributosDeAutoridad --version 1.0.0
                    
#r "nuget: Cosmos.Types.TributosDeAutoridad, 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.TributosDeAutoridad@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.TributosDeAutoridad&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Cosmos.Types.TributosDeAutoridad&version=1.0.0
                    
Install as a Cake Tool

Cosmos.Types.TributosDeAutoridad

NuGet

TributoDeAutoridad — Value Object del tributo tal como lo nombra la autoridad fiscal de un país: el país más el código que la autoridad le asigna (el 02 de la DIAN es el impuesto al consumo departamental). Catálogo embebido de Colombia (tabla 13.2.2 «Tributos» del anexo técnico de la factura electrónica, 22 códigos con ZZ como comodín). Sirve para que quien lee un documento (p. ej. Radicación) y quien lo registra (p. ej. Impuestos) nombren el mismo impuesto de la misma forma sin traducirlo: la traducción a un tributo propio (02 → IC) es del consumidor, no de este paquete. Viaja dentro de eventos event-sourced (JSONB), por lo que su forma serializada es un contrato estable.

Instalación

dotnet add package Cosmos.Types.TributosDeAutoridad

Uso

using Cosmos.Types.Paises;
using Cosmos.Types.TributosDeAutoridad;

var colombia = Pais.Obtener("CO");

// Desde el código que trae un documento: null si no existe activo. Nunca lanza.
var consumo = TributoDeAutoridad.DesdeAutoridad(colombia, "02");
consumo?.Nombre;        // "IC"
consumo?.Descripcion;   // texto del catálogo
consumo?.EsComodin;     // false

TributoDeAutoridad.DesdeAutoridad(colombia, "99");   // null (no existe)
TributoDeAutoridad.DesdeAutoridad(colombia, "2");    // null (sin cero a la izquierda)

// Lookup confiable, para un código que el desarrollador conoce: lanza ArgumentException si no existe activo.
var comodin = TributoDeAutoridad.Obtener(colombia, "ZZ");
comodin.EsComodin;      // true: el nombre lo asigna el emisor y este tipo no lo lleva

// Tabla de códigos activos del país, en el orden de la autoridad, para la elección manual.
TributoDeAutoridad.Tabla(colombia);                  // 22 tributos; vacía para DO, PA o un país sin tabla
  • Sin normalización: el código se compara tal cual, en forma ordinal. "2", "zz", " 02" y "02 " no existen.
  • DesdeAutoridad devuelve null cuando el código no existe activo: país sin tabla, nulo o poison, código nulo, inexistente, inactivo o con otra grafía. Un null no distingue «no existe» de «mi versión del paquete es vieja»: el consumidor debe conservar el código crudo del documento para reconocerlo al actualizar el paquete.
  • El comodín es válido: ZZ se construye como cualquier otro código. El nombre libre que le pone el emisor no viaja en este tipo; lo conserva el consumidor.
  • Los códigos 32, 33 y 36 (componentes del impuesto al consumo de licores, INPP y ad valorem) se construyen igual que los demás, aunque el catálogo los marque verificado: false; ese marcador no se expone.
  • No hay Crear público: la validación vive en un Crear interno; la puerta pública es DesdeAutoridad y Obtener.
  • Datos derivados (Nombre, Descripcion, EsComodin): propiedades [JsonIgnore] resueltas del catálogo sin filtrar por activo, de modo que un evento histórico siga mostrando su nombre aunque el código se inactive.
  • Igualdad: por valor, sobre (Pais, Codigo). Dos tributos distintos que el documento trae como ZZ son iguales.
  • ToString() devuelve CO:02, solo para mostrar y registrar.

Forma serializada

{ "pais": { "codigo": "CO" }, "codigo": "02" }

Claves camelCase ancladas con [JsonPropertyName]. CO:02 no es la forma del cable. Nombre, Descripcion y EsComodin no viajan en el evento.

Rehidratación

La rehidratación ([JsonConstructor] + propiedades init) no valida ni lanza: un evento con un código que el catálogo de esta versión no conoce, o con país o código nulos, se carga igual. En ese caso Nombre, Descripcion y EsComodin devuelven null. Quien reciba un Nombre == null debe tratarlo como «código que mi versión no conoce», no como un error.

Datos embebidos

Archivo Contenido
tributos-de-autoridad.json Colombia: 22 códigos (01–08, 20–26, 30, 32–36 y el comodín ZZ). República Dominicana y Panamá figuran sin códigos hasta que se completen sus tablas

Procedencia: copia sin modificar del archivo compartido/nuggets/tributo-de-autoridad/tributos-de-autoridad.json de erp-definiciones en el commit efcae68f9ca609dcb897deda2274e028847f3b81 (blob 9c644ab0fc9fceac40c75a11a39bc62bda002209). Los textos que devuelve el paquete son los de ese archivo.

Diferencias con la especificación del Nugget (v0.1)

  1. Se agrega Obtener(pais, codigo) (lookup confiable que lanza), que la especificación no nombra.
  2. nombre(), descripcion() y esComodin() son propiedades (Nombre, Descripcion, EsComodin), según la convención de accessors derivados del repo. EsComodin es bool?: null dice «no se sabe» en un valor rehidratado con un código que el paquete no conoce.
  3. tabla(pais) es Tabla(pais) y devuelve TributoDeAutoridad válidos, no códigos sueltos.
  4. DesdeAutoridad exige que el código esté activo, no solo que exista (la especificación lo pide en la regla V02 y no en la descripción de la operación).
  5. DesdeAutoridad, Obtener y Tabla reciben un Pais tipado, no un texto.
  6. La representación textual pais:codigo queda solo en ToString(); la forma del cable es el objeto.
  7. verificado no se lee ni se expone.

Hallazgos sobre la especificación v0.1

# Hallazgo Qué hace el paquete
H1 El ejemplo de descripcion() da el nombre oficial («Impuesto al Consumo Departamental Nominal»); el JSON trae para 02 y 08 un texto editorial más largo Devuelve el texto del JSON
H2 V02 exige «activo a la fecha de consulta», pero los datos solo traen activo: bool; un código inactivado después impide construir un documento emitido cuando estaba vigente Booleano del paquete
H3 La operación desdeAutoridad no nombra activo; V02 y tabla(pais) sí Sigue V02
H4 verificado aparece en los datos pero en ninguna operación ni regla Se ignora
H5 La representación pais:codigo no dice si es la forma del cable ni hay operación para leerla Solo ToString()
H6 tabla(pais) no dice si devuelve códigos o Nuggets Devuelve Nuggets
H7 esComodin() es booleano y no cubre el valor rehidratado con un código desconocido bool?
H8 Cada fila repite pais, que ya es la clave de su tabla; pueden divergir al completar DO y PA Test de integridad
H9 Un borrador v0.1 se publica como 1.0.0: un cambio de API que salga de la revisión es versión mayor —
H10 La tabla 13.2.2 «de la versión 1.9» vive desde la 1.8 en el Excel de la Caja de herramientas de la DIAN, no en el PDF —
H11 Los nombres del JSON no son los literales de la DIAN: ZZ es «Nombre de la figura tributaria» (no «Otro»), 05 es RETEIVA (no ReteIVA), 07 es ReteIca (no ReteICA), la descripción de 36 es «AD VALOREM» y la de 32 «Impuesto al Consumo de Licores» Devuelve el texto del JSON
H12 La DIAN valida el ad valorem como nominal por unidad; el libro lo describe como componente porcentual Es del consumidor
H13 Con igualdad por (pais, codigo), dos tributos distintos traídos como ZZ son iguales y la comparación por código queda ambigua Igualdad por (pais, codigo)
H14 El contrato que lleva el tributo entre dominios no tiene campo de nombre: un ZZ llega sin el nombre que el emisor le puso Es del contrato del consumidor

Pendiente de la especificación: completar las tablas de República Dominicana (e-CF de la DGII) y Panamá (CAFE de la DGI).

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.TributosDeAutoridad:

Package Downloads
Cosmos.Impuestos.Contratos

Eventos públicos de integración de Cosmos Impuestos (IPublicEvent) para consumidores en otros bounded contexts.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 162 11/10/2026