From ad08d4ce9611e9d5f59e674bd6198a9eef2cdc5f Mon Sep 17 00:00:00 2001
From: tundebabzy <tundebabzy@gmail.com>
Date: Wed, 16 May 2018 07:01:41 +0100
Subject: [PATCH] Ability to hold payment for disputed invoices #12048 (#13298)

* add new fields to Supplier Master:
- on_hold: To signal the Customer is blocked from completing certain transactions
- hold_type: 3 options - All, invoices and payments

* sanitize `on_hold` field input

* show hold status in list view

* add `release_date` field to Supplier Master:
- specifies the date when transaction restraint will be removed

* reset release date if supplier is not on hold

* add validation to stop transactions when Supplier is blocked

* add test cases

* return empty list for outstanding references if supplier is blocked

* block make button:payment if supplier is blocked

* adjust test cases

* PEP 8 clean up

* more tests

* adds new fields to Purchase Invoice:
- release_date: once set, invoice will be on hold until set date
- hold_comment: so user can add comment pertaining to why invoice is on hold

* implement individual purchase invoice on hold logic

* allow user to change release date

* update manual

* final cleanup including more validation and tests

* update supplier manual

* make default for release_date argument todays date

* remove Auto Repeat added by mistake

* add on_hold_field to purchase invoice

* add 'On Hold' or 'Temporarily on Hold' status for purchase invoice in list view

* implement explicit payment hold in purchase invoice

* update manual

* add dialog for saving comment

* bug fix, refactor, clean up

* more test cases
---
 .../doctype/payment_entry/payment_entry.py    |  45 +++--
 .../payment_entry/test_payment_entry.py       |  63 +++++++
 .../purchase_invoice/purchase_invoice.js      | 121 ++++++++++++-
 .../purchase_invoice/purchase_invoice.json    | 161 +++++++++++++++++-
 .../purchase_invoice/purchase_invoice.py      |  47 ++++-
 .../purchase_invoice/purchase_invoice_list.js |   8 +-
 .../purchase_invoice/test_purchase_invoice.py | 101 +++++++++++
 erpnext/accounts/utils.py                     |  47 +++--
 .../purchase_order/test_purchase_order.py     |  72 ++++++++
 erpnext/buying/doctype/supplier/supplier.json | 132 +++++++++++++-
 erpnext/buying/doctype/supplier/supplier.py   |  10 +-
 .../buying/doctype/supplier/supplier_list.js  |   7 +-
 erpnext/controllers/accounts_controller.py    |  36 +++-
 .../img/accounts/purchase-invoice-hold.png    | Bin 0 -> 37126 bytes
 .../manual/en/accounts/purchase-invoice.md    |  38 +++++
 .../docs/user/manual/en/buying/supplier.md    |  15 +-
 16 files changed, 865 insertions(+), 38 deletions(-)
 create mode 100644 erpnext/docs/assets/img/accounts/purchase-invoice-hold.png

diff --git a/erpnext/accounts/doctype/payment_entry/payment_entry.py b/erpnext/accounts/doctype/payment_entry/payment_entry.py
index 96b997f9d7..8539c36c43 100644
--- a/erpnext/accounts/doctype/payment_entry/payment_entry.py
+++ b/erpnext/accounts/doctype/payment_entry/payment_entry.py
@@ -5,14 +5,14 @@
 from __future__ import unicode_literals
 import frappe, erpnext, json
 from frappe import _, scrub, ValidationError
-from frappe.utils import flt, comma_or, nowdate
+from frappe.utils import flt, comma_or, nowdate, getdate
 from erpnext.accounts.utils import get_outstanding_invoices, get_account_currency, get_balance_on
 from erpnext.accounts.party import get_party_account, get_patry_tax_withholding_details
 from erpnext.accounts.doctype.journal_entry.journal_entry import get_default_bank_cash_account
 from erpnext.setup.utils import get_exchange_rate
 from erpnext.accounts.general_ledger import make_gl_entries
 from erpnext.hr.doctype.expense_claim.expense_claim import update_reimbursed_amount
-from erpnext.controllers.accounts_controller import AccountsController
+from erpnext.controllers.accounts_controller import AccountsController, get_supplier_block_status
 
 from six import string_types
 
@@ -59,6 +59,7 @@ class PaymentEntry(AccountsController):
 		self.set_remarks()
 		self.validate_duplicate_entry()
 		self.validate_allocated_amount()
+		self.ensure_supplier_is_not_blocked()
 
 	def on_submit(self):
 		self.setup_party_account_field()
@@ -537,6 +538,16 @@ def get_outstanding_reference_documents(args):
 	if isinstance(args, string_types):
 		args = json.loads(args)
 
+	# confirm that Supplier is not blocked
+	if args.get('party_type') == 'Supplier':
+		supplier_status = get_supplier_block_status(args['party'])
+		if supplier_status['on_hold']:
+			if supplier_status['hold_type'] == 'All':
+				return []
+			elif supplier_status['hold_type'] == 'Payments':
+				if not supplier_status['release_date'] or getdate(nowdate()) <= supplier_status['release_date']:
+					return []
+
 	party_account_currency = get_account_currency(args.get("party_account"))
 	company_currency = frappe.db.get_value("Company", args.get("company"), "default_currency")
 
