JSON API » invoices » invoices/update

Updates an existing invoice.

Input parameters

Requires authentication and the commerce role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
idIntegerID of invoice to update.Yes
statusStringStatus. "approved", "cancelled", "due", "overdue", "paid", "payment_refused", "pending", "prepaid", "queued", or "superceded".NoCurrent value.

Responses

CodeDescription
204Success.
400Invalid input parameters specified. Check the key and message fields for more details.
401The authentication details provided are invalid.
402Your role does not allow this.
404The invoice does not exist, or you do not have permission to view it.

Data returned

No data is returned.

Example: Changing the status

http://enswitch.example.com/api/json/invoices/update/?auth_username=user;auth_password=password;id=123;status=paid

{ "responses":[ { "code":"204", "key":"", "message":"OK" } ] }

Change history

VersionChanges
3.13Function added.