Aviso legal

regalias_vzla es una herramienta informática de carácter educativo y de referencia técnica. No constituye asesoría legal, fiscal ni financiera. No está afiliada, avalada ni patrocinada por PDVSA, el Ministerio del Poder Popular de Petróleo, el SENIAT ni ningún otro ente del Estado venezolano. Los resultados son estimaciones referenciales sin validez oficial para declaraciones fiscales, liquidaciones ante PDVSA, fiscalizaciones, procedimientos administrativos ni procesos judiciales. Verifique siempre el instrumento vigente en la Gaceta Oficial de la República Bolivariana de Venezuela.

fluidos

regalias_vzla.fluidos

Capa física: definición y validación del dominio de fluidos.

FluidoCrudo

Bases: BaseModel

Parámetros físicos del fluido extraído de un pozo o campo.

El volumen bruto incluye agua y sedimentos; el volumen neto fiscalizable se obtiene deduciendo el BS&W:

V_neto = V_bruto x (1 - BS&W)

Source code in src/regalias_vzla/fluidos.py

class FluidoCrudo(BaseModel):
    """Parámetros físicos del fluido extraído de un pozo o campo.

    El volumen bruto incluye agua y sedimentos; el volumen neto fiscalizable
    se obtiene deduciendo el BS&W:

        V_neto = V_bruto x (1 - BS&W)
    """

    model_config = ConfigDict(frozen=True)

    volumen_bruto: Decimal = Field(
        ...,
        gt=0,
        description="Volumen bruto extraído en barriles (incluye agua y arena).",
    )
    bs_w: Decimal = Field(
        ...,
        ge=0,
        le=1,
        description="Basic Sediment & Water, en decimal (0 a 1).",
    )
    gravedad_api: float = Field(
        ...,
        gt=0,
        le=80,
        allow_inf_nan=False,
        description=(
            "Densidad del crudo en grados API (< 10 es extrapesado). "
            "Debe ser finita y positiva; se rechazan Infinity/NaN."
        ),
    )

    @property
    def es_extrapesado(self) -> bool:
        """Indica si el crudo pertenece a la banda extrapesada (< 10° API)."""
        return self.gravedad_api < GRAVEDAD_EXTRAPESADO

    @property
    def volumen_neto(self) -> Decimal:
        """Volumen de petróleo real fiscalizable, tras deducir impurezas."""
        return self.volumen_bruto * (Decimal("1") - self.bs_w)

es_extrapesado property

es_extrapesado: bool

Indica si el crudo pertenece a la banda extrapesada (< 10° API).

volumen_neto property

volumen_neto: Decimal

Volumen de petróleo real fiscalizable, tras deducir impurezas.