Subject

Each subject has a unique code

Each subject registered in 4ws.suite has a unique code that identifies their personal data, such as first name, last name, company name, etc.

The subject is classified into three categories.

Customers

In this category, the customers profiles of the tenant are included, for example, loyalty customers, B2C, or B2B customers.

Employee

Supplier

Subject type and sub type

Each subject, like customers or supplier or employee registered in the suite is classified by a type and a subtype that are interdependent, with each subtype dependent on a single type.
The basic configuration is created at the tenant's initialization.

Subject type and subtype

Get type or subtype

To retrieve the types and subtypes of entities registered by the tenant, the following services can be used:

type: Get subject type

subtype: Get subject subtype

🚧law nature

Heading
1	Compay
2	Sole Proprietorship or Natural Person
3	Private NO VAT
4	Associations or Foundations

Subject contacts & addresses

This section describes how to manage contacts and addresses for subjects within the system. Each contact and address is identified by a specific type that determines its category and usage.

Subject contacts

A subject's contacts can be of various types, each serving to identify a different mode of communication.

contacts type

Contact Example

A contact consists of the following fields:

contact_type: The type of contact, must be one of the values listed above.

value: The actual contact information, such as the phone number or email address.

JSON Example

{
    "subject_code": "123433",
    "contact_type": "CELL",
    "value": "+38 11111111"
}

Subject adresses

A subject's addresses can be used for various purposes, such as shipping, billing, or residence. The supported address types are:

contacts type

Address Example: an address consists of the following fields:

address1: Street address

city: City

state: State or province

zip_code: Postal code

country: Country (ISO 2 ISO Code)

address_type: The type of address, must be one of the values listed above.

JSON Example

{
    "destination_code": "123",
    "subject_code": "123433",
    "destination_type": "RES",
    "country": "IT",
    "address1": "123 Main St",
    "zip_code": "20100",
    "city": "Milan",
    "province": "MI"
}

Managing Contacts and Addresses

Contacts and addresses are associated with subjects through a one-to-many relationship. This means each subject can have many contacts and many addresses.

Adding a Contact

To add a contact to a subject, you must provide the subject code (subject_code), the contact type (contact_type), and the contact information (contact_info).

INFO

Complete documentation Insert new contacts

API Request Example

{
  "subject_code": "12345",
  "contact_type": "EMAIL",
  "contact_info": "example@example.com"
}

Adding an Address

To add an address to a subject, you must provide the subject code (subject_code) and all relevant address information.

INFO

Complete documentation Insert subject address

API Request Example

{
    "destination_code": "123",
    "subject_code": "123433",
    "destination_type": "FATT",
    "country": "IT",
    "address1": "123 Main St",
    "zip_code": "20100",
    "city": "Milan",
    "province": "MI"
}

Subject customers cards

Todo
card, subtype type, circuit ecc...

Subjects overview

Subject#

Subject type and sub type#

🚧law nature#

Subject contacts & addresses#

Subject contacts#

Contact Example#

JSON Example#

Subject adresses#

JSON Example#

Managing Contacts and Addresses#

Adding a Contact#

Adding an Address#

Subject customers cards#

Subject

Subject type and sub type

🚧law nature

Subject contacts & addresses

Subject contacts

Contact Example

JSON Example

Subject adresses

JSON Example

Managing Contacts and Addresses

Adding a Contact

Adding an Address

Subject customers cards