Bestaande integratie — storingen en fouten
Op deze pagina leest u welke informatie vereist is bij het indienen van een 03-EDI-ticket voor een integratie die niet meer werkt of fouten geeft. Volledige informatie vooraf stelt het Boltrics-integratieteam in staat direct te onderzoeken zonder onnodige vertraging.
Note
Deze pagina is van toepassing wanneer een integratie tussen 3PL Dynamics en een extern systeem (zoals SAP, Shopify, Exact of WooCommerce) eerder wel werkte en nu stopt of onverwachte resultaten geeft. Richt u een nieuwe integratie in? Zie dan Nieuwe integratie inrichten — benodigde informatie.
Checklist benodigde informatie
1 — Integratie identificeren
| Veld | Wat aan te leveren |
|---|---|
| Naam extern systeem | Bijv. SAP S/4HANA, Shopify, Exact Globe, WooCommerce |
| Naam van de integratie / interface | De naam die intern of in 3PL Dynamics wordt gebruikt voor deze integratie |
| Protocol | REST API, SOAP, SFTP, EDIFACT, X12, Webhook, etc. |
| Richting | Inkomend, Uitgaand of beide |
| Omgeving | Productie, test of sandbox |
2 — Wat is er veranderd?
Integratiefouten worden vaak veroorzaakt door een wijziging aan één van de kanten. Beantwoord de volgende vragen:
| Vraag | Wat aan te leveren |
|---|---|
| Wanneer is het gestopt? | Ongeveer datum en tijdstip, inclusief tijdzone |
| Is er een 3PL Dynamics-update uitgevoerd? | Zo ja, geef het versienummer op |
| Zijn er instellingen gewijzigd in 3PL Dynamics? | Bijv. endpoints, inloggegevens, mappings, taakwachtrij |
| Heeft de externe partij iets gewijzigd? | Bijv. nieuwe API-versie, wachtwoordrotatie, endpoint-wijziging, firewallupdate |
| Is het berichtvolume of de inhoud veranderd? | Bijv. nieuwe velden, nieuwe berichttypes, grotere berichten |
3 — Foutdetails
| Veld | Wat aan te leveren |
|---|---|
| Foutmelding | De exacte foutmelding, HTTP-statuscode, SFTP-foutcode of EDI-bevestigingscode |
| Waar verschijnt de fout? | In 3PL Dynamics, in het externe systeem of in middleware / een logbestand |
| Tijdstip | Datum en tijdstip van een specifiek mislukt bericht, inclusief tijdzone |
| Bericht- / transactie-ID | Een referentienummer waarmee het specifieke bericht in beide systemen terug te vinden is |
| Frequentie | Treft dit alle berichten, of alleen bepaalde? Onder welke omstandigheden? |
| Scope | Alle bedrijven en omgevingen, of alleen een specifieke? |
4 — Ruw bericht en logbestanden
Voeg zoveel mogelijk van het volgende bij:
- Het ruwe mislukte bericht (verzoek en/of respons voor REST/SOAP; ruw EDI-segment voor EDIFACT/X12; bestandsinhoud voor SFTP)
- Foutlog of trace uit 3PL Dynamics (zie Hoe de call stack ophalen)
- Foutlog of respons van het externe systeem of de middleware
- Schermafbeelding van de fout zoals die in de gebruikersinterface verschijnt
Tip
Anonimiseer persoons- of bedrijfsgevoelige gegevens voordat u bijlagen toevoegt. Het ruwe bericht is het meest waardevolle stuk informatie voor het diagnosticeren van integratiefouten.
5 — Vergelijking met een werkend bericht
Als er nog berichten succesvol worden verwerkt, geef dan een vergelijking:
| Veld | Wat aan te leveren |
|---|---|
| Voorbeeld van een succesvol bericht | Voeg een bericht bij dat wel correct verwerkt wordt, of beschrijf het |
| Verschil met het mislukte bericht | Wat is er anders tussen het succesvolle en het mislukte bericht? |
| Laatste bekende werkdatum | De meest recente datum waarop de integratie correct werkte |
6 — Technisch contactpersoon bij de partner
Geef de contactgegevens van de technische contactpersoon bij de externe partij, voor het geval directe afstemming nodig is.
| Veld | Wat aan te leveren |
|---|---|
| Naam | Volledige naam van de technische contactpersoon |
| Direct e-mailadres | |
| Telefoon | Telefoonnummer (optioneel) |
Ticket indienen
Zodra u alle bovenstaande informatie heeft verzameld, gaat u naar Support- of changeticket aanmaken en selecteert u categorie 03-EDI. Voeg alle relevante bestanden toe in Stap 4 — Bijlagen toevoegen.