Filer - Data Model

A Filer is the legal entity responsible for information reporting and tax form filing. The Filer page is the single place to manage all details required for tax form generation.

You can create a filer with just a name, but forms will not generate until the fields required for your specific regime or form type are completed. This guide shows exactly which fields each regime requires so you can complete what’s relevant to you.

Please note: If your organization uses multiple filers, ensure the correct Filer ID is assigned during ingestion. Otherwise, forms will reference the default filer.

Universal Filer Fields

The following fields are relevant for all filers, regardless of regime:

Section	Field	Required	Description	Format
Filer Details	Filer Name	Required	Legal name of the entity responsible for filing.	String
Filer Details	Address Line 1	Required	First line of the filer’s legal address	String
Filer Details	Address Line 2	Optional	Second line of the filer’s legal address	String
Filer Details	Address City	Required	City of the filer’s legal address	String
Filer Details	Address State	Only required if Address Country is US	State or province of the legal address	String/Enums
Filer Details	Address Postal Code	Only required if Address Country is US	Postal or ZIP code for the legal address	If Address Country is US: 5 or 9 digits Otherwise: String
Filer Details	Address Country	Required	Country associated with the filer’s legal address	Enums
Filer Contact Information	Phone Number	Required	Phone number associated with the filer	10 or 11 digits
Filer Contact Information	Contact Name	Only required for US 1042-S and all DAC7, MRDP, SERR	Person responsible for handling questions about the filing	String
Filer Contact Information	Contact Department/Title	Only required for US 1042-S	Role or department of the filer’s contact person	String

 

US Reporting Filer Fields

The following fields are located within the US Reporting section, and may be required in addition to Universal Filer Fields. Reference general and form type-specific sections to determine which fields are required based on the type of tax form you intend to generate:

Section	Field	Required	Description	Format
General	EIN	Required	U.S. Employer Identification Number	9 digits
General	Disposition Method	Only required for 1099-B/DA reporting	Indicates the method for the disposal of an asset.	Enums
1099-INT	RTN	Optional	Routing Transit Number	9 digits
1099-K	Filer Type	Required	Indicates whether the filer is a Payment Settlement Entity (PSE) or Electronic Payment Facilitator (EPF) This field gets locked after being set	Enums
1099-K	Transaction Type	Required	Whether the filer processes payment card transactions or third party network transactions	Enums
1099-K	PSE Name	Only required if Filer Type = EPF/Other	Name of Payment Settlement Entity	String
1099-K	PSE Phone Number	Only required if Filer Type = EPF/Other	Phone number of Payment Settlement Entity	10 or 11 digits
1042-S	Chapter 3 Status	Required	Withholding agent classification	Enums
1042-S	Chapter 4 Status	Required	FATCA classification	Enums
1042-S	Foreign TIN	Optional	Non-US tax identification number (use if entity is foreign)	Alphanumeric String
1042-S	GIIN	Optional	Global Intermediary Identification Number	XXXXXX.XXXXX.XX.XXX

 

Global Reporting Section

The following fields are located within the DAC7, MRDP, SERR, and CESOP sections, and may be required in addition to Universal Filer Fields. Reference the general and regime-specific sections to determine which fields are required based on the type of tax form you intend to generate

Section	Field	Required	Description	Format
General	TIN Country	Only required for all global reporting except DAC7 CZ, RO, or SK filings	Country that issued the tax identification number	Enums
General	TIN	Only required for all global reporting except DAC7 CZ, RO, or SK filings	Tax identification number used by the TIN country	If TIN Country is Hungary: 11 digits Great Britain: 5 letters, then 10 digits New Zealand: 8 or 9 digits Australia: 11 digits If other: any alphanumeric string
General	VAT Country	Only required for DAC7 CZ, RO, or SK filings	Country that issued the value added tax number	Enums
General	VAT	Only required for DAC7 CZ, RO, or SK filings	Value added tax number issued by VAT country	If VAT Country is Czech Republic: 8, 9, or 10 digits Romania: 8 digits Slovakia: 10 digits Other: any alphanumeric string
DAC7 Details (EU)	Receiving Jurisdiction	Required	EU member state where DAC7 reports will be filed	Enums
MRDP (Canada)	CRA Account Number Type	Only required if CRA Representative Identifier is not provided	Type of Canadian Revenue Agency number	Enum
MRDP (Canada)	CRA Account Number	Only required if CRA Representative Identifier is not provided	Canadian Revenue Agency number	If CRA Account Number Type is  BN9: 9 digits BN15: 9 digits, 2 letters, and 4 digits Trust: 1 letter, 8 digits NR4: 3 letters, 6 digits
MRDP (Canada)	CRA Representative Identifier	Only required if CRA Account Number is not provided	Canadian Revenue Agency number used for representatives filing on behalf of the entity	7 alphanumeric characters
SERR Details (Australia)	ARN	Only required if TIN Country provided is not Australia	ATO Reference Number	12 digits
CESOP	PSP ID	Required	Payment Service Provider identifier	Alphanumeric string
CESOP	PSP ID Country	Required	EU country that issued the Payment Service Provider identifier	Enums
CESOP	PSP ID Description	Required	Description of the Payment Service Provider identifier	Alphanumeric string