from datetime import date, datetime, timedelta from flask import current_app from notifications_utils.timezones import convert_utc_to_local_timezone from sqlalchemy import Date, Integer, and_, desc, func, union from sqlalchemy.dialects.postgresql import insert from sqlalchemy.sql.expression import case, literal from app import db from app.dao.date_util import ( get_financial_year_dates, get_financial_year_for_datetime, ) from app.dao.organisation_dao import dao_get_organisation_live_services from app.models import ( EMAIL_TYPE, KEY_TYPE_NORMAL, KEY_TYPE_TEAM, NOTIFICATION_STATUS_TYPES_BILLABLE_SMS, NOTIFICATION_STATUS_TYPES_SENT_EMAILS, SMS_TYPE, AnnualBilling, FactBilling, NotificationAllTimeView, NotificationHistory, Organisation, Rate, Service, ) from app.utils import get_local_midnight_in_utc def fetch_sms_free_allowance_remainder_until_date(end_date): # ASSUMPTION: AnnualBilling has been populated for year. billing_year = get_financial_year_for_datetime(end_date) start_of_year = date(billing_year, 4, 1) billable_units = func.coalesce(func.sum(FactBilling.billable_units * FactBilling.rate_multiplier), 0) query = db.session.query( AnnualBilling.service_id.label("service_id"), AnnualBilling.free_sms_fragment_limit, billable_units.label('billable_units'), func.greatest((AnnualBilling.free_sms_fragment_limit - billable_units).cast(Integer), 0).label('sms_remainder') ).outerjoin( # if there are no ft_billing rows for a service we still want to return the annual billing so we can use the # free_sms_fragment_limit) FactBilling, and_( AnnualBilling.service_id == FactBilling.service_id, FactBilling.local_date >= start_of_year, FactBilling.local_date < end_date, FactBilling.notification_type == SMS_TYPE, ) ).filter( AnnualBilling.financial_year_start == billing_year, ).group_by( AnnualBilling.service_id, AnnualBilling.free_sms_fragment_limit, ) return query def fetch_sms_billing_for_all_services(start_date, end_date): # ASSUMPTION: AnnualBilling has been populated for year. allowance_left_at_start_date_query = fetch_sms_free_allowance_remainder_until_date(start_date).subquery() sms_billable_units = func.sum(FactBilling.billable_units * FactBilling.rate_multiplier) # subtract sms_billable_units units accrued since report's start date to get up-to-date # allowance remainder sms_allowance_left = func.greatest(allowance_left_at_start_date_query.c.sms_remainder - sms_billable_units, 0) # billable units here are for period between start date and end date only, so to see # how many are chargeable, we need to see how much free allowance was used up in the # period up until report's start date and then do a subtraction chargeable_sms = func.greatest(sms_billable_units - allowance_left_at_start_date_query.c.sms_remainder, 0) sms_cost = chargeable_sms * FactBilling.rate query = db.session.query( Organisation.name.label('organisation_name'), Organisation.id.label('organisation_id'), Service.name.label("service_name"), Service.id.label("service_id"), allowance_left_at_start_date_query.c.free_sms_fragment_limit, FactBilling.rate.label('sms_rate'), sms_allowance_left.label("sms_remainder"), sms_billable_units.label('sms_billable_units'), chargeable_sms.label("chargeable_billable_sms"), sms_cost.label('sms_cost'), ).select_from( Service ).outerjoin( allowance_left_at_start_date_query, Service.id == allowance_left_at_start_date_query.c.service_id ).outerjoin( Service.organisation ).join( FactBilling, FactBilling.service_id == Service.id, ).filter( FactBilling.local_date >= start_date, FactBilling.local_date <= end_date, FactBilling.notification_type == SMS_TYPE, ).group_by( Organisation.name, Organisation.id, Service.id, Service.name, allowance_left_at_start_date_query.c.free_sms_fragment_limit, allowance_left_at_start_date_query.c.sms_remainder, FactBilling.rate, ).order_by( Organisation.name, Service.name ) return query.all() def fetch_billing_totals_for_year(service_id, year): """ Returns a row for each distinct rate and notification_type from ft_billing over the specified financial year e.g. ( rate=0.0165, notification_type=sms, notifications_sent=123, ... ) The "query_service_..." subqueries for each notification_type all return the same columns but differ internally e.g. SMS has to incorporate a rate multiplier. Each subquery returns the same set of columns, which we pick from here before the big union. """ return db.session.query( union(*[ db.session.query( query.c.notification_type.label("notification_type"), query.c.rate.label("rate"), func.sum(query.c.notifications_sent).label("notifications_sent"), func.sum(query.c.chargeable_units).label("chargeable_units"), func.sum(query.c.cost).label("cost"), func.sum(query.c.free_allowance_used).label("free_allowance_used"), func.sum(query.c.charged_units).label("charged_units"), ).group_by( query.c.rate, query.c.notification_type ) for query in [ query_service_sms_usage_for_year(service_id, year).subquery(), query_service_email_usage_for_year(service_id, year).subquery(), ] ]).subquery() ).order_by( "notification_type", "rate", ).all() def fetch_monthly_billing_for_year(service_id, year): """ Returns a row for each distinct rate, notification_type, and month from ft_billing over the specified financial year e.g. ( rate=0.0165, notification_type=sms, month=2022-04-01 00:00:00, notifications_sent=123, ... ) Each subquery takes care of anything specific to the notification type e.g. rate multipliers for SMS. Since the data in ft_billing is only refreshed once a day for all services, we also update the table on-the-fly if we need accurate data for this year. """ _, year_end = get_financial_year_dates(year) today = convert_utc_to_local_timezone(datetime.utcnow()).date() # if year end date is less than today, we are calculating for data in the past and have no need for deltas. if year_end >= today: data = fetch_billing_data_for_day(process_day=today, service_id=service_id, check_permissions=True) for d in data: update_fact_billing(data=d, process_day=today) return db.session.query( union(*[ db.session.query( query.c.rate.label("rate"), query.c.notification_type.label("notification_type"), func.date_trunc('month', query.c.local_date).cast(Date).label("month"), func.sum(query.c.notifications_sent).label("notifications_sent"), func.sum(query.c.chargeable_units).label("chargeable_units"), func.sum(query.c.cost).label("cost"), func.sum(query.c.free_allowance_used).label("free_allowance_used"), func.sum(query.c.charged_units).label("charged_units"), ).group_by( query.c.rate, query.c.notification_type, 'month', ) for query in [ query_service_sms_usage_for_year(service_id, year).subquery(), query_service_email_usage_for_year(service_id, year).subquery(), ] ]).subquery() ).order_by( "month", "notification_type", "rate", ).all() def query_service_email_usage_for_year(service_id, year): year_start, year_end = get_financial_year_dates(year) return db.session.query( FactBilling.local_date, FactBilling.notifications_sent, FactBilling.billable_units.label("chargeable_units"), FactBilling.rate, FactBilling.notification_type, literal(0).label("cost"), literal(0).label("free_allowance_used"), FactBilling.billable_units.label("charged_units"), ).filter( FactBilling.service_id == service_id, FactBilling.local_date >= year_start, FactBilling.local_date <= year_end, FactBilling.notification_type == EMAIL_TYPE ) def query_service_sms_usage_for_year(service_id, year): """ Returns rows from the ft_billing table with some calculated values like cost, incorporating the SMS free allowance e.g. ( local_date=2022-04-27, notifications_sent=12, chargeable_units=12, rate=0.0165, [cost=0 <== covered by the free allowance], [cost=0.198 <== if free allowance exhausted], [cost=0.099 <== only some free allowance left], ... ) In order to calculate how much free allowance is left, we need to work out how much was used for previous local_dates - cumulative_chargeable_units - which we then subtract from the free allowance for the year. cumulative_chargeable_units is calculated using a "window" clause, which has access to all the rows identified by the query filter. Note that it's not affected by any GROUP BY clauses that happen in outer queries. https://www.postgresql.org/docs/current/tutorial-window.html ASSUMPTION: rates always change at midnight i.e. there can only be one rate on a given local_date. This means we don't need to worry about how to assign free allowance if it happens to run out when a rate changes. """ year_start, year_end = get_financial_year_dates(year) this_rows_chargeable_units = FactBilling.billable_units * FactBilling.rate_multiplier # Subquery for the number of chargeable units in all rows preceding this one, # which might be none if this is the first row (hence the "coalesce"). For # some reason the end result is a decimal despite all the input columns being # integer - this seems to be a Sqlalchemy quirk (works in raw SQL). chargeable_units_used_before_this_row = func.coalesce( func.sum(this_rows_chargeable_units).over( # order is "ASC" by default order_by=[FactBilling.local_date], # first row to previous row rows=(None, -1) ).cast(Integer), 0 ) # Subquery for how much free allowance we have left before the current row, # so we can work out the cost for this row after taking it into account. remaining_free_allowance_before_this_row = func.greatest( AnnualBilling.free_sms_fragment_limit - chargeable_units_used_before_this_row, 0 ) # Subquery for the number of chargeable_units that we will actually charge # for, after taking any remaining free allowance into account. charged_units = func.greatest(this_rows_chargeable_units - remaining_free_allowance_before_this_row, 0) free_allowance_used = func.least(remaining_free_allowance_before_this_row, this_rows_chargeable_units) return db.session.query( FactBilling.local_date, FactBilling.notifications_sent, this_rows_chargeable_units.label("chargeable_units"), FactBilling.rate, FactBilling.notification_type, (charged_units * FactBilling.rate).label("cost"), free_allowance_used.label("free_allowance_used"), charged_units.label("charged_units"), ).join( AnnualBilling, AnnualBilling.service_id == service_id ).filter( FactBilling.service_id == service_id, FactBilling.local_date >= year_start, FactBilling.local_date <= year_end, FactBilling.notification_type == SMS_TYPE, AnnualBilling.financial_year_start == year, ) def delete_billing_data_for_service_for_day(process_day, service_id): """ Delete all ft_billing data for a given service on a given local_date Returns how many rows were deleted """ return FactBilling.query.filter( FactBilling.local_date == process_day, FactBilling.service_id == service_id ).delete() def fetch_billing_data_for_day(process_day, service_id=None, check_permissions=False): start_date = get_local_midnight_in_utc(process_day) end_date = get_local_midnight_in_utc(process_day + timedelta(days=1)) current_app.logger.info("Populate ft_billing for {} to {}".format(start_date, end_date)) transit_data = [] if not service_id: services = Service.query.all() else: services = [Service.query.get(service_id)] for service in services: for notification_type in (SMS_TYPE, EMAIL_TYPE): if (not check_permissions) or service.has_permission(notification_type): results = _query_for_billing_data( notification_type=notification_type, start_date=start_date, end_date=end_date, service=service ) transit_data += results return transit_data def _query_for_billing_data(notification_type, start_date, end_date, service): def _email_query(): return db.session.query( NotificationAllTimeView.template_id, literal(service.id).label('service_id'), literal(notification_type).label('notification_type'), literal('ses').label('sent_by'), literal(0).label('rate_multiplier'), literal(False).label('international'), literal(0).label('billable_units'), func.count().label('notifications_sent'), ).filter( NotificationAllTimeView.status.in_(NOTIFICATION_STATUS_TYPES_SENT_EMAILS), NotificationAllTimeView.key_type.in_((KEY_TYPE_NORMAL, KEY_TYPE_TEAM)), NotificationAllTimeView.created_at >= start_date, NotificationAllTimeView.created_at < end_date, NotificationAllTimeView.notification_type == notification_type, NotificationAllTimeView.service_id == service.id ).group_by( NotificationAllTimeView.template_id, ) def _sms_query(): sent_by = func.coalesce(NotificationAllTimeView.sent_by, 'unknown') rate_multiplier = func.coalesce(NotificationAllTimeView.rate_multiplier, 1).cast(Integer) international = func.coalesce(NotificationAllTimeView.international, False) return db.session.query( NotificationAllTimeView.template_id, literal(service.id).label('service_id'), literal(notification_type).label('notification_type'), sent_by.label('sent_by'), rate_multiplier.label('rate_multiplier'), international.label('international'), func.sum(NotificationAllTimeView.billable_units).label('billable_units'), func.count().label('notifications_sent'), ).filter( NotificationAllTimeView.status.in_(NOTIFICATION_STATUS_TYPES_BILLABLE_SMS), NotificationAllTimeView.key_type.in_((KEY_TYPE_NORMAL, KEY_TYPE_TEAM)), NotificationAllTimeView.created_at >= start_date, NotificationAllTimeView.created_at < end_date, NotificationAllTimeView.notification_type == notification_type, NotificationAllTimeView.service_id == service.id ).group_by( NotificationAllTimeView.template_id, sent_by, rate_multiplier, international, ) query_funcs = { SMS_TYPE: _sms_query, EMAIL_TYPE: _email_query, } query = query_funcs[notification_type]() return query.all() def get_rates_for_billing(): rates = Rate.query.order_by(desc(Rate.valid_from)).all() return rates def get_service_ids_that_need_billing_populated(start_date, end_date): return db.session.query( NotificationHistory.service_id ).filter( NotificationHistory.created_at >= start_date, NotificationHistory.created_at <= end_date, NotificationHistory.notification_type.in_([SMS_TYPE, EMAIL_TYPE]), NotificationHistory.billable_units != 0 ).distinct().all() def get_rate( rates, notification_type, date ): start_of_day = get_local_midnight_in_utc(date) if notification_type == SMS_TYPE: return next( r.rate for r in rates if ( notification_type == r.notification_type and start_of_day >= r.valid_from ) ) else: return 0 def update_fact_billing(data, process_day): rates = get_rates_for_billing() rate = get_rate(rates, data.notification_type, process_day) billing_record = create_billing_record(data, rate, process_day) table = FactBilling.__table__ ''' This uses the Postgres upsert to avoid race conditions when two threads try to insert at the same row. The excluded object refers to values that we tried to insert but were rejected. http://docs.sqlalchemy.org/en/latest/dialects/postgresql.html#insert-on-conflict-upsert ''' stmt = insert(table).values( local_date=billing_record.local_date, template_id=billing_record.template_id, service_id=billing_record.service_id, provider=billing_record.provider, rate_multiplier=billing_record.rate_multiplier, notification_type=billing_record.notification_type, international=billing_record.international, billable_units=billing_record.billable_units, notifications_sent=billing_record.notifications_sent, rate=billing_record.rate, ) stmt = stmt.on_conflict_do_update( constraint="ft_billing_pkey", set_={"notifications_sent": stmt.excluded.notifications_sent, "billable_units": stmt.excluded.billable_units, "updated_at": datetime.utcnow() } ) db.session.connection().execute(stmt) db.session.commit() def create_billing_record(data, rate, process_day): billing_record = FactBilling( local_date=process_day, template_id=data.template_id, service_id=data.service_id, notification_type=data.notification_type, provider=data.sent_by, rate_multiplier=data.rate_multiplier, international=data.international, billable_units=data.billable_units, notifications_sent=data.notifications_sent, rate=rate, ) return billing_record def fetch_email_usage_for_organisation(organisation_id, start_date, end_date): query = db.session.query( Service.name.label("service_name"), Service.id.label("service_id"), func.sum(FactBilling.notifications_sent).label("emails_sent") ).select_from( Service ).join( FactBilling, FactBilling.service_id == Service.id, ).filter( FactBilling.local_date >= start_date, FactBilling.local_date <= end_date, FactBilling.notification_type == EMAIL_TYPE, Service.organisation_id == organisation_id, Service.restricted.is_(False) ).group_by( Service.id, Service.name, ).order_by( Service.name ) return query.all() def fetch_sms_billing_for_organisation(organisation_id, financial_year): # ASSUMPTION: AnnualBilling has been populated for year. ft_billing_subquery = query_organisation_sms_usage_for_year(organisation_id, financial_year).subquery() sms_billable_units = func.sum(func.coalesce(ft_billing_subquery.c.chargeable_units, 0)) # subtract sms_billable_units units accrued since report's start date to get up-to-date # allowance remainder sms_allowance_left = func.greatest(AnnualBilling.free_sms_fragment_limit - sms_billable_units, 0) chargeable_sms = func.sum(ft_billing_subquery.c.charged_units) sms_cost = func.sum(ft_billing_subquery.c.cost) query = db.session.query( Service.name.label("service_name"), Service.id.label("service_id"), AnnualBilling.free_sms_fragment_limit, func.coalesce(sms_allowance_left, 0).label("sms_remainder"), func.coalesce(sms_billable_units, 0).label('sms_billable_units'), func.coalesce(chargeable_sms, 0).label("chargeable_billable_sms"), func.coalesce(sms_cost, 0).label('sms_cost'), Service.active ).select_from( Service ).outerjoin( AnnualBilling, and_(Service.id == AnnualBilling.service_id, AnnualBilling.financial_year_start == financial_year) ).outerjoin( ft_billing_subquery, Service.id == ft_billing_subquery.c.service_id ).filter( Service.organisation_id == organisation_id, Service.restricted.is_(False) ).group_by( Service.id, Service.name, AnnualBilling.free_sms_fragment_limit ).order_by( Service.name ) return query.all() def query_organisation_sms_usage_for_year(organisation_id, year): """ See docstring for query_service_sms_usage_for_year() """ year_start, year_end = get_financial_year_dates(year) this_rows_chargeable_units = FactBilling.billable_units * FactBilling.rate_multiplier # Subquery for the number of chargeable units in all rows preceding this one, # which might be none if this is the first row (hence the "coalesce"). chargeable_units_used_before_this_row = func.coalesce( func.sum(this_rows_chargeable_units).over( # order is "ASC" by default order_by=[FactBilling.local_date], # partition by service id partition_by=FactBilling.service_id, # first row to previous row rows=(None, -1) ).cast(Integer), 0 ) # Subquery for how much free allowance we have left before the current row, # so we can work out the cost for this row after taking it into account. remaining_free_allowance_before_this_row = func.greatest( AnnualBilling.free_sms_fragment_limit - chargeable_units_used_before_this_row, 0 ) # Subquery for the number of chargeable_units that we will actually charge # for, after taking any remaining free allowance into account. charged_units = func.greatest(this_rows_chargeable_units - remaining_free_allowance_before_this_row, 0) return db.session.query( Service.id.label('service_id'), FactBilling.local_date, this_rows_chargeable_units.label("chargeable_units"), (charged_units * FactBilling.rate).label("cost"), charged_units.label("charged_units"), ).join( AnnualBilling, AnnualBilling.service_id == Service.id ).outerjoin( FactBilling, and_( Service.id == FactBilling.service_id, FactBilling.local_date >= year_start, FactBilling.local_date <= year_end, FactBilling.notification_type == SMS_TYPE, ) ).filter( Service.organisation_id == organisation_id, AnnualBilling.financial_year_start == year, ) def fetch_usage_year_for_organisation(organisation_id, year): year_start, year_end = get_financial_year_dates(year) today = convert_utc_to_local_timezone(datetime.utcnow()).date() services = dao_get_organisation_live_services(organisation_id) # if year end date is less than today, we are calculating for data in the past and have no need for deltas. if year_end >= today: for service in services: data = fetch_billing_data_for_day(process_day=today, service_id=service.id) for d in data: update_fact_billing(data=d, process_day=today) service_with_usage = {} # initialise results for service in services: service_with_usage[str(service.id)] = { 'service_id': service.id, 'service_name': service.name, 'free_sms_limit': 0, 'sms_remainder': 0, 'sms_billable_units': 0, 'chargeable_billable_sms': 0, 'sms_cost': 0.0, 'emails_sent': 0, 'active': service.active } sms_usages = fetch_sms_billing_for_organisation(organisation_id, year) email_usages = fetch_email_usage_for_organisation(organisation_id, year_start, year_end) for usage in sms_usages: service_with_usage[str(usage.service_id)] = { 'service_id': usage.service_id, 'service_name': usage.service_name, 'free_sms_limit': usage.free_sms_fragment_limit, 'sms_remainder': usage.sms_remainder, 'sms_billable_units': usage.sms_billable_units, 'chargeable_billable_sms': usage.chargeable_billable_sms, 'sms_cost': float(usage.sms_cost), 'emails_sent': 0, 'active': usage.active } for email_usage in email_usages: service_with_usage[str(email_usage.service_id)]['emails_sent'] = email_usage.emails_sent return service_with_usage def fetch_billing_details_for_all_services(): billing_details = db.session.query( Service.id.label('service_id'), func.coalesce(Service.purchase_order_number, Organisation.purchase_order_number).label('purchase_order_number'), func.coalesce(Service.billing_contact_names, Organisation.billing_contact_names).label('billing_contact_names'), func.coalesce( Service.billing_contact_email_addresses, Organisation.billing_contact_email_addresses ).label('billing_contact_email_addresses'), func.coalesce(Service.billing_reference, Organisation.billing_reference).label('billing_reference'), ).outerjoin( Service.organisation ).all() return billing_details def fetch_daily_volumes_for_platform(start_date, end_date): # query to return the total notifications sent per day for each channel. NB start and end dates are inclusive daily_volume_stats = db.session.query( FactBilling.local_date, func.sum(case( [ (FactBilling.notification_type == SMS_TYPE, FactBilling.notifications_sent) ], else_=0 )).label('sms_totals'), func.sum(case( [ (FactBilling.notification_type == SMS_TYPE, FactBilling.billable_units) ], else_=0 )).label('sms_fragment_totals'), func.sum(case( [ (FactBilling.notification_type == SMS_TYPE, FactBilling.billable_units * FactBilling.rate_multiplier) ], else_=0 )).label('sms_fragments_times_multiplier'), func.sum(case( [ (FactBilling.notification_type == EMAIL_TYPE, FactBilling.notifications_sent) ], else_=0 )).label('email_totals'), ).filter( FactBilling.local_date >= start_date, FactBilling.local_date <= end_date ).group_by( FactBilling.local_date, FactBilling.notification_type ).subquery() aggregated_totals = db.session.query( daily_volume_stats.c.local_date.cast(db.Text).label('local_date'), func.sum(daily_volume_stats.c.sms_totals).label('sms_totals'), func.sum(daily_volume_stats.c.sms_fragment_totals).label('sms_fragment_totals'), func.sum( daily_volume_stats.c.sms_fragments_times_multiplier).label('sms_chargeable_units'), func.sum(daily_volume_stats.c.email_totals).label('email_totals'), ).group_by( daily_volume_stats.c.local_date ).order_by( daily_volume_stats.c.local_date ).all() return aggregated_totals def fetch_daily_sms_provider_volumes_for_platform(start_date, end_date): # query to return the total notifications sent per day for each channel. NB start and end dates are inclusive daily_volume_stats = db.session.query( FactBilling.local_date, FactBilling.provider, func.sum(FactBilling.notifications_sent).label('sms_totals'), func.sum(FactBilling.billable_units).label('sms_fragment_totals'), func.sum(FactBilling.billable_units * FactBilling.rate_multiplier).label('sms_chargeable_units'), func.sum(FactBilling.billable_units * FactBilling.rate_multiplier * FactBilling.rate).label('sms_cost'), ).filter( FactBilling.notification_type == SMS_TYPE, FactBilling.local_date >= start_date, FactBilling.local_date <= end_date, ).group_by( FactBilling.local_date, FactBilling.provider, ).order_by( FactBilling.local_date, FactBilling.provider, ).all() return daily_volume_stats def fetch_volumes_by_service(start_date, end_date): # query to return the volume totals by service aggregated for the date range given # start and end dates are inclusive. year_end_date = int(end_date.strftime('%Y')) volume_stats = db.session.query( FactBilling.local_date, FactBilling.service_id, func.sum(case([ (FactBilling.notification_type == SMS_TYPE, FactBilling.notifications_sent) ], else_=0)).label('sms_totals'), func.sum(case([ (FactBilling.notification_type == SMS_TYPE, FactBilling.billable_units * FactBilling.rate_multiplier) ], else_=0)).label('sms_fragments_times_multiplier'), func.sum(case([ (FactBilling.notification_type == EMAIL_TYPE, FactBilling.notifications_sent) ], else_=0)).label('email_totals'), ).filter( FactBilling.local_date >= start_date, FactBilling.local_date <= end_date ).group_by( FactBilling.local_date, FactBilling.service_id, FactBilling.notification_type ).subquery() annual_billing = db.session.query( func.max(AnnualBilling.financial_year_start).label('financial_year_start'), AnnualBilling.service_id, AnnualBilling.free_sms_fragment_limit ).filter( AnnualBilling.financial_year_start <= year_end_date ).group_by( AnnualBilling.service_id, AnnualBilling.free_sms_fragment_limit ).subquery() results = db.session.query( Service.name.label("service_name"), Service.id.label("service_id"), Service.organisation_id.label("organisation_id"), Organisation.name.label("organisation_name"), annual_billing.c.free_sms_fragment_limit.label("free_allowance"), func.coalesce(func.sum(volume_stats.c.sms_totals), 0).label("sms_notifications"), func.coalesce(func.sum(volume_stats.c.sms_fragments_times_multiplier), 0 ).label("sms_chargeable_units"), func.coalesce(func.sum(volume_stats.c.email_totals), 0).label("email_totals"), ).select_from( Service ).outerjoin( Organisation, Service.organisation_id == Organisation.id ).join( annual_billing, Service.id == annual_billing.c.service_id ).outerjoin( # include services without volume volume_stats, Service.id == volume_stats.c.service_id ).filter( Service.restricted.is_(False), Service.count_as_live.is_(True), Service.active.is_(True) ).group_by( Service.id, Service.name, Service.organisation_id, Organisation.name, annual_billing.c.free_sms_fragment_limit ).order_by( Organisation.name, Service.name, ).all() return results