Integraties: STOSAG

Contents

    STOSAG is een open standaard voor uitwisseling voor gegevens rond afvalinzameling. In OMS4Business kan voor verzamelcontainers een koppeling worden opgezet voor verwerken van registratiegegevens en systeeminformatie (STOSAG 3a), en versturen van een autorisatielijst (STOSAG 3b). Voor inzamelvoertuigen kunnen registratiegegevens worden ontvangen (STOSAG 4a) en een autorisatielijst worden verstuurd (STOSAG 4b). Uitgebreidere informatie over STOSAG is onder de functionele beschrijving te vinden.

    Onder Instellingen → Integraties → STOSAG worden de instellingen beheerd die van toepassing zijn op STOSAG koppelingen. Deze integratie is alleen beschikbaar als de module ” STOSAG koppeling” actief is.

    Stosag koppeling toevoegen

    1. voeg de koppeling toe met de “Voeg toe” button, en vul de naam voor de koppeling in. Sla de wijzigingen op
    2. ga naar de koppeling en vul de overige informatie toe. Ook de velden “Gebruikersnaam” en ” Wachtwoord” zijn nu beschikbaar.

    STOSAG 3a

    • Url (bovenin het STOSAG 3a blok: https://pr02.oms4business.com/api/etc…) Endpoint voor STOSAG koppeling
    • Gebruikersnaam: wordt automatisch gegenereerd
    • Wachtwoord: wordt automatisch gegenereerd
    • Naam: naam voor de koppeling
    • Actief: als de 3a-koppeling Actief staat worden de gegevens die worden ontvangen op de API verwerkt door OMS. Zo niet, dan worden gegevens wel ontvangen maar niet verwerkt
    • Koppel prijslijst aan order indien beschikbaar: Als er een prijslijst is dan wordt deze gebruikt voor de orders die via STOSAG worden aangemaakt
    • Maak order aan op basis van inhoud: order wordt aangemaakt op basis van volume.

    STOSAG 3b

    • Naam: naam van de koppeling
    • Url: url van het endpoint, wordt aangeleverd door leverancier
    • Gebruikersnaam: wordt aangeleverd door leverancier
    • Wachtwoord: wordt aangeleverd door leverancier
    • Leverancier ID: het vaste ID van de leverancier
    • Optie:
      • Whitelist: de autorisatielijst bestaat uit alle actieve tags die aan een adres zijn gekoppeld en toegang hebben tot de container
      • Blacklist: de autorisatielijst bestaat uit alle geblokkeerde tagnummers
    • Selectie: selecteer hier alle containers die een whitelist krijgen
    • Actief: als de koppeling actief staat wordt de whitelist naar de leverancier verstuurd
    • Download bestand: geeft een bestand met de autorisatielijst voor alle containers
    • Direct versturen: er wordt direct een autorisatielijst verstuurd voor alle containers die volgens de instellingen een lijst moeten krijgen

    STOSAG 4a

    • Url (bovenin het STOSAG 4a blok: https://pr02.oms4business.com/api/etc…) Endpoint voor STOSAG koppeling
    • Gebruikersnaam: wordt automatisch gegenereerd
    • Wachtwoord: wordt automatisch gegenereerd
    • Naam: naam voor de koppeling
    • Actief: als de 4a-koppeling Actief staat worden de gegevens die worden ontvangen op de API verwerkt door OMS. Zo niet, dan worden gegevens wel ontvangen maar niet verwerkt
    • Voeg transacties samen op enkele order: Als binnen een vastgestelde tijd meerdere transacties voor een container worden ontvangen, dan worden deze samengevoegd tot een enkele order
    • Maximaal aantal seconden tussen transacties voor samenvoegen: aantal seconden waarbinnen transacties worden samengevoegd
    • Koppel prijslijst aan order indien beschikbaar: Als er een prijslijst is dan wordt deze gebruikt voor de orders die via STOSAG worden aangemaakt
    • Maak order aan op basis van inhoud: order wordt aangemaakt op basis van het gewicht

    STOSAG 4b

    • Naam: naam voor de koppeling
    • Url: url van het endpoint, wordt aangeleverd door leverancier
    • Gebruikersnaam: wordt aangeleverd door de leverancier
    • Wachtwoord: wordt aangeleverd door de leverancier
    • Optie:
      • Blacklist: de autorisatielijst bestaat uit alle geblokkeerde tagnummers
      • Whitelist: de autorisatielijst bestaat uit alle tags die actief zijn en aan een adres gekoppeld zijn
    • Actief: als de koppeling actief staat dan wordt er een autorisatielijst verstuurd
    • Download bestand: geeft een bestand met de autorisatielijst voor alle containers
    • Direct versturen: er wordt direct een autorisatielijst verstuurd