Cosmos.Contabilidad.Contratos 0.3.0

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.3.0

• Nuevo SolicitarSuspensionHechoEconomico(Origen, Motivo, UsuarioId) (evento de entrada): el emisor pide suspender el borrador de su hecho económico (por ejemplo, porque va a corregir el documento y reenviarlo). Se valida al construirse, también con with: origen obligatorio, y Motivo y UsuarioId no pueden ser nulos, vacíos ni espacios (ArgumentException).

• Dos respuestas nuevas (eventos de salida): SuspensionHechoEconomicoRealizada(Origen, Fecha) cuando quedó suspendido (también si el hecho no existe o ya estaba suspendido), y SuspensionHechoEconomicoRechazada(Origen, MotivoCodigo, MotivoDetalle, Fecha) cuando no se puede.

• MotivosRechazoSuspension viaja como número; los valores son explícitos y nunca se reordenan:

  Valor	Motivo	Tipo	Qué hace el emisor
  1	BorradorEnEnvio	Transitorio	El borrador está en envío al sistema contable; si este lo rechaza se podrá suspender. Reintentar más tarde.
  2	HechoContabilizado	Definitivo	El asiento ya está contabilizado; no se suspende, se anula en el sistema contable.

• Canal: el mismo de hoy. La solicitud entra por el forward y las respuestas salen por el reverse (contabilidad-respuestas); no hace falta topic ni suscripción nuevos.

• Cambio aditivo: quien compila contra 0.2.0 sigue compilando y no necesita actualizar si no usa la suspensión.

• Orden de despliegue: Contabilidad antes de que el emisor empiece a enviar la solicitud; si el emisor se adelanta, la solicitud no tiene quién la atienda.

Novedades v0.2.0

• Nuevo VO ReferenciaDeHecho(Tipo, Id) (cambio que rompe compilación): reemplaza el texto en Origen.ReferenciaOrigen (string → ReferenciaDeHecho) y en LineaTraduccion.ReferenciaHechoRelacionado (string? → ReferenciaDeHecho?). El emisor entrega el tipo del hecho (comercio, anticipo, …) y su id (Guid) por separado; el texto "{tipo}-{id}" lo arma Contabilidad con ToString(), así que el emisor ya no necesita conocer ese formato.
• Tipo se guarda en minúsculas y no puede estar vacío ni contener -; Id no puede ser Guid.Empty. ReferenciaDeHecho.Parse("comercio-<guid>") lee el texto.
• Por el bus viaja como objeto: {"Tipo":"comercio","Id":"<guid>"}. Un mensaje 0.1.0 (referencia como texto) no se lee con 0.2.0 ni al revés.
• Migración del emisor: new Origen("comercio-" + id, …) → new Origen(new ReferenciaDeHecho("comercio", id), …); igual en ReferenciaHechoRelacionado. En HechoEconomicoRecibido y HechoEconomicoContabilizado, el Origen.ReferenciaOrigen llega como ReferenciaDeHecho: el emisor la empata por Tipo e Id, o por ToString().
• Despliegue coordinado, con la cola vacía: Contabilidad y el emisor salen con 0.2.0 a la vez.

Novedades v0.1.0

• Nuevo HechoEconomicoRecibido(Origen, Fecha): el acuse. Contabilidad lo publica en cuanto guarda el hecho, por el mismo topic de respuestas (contabilidad-respuestas). Dice "Contabilidad lo tiene"; no dice si se tradujo ni si se contabilizó.
• Eliminado HechoEconomicoRechazado (y MotivoRechazo): Contabilidad ya no le devuelve rechazos al emisor. Lo que no puede traducir queda en su propia bandeja, con su motivo, y lo resuelve Contabilidad. Al emisor solo le llegan el acuse y HechoEconomicoContabilizado.
• Validación en los constructores (cambio de comportamiento): armar un record con datos que el contrato no admite lanza ArgumentException en el new, y también con with. Se valida: origen con referencia y subdominio; hecho con origen, transacción y al menos una línea; transacción con tercero principal; tercero con nombre no vacío e identificación; línea con concepto y tercero; valor nunca negativo. "Nulo solo en la contrapartida" lo valida Contabilidad, porque depende de la plantilla.
• Orden de despliegue: (1) publicar 0.1.0; (2) desplegar Contabilidad; (3) desplegar el emisor con 0.1.0 completo: consumir el acuse, quitar su consumer de HechoEconomicoRechazado y asegurar que sus mappers no armen datos que el constructor rechace. No hace falta topic ni suscripción nuevos.

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 (eliminado en 0.1.0): 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

Eventos de salida

Modelos del contrato estandarizado

Parámetros de HechoEconomicoCreado

Parámetros de la LineaTraduccion

Parámetros de HechoEconomicoContabilizado

Parámetros de HechoEconomicoRecibido

Dependencias

Licencia

Software propietario © 2026 Sincosoft. Todos los derechos reservados.