MIXIT kan informatie over mengverbruik in realtime verzenden naar een extern Information Management System (IMS) voor specifieke shops die zowel klant zijn van MIXIT als van het IMS. De informatie wordt verzonden met behulp van de API voor mengverbruik die door het IMS is gedefinieerd en geïmplementeerd volgens onze API-specificatie.
Hoe de API voor mengverbruik werkt
De integratie werkt door de API voor mengverbruik aan jouw kant te creëren volgens deze OpenAPI-specificatie. Wanneer er verbruik van een mengsel plaatsvindt op een weegschaal die met MIXIT is verbonden, verzendt MIXIT in realtime een verbruiksmelding naar jouw IMS via de API voor mengverbruik, met alle verbruikte verfcomponenten en de verbruikte hoeveelheid daarvan. Ook worden gegevens verzonden over de gebruikte mengruimte en weegschaal, gekoppelde reparatieorders en het mengselnummer. Deze informatie wordt opgesplitst in twee typen meldingen: initiële en gedeeltelijke.
- Initiële meldingen van mengverbruik bevatten het eerste geregistreerde verbruik van een mengsel. Ze bevatten de volgende informatie:
- Id van het mengsel (identificatie binnen MIXIT)
- Beschrijving van het mengsel
- Datum van het mengsel
- Mengselnummer
- Gebruiker die het mengsel heeft gemengd
- Id van de shop (identificatie binnen MIXIT)
- Informatie over de reparatieorder
- Id van de weegschaal
- Informatie over de mengruimte
- Status van het mengsel
- Gedeeltelijke meldingen van mengverbruik bevatten alleen de gewijzigde verfcomponenten en de hoeveelheden daarvan sinds de vorige melding is verzonden. Deze melding bevat ook de reparatieorders en de informatie over de mengruimte; alle andere informatie die in een initiële melding staat, wordt weggelaten.
Als een schadeherstelbedrijf bijvoorbeeld een mengsel start en halverwege pauzeert, wordt er een initiële melding van mengverbruik verzonden. Deze bevat alle componenten die zijn verbruikt tot het moment waarop het mengen werd gepauzeerd.
Wanneer de gebruiker het mengen hervat, wordt er een gedeeltelijke melding verzonden met alleen de verfcomponenten die sinds de vorige melding zijn gegoten.
Raadpleeg voor meer informatie over de payload van deze meldingen de documentatie hier.
Stappen voor integratie
-
Goedkeuring verkrijgen: Je hebt goedkeuring nodig van je AkzoNobel-accountmanager.
- Een API maken: Je moet de API voor mengverbruik definiëren en implementeren volgens deze OpenAPI-specificatie.
- Je API instellen in MIXIT: We hebben de URI van je API voor mengverbruik nodig, evenals de API-sleutel die nodig is om de verzoeken te autoriseren.
- Integratietests: Zodra alles is ingesteld, kunnen we beginnen met de integratietests met een testshop in onze productieomgeving.
- Gebruik in productie: Nu alles is ingesteld en correct werkt, kunnen we de schadeherstelbedrijven aansluiten om MIXIT en jouw IMS te gebruiken. Het AkzoNobel-supportteam schakelt voor elke shop de verbinding tussen MIXIT en jouw IMS in.