Module adcp.types.generated_poc.pricing_options.price_breakdown

Classes

class Adjustments (**data: Any)

Expand source code

class Adjustments(AdCPBaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    amount: Annotated[
        float | None,
        Field(
            description="Adjustment as a fixed monetary amount in the pricing option's currency. Always positive — kind determines the economic effect. Mutually exclusive with rate.",
            gt=0.0,
        ),
    ] = None
    beneficiary: Annotated[
        str | None,
        Field(
            description="Identifies who receives this adjustment's value. For commissions, the intermediary (e.g., a sellers.json domain, an AdCP account ID, or a human-readable party name). Optional but recommended for multi-intermediary transparency.",
            max_length=256,
        ),
    ] = None
    description: Annotated[
        str | None,
        Field(
            description="Human-readable description of this adjustment (e.g., 'Malstaffel 12x', '2% Skonto 10 Tage')",
            max_length=256,
        ),
    ] = None
    kind: adjustment_kind.PriceAdjustmentKind
    name: Annotated[
        str,
        Field(
            description='Specific adjustment name. Use well-known values where applicable for interoperability.',
            examples=[
                'ad_serving',
                'data_targeting',
                'brand_safety',
                'volume',
                'negotiated',
                'early_booking',
                'agency',
                'intermediary',
                'cash_discount',
                'early_payment',
            ],
            max_length=64,
        ),
    ]
    rate: Annotated[
        float,
        Field(
            description='Adjustment as a decimal proportion (e.g., 0.15 for 15%). Always positive — kind determines the economic effect. Mutually exclusive with amount.',
            gt=0.0,
            lt=1.0,
        ),
    ]

Base model for AdCP types with spec-compliant serialization.

Defaults to extra='ignore' so that unknown fields from newer spec versions are silently dropped rather than causing validation errors. Generated types whose schemas set additionalProperties: true override this with extra='allow' in their own model_config. Consumers who want strict validation can override with extra='forbid'.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Ancestors

• AdCPBaseModel
• pydantic.main.BaseModel

Class variables

var amount : float | None

var beneficiary : str | None

var description : str | None

var kind : PriceAdjustmentKind

var model_config

var name : str

var rate : float

Inherited members

• AdCPBaseModel:
  • model_dump
  • model_dump_json
  • model_summary

class Adjustments1 (**data: Any)

Expand source code

class Adjustments1(AdCPBaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    amount: Annotated[
        float,
        Field(
            description="Adjustment as a fixed monetary amount in the pricing option's currency. Always positive — kind determines the economic effect. Mutually exclusive with rate.",
            gt=0.0,
        ),
    ]
    beneficiary: Annotated[
        str | None,
        Field(
            description="Identifies who receives this adjustment's value. For commissions, the intermediary (e.g., a sellers.json domain, an AdCP account ID, or a human-readable party name). Optional but recommended for multi-intermediary transparency.",
            max_length=256,
        ),
    ] = None
    description: Annotated[
        str | None,
        Field(
            description="Human-readable description of this adjustment (e.g., 'Malstaffel 12x', '2% Skonto 10 Tage')",
            max_length=256,
        ),
    ] = None
    kind: adjustment_kind.PriceAdjustmentKind
    name: Annotated[
        str,
        Field(
            description='Specific adjustment name. Use well-known values where applicable for interoperability.',
            examples=[
                'ad_serving',
                'data_targeting',
                'brand_safety',
                'volume',
                'negotiated',
                'early_booking',
                'agency',
                'intermediary',
                'cash_discount',
                'early_payment',
            ],
            max_length=64,
        ),
    ]
    rate: Annotated[
        float | None,
        Field(
            description='Adjustment as a decimal proportion (e.g., 0.15 for 15%). Always positive — kind determines the economic effect. Mutually exclusive with amount.',
            gt=0.0,
            lt=1.0,
        ),
    ] = None

Base model for AdCP types with spec-compliant serialization.

Defaults to extra='ignore' so that unknown fields from newer spec versions are silently dropped rather than causing validation errors. Generated types whose schemas set additionalProperties: true override this with extra='allow' in their own model_config. Consumers who want strict validation can override with extra='forbid'.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Ancestors

• AdCPBaseModel
• pydantic.main.BaseModel

Class variables

var amount : float

var beneficiary : str | None

var description : str | None

var kind : PriceAdjustmentKind

var model_config

var name : str

var rate : float | None

Inherited members

• AdCPBaseModel:
  • model_dump
  • model_dump_json
  • model_summary

class PriceBreakdown (**data: Any)

Expand source code

class PriceBreakdown(AdCPBaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    adjustments: Annotated[
        list[Adjustments | Adjustments1],
        Field(
            description="Ordered list of price adjustments. Fee and discount adjustments walk list_price to fixed_price — fees increase the running price, discounts reduce it. Commission and settlement adjustments are disclosed for transparency but do not affect the buyer's committed price.",
            max_length=20,
            min_length=1,
        ),
    ]
    list_price: Annotated[
        float,
        Field(
            description='Rate card or base price before any adjustments. The starting point from which fixed_price is derived by applying fee and discount adjustments sequentially.',
            gt=0.0,
        ),
    ]

Base model for AdCP types with spec-compliant serialization.

Defaults to extra='ignore' so that unknown fields from newer spec versions are silently dropped rather than causing validation errors. Generated types whose schemas set additionalProperties: true override this with extra='allow' in their own model_config. Consumers who want strict validation can override with extra='forbid'.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Ancestors

• AdCPBaseModel
• pydantic.main.BaseModel

Class variables

var adjustments : list[Adjustments | Adjustments1]

var list_price : float

var model_config

Inherited members

• AdCPBaseModel:
  • model_dump
  • model_dump_json
  • model_summary