Cosmos.Contabilidad.Contratos 0.0.11

dotnet add package Cosmos.Contabilidad.Contratos --version 0.0.11
                    
NuGet\Install-Package Cosmos.Contabilidad.Contratos -Version 0.0.11
                    
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.Contabilidad.Contratos" Version="0.0.11" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Cosmos.Contabilidad.Contratos" Version="0.0.11" />
                    
Directory.Packages.props
<PackageReference Include="Cosmos.Contabilidad.Contratos" />
                    
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.Contabilidad.Contratos --version 0.0.11
                    
#r "nuget: Cosmos.Contabilidad.Contratos, 0.0.11"
                    
#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.Contabilidad.Contratos@0.0.11
                    
#: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.Contabilidad.Contratos&version=0.0.11
                    
Install as a Cake Addin
#tool nuget:?package=Cosmos.Contabilidad.Contratos&version=0.0.11
                    
Install as a Cake Tool

Cosmos.Contabilidad.Contratos

Contratos del sub-dominio de Contabilidad del ERP Cosmos. Este paquete contiene los records para comunicarse con el Motor de Traducción (N1) y recibir resultados de contabilización. Es agnóstico al transporte — no trae dependencias de mensajería.

Si usas Wolverine, instala además Cosmos.Contabilidad.Mensajeria para obtener el método de extensión HabilitarContabilidad.

Instalación

dotnet add package Cosmos.Contabilidad.Contratos

Novedades v0.0.11

  • ConceptoEconomico.TipoComponente y ContextoTransaccion.TipoTransaccion pasan de string a enum del paquete (TipoComponente, TipoTransaccion, en Cosmos.Contabilidad.Contratos.ServicioDeTraduccion.Modelos). Los enums son el catálogo publicado: un emisor solo puede nombrar tipos que Contabilidad conoce.
  • Viajan por el bus como valor numérico, igual que los demás contratos Cosmos. Los valores son explícitos y nunca se reordenan, reutilizan ni borran; un tipo nuevo exige una versión nueva del paquete.
  • El emisor debe migrar sus literales al enum ("cruce_obligacion" → TipoComponente.CruceObligacion, "causacion_gasto" → TipoTransaccion.CausacionGasto).
  • El formato del mensaje cambia respecto a 0.0.10: antes el campo viajaba como texto ("cruce_obligacion"), ahora como número (17). Un mensaje 0.0.10 no se lee con 0.0.11 ni al revés, así que el despliegue de emisor y Contabilidad es coordinado, con la cola vacía.

Novedades v0.0.9

  • La contrapartida viaja como una línea más (tipoComponente = "contrapartida"): con su tercero y su clasificación, pero sin valor ni unidad organizacional — el Motor calcula el valor (balance) y asigna la unidad. Antes el Motor generaba la contrapartida a partir del terceroPrincipal. [R54]
  • ReferenciaHechoRelacionado pasa a ser por línea (en LineaTraduccion), habilitando cruces y notas crédito donde cada línea referencia un hecho distinto. Se removió de Origen. [R53]
  • ConceptoEconomico.Valor y LineaTraduccion.UnidadOrganizacional ahora son opcionales (la línea de contrapartida los omite).

Tipos disponibles

Evento de entrada

Tipo Descripción
HechoEconomicoCreado Evento que envía las líneas de traducción de un hecho económico a Contabilidad para generar un borrador contable. Los sub-dominios transaccionales (OXP, CXC, Tesorería, etc.) lo publican cuando ocurre un hecho económico con impacto contable.

Eventos de salida

Tipo Descripción
HechoEconomicoContabilizado Contabilidad informa que el destino (SincoA&F) aceptó el borrador. Contiene el Origen y la referencia al asiento en el destino. [R17]
HechoEconomicoRechazado Contabilidad informa que la traducción falló. Contiene Motivo (código estructurado) y Detalle (descripción legible).

Modelos del contrato estandarizado

