Uw ERP kent uw oogsten, ontvangsten en zendingen al. Als u het koppelt, hoeft niemand ze twee keer in te typen. Alles staat in Instellingen › Integraties, in vijf tabbladen: Webhooks, Inkomend, Machineclients, IP-adressen en Identiteit van credentials (de identiteit waarmee uw productpaspoorten worden ondertekend, zie Identiteit van credentials). Eigenaren en beheerders richten de koppelingen van productiebedrijven in; in een sandbox kunnen ook operators ze inrichten.
Wat uit een ander systeem binnenkomt, doet nooit zelf iets: het wordt een gebeurtenis, een concept of een goedkeuring, en een persoon moet het goedkeuren.
Kies de juiste manier
| U wilt… | Gebruik |
|---|---|
| dat uw ERP goederenontvangsten, leveringen of labresultaten naar A-REX stuurt | Inkomend |
| dat A-REX uw ERP laat weten wanneer een partij is geregistreerd, geleverd of gecertificeerd | Webhooks |
| dat uw systeem zelf de A-REX-API aanroept | Machineclients |
| een spreadsheet met gegevens inladen | bestandsimport (hieronder) |
Berichten van uw ERP ontvangen
- Selecteer in Inkomend de optie Inkomend eindpunt toevoegen.
- Afzender: geef een naam (bijvoorbeeld "ERP-goederenontvangsten") en kies Hoe de afzender ondertekent.
- Toegang en limieten: beperk eventueel de Toegestane afzenderadressen en stel de berichtgrootte en het tempo in.
- Voorbeeldbericht: plak een typisch bericht. De velden daarvan worden het verwachte formaat.
- Selecteer Aanmaken en bevestig met een code uit uw authenticator-app. Kopieer het Adres en het geheim naar uw ERP: het geheim wordt maar één keer getoond.
Berichten die niet bij de verwachte velden passen, komen In quarantaine. Open er een en kies Opnieuw controleren nadat de velden zijn hersteld, of Verwerpen.
Gebeurtenissen naar uw ERP sturen (webhooks)
- Selecteer in Webhooks de optie Eindpunt toevoegen.
- Bestemming: een naam, de https-URL van uw systeem en het Formaat (CloudEvents (aanbevolen) of Gewone JSON). Vink Automatiseringen mogen naar dit eindpunt sturen aan als stappen van automatiseringen ernaar moeten versturen.
- Gebeurtenissen: Begin met een sjabloon (Alles over partijen, Alleen problemen, Goedkeuringen, Partijregels en uitbreidingen, Wijzigingen in het register, Rapporten), of kies gebeurtenissen per groep. Zo laten Levering wacht en Levering mislukt uw ERP weten wanneer een goedgekeurde levering wordt opgehouden of niet kan doorgaan.
- Controleren, dan Aanmaken. Kopieer het ondertekeningsgeheim. A-REX stuurt een verificatieverzoek, en het eindpunt wordt Actief zodra uw systeem daarop antwoordt.
Een eindpunt ontvangt de gebeurtenissen van zijn eigen bedrijf: echte gebeurtenissen in een productiebedrijf, oefengebeurtenissen in een sandbox. Berichten bevatten codes en links, geen namen. Elk eindpunt toont zijn Leveringen met elke poging; mislukte pogingen worden opnieuw geprobeerd, en Ontbrekende herstellen / opnieuw versturen stuurt opnieuw wat uw systeem heeft gemist. Sta de adressen uit IP-adressen toe in uw firewall.
Controleren dat een bericht van A-REX komt
Elk webhookbericht is ondertekend met het geheim van het eindpunt, dat begint met whsec_. Uw systeem
moet die handtekening controleren voordat het een bericht vertrouwt. Open het eindpunt in
Webhooks: het paneel Handtekeningen controleren geeft
kant-en-klare code in TypeScript, Python, Java en C# die uw IT-team kan kopiëren. Tijdens Geheim
roteren zijn zowel het vorige als het nieuwe geheim geldig gedurende de overlap die u kiest; geef
dus beide door aan de controle.
Machineclients
Selecteer in Machineclients de optie
Client aanmaken, kies de Toegang (Lezen, Voorstellen) en de Aanmeldmethode:
Privésleutel (aanbevolen) of Clientgeheim. Geen enkele toegang kan goedkeuren: wat een
systeem voorstelt, wacht op een persoon. Clientgeheimen en API-sleutels zeggen bij welk soort bedrijf
ze horen: ze beginnen met arex_cs_prod_ of arex_cs_sandbox_, en arex_sk_prod_ of
arex_sk_sandbox_, zodat een oefensleutel nooit voor een productiesleutel wordt aangezien. Eerder
gemaakte sleutels blijven werken.
Beschrijvingen van de API en de gebeurtenissen
Voor uw IT-team beschrijft A-REX zijn API in OpenAPI 3.1 en elke webhookgebeurtenis in AsyncAPI 3.0. Beide worden uit het platform zelf gegenereerd, dus ze komen overeen met wat het accepteert en verstuurt. Uw ontwikkelaars kunnen de actuele bestanden opvragen via Support, en daarna koppelen met een machineclient.
Uw eigen codes
Relaties, locaties en producten kunnen de eigen code van uw bedrijf dragen, de code die ze in uw ERP hebben. Uw integratie kan dan een producent, landbouwbedrijf of product opzoeken met uw code, en berichten kunnen die code bevatten, zodat uw ERP de codes van A-REX nooit hoeft te kennen.
Bestandsimport
Bestandsimport (CSV) van oogstontvangsten, leveringen, labresultaten en registervermeldingen wordt toegevoegd aan Integraties. Elke rij wordt eerst gecontroleerd en de fouten worden getoond; daarna ontstaan er openstaande goedkeuringen, nooit directe wijzigingen.
Oefenen in een sandbox
Probeer alles uit voordat uw productiebedrijf het gebruikt:
- Maak vanuit uw organisatie een sandbox: Nieuw bedrijf › Een sandbox. Het is een oefenbedrijf met fictieve gegevens, en de eindpunten ervan ontvangen de eigen gebeurtenissen: keur een oefenoogst goed en zie het echte bericht binnenkomen. Operators kunnen daar eindpunten toevoegen; in een productiebedrijf zijn voor eindpunten een eigenaar of beheerder en hun tweede factor nodig.
- Selecteer op een eindpunt Voorbeeldgebeurtenis versturen om een ondertekend voorbeeld te sturen, gemarkeerd als voorbeeld, en het exacte verzoek en antwoord te zien.
- Een testuitvoering van een automatisering simuleert alleen de berichten: er komt niets bij uw live systemen aan. Zie Automatiseringen.