---
title: "API: Hoe krijg ik ID's"
description: API hoe krijg ik ID ID's
---

[Overslaan naar inhoud](https://cash.nl/knowledge/api-hoe-krijg-ik-ids#main-content)

Nederlands

Submenu tonen voor vertalingen

![Cash-logo-secondary-256h](https://cash.nl/hs-fs/hubfs/social-suggested-images/Cash-logo-secondary-256h.png?width=180&height=82&name=Cash-logo-secondary-256h.png)

- [Login](https://www.cashweb.nl/)
- [Support](https://cash.nl/nl/contact)
- [Contact](https://cash.nl/nl/contact)

Hoofdnavigatie openen

Hoofdnavigatie sluiten

- [Login](https://www.cashweb.nl/)
- [Support](https://cash.nl/nl/contact)
- [Contact](https://cash.nl/nl/contact)
- Nederlands
  
  Submenu tonen voor vertalingen
- [Meer over Cash](https://cash.nl/)

[Meer over Cash](https://cash.nl/?hsLang=nl)

 Welkom! Hoe kunnen we je helpen?

- Er zijn geen suggesties want het zoekveld is leeg.

1. [CASHWeb en CASHWin](https://cash.nl/knowledge?hsLang=nl)
2. [Cash Payroll](https://cash.nl/knowledge/cash-payroll?hsLang=nl)

# API: Hoe krijg ik ID's

## Een ID is een uniek nummer dat niet direct zichtbaar is in de gebruikersinterface. ID's worden veelvuldig gebruikt binnen de API-service.

In dit artikel komen de volgende onderwerpen aan bod:

1. Nummers en ID's
2. Een werknemer-ID ophalen
3. Een bedrijf-ID ophalen
4. Een debiteur-ID ophalen

#### 1. Zijn het nummer en het ID van een werknemer/bedrijf/debiteur hetzelfde?

**Nee**, het nummer is een numeriek veld dat door gebruikers kan worden aangepast. Daarom mag dit veld niet worden gebruikt als uniek kenmerk om werknemers en bedrijven te identificeren. Het **ID** is wel uniek en moet worden gebruikt om werknemers, bedrijven en debiteuren te identificeren.

#### 2. Een werknemer-ID ophalen (Retrieving an Employee ID)

Werknemer-ID's zijn niet zichtbaar in de gebruikersinterface. Deze kunnen worden opgehaald door de API-methode [List\_GetByCompany](https://api.nmbrs.nl/soap/v3/EmployeeService.asmx?op=List_GetByCompany)of [List\_GetByDebto](https://api.nmbrs.nl/soap/v3/EmployeeService.asmx?op=List_GetByDebtor)r aan te roepen. Deze methoden retourneren een lijst met werknemersgegevens, inclusief de werknemer-ID's.

- [List\_GetByCompany](https://api.nmbrs.nl/soap/v3/EmployeeService.asmx?op=List_GetByCompany) retourneert alle werknemers die bij een specifiek bedrijf horen.
- [ListGetByDebtor](https://api.nmbrs.nl/soap/v3/EmployeeService.asmx?op=List_GetByDebtor) retourneert alle werknemers die bij een specifieke debiteur horen.

Voor deze aanroepen moet je de gebruikersnaam, de token en het CompanyId opgeven.

In het veld \<active\> zijn drie opties mogelijk: **active** (actief), **notActive** (niet actief) of **all** (alle). Actieve werknemers zijn werknemers met een actief dienstverband in de huidige periode van een bedrijf. Werknemers die 'notActive' zijn, zijn uit dienst of treden pas in de toekomst (ten opzichte van de huidige periode van het bedrijf) in dienst.

Als de aanroep succesvol is, ontvang je het ID, het nummer en de weergavenaam (display name) van de werknemer.

#### 3. Een bedrijf-ID ophalen (Retrieving a company ID)

Bedrijf-ID's zijn niet zichtbaar in de gebruikersinterface. Deze kunnen worden opgehaald door de API-methode [List\_GetAll](https://api.nmbrs.nl/soap/v3/CompanyService.asmx?op=List_GetAll) of  [List\_GetByDebtor](https://api.nmbrs.nl/soap/v3/CompanyService.asmx?op=List_GetByDebtor).  aan te roepen. Deze methoden retourneren een lijst met bedrijfsgegevens, inclusief de bedrijf-ID's.

- [List\_GetAll](https://api.nmbrs.nl/soap/v3/CompanyService.asmx?op=List_GetAll) retourneert alle bedrijven (waar jij toegang toe hebt). Je hoeft hierbij alleen je gebruikersnaam en een token mee te sturen. Als de test slaagt, ontvang je het \<ID\>, wat het CompanyId is. Je ontvangt ook overige informatie; zie hiervoor de [API description](https://api.nmbrs.nl/soap/v3/CompanyService.asmx?op=List_GetAll) van de respons.
- [List\_GetByDebtor](https://api.nmbrs.nl/soap/v3/CompanyService.asmx?op=List_GetByDebtor) retourneert bedrijven die onder een specifieke debiteur vallen. Om deze aanroep succesvol uit te voeren, moet je een debiteur-ID opgeven.

#### 4. Een debiteur-ID ophalen (Retrieving a debtor ID)

Dezelfde aanpak kan worden gebruikt om debiteur-ID's op te halen (op basis van nummer of allemaal). Gebruik hiervoor de methode [List\_GetAll](https://api.nmbrs.nl/soap/v3/CompanyService.asmx?op=List_GetAll) of [List\_GetByNumber](https://api.nmbrs.nl/soap/v3/DebtorService.asmx?op=List_GetByNumber). 

- [List\_GetAll](https://api.nmbrs.nl/soap/v3/DebtorService.asmx?op=List_GetAll) retourneert alle debiteuren (waar jij toegang toe hebt). Je hoeft alleen je gebruikersnaam en een token op te geven. Als de test slaagt, ontvang je het  \<ID\>, wat het [API description](https://api.nmbrs.nl/soap/v3/DebtorService.asmx?op=List_GetAll) is. Je ontvangt ook overige informatie; zie hiervoor de API-beschrijving van de respons.

- [Algemeen en Beheer](https://cash.nl/knowledge/algemeen-en-beheer?hsLang=nl#main-content)

    - [Bank(koppeling)](https://cash.nl/knowledge/algemeen-en-beheer?hsLang=nl#bankkoppeling)
    - [Import/Export](https://cash.nl/knowledge/algemeen-en-beheer?hsLang=nl#import-export)
    - [Postbus](https://cash.nl/knowledge/algemeen-en-beheer?hsLang=nl#postbus)
    - [Training & Consultancy](https://cash.nl/knowledge/algemeen-en-beheer?hsLang=nl#training-consultancy)
    - [Overig](https://cash.nl/knowledge/algemeen-en-beheer?hsLang=nl#overig)
- [Cash Financieel](https://cash.nl/knowledge/cash-financieel?hsLang=nl#main-content)

    - [Boekhoud](https://cash.nl/knowledge/cash-financieel?hsLang=nl#boekhoud)
    - [Fiscaal](https://cash.nl/knowledge/cash-financieel?hsLang=nl#fiscaal)
    - [Overig](https://cash.nl/knowledge/cash-financieel?hsLang=nl#overig)
- [CashWeb](https://cash.nl/knowledge/cashweb?hsLang=nl#main-content)

    - [CashHero Layout](https://cash.nl/knowledge/cashweb?hsLang=nl#cashhero-layout)
    - [Mailen vanuit CASHWeb](https://cash.nl/knowledge/cashweb?hsLang=nl#mailen-vanuit-cashweb)
    - [Algemeen gebruik](https://cash.nl/knowledge/cashweb?hsLang=nl#algemeen-gebruik)
- [API / Koppeling](https://cash.nl/knowledge/api-koppeling?hsLang=nl#main-content)

    - [Algemeen](https://cash.nl/knowledge/api-koppeling?hsLang=nl#algemeen)
    - [Api 3.0 (SOAP API)](https://cash.nl/knowledge/api-koppeling?hsLang=nl#api-3-0-soap-api)
    - [API 4.0 (REST API)](https://cash.nl/knowledge/api-koppeling?hsLang=nl#api-4-0-rest-api)
- [CashWeb app](https://cash.nl/knowledge/cashweb-app?hsLang=nl#main-content)

    - [Veel gestelde vragen](https://cash.nl/knowledge/cashweb-app?hsLang=nl#veel-gestelde-vragen)
- [Cash Facturatie](https://cash.nl/knowledge/cash-facturatie?hsLang=nl#main-content)

    - [Factureren](https://cash.nl/knowledge/cash-facturatie?hsLang=nl#factureren)
    - [Instellingen](https://cash.nl/knowledge/cash-facturatie?hsLang=nl#instellingen)
    - [Algemeen](https://cash.nl/knowledge/cash-facturatie?hsLang=nl#algemeen)
    - [Formulierlayout](https://cash.nl/knowledge/cash-facturatie?hsLang=nl#formulierlayout)
- [Cash Handel](https://cash.nl/knowledge/cash-handel?hsLang=nl#main-content)

    - [Inkoop](https://cash.nl/knowledge/cash-handel?hsLang=nl#inkoop)
    - [Verkoop](https://cash.nl/knowledge/cash-handel?hsLang=nl#verkoop)
    - [Voorraad](https://cash.nl/knowledge/cash-handel?hsLang=nl#voorraad)
    - [Overig](https://cash.nl/knowledge/cash-handel?hsLang=nl#overig)
    - [VoorraadService & Onderhoud](https://cash.nl/knowledge/cash-handel?hsLang=nl#voorraadservice-onderhoud)
- [Cash Leden](https://cash.nl/knowledge/cash-leden?hsLang=nl)
- [Cash Lonen](https://cash.nl/knowledge/cash-lonen?hsLang=nl#main-content)

    - [Algemeen](https://cash.nl/knowledge/cash-lonen?hsLang=nl#algemeen)
    - [Inrichting](https://cash.nl/knowledge/cash-lonen?hsLang=nl#inrichting)
    - [Jaarafsluiting](https://cash.nl/knowledge/cash-lonen?hsLang=nl#jaarafsluiting)
    - [Salarisberekening](https://cash.nl/knowledge/cash-lonen?hsLang=nl#salarisberekening)
    - [Overig](https://cash.nl/knowledge/cash-lonen?hsLang=nl#overig)
    - [FAQ – Beëindiging CASH Lonen en overstap naar Cash Payroll](https://cash.nl/knowledge/cash-lonen?hsLang=nl#faq-be%C3%ABindiging-cash-lonen-en-overstap-naar-cash-payroll)
    - [Loonaangifte](https://cash.nl/knowledge/cash-lonen?hsLang=nl#loonaangifte)
- [Cash Payroll](https://cash.nl/knowledge/cash-payroll?hsLang=nl#main-content)

    - [Aangifte](https://cash.nl/knowledge/cash-payroll?hsLang=nl#aangifte)
    - [Algemeen](https://cash.nl/knowledge/cash-payroll?hsLang=nl#algemeen)
    - [Basis Training](https://cash.nl/knowledge/cash-payroll?hsLang=nl#basis-training)
    - [Berekening](https://cash.nl/knowledge/cash-payroll?hsLang=nl#berekening)
    - [FAQ](https://cash.nl/knowledge/cash-payroll?hsLang=nl#faq)
    - [Gebruikersaccount](https://cash.nl/knowledge/cash-payroll?hsLang=nl#gebruikersaccount)
    - [Grootboekrekening & Journaalpost](https://cash.nl/knowledge/cash-payroll?hsLang=nl#grootboekrekening-journaalpost)
    - [HR](https://cash.nl/knowledge/cash-payroll?hsLang=nl#hr)
    - [Import / Export](https://cash.nl/knowledge/cash-payroll?hsLang=nl#import-export)
    - [Inrichting](https://cash.nl/knowledge/cash-payroll?hsLang=nl#inrichting)
    - [Instellingen](https://cash.nl/knowledge/cash-payroll?hsLang=nl#instellingen)
    - [Jaarafsluiting](https://cash.nl/knowledge/cash-payroll?hsLang=nl#jaarafsluiting)
    - [My Cash Payroll account](https://cash.nl/knowledge/cash-payroll?hsLang=nl#my-cash-payroll-account)
    - [Overzichten](https://cash.nl/knowledge/cash-payroll?hsLang=nl#overzichten)
    - [Pensioenen (inrichting, export, etc.)](https://cash.nl/knowledge/cash-payroll?hsLang=nl#pensioenen-inrichting-export-etc)
    - [Regelingen](https://cash.nl/knowledge/cash-payroll?hsLang=nl#regelingen)
    - [Templates](https://cash.nl/knowledge/cash-payroll?hsLang=nl#templates)
    - [Uurcode](https://cash.nl/knowledge/cash-payroll?hsLang=nl#uurcode)
    - [Verzuim](https://cash.nl/knowledge/cash-payroll?hsLang=nl#verzuim)
    - [Workflow](https://cash.nl/knowledge/cash-payroll?hsLang=nl#workflow)
    - [Loonaangifte](https://cash.nl/knowledge/cash-payroll?hsLang=nl#loonaangifte)
    - [Verlof](https://cash.nl/knowledge/cash-payroll?hsLang=nl#verlof)
    - [Technisch voor ontwikkelaars](https://cash.nl/knowledge/cash-payroll?hsLang=nl#technisch-voor-ontwikkelaars)
    - [Run](https://cash.nl/knowledge/cash-payroll?hsLang=nl#run)
- [Cash Projecten](https://cash.nl/knowledge/cash-projecten?hsLang=nl)
- [CashWin](https://cash.nl/knowledge/cashwin?hsLang=nl#main-content)

    - [Overig](https://cash.nl/knowledge/cashwin?hsLang=nl#overig)
- [Mijn CASH Factuur](https://cash.nl/knowledge/mijn-cash-factuur?hsLang=nl#main-content)

    - [Facturatie Loonportal( CASH Lonen)](https://cash.nl/knowledge/mijn-cash-factuur?hsLang=nl#facturatie-loonportal-cash-lonen)
    - [Mijn CASH factuur](https://cash.nl/knowledge/mijn-cash-factuur?hsLang=nl#mijn-cash-factuur)
    - [Verbruik en Tarieven](https://cash.nl/knowledge/mijn-cash-factuur?hsLang=nl#verbruik-en-tarieven)
    - [Verbruikspagina](https://cash.nl/knowledge/mijn-cash-factuur?hsLang=nl#verbruikspagina)
- [Versie updates](https://cash.nl/knowledge/versie-updates?hsLang=nl#main-content)

    - [CashWeb updates 2025](https://cash.nl/knowledge/versie-updates?hsLang=nl#cashweb-updates-2025)
    - [CashWeb updates 2024](https://cash.nl/knowledge/versie-updates?hsLang=nl#cashweb-updates-2024)
    - [CashWeb updates 2023](https://cash.nl/knowledge/versie-updates?hsLang=nl#cashweb-updates-2023)
- [Microloon](https://cash.nl/knowledge/microloon?hsLang=nl)

[![Cash-logo-secondary-256h](https://cash.nl/hs-fs/hubfs/social-suggested-images/Cash-logo-secondary-256h.png?width=180&height=82&name=Cash-logo-secondary-256h.png "Cash-logo-secondary-256h")](https://www.cash.nl?hsLang=nl)

Cash kenniscentrum

Copyright ©2025 Cash