Skip to content

AgreementViewSummary

Source code in docs_src/capo_marketplace_agreement/types/agreement_view_summary.py
class AgreementViewSummary(TypedDict, closed=True):
    agreement_id: NotRequired["capo_marketplace_agreement.types.resource_id.ResourceId"]
    """<p>The unique identifier of the agreement.</p>"""
    acceptance_time: NotRequired["capo_marketplace_agreement.types.timestamp.Timestamp"]
    """<p>The date and time that the agreement was accepted.</p>"""
    start_time: NotRequired["capo_marketplace_agreement.types.timestamp.Timestamp"]
    """<p>The date and time when the agreement starts.</p>"""
    end_time: NotRequired["capo_marketplace_agreement.types.timestamp.Timestamp"]
    """<p>The date and time when the agreement ends. The field is <code>null</code> for pay-as-you-go agreements, which don’t have end dates.</p>"""
    last_update_time: NotRequired[
        "capo_marketplace_agreement.types.timestamp.Timestamp"
    ]
    """<p>The date and time when the agreement was last updated. An agreement is updated when any of its attributes or accepted terms change. Amendments, renewals, and a party changing whether the agreement renews are all examples.</p> <p>Use the <code>BeforeLastUpdateTime</code> and <code>AfterLastUpdateTime</code> filters to search on this value, and <code>LastUpdateTime</code> as the <code>SortBy</code> value to sort by it. Sorting by <code>LastUpdateTime</code> is supported only when <code>PartyType</code> is <code>Proposer</code>.</p>"""
    agreement_type: NotRequired[
        "capo_marketplace_agreement.types.agreement_type.AgreementType"
    ]
    """<p>The type of agreement.</p>"""
    acceptor: NotRequired["capo_marketplace_agreement.types.acceptor.Acceptor"]
    """<p>Details of the party accepting the agreement terms. This is commonly the buyer for <code>PurchaseAgreement.</code> </p>"""
    proposer: NotRequired["capo_marketplace_agreement.types.proposer.Proposer"]
    """<p>Details of the party proposing the agreement terms, most commonly the seller for <code>PurchaseAgreement</code>.</p>"""
    proposal_summary: NotRequired[
        "capo_marketplace_agreement.types.proposal_summary.ProposalSummary"
    ]
    """<p>A summary of the proposal</p>"""
    status: NotRequired[
        "capo_marketplace_agreement.types.agreement_status.AgreementStatus"
    ]
    """<p>The current status of the agreement. </p>"""
    entitlements: NotRequired[
        "capo_marketplace_agreement.types.entitlement_list.EntitlementList"
    ]
    """<p>A list of entitlements associated with the agreement.</p>"""
    initial_agreement_id: NotRequired[
        "capo_marketplace_agreement.types.resource_id.ResourceId"
    ]
    """<p>The unique identifier of the very first agreement in a chain of related agreements, such as renewals or replacements. It stays the same across all agreements in that chain, which lets you trace an agreement back to the original. You can also use it as the <code>InitialAgreementId</code> filter value to return every agreement in the same chain.</p>"""
    end_time_behavior_type: NotRequired[
        "capo_marketplace_agreement.types.end_time_behavior_type.EndTimeBehaviorType"
    ]
    """<p>The behavior of the agreement when it reaches its end date. The field is <code>null</code> for agreements that have no end date, because those agreements never reach an end time.</p> <p>Types include:</p> <ul> <li> <p> <code>RENEW</code> – A new agreement is created from the accepted terms of this agreement.</p> </li> <li> <p> <code>REPLACE</code> – A new agreement is created from a different offer than the one this agreement was created from. This happens, for example, when a private offer reaches its end date and the acceptor transitions to the public offer for the product.</p> </li> <li> <p> <code>EXPIRE</code> – The agreement ends and isn't renewed or replaced.</p> </li> </ul>"""
    end_time_behavior_reason_code: NotRequired[
        "capo_marketplace_agreement.types.end_time_behavior_reason_code.EndTimeBehaviorReasonCode"
    ]
    """<p>The reason why the agreement doesn't renew at its end date. The field is <code>null</code> when the agreement renews.</p> <p>More than one reason can apply to the same agreement. When that happens, the operation returns only one reason code, and <code>PROPOSER_RENEW_OPTED_OUT</code> takes precedence over all others.</p> <p>The <code>EnableAutoRenew</code> field reflects only the acceptor's preference, and doesn't reflect the other reasons an agreement might not renew.</p> <p>Reason codes include:</p> <ul> <li> <p> <code>PROPOSER_RENEW_OPTED_OUT</code> – The proposer opted out of renewing the agreement.</p> </li> <li> <p> <code>ACCEPTOR_RENEW_OPTED_OUT</code> – The acceptor opted out of renewing the agreement.</p> </li> <li> <p> <code>NO_RENEWAL_TERM</code> – The accepted terms of the agreement don't include a renewal term, which is required for an agreement to renew.</p> </li> <li> <p> <code>RENEWAL_LIMIT_EXHAUSTED</code> – The agreement reached the maximum number of renewals allowed by its renewal term.</p> </li> </ul>"""

