Een ID is een uniek nummer dat niet direct zichtbaar is in de gebruikersinterface en komt ook niet naar voren wanneer een je export doet via import/export. IDs worden veel gebruikt in de API-service die Nmbrs biedt.

1. Nummers en IDs
2. Een medewerker-ID ophalen
3. Een bedrijfs-ID ophalen
4. Een debiteur-ID ophalen

1. Zijn medewerker/bedrijf/debiteur Nummer en ID hetzelfde?

Nee, het nummer is een numeriek veld dat door gebruikers kan worden aangepast en daarom niet als uniek veld moet worden gebruikt om medewerkers en bedrijven te identificeren. Het ID is uniek en moet worden gebruikt om medewerkers, bedrijven en debiteuren te identificeren bij gebruik van koppelingen via de API. 

2. Een medewerker-ID ophalen

De medewerker-IDs zijn niet zichtbaar in de gebruikersinterface(per medewerker is die nog te zien in de URL, maar niet in overzichten en dergelijken). Deze kunnen worden opgehaald door de API-methode List_GetByCompany of List_GetByDebtor aan te roepen. Deze methoden retourneren een lijst met medewerkergegevens, inclusief medewerker-IDs. List_GetByCompany retourneert alle medewerkers die bij een bedrijf horen. List_GetByDebtor retourneert alle medewerkers die bij een debiteur horen. U moet uw gebruikersnaam, token en CompanyId invoeren.

In het veld <active> zijn er drie opties: active, notActive of all. Actieve medewerkers zijn medewerkers die een actief dienstverband hebben in de huidige periode van een bedrijf. Medewerkers die niet actief zijn, zijn uit dienst of zullen in de toekomst in dienst treden in vergelijking met de huidige periode van het bedrijf.

Als het verzoek succesvol is, krijgt u de Id, het nummer en de weergavenaam van de medewerker.

Wil je het voor 1 of een paar medewerkers weten? Dan kan je naar het medewerkersniveau van die medewerkers. Wanneer je op medewerkersniveau bent, staat de medewerker-ID in de URL, zoek naar 'medewerkerID='. 

3. Een bedrijfs-ID ophalen

De bedrijfs-IDs zijn niet zichtbaar in de gebruikersinterface. Deze kunnen worden opgehaald door de API-methode List_GetAll of List_GetByDebtor aan te roepen. Deze methoden retourneren een lijst met bedrijfsgegevens, inclusief bedrijfs-IDs.

List_GetAll retourneert alle bedrijven (waartoe u toegang heeft). U hoeft alleen uw gebruikersnaam en een token in te voeren. Als de test succesvol is, krijgt u <ID> wat CompanyId is. U krijgt ook andere informatie, zie de API-beschrijving van de response.

List_GetByDebtor retourneert bedrijven die bij een debiteur horen. Om deze aanroep succesvol uit te voeren, moet u een debiteur-ID invoeren.

4. Een debiteur-ID ophalen

Dezelfde aanpak kan worden gebruikt om debiteur-IDs op te halen per nummer of allemaal. Gebruik methode List_GetAll of List_GetByNumber.

List_GetAll retourneert alle debiteuren (waartoe u toegang heeft). U hoeft alleen uw gebruikersnaam en een token in te voeren. Als de test succesvol is, krijgt u <ID> wat DebtorId is. U krijgt ook andere informatie, zie de API-beschrijving van de response.

Heb je nog vragen over deze vertaling of wil je bepaalde termen anders vertaald hebben?