Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
Return list of companies in WorkbenchProvides access to Company related data.
Endpoints
The resources available in this module.
CompanyListApi
Return companies list in WorkbenchProvides API access to the Companies (#/General/CompanyList.aspx) Web Workbench screen.
/api/CompanyListApi | |||||
---|---|---|---|---|---|
Method | DescriptionPerformed As | Request Query | Request Body | Response | |
GET | Logged in User | - | - | ||
POST |
CompanyDetailApi
Return company details, people, addresses and attributescompanies. | Logged in User | - |
CompanyDetailApi
Provides API access to the Company Detail (#/General/CompanyList.aspx) dialog Web Workbench screen.
/api/CompanyDetailApi | |||||
---|---|---|---|---|---|
Method | Description | Performed As | Request Query | Request Body | Response |
GET | Admin User | - | |||
POST | Admin User | - |
Models
The definitions of models specific to endpoints in this module.
CompanyApiModelCompanyKey
Property | Type | Description |
---|
Field
Type
CompanyID |
GeneralCompanyKey
Main
GeneralCompanyMainFields
Financials
GeneralCompanyFinancialsFields
People
CompanyApiGridLines_GeneralPersonLine
Attributes
CompanyApiGridLines_GeneralAttributeLine
Addresses
CompanyApiGridLines_GeneralAddressLine
Notes
CompanyApiGridLines_GeneralNoteLine
GeneralCompanyLine
Integer | The unique Company ID of the Company |
CompanyLine
Property | Type | Description |
---|---|---|
Key | The unique key for the line. | |
CompanyId | Integer |
The unique Company ID |
of the |
Company. | ||
CompanyName | String | The name of the Company. |
CompanyNameValue | The name of the Company. | |
AlphaCode | String | The shorthand code for the Company. |
AlphaCodeValue | The shorthand code for the |
Company. | ||
ApAccount | String | The AP linking code to the financial system. |
ApAccountValue | The AP linking code to the financial system. | |
ArAccount | String | The AR linking code to the financial system. |
ArAccountValue | The AR linking code to the financial system. | |
CreditStatus | String | The Company's credit status with your organization. |
CreditStatusValue | The |
Company's credit status |
with your organization. | ||
Location | String | The location the Company has been assigned to. |
LocationValue | The location the Company has been assigned to. | |
FinancialCompanyCode | String | The internal Financial Company this company sits under. |
FinancialCompanyCodeValue |
The internal Financial Company this company sits under. | ||
CompanyType | String | The company type of this |
Company. |
CompanyTypeValue |
String
The company type of this Company. | ||
Phone | String | The Phone Number of this Company. |
PhoneValue | The Phone Number of this Company. | |
Client | Boolean |
The Client flag on the Company. | |
Supplier | Boolean |
The Supplier flag on the Company. | |
Subcontractor | Boolean |
The Subcontractor flag on the Company. | ||
Other | Boolean | The |
Other flag on the Company. | ||
Inactive | Boolean | The |
Inactive flag on the Company. | ||
GSTNumber | String | The tax identifier for the |
Company. |
CostValue | CellData |
CompanyNameValue
Company name.
AlphaCodeValue
The shorthand code for the company.
ApAccountValue
The AP linking code to the financial system.
ArAccountValue
The AR linking code to the financial system.
CreditStatusValue
The company's credit status is with your organization.
LocationValue
The location has been assigned to this company.
FinancialCompanyCodeValue
The internal Financial Company this company sits under.
CompanyTypeValue
The company type of this company.
PhoneValue
Phone number.
CostValue
Price cost?
CatalogueValue
Group 1
String
The group of the company.
Group 2
String
The group of the company.
Group 3
String
The group of the company.
UpdatedDate
String
Updated date.
Status
String
ReadonlyFlag
Integer
ReadonlyMessage
String
OriginalKey
CurrentKey
Key
Index
Integer
GeneralCompanyKey
(if GridRequestParametersApi.IntValue2 is populated with an ItemID) The Cost on the Catalogue Line | ||
CatalogueValue | CellData | (if GridRequestParametersApi.IntValue2 is populated with an ItemID) The Name of the Catalogue |
Group1 | String | The Attribute Group of the first Attribute Category filter |
Group2 | String | The Attribute Group of the second Attribute Category filter |
Group3 | String | The Attribute Group of the third Attribute Category filter |
UpdatedDate | DateTime | The Date this record was last updated. |
CompanyApiModel
Property | Type | Description |
---|---|---|
Key | The unique key of the Company. | |
Main | General data associated with the Company. | |
Financials | Financial data associated with the Company. | |
People.Rows | Array<PersonLine> | People associated with the Company. |
Attributes.Rows | Array<AttributeLine> | Attributes associated with the Company. |
CompanyInsurance.Rows | Array<CompanyInsuranceLine> | Company Insurances associated with the Company. |
Addresses.Rows | Array<AddressLine> | Addresses associated with the Company. |
Notes.Rows | Array<NoteLine> | Notes associated with the Company. |
ToDoItems.Rows | Array<ToDoLine> | To Do Items associated with the Company. |
⬆️ Back to top
CompanyMainFields
GeneralCompanyMainFields
Field | Type | Description | |||
---|---|---|---|---|---|
CompanyIDCompany. | |||||
CompanyName | Code The name of the company | CompanyName | Company nameCompany. | ||
AlphaCode | The shorthand code for the companyCompany. | ||||
CompanyType | The type of the companyCompany. | ||||
PriceCode | Price code of the companyCompany. | ||||
Location | Location The location the Company has been assigned to company. | ||||
Branch | StringViewDataFinancialCompany | The Branch the Company belongs to. | |||
FinancialCompany | The internal Financial Company this company Company sits under. | ||||
ArAccount | The AR linking code to the financial system. | ||||
ApAccount | The AP linking code to the financial system. | ||||
Currency | The default currency Currency of the companyCompany. | ||||
CompanyReference | The reference. | ||||
InactiveCompany | The Inactive flag on the Company. | ||||
Client | Marked as Client or notThe Client flag on the Company. | ||||
Supplier | Marked as Supplier or notThe Supplier flag on the Company. | ||||
Subcontractor | Marked as Subcontractor or notThe Subcontractor flag on the Company. | ||||
Other | Marked as Other or notThe Other flag on the Company. | ||||
GSTNumber | The tax identifier for the companyCompany. | ||||
DefaultJobManager | The Person as who is the default Job managerManager. | ||||
DefaultAccountManager | The Person as who is the default Account managerManager. |
⬆️ Back to top
GeneralCompanyFinancialsFieldsCompanyFinancialsFields
Property | Type | Description |
---|---|---|
PaymentTerms | The numerical value for days | |
PaymentTermsType | To nominate the payment terms for Job Sales Invoices to this company | |
CreditStatus | The company's credit status is with your organization | |
CashLimit | To nominate a cash limit. | |
BankAccountRef1 | Account details. | |
BankAccountRef2 | Account details. | |
BankAccountRef3 | Account details. | |
UseGST | Include tax on any sales to this company Have tax or not. | |
CashOnly | This company as a cash-only or not | |
UseBuyerCreatedInvoices | Use the BCI/RCTI with this company or not. |
GeneralPersonLine
Field⬆️ Back to top
CompanyInsuranceKey
Property | Type | Description |
---|
CompanyInsuranceID | Integer | The unique ID of the |
DisplayName
String
Surname
String
Family name
FirstName
String
First name
CompanyId
Integer
The company id of the person.
Company
String
The company name of this person.
Role
String
Person role.
JobTitle
String
User's official title.
EmailAddress
String
Email address.
MobilePhone
String
Mobile number
BusinessPhone
String
Working phone number
IsEmployee
Boolean
The person is an employee or not.
IsActive
Boolean
The account is active or not.
Inactive
Boolean
The account status is inactive or not.
IsBillingContact
Boolean
The person is the billing contact or not.
IsSiteContact
Boolean
The person is the primary project contact or not.
IsCommercialContact
Boolean
The person is the Site Contact or not.
EmployeeNo
String
Employee code
SelectId
String
SelectTag
String
Select
PersonIdValue
Code of the person
SurnameValue
Surname of the person
FirstNameValue
First name of the person.
CompanyValue
Company of the person.
RoleValue
Person role.
JobTitleValue
User's official title.
EmailAddressValue
Person email address
MobilePhoneValue
Person mobile number
BusinessPhoneValue
Person business phone
Delete
Group1
String
The Attribute Group of the first Attribute Category filter
Group2
String
The Attribute Group of the second Attribute Category filter
Group3
String
The Attribute Group of the third Attribute Category filter
UpdatedDate
String
Updated date.
Status
String
ReadonlyFlag
Integer
ReadonlyMessage
String
OriginalKey
GeneralPersonKey
CurrentKey
GeneralPersonKey
Key
GeneralPersonKey
Index
Company Insurance. | ||
CompanyID | Integer | The ID of the Company this belongs to. |
CompanyInsuranceLine
Property | Type | Description |
---|---|---|
Key | The unique key for the line. | |
Type | String | The description of the Insurance Type. |
TypeValue | The description of the Insurance Type. | |
Number | String | The Insurance Certificate Number. |
Numbervalue | The Insurance Certificate Number. | |
ExpiryDate | DateTime | The Insurance Expiry Date. |
Insurer | String | The Insurance name. |
InsurerValue | The Insurance name. | |
Cover | Decimal | The Insurance limit. |
CoverValue | The Insurance limit. | |
Excess | Decimal | The Insurance excess. |
ExcessValue | The Insurance excess. | |
Subcontract | String | The description of the Subcontract. |
SubcontractValue | The description of the Subcontract. | |
Description | String | The description of the Company Insurance. |
DescriptionValue | The description of the Company Insurance. | |
Details | String | The details on the Company Insurance. |
DetailsValue | The details on the Company Insurance. | |
Reviewed | Boolean | The Reviewed flag on the Company Insurance. |
AddressKey
Property | Type | Description |
---|---|---|
AddressID | Integer | The unique ID of the Address. |
AddressLine
Property | Type | Description |
---|---|---|
Key | The unique key for the line. | |
Title | String | The Address Title. |
TitleValue | The Address Title. | |
Line1 | String | Street line 1 information. |
Line1Value | Street line 1 information. | |
Line2 | String | Street line 2 information. |
Line2Value | Street line 2 information. | |
Phone | String | The phone number on the address. |
PhoneValue | The phone number on the address. | |
PostCode | String | The post code of the Address. |
PostCodeValue | The post code of the Address. | |
Inactive | Boolean | The Reviewed flag on the Address. |
IsPostalAddress | Boolean | A flag to indicate if the Address is the Postal Address of the Company. |
IsPhysicalAddress | Boolean | A flag to indicate if the Address is the Physical Address of the Company. |
Examples
Get list of first 20 companies.
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response sample
|
Get the list of all Workbench companies.
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response sample
|
Create a new company.
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response sample
|
⬆️ Back to top
On this page
Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|