acceptance_time instance-attribute

acceptance_time: NotRequired[Timestamp]

The date and time that the agreement was accepted.

acceptor instance-attribute

acceptor: NotRequired[Acceptor]

Details of the party accepting the agreement terms. This is commonly the buyer for PurchaseAgreement.

agreement_id instance-attribute

agreement_id: NotRequired[ResourceId]

The unique identifier of the agreement.

agreement_type instance-attribute

agreement_type: NotRequired[AgreementType]

The type of agreement.

end_time instance-attribute

end_time: NotRequired[Timestamp]

The date and time when the agreement ends. The field is null for pay-as-you-go agreements, which don’t have end dates.

end_time_behavior_reason_code instance-attribute

end_time_behavior_reason_code: NotRequired[EndTimeBehaviorReasonCode]

The reason why the agreement doesn't renew at its end date. The field is null when the agreement renews.

More than one reason can apply to the same agreement. When that happens, the operation returns only one reason code, and PROPOSER_RENEW_OPTED_OUT takes precedence over all others.

The EnableAutoRenew field reflects only the acceptor's preference, and doesn't reflect the other reasons an agreement might not renew.

Reason codes include:

  • PROPOSER_RENEW_OPTED_OUT – The proposer opted out of renewing the agreement.

  • ACCEPTOR_RENEW_OPTED_OUT – The acceptor opted out of renewing the agreement.

  • NO_RENEWAL_TERM – The accepted terms of the agreement don't include a renewal term, which is required for an agreement to renew.

  • RENEWAL_LIMIT_EXHAUSTED – The agreement reached the maximum number of renewals allowed by its renewal term.

end_time_behavior_type instance-attribute

end_time_behavior_type: NotRequired[EndTimeBehaviorType]

The behavior of the agreement when it reaches its end date. The field is null for agreements that have no end date, because those agreements never reach an end time.

Types include:

  • RENEW – A new agreement is created from the accepted terms of this agreement.

  • REPLACE – A new agreement is created from a different offer than the one this agreement was created from. This happens, for example, when a private offer reaches its end date and the acceptor transitions to the public offer for the product.

  • EXPIRE – The agreement ends and isn't renewed or replaced.

entitlements instance-attribute

entitlements: NotRequired[EntitlementList]

A list of entitlements associated with the agreement.

initial_agreement_id instance-attribute

initial_agreement_id: NotRequired[ResourceId]

The unique identifier of the very first agreement in a chain of related agreements, such as renewals or replacements. It stays the same across all agreements in that chain, which lets you trace an agreement back to the original. You can also use it as the InitialAgreementId filter value to return every agreement in the same chain.

last_update_time instance-attribute

last_update_time: NotRequired[Timestamp]

The date and time when the agreement was last updated. An agreement is updated when any of its attributes or accepted terms change. Amendments, renewals, and a party changing whether the agreement renews are all examples.

Use the BeforeLastUpdateTime and AfterLastUpdateTime filters to search on this value, and LastUpdateTime as the SortBy value to sort by it. Sorting by LastUpdateTime is supported only when PartyType is Proposer.

proposal_summary instance-attribute

proposal_summary: NotRequired[ProposalSummary]

A summary of the proposal

proposer instance-attribute

proposer: NotRequired[Proposer]

Details of the party proposing the agreement terms, most commonly the seller for PurchaseAgreement.

start_time instance-attribute

start_time: NotRequired[Timestamp]

The date and time when the agreement starts.

status instance-attribute

status: NotRequired[AgreementStatus]

The current status of the agreement.