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
<PackageReference Include="Cosmos.Types.TributosDeAutoridad" Version="1.0.0" />
<PackageVersion Include="Cosmos.Types.TributosDeAutoridad" Version="1.0.0" />
<PackageReference Include="Cosmos.Types.TributosDeAutoridad" />
paket add Cosmos.Types.TributosDeAutoridad --version 1.0.0
#r "nuget: Cosmos.Types.TributosDeAutoridad, 1.0.0"
#:package Cosmos.Types.TributosDeAutoridad@1.0.0
#addin nuget:?package=Cosmos.Types.TributosDeAutoridad&version=1.0.0
#tool nuget:?package=Cosmos.Types.TributosDeAutoridad&version=1.0.0
Cosmos.Types.TributosDeAutoridad
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. DesdeAutoridaddevuelvenullcuando el código no existe activo: país sin tabla, nulo o poison, código nulo, inexistente, inactivo o con otra grafía. Unnullno 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:
ZZse 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,33y36(componentes del impuesto al consumo de licores, INPP y ad valorem) se construyen igual que los demás, aunque el catálogo los marqueverificado: false; ese marcador no se expone. - No hay
Crearpúblico: la validación vive en unCrearinterno; la puerta pública esDesdeAutoridadyObtener. - Datos derivados (
Nombre,Descripcion,EsComodin): propiedades[JsonIgnore]resueltas del catálogo sin filtrar poractivo, 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 comoZZson iguales. ToString()devuelveCO: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)
- Se agrega
Obtener(pais, codigo)(lookup confiable que lanza), que la especificación no nombra. nombre(),descripcion()yesComodin()son propiedades (Nombre,Descripcion,EsComodin), según la convención de accessors derivados del repo.EsComodinesbool?:nulldice «no se sabe» en un valor rehidratado con un código que el paquete no conoce.tabla(pais)esTabla(pais)y devuelveTributoDeAutoridadválidos, no códigos sueltos.DesdeAutoridadexige 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).DesdeAutoridad,ObteneryTablareciben unPaistipado, no un texto.- La representación textual
pais:codigoqueda solo enToString(); la forma del cable es el objeto. verificadono 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 | 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.Abstractions (>= 1.1.1)
- Cosmos.Types.Paises (>= 1.1.1)
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 |