ObligacionesPorPagar.Entradas.Contratos 5.3.0

ObligacionesPorPagar.Entradas.Contratos

Contratos de eventos públicos del módulo de Entradas de Obligaciones por Pagar (OxP). Este paquete expone los eventos de dominio y modelos compartidos necesarios para que sistemas externos reaccionen a las operaciones confirmadas en el módulo.

Instalación

dotnet add package ObligacionesPorPagar.Entradas.Contratos

Eventos disponibles

Todos los eventos implementan IPublicEvent de Cosmos.EventDriven.Abstractions.

Modelos compartidos

Los eventos utilizan los siguientes records como componentes reutilizables:

Cambios 5.3.0

Tipo y confiabilidad de los impuestos, para que el radicador compare contra el motor de Impuestos sin falsos avisos. Todo aditivo: un consumidor en 5.2.x ignora los campos nuevos.

• ImpuestoEvento.Tipo — nuevo, TipoImpuesto? (Iva, Inc, Otro), último parámetro con default null. Tipo canónico del impuesto, independiente de cómo lo escribe Nombre. Otro = no comparable por tipo.
  • Desde Reconocimiento: el que elige el reconocedor.
  • Desde Recepción Electrónica: el código de tributo DIAN (01 → Iva, 04 → Inc, cualquier otro → Otro).
  • null = no informado: evento anterior, impuesto de RE sin código, o un valor que este contrato aún no conoce.
• TotalEvento.VerificacionImpuestos — nuevo, VerificacionImpuestos? (Cuadra, NoCuadra, SinCifras), último parámetro con default null. Indica si Total.Impuestos explica TotalAPagar − Subtotal impresos (tolerancia 1 % del total). Solo lo informa el Comercio de Reconocimiento; null = no se evaluó (Devolución, Recepción Electrónica, eventos anteriores). Nunca se asume Cuadra.
• ProcedenciaImpuesto.SinVerificar — miembro nuevo al final: impuesto de línea que ninguna cifra impresa valida. Antes viajaba como null. Aviso: un switch sobre ProcedenciaImpuesto sin rama por defecto verá un valor nuevo.

Cambios 5.2.0

• DocumentoParaRadicar.Notas — nuevo, string?, propiedad init (no cambia el constructor). Notas que el emisor escribió en el documento, completas y sin recortar (pueden pasar de 4.000 caracteres, con saltos de línea): suelen ser texto legal o tributario. Recepción Electrónica las envía en ComercioParaRadicar y DevolucionParaRadicar; viajan aparte de Descripcion para que el consumidor decida dónde usarlas. null = sin notas. Aditivo: un consumidor en 5.1.x ignora el campo.
• ComercioParaRadicar ahora también llega desde Recepción Electrónica para los documentos equivalentes (DE, p. ej. tiquetes aéreos), con Descripcion = "DE". No cambia el contrato.

Cambios 5.1.0

• DocumentoParaRadicar.ArchivosAdicionales — nuevo, IReadOnlyList<StorageInfo>?, propiedad init (no cambia el constructor). Archivos que acompañan al documento además de Archivo, que sigue siendo el principal. Recepción Electrónica envía aquí el XML de la factura (ComercioParaRadicar y DevolucionParaRadicar). null = sin adicionales. Aditivo: un consumidor en 5.0.x ignora el campo, y los archivos que traiga se pierden para él.

Cambios 5.0.0 (breaking)

• ConceptoCompletoEvento.Cantidad pasó de int? a decimal?. Recepción Electrónica entrega cantidades fraccionarias (0.5 kg, 2.5 horas) que el entero truncaba. Un consumidor en 4.x no deserializa un 2.5 (ni un 2.00) en int?: debe actualizarse antes de que Entradas publique con esta versión.
• ComercioParaRadicar y DevolucionParaRadicar ya no incluyen conceptos con Cantidad menor o igual a 0. El concepto sin cantidad (null) se sigue entregando.

Cambios 4.5.0

• CanalIngreso.RecepcionElectronica — nuevo valor, agregado al final del enum para no mover los existentes (Manual = 0, Correo = 1, RecepcionElectronica = 2). Todo documento que Entradas trae de Recepción Electrónica (ComercioParaRadicar y DevolucionParaRadicar con FuenteTipo.RecepcionElectronica) lo lleva. Un consumidor en una versión anterior recibe un valor que su enum no nombra: debe mapearlo explícitamente y no con un cast.

Cambios 4.4.0

• CargoFinancieroEvento.Descripcion — nuevo, string? con default null. Texto del cargo tal como lo imprimió el banco, del que Reconocimiento dedujo el Tipo. null significa "no informada" (eventos publicados antes de este cambio).

Cambios 4.3.0

• ObligacionReclasificadaId (Guid?, al final) en ComercioParaRadicar: la obligación que esta compra reemplaza (p. ej. un anticipo reclasificado como compra). Aditivo. Eco de ComercioReconocido.ObligacionReclasificadaId de ObligacionesPorPagar.Reconocimiento.Contratos 2.4.0; null en el camino normal.

Cambios 4.2.0

• CanalIngreso (Manual | Correo, nullable) en DocumentoParaRadicar y los cuatro *ParaRadicar. Aditivo. null = documento reconocido antes de ObligacionesPorPagar.Reconocimiento.Contratos 2.3.0.

Cambios 4.0.0 (breaking)

Los eventos *ParaRadicar se alinearon con la estructura de ObligacionesPorPagar.Reconocimiento.Contratos 2.0.0:

• Se eliminó Ocr (MetadatosOcr, CampoOcr, UbicacionOcr, PosicionOcr): Reconocimiento ya no emite metadatos OCR.
• Se eliminó FormaPago de ComercioParaRadicar y DevolucionParaRadicar.
• MedioPago (string) se reemplazó por CondicionesPago: CondicionesPagoEvento? en Comercio, Devolución y Anticipo (se eliminó MedioPagoAnticipoEvento).
• En ExtractoParaRadicar, Tarjeta (TarjetaEvento) y MedioDePago (MedioDePagoExtractoEvento) se reemplazaron por IdentificadorProductoFinanciero: string?.
• En MovimientoExtractoEvento, TasaCambio (TasaRepresentativaMercadoEvento) se reemplazó por MonedaOrigen: MonedaOrigenEvento?.
• DevolucionParaRadicar.ReferenciaAfectada pasó de ReferenciaAfectadaEvento a string?.

Cambios 2.0.3

ComercioParaRadicar (evento interno IPrivateEvent consumido por Radicacion) transporta, opcionalmente, los catálogos tributarios del país a nivel del evento:

• ClasificacionesTributarias: IReadOnlyList<ClasificacionTributaria>? — universo válido de clasificaciones.
• ConceptosPago: IReadOnlyList<string>? — universo válido de conceptos de pago.

Ambos son opcionales (null por defecto): solo se poblan cuando el documento ingresó con catálogos desde el flujo de Reconocimiento.

Ejemplo de uso

using ObligacionesPorPagar.Entradas.Contratos.Eventos;

// Suscribirse a un evento con Wolverine
public class CuandoComercioConfirmado : IHandler<ComercioConfirmado>
{
    public Task Handle(ComercioConfirmado evento)
    {
        var tercero = evento.InformacionTercero.Nombre;
        var valor = evento.Valor;
        // Procesar la entrada confirmada...
    }
}

Dependencias

Licencia

Software propietario © 2026 Sincosoft. Todos los derechos reservados. Consulte el archivo LICENSE para más detalles.