@@ -621,6 +632,9 @@ def get_orders_to_be_billed(posting_date, party_type, party, party_account_curre
 
 def get_negative_outstanding_invoices(party_type, party, party_account, party_account_currency, company_currency):
 	voucher_type = "Sales Invoice" if party_type == "Customer" else "Purchase Invoice"
+	supplier_condition = ""
+	if voucher_type == "Purchase Invoice":
+		supplier_condition = "and (release_date is null or release_date <= CURDATE())"
 	if party_account_currency == company_currency:
 		grand_total_field = "base_grand_total"
 		rounded_total_field = "base_rounded_total"
@@ -638,9 +652,11 @@ def get_negative_outstanding_invoices(party_type, party, party_account, party_ac
 			`tab{voucher_type}`
 		where
 			{party_type} = %s and {party_account} = %s and docstatus = 1 and outstanding_amount < 0
+			{supplier_condition}
 		order by
 			posting_date, name
 		""".format(**{
+			"supplier_condition": supplier_condition,
 			"rounded_total_field": rounded_total_field,
 			"grand_total_field": grand_total_field,
 			"voucher_type": voucher_type,
@@ -854,6 +870,9 @@ def get_payment_entry(dt, dn, party_amount=None, bank_account=None, bank_amount=
 	pe.mode_of_payment = doc.get("mode_of_payment")
 	pe.party_type = party_type
 	pe.party = doc.get(scrub(party_type))
+
+	pe.ensure_supplier_is_not_blocked()
+
 	pe.paid_from = party_account if payment_type=="Receive" else bank.account
 	pe.paid_to = party_account if payment_type=="Pay" else bank.account
 	pe.paid_from_account_currency = party_account_currency \
@@ -864,15 +883,19 @@ def get_payment_entry(dt, dn, party_amount=None, bank_account=None, bank_amount=
 	pe.allocate_payment_amount = 1
 	pe.letter_head = doc.get("letter_head")
 
-	pe.append("references", {
-		'reference_doctype': dt,
-		'reference_name': dn,
-		"bill_no": doc.get("bill_no"),
-		"due_date": doc.get("due_date"),
-		'total_amount': grand_total,
-		'outstanding_amount': outstanding_amount,
-		'allocated_amount': outstanding_amount
-	})
+	# only Purchase Invoice can be blocked individually
+	if doc.doctype == "Purchase Invoice" and doc.invoice_is_blocked():
+		frappe.msgprint(_('{0} is on hold till {1}'.format(doc.name, doc.release_date)))
+	else:
+		pe.append("references", {
+			'reference_doctype': dt,
+			'reference_name': dn,
+			"bill_no": doc.get("bill_no"),
+			"due_date": doc.get("due_date"),
+			'total_amount': grand_total,
+			'outstanding_amount': outstanding_amount,
+			'allocated_amount': outstanding_amount
+		})
 
 	pe.setup_party_account_field()
 	pe.set_missing_values()
diff --git a/erpnext/accounts/doctype/payment_entry/test_payment_entry.py b/erpnext/accounts/doctype/payment_entry/test_payment_entry.py
index 435bee0659..57516a1bbb 100644
--- a/erpnext/accounts/doctype/payment_entry/test_payment_entry.py
+++ b/erpnext/accounts/doctype/payment_entry/test_payment_entry.py
@@ -40,6 +40,69 @@ class TestPaymentEntry(unittest.TestCase):
 		so_advance_paid = frappe.db.get_value("Sales Order", so.name, "advance_paid")
 		self.assertEqual(so_advance_paid, 0)
 
+	def test_payment_entry_for_blocked_supplier_invoice(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Invoices'
+		supplier.save()
+
+		self.assertRaises(frappe.ValidationError, make_purchase_invoice)
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_payment_entry_for_blocked_supplier_payments(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Payments'
+		supplier.save()
+
+		pi = make_purchase_invoice()
+
+		self.assertRaises(
+			frappe.ValidationError, get_payment_entry, dt='Purchase Invoice', dn=pi.name,
+			bank_account="_Test Bank - _TC")
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_payment_entry_for_blocked_supplier_payments_today_date(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Payments'
+		supplier.release_date = nowdate()
+		supplier.save()
+
+		pi = make_purchase_invoice()
+
+		self.assertRaises(
+			frappe.ValidationError, get_payment_entry, dt='Purchase Invoice', dn=pi.name,
+			bank_account="_Test Bank - _TC")
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_payment_entry_for_blocked_supplier_payments_past_date(self):
+		# this test is meant to fail only if something fails in the try block
+		with self.assertRaises(Exception):
+			try:
+				supplier = frappe.get_doc('Supplier', '_Test Supplier')
+				supplier.on_hold = 1
+				supplier.hold_type = 'Payments'
+				supplier.release_date = '2018-03-01'
+				supplier.save()
+
+				pi = make_purchase_invoice()
+
+				get_payment_entry('Purchase Invoice', pi.name, bank_account="_Test Bank - _TC")
+
+				supplier.on_hold = 0
+				supplier.save()
+			except:
+				pass
+			else:
+				raise Exception
+
 	def test_payment_entry_against_si_usd_to_usd(self):
 		si = create_sales_invoice(customer="_Test Customer USD", debit_to="_Test Receivable USD - _TC",
 			currency="USD", conversion_rate=50)
diff --git a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.js b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.js
index d2c41938fe..c1a2c9741b 100644
--- a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.js
+++ b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.js
@@ -27,6 +27,7 @@ erpnext.accounts.PurchaseInvoice = erpnext.buying.BuyingController.extend({
 	},
 
 	refresh: function(doc) {
+		const me = this;
 		this._super();
 
 		hide_fields(this.frm.doc);
@@ -37,6 +38,27 @@ erpnext.accounts.PurchaseInvoice = erpnext.buying.BuyingController.extend({
 			this.show_stock_ledger();
 		}
 
+		if(!doc.is_return && doc.docstatus == 1 && doc.outstanding_amount != 0){
+			if(doc.on_hold) {
+				this.frm.add_custom_button(
+					__('Change Release Date'),
+					function() {me.change_release_date()},
+					__('Hold Invoice')
+				);
+				this.frm.add_custom_button(
+					__('Unblock Invoice'),
+					function() {me.unblock_invoice()},
+					__('Make')
+				);
+			} else if (!doc.on_hold) {
+				this.frm.add_custom_button(
+					__('Block Invoice'),
+					function() {me.block_invoice()},
+					__('Make')
+				);
+			}
+		}
+
 		if(!doc.is_return && doc.docstatus==1) {
 			if(doc.outstanding_amount != 0) {
 				this.frm.add_custom_button(__('Payment'), this.make_payment_entry, __("Make"));
@@ -56,7 +78,6 @@ erpnext.accounts.PurchaseInvoice = erpnext.buying.BuyingController.extend({
 		}
 
 		if(doc.docstatus===0) {
-			var me = this;
 			this.frm.add_custom_button(__('Purchase Order'), function() {
 				erpnext.utils.map_current_doc({
 					method: "erpnext.buying.doctype.purchase_order.purchase_order.make_purchase_invoice",
@@ -109,6 +130,104 @@ erpnext.accounts.PurchaseInvoice = erpnext.buying.BuyingController.extend({
 		}
 	},
 
+	unblock_invoice: function() {
+		const me = this;
+		frappe.call({
+			'method': 'erpnext.accounts.doctype.purchase_invoice.purchase_invoice.unblock_invoice',
+			'args': {'name': me.frm.doc.name},
+			'callback': (r) => me.frm.reload_doc()
+		});
+	},
+
+	block_invoice: function() {
+		this.make_comment_dialog_and_block_invoice();
+	},
+
+	change_release_date: function() {
+		this.make_dialog_and_set_release_date();
+	},
+
+	can_change_release_date: function(date) {
+		const diff = frappe.datetime.get_diff(date, frappe.datetime.nowdate());
+		if (diff < 0) {
+			frappe.throw('New release date should be in the future');
+			return false;
+		} else {
+			return true;
+		}
+	},
+
+	make_comment_dialog_and_block_invoice: function(){
+		const me = this;
+
+		const title = __('Add Comment');
+		const fields = [
+			{
+				fieldname: 'hold_comment',
+				read_only: 0,
+				fieldtype:'Small Text',
+				label: __('Reason For Putting On Hold'),
+				default: ""
+			},
+		];
+
+		this.dialog = new frappe.ui.Dialog({
+			title: title,
+			fields: fields
+		});
+
+		this.dialog.set_primary_action(__('Save'), function() {
+			const dialog_data = me.dialog.get_values();
+			frappe.call({
+				'method': 'erpnext.accounts.doctype.purchase_invoice.purchase_invoice.block_invoice',
+				'args': {'name': me.frm.doc.name, 'hold_comment': dialog_data.hold_comment},
+				'callback': (r) => me.frm.reload_doc()
+			});
+			me.dialog.hide();
+		});
+
+		this.dialog.show();
+	},
+
+	make_dialog_and_set_release_date: function() {
+		const me = this;
+
+		const title = __('Set New Release Date');
+		const fields = [
+			{
+				fieldname: 'release_date',
+				read_only: 0,
+				fieldtype:'Date',
+				label: __('Release Date'),
+				default: me.frm.doc.release_date
+			},
+		];
+
+		this.dialog = new frappe.ui.Dialog({
+			title: title,
+			fields: fields
+		});
+
+		this.dialog.set_primary_action(__('Save'), function() {
+			me.dialog_data = me.dialog.get_values();
+			if(me.can_change_release_date(me.dialog_data.release_date)) {
+				me.dialog_data.name = me.frm.doc.name;
+				me.set_release_date(me.dialog_data);
+				me.dialog.hide();
+			}
+		});
+
+		this.dialog.show();
+	},
+
+	set_release_date: function(data) {
+		return frappe.call({
+			'method': 'erpnext.accounts.doctype.purchase_invoice.purchase_invoice.change_release_date',
+			'args': data,
+			'callback': (r) => this.frm.reload_doc()
+		});
+	},
+
 	supplier: function() {
 		var me = this;
 		if(this.frm.updating_party_details)
diff --git a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.json b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.json
index 8acdf5c4b8..a8fa9f7529 100755
--- a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.json
+++ b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.json
@@ -432,6 +432,165 @@
    "translatable": 0, 
    "unique": 0
   }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 1, 
+   "collapsible_depends_on": "eval:doc.on_hold", 
+   "columns": 0, 
+   "fieldname": "sb_14", 
+   "fieldtype": "Section Break", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Hold Invoice", 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "default": "0", 
+   "fieldname": "on_hold", 
+   "fieldtype": "Check", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Hold Invoice", 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "depends_on": "eval:doc.on_hold", 
+   "description": "Once set, this invoice will be on hold till the set date", 
+   "fieldname": "release_date", 
+   "fieldtype": "Date", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Release Date", 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "fieldname": "cb_17", 
+   "fieldtype": "Column Break", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "depends_on": "eval:doc.on_hold", 
+   "fieldname": "hold_comment", 
+   "fieldtype": "Small Text", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Reason For Putting On Hold", 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
   {
    "allow_bulk_edit": 0, 
    "allow_on_submit": 0, 
@@ -4072,7 +4231,7 @@
  "istable": 0, 
  "max_attachments": 0, 
  "menu_index": 0, 
- "modified": "2018-04-19 15:48:29.457594", 
+ "modified": "2018-04-19 15:48:29.457594",
  "modified_by": "Administrator", 
  "module": "Accounts", 
  "name": "Purchase Invoice", 
diff --git a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.py b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.py
index f6103cc89f..9599d1f53f 100644
--- a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.py
+++ b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice.py
@@ -3,7 +3,7 @@
 
 from __future__ import unicode_literals
 import frappe, erpnext
-from frappe.utils import cint, formatdate, flt, getdate
+from frappe.utils import cint, cstr, formatdate, flt, getdate, nowdate
 from frappe import _, throw
 import frappe.defaults
 
@@ -41,6 +41,13 @@ class PurchaseInvoice(BuyingController):
 			'overflow_type': 'billing'
 		}]
 
+	def before_save(self):
+		if not self.on_hold:
+			self.release_date = ''
+
+	def invoice_is_blocked(self):
+		return self.on_hold and (not self.release_date or self.release_date > getdate(nowdate()))
+
 	def validate(self):
 		if not self.is_opening:
 			self.is_opening = 'No'
@@ -61,6 +68,7 @@ class PurchaseInvoice(BuyingController):
 		if self._action=="submit" and self.update_stock:
 			self.make_batches('warehouse')
 
+		self.validate_release_date()
 		self.check_conversion_rate()
 		self.validate_credit_to_acc()
 		self.clear_unallocated_advances("Purchase Invoice Advance", "advances")
@@ -78,6 +86,10 @@ class PurchaseInvoice(BuyingController):
 		self.set_status()
 		validate_inter_company_party(self.doctype, self.supplier, self.company, self.inter_company_invoice_reference)
 
+	def validate_release_date(self):
+		if self.release_date and getdate(nowdate()) >= getdate(self.release_date):
+			frappe.msgprint('Release date must be in the future', raise_exception=True)
+
 	def validate_cash(self):
 		if not self.cash_bank_account and flt(self.paid_amount):
 			frappe.throw(_("Cash or Bank Account is mandatory for making payment entry"))
@@ -730,7 +742,15 @@ class PurchaseInvoice(BuyingController):
 	def on_recurring(self, reference_doc, auto_repeat_doc):
 		self.due_date = None
 
-	def set_tax_withholding(self):
+	def block_invoice(self, hold_comment=None):
+		self.db_set('on_hold', 1)
+		self.db_set('hold_comment', cstr(hold_comment))
+
+	def unblock_invoice(self):
+		self.db_set('on_hold', 0)
+		self.db_set('release_date', None)
+
+  def set_tax_withholding(self):
 		"""
 			1. Get TDS Configurations against Supplier
 		"""
@@ -768,7 +788,28 @@ def make_stock_entry(source_name, target_doc=None):
 
 	return doc
 
+@frappe.whitelist()
+def change_release_date(name, release_date=None):
+	if frappe.db.exists('Purchase Invoice', name):
+		pi = frappe.get_doc('Purchase Invoice', name)
+		pi.db_set('release_date', release_date)
+
+
+@frappe.whitelist()
+def unblock_invoice(name):
+	if frappe.db.exists('Purchase Invoice', name):
+		pi = frappe.get_doc('Purchase Invoice', name)
+		pi.unblock_invoice()
+
+
+@frappe.whitelist()
+def block_invoice(name, hold_comment):
+	if frappe.db.exists('Purchase Invoice', name):
+		pi = frappe.get_doc('Purchase Invoice', name)
+		pi.block_invoice(hold_comment)
+
 @frappe.whitelist()
 def make_inter_company_sales_invoice(source_name, target_doc=None):
 	from erpnext.accounts.doctype.sales_invoice.sales_invoice import make_inter_company_invoice
-	return make_inter_company_invoice("Purchase Invoice", source_name, target_doc)
\ No newline at end of file
+	return make_inter_company_invoice("Purchase Invoice", source_name, target_doc)
+
diff --git a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice_list.js b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice_list.js
index 8283acc4f1..4103e57df8 100644
--- a/erpnext/accounts/doctype/purchase_invoice/purchase_invoice_list.js
+++ b/erpnext/accounts/doctype/purchase_invoice/purchase_invoice_list.js
@@ -4,12 +4,16 @@
 // render
 frappe.listview_settings['Purchase Invoice'] = {
 	add_fields: ["supplier", "supplier_name", "base_grand_total", "outstanding_amount", "due_date", "company",
-		"currency", "is_return"],
+		"currency", "is_return", "release_date", "on_hold"],
 	get_indicator: function(doc) {
 		if(cint(doc.is_return)==1) {
 			return [__("Return"), "darkgrey", "is_return,=,Yes"];
 		} else if(flt(doc.outstanding_amount) > 0 && doc.docstatus==1) {
-			if(frappe.datetime.get_diff(doc.due_date) < 0) {
+			if(cint(doc.on_hold) && !doc.release_date) {
+				return [__("On Hold"), "darkgrey"];
+			} else if(cint(doc.on_hold) && doc.release_date && frappe.datetime.get_diff(doc.release_date, frappe.datetime.nowdate()) > 0) {
+				return [__("Temporarily on Hold"), "darkgrey"];
+			} else if(frappe.datetime.get_diff(doc.due_date) < 0) {
 				return [__("Overdue"), "red", "outstanding_amount,>,0|due_date,<,Today"];
 			} else {
 				return [__("Unpaid"), "orange", "outstanding_amount,>,0|due,>=,Today"];
diff --git a/erpnext/accounts/doctype/purchase_invoice/test_purchase_invoice.py b/erpnext/accounts/doctype/purchase_invoice/test_purchase_invoice.py
index a99a86a993..339d2750b0 100644
--- a/erpnext/accounts/doctype/purchase_invoice/test_purchase_invoice.py
+++ b/erpnext/accounts/doctype/purchase_invoice/test_purchase_invoice.py
@@ -6,6 +6,7 @@ from __future__ import unicode_literals
 import unittest
 import frappe, erpnext
 import frappe.model
+from erpnext.accounts.doctype.payment_entry.payment_entry import get_payment_entry
 from frappe.utils import cint, flt, today, nowdate, add_days
 import frappe.defaults
 from erpnext.stock.doctype.purchase_receipt.test_purchase_receipt import set_perpetual_inventory, \
@@ -91,6 +92,106 @@ class TestPurchaseInvoice(unittest.TestCase):
 
 		self.assertRaises(frappe.LinkExistsError, pi_doc.cancel)
 
+	def test_purchase_invoice_for_blocked_supplier(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.save()
+
+		self.assertRaises(frappe.ValidationError, make_purchase_invoice)
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_purchase_invoice_for_blocked_supplier_invoice(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Invoices'
+		supplier.save()
+
+		self.assertRaises(frappe.ValidationError, make_purchase_invoice)
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_purchase_invoice_for_blocked_supplier_payment(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Payments'
+		supplier.save()
+
+		pi = make_purchase_invoice()
+
+		self.assertRaises(
+			frappe.ValidationError, get_payment_entry, dt='Purchase Invoice', dn=pi.name, bank_account="_Test Bank - _TC")
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_purchase_invoice_for_blocked_supplier_payment_today_date(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Payments'
+		supplier.release_date = nowdate()
+		supplier.save()
+
+		pi = make_purchase_invoice()
+
+		self.assertRaises(
+			frappe.ValidationError, get_payment_entry, dt='Purchase Invoice', dn=pi.name,
+			bank_account="_Test Bank - _TC")
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_purchase_invoice_for_blocked_supplier_payment_past_date(self):
+		# this test is meant to fail only if something fails in the try block
+		with self.assertRaises(Exception):
+			try:
+				supplier = frappe.get_doc('Supplier', '_Test Supplier')
+				supplier.on_hold = 1
+				supplier.hold_type = 'Payments'
+				supplier.release_date = '2018-03-01'
+				supplier.save()
+
+				pi = make_purchase_invoice()
+
+				get_payment_entry('Purchase Invoice', dn=pi.name, bank_account="_Test Bank - _TC")
+
+				supplier.on_hold = 0
+				supplier.save()
+			except:
+				pass
+			else:
+				raise Exception
+
+	def test_purchase_invoice_blocked_invoice_must_be_in_future(self):
+		pi = make_purchase_invoice(do_not_save=True)
+		pi.release_date = nowdate()
+
+		self.assertRaises(frappe.ValidationError, pi.save)
+		pi.release_date = ''
+		pi.save()
+
+	def test_purchase_invoice_temporary_blocked(self):
+		pi = make_purchase_invoice(do_not_save=True)
+		pi.release_date = add_days(nowdate(), 10)
+		pi.save()
+		pi.submit()
+
+		pe = get_payment_entry('Purchase Invoice', dn=pi.name, bank_account="_Test Bank - _TC")
+
+		self.assertRaises(frappe.ValidationError, pe.save)
+
+	def test_purchase_invoice_explicit_block(self):
+		pi = make_purchase_invoice()
+		pi.block_invoice()
+
+		self.assertEqual(pi.on_hold, 1)
+
+		pi.unblock_invoice()
+
+		self.assertEqual(pi.on_hold, 0)
+
 	def test_gl_entries_with_perpetual_inventory_against_pr(self):
 		pr = frappe.copy_doc(pr_test_records[0])
 		set_perpetual_inventory(1, pr.company)
diff --git a/erpnext/accounts/utils.py b/erpnext/accounts/utils.py
index 9c7310fb45..8c86887186 100644
--- a/erpnext/accounts/utils.py
+++ b/erpnext/accounts/utils.py
@@ -572,6 +572,22 @@ def get_stock_rbnb_difference(posting_date, company):
 	return flt(stock_rbnb) + flt(sys_bal)
 
 
+def get_held_invoices(party_type, party):
+	"""
+	Returns a list of names Purchase Invoices for the given party that are on hold
+	"""
+	held_invoices = None
+
+	if party_type == 'Supplier':
+		held_invoices = frappe.db.sql(
+			'select name from `tabPurchase Invoice` where release_date IS NOT NULL and release_date > CURDATE()',
+			as_dict=1
+		)
+		held_invoices = [d['name'] for d in held_invoices]
+
+	return held_invoices
+
+
 def get_outstanding_invoices(party_type, party, account, condition=None):
 	outstanding_invoices = []
 	precision = frappe.get_precision("Sales Invoice", "outstanding_amount")
@@ -584,7 +600,9 @@ def get_outstanding_invoices(party_type, party, account, condition=None):
 		payment_dr_or_cr = "payment_gl_entry.debit_in_account_currency - payment_gl_entry.credit_in_account_currency"
 
 	invoice = 'Sales Invoice' if erpnext.get_party_account_type(party_type) == 'Receivable' else 'Purchase Invoice'
-	invoice_list = frappe.db.sql("""
+	held_invoices = get_held_invoices(party_type, party)
+
+  invoice_list = frappe.db.sql("""
 		select
 			voucher_no, voucher_type, posting_date, ifnull(sum({dr_or_cr}), 0) as invoice_amount,
 			(
@@ -622,20 +640,21 @@ def get_outstanding_invoices(party_type, party, account, condition=None):
 		}, as_dict=True)
 
 	for d in invoice_list:
-		due_date = frappe.db.get_value(d.voucher_type, d.voucher_no,
-			"posting_date" if party_type == "Employee" else "due_date")
+		if not d.voucher_type == "Purchase Invoice" or d.voucher_no not in held_invoices:
+			due_date = frappe.db.get_value(
+				d.voucher_type, d.voucher_no, "posting_date" if party_type == "Employee" else "due_date")
 
-		outstanding_invoices.append(
-			frappe._dict({
-				'voucher_no': d.voucher_no,
-				'voucher_type': d.voucher_type,
-				'posting_date': d.posting_date,
-				'invoice_amount': flt(d.invoice_amount),
-				'payment_amount': flt(d.payment_amount),
-				'outstanding_amount': flt(d.invoice_amount - d.payment_amount, precision),
-				'due_date': due_date
-			})
-		)
+			outstanding_invoices.append(
+				frappe._dict({
+					'voucher_no': d.voucher_no,
+					'voucher_type': d.voucher_type,
+					'posting_date': d.posting_date,
+					'invoice_amount': flt(d.invoice_amount),
+					'payment_amount': flt(d.payment_amount),
+					'outstanding_amount': flt(d.invoice_amount - d.payment_amount, precision),
+					'due_date': due_date
+				})
+			)
 
 	outstanding_invoices = sorted(outstanding_invoices, key=lambda k: k['due_date'] or getdate(nowdate()))
 
diff --git a/erpnext/buying/doctype/purchase_order/test_purchase_order.py b/erpnext/buying/doctype/purchase_order/test_purchase_order.py
index 873fc74537..0d46318731 100644
--- a/erpnext/buying/doctype/purchase_order/test_purchase_order.py
+++ b/erpnext/buying/doctype/purchase_order/test_purchase_order.py
@@ -5,6 +5,7 @@ from __future__ import unicode_literals
 import unittest
 import frappe
 import frappe.defaults
+from erpnext.accounts.doctype.payment_entry.payment_entry import get_payment_entry
 from frappe.utils import flt, add_days, nowdate
 from erpnext.buying.doctype.purchase_order.purchase_order import (make_purchase_receipt, make_purchase_invoice, make_rm_stock_entry as make_subcontract_transfer_entry)
 from erpnext.stock.doctype.stock_entry.test_stock_entry import make_stock_entry
@@ -163,6 +164,77 @@ class TestPurchaseOrder(unittest.TestCase):
 
 		self.assertTrue(po.get('payment_schedule'))
 
+	def test_po_for_blocked_supplier_all(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.save()
+
+		self.assertEqual(supplier.hold_type, 'All')
+		self.assertRaises(frappe.ValidationError, create_purchase_order)
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_po_for_blocked_supplier_invoices(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Invoices'
+		supplier.save()
+
+		self.assertRaises(frappe.ValidationError, create_purchase_order)
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_po_for_blocked_supplier_payments(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.hold_type = 'Payments'
+		supplier.save()
+
+		po = create_purchase_order()
+
+		self.assertRaises(
+			frappe.ValidationError, get_payment_entry, dt='Purchase Order', dn=po.name, bank_account="_Test Bank - _TC")
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_po_for_blocked_supplier_payments_with_today_date(self):
+		supplier = frappe.get_doc('Supplier', '_Test Supplier')
+		supplier.on_hold = 1
+		supplier.release_date = nowdate()
+		supplier.hold_type = 'Payments'
+		supplier.save()
+
+		po = create_purchase_order()
+
+		self.assertRaises(
+			frappe.ValidationError, get_payment_entry, dt='Purchase Order', dn=po.name, bank_account="_Test Bank - _TC")
+
+		supplier.on_hold = 0
+		supplier.save()
+
+	def test_po_for_blocked_supplier_payments_past_date(self):
+		# this test is meant to fail only if something fails in the try block
+		with self.assertRaises(Exception):
+			try:
+				supplier = frappe.get_doc('Supplier', '_Test Supplier')
+				supplier.on_hold = 1
+				supplier.hold_type = 'Payments'
+				supplier.release_date = '2018-03-01'
+				supplier.save()
+
+				po = create_purchase_order()
+				get_payment_entry('Purchase Order', po.name, bank_account='_Test Bank - _TC')
+
+				supplier.on_hold = 0
+				supplier.save()
+			except:
+				pass
+			else:
+				raise Exception
+
 	def test_terms_does_not_copy(self):
 		po = create_purchase_order()
 
diff --git a/erpnext/buying/doctype/supplier/supplier.json b/erpnext/buying/doctype/supplier/supplier.json
index eedbac1dff..181b214b00 100644
--- a/erpnext/buying/doctype/supplier/supplier.json
+++ b/erpnext/buying/doctype/supplier/supplier.json
@@ -108,7 +108,7 @@
    "reqd": 1, 
    "search_index": 0, 
    "set_only_once": 0, 
-   "translatable": 0,
+   "translatable": 0, 
    "unique": 0
   }, 
   {
@@ -770,7 +770,135 @@
    "reqd": 0, 
    "search_index": 0, 
    "set_only_once": 0, 
-   "translatable": 0,
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "fieldname": "cb_21", 
+   "fieldtype": "Column Break", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "default": "0", 
+   "fieldname": "on_hold", 
+   "fieldtype": "Check", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Block Supplier", 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "depends_on": "eval:doc.on_hold", 
+   "fieldname": "hold_type", 
+   "fieldtype": "Select", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Hold Type", 
+   "length": 0, 
+   "no_copy": 0, 
+   "options": "\nAll\nInvoices\nPayments", 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
+   "unique": 0
+  }, 
+  {
+   "allow_bulk_edit": 0, 
+   "allow_on_submit": 0, 
+   "bold": 0, 
+   "collapsible": 0, 
+   "columns": 0, 
+   "depends_on": "eval:doc.on_hold", 
+   "description": "Leave blank if the Supplier is blocked indefinitely", 
+   "fieldname": "release_date", 
+   "fieldtype": "Date", 
+   "hidden": 0, 
+   "ignore_user_permissions": 0, 
+   "ignore_xss_filter": 0, 
+   "in_filter": 0, 
+   "in_global_search": 0, 
+   "in_list_view": 0, 
+   "in_standard_filter": 0, 
+   "label": "Release Date", 
+   "length": 0, 
+   "no_copy": 0, 
+   "permlevel": 0, 
+   "precision": "", 
+   "print_hide": 0, 
+   "print_hide_if_no_value": 0, 
+   "read_only": 0, 
+   "remember_last_selected_value": 0, 
+   "report_hide": 0, 
+   "reqd": 0, 
+   "search_index": 0, 
+   "set_only_once": 0, 
+   "translatable": 0, 
    "unique": 0
   }, 
   {
diff --git a/erpnext/buying/doctype/supplier/supplier.py b/erpnext/buying/doctype/supplier/supplier.py
index 6aa3b019d5..b6d588ed96 100644
--- a/erpnext/buying/doctype/supplier/supplier.py
+++ b/erpnext/buying/doctype/supplier/supplier.py
@@ -10,6 +10,7 @@ from frappe.contacts.address_and_contact import load_address_and_contact, delete
 from erpnext.utilities.transaction_base import TransactionBase
 from erpnext.accounts.party import validate_party_accounts, get_dashboard_info, get_timeline_data # keep this
 
+
 class Supplier(TransactionBase):
 	def get_feed(self):
 		return self.supplier_name
@@ -19,6 +20,13 @@ class Supplier(TransactionBase):
 		load_address_and_contact(self)
 		self.load_dashboard_info()
 
+	def before_save(self):
+		if not self.on_hold:
+			self.hold_type = ''
+			self.release_date = ''
+		elif self.on_hold and not self.hold_type:
+			self.hold_type = 'All'
+
 	def load_dashboard_info(self):
 		info = get_dashboard_info(self.doctype, self.name)
 		self.set_onload('dashboard_info', info)
@@ -35,7 +43,7 @@ class Supplier(TransactionBase):
 			self.naming_series = ''
 
 	def validate(self):
-		#validation for Naming Series mandatory field...
+		# validation for Naming Series mandatory field...
 		if frappe.defaults.get_global_default('supp_master_name') == 'Naming Series':
 			if not self.naming_series:
 				msgprint(_("Series is mandatory"), raise_exception=1)
diff --git a/erpnext/buying/doctype/supplier/supplier_list.js b/erpnext/buying/doctype/supplier/supplier_list.js
index d99e3f8f0f..c776b001a5 100644
--- a/erpnext/buying/doctype/supplier/supplier_list.js
+++ b/erpnext/buying/doctype/supplier/supplier_list.js
@@ -1,3 +1,8 @@
 frappe.listview_settings['Supplier'] = {
-	add_fields: ["supplier_name", "supplier_group", "image"],
+	add_fields: ["supplier_name", "supplier_group", "image", "on_hold"],
+	get_indicator: function(doc) {
+		if(cint(doc.on_hold)) {
+			return [__("On Hold"), "red"];
+		}
+	}
 };
diff --git a/erpnext/controllers/accounts_controller.py b/erpnext/controllers/accounts_controller.py
index d3deb06b5b..4802e02094 100644
--- a/erpnext/controllers/accounts_controller.py
+++ b/erpnext/controllers/accounts_controller.py
@@ -4,7 +4,7 @@
 from __future__ import unicode_literals
 import frappe, erpnext
 from frappe import _, throw
-from frappe.utils import today, flt, cint, fmt_money, formatdate, getdate, add_days, add_months, get_last_day
+from frappe.utils import today, flt, cint, fmt_money, formatdate, getdate, add_days, add_months, get_last_day, nowdate
 from erpnext.setup.utils import get_exchange_rate
 from erpnext.accounts.utils import get_fiscal_years, validate_fiscal_year, get_account_currency
 from erpnext.utilities.transaction_base import TransactionBase
@@ -36,10 +36,29 @@ class AccountsController(TransactionBase):
 			if self.doctype in relevant_docs:
 				self.set_payment_schedule()
 
+	def ensure_supplier_is_not_blocked(self):
+		is_supplier_payment = self.doctype == 'Payment Entry' and self.party_type == 'Supplier'
+		is_buying_invoice = self.doctype in ['Purchase Invoice', 'Purchase Order']
+		supplier = None
+		supplier_name = None
+
+		if is_buying_invoice or is_supplier_payment:
+			supplier_name = self.supplier if is_buying_invoice else self.party
+			supplier = frappe.get_doc('Supplier', supplier_name)
+
+		if supplier and supplier_name and supplier.on_hold:
+			if (is_buying_invoice and supplier.hold_type in ['All', 'Invoices']) or \
+					(is_supplier_payment and supplier.hold_type in ['All', 'Payments']):
+				if not supplier.release_date or getdate(nowdate()) <= supplier.release_date:
+					frappe.msgprint(
+						_('{0} is blocked so this transaction cannot proceed'.format(supplier_name)), raise_exception=1)
+
 	def validate(self):
 		if self.get("_action") and self._action != "update_after_submit":
 			self.set_missing_values(for_validate=True)
 
+		self.ensure_supplier_is_not_blocked()
+
 		self.validate_date_with_fiscal_year()
 
 		if self.meta.get_field("currency"):
@@ -969,3 +988,18 @@ def get_due_date(term, posting_date=None, bill_date=None):
 	elif term.due_date_based_on == "Month(s) after the end of the invoice month":
 		due_date = add_months(get_last_day(date), term.credit_months)
 	return due_date
+
+
+def get_supplier_block_status(party_name):
+	"""
+	Returns a dict containing the values of `on_hold`, `release_date` and `hold_type` of
+	a `Supplier`
+	"""
+	supplier = frappe.get_doc('Supplier', party_name)
+	info = {
+		'on_hold': supplier.on_hold,
+		'release_date': supplier.release_date,
+		'hold_type': supplier.hold_type
+	}
+	return info
+
diff --git a/erpnext/docs/assets/img/accounts/purchase-invoice-hold.png b/erpnext/docs/assets/img/accounts/purchase-invoice-hold.png
new file mode 100644
index 0000000000000000000000000000000000000000..e87f9f58523ad62a9ae20721429bcbb6b68a1181
GIT binary patch
literal 37126
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

literal 0
HcmV?d00001

diff --git a/erpnext/docs/user/manual/en/accounts/purchase-invoice.md b/erpnext/docs/user/manual/en/accounts/purchase-invoice.md
index 8076bd8419..122dfa3ced 100644
--- a/erpnext/docs/user/manual/en/accounts/purchase-invoice.md
+++ b/erpnext/docs/user/manual/en/accounts/purchase-invoice.md
@@ -92,4 +92,42 @@ every transaction.
 
 For more help, please contact your Accountant!
 
+#### Hold Payments For A Purchase Invoice
+There are two ways to put a purchase invoice on hold:
+- Date Span Hold
+- Explicit Hold
+
+##### Explicit Hold
+Explicit hold holds the purchase invoice indefinitely. 
+To do it, in the "Hold Invoice" section of the purchase invoice form, simply 
+check the "Hold Invoice" checkbox. In the "Reason For Putting On Hold" text 
+field, type a comment explaining why the invoice is to be put on hold.
+
+If you need to hold a submitted invoice, click the "Make" drop down button 
+and click "Block Invoice". Also add a comment explaining why the invoice is 
+to be put on hold in the dialog that pops up and click "Save".
+
+##### Date Span Hold
+Date span hold holds the purchase invoice until a 
+specified date. To do it, in the "Hold Invoice" section of the purchase 
+invoice form, check the "Hold Invoice" checkbox. Next, input the release date 
+in the dialog that pops up and click "Save". The release date is the date 
+that the hold on the document expires.
+
+After the invoice has been saved, you can change the release date by clicking 
+on the "Hold Invoice" drop down button and then "Change Release Date". This 
+action will cause a dialog to appear. 
+
+<img class="screenshot" alt="Purchase Invoice on hold" src="{{docs_base_url}}/assets/img/accounts/purchase-invoice-hold.png">
+
+Select the new release date and click "Save". You should also enter a comment 
+in the "Reason For Putting On Hold" field.
+
+Take note of the following:
+- All purchases that have been placed on hold will not included in a Payment Entry's references table
+- The release date cannot be in the past.
+- You can only block or unblock a purchase invoice if it is unpaid.
+- You can only change the release date if the invoice is unpaid.
+ 
+
 {next}
diff --git a/erpnext/docs/user/manual/en/buying/supplier.md b/erpnext/docs/user/manual/en/buying/supplier.md
index baf0fed525..f116c889e0 100644
--- a/erpnext/docs/user/manual/en/buying/supplier.md
+++ b/erpnext/docs/user/manual/en/buying/supplier.md
@@ -38,7 +38,20 @@ If you don't want to customize payable account, and proceed with default payable
 You can add multiple companies in your ERPNext instance, and one Supplier can be used across multiple companies. In this case, you should define Companywise Payable Account for the Supplier in the "Default Payable Accounts" table.
 
 <iframe width="660" height="371" src="https://www.youtube.com/embed/anoGi_RpQ20" frameborder="0" allowfullscreen></iframe>
-
 (Check from 2:20)
 
+### Place Supplier On Hold
+In the Supplier form, check the "Block Supplier" checkbox. Next, choose the "Hold Type".
+
+The hold types are as follows:
+- Invoices: ERPNext will not allow Purchase Invoices or Purchase Orders to be created for the supplier
+- Payments: ERPNext will not allow Payment Entries to be created for the Supplier
+- All: ERPNext will apply both hold types above
+
+After selecting the hold type, you can optionally set a release date in the "Release Date" field.
+
+Take note of the following:
+- If you do not select a hold type, ERPNext will set it to "All"
+- If you do not set a release date, ERPNext will hold the Supplier indefinitely 
+
 {next}