Updates McMain Open API

Tegelijk met de nieuwe LTS-update van McMain Online wijzigt er ook een aantal zaken rondom de Open API. In dit artikel vind je een compleet overzicht.

Algemene veranderingen

Elk datumveld geeft de datum nu terug in het format yyyy-MM-dd
Errors worden bij elk endpoint vanaf nu in het volgende format teruggegeven:

     {
         "error_no": "19110",
         "id": "PAYLOAD VALUE",
         "message": "Work order with that ID is not present in the database.",
         "msg_no": "",
         "title": "No-Data Reply Group Error"
     }

Een aantal endpoints controleert nu extra of bepaalde configuratieopties aan staan, en geven bepaalde velden alleen mee wanneer deze optie aan staat.

Endpoint	Controleerd op:
Asset/GetDetails	Optie EQ022 bij het veld typeDetails (en onderliggende)
Employee/GetDetails	Optie WO016 bij het veld crewId Optie CR032 bij het veld qualifications
Employee/GetList	Optie WO016 bij het veld crewId
WorkOrder/GetDetails	Optie CR032 bij het veld qualificationsList Optie WO016 bij het veld crewId Optie WO103 bij het veld employeeList Optie EQ005 bij het veld department (en onderliggende)
WorkOrder/GetList	Optie WO016 bij het veld crewId Optie WO103 bij het veld employeeList Optie EQ005 bij het veld departmentId
WorkOrder/Update	Optie WO016 bij het veld crewId Optie WO103 bij het veld employeeList
WorkOrder/Create	Optie WO016 bij het veld crewId Optie WO103 bij het veld employeeList

Overige updates

Endpoint	Verandering
Asset/GetDetails	Van het veld price is de width aangepast naar van 7.2 naar 14.2
Asset/GetList	Van het veld date is de naam veranderd naar installationDate Dit veld wordt ook installationDate in andere endpoints genoemd Van het veld installationDate (Eerst date) is het format veranderd naar yyyy-MM-dd Dit was eerst dd-MM-yyyy
BaseData/GetHourTypes	Endpoint is verwijderd Het endpoint HourType/GetList kan hiervoor in de plaats gebruikt worden
BaseData/GetStores	Endpoint is verwijderd Het endpoint Store/GetList kan hiervoor in de plaats gebruikt worden
Employee/GetList	Het veld crewId wordt nu gevuld met het ID van de desbetreffende vakgroep Dit was eerst de beschrijving van de vakgroep Nieuw veld crewName Dit wordt gevuld met de beschrijving van de vakgroep Nieuwe filter: crCrew Hiermee kan op de ID van vakgroep worden gefilterd
HourType/GetList	Nieuw veld type Wordt gevuld met het type van de uursoort Uursoorten in de status ‘Verwijderd’ (8xxx) worden niet meer meegestuurd met dit endpoint.
PreventiveMaintenance/GetList	Van het veld lastCompletedDate is het format veranderd naar yyyy-MM-dd Dit was eerst dd-MM-yyyy Van het veld nextPlannedDate is het format veranderd naar yyyy-MM-dd Dit was eerst dd-MM-yyyy
PreventiveMaintenance/GetDetails	Bij het veld source van de velden documents en images wordt nu een ander bericht teruggegeven. Hier stonden eerst icoontjes bij, deze zijn nu weg. Voorbeeld: “speaker_notes\|Geüpload op onderhoudsmodel” wordt nu “Geüpload op onderhoudsmodel”
Store/GetList	Nieuw veld status Wordt gevuld met de status van het magazijn
Store/GetDetails	Nieuw veld status Wordt gevuld met de status van het magazijn

Heb je vragen over deze updates, of de Open API van McMain in het algemeen?

Neem dat contact op met onze supportafdeling via support@mcmain.nl of +31 341 750 500.