# \_setStatus

Set the Status for an Invoice.

### Parameters

#### id

The ID of the Invoice on which the status will be changed.

#### val

The status to be set for the Invoice.\
Draft => -1\
Quoted => 0\
Invoiced => 1\
Paid => 2\
Cancelled => 3\
Credit Note => 4

### Example

```
FM_api('Invoice_setStatus',[
  'id'=>'697934',
  'val'=>'3'
  ]
);
```

### Result

#### On Success

"id" value in below result will match given "id" parameter value.

```
{"ok":1,"id":697934}
```

#### On Failure

If the "id" parameter is less than 1 or not given a value:

```
{"error":"missing or invalid parameter: id"}
```

If the "id" parameter does not match an existing invoice:

```
{"error":"no such invoice"}
```