SAM API

Kort gezegd biedt de API op dit moment de volgende functies:

• Artikelgroepen ophalen, toevoegen, bewerken en verwijderen.
• Artikelen ophalen, toevoegen, wijzigen of verwijderen.
• Artikelprijzen voor relatie ophalen.
• Artikelleveranciers ophalen, toevoegen, bewerken en verwijderen.
• Batchnummers ophalen.
• Totale en beschikbare voorraad ophalen.
• Relaties en contactpersonen ophalen, toevoegen, bewerken en verwijderen.
• Projecten en projectprijzen ophalen.
• Projectdocumenten aanmaken.
• Servicedesk e-mails versturen.
• Projectstatussen ophalen.
• Weborders inschieten.
• Transportkosten ophalen, rekening houdend met de ingestelde uitzonderingen.
• Prijsberekening voor weborder ophalen.
• Facturen ophalen.
• Vestigingen ophalen.

De volledige specificaties vind je terug door naar https://[jouwsubdomein].samrental.nl/api/ te gaan. Heb je nog geen SAM omgeving? Dan kun je hier vrijblijvend een demo aanvragen. 

Externe koppelingen die gegevens ophalen, toevoegen of wijzigen in jouw SAM-omgeving doen dat met een API gebruiker. Dat kan een webshop zijn, een inhuurleverancier of een andere externe applicatie. Deze gebruikers en hun rechten kun je zelf in SAM beheren.

1. Ga in SAM naar Instellingen > Externe koppelingen > Tabblad 'API-gebruikers'
2. Klik rechts bovenin op 'API-gebruiker toevoegen'
3. Geef de gebruiker een naam. Om de koppeling goed te laten werken, mag de naam alleen bestaan uit letters, cijfers en underscores.
4. Geef de gebruiker de benodigde rechten. Maak je een gebruiker aan voor een inhuurlevernacier, geef deze dan minimaal rechten voor het plaatsen van weborders.

5. Klik op 'Opslaan'. Er wordt op dat moment automatisch een Client secret voor je gegenereerd, die nodig is om van de koppelinge gebruik te kunnen maken.
6. Geef vervolgens aan je API gebruiker de volgende gegevens door:
   • De URL van jouw SAM-omgeving
   • Client ID
   • Client secret

Met de gegevens van je API gebruiker kun je ook in de documentatie autoriseren en de API uitproberen. Zo weet je precies op welke manier gegevens ingeschoten moeten worden en hoe je gegevens terugkrijgt uit SAM.

Voor de ontwikkelaar:
Om met je OAuth gegevens verbinding te maken met de SAM API stuur je een POST request naar https://<subdomein>.samrental.nl/api/webshop/v1/token met data grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>.

Vervolgens krijg je een access_token terug, met een datum tot wanneer die geldig is. Die twee velden moeten worden opgeslagen in het systeem van de webshop.

Bij de API calls voeg je vervolgens de volgende HTTP Header toe:
Authorization: Bearer <access_token>