payee_aggregate Property

Wrapper for payee details.

Syntax

def get_payee_aggregate() -> str: ...
def set_payee_aggregate(value: str) -> None: ...

payee_aggregate = property(get_payee_aggregate, set_payee_aggregate)

Default Value

""

Remarks

Wrapper for payee details.

This string consists of all the payee's properties payee_id, payee_name, payee_addr1, payee_addr2, payee_addr3, payee_city, payee_state, payee_postal_code, payee_country, payee_phone, payee_id_scope, payee_days_to_pay, payee_list_id, payee_account of the payee.

When the on_synchronize_payees is called, the on_sync_payees event is fired for each payee in the payee list. Among other payee data returned through this event's parameters, there is also a PayeeAggregate parameter.

When sending a payment request (by calling on_pay_bill) to an existing payee in the list returned via the payee synchronization request, and when the payee_id is unknown or not assigned, instead of setting all payee's properties, the user can set the payee_aggregate to the value of PayeeAggregate returned for that payee from the on_sync_payees event. When the payee_aggregate is set to this value, all payee's properties are populated with the corresponding values in the aggregate.

Aggregates are pieces of XML taken from the financial institution's original response. They contain elements that correspond to many of the class's properties. However, some of these elements, and/or their potential values, may not be supported by the class. Any user who wishes to use unsupported fields may use this aggregate property to parse out the desired data either via our OFXAggregate class or any other means.

Note: The original data from the server is returned as SGML or XML (depending on the value of ofx_version that FI supports. If the original data is returned in SGML format, the class internally manipulates these responses into the equivalent XML format by inserting close element tags (e.g., "</ACCTID>") into the data as it comes from the server.