_setForm

Sets a chosen Form to an Invoice.

Parameters

id

The ID of the Invoice being modified

val

The ID of the Form to be set to the Invoice

Example

FM_api('Invoice_setForm',[
  'id'=>'697934',
  'val'=>'460477'
  ]
);

Result

On Success

Normal result

{"ok":1}

If the Invoice was already assigned to the chosen Form:

{"ok":1,"warning":"no change needed"}

On Failure

If either the "id" or "val" parameters are not set:

{"error":"id and val parameters are both required"}

If the value of the "id" parameter does not match an existing Invoice:

{"error":"invoice does not exist"}

If the value of the "val" parameter does not match an existing Form:

{"error":"form does not exist"}

If the Invoice being modifed has its Status set as Paid:

{"error":"cannot edit invoices that are marked Paid"}

If the Form being set to the Invoice an "Invoice Table" type:

{"error":"wrong form type"}