AWW Automation API

Base URL

All endpoints require HTTPS or trusted network access according to the deployment environment.

Developer Console

Use the console to request a token, inspect the outbound request, and review the response payload.

GET /AutomationTest.html

Authentication

Request a bearer token using the automation token endpoint.

POST /automation/token
Content-Type: application/x-www-form-urlencoded

grant_type=password
username=YOUR_USERNAME
password=YOUR_PASSWORD

Use the returned token on API calls:

Authorization: Bearer ACCESS_TOKEN

Endpoints

Method	Path	Description
GET	`/AWW_Automation_WS.asmx/About`	Returns service, assembly, and database version metadata.
GET	`/AWW_Automation_WS.asmx/KeepAlive`	Validates authentication and returns the current server date/time.
GET	`/AWW_Automation_WS.asmx/Tickets`	Returns filtered Dolibarr tickets using the standard response envelope.

Tickets

Query Parameters

Name	Default	Description
`Page`	`0`	Dolibarr page number. Pagination starts at zero.
`Limit`	`100`	Page size. Accepted range is 1 through 500.
`DateField`	`datec`	One of `datec`, `date_creation`, `date_modification`, or `date_close`.
`DateFrom`		Inclusive lower date/time bound. Use `YYYY-MM-DD`, `YYYY-MM-DD HH:MM`, `YYYY-MM-DD HH:MM:SS`, `YYYY-MM-DDTHH:MM`, or `YYYY-MM-DDTHH:MM:SS`.
`DateTo`		Inclusive upper date/time bound. Use `YYYY-MM-DD`, `YYYY-MM-DD HH:MM`, `YYYY-MM-DD HH:MM:SS`, `YYYY-MM-DDTHH:MM`, or `YYYY-MM-DDTHH:MM:SS`.
`TypeLabel`		Optional case-insensitive contains filter for returned `type_label`.
`CategoryLabel`		Optional case-insensitive contains filter for returned `category_label`.
`Ref`		Optional contains filter for ticket reference.
`Status`		Optional exact numeric ticket status filter.
`IncludeEvents`	`false`	Set to `true` to include the Dolibarr agenda/history events for each returned ticket. This adds one Dolibarr API call per ticket. Event notes have email addresses and USA-style phone numbers replaced with a blank space.
`EventsLimit`	`25`	Maximum events returned per ticket when `IncludeEvents=true`. Accepted range is 1 through 100.
`SortField`		Dolibarr field, for example `t.datec`.
`SortOrder`		`ASC` or `DESC`.

Response Fields

track_id
message
status
progress
category_code
options_serial
options_rma
type_label
category_label
datec
date_close
ref
date_modification
date_creation
events

Example

GET /AWW_Automation_WS.asmx/Tickets?Page=0&Limit=50&DateField=datec&DateFrom=2026-06-01T00:00:00&DateTo=2026-06-03T23:59:59&TypeLabel=Monitor&CategoryLabel=Service&Ref=TS2002&Status=2&IncludeEvents=true&EventsLimit=25&SortField=t.datec&SortOrder=DESC
Authorization: Bearer ACCESS_TOKEN

Response Envelope

{
  "Status": "Success",
  "StatusCode": 0,
  "ErrorSource": "",
  "ErrorMessage": "",
  "Results": {}
}

Date values returned from Dolibarr may be Unix timestamps. Client applications should format them for display as needed.