Overview over changes made to the Handyman API and Common API related to Handyman Office versions.
Detailed documentation is at:
| Common API | api.gsgroup.io |
| Handyman API |
Example: Dependent of Handyman API configuration in the Handyman ControlCenter |
Versjon 9.6.5
Nye funksjoner
Autorisasjon per sluttpunkt
Det er nå mulig å begrense tilgangen for hver endepunkt når du bruker tokenbasert autorisasjon. Dette vil vanligvis være av interesse når du trenger å gi partnere/leverandører tilgang til Handyman via API-tilgang i et spesielt integrasjonsscenario. Vennligst kontakt GSGroup for mer informasjon om hvordan du bruker denne funksjonen.
Støtte for både intern og ekstern adresse for HM-API URL
Avhengig av infrastrukturen kan det være nødvendig å ha to URL-er konfigurert hvis serverrapporter i Handyman Mobile ikke kan nås med gjeldende API-URL. Konfigurasjonen gjøres i Handyman ControlCenter. Vennligst kontakt GSGroup hvis dette er et problem.
ServiceBusSender
Handyman Office og Sync støtter å sende meldinger til Azure Service Bus for å signalisere hvilke ordre eller andre enheter som skal eksporteres fra Handyman. Dette brukes i API-baserte integrasjoner for å ha en meldingsbasert integrasjonsflyt. Mer dokumentasjon vil komme senere.
New APIs
| Endpoint | Purpose | Comment |
| weboffice/quotes |
|
|
| messagelogs | Insert messages to Handymans message log. |
Useful for logging exceptions from integrations so that it will be easier to troubleshoot. Also to be used for logging normal events related to import/export of data. See here for instructions on how to use |
Endringer i eksisterende API-er
| Endpoint | Change | Comment |
| all order endpoints with dates | DateTimeBehaviour paramteter is added to support writing and reading dates as UTC value |
Possible values:
|
|
SyncStatus field added |
0 = not sent to ERP For material and salary codes registrations, quantity should be <> 0 before sending to ERP.
When record is updated, it is automatically set to 2
See here for description of minimum records for updated SyncStatus. |
| orders | DoNotSetAsPassive is now handled as in the XML API. |
Set to "true" to avoid finished orders to på historical until ERP has completed the order. |
|
orders/salarycodes |
Removed requirement for mandatory fields
|
|
|
orders/material |
Removed requirement for mandatory fields
|
|
|
orders |
ExternaID will now not be overwritten if empty or not provided |
|
|
orders/document |
Metadata can now be changed without providing the document binary data |
|
|
orders |
Message field for orders is now supporting configuration per contract and concatenating with manual text:
|
|
|
Swagger-oppdatering - prefikset "parameter." er fjernet fra komplekse parameterobjekter |
||
|
|
Improved error feedback if post/get requests fail |
Versjon 9.6.4
Viktige rettelser
| Endpoint | Fix | Comment |
| orders |
Stedet oppretter ny adresse hver gang. BackofficeID eller HsID hadde ingen effekt. |
|
| settings |
Logo was not returned as image/binary |
Versjon 9.6.3
Viktige rettelser
| Endpoint | Fix | Comment |
| orders |
InvoiceStatus was not updated |
|
| orders | EstimatedHours was mandatory field | Requirement removed |
| orders/material | locking rules was not correct | |
| orders | Location validation rules is too strict | Bare vanlig API. Brukte samme regler som for kundeadresser. Nå mindre streng. |