Add a T&C appraisal note (p_id null) or change one.
Add a T&C appraisal note (p_id null) or change one. Every heading and every item is sent, as the note stands; see tnc_appraisal_notes for what each heading is. Needs finance.tnc_appraisal_note.edit.
p_items is a list of objects, each with specification, quantity, gross_amount and gst_amount, and item_no for an item the note already holds (see tnc_appraisal_note_items). An item sent with its item_no is that item, changed; one sent without is added and numbered after the note’s others; one the note holds that is not sent is taken off. Each item is complete or the save is refused with INVALID_NOTE, whose detail.item is its place in the list: an Item/Specification of 1 to 500 characters, a whole quantity from 1 up to 99,999, and a gross value and a GST each more than zero and up to 99,999,999.99, kept to two decimal places.
Any argument may be left out, and is then saved as nothing; an item list left out takes every item off. Nothing a note must hold before it is sent is asked here, save its unit: a note is written over as long as its writer needs, and submit_tnc_appraisal_note and every level’s approval refuse it while something is missing (needs in the answer lists the columns, as note_needs does). Refused with INVALID_NOTE for no p_site_id, a p_location_id that is not in that unit, p_item_type other than MIS or NON_MIS, and p_manager_name, p_emp_code or p_grade longer than 100, 10 and 100 characters; with NOT_FOUND for a category not on your Category Master list or a manager location not on your Manager Location list, and for a unit or location you cannot reach. An empty value is stored as nothing.
What your organisation sets on this form in the Form Studio applies too: a heading whose writing it keeps to some roles is refused with FIELD_NOT_PERMITTED to anybody without one of them who changes it.
While the note is with its approvers, only the approver it is waiting on may change it, and they need not hold finance.tnc_appraisal_note.edit; what they change on the header is recorded against their step. Refused with NOTE_DECIDED once the note is approved or rejected, and NOTE_WITH_APPROVERS while it is with approvers to anybody it is not waiting on. Returns the note’s id and its T&C/No. as tc_no.
Headers
Preference
params=single-object Body
Add a T&C appraisal note (p_id null) or change one. Every heading and every item is sent, as the note stands; see tnc_appraisal_notes for what each heading is. Needs finance.tnc_appraisal_note.edit.
p_items is a list of objects, each with specification, quantity, gross_amount and gst_amount, and item_no for an item the note already holds (see tnc_appraisal_note_items). An item sent with its item_no is that item, changed; one sent without is added and numbered after the note's others; one the note holds that is not sent is taken off. Each item is complete or the save is refused with INVALID_NOTE, whose detail.item is its place in the list: an Item/Specification of 1 to 500 characters, a whole quantity from 1 up to 99,999, and a gross value and a GST each more than zero and up to 99,999,999.99, kept to two decimal places.
Any argument may be left out, and is then saved as nothing; an item list left out takes every item off. Nothing a note must hold before it is sent is asked here, save its unit: a note is written over as long as its writer needs, and submit_tnc_appraisal_note and every level's approval refuse it while something is missing (needs in the answer lists the columns, as note_needs does). Refused with INVALID_NOTE for no p_site_id, a p_location_id that is not in that unit, p_item_type other than MIS or NON_MIS, and p_manager_name, p_emp_code or p_grade longer than 100, 10 and 100 characters; with NOT_FOUND for a category not on your Category Master list or a manager location not on your Manager Location list, and for a unit or location you cannot reach. An empty value is stored as nothing.
What your organisation sets on this form in the Form Studio applies too: a heading whose writing it keeps to some roles is refused with FIELD_NOT_PERMITTED to anybody without one of them who changes it.
While the note is with its approvers, only the approver it is waiting on may change it, and they need not hold finance.tnc_appraisal_note.edit; what they change on the header is recorded against their step. Refused with NOTE_DECIDED once the note is approved or rejected, and NOTE_WITH_APPROVERS while it is with approvers to anybody it is not waiting on. Returns the note's id and its T&C/No. as tc_no.
Response
OK