AFAS_HrOnboarding_field_mapping

	A	B	C	D	E	F	G	H	I	J	K	L	M
1	AFAS Object / Section	AFAS Code	AFAS Field Name (NL)	Description (EN)	AFAS Type	Required	Required when	Data Source	TT Custom Field – API Name	TT Custom Field – Type	Allowed / Expected values	Default value	Notes

2	Control / routing	afasAction	—	Selects which AFAS action runs.	enum	Yes	Always	Control flag (config – activation setup)		select (config field)	onboarding = 'Create onboarding'	—	Config field 'afasAction'. The 'Create onboarding' option only shows when the AFAS env has the 'TeamtailorProfitProfiles' GetConnector. Not sent to AFAS.
3	AfasPerson › Fields	AutoNum	Autonummering	Auto-number the person.	boolean*	No	Always	Hardcoded (adapter)		—	true	true	Hardcoded; this is why BcCo (Nummer) is not sent.
4	AfasPerson › Fields	MatchPer	Persoon matchen op	Person matching method.	string	No	Always	Hardcoded (adapter)		—	7	'7'	Hardcoded.
5	AfasPerson › Fields	SpNm	Geboortenaam apart vastleggen	Record birth name separately.	boolean	No	Always	Hardcoded (adapter)		—	true	true	Hardcoded.
6	AfasPerson › Fields	PrId	Profiel	Onboarding profile (Volgnummer).	integer*	Yes	Always	Config – activation setup		select (config field)	Profile picked from the AFAS list	—	Config field 'onboardingProfile' (required).
7	AfasPerson › Fields	FiNm	Voornaam	First name.	string (max 50)	Yes	Always	Candidate – standard field		—	Free text	—	Teamtailor 'First name'.
8	AfasPerson › Fields	In	Voorletters	Initials.	string (max 15)	No	—	Candidate – custom field	initials	Text	Free text	—
9	AfasPerson › Fields	Is	Voorvoegsel	Name prefix / tussenvoegsel.	string (max 15)	No	—	Candidate – custom field	prefix	Text	Free text	—
10	AfasPerson › Fields	LaNm	Achternaam	Last name.	string (max 80)	Yes	Always	Candidate – standard field		—	Free text	—	Teamtailor 'Last name'.
11	AfasPerson › Fields	NmBi	Geboortenaam	Birth surname.	string (max 80)	No	—	Candidate – custom field	birth-surname	Text	Free text	Falls back to Last name	If empty, Last name is used.
12	AfasPerson › Fields	EmA2	E-mail privé	Private e-mail.	email	Yes	Always	Candidate – standard field		—	Valid e-mail	—	Teamtailor 'Email'.
13	AfasPerson › Fields	EmAd	E-mail werk	Work e-mail.	email	No	—	Candidate – custom field	work-email	Text	Valid e-mail	—	If 'User email type' = Business, this MUST be filled — it is the business e-mail AFAS uses for the created user and digital documents.
14	AfasPerson › Fields	EmailPortal	E-mail toegang	Portal access e-mail.	string (max 255)	No	Only when 'Add to portal' is on	Candidate – custom field	email-portal	Text	Valid e-mail	Falls back to private e-mail	Only sent when AddToPortal = true.
15	AfasPerson › Fields	AddToPortal	Toegang afgeschermd portal	Give portal access.	boolean*	No	—	Config – activation setup		checkbox (config field)	true / false	false	Config field 'addToPortal'. When on, EmailPortal is sent (custom field or fallback private e-mail).
16	AfasPerson › Fields	ViGe	Geslacht	Gender.	enum	No	—	Candidate – custom field	gender	Select (value = AFAS code)	M = Man · O = Onbekend · V = Vrouw · X = Non-binair	—	Value must be the AFAS code.
17	AfasPerson › Fields	DaBi	Geboortedatum	Date of birth.	date	No	—	Candidate – custom field	birthdate	Date	YYYY-MM-DD	—
18	AfasPerson › Fields	MbN2	Mobiel privé	Private mobile.	string	No	—	Candidate – standard field		—	Phone number	—	Teamtailor 'Phone'.
19	AfasPerson › Fields	PsNa	Nationaliteit	Nationality.	enum	No	—	Candidate – custom field	nationality	Select (value = AFAS code)	AFAS nationality code (full list in AFAS), e.g. NL=Nederlandse, B=Belgische, D=Duitse, PL=Poolse, 000=Onbekend	—	~190 codes; value must be the AFAS code.
20	AfasPerson › Fields	CoBi	Geboorteland	Country of birth.	string (max 3)	No	—	Candidate – custom field	country-of-birth	Text	AFAS country code e.g. NL	—
21	AfasPerson › Fields	RsBi	Geboorteplaats	Place of birth.	string (max 50)	No	—	Candidate – custom field	birthplace	Text	Free text	—
22	AfasPerson › Fields	SoSe	BSN-nummer	BSN.	string (max 25)	No	—	Candidate – custom field	bsn	Text	BSN number	—
23	AfasPerson › Fields	ViCs	Burgerlijke staat	Marital status.	enum	No	—	Candidate – custom field	marital-status	Select (EXACT option values)	Sustainable separation → DZ · Married → GH · Registered partnership → GP · Divorced → GS · Unmaried → OG · Other → OV · Widow-widower → WE	—	Adapter translates the English label → AFAS code. Use these EXACT option values (note 'Unmaried').
24	AfasPerson › Fields	CoLw	Land wetgeving	Country of legislation.	string (max 2)	No	—	Candidate – custom field	country-of-legislation	Text	Country code e.g. NL	—
25	AfasPerson › Fields	ViUs	Naamgebruik	Name usage.	enum	No	Always	Hardcoded (adapter)		—	0 = Geboortenaam · 1 = Geb.naam partner + Geboortenaam · 2 = Geboortenaam partner · 3 = Geboortenaam + Geb.naam partner	'0'	Hardcoded '0'.
26	AfasPerson › Fields	PadAdr	Postadres is adres	Postal address equals address.	boolean*	No	—	Candidate – custom field	postal-is-address	Checkbox / Boolean	true / false	—	AFAS marks it mandatory (*) but the connector accepts its absence; only sent if filled.
27	AfasPerson › Fields	SeNm	Zoeknaam	Search name.	string (max 10)	No	—	Candidate – custom field	search-name	Text	Free text	—
28	AfasPerson › Fields	CaNm	Roepnaam	Nickname.	string (max 80)	No	—	Candidate – custom field	nickname	Text	Free text	—
29	AfasPerson › Fields	IsBi	Voorv. geb.naam	Birth-name prefix.	string (max 15)	No	—	Candidate – custom field	birth-name-prefix	Text	Free text	—
30	AfasPerson › Fields	IsPa	Voorvoegsel partner	Partner name prefix.	string (max 15)	No	—	Candidate – custom field	partner-name-prefix	Text	Free text	—
31	AfasPerson › Fields	NmPa	Geb.naam partner	Partner birth name.	string (max 80)	No	—	Candidate – custom field	partner-birth-name	Text	Free text	—
32	AfasPerson › Fields	DaMa	Huwelijksdatum	Marriage date.	date	No	—	Candidate – custom field	marriage-date	Date	YYYY-MM-DD	—
33	AfasPerson › Fields	DaDi	Datum scheiding	Divorce date.	date	No	—	Candidate – custom field	divorce-date	Date	YYYY-MM-DD	—
34	AfasPerson › Fields	DaDe	Overlijdensdatum	Date of death.	date	No	—	Candidate – custom field	date-of-death	Date	YYYY-MM-DD	—
35	AfasPerson › Fields	TtId	Titel/aanhef	Title / salutation.	string (max 3)	No	—	Candidate – custom field	title	Text	AFAS title code	—
36	AfasPerson › Fields	TtEx	Tweede titel	Second title.	string (max 3)	No	—	Candidate – custom field	second-title	Text	AFAS title code	—
37	AfasPerson › Fields	LeHe	Briefaanhef	Letter salutation.	string (max 255)	No	—	Candidate – custom field	letter-salutation	Text	Free text	—
38	AfasPerson › Fields	TeNr	Telefoonnr. werk	Work phone.	string	No	—	Candidate – custom field	phone-work	Text	Phone number	—
39	AfasPerson › Fields	TeN2	Telefoonnr. privé	Private phone.	string	No	—	Candidate – custom field	phone-private	Text	Phone number	—
40	AfasPerson › Fields	FaNr	Fax werk	Work fax.	string (max 255)	No	—	Candidate – custom field	fax-work	Text	Free text	—
41	AfasPerson › Fields	MbNr	Mobiel werk	Work mobile.	string	No	—	Candidate – custom field	mobile-work	Text	Phone number	—
42	AfasPerson › Fields	HoPa	Website	Website.	uri	No	—	Candidate – custom field	website	Text	URL	—
43	AfasPerson › Fields	Corr	Correspondentie	Correspondence flag.	boolean	No	—	Candidate – custom field	correspondence	Checkbox / Boolean	true / false	—
44	AfasPerson › Fields	ViMd	Voorkeursmedium	Preferred medium.	enum	No	—	Candidate – custom field	preferred-medium	Select (value = AFAS code)	EMA = E-mail · FAX = Fax · PRS = Persoonlijk · PST = Post · TEL = Telefoonnr.	—
45	AfasPerson › Fields	Re	Opmerking	Remark.	byte (text)	No	—	Candidate – custom field	remark	Text	Free text	—
46	AfasEmployee › Fields	EnUs	Automatisch gebruiker aanmaken	Auto-create InSite user.	boolean	No	—	Config – activation setup		checkbox (config field)	true / false	empty	Config field 'createUser'. When on, AFAS creates a user and needs an e-mail per 'User email type' (work-email if Business).
47	AfasEmployee › Fields	EmUs	E-mail gebruiker	User e-mail type.	enum	No	—	Config – activation setup		select (config field)	P = Privé e-mailadres · Z = Zakelijk e-mailadres	—	Config field 'userEmail'. SELECTOR only (P/Z). If Z (Business) the candidate 'work-email' must be filled; P uses the private e-mail (always present).
48	AfasEmployee › Fields	ExTm	Exporteren naar tijdregistratie	Export to time registration.	boolean	No	—	Candidate – custom field	export-time-registration	Checkbox / Boolean	true / false	—
49	AfasEmployee › Fields	LgId	Afwijkende taal	Deviating language.	string (max 3)	No	—	Candidate – custom field	language	Text	Language code e.g. NL	—
50	AfasEmployee › Fields	RlBh	Relatiebeheerder	Account manager.	string (max 15)	No	—	Candidate – custom field	account-manager	Text	AFAS code	—
51	AfasEmployee › Fields	StFs	Startfase	Start phase.	enum	No	—	Candidate – custom field	start-phase	Select (value = AFAS code)	1 = Fase 1 · 12 = Fase 1-2 · 2 = Fase 2 · 3 = Fase 3 · 4 = Fase 4 · A = Fase A · B = Fase B · C = Fase C · G = Geen fasetelling	—
52	AfasEmployee › Fields	BeSf	Begindatum startfase	Start date phase.	date	No	—	Candidate – custom field	start-date-phase	Date	YYYY-MM-DD	—
53	AfasEmployee › Fields	BePe	Begindatum vorige werkgever	Start date previous employer.	date	No	—	Candidate – custom field	start-date-previous-employer	Date	YYYY-MM-DD	—
54	AfasEmployee › Fields	DlWk	Datum laatst gewerkt	Date last worked.	date	No	—	Candidate – custom field	date-last-worked	Date	YYYY-MM-DD	—
55	AfasEmployee › Fields	WkWh	Gewerkte weken	Worked weeks history.	integer	No	—	Candidate – custom field	worked-weeks	Number	Whole number	—
56	AfasEmployee › Fields	CF3h	Kalenderweken fase 3	Calendar weeks phase 3.	integer	No	—	Candidate – custom field	calendar-weeks-phase-3	Number	Whole number	—
57	AfasEmployee › Fields	CFBh	Kalenderweken fase B	Calendar weeks phase B.	integer	No	—	Candidate – custom field	calendar-weeks-phase-b	Number	Whole number	—
58	AfasEmployee › Fields	AF3h	Aantal fase 3 contracten	Phase-3 contracts.	integer	No	—	Candidate – custom field	contracts-phase-3	Number	Whole number	—
59	AfasEmployee › Fields	AFBh	Aantal fase B contracten	Phase-B contracts.	integer	No	—	Candidate – custom field	contracts-phase-b	Number	Whole number	—
60	AfasEmployee › Fields	ViPa	Betaalfrequentie	Payment frequency.	enum	No	—	Candidate – custom field	payment-frequency	Select (value = AFAS code)	4W = 4 weken · P = Periode	—
61	AfasEmployee › Fields	PsPv	Verstrekking loonstrook	Payslip delivery.	enum	No	—	Candidate – custom field	payslip-delivery	Select (value = AFAS code)	A = Afdrukken · B = Afdrukken en bericht · E = Bericht · N = Niet afdrukken/Geen bericht	—
62	AfasEmployee › Fields	YsPv	Verstrekking jaaropgave	Annual statement delivery.	enum	No	—	Candidate – custom field	annual-statement-delivery	Select (value = AFAS code)	A = Afdrukken · B = Afdrukken en bericht · E = Bericht · N = Niet afdrukken/Geen bericht	—
63	AfasEmployee › Fields	EmAd	E-mail digitale documenten	E-mail for digital docs.	enum	No	—	Config – activation setup		select (config field)	P = Privé e-mailadres · Z = Zakelijk e-mailadres	—	Filled with the same 'userEmail' config value (P/Z) as EmUs — a selector, not the address.
64	AfasEmployee › Fields	PwEm	Wachtwoord	Password.	string (max 70)	No	—	Candidate – custom field	employee-password	Text	Free text	—
65	AfasEmployee › Fields	EmUp	Privé e-mail mag verstrekt	Private e-mail may be shared.	boolean	No	—	Candidate – custom field	share-private-email	Checkbox / Boolean	true / false	—
66	AfasEmployee › Fields	BeVo	Bewindvoering	Guardianship.	boolean	No	—	Candidate – custom field	administration	Checkbox / Boolean	true / false	—
67	AfasEmployee › Fields	ViTr	Overgangsregeling 2022	Transitional arrangement.	enum	No	—	Candidate – custom field	transitional-arrangement	Select (value = AFAS code)	1 = Nog te bepalen d.m.v. jaarloon BT · 2 = Geen overgangsregeling · 3 = Overgangsregeling Fase A/1-2 · 4 = Overgangsregeling Fase B/3	—
68	AfasEmployee › Fields	Flex	Flex-medewerker	Flex employee.	boolean	No	—	Candidate – custom field	flex-employee	Checkbox / Boolean	true / false	—
69	AfasEmployee › Fields	BlPa	Geblokkeerd voor betaling	Blocked for payment.	boolean	No	—	Candidate – custom field	payment-blocked	Checkbox / Boolean	true / false	—
70	AfasEmployee › Fields	SeAt	E-mailbijlagen beveiligen	Secure e-mail attachments.	boolean	No	—	Candidate – custom field	secure-email-attachments	Checkbox / Boolean	true / false	—
71	AfasEmployee › Fields	Sdla	Id-nummer persoon	Person id number.	string (max 10)	No	—	Candidate – custom field	id-number-person	Text	Free text	—
72	AfasEmployee › Fields	CrIb	CRIB nummer	CRIB number.	string (max 9)	No	—	Candidate – custom field	crib-number	Text	Free text	—
73	AfasBankInfo (module)	(toggle)	—	Enables the bank block.	boolean	No	—	Control flag (config – activation setup)		checkbox (config field)	true / false	off	Config field 'bankData'. Bank-country is mandatory when on — missing it ERRORS the whole onboarding (not a silent skip).
74	AfasBankInfo › Fields	CoId	Land van de bank	Bank country.	string (max 3)	Conditional	REQUIRED when bank block on	Candidate – custom field	bank-country	Text	AFAS country code e.g. NL	—	If bank block on and empty → onboarding FAILS with an error.
75	AfasBankInfo › Fields	IbCk	IBAN-controle	Validate IBAN.	boolean	No	Only within bank block	Candidate – custom field	iban-controle	Checkbox / Boolean	true / false	false
76	AfasBankInfo › Fields	Iban	IBAN-nummer	IBAN.	string (max 40)	No	Only within bank block	Candidate – custom field	iban-number	Text	IBAN	—
77	AfasBankInfo › Fields	BaAc	Bankrekening	Bank account.	string (max 40)	No	Only within bank block	Candidate – custom field	bank-account	Text	Account no.	—
78	AfasBankInfo › Fields	BaNm	Naam bank	Bank name.	string (max 35)	No	Only within bank block	Candidate – custom field	bank-name	Text	Free text	—
79	AfasBankInfo › Fields	BaFi	Filiaal van de bank	Bank branch.	string (max 35)	No	Only within bank block	Candidate – custom field	bank-branch	Text	Free text	—
80	AfasBankInfo › Fields	BaAd	Adres van de bank	Bank address.	string (max 35)	No	Only within bank block	Candidate – custom field	bank-address	Text	Free text	—
81	AfasBankInfo › Fields	BaPl	Vestigingsplaats bank	Bank location.	string (max 35)	No	Only within bank block	Candidate – custom field	bank-location	Text	Free text	—
82	AfasBankInfo › Fields	CaPa	Kasbetaling	Cash payment.	boolean	No	Only within bank block	Candidate – custom field	cash-payment	Checkbox / Boolean	true / false	—
83	AfasBankInfo › Fields	DsTp	Betalingskenmerk incl. tekst	Payment ref incl. text.	boolean	No	Only within bank block	Candidate – custom field	payment-ref-incl-text	Checkbox / Boolean	true / false	—
84	AfasBankInfo › Fields	BkTp	Type bank	Bank type.	integer	No	Only within bank block	Candidate – custom field	bank-type	Number	Whole number	—
85	AfasBankInfo › Fields	Bic	BIC-code	BIC.	string (max 11)	No	Only within bank block	Candidate – custom field	bic	Text	BIC	—
86	AfasBankInfo › Fields	BkIc	Bank	Bank code.	string (max 15)	No	Only within bank block	Candidate – custom field	bank-code	Text	AFAS bank code	—
87	AfasBankInfo › Fields	DiNm	Afwijkende naam	Deviating name.	string (max 80)	No	Only within bank block	Candidate – custom field	bank-deviating-name	Text	Free text	—
88	AfasBankInfo › Fields	DiPl	Afwijkende woonplaats	Deviating city.	string (max 35)	No	Only within bank block	Candidate – custom field	bank-deviating-city	Text	Free text	—
89	AfasBankInfo › Fields	Ds	Betalingskenmerk	Payment reference.	string (max 32)	No	Only within bank block	Candidate – custom field	payment-reference	Text	Free text	—
90	AfasBankInfo › Fields	CalM	Code doorberekening	Cost allocation.	enum	No	Only within bank block	Candidate – custom field	bank-cost-allocation	Select (value = AFAS code)	1 = Alle kosten ten laste van de begunstigde · 2 = Alle kosten ten laste van de opdrachtgever · 3 = Gedeelde kosten	—
91	KnBasicAddressAdr/Pad (module)	(toggle)	—	Enables the address block. Only sent when on AND Ad, Rs, HmNr, ZpCd, CoId are all filled.	boolean	No	—	Control flag (config – activation setup)		checkbox (config field)	true / false	off	Config field 'addressData'. If this block is enabled but a required (Conditional) field is empty, the whole block is silently skipped — no error, nothing reaches AFAS.
92	KnBasicAddressAdr / Pad › Fields	Ad	Straat	Street.	string (max 60)	Conditional	REQUIRED when address block on	Candidate – custom field	street	Text	Free text	—	Address skipped unless Ad, Rs, HmNr, ZpCd and CoId are ALL present.
93	KnBasicAddressAdr / Pad › Fields	Rs	Woonplaats	City.	string (max 50)	Conditional	REQUIRED when address block on	Candidate – custom field	city	Text	Free text	—	From custom field 'city' → AFAS Rs.
94	KnBasicAddressAdr / Pad › Fields	HmNr	Huisnummer	House number.	integer	Conditional	REQUIRED when address block on	Candidate – custom field	house-number	Number	Whole number	—
95	KnBasicAddressAdr / Pad › Fields	ZpCd	Postcode	Postal code.	string (max 15)	Conditional	REQUIRED when address block on	Candidate – custom field	post-code	Text	e.g. 1234AB	—
96	KnBasicAddressAdr / Pad › Fields	CoId	Land	Country.	string (max 3)*	Conditional	REQUIRED when address block on	Candidate – custom field	country-address	Text	AFAS country code e.g. NL	—	From custom field 'country-address'. AFAS-mandatory (*) within the block.
97	KnBasicAddressAdr / Pad › Fields	PbAd	Postbusadres	PO-box address.	boolean*	No	Within address block	Candidate – custom field	po-box-address	Checkbox / Boolean	true / false	false	AFAS-mandatory (*) but auto-defaulted to false by the adapter.
98	KnBasicAddressAdr / Pad › Fields	ResZip	Zoek woonplaats bij postcode	Look up city by postcode.	boolean*	No	Within address block	Candidate – custom field	res-zip	Checkbox / Boolean	true / false	false	AFAS-mandatory (*) but auto-defaulted to false.
99	KnBasicAddressAdr / Pad › Fields	BeginDate	Ingangsdatum adreswijziging	Effective date.	date*	No	Within address block	Candidate – custom field	begin-date	Date	YYYY-MM-DD	Today's date	AFAS-mandatory (*) but defaults to today when empty.
100	KnBasicAddressAdr / Pad › Fields	StAd	Toev. voor straat	Street prefix.	string (max 255)	No	Within address block	Candidate – custom field	street-prefix	Text	Free text	—