Cosmos.Contabilidad.Contratos 0.0.14

dotnet add package Cosmos.Contabilidad.Contratos --version 0.0.14
                    
NuGet\Install-Package Cosmos.Contabilidad.Contratos -Version 0.0.14
                    
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.14" />
                    
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.14" />
                    
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.14
                    
#r "nuget: Cosmos.Contabilidad.Contratos, 0.0.14"
                    
#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.14
                    
#: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.14
                    
Install as a Cake Addin
#tool nuget:?package=Cosmos.Contabilidad.Contratos&version=0.0.14
                    
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.14

  • LineaTraduccion gana la relación informativa entre líneas [R56]: IdComponente (string?, en las líneas principales) y ComponentePrincipal (string?, en las dependientes, apunta al IdComponente de su principal). Ambos opcionales, null por defecto y agregados al final. Contabilidad no los interpreta: los compara como texto exacto, los copia a cada partida del borrador y no cambian cuentas, terceros, unidades ni valores.
  • Nuevo motivo de rechazo MotivoRechazo.RelacionEntreLineasInvalida: la relación enviada es incoherente (dependiente sin principal, una línea con ambos campos, contrapartida con alguno, etc.).
  • Cambio aditivo: quien compila contra 0.0.13 sigue compilando, y un mensaje sin los campos se lee con ambos en null (líneas sueltas). El emisor no está obligado a actualizar.

Novedades v0.0.13

  • HechoEconomicoCreado gana Observaciones (string?, opcional, null por defecto), agregado al final, después de Descripcion. Es texto libre que el emisor quiere que llegue al sistema contable destino (SincoA&F) como observaciones del documento. Contabilidad lo reenvía sin transformarlo: lo guarda en el borrador, lo expone en la vista y lo entrega a AyF.
  • Cambio aditivo: quien compila contra 0.0.12 sigue compilando, y un mensaje sin el campo se lee con Observaciones = null (AyF recibe null, como hasta ahora). El emisor no está obligado a actualizar.
  • Orden de despliegue: Contabilidad antes que el emisor. Al revés no falla, pero las observaciones que mande el emisor se pierden en silencio.

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).
Observaciones string? Observaciones del documento para el sistema contable destino (opcional, desde 0.0.13). Contabilidad las reenvía tal cual llegan.

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.
IdComponente string? Solo en líneas principales: identifica el componente del hecho (desde 0.0.14). Si el componente se distribuye en varias líneas, todas llevan el mismo valor.
ComponentePrincipal string? Solo en líneas dependientes: el IdComponente de su principal (desde 0.0.14). Nunca junto con IdComponente; la contrapartida no lleva ninguno.

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, LineaContrapartidaFaltante, LineaConValorNoPositivo, RelacionEntreLineasInvalida.
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.14 185 10/5/2026
0.0.13 41 10/5/2026
0.0.11 359 9/25/2026
0.0.10-beta.1 178 9/17/2026
0.0.9-beta.1 380 7/22/2026
0.0.8 259 7/1/2026
0.0.7 185 7/1/2026
0.0.6 328 6/9/2026
0.0.5 203 6/2/2026
0.0.4 153 6/2/2026
0.0.4-beta.1 100 5/29/2026
0.0.3-beta.4 289 5/6/2026
0.0.3-beta.3 71 5/6/2026
0.0.3-beta.2 96 5/5/2026
0.0.3-beta.1 74 5/5/2026
0.0.3-beta 110 5/5/2026
0.0.2 148 4/27/2026
0.0.1 252 4/24/2026