Skip to main content

Party Service

The Party service is a basic contact directory for the agency. A Party can be defined as either a Person or a Company. Parties have contact information along with beneficiary details attached to them.

Domain​

The party service also has some domain logic that is used for accounting and actual payments. Namely a party has an AccountType and a PartyTag.

Account Type​

The account type is used for invoicing parties as well as the main contact pills on the UI service. A party can have multiple accounts type and these are the following types:

  • Owner: Owner of a property
  • Tenant: Tenant who occupies a property
  • Team: Agent / Agency. Someone who works in the Agency.
  • Institution: Municipalities and Body Corporates
  • Supplier: Contractors and suppliers such as Telephone/Dstv etc.

Party Tag​

The party tag is used primarily when payments are made via Recon/Invoicing Service. Every payment rule has a party tag associated with it and this is to be used when generating Income/Expense reports(Future work) which are sent to landlords. The party tag also determines the flow of payments made. ie: A payment with the party tag of Agency will not result in an EFT but rather a wallet to wallet transfer. More can be founds in the Wallet Service Documentation. The following is a list of party tags which can be used and helps with the reporting

  • Agency
  • Agency Deposit Account
  • Agent
  • Body Corporate
  • Body Corporate: Levies
  • Body Corporate: Parking
  • Body Corporate: Rates
  • Body Corporate: Taxes
  • Contractor
  • Contractor: Bin Cleaner
  • Contractor: Carpet Cleaning
  • Contractor: Painter
  • Levies
  • Municipality
  • Municipality: Electricity
  • Municipality: Refuse
  • Municipality: Sewerage
  • Municipality: Water
  • Owner
  • Rates
  • Supplier
  • Supplier: Domestic
  • Supplier: Dstv
  • Supplier: Internet
  • Supplier: Telephone
  • Tenant
  • Tenant Deposit Account

Additional Domain logic​

  • Unique References: when a PortfolioApproved event takes place, any parties(landlord/tenant) associated with the lease has a unique payment reference generated.
  • PartyTag gets added whenever the Invoice/Recon service emits a PaymentRule updated/created event.