De API-activiteit van een order bekijken

In dit artikel leggen we uit hoe je de API-activiteit van een order bekijkt. Dit tabblad laat de technische koppelingscalls zien die bij een order horen, zoals de communicatie met Picqer en met je leveranciers. Je gebruikt het om te achterhalen waarom een order wel of niet goed is doorgekomen, bijvoorbeeld als een order niet in Picqer verschijnt of een bijbestelling bij een leverancier misging. Het is een hulpmiddel voor foutopsporing, geen scherm waarin je iets wijzigt.

Wanneer gebruik je dit tabblad

Meestal verloopt het verwerken van een order ongemerkt goed. Gaat er iets niet zoals verwacht, dan geeft dit tabblad je het volledige verhaal: welke calls zijn er gedaan, in welke volgorde, en wat er precies is verstuurd en teruggekomen. Zo zie je of de order wel naar Picqer is gegaan, of een leverancier een fout teruggaf, of dat een stap helemaal niet is uitgevoerd.

Het tabblad openen

De API-activiteit vind je als tabblad in het detailscherm van een order, naast Algemeen en Historie. Het tabblad is alleen zichtbaar als je daar de juiste rechten voor hebt. Zie je het niet, dan is het voor jouw account niet beschikbaar.

1. Open de order vanuit het bestellingen-overzicht.
2. Klik bovenin op het tabblad API-activiteit.

Hoe je de tijdlijn leest

De activiteit staat als tijdlijn, van oud naar nieuw. Elke regel is één call. Van links naar rechts zie je:

• de richting: in (binnenkomend, bijvoorbeeld de import of het verwerkverzoek) of uit (uitgaand, naar een gekoppeld systeem);
• het systeem: een herkenbare naam zoals Picqer, een leverancier of de bezorgkoppeling;
• de methode en het endpoint van de call;
• de status: OK of Fout, met daarbij de responscode;
• de tijd en de duur in milliseconden.

Regels met een fout worden gemarkeerd, zodat je in één oogopslag ziet waar het misging.

Een regel openklappen voor de details

Klik op een regel om 'm uit te klappen. Je ziet dan de volledige URL, de verzonden Request en de ontvangen Response. Als de inhoud geldige JSON is, wordt die netjes ingesprongen weergegeven, zodat je makkelijk kunt teruglezen wat er precies is uitgewisseld. Zo herleid je bij een fout waar het aan lag, bijvoorbeeld een ontbrekend gegeven of een melding van het andere systeem.

Tip: begin bij een storing bij de eerste foutregel in de tijdlijn. Die wijst meestal naar de stap waar het misliep; de regels daarna zijn vaak een gevolg daarvan.

Veelvoorkomende systemen in de tijdlijn

Afhankelijk van je koppelingen kom je verschillende systemen tegen. Vaak zie je een binnenkomende regel voor de import of het verwerken van de order, gevolgd door uitgaande calls naar Picqer en naar leveranciers. Werk je met een bezorgkoppeling, dan zie je ook stappen zoals het aanmaken of opzoeken van een bezorgopdracht. De namen zijn vertaald naar wat er gebeurde, zodat je ze zonder technische kennis kunt plaatsen.

Let op: zie je de melding dat er nog geen API-activiteit is? Dan zijn er voor deze order (nog) geen koppelingscalls vastgelegd, bijvoorbeeld omdat de order nog niet is verwerkt.

Waarvoor je dit niet gebruikt

Dit tabblad is bedoeld om mee te kijken en te onderzoeken, niet om iets aan te passen. Je kunt er geen call opnieuw starten of een order repareren. Een order opnieuw doorzetten doe je via de knop Verwerken op het tabblad Algemeen; de inhoud van de order pas je daar ook aan. Gebruik de API-activiteit om eerst te begrijpen wat er gebeurde, en los het daarna op de juiste plek op.

Samenvatting

In dit artikel heb je gezien hoe je de API-activiteit van een order bekijkt: het tabblad openen, de tijdlijn met in- en uitgaande calls lezen, een regel openklappen voor de verzonden en ontvangen inhoud, en de foutregels herkennen. Gebruik dit om storingen te onderzoeken en los ze daarna op via 'Een order verwerken' of door de order aan te passen volgens 'Een bestelling bekijken en bewerken'.