Versions Compared

Old Version 10

changes.mady.by.user Ritchie Piessens

Saved on

compared with

New Version 11

changes.mady.by.user Ritchie Piessens

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Dutch

(#6372) Door middel van de Wholesale365 API Collection wordt het eenvoudig om andere SaaS applicaties te integreren met Business Central. Bijvoorbeeld voor de integratie met een webshop, vervoerders of fullfilment partners.

De API Collection bestaat uit rijke JSON API’s voor onder andere het ophalen (“GET”) van data uit BC. Niet alleen stamgegevens als klanten, artikelen en leveranciers maar bijvoorbeeld ook prijslijsten en verkooporders. Ook is het mogelijk om bestaande BC data bij te werken (“PATCH”), zoals klanten en contacten. en om nieuwe data in te voeren (“POST”). Denk bijvoorbeeld aan het “inschieten” van verkooporders.

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#4C9AFF

Onderdeel van de Wholesale365 App “Integration”

Activeren en Configureren

Activeer deze functie via de pagina [Wholesale 365 Setup]. Meer informatie: Wholesale365 Setup - Order To Cash

Gedrag met deze functie geactiveerd

  1. De API Collection is beschikbaar en kan gebruikt worden.

Stappen

In dit artikel worden de volgende stappen beschreven om je op weg te helpen met het gebruiken van de API Collection:

  1. https://briteblue.atlassian.net/wiki/spaces/WS/pages/edit-v2/46530628#Voorbereiding

  2. https://briteblue.atlassian.net/wiki/spaces/WS/pages/edit-v2/46530628#Beschrijving-beschikbare-API%E2%80%99s

  3. https://briteblue.atlassian.net/wiki/spaces/WS/pages/edit-v2/46530628#Aandachtspunten

  4. https://briteblue.atlassian.net/wiki/spaces/WS/pages/edit-v2/46530628#Testen-van-API%E2%80%99s-met-behulp-van-Voorbereiding

  5. Beschrijving beschikbare API’s

  6. Aandachtspunten

  7. Testen van API’s met behulp van Postman

Voorbereiding

  1. Creëer een App registratie op https://portal.azure.com

  2. Voeg een Microsoft Entra-toepassing toe in Business Central

Info

Kijk voor een stap-voor-stap handleiding voor het creëren van een App registratie, het toevoegen van een Entra-toepassing én het testen hiervan op Integrate Dynamics 365 Business Central using OAuth 2.0

  1. Voeg minimaal de volgende Gebruikersmachtigingensets toe aan de Microsoft Entra-toepassingskaart:

    1. BBS_LICMNGUSERPERM

    2. BBS_PROPACKPERMUSER

    3. BBS_WHOLESALE_USER

image-20240801-140948.png
Gebruikersmachtigingensets toevoegen aan de Microsoft Entra-toepassingskaart

  1. Volgende stap is het aanmaken van Gebruikersinstellingen voor de Microsoft Entra-toepassing:

    1. Open de pagina Gebruikersinstellingen.

    2. Voeg een nieuwe rij toe voor de Entra-gebruiker. Type hierbij de naam van de Entra-gebruiker handmatig in (BC laat je standaard niet zoeken in de lijst met Entra-gebruikers).

    3. Kies eventueel een “Boeken toegest. vanaf” en “Boeken toegest. tot” datum, wanneer het niet wenselijk is om de API buiten die datum te laten boeken.

    4. Koppel de Gebruikers-ID aan een “Verkoper/Inkoper”. Hierdoor is het makkelijker te herkennen binnen BC wat de door de API-gebruiker aangemaakte / gewijzigde documenten zijn.

image-20240801-141905.png
Gebruikersinstellingen voor de Entra-gebruiker

Beschrijving beschikbare API’s

Info

Patch requests: Gebruik No in de URL

If-Match toevoegen bij Patch

patch doen met welk veld? (welke key-fields)

expand mogelijk op

API

Get

Post

Update (Patch)

Expand

SalesOrders

(Verkooporders)

Ja

Ja, optioneel met noSeries (anders default noSeries)

Ja,

Optioneel, met customSalesOrderLines

Aandachtspunten

GetPriceListLines: nieuwe prijservaring (link)

Testen van API’s met behulp van Postman