Page Comparison

...

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 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

panelIconId	atlassian-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

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:

Voorbereiding

Creëer een App registratie op https://portal.azure.com
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

Voeg minimaal de volgende Gebruikersmachtigingensets toe aan de Microsoft Entra-toepassingskaart:
1. BBS_LICMNGUSERPERM
2. BBS_PROPACKPERMUSER
3. BBS_WHOLESALE_USER


Gebruikersmachtigingensets toevoegen aan de Microsoft Entra-toepassingskaart

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.


Gebruikersinstellingen voor de Entra-gebruiker

Beschrijving beschikbare API’s

Info
Get-requests ondersteunen oData filter expressies op vrijwel alle velden die geretourneerd worden door een Get-request. Kijk voor meer informatie over het gebruik van oData filter expressies op https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/use-filter-expressions-in-odata-uris

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 (page 11295762) Verkooporders	Ja	Ja, optioneel met attribuut noSeries (anders default noSeries). Ook mogelijk in Batch, incl. optionele Expand	Ja, alleen voor header. Voorzie de URL van het volgende key-field: “No”	Optioneel, met customSalesOrderLines
SalesOrderLines (page 11295763) Verkoopregels	Ja	Nee	Ja, voorzie de URL van de volgende key-fields: “Document No.", "Document Type", "Line No."	Nee
ReturnOrders (page 11295764) Verkoopretourorders	Ja	Ja, optioneel met attribuut noSeries (anders default noSeries)	Ja, alleen voor header. Voorzie de URL van het volgende key-field: “No”	Optioneel, met customReturnOrderLines
ReturnOrderLines (page 11295765) Verkoopretourorderregels	Ja	Nee	Ja, voorzie de URL van de volgende key-fields: “Document No.", "Document Type", "Line No."	Nee
Customers (page 11295766) Klanten	Ja	Optioneel, met customSalesOrderLines

Aandachtspunten

GetPriceListLines: nieuwe prijservaring (link)

Ja, optioneel met Expand. Ook mogelijk in Batch, incl. optionele Expand	Ja, voorzie de URL van het volgende key-field: “No”	Optioneel, met ShipToAddresses, Contacts, CustomerGroupPrices
ShipToAddresses (page 11295767) Verzendadressen	Ja	Ja	Ja, voorzie de URL van de volgende key-fields: “CustomerNo”, “Code”	Nee
Items (page 11295768) Artikelen	Ja	Ja	Ja, voorzie de URL van het volgende key-field: “No”	Nee
StockItem (page 11295769) Voorraad Artikelen	Ja	Nee	Nee	Nee
PriceListLine (o.b.v. nieuwe verkoopprijservaring) (page 11295770) Verkoopprijslijstregels	Ja	Nee	Nee	Optioneel, met CustomerPrices, CustomerGroupPrices
CustomerCreditLimit (page 11295771) Klant kredietlimieten	Ja	Nee	Nee	Nee
VatBusinessPostingGroups (page 11295772) Btw-bedrijfsboekingsgroepen	Ja	Nee	Nee	Nee
VatProdPostingGroups (page 11295773) Btw-productboekingsgroepen	Ja	Nee	Nee	Nee
VatPostSetup (page 11295774) Btw-boekingsinstellingen	Ja	Nee	Nee	Nee







Inkooporders			Ja, indien Status = Open

Aandachtspunten

Info

Updates (“PATCH-requests”) verlangen het meegeven van 1 of meerdere key-fields in de URL, zodat BC het juiste record kan vinden om te updaten. Kijk voor voorbeelden in het Postman project;
Verkoopprijslijstregels zijn gebaseerd op de tabellen die gebruikt worden door BC’s “Nieuwe verkoopprijservaring” Meer informatie op https://learn.microsoft.com/en-us/dynamics365-release-plan/2020wave2/smb/dynamics365-business-central/use-new-sales-pricing-experience-

Versions Compared

Old Version 11

New Version 12

Key

Activeren en Configureren

Gedrag met deze functie geactiveerd

Stappen

Voorbereiding

Gebruikersmachtigingensets toevoegen aan de Microsoft Entra-toepassingskaart

Gebruikersinstellingen voor de Entra-gebruiker

Beschrijving beschikbare API’s

Aandachtspunten

Aandachtspunten

Testen van API’s met behulp van Postman