# -*- Mode: Python; coding: utf-8 -*-
# vi:si:et:sw=4:sts=4:ts=4
##
## Copyright (C) 2005-2012 Async Open Source <http://www.async.com.br>
## All rights reserved
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 2 of the License, or
## (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with this program; if not, write to the Free Software
## Foundation, Inc., or visit: http://www.gnu.org/.
##
## Author(s): Stoq Team <stoq-devel@async.com.br>
#
""" Main gui definition for purchase application. """
import datetime
from decimal import Decimal
import pango
import gtk
from kiwi.currency import currency
from kiwi.python import all
from stoqlib.api import api
from stoqlib.domain.purchase import PurchaseOrder, PurchaseOrderView
from stoqlib.enums import SearchFilterPosition
from stoqlib.gui.dialogs.purchasedetails import PurchaseDetailsDialog
from stoqlib.gui.dialogs.sellabledialog import SellableMassEditorDialog
from stoqlib.gui.dialogs.stockcostdialog import StockCostDialog
from stoqlib.gui.dialogs.manufacturerdialog import ProductManufacturerDialog
from stoqlib.gui.search.categorysearch import SellableCategorySearch
from stoqlib.gui.search.consignmentsearch import ConsignmentItemSearch
from stoqlib.gui.search.personsearch import SupplierSearch, TransporterSearch
from stoqlib.gui.search.productsearch import (ProductSearch,
ProductStockSearch,
ProductClosedStockSearch,
ProductsSoldSearch)
from stoqlib.gui.search.purchasesearch import PurchasedItemsSearch
from stoqlib.gui.search.searchcolumns import IdentifierColumn, SearchColumn
from stoqlib.gui.search.searchfilters import ComboSearchFilter, DateSearchFilter
from stoqlib.gui.search.sellableunitsearch import SellableUnitSearch
from stoqlib.gui.search.servicesearch import ServiceSearch
from stoqlib.gui.stockicons import (STOQ_PRODUCTS, STOQ_SUPPLIERS)
from stoqlib.gui.utils.keybindings import get_accels
from stoqlib.gui.wizards.consignmentwizard import (ConsignmentWizard,
CloseInConsignmentWizard)
from stoqlib.gui.wizards.productwizard import ProductCreateWizard
from stoqlib.gui.wizards.purchasefinishwizard import PurchaseFinishWizard
from stoqlib.gui.wizards.purchasequotewizard import (QuotePurchaseWizard,
ReceiveQuoteWizard)
from stoqlib.gui.wizards.purchasewizard import PurchaseWizard
from stoqlib.lib.filizola import generate_filizola_file
from stoqlib.lib.formatters import format_quantity
from stoqlib.lib.message import warning, yesno, info
from stoqlib.lib.permissions import PermissionManager
from stoqlib.lib.translation import stoqlib_ngettext, stoqlib_gettext as _
from stoqlib.reporting.purchase import PurchaseReport
from stoq.gui.shell.shellapp import ShellApp
[docs]class PurchaseApp(ShellApp):
# TODO: Change all widget.set_sensitive to self.set_sensitive([widget])
app_title = _('Purchase')
gladefile = "purchase"
search_spec = PurchaseOrderView
search_label = _('matching:')
report_table = PurchaseReport
action_permissions = {
'ProductUnits': ('ProductUnit', PermissionManager.PERM_SEARCH),
'NewProduct': ('Product', PermissionManager.PERM_CREATE),
'Products': ('Product', PermissionManager.PERM_SEARCH),
'Services': ('Service', PermissionManager.PERM_SEARCH),
}
#
# Application
#
[docs] def create_actions(self):
group = get_accels('app.purchase')
actions = [
# File
("OrderMenu", None, _("Order")),
("NewOrder", gtk.STOCK_NEW, _("Order..."),
group.get('new_order'),
_("Create a new purchase order")),
("NewQuote", gtk.STOCK_INDEX, _("Quote..."),
group.get('new_quote'),
_("Create a new purchase quote")),
("NewConsignment", None, _("Consignment..."),
group.get('new_consignment'),
_("Create a new purchase consignment")),
("NewProduct", None, _("Product..."),
group.get('new_product'),
_("Create a new product")),
("CloseInConsignment", None, _("Close consigment...")),
("ExportFilizola", None, _("Export Filizola File...")),
# Edit
("StockCost", None, _("_Stock cost...")),
# Search
("Categories", None, _("Categories..."),
group.get("search_categories")),
("Products", STOQ_PRODUCTS, _("Products..."),
group.get("search_products")),
("ProductUnits", None, _("Product units..."),
group.get("search_product_units")),
("ProductManufacturers", None, _("Manufacturers..."),
group.get("search_product_manufacturers")),
("Services", None, _("Services..."),
group.get("search_services")),
("SearchStockItems", None, _("Stock items..."),
group.get("search_stock_items")),
("SearchClosedStockItems", None, _("Closed stock items..."),
group.get("search_closed_stock_items")),
("Suppliers", STOQ_SUPPLIERS, _("Suppliers..."),
group.get("search_suppliers")),
("Transporter", None, _("Transporters..."),
group.get("search_transporters")),
("SearchQuotes", None, _("Quotes..."),
group.get("search_quotes")),
("SearchPurchasedItems", None, _("Purchased items..."),
group.get("search_purchased_items")),
("ProductsSoldSearch", None, _("Sold products..."),
group.get("search_products_sold")),
("ProductsPriceSearch", None, _("Prices..."),
group.get("search_prices")),
("SearchInConsignmentItems", None, _("Search consigment items..."),
group.get("search_consignment_items")),
# Order
("Confirm", gtk.STOCK_APPLY, _("Confirm..."),
group.get('order_confirm'),
_("Confirm the selected order(s), marking it as sent to the "
"supplier")),
("Cancel", gtk.STOCK_CANCEL, _("Cancel..."),
group.get('order_cancel'),
_("Cancel the selected order")),
("Edit", gtk.STOCK_EDIT, _("Edit..."),
group.get('order_edit'),
_("Edit the selected order, allowing you to change it's details")),
("Details", gtk.STOCK_INFO, _("Details..."),
group.get('order_details'),
_("Show details of the selected order")),
("Finish", gtk.STOCK_APPLY, _("Finish..."),
group.get('order_finish'),
_('Complete the selected partially received order')),
]
self.purchase_ui = self.add_ui_actions("", actions,
filename="purchase.xml")
self.Confirm.props.is_important = True
self.NewOrder.set_short_label(_("New order"))
self.NewQuote.set_short_label(_("New quote"))
self.Products.set_short_label(_("Products"))
self.Suppliers.set_short_label(_("Suppliers"))
self.Confirm.set_short_label(_("Confirm"))
self.Cancel.set_short_label(_("Cancel"))
self.Finish.set_short_label(_("Finish"))
self.Edit.set_short_label(_("Edit"))
self.Details.set_short_label(_("Details"))
self.set_help_section(_("Purchase help"), 'app-purchase')
self.popup = self.uimanager.get_widget('/PurchaseSelection')
[docs] def create_ui(self):
if api.sysparam.get_bool('SMART_LIST_LOADING'):
self.search.enable_lazy_search()
self.window.add_new_items([
self.NewOrder,
self.NewQuote,
self.NewProduct,
self.NewConsignment])
self.window.add_search_items([
self.Products,
self.Suppliers,
self.SearchQuotes,
self.Services])
self.search.set_summary_label(column='total',
label=('<b>%s</b>' %
api.escape(_('Orders total:'))),
format='<b>%s</b>',
parent=self.get_statusbar_message_area())
self.results.set_selection_mode(gtk.SELECTION_MULTIPLE)
self.Confirm.set_sensitive(False)
self._inventory_widgets = [self.NewConsignment,
self.CloseInConsignment]
self.register_sensitive_group(self._inventory_widgets,
lambda: not self.has_open_inventory())
[docs] def activate(self, refresh=True):
self.window.NewToolItem.set_tooltip(
_("Create a new purchase order"))
self.window.SearchToolItem.set_tooltip(
_("Search for purchase orders"))
self.window.Print.set_tooltip(
_("Print a report of these orders"))
if refresh:
self.refresh()
self._update_view()
self.results.set_selection_mode(gtk.SELECTION_MULTIPLE)
self.check_open_inventory()
self.search.focus_search_entry()
[docs] def deactivate(self):
self.uimanager.remove_ui(self.purchase_ui)
[docs] def new_activate(self):
self._new_order()
[docs] def search_activate(self):
self.run_dialog(ProductSearch, self.store)
[docs] def search_completed(self, results, states):
if len(results):
return
supplier, status = states[:2]
if len(states) > 2 or (supplier.text == '' and status.value is None):
self.search.set_message("%s\n\n%s" % (
_("No orders could be found."),
_("Would you like to %s ?") % (
'<a href="new_order">%s</a>' % (
api.escape(_("create a new order"), )))
))
# FIXME: Push number of results to Statusbar
[docs] def set_open_inventory(self):
self.set_sensitive(self._inventory_widgets, False)
[docs] def create_filters(self):
self.set_text_field_columns(['supplier_name', 'identifier_str'])
self.status_filter = ComboSearchFilter(_('Show orders'),
self._get_status_values())
self.add_filter(self.status_filter, SearchFilterPosition.TOP, ['status'])
self.branch_filter = self.create_branch_filter(column=PurchaseOrderView.branch_id)
[docs] def get_columns(self):
return [IdentifierColumn('identifier', title=_('Purchase #')),
SearchColumn('status_str', title=_('Status'), width=100,
data_type=str, search_attribute='status',
valid_values=self._get_status_values(),
visible=False),
SearchColumn('open_date', title=_('Opened'),
long_title=_('Date Opened'), width=90,
data_type=datetime.date, sorted=True,
order=gtk.SORT_DESCENDING),
SearchColumn('supplier_name', title=_('Supplier'),
data_type=str, searchable=True, expand=True,
ellipsize=pango.ELLIPSIZE_END),
SearchColumn('ordered_quantity', title=_('Ordered'),
data_type=Decimal, width=90,
format_func=format_quantity),
SearchColumn('received_quantity', title=_('Received'),
data_type=Decimal, width=90,
format_func=format_quantity),
SearchColumn('total', title=_('Total'),
data_type=currency, width=120)]
[docs] def print_report(self, *args, **kwargs):
# PurchaseReport needs a status arg
kwargs['status'] = self.status_filter.get_state().value
super(PurchaseApp, self).print_report(*args, **kwargs)
[docs] def search_for_date(self, date):
dfilter = DateSearchFilter(_("Expected receival date"))
dfilter.set_removable()
dfilter.select(data=DateSearchFilter.Type.USER_DAY)
self.add_filter(dfilter, columns=["expected_receival_date"])
dfilter.start_date.set_date(date)
self.refresh()
#
# Private
#
def _update_totals(self):
self._update_view()
def _update_list_aware_widgets(self, has_items):
for widget in (self.Edit, self.Details):
widget.set_sensitive(has_items)
def _update_view(self):
self._update_list_aware_widgets(len(self.results))
selection = self.results.get_selected_rows()
can_edit = one_selected = len(selection) == 1
can_finish = False
if selection:
can_send_supplier = all(
order.status == PurchaseOrder.ORDER_PENDING
for order in selection)
can_cancel = all(order_view.purchase.can_cancel()
for order_view in selection)
else:
can_send_supplier = False
can_cancel = False
if one_selected:
can_edit = (selection[0].status == PurchaseOrder.ORDER_PENDING or
selection[0].status == PurchaseOrder.ORDER_QUOTING or
selection[0].status == PurchaseOrder.ORDER_CONFIRMED)
can_finish = (selection[0].status == PurchaseOrder.ORDER_CONFIRMED and
selection[0].received_quantity > 0)
self.Cancel.set_sensitive(can_cancel)
self.Edit.set_sensitive(can_edit)
self.Confirm.set_sensitive(can_send_supplier)
self.Details.set_sensitive(one_selected)
self.Finish.set_sensitive(can_finish)
def _new_order(self, order=None, edit_mode=False):
with api.new_store() as store:
order = store.fetch(order)
self.run_dialog(PurchaseWizard, store, order, edit_mode)
if store.committed:
self.refresh()
res = self.store.find(PurchaseOrderView, id=store.retval.id).one()
self.select_result(res)
def _edit_order(self):
selected = self.results.get_selected_rows()
qty = len(selected)
if qty != 1:
raise ValueError('You should have only one order selected, '
'got %d instead' % qty)
purchase = selected[0].purchase
if purchase.status == PurchaseOrder.ORDER_QUOTING:
self._quote_order(purchase)
else:
self._new_order(purchase, edit_mode=False)
def _run_details_dialog(self):
order_views = self.results.get_selected_rows()
qty = len(order_views)
if qty != 1:
raise ValueError('You should have only one order selected '
'at this point, got %d' % qty)
self.run_dialog(PurchaseDetailsDialog, self.store,
model=order_views[0].purchase)
def _send_selected_items_to_supplier(self):
orders = self.results.get_selected_rows()
valid_order_views = [
order for order in orders
if order.status == PurchaseOrder.ORDER_PENDING]
if not valid_order_views:
warning(_("There are no pending orders selected."))
return
msg = stoqlib_ngettext(
_("The selected order will be marked as sent."),
_("The %d selected orders will be marked as sent.")
% len(valid_order_views),
len(valid_order_views))
confirm_label = stoqlib_ngettext(_("Confirm order"),
_("Confirm orders"),
len(valid_order_views))
if not yesno(msg, gtk.RESPONSE_YES, confirm_label, _("Don't confirm")):
return
with api.new_store() as store:
for order_view in valid_order_views:
order = store.fetch(order_view.purchase)
order.confirm()
self.refresh()
self.select_result(orders)
def _finish_order(self):
order_views = self.results.get_selected_rows()
qty = len(order_views)
if qty != 1:
raise ValueError('You should have only one order selected '
'at this point, got %d' % qty)
with api.new_store() as store:
order = store.fetch(order_views[0].purchase)
self.run_dialog(PurchaseFinishWizard, store, order)
self.refresh()
self.select_result(order_views)
def _cancel_order(self):
order_views = self.results.get_selected_rows()
assert all(ov.purchase.can_cancel() for ov in order_views)
cancel_label = stoqlib_ngettext(_("Cancel order"),
_("Cancel orders"), len(order_views))
select_label = stoqlib_ngettext(_('The selected order will be cancelled.'),
_('The selected orders will be cancelled.'),
len(order_views))
if not yesno(select_label, gtk.RESPONSE_YES,
cancel_label, _("Don't cancel")):
return
with api.new_store() as store:
for order_view in order_views:
order = store.fetch(order_view.purchase)
order.cancel()
self._update_totals()
self.refresh()
self.select_result(order_views)
def _get_status_values(self):
items = [(text, value)
for value, text in PurchaseOrder.statuses.items()]
items.insert(0, (_('Any'), None))
return items
def _quote_order(self, quote=None):
with api.new_store() as store:
quote = store.fetch(quote)
self.run_dialog(QuotePurchaseWizard, store, quote)
if store.committed:
self.refresh()
res = self.store.find(PurchaseOrderView, id=store.retval.id).one()
self.select_result(res)
def _new_product(self):
ProductCreateWizard.run_wizard(self)
def _new_consignment(self):
with api.new_store() as store:
self.run_dialog(ConsignmentWizard, store, model=None)
if store.committed:
self.refresh()
res = self.store.find(PurchaseOrderView, id=store.retval.id).one()
self.select_result(res)
#
# Kiwi Callbacks
#
[docs] def on_results__right_click(self, results, result, event):
self.popup.popup(None, None, None, event.button, event.time)
[docs] def on_results__row_activated(self, klist, purchase_order_view):
self._run_details_dialog()
[docs] def on_results__selection_changed(self, results, selected):
self._update_view()
[docs] def on_results__activate_link(self, results, uri):
if uri == 'new_order':
self._new_order()
def _on_results__double_click(self, results, order):
self._run_details_dialog()
def _on_results__has_rows(self, results, has_items):
self._update_list_aware_widgets(has_items)
[docs] def on_Details__activate(self, action):
self._run_details_dialog()
[docs] def on_Edit__activate(self, action):
self._edit_order()
[docs] def on_Cancel__activate(self, action):
self._cancel_order()
[docs] def on_Confirm__activate(self, button):
self._send_selected_items_to_supplier()
[docs] def on_Finish__activate(self, action):
self._finish_order()
[docs] def on_ExportFilizola__activate(self, action):
dest = generate_filizola_file(self.store)
info(_('File saved in %s') % dest)
# Order
[docs] def on_StockCost__activate(self, action):
self.run_dialog(StockCostDialog, self.store, None)
# Consignment
[docs] def on_CloseInConsignment__activate(self, action):
with api.new_store() as store:
self.run_dialog(CloseInConsignmentWizard, store)
[docs] def on_SearchInConsignmentItems__activate(self, action):
self.run_dialog(ConsignmentItemSearch, self.store)
[docs] def on_Categories__activate(self, action):
self.run_dialog(SellableCategorySearch, self.store)
[docs] def on_SearchQuotes__activate(self, action):
with api.new_store() as store:
self.run_dialog(ReceiveQuoteWizard, store)
self.refresh()
[docs] def on_SearchPurchasedItems__activate(self, action):
self.run_dialog(PurchasedItemsSearch, self.store)
[docs] def on_SearchStockItems__activate(self, action):
self.run_dialog(ProductStockSearch, self.store)
[docs] def on_SearchClosedStockItems__activate(self, action):
self.run_dialog(ProductClosedStockSearch, self.store)
[docs] def on_Suppliers__activate(self, action):
self.run_dialog(SupplierSearch, self.store, hide_footer=True)
[docs] def on_Products__activate(self, action):
self.run_dialog(ProductSearch, self.store)
[docs] def on_ProductUnits__activate(self, action):
self.run_dialog(SellableUnitSearch, self.store)
[docs] def on_ProductManufacturers__activate(self, action):
self.run_dialog(ProductManufacturerDialog, self.store)
[docs] def on_Services__activate(self, action):
self.run_dialog(ServiceSearch, self.store, hide_price_column=True)
[docs] def on_Transporter__activate(self, action):
self.run_dialog(TransporterSearch, self.store, hide_footer=True)
[docs] def on_ProductsSoldSearch__activate(self, action):
self.run_dialog(ProductsSoldSearch, self.store)
[docs] def on_ProductsPriceSearch__activate(self, action):
with api.new_store() as store:
self.run_dialog(SellableMassEditorDialog, store)
# Toolitem
[docs] def on_NewOrder__activate(self, action):
self._new_order()
[docs] def on_NewQuote__activate(self, action):
self._quote_order()
[docs] def on_NewProduct__activate(self, action):
self._new_product()
[docs] def on_NewConsignment__activate(self, action):
self._new_consignment()