Organization

BETA

Operation	Type	Object	Dto
Create	Mutation	`createOrganization`	`OrganizationCreateGLDtoInput`
Read	Query	`organizationById`	`OrganizationGLDto`
List	Query	`organizations`	`OrganizationGLDto`
Other	Query	`organizationAccountingSetupByOrgId`

Organizations in a tenant.

Key	Value
`Authorization`	Bearer Current access Token
`X-TenantId`	Current tenant id obtained from userProfile
`x-api-key`	Primary or secondary subscription key of your app

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
legislationCode RThis field is read-only, its value cannot be assigned	string	Compliance with the legislation of the organization See InfoAdditional information is available in the Info block below
socialName *The value of the field or object is mandatory	string	Company name	50
documentId *The value of the field or object is mandatory	string	Identification number See InfoAdditional information is available in the Info block below	14
documentTypeId	UUID	Id document type See InfoAdditional information is available in the Info block below
allowBlankIdentificationNumbers	boolean	always True See InfoAdditional information is available in the Info block below
useCustomerCodes *The value of the field or object is mandatory	boolean	always True
nafApeCode	string	NAF/APE Code	7
vatNumber	string	Intracommunity VAT number	25
contacts[]	Array	Contacts organization
addresses[]	Array	Addresses organization
taxOfficialModelsOrganization[]	Array	List of taxOfficialModel
allowBlankOrDuplicatedIdentificationNumbers DeprThis field is now deprecated, and we recommend using an alternative solution	boolean	always True See InfoAdditional information is available in the Info block below

legislationCode: FR, ES, or DE. This variable can be used if your application needs to work for different legislations, to account for the differences between them. Please note that this cannot be set during the organization creation process as the organization inherits the legislation from the tenant.
allowBlankOrDuplicatedIdentificationNumbers: This field is deprecated, and it is replaced by allowBlankIdentificationNumbers

documentTypeId : Id of an allowed document type, values are different depending on legislationCode

France (FR)

Spain (ES)

Germany (DE)

CountryAcronym	Allowed document types (code name)
FR	01 SIREN / SIRET

CountryAcronym	Allowed document types (code name)
DE	01 Steur-IdN

CountryAcronym	Allowed document types (code name)
ES	01 NIF/DNI

documentId : Identification number, please note that each organization must have a unique value.
France (FR)

Spain (ES)

Germany (DE)
- You can fill any SIREN of 9 characters or any SIRET of 14 characters.
- You can fill any Steur-Idn of 11 characters
- You need to fill a valid NIF number.
For your tests :

Attention, only one address is authorized, even if the representation is an array of addresses

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
countryId	UUID	Id Country
countryNameRThis field is read-only, its value cannot be assigned	string	CountryName
name	string	Code	50
firstLine	string	First Line	35
secondLine	string	Second Line	35
city	string	Town	35
zipCode	string	Postal Code	9
province	string	Province	25

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
isDefault	boolean	Main contact
jobAreaId	UUID	Job areas Id
jobName	string	Job name	35
name	string	First name	35
courtesy	NONE MR MISS	Type
surname	string	Family name	35
emails[]	Array	List of emails
phones[]	Array	List of phones
socialMedias[]	Array	List Social Networking

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
emailAddress	string	Email address	70
usage	NOT_SET EMPTY INVOICES PAYMENTS OTHERS	Type
isDefault	boolean	Main mail

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
number	string	Phone	20
type	NOT_SET EMPTY LANDLINE MOBILE FAX SKYPE WHATS_APP	Type
isDefault	boolean	Main phone

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	UUID
name	string	Name	30
link	string	Link	100

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
intialDate	datetime	Start date
finalDate	datetime	End date
taxOfficilaModelId	UUID	Id taxOfficialModel
periodicity	NONE MONTHLY QUARTERLY ANNUAL DAILY	Periodicity
territory	NONE COMMON STATE	Territory
description	string	Description	200

Fields	Type	Description
idSSystem field that cannot be assigned	UUID	Id
defaultCustomersAccountId	UUID	Customer account Id
defaultSuppliersAccountId	UUID	Supplier account Id
subAccountingLength	decimal	Sub accounts max length (max 13)
taxRegime	GENERAL BA BNC	Tax regime