Cosmos.Contabilidad.Contratos 0.1.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.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.