Tipo Descripción
LineaTraduccion Unidad mínima de información que un sub-dominio emite para ser traducida a contabilidad. Contiene ConceptoEconomico, Tercero, UnidadOrganizacional (opcional) y ReferenciaHechoRelacionado (opcional, por línea).
ConceptoEconomico TipoComponente (enum TipoComponente: Gasto, Iva, Retefuente, Contrapartida, …; viaja como número), Clasificacion (texto semántico de emparejamiento) y Valor (opcional — la línea de contrapartida no lo trae; lo calcula el Motor).
DatosTercero Nombre e identificación legal del tercero.
ContextoTransaccion Tipo de transacción (enum TipoTransaccion: CausacionGasto, NotaCreditoGasto, …; viaja como número), empresa, moneda, fecha y TerceroPrincipal. El TerceroPrincipal es el tercero del documento que envía el emisor (proveedor en causación/anticipo/nota crédito, banco/emisor en el extracto). Es informativo del hecho — el tercero de la contrapartida viaja en su propia línea.
Origen Referencia de origen única, sub-dominio y documento fuente.

Parámetros de HechoEconomicoCreado

Parámetro Tipo Descripción
Origen Origen Referencia de origen única, sub-dominio y documento fuente del hecho económico.
Transaccion ContextoTransaccion Tipo de transacción (enum TipoTransaccion: CausacionGasto, NotaCreditoGasto, …; viaja como número), empresa, moneda, fecha y tercero principal (informativo).
Lineas IReadOnlyList<LineaTraduccion> Líneas de traducción del hecho económico, todas de la misma empresa, moneda y referencia de origen. Cuando la plantilla del tipo de transacción tiene rol de contrapartida, debe incluirse exactamente una línea contrapartida.
Descripcion string? Descripción general del hecho económico (opcional).

Parámetros de la LineaTraduccion

Parámetro Tipo Descripción
ConceptoEconomico ConceptoEconomico Tipo de componente, clasificación y valor (opcional).
Tercero DatosTercero Tercero de la línea. En la línea de contrapartida es el tercero de la cuenta por pagar (proveedor, banco/emisor).
UnidadOrganizacional string? Unidad organizacional de la línea. La línea de contrapartida la omite (la asigna el Motor).
ReferenciaHechoRelacionado string? Referencia al hecho económico original cuando la línea deriva de otro (cruce, nota crédito, amortización). Habilita la resolución por espejo. null en hechos originales.

Parámetros de HechoEconomicoContabilizado

Parámetro Tipo Descripción
Origen Origen Referencia, sub-dominio y documento fuente.
ReferenciaDestino string Consecutivo o comprobante asignado por el sistema contable de destino (SincoA&F).
Destino string Sistema contable que aceptó (ej: AYF).

Parámetros de HechoEconomicoRechazado

Parámetro Tipo Descripción
Origen Origen Datos del origen del hecho económico rechazado.
Motivo MotivoRechazo Código estructurado del rechazo: ReferenciaOrigenDuplicadaNoReemplazable, TipoTransaccionSinPlantilla, LineaSinRolEnPlantilla, RolObligatorioSinLineas, DatosInvalidos.
Detalle string Descripción legible del rechazo.

Dependencias

Paquete Propósito
Cosmos.EventDriven.Abstractions Interfaz IPublicEvent para eventos que viajan por RabbitMQ.
Cosmos.Types Tipo Moneda para el contexto de transacción.
Cosmos.Types.IdentificacionesLegales Identificación legal del tercero.
Cosmos.Types.Paises País de la identificación legal.

Licencia

Software propietario © 2026 Sincosoft. Todos los derechos reservados.

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.Contabilidad.Contratos:

Package Downloads
Cosmos.Contabilidad.Mensajeria

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.0.11 300 9/25/2026
0.0.10-beta.1 175 9/17/2026
0.0.9-beta.1 379 7/22/2026
0.0.8 255 7/1/2026
0.0.7 180 7/1/2026
0.0.6 325 6/9/2026
0.0.5 200 6/2/2026
0.0.4 151 6/2/2026
0.0.4-beta.1 98 5/29/2026
0.0.3-beta.4 285 5/6/2026
0.0.3-beta.3 67 5/6/2026
0.0.3-beta.2 93 5/5/2026
0.0.3-beta.1 69 5/5/2026
0.0.3-beta 107 5/5/2026
0.0.2 144 4/27/2026
0.0.1 247 4/24/2026