AgreementViewSummary
¶
Source code in docs_src/capo_marketplace_agreement/types/agreement_view_summary.py
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.