Organizations Data Structure and Requirements
Inspectorio Responsible Sourcing & Compliance (RSC), as a responsible sourcing platform, focuses on organizations based assessments execution.
Inspectorio RSC API enables you to take over full control over managing your supply chain entirely within the platform. Bring in all organizations that you are working with into the platform, build associations for correct data sharing and manage organizations profiles effectively and autonomously.
Organization Types​
Inspectorio RSC gives you the ability to reflect your entire supply chain by (POSTing
) two types of organizations. Different organization types have different roles in auditing operations and thus perform different activities within the platform.
- Partner
Partner organizations represent Suppliers, Vendors, Inspection Agencies that your organization is working with.
- Factory
Factory is an actual production facility organization that is normally going through the assessment.
You can specify the type of organization that you wish to integrate through (type
) field available in our POST API method. This is a mandatory string field supporting two types of values: (factory
) or (partner
).
Mind that it is not possible to update the type of organization once it is created. One organization on Inspectorio RSC can be either partner or factory, but not both.
Organization attributes​
There are numerous attributes that can be included into organization profile on Inspectorio RSC depending on organization type. Utilize the capabilities outlined below to group organizations with similar profiles into assessments activation lists and activate responsible sourcing audits efficiently.
Partner organization attributes:
Field Name | Properties | Type | Description | Example |
---|---|---|---|---|
General information | ||||
id | Required, Unique | string | Unique identifier of an Organization | P123 |
name | Required | string | Name of the Organization | Partner A |
type | Required | string | Enum: factory ,partner . Field is case-sensitive. | partner |
address | Required | string | Address of the Organization | 901 Marquette Ave. S, Suite 603 |
city | string | City of the Organization | Minneapolis | |
country | string | Country of the Organization represented by the standard ISO Alpha-2 code | US for the United States | |
postal | string | Zip / Postal code of the Organization | 55402 | |
province | string | Province of the Organization | Minnesota | |
location[].latitude | Required | float | 44.97997 | |
location[].longitude | Required | float | 93.26384 | |
isFoodFacility | boolean | Indicates by true or false whether the Organization has the ability to produce food | true | |
contacts[].id | string | Unique identifier of the organization contact | E123 | |
contacts[].email | Required | string | Email of the organization contact | [email protected] |
contacts[].firstName | Required | string | First name of the organization contact | Jane |
contacts[].lastName | string | Last name of the organization contact | Addams | |
contacts[].phone | Required | string | Phone number of the organization contact | 12345678 |
contacts[].phoneCountryCode | string | Country code of the phone number of a Contact | 084 | |
Other Attributes | ||||
businessPartnerTypes | Only required in case organization's type is partner | string | Multiple choice from the list:Fabric Supplier Trim Supplier Merchandise Vendor Packaging Supplier Production/Storage Facility Owner Field is case-sensitive. | Fabric Supplier |
Factory organization attributes:
Field Name | Properties | Type | Description | Example |
---|---|---|---|---|
General information | ||||
id | Required, Unique | string | Unique identifier of an Organization | F123 |
name | Required | string | Name of the Organization | Factory A |
type | Required | string | Enum: factory ,partner . Field is case-sensitive. | factory |
address | Required | string | Address of the Organization | 901 Marquette Ave. S, Suite 603 |
city | string | City of the Organization | Minneapolis | |
country | string | Country of the Organization represented by the standard ISO Alpha-2 code | US for the United States | |
postal | string | Zip / Postal code of the Organization | 55402 | |
province | string | Province of the Organization | Minnesota | |
location[].latitude | Required | float | 44.97997 | |
location[].longitude | Required | float | 93.26384 | |
isFoodFacility | boolean | Indicates by true or false whether the Organization has the ability to produce food | true | |
contacts[].id | string | Unique identifier of the organization contact | E123 | |
contacts[].email | Required | string | Email of the organization contact | [email protected] |
contacts[].firstName | Required | string | First name of the organization contact | Jane |
contacts[].lastName | string | Last name of the organization contact | Addams | |
contacts[].phone | Required | string | Phone number of the organization contact | 12345678 |
contacts[].phoneCountryCode | string | Country code of the phone number of a Contact | 084 | |
Other Attributes | ||||
partners[].id | Only required in case partner field is added into request body | string | Unique identifier of the Partner Organization | 123 |
partners[].name | Only required in case partner field is added into request body | string | Name of the Partner Organization | Partner A |
partners[].authorizedCapabilities | integer[] | Multiple choice from the list: 1, 2, 3, 4, 5, 6, 7 Decoding of numbers: 1 = "DYEING", 2 = "PRINTING", 3 = "FINISHING", 4 = "KNITTING", 5 = "WEAVING", 6 = "LAUNDRY", 7 = "SPINNING" | 2 | |
partners[].manufacturingTypes | integer[] | Multiple choice from the list: 1, 2, 3, 4, 5 Decoding of numbers: 1 = "FACTORY", 2 = "MILL", 3 = "LAUNDRY", 4 = "PACKING", 5 = "TRIM" | 1 | |
partners[].locationStatus | string | Single choice from the list: "Available", "In Progress", "Non-Compliant", "Pending Transfer", "Pending Duplicate Check" Field is case-sensitive. | Available | |
partners[].registrationDate | date-time | Date of registration of the Partner Organization | 18-01-15 | |
partners[].registrationStatus | integer | Single choice from the list: 1, 2, 3, 4 Decoding of numbers: 1 = "REGISTERED", 2 = "UNREGISTERED", 3 = "PENDING", 4 = "DECLINED" | 3 | |
partners[].scope | integer | Single choice from the list: 1, 2, 3 Decoding of numbers: 1 = "OWNED_BRAND", 2 = "NATIONAL_BRAND", 3 = "BOTH" | 2 |
Associations​
Inspectorio RSC is a network platform empowering Brands, Retailers, Vendors and Factories to cooperate together within centralized platform for greater effectiveness and transparency. Thus, when integrating your supply chain organizations into Inspectorio RSC, it is pivotal to build proper associations between organizations that are partnering.
Associations allow you to collaborate with organizations within your ecosystem, engage into compliance operations and share information with relevant stakeholders.
All organizations that you are pushing into the system will be automatically associated with your organization. It will make all organizations’ profiles accessible through your account for assessments activations.
But this is also important to build associations between Partners (Vendors/Suppliers) and its Factories to allow these organizations to work together on assessments and get visibility over the important audits data.
There is a type of relationship that can be established between Partner organization and its Factories, which is Business Partnership
-
Partnership association type presupposes subcontracting business relationship between Partner organization and its Factories. One Factory can have multiple Partners it is working with and vice versa. Association is built through (
partners[].id
) and (partners[].name
) fields where Partner ID is a unique external ID of Partner organization and Partner Name is the name of the organization. -
If the ID does not exist in Inspectorio system at the moment of integration yet, then it will be created automatically via REST-API with default type Partner.
-
If an organization whose type is
partner
can not be created due to duplicates, it means that there is an existing partner with the same partner ID. In this case, (PUT
) method is the only accepted method to update the partner's information.
Mentioned fields for establishing both types of associations are available in (POST
) and (PUT
) methods for factory
of organization's type only.
For further information, you can look at our API References page here, to understand better data structure for organizations.