About Deny
This API is used to deny a Bill or Vendor Credit from being paid or applied. Only users that have approver permissions and are assigned to approve a Bill or Vendor Credit can call this API. The comment
field describes the approver's reason for rejection.
Once an approval request is denied, it immediately stops the approval process. The normal approval process for the respective Bill or Vendor Credit is stopped until the reason for denial is resolved.
The next action is to use ClearApprovers to disconnect all approvers from the Bill or Vendor Credit. Then call SetApprovers to restore the approval process. For more information, see Approve Payments.
Note: A user with permission to pay unapproved Bills can directly pay the Bill, regardless of the Bill's Approval Status.
Example
Request
<API_URL_EndPoint>/Deny.json
data={
"objectId" : "00n01TUPMWVLJHJUR1mg",
"entity" : "Bill",
"comment" : "This bill is for $80.00, not $8000.00!"
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : { }
}
Resources
Parameters
Field Name | Description | Required? |
---|---|---|
objectId | The system generated ID of the Bill or Vendor Credit that is being denied. | Yes |
entity |
Define the type of the entity. If the |
Yes |
comment | Description or note that the approver adds when denying the Bill or Vendor Credit. | No |