Understanding the CRM Concept
Last updated
Last updated
CRM is a technology for managing all your company´s relationships and interactions with existing customers and potential customers. For managing this information Pipeliner provides CRM users with different objects representation and relationships between them. Pipeliner calls the main objects Entities.
Entities help to map company sales business processes in the CRM. In Pipeliner, there exist following Entities
represents the potential business to your company
Activities
Represents Tasks and Appointments together. Tasks are one-time activities that usually don´t have duration. We can refer to Appointments as meeting with duration.
Appointments (Endpoint: {{baseURL}}/entities/Appointments)
Tasks: (Endpoint: {{baseURL}}/entities/Tasks)
Notes
Messages
Entities in the CRM are linked between themselves with relations. Take a look at the entity-relationship diagram to understand the connections that can exist.
Api name: master_right
Users are part of the Role. Users can be assigned only to one Role. The role determines what data, features the User can access.
Example of Roles: Standard Users, Administrators, Salespeople
Api name: client
Users are real people who have access to the Pipeliner CRM space. Users usually get a direct invitation to the space from the space admin. The user unique identification is email_address.
Users can be assigned to the Entity Records. Users who are assigned to the records are called Owners. Owners are required on the majority of entities. Only Leads and Activities can be unassigned (without an Owner).
Api name: unit
Sales units from a business point of view are groups of users with similar traits. Sales units works in the hierarchy. Pipeliner admin defines this hierarchy based on the business requirements. Sales units can refer to territory, team, business unit.
Example of Sales units: Canada, Europe -> UK, Germany, France
System Sales Unit
The Company
sales Unit is System Sales Unit. It is always at the top of the hierarchy and you can always assign entity records to this Sales Unit. Company Sales Unit has always attribute parent:
null
Accounts ( {{baseURL}}/entities/Accounts)
accounts stores Company information (industry, company size, contacts). See how to create
Contacts ({{baseURL}}/entities/Contacts)
contacts refer to people who have a relation to a specific Account. See how to create
Opportunities ( {{baseURL}}/entities/Opportunities)
represents existing or potential business revenue with Contact or Account. Opportunities have to move through several stages in Pipeline. See how to create
Leads ( {{baseURL}}/entities/Leads)
Products (: {{baseURL}}/entities/Products)
Represents physical items that your sales team is selling. See how to create
Product Line Items ({{baseURL}}/entities/OpptyProductRelations)
Represents product that is being currently sold by your sales team. Product Line items are direct connections between Opportunity and Physical Product. See how to work with
Documents ( {{baseURL}}/entities/CloudObjects)
To get {{baseURL}} read
Fields represent a property of Entity where end-users(salespeople) store information like (Name, Opportunity Value, Industry...). Pipeliner works with System Fields (defined by the Pipeliner system) and Custom Fields (defined by business people). Learn more about .
Users, roles, sales units determine what users can see inside the Pipeliner application. At the top of the hierarchy is the Role, which includes 0..N users. Those Users can be part of the N Sales Units. To understand how roles, users, sales unit works .
Returns all defined MasterRights
if enabled, deleted MasterRights are returned as well
Number of entities to return from beginning of the result set. Max: 100. Default: 30
Return only the "last" number of entities from result set. When used with first parameter, then it returns last M records from the first N records.
Cursor until which to take entities to result set.
Cursor after which to start taking entities to result set.
Expand related entity. Use api_names of relation fields. You can use multiple values separated via ',' colon. If not used, URI link will be returned instead. You can use dots '.' to expand nested entities as well.
expand=owner,sales_unit,account_relations.account
Order by values. Use api_name of field to sort by ascending. Prefix api_name with '-' to descending sort. You can use multiple values separated via ',' colon.
order-by=created,-modified
Use name of field in braces to filter by this field. To advanced filter, use with combination with filter-op parameter.
filter[name]=Example
Filter operator. Specify a way how to filter fields. Supported operators: [eq, ieq, not-eq, not-ieq, contains, starts, ends, icontains, istarts, iends, null, not-null, empty, not-empty, gt, gte, lt, lte, between].
filter-op[name]=eq
Loads only fields defined within this parameter. You can use multiple values separated via ',' colon. If not used, then all fields are returned. You can use dots '.' to specify load only fields in nested as well.
load-only=id,name,owner.id
Returns all defined Clients
if enabled, deleted Clients are returned as well
Number of entities to return from beginning of the result set. Max: 100. Default: 30
Return only the "last" number of entities from result set. When used with first parameter, then it returns last M records from the first N records.
Cursor until which to take entities to result set.
Cursor after which to start taking entities to result set.
Expand related entity. Use api_names of relation fields. You can use multiple values separated via ',' colon. If not used, URI link will be returned instead. You can use dots '.' to expand nested entities as well.
expand=owner,sales_unit,account_relations.account
Order by values. Use api_name of field to sort by ascending. Prefix api_name with '-' to descending sort. You can use multiple values separated via ',' colon.
order-by=created,-modified
Use name of field in braces to filter by this field. To advanced filter, use with combination with filter-op parameter.
filter[name]=Example
Filter operator. Specify a way how to filter fields. Supported operators: [eq, ieq, not-eq, not-ieq, contains, starts, ends, icontains, istarts, iends, null, not-null, empty, not-empty, gt, gte, lt, lte, between].
filter-op[name]=eq
Loads only fields defined within this parameter. You can use multiple values separated via ',' colon. If not used, then all fields are returned. You can use dots '.' to specify load only fields in nested as well.
load-only=id,name,owner.id
Returns all defined SalesUnits
if enabled, deleted SalesUnits are returned as well
Number of entities to return from beginning of the result set. Max: 100. Default: 30
Return only the "last" number of entities from result set. When used with first parameter, then it returns last M records from the first N records.
Cursor until which to take entities to result set.
Cursor after which to start taking entities to result set.
Expand related entity. Use api_names of relation fields. You can use multiple values separated via ',' colon. If not used, URI link will be returned instead. You can use dots '.' to expand nested entities as well.
expand=owner,sales_unit,account_relations.account
Order by values. Use api_name of field to sort by ascending. Prefix api_name with '-' to descending sort. You can use multiple values separated via ',' colon.
order-by=created,-modified
Use name of field in braces to filter by this field. To advanced filter, use with combination with filter-op parameter.
filter[name]=Example
Filter operator. Specify a way how to filter fields. Supported operators: [eq, ieq, not-eq, not-ieq, contains, starts, ends, icontains, istarts, iends, null, not-null, empty, not-empty, gt, gte, lt, lte, between].
filter-op[name]=eq
Loads only fields defined within this parameter. You can use multiple values separated via ',' colon. If not used, then all fields are returned. You can use dots '.' to specify load only fields in nested as well.
load-only=id,name,owner.id