mirror of https://github.com/vernonkeenan/lib
2410 lines
61 KiB
YAML
2410 lines
61 KiB
YAML
swagger: "2.0"
|
|
info:
|
|
version: 0.0.2
|
|
title: "sf-gate"
|
|
description: "Customer Information Microservice"
|
|
termsOfService: "http://taxnexus.net/terms/"
|
|
contact:
|
|
email: "noc@taxnexus.net"
|
|
license:
|
|
name: "Proprietary - Copyright (c) 2018-2021 by Taxnexus, Inc."
|
|
securityDefinitions:
|
|
ApiKeyAuth:
|
|
type: "apiKey"
|
|
in: "header"
|
|
name: "X-API-Key"
|
|
schemes:
|
|
- "http"
|
|
basePath: "/v1"
|
|
host: "sf-gate.vernonkeenan.com:8080"
|
|
consumes:
|
|
- "application/json"
|
|
produces:
|
|
- "application/json"
|
|
parameters:
|
|
accountIdQuery:
|
|
description: Taxnexus Record Id of an Account
|
|
in: query
|
|
name: accountId
|
|
required: false
|
|
type: string
|
|
accountRequest:
|
|
description: A request with an array of Account Objects
|
|
in: body
|
|
name: accountRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AccountRequest"
|
|
activeQuery:
|
|
description: Only retrieve active records?
|
|
in: query
|
|
name: active
|
|
required: false
|
|
type: boolean
|
|
apiKeyQuery:
|
|
description: Taxnexus Id of the User to be retrieved
|
|
in: query
|
|
name: apikey
|
|
required: false
|
|
type: string
|
|
assetIdQuery:
|
|
description: Taxnexus Record Id of an Asset
|
|
in: query
|
|
name: assetId
|
|
required: false
|
|
type: string
|
|
assetRequest:
|
|
description: An array of new Asset records
|
|
in: body
|
|
name: assetRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/AssetRequest"
|
|
clusterIdQuery:
|
|
description: Taxnexus Record Id of a Cluster
|
|
in: query
|
|
name: clusterId
|
|
required: false
|
|
type: string
|
|
clusterRequest:
|
|
description: An array of Cluster records
|
|
in: body
|
|
name: ClusterRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/ClusterRequest"
|
|
companyProductIdQuery:
|
|
description: Taxnexus CompanyProduct record ID
|
|
in: query
|
|
name: companyProductId
|
|
required: false
|
|
type: string
|
|
contactIdQuery:
|
|
description: Taxnexus Record Id of a Contact
|
|
in: query
|
|
name: contactId
|
|
required: false
|
|
type: string
|
|
contactRequest:
|
|
description: An array of new Contact records
|
|
in: body
|
|
name: contactRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/ContactRequest"
|
|
companyProductRequest:
|
|
description: An array of new Contact records
|
|
in: body
|
|
name: contactRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/CompanyProductRequest"
|
|
contractIdQuery:
|
|
description: Taxnexus Contact record ID
|
|
in: query
|
|
name: contractId
|
|
required: false
|
|
type: string
|
|
contractRequest:
|
|
description: An array of new Contract records
|
|
in: body
|
|
name: contractsRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/ContractRequest"
|
|
databaseRequest:
|
|
description: An array of Database records
|
|
in: body
|
|
name: DatabaseRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/DatabaseRequest"
|
|
databaseIdQuery:
|
|
description: Taxnexus Record Id of a Database
|
|
in: query
|
|
name: databaseId
|
|
required: false
|
|
type: string
|
|
emailQuery:
|
|
description: Email address used for identity lookup
|
|
in: query
|
|
name: email
|
|
required: false
|
|
type: string
|
|
industryIdQuery:
|
|
description: Taxnexus Industry record ID
|
|
in: query
|
|
name: industryId
|
|
required: false
|
|
type: string
|
|
industryProductIdQuery:
|
|
description: Taxnexus IndustryProduct record ID
|
|
in: query
|
|
name: industryProductId
|
|
required: false
|
|
type: string
|
|
industryRequest:
|
|
description: An array of new Industry records
|
|
in: body
|
|
name: industryRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/IndustryRequest"
|
|
industryProductRequest:
|
|
description: An array of new Industry records
|
|
in: body
|
|
name: industryRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/IndustryProductRequest"
|
|
limitQuery:
|
|
description: "How many objects to return at one time"
|
|
format: int64
|
|
in: query
|
|
name: limit
|
|
required: false
|
|
type: integer
|
|
nameQuery:
|
|
description: The Name of this Object
|
|
in: query
|
|
name: name
|
|
required: false
|
|
type: string
|
|
offsetQuery:
|
|
description: How many objects to skip?
|
|
format: int64
|
|
in: query
|
|
name: offset
|
|
required: false
|
|
type: integer
|
|
roleIdQuery:
|
|
description: Taxnexus Id of the Role to be retrieved
|
|
in: query
|
|
name: roleId
|
|
required: false
|
|
type: string
|
|
templateIdQuery:
|
|
description: Taxnexus Record Id of a Template
|
|
in: query
|
|
name: templateId
|
|
required: false
|
|
type: string
|
|
tenantIdQuery:
|
|
description: Taxnexus Record Id of a Tenant
|
|
in: query
|
|
name: tenantId
|
|
required: false
|
|
type: string
|
|
tenantRequest:
|
|
description: An array of Tenant records
|
|
in: body
|
|
name: CTenantRequest
|
|
required: true
|
|
schema:
|
|
$ref: "#/definitions/TenantRequest"
|
|
userIdQuery:
|
|
description: Taxnexus Id of the User to be retrieved
|
|
in: query
|
|
name: userId
|
|
required: false
|
|
type: string
|
|
responses:
|
|
AccessForbidden:
|
|
description: "Access forbidden, account lacks access"
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/Error"
|
|
AccountResponse:
|
|
description: Taxnexus Response with Account objects with Contacts
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
Cache-Control:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/AccountResponse"
|
|
AssetResponse:
|
|
description: Taxnexus Response with Asset objects with Contacts
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
Cache-Control:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/AssetResponse"
|
|
ClusterResponse:
|
|
description: Taxnexus Response with Cluster objects
|
|
schema:
|
|
$ref: "#/definitions/ClusterResponse"
|
|
ContactResponse:
|
|
description: Taxnexus Response with Contact objects
|
|
schema:
|
|
$ref: "#/definitions/ContactResponse"
|
|
IndustryResponse:
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
Cache-Control:
|
|
type: string
|
|
description: Taxnexus Response with Industry objects
|
|
schema:
|
|
$ref: "#/definitions/IndustryResponse"
|
|
IndustryProductResponse:
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
Cache-Control:
|
|
type: string
|
|
description: Taxnexus Response with Industry objects
|
|
schema:
|
|
$ref: "#/definitions/IndustryProductResponse"
|
|
ContractResponse:
|
|
description: Taxnexus Response with an array of Contract objects
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
Cache-Control:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/ContractResponse"
|
|
CompanyProductResponse:
|
|
description: Taxnexus Response with an array of CompanyProduct objects
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
Cache-Control:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/CompanyProductResponse"
|
|
DatabaseResponse:
|
|
description: Taxnexus Response with Database objects
|
|
schema:
|
|
$ref: "#/definitions/DatabaseResponse"
|
|
DeleteResponse:
|
|
description: Taxnexus Response with Message Objects with Delete Status
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/DeleteResponse"
|
|
InvalidDataError:
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
description: Invalid data was sent
|
|
schema:
|
|
$ref: "#/definitions/InvalidError"
|
|
NotFound:
|
|
description: Resource was not found
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/Error"
|
|
RoleResponse:
|
|
description: Taxnexus Response with Role objects
|
|
schema:
|
|
$ref: "#/definitions/RoleResponse"
|
|
ServerError:
|
|
description: Server Internal Error
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/Error"
|
|
TemplateResponse:
|
|
description: Taxnexus Response with Template objects
|
|
schema:
|
|
$ref: "#/definitions/TemplateResponse"
|
|
TenantResponse:
|
|
description: Taxnexus Response with Tenant objects
|
|
schema:
|
|
$ref: "#/definitions/TenantResponse"
|
|
Unauthorized:
|
|
description: "Access unauthorized, invalid API-KEY was used"
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/Error"
|
|
UnprocessableEntity:
|
|
description: "Unprocessable Entity, likely a bad parameter"
|
|
headers:
|
|
Access-Control-Allow-Origin:
|
|
type: string
|
|
schema:
|
|
$ref: "#/definitions/Error"
|
|
UserResponse:
|
|
description: Taxnexus Response with User objects
|
|
schema:
|
|
$ref: "#/definitions/UserResponse"
|
|
paths:
|
|
/accounts:
|
|
delete:
|
|
description: Delete Taxnexus Account record
|
|
operationId: deleteAccount
|
|
parameters:
|
|
- $ref: "#/parameters/accountIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/DeleteResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Delete An Account
|
|
tags:
|
|
- Accounts
|
|
get:
|
|
description: Return a list of all available Accounts
|
|
operationId: getAccounts
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/nameQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/accountIdQuery"
|
|
- $ref: "#/parameters/emailQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/AccountResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list of accounts
|
|
tags:
|
|
- Accounts
|
|
post:
|
|
description: Account record to be added
|
|
operationId: postAccounts
|
|
parameters:
|
|
- $ref: "#/parameters/accountRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/AccountResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new account to Taxnexus
|
|
tags:
|
|
- Accounts
|
|
put:
|
|
description: Update a single account specified by accountId
|
|
operationId: putAccount
|
|
parameters:
|
|
- $ref: "#/parameters/accountRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/AccountResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Update a single account
|
|
tags:
|
|
- Accounts
|
|
/assets:
|
|
get:
|
|
description: Return a list of all available Assets
|
|
operationId: getAssets
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/assetIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/AssetResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list of assets
|
|
tags:
|
|
- Assets
|
|
post:
|
|
description: Industry record to be added
|
|
operationId: postAssets
|
|
parameters:
|
|
- $ref: "#/parameters/assetRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/AssetResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new asset to Taxnexus
|
|
tags:
|
|
- Assets
|
|
/clusters:
|
|
get:
|
|
description: Return a list of Cluster records from the datastore
|
|
operationId: getClusters
|
|
parameters:
|
|
- $ref: "#/parameters/clusterIdQuery"
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ClusterResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list Clusters
|
|
tags:
|
|
- Clusters
|
|
post:
|
|
description: Create Clusters in Taxnexus
|
|
operationId: postClusters
|
|
parameters:
|
|
- $ref: "#/parameters/clusterRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ClusterResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Create new Clusters
|
|
tags:
|
|
- Clusters
|
|
put:
|
|
description: Update Cluster in Taxnexus
|
|
operationId: putClusters
|
|
parameters:
|
|
- $ref: "#/parameters/clusterRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ClusterResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Update Clusters
|
|
tags:
|
|
- Clusters
|
|
/companyproducts:
|
|
get:
|
|
description: Return a list of all available CompanyProducts
|
|
operationId: getCompanyProducts
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/companyProductIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/CompanyProductResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list of companyproducts
|
|
tags:
|
|
- CompanyProducts
|
|
post:
|
|
description: Industry record to be added
|
|
operationId: postCompanyProducts
|
|
parameters:
|
|
- $ref: "#/parameters/companyProductRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/CompanyProductResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new companyproduct to Taxnexus
|
|
tags:
|
|
- CompanyProducts
|
|
/contacts:
|
|
get:
|
|
description: Retrieve Contact records from the datastore
|
|
operationId: getContacts
|
|
parameters:
|
|
- $ref: "#/parameters/contactIdQuery"
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/nameQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/accountIdQuery"
|
|
- $ref: "#/parameters/emailQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ContactResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a Contact record
|
|
tags:
|
|
- Contacts
|
|
post:
|
|
description: Contacts record to be added
|
|
operationId: postContacts
|
|
parameters:
|
|
- $ref: "#/parameters/contactRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ContactResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new Contacts to Taxnexus
|
|
tags:
|
|
- Contacts
|
|
/contracts:
|
|
get:
|
|
description: Return a list of all available Contracts
|
|
operationId: getContracts
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/contractIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ContractResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list of contracts
|
|
tags:
|
|
- Contracts
|
|
post:
|
|
description: Contract record to be added
|
|
operationId: postContracts
|
|
parameters:
|
|
- $ref: "#/parameters/contractRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/ContractResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new contract to Taxnexus
|
|
tags:
|
|
- Contracts
|
|
/industryproducts:
|
|
get:
|
|
description: Return a list of all available IndustryProducts
|
|
operationId: getIndustryProducts
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/industryProductIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/IndustryProductResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list of industryproducts
|
|
tags:
|
|
- Industryproducts
|
|
post:
|
|
description: Industry record to be added
|
|
operationId: postIndustryproducts
|
|
parameters:
|
|
- $ref: "#/parameters/industryProductRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/IndustryProductResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new industryproduct to Taxnexus
|
|
tags:
|
|
- IndustryProducts
|
|
/industries:
|
|
get:
|
|
description: Return a list of all available Industries
|
|
operationId: getIndustries
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/industryIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/IndustryResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Get a list of industries
|
|
tags:
|
|
- Industries
|
|
post:
|
|
description: Industry record to be added
|
|
operationId: postIndustries
|
|
parameters:
|
|
- $ref: "#/parameters/industryRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/IndustryResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
security:
|
|
- ApiKeyAuth: []
|
|
summary: Add a new industry to Taxnexus
|
|
tags:
|
|
- Industries
|
|
/roles:
|
|
get:
|
|
description: Return a list of Roles
|
|
operationId: getRoles
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/roleIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/RoleResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Get a list of Roles
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Roles
|
|
/templates:
|
|
get:
|
|
description:
|
|
"Returns the PDF rendering template, or a link to where to get
|
|
the template"
|
|
operationId: getTemplates
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/templateIdQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/TemplateResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Get PDF Rendering Templates
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Templates
|
|
/tenants:
|
|
get:
|
|
description: Return a list of Tenant records from the datastore
|
|
operationId: getTenants
|
|
parameters:
|
|
- $ref: "#/parameters/tenantIdQuery"
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/TenantResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Get a list Tenants
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Tenants
|
|
post:
|
|
description: Create Tenants in Taxnexus
|
|
operationId: Tenants
|
|
parameters:
|
|
- $ref: "#/parameters/tenantRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/TenantResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Create new Tenants
|
|
tags:
|
|
- Tenants
|
|
put:
|
|
description: Update Tenant in Taxnexus
|
|
operationId: putTenants
|
|
parameters:
|
|
- $ref: "#/parameters/tenantRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/TenantResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Update Tenants
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Tenants
|
|
/databases:
|
|
get:
|
|
description: Return a list of Database records from the datastore
|
|
operationId: getDatabases
|
|
parameters:
|
|
- $ref: "#/parameters/databaseIdQuery"
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/DatabaseResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Get a list Databases
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Databases
|
|
post:
|
|
description: Create Databases in Taxnexus
|
|
operationId: postDatabases
|
|
parameters:
|
|
- $ref: "#/parameters/databaseRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/DatabaseResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Create new Databases
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Databases
|
|
put:
|
|
description: Update Database in Taxnexus
|
|
operationId: putDatabases
|
|
parameters:
|
|
- $ref: "#/parameters/databaseRequest"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/DatabaseResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Update Databases
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Databases
|
|
/users:
|
|
get:
|
|
description: Return a list of User records from the datastore
|
|
operationId: getUsers
|
|
parameters:
|
|
- $ref: "#/parameters/limitQuery"
|
|
- $ref: "#/parameters/offsetQuery"
|
|
- $ref: "#/parameters/userIdQuery"
|
|
- $ref: "#/parameters/activeQuery"
|
|
- $ref: "#/parameters/apiKeyQuery"
|
|
responses:
|
|
"200":
|
|
$ref: "#/responses/UserResponse"
|
|
"401":
|
|
$ref: "#/responses/Unauthorized"
|
|
"403":
|
|
$ref: "#/responses/AccessForbidden"
|
|
"404":
|
|
$ref: "#/responses/NotFound"
|
|
"422":
|
|
$ref: "#/responses/UnprocessableEntity"
|
|
"500":
|
|
$ref: "#/responses/ServerError"
|
|
summary: Get a list Users
|
|
security:
|
|
- ApiKeyAuth: []
|
|
tags:
|
|
- Users
|
|
definitions:
|
|
Account:
|
|
properties:
|
|
TenantID:
|
|
description: tenant identifier
|
|
type: string
|
|
ID:
|
|
description: Taxnexus Account Id
|
|
type: string
|
|
AccountNumber:
|
|
description: Account Number
|
|
type: string
|
|
AccountSource:
|
|
description: The marketing orgin of this account
|
|
type: string
|
|
AnnualRevenue:
|
|
description: Annual Revenue Estimate
|
|
format: double
|
|
type: number
|
|
BillingAddress:
|
|
$ref: "#/definitions/Address"
|
|
BillingContactID:
|
|
description: Contact ID
|
|
type: string
|
|
CreatedByID:
|
|
description: Created By User ID
|
|
type: string
|
|
CreatedDate:
|
|
description: Created Date
|
|
type: string
|
|
CloseDate:
|
|
description: Date company closed
|
|
type: string
|
|
CloudRevenueTotal:
|
|
type: number
|
|
CloudType:
|
|
type: string
|
|
CloudYear:
|
|
type: string
|
|
CrunchbaseURL:
|
|
type: string
|
|
Description:
|
|
description: Description
|
|
type: string
|
|
EarningsCall:
|
|
type: string
|
|
Email:
|
|
description: Main Account Email
|
|
type: string
|
|
EquityFunding:
|
|
type: number
|
|
Fax:
|
|
description: Fax
|
|
type: string
|
|
FoundedDate:
|
|
type: string
|
|
Industry:
|
|
description: Industry
|
|
type: string
|
|
Facebook:
|
|
type: string
|
|
Industries:
|
|
type: string
|
|
IPODate:
|
|
type: string
|
|
LastModifiedByID:
|
|
description: Last Modified By User ID
|
|
type: string
|
|
LastModifiedDate:
|
|
description: Last Modified Date
|
|
type: string
|
|
LinkedIn:
|
|
type: string
|
|
Location:
|
|
type: string
|
|
MarketCapitalization:
|
|
type: number
|
|
Name:
|
|
description: Account Name
|
|
type: string
|
|
NumberOfEmployees:
|
|
description: Employee Count Estimate
|
|
type: number
|
|
format: int64
|
|
NumberInvestments:
|
|
description: Number of Locations Estimate
|
|
type: number
|
|
format: int64
|
|
OwnerID:
|
|
description: Account Owner User ID
|
|
type: string
|
|
Ownership:
|
|
description: Ownership
|
|
type: string
|
|
ParentID:
|
|
description: Parent Account
|
|
type: string
|
|
Phone:
|
|
description: Phone
|
|
type: string
|
|
Publish:
|
|
type: boolean
|
|
SalesforceFirst:
|
|
type: boolean
|
|
ShippingAddress:
|
|
$ref: "#/definitions/Address"
|
|
ShippingContactID:
|
|
type: string
|
|
SIC:
|
|
description: SIC Code
|
|
type: string
|
|
SICDesc:
|
|
description: SIC Description
|
|
type: string
|
|
Site:
|
|
description: Account Site
|
|
type: string
|
|
TagLine:
|
|
type: string
|
|
TickerSymbol:
|
|
type: string
|
|
Type:
|
|
description: Type
|
|
type: string
|
|
Twitter:
|
|
type: string
|
|
Website:
|
|
description: Website
|
|
type: string
|
|
YearStarted:
|
|
description: Year Started
|
|
type: string
|
|
type: object
|
|
AccountRequest:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Account"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
type: object
|
|
AccountResponse:
|
|
description: An array of Account objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Account"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Address:
|
|
properties:
|
|
city:
|
|
description: City
|
|
type: string
|
|
country:
|
|
description: Country full name
|
|
type: string
|
|
countrycode:
|
|
description: Country Code
|
|
type: string
|
|
postalcode:
|
|
description: Postal Code
|
|
type: string
|
|
state:
|
|
description: State full name
|
|
type: string
|
|
statecode:
|
|
description: State Code
|
|
type: string
|
|
street:
|
|
description: Street number and name
|
|
type: string
|
|
required:
|
|
- city
|
|
- statecode
|
|
type: object
|
|
CompanyProduct:
|
|
description: A software product or service vended by a Company
|
|
type: object
|
|
properties:
|
|
ID:
|
|
description: Taxnexus Record Id
|
|
type: string
|
|
CreatedByID:
|
|
description: Created By User ID
|
|
type: string
|
|
CreatedDate:
|
|
description: Created Date
|
|
type: string
|
|
LastModifiedByID:
|
|
description: Last Modified By User ID
|
|
type: string
|
|
LastModifiedDate:
|
|
description: Last Modified Date
|
|
type: string
|
|
AccountID:
|
|
description: Taxnexus ID of the Company that owns this Product
|
|
type: string
|
|
Description:
|
|
description: Description of product
|
|
type: string
|
|
Name:
|
|
description: Product Name
|
|
type: string
|
|
TagLine:
|
|
description: TagLine
|
|
type: string
|
|
URL:
|
|
description: Website
|
|
type: string
|
|
Asset:
|
|
properties:
|
|
ID:
|
|
type: string
|
|
description: Taxnexus Record Id
|
|
AccountID:
|
|
type: string
|
|
description: Account
|
|
Address:
|
|
$ref: "#/definitions/Address"
|
|
AssetLevel:
|
|
type: number
|
|
description: Asset Level
|
|
Name:
|
|
type: string
|
|
description: Asset Name
|
|
AssetProvidedByID:
|
|
type: string
|
|
description: Asset Provided By
|
|
AssetServicedByID:
|
|
type: string
|
|
description: Asset Serviced By
|
|
CompanyProductID:
|
|
type: string
|
|
description: Company Product
|
|
IsCompetitorProduct:
|
|
type: boolean
|
|
description: Competitor Asset
|
|
ConsequenceOfFailure:
|
|
type: string
|
|
description: Consequence Of Failure
|
|
ContactID:
|
|
type: string
|
|
description: Contact
|
|
CreatedByID:
|
|
type: string
|
|
description: Created By
|
|
CreatedDate:
|
|
type: string
|
|
description: Created Date
|
|
CurrentAmount:
|
|
type: number
|
|
description: Current Amount
|
|
CurrentLifecycleEndDate:
|
|
type: string
|
|
description: Current Lifecycle End Date
|
|
CurrentMrr:
|
|
type: number
|
|
description: Current Monthly Recurring Revenue
|
|
CurrentQuantity:
|
|
type: number
|
|
description: Current Quantity
|
|
Description:
|
|
type: string
|
|
description: Description
|
|
DigitalAssetStatus:
|
|
type: string
|
|
description: Digital Asset Status
|
|
ExternalIdentifier:
|
|
type: string
|
|
description: External Id
|
|
HasLifecycleManagement:
|
|
type: boolean
|
|
description: Has Lifecycle Management
|
|
InstallDate:
|
|
type: string
|
|
description: Install Date
|
|
IsInternal:
|
|
type: boolean
|
|
description: Internal Asset
|
|
LastModifiedByID:
|
|
type: string
|
|
description: Last Modified By
|
|
LastModifiedDate:
|
|
type: string
|
|
description: Last Modified Date
|
|
LocationID:
|
|
type: string
|
|
description: Location
|
|
ManufactureDate:
|
|
type: string
|
|
description: Manufacture Date
|
|
MIMEType:
|
|
type: string
|
|
description: MIME Type
|
|
ParentID:
|
|
type: string
|
|
description: Parent Asset
|
|
Price:
|
|
type: number
|
|
description: Price
|
|
Product2ID:
|
|
type: string
|
|
description: Product
|
|
ProductCode:
|
|
type: string
|
|
description: Product Code
|
|
ProductDescription:
|
|
type: string
|
|
description: Product Description
|
|
ProductFamily:
|
|
type: string
|
|
description: Product Family
|
|
StockKeepingUnit:
|
|
type: string
|
|
description: Product SKU
|
|
PurchaseDate:
|
|
type: string
|
|
description: Purchase Date
|
|
Quantity:
|
|
type: number
|
|
description: Quantity
|
|
RootAssetID:
|
|
type: string
|
|
description: Root Asset
|
|
SerialNumber:
|
|
type: string
|
|
description: Serial Number
|
|
Status:
|
|
type: string
|
|
description: Status
|
|
StatusReason:
|
|
type: string
|
|
description: Status Reason
|
|
TenantID:
|
|
type: string
|
|
description: Tenant ID
|
|
TotalLifecycleAmount:
|
|
type: number
|
|
description: Total Lifecycle Amount
|
|
Type:
|
|
type: string
|
|
description: Type
|
|
UUID:
|
|
type: string
|
|
description: Unique Identifier
|
|
URL:
|
|
type: string
|
|
description: URL
|
|
UsageEndDate:
|
|
type: string
|
|
description: Usage End Date
|
|
type: object
|
|
AssetRequest:
|
|
description: An array of Asset objects with Contacts
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Asset"
|
|
type: array
|
|
type: object
|
|
AssetResponse:
|
|
description: An array of Asset objects with Contacts
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Asset"
|
|
type: array
|
|
Meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Cluster:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: Taxnexus Record Id
|
|
name:
|
|
type: string
|
|
description: Cluster Name
|
|
createdbyid:
|
|
type: string
|
|
description: Created By
|
|
createddate:
|
|
type: string
|
|
description: Created Date
|
|
description:
|
|
type: string
|
|
description: Description
|
|
environment:
|
|
type: string
|
|
description: Environment
|
|
ref:
|
|
type: string
|
|
description: External Reference
|
|
gateway:
|
|
type: string
|
|
description: Gateway
|
|
ip_address:
|
|
type: string
|
|
description: IP Address
|
|
lastmodifiedbyid:
|
|
type: string
|
|
description: Last Modified By
|
|
lastmodifieddate:
|
|
type: string
|
|
description: Last Modified Date
|
|
ownerid:
|
|
type: string
|
|
description: Owner
|
|
status:
|
|
type: string
|
|
description: Status
|
|
subnet:
|
|
type: string
|
|
description: Subnet
|
|
tenantid:
|
|
type: string
|
|
description: tenantid
|
|
type:
|
|
type: string
|
|
description: Type
|
|
zone:
|
|
type: string
|
|
description: Zone
|
|
ClusterRequest:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Cluster"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
required:
|
|
- meta
|
|
- data
|
|
type: object
|
|
ClusterResponse:
|
|
description: An array of cluster objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Cluster"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Contact:
|
|
properties:
|
|
TenantID:
|
|
description: tenant identifier
|
|
type: string
|
|
ID:
|
|
description: Taxnexus Record Id
|
|
type: string
|
|
AccountID:
|
|
description: The primary account ID of this contact
|
|
type: string
|
|
AssistantName:
|
|
description: Assistant Name
|
|
type: string
|
|
AssistantPhone:
|
|
description: Asst. Phone
|
|
type: string
|
|
BirthDate:
|
|
description: Birthdate
|
|
type: string
|
|
CreatedByID:
|
|
description: Created By User ID
|
|
type: string
|
|
CreatedDate:
|
|
description: Created Date
|
|
type: string
|
|
Department:
|
|
description: Department
|
|
type: string
|
|
Description:
|
|
description: Description
|
|
type: string
|
|
DoNotCall:
|
|
description: Do Not Call?
|
|
type: boolean
|
|
Email:
|
|
description: Email address
|
|
type: string
|
|
EmailBounceDate:
|
|
description: Email Bounce Date
|
|
type: string
|
|
EmailBounceReason:
|
|
description: Email Bounce Reason
|
|
type: string
|
|
Fax:
|
|
type: string
|
|
Facebook:
|
|
description: Fax Number
|
|
type: string
|
|
FirstName:
|
|
description: First Name
|
|
type: string
|
|
HasOptedOutOfEmail:
|
|
description: Email Opt Out
|
|
type: boolean
|
|
HasOptedOutOfFax:
|
|
description: Fax Opt Out
|
|
type: boolean
|
|
HomePhone:
|
|
description: Home Phone
|
|
type: string
|
|
IsEmailBounced:
|
|
description: Does this contact have bounced emails?
|
|
type: boolean
|
|
LastModifiedByID:
|
|
description: Last Modified By User ID
|
|
type: string
|
|
LastModifiedDate:
|
|
description: Last Modified Date
|
|
type: string
|
|
LastName:
|
|
description: Last Name
|
|
type: string
|
|
LeadSource:
|
|
description: Lead Source
|
|
type: string
|
|
LinkedIn:
|
|
description: LinkedIn Page
|
|
type: string
|
|
MailingAddress:
|
|
$ref: "#/definitions/Address"
|
|
MobilePhone:
|
|
description: Mobile Phone
|
|
type: string
|
|
Name:
|
|
description: Full Name
|
|
type: string
|
|
OtherAddress:
|
|
$ref: "#/definitions/Address"
|
|
OtherPhone:
|
|
description: Other Phone
|
|
type: string
|
|
OwnerID:
|
|
description: The User ID of the user who owns this Contact
|
|
type: string
|
|
PersonalEmail:
|
|
description: Personal Email Address for this Contact
|
|
type: string
|
|
Phone:
|
|
description: Phone Number
|
|
type: string
|
|
PhotoURL:
|
|
description: URL of a photograph of this User
|
|
type: string
|
|
Title:
|
|
description: Contact Title
|
|
type: string
|
|
Twitter:
|
|
type: string
|
|
type: object
|
|
CompanyProductRequest:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/CompanyProduct"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
required:
|
|
- meta
|
|
- data
|
|
type: object
|
|
CompanyProductResponse:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/CompanyProduct"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
ContactRequest:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Contact"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
required:
|
|
- meta
|
|
- data
|
|
type: object
|
|
ContactResponse:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Contact"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Contract:
|
|
type: object
|
|
properties:
|
|
AccountID:
|
|
description: Account
|
|
type: string
|
|
ActivatedByID:
|
|
description: Activated By
|
|
type: string
|
|
ActivatedDate:
|
|
description: Activated Date
|
|
type: string
|
|
BillingAddress:
|
|
$ref: "#/definitions/Address"
|
|
description: Billing Address
|
|
BillingContactID:
|
|
description: Billing Contact
|
|
type: string
|
|
CompanySignedDate:
|
|
description: Company Signed Date
|
|
type: string
|
|
CompanySignedID:
|
|
description: Company Signed By
|
|
type: string
|
|
ContractNumber:
|
|
description: Contract Number
|
|
type: string
|
|
ContractTerm:
|
|
description: Contract Term (months)
|
|
type: number
|
|
CreatedByID:
|
|
description: Created By User ID
|
|
type: string
|
|
CreatedDate:
|
|
description: Created Date
|
|
type: string
|
|
CustomerSignedDate:
|
|
description: Customer Signed Date
|
|
type: string
|
|
CustomerSignedID:
|
|
description: Customer Signed By
|
|
type: string
|
|
CustomerSignedTitle:
|
|
description: Customer Signed Title
|
|
type: string
|
|
DefaultEndUserID:
|
|
description: End User
|
|
type: string
|
|
Description:
|
|
description: Description
|
|
type: string
|
|
EndDate:
|
|
description: Contract End Date
|
|
type: string
|
|
HourlyRate:
|
|
description: Hourly Rate
|
|
type: number
|
|
ID:
|
|
description: Telnexus Record Id
|
|
type: string
|
|
LastModifiedByID:
|
|
description: Last Modified By User ID
|
|
type: string
|
|
LastModifiedDate:
|
|
description: Last Modified Date
|
|
type: string
|
|
Name:
|
|
description: Contract Name
|
|
type: string
|
|
PaymentMethodID:
|
|
description: Payment Method
|
|
type: string
|
|
PaymentTerms:
|
|
description: Payment Terms
|
|
type: string
|
|
Perpetual:
|
|
description: Perpetual Agreement?
|
|
type: boolean
|
|
ShippingAddress:
|
|
$ref: "#/definitions/Address"
|
|
description: Shipping Address
|
|
ShippingContactID:
|
|
description: Shipping Contact
|
|
type: string
|
|
StartDate:
|
|
description: Contract Start Date
|
|
type: string
|
|
Status:
|
|
description: Status
|
|
type: string
|
|
TenantID:
|
|
description: Tenant Identifier
|
|
type: string
|
|
ContractRequest:
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Contract"
|
|
type: array
|
|
type: object
|
|
ContractResponse:
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Contract"
|
|
type: array
|
|
Meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Database:
|
|
type: object
|
|
description: A Database provisioned and owned by a Tenant
|
|
properties:
|
|
active:
|
|
description: Is this database active?
|
|
type: boolean
|
|
clusterid:
|
|
description: The ID of the Cluster in which this database is deployed
|
|
type: string
|
|
createdbyid:
|
|
description: Created By
|
|
type: string
|
|
createddate:
|
|
description: Created Date
|
|
type: string
|
|
databasename:
|
|
description: The name of the physical database in the cluster
|
|
type: string
|
|
dsn:
|
|
description: Database connection string
|
|
type: string
|
|
id:
|
|
description: Record Id
|
|
type: string
|
|
lastmodifiedbyid:
|
|
description: Last Modified By
|
|
type: string
|
|
lastmodifieddate:
|
|
description: Last Modifed Date
|
|
type: string
|
|
microservices:
|
|
description: List of Taxnexus microservices implemented by this Database
|
|
type: string
|
|
status:
|
|
description: The current status of this Tenant
|
|
type: string
|
|
tenantid:
|
|
description: The ID of the tenant who owns this Database
|
|
type: string
|
|
type:
|
|
description: "The type of Database (mysql, etc)"
|
|
type: string
|
|
DatabaseRequest:
|
|
description: An array of Database objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Database"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
type: object
|
|
DatabaseResponse:
|
|
description: An array of Database objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Database"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
DeleteResponse:
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Message"
|
|
type: array
|
|
Meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Error:
|
|
properties:
|
|
Code:
|
|
format: int64
|
|
type: integer
|
|
Fields:
|
|
type: string
|
|
Message:
|
|
type: string
|
|
type: object
|
|
IndustryProduct:
|
|
description: Junction object between Industry and CompanyProduct
|
|
type: object
|
|
properties:
|
|
ID:
|
|
description: Taxnexus Record Id
|
|
type: string
|
|
CreatedByID:
|
|
description: Created By User ID
|
|
type: string
|
|
CreatedDate:
|
|
description: Created Date
|
|
type: string
|
|
LastModifiedByID:
|
|
description: Last Modified By User ID
|
|
type: string
|
|
LastModifiedDate:
|
|
description: Last Modified Date
|
|
type: string
|
|
IndustryID:
|
|
type: string
|
|
HTML:
|
|
type: string
|
|
CompanyProductID:
|
|
type: string
|
|
Industry:
|
|
description: An industry that is being researched
|
|
type: object
|
|
properties:
|
|
ID:
|
|
description: Taxnexus Record Id
|
|
type: string
|
|
CreatedByID:
|
|
description: Created By User ID
|
|
type: string
|
|
CreatedDate:
|
|
description: Created Date
|
|
type: string
|
|
LastModifiedByID:
|
|
description: Last Modified By User ID
|
|
type: string
|
|
LastModifiedDate:
|
|
description: Last Modified Date
|
|
type: string
|
|
Name:
|
|
description: Industry Name
|
|
type: string
|
|
Description:
|
|
description: Industry Description
|
|
type: string
|
|
ParentIndustryID:
|
|
description: The ID of the Parent Industry
|
|
type: string
|
|
Level:
|
|
description: The hierarchical level of this Industry
|
|
type: string
|
|
Path:
|
|
description: The full path of this industry, including Parent
|
|
type: string
|
|
Slug:
|
|
description: The CMS Slug for this Industry
|
|
type: string
|
|
SiteURL:
|
|
description: The URL of the corresponding page on the CMS
|
|
type: string
|
|
IndustryRequest:
|
|
description: An array of Industry objects submitted for processing
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Industry"
|
|
type: array
|
|
type: object
|
|
IndustryResponse:
|
|
description: An array of Industry objects produced in response to a request
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/Industry"
|
|
type: array
|
|
Meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
IndustryProductRequest:
|
|
description: An array of IndustryProduct objects submitted for processing
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/IndustryProduct"
|
|
type: array
|
|
type: object
|
|
IndustryProductResponse:
|
|
description: An array of IndustryProduct objects produced in response to a request
|
|
properties:
|
|
Data:
|
|
items:
|
|
$ref: "#/definitions/IndustryProduct"
|
|
type: array
|
|
Meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
InvalidError:
|
|
allOf:
|
|
- $ref: "#/definitions/Error"
|
|
- properties:
|
|
details:
|
|
items:
|
|
type: string
|
|
type: array
|
|
type: object
|
|
Message:
|
|
properties:
|
|
message:
|
|
type: string
|
|
ref:
|
|
type: string
|
|
status:
|
|
format: int64
|
|
type: number
|
|
type: object
|
|
Pagination:
|
|
properties:
|
|
limit:
|
|
format: int64
|
|
type: number
|
|
pagesize:
|
|
format: int64
|
|
type: number
|
|
poffset:
|
|
format: int64
|
|
type: integer
|
|
setsize:
|
|
format: int64
|
|
type: number
|
|
type: object
|
|
RequestMeta:
|
|
properties:
|
|
TaxnexusAccount:
|
|
description: Taxnexus Account Number of the Reseller or OEM
|
|
type: string
|
|
required:
|
|
- TaxnexusAccount
|
|
type: object
|
|
ResponseMeta:
|
|
properties:
|
|
Contact:
|
|
description: Microservice Contact Info
|
|
type: string
|
|
Copyright:
|
|
description: Copyright Info
|
|
type: string
|
|
License:
|
|
description: License Information and Restrictions
|
|
type: string
|
|
OperationID:
|
|
description: Operation ID
|
|
type: string
|
|
Pagination:
|
|
$ref: "#/definitions/Pagination"
|
|
RequestIP:
|
|
description: Request IP Address
|
|
type: string
|
|
RequestType:
|
|
description: Request Type
|
|
type: string
|
|
RequestURL:
|
|
description: Request URL
|
|
type: string
|
|
ServerInfo:
|
|
description: Data Server Info
|
|
type: string
|
|
ServerResponseTime:
|
|
description: Data Server Response Time (ms)
|
|
type: string
|
|
ServerTimestamp:
|
|
description: Backend Server Timestamp
|
|
type: string
|
|
TaxnexusAccount:
|
|
description: Taxnexus Account Number used for recording transactions
|
|
type: string
|
|
type: object
|
|
TenantRequest:
|
|
description: An array of Tenant objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Tenant"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
type: object
|
|
TenantResponse:
|
|
description: An array of Tenant objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Tenant"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
TenantUser:
|
|
description: Relationship object that connects users to a tenant
|
|
type: object
|
|
properties:
|
|
accesslevel:
|
|
type: string
|
|
description: The Tenant access level for this User
|
|
tenantid:
|
|
type: string
|
|
description: The Tenant ID
|
|
userid:
|
|
type: string
|
|
description: The User ID
|
|
Role:
|
|
type: object
|
|
description: A functional role within a Tenant
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: record id
|
|
auth0roleid:
|
|
description: the corresponding auth0 role
|
|
type: string
|
|
createdbyid:
|
|
type: string
|
|
description: created by
|
|
createddate:
|
|
type: string
|
|
description: created date
|
|
description:
|
|
type: string
|
|
description: role description
|
|
lastmodifiedbyid:
|
|
type: string
|
|
description: last modified by
|
|
lastmodifieddate:
|
|
type: string
|
|
description: last modifed date
|
|
rolename:
|
|
type: string
|
|
description: the name of this role
|
|
tenantid:
|
|
type: string
|
|
description: the id of the tenant that owns this role
|
|
RoleRequest:
|
|
description: An array of Role objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Role"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/RequestMeta"
|
|
type: object
|
|
RoleResponse:
|
|
description: An array of Role objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Role"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Template:
|
|
properties:
|
|
tenantid:
|
|
description: tenant identifier
|
|
type: string
|
|
CompanyID:
|
|
description: Company
|
|
type: string
|
|
CreatedByID:
|
|
type: string
|
|
CreatedDate:
|
|
type: string
|
|
Description:
|
|
description: Description
|
|
type: string
|
|
HTML:
|
|
description: HTML Body
|
|
type: string
|
|
format: byte
|
|
ID:
|
|
description: Taxnexus Record Id
|
|
type: string
|
|
IsActive:
|
|
description: Active?
|
|
type: boolean
|
|
IsMaster:
|
|
description: Master Template?
|
|
type: boolean
|
|
LastModifiedByID:
|
|
type: string
|
|
LastModifiedDate:
|
|
type: string
|
|
Name:
|
|
description: Template Name
|
|
type: string
|
|
ObjectType:
|
|
description: Object
|
|
type: string
|
|
RecordTypeName:
|
|
description: Record Type Name
|
|
type: string
|
|
Type:
|
|
description: Type
|
|
type: string
|
|
URL:
|
|
description: URL
|
|
type: string
|
|
type: object
|
|
TemplateResponse:
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/Template"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
Tenant:
|
|
type: object
|
|
description: Taxnexus Account Tenant
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: Record Id
|
|
accountid:
|
|
type: string
|
|
description: The Account that owns this Tenant
|
|
active:
|
|
type: boolean
|
|
description: Is this Tenant currently active?
|
|
createdbyid:
|
|
type: string
|
|
description: Created By
|
|
createddate:
|
|
type: string
|
|
description: Created Date
|
|
lastmodifiedbyid:
|
|
type: string
|
|
description: Last Modified By
|
|
lastmodifieddate:
|
|
type: string
|
|
description: Last Modifed Date
|
|
status:
|
|
type: string
|
|
description: The current status of this Tenant
|
|
tenantname:
|
|
type: string
|
|
description: Name of the Tenant Resource
|
|
type:
|
|
type: string
|
|
description: Type of tenant
|
|
version:
|
|
type: string
|
|
description: The version number of the Tenant Onboarding system used to
|
|
create this tenant
|
|
databases:
|
|
items:
|
|
$ref: "#/definitions/Database"
|
|
type: array
|
|
roles:
|
|
items:
|
|
$ref: "#/definitions/Role"
|
|
type: array
|
|
tenantusers:
|
|
items:
|
|
$ref: "#/definitions/TenantUser"
|
|
type: array
|
|
User:
|
|
properties:
|
|
tenantid:
|
|
type: string
|
|
aboutme:
|
|
description: About Me
|
|
type: string
|
|
accountid:
|
|
description: Account ID
|
|
type: string
|
|
address:
|
|
$ref: "#/definitions/Address"
|
|
alias:
|
|
description: Alias
|
|
type: string
|
|
apikey:
|
|
description: API Key
|
|
type: string
|
|
auth0userid:
|
|
description: Auth0 User ID
|
|
type: string
|
|
communitynickname:
|
|
description: Nickname
|
|
type: string
|
|
companyname:
|
|
description: Company Name
|
|
type: string
|
|
contactid:
|
|
description: Contact
|
|
type: string
|
|
createdbyid:
|
|
description: Created User ID
|
|
type: string
|
|
createddate:
|
|
description: Date Created
|
|
type: string
|
|
delegatedapproverid:
|
|
description: Delegated Approver
|
|
type: string
|
|
department:
|
|
description: Department
|
|
type: string
|
|
division:
|
|
description: Division
|
|
type: string
|
|
email:
|
|
description: Email address
|
|
type: string
|
|
employeenumber:
|
|
description: Employee Number
|
|
type: string
|
|
endday:
|
|
description: Time day ends
|
|
type: string
|
|
environment:
|
|
description: Environment
|
|
type: string
|
|
extension:
|
|
description: Extension
|
|
type: string
|
|
fabricapikey:
|
|
description: Fabric API Key
|
|
type: string
|
|
fax:
|
|
description: Fax
|
|
type: string
|
|
firstname:
|
|
description: The first name
|
|
type: string
|
|
forecastenabled:
|
|
description: Allow Forecasting
|
|
type: boolean
|
|
fullphotourl:
|
|
description: Full Photo URL
|
|
type: string
|
|
id:
|
|
description: Taxnexus ID
|
|
type: string
|
|
isactive:
|
|
description: Active
|
|
type: boolean
|
|
isportalenabled:
|
|
description: Is the user enabled for Communities?
|
|
type: boolean
|
|
isprofilephotoactive:
|
|
description: Has Profile Photo
|
|
type: boolean
|
|
issystemcontrolled:
|
|
type: boolean
|
|
lastip:
|
|
description: ip address of last login
|
|
type: string
|
|
lastlogin:
|
|
description: last login time
|
|
type: string
|
|
lastmodifiedbyid:
|
|
description: Last Modified User ID
|
|
type: string
|
|
lastmodifieddate:
|
|
description: Last Modified Date
|
|
type: string
|
|
lastname:
|
|
description: The Last Name
|
|
type: string
|
|
logincount:
|
|
description: number of times user has logged in
|
|
format: int64
|
|
type: number
|
|
managerid:
|
|
description: Manager
|
|
type: string
|
|
mobilephone:
|
|
description: Mobile
|
|
type: string
|
|
name:
|
|
description: Name
|
|
type: string
|
|
outofofficemessage:
|
|
description: Out of office message
|
|
type: string
|
|
phone:
|
|
description: Phone
|
|
type: string
|
|
portalrole:
|
|
description: Portal Role Level
|
|
type: string
|
|
profileid:
|
|
description: Profile
|
|
type: string
|
|
receivesadmininfoemails:
|
|
description: Admin Info Emails
|
|
type: boolean
|
|
receivesinfoemails:
|
|
description: Info Emails
|
|
type: boolean
|
|
senderemail:
|
|
description: Email Sender Address
|
|
type: string
|
|
sendername:
|
|
description: Email Sender Name
|
|
type: string
|
|
signature:
|
|
description: Email Signature
|
|
type: string
|
|
smallphotourl:
|
|
description: Small Photo URL
|
|
type: string
|
|
startday:
|
|
description: The time day starts
|
|
type: string
|
|
taxnexusaccount:
|
|
description: Taxnexus Account
|
|
type: string
|
|
timezonesidkey:
|
|
description: Time Zone
|
|
type: string
|
|
title:
|
|
description: Title
|
|
type: string
|
|
username:
|
|
description: Username
|
|
type: string
|
|
userroleid:
|
|
description: Role
|
|
type: string
|
|
usertype:
|
|
description: User Type
|
|
type: string
|
|
userroles:
|
|
items:
|
|
$ref: "#/definitions/UserRole"
|
|
type: array
|
|
tenantusers:
|
|
items:
|
|
$ref: "#/definitions/TenantUser"
|
|
type: array
|
|
type: object
|
|
UserResponse:
|
|
description: An array of Print-Ready ingest Objects
|
|
properties:
|
|
data:
|
|
items:
|
|
$ref: "#/definitions/User"
|
|
type: array
|
|
meta:
|
|
$ref: "#/definitions/ResponseMeta"
|
|
type: object
|
|
UserRole:
|
|
description: Relationship object that connects user to a role
|
|
type: object
|
|
properties:
|
|
description:
|
|
type: string
|
|
description: Role description
|
|
roleid:
|
|
type: string
|
|
description: The Role ID
|
|
userid:
|
|
type: string
|
|
description: The User ID
|
|
name:
|
|
type: string
|
|
description: Role Name
|
|
auth0roleid:
|
|
type: string
|
|
description: Linked role ID
|