Upsert Cost Center Code

Summary Description

The Cost Center PUT endpoint is used to either create a new Cost Center resource or replace an existing one within the Paylocity system. This endpoint ensures that the specified Cost Center is accurately recorded or updated, reflecting any changes in organizational structure or financial management practices. Cost Centers are key organizational units or divisions that incur expenses due to their activities. These entities are essential for tracking and managing costs, allocating budgets, and evaluating departmental efficiency. By using the PUT endpoint, organizations can effectively manage their Cost Centers, ensuring that each one is aligned with current business needs and financial objectives.

Key Functionality

  • Creating a New Cost Center: The PUT endpoint allows you to define a new Cost Center, complete with all necessary details such as its Code, description, and associated parameters. This is crucial when establishing new departments or divisions that require separate financial tracking.
  • Replacing an Existing Cost Center: When modifications are needed, the PUT endpoint can replace an existing Cost Center resource. This includes updating information like the Cost Center's description, associated budget, or other critical details, while the Code remains permanent and unchangeable.
  • Resource Management: The PUT endpoint ensures that Cost Centers are accurately reflected in the system, supporting effective cost management and financial reporting.

Note

  • Permanence of Cost Center Codes: Once a Cost Center Code is assigned, it cannot be changed or deleted. The PUT endpoint allows for editing other aspects of the Cost Center but keeps the Code immutable.
  • Code Compatibility: To ensure seamless integration across different systems, Cost Center Codes must be numeric only if employees use time clocks or kiosk tablets. Additionally, these codes should not include leading zeros or special characters.
  • Deactivating a cost center: Employees need to be removed from the cost center before it can be deactivated.
Path Params
string
required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.
Allowable Values:
9 char max

int32
required

The level or rank of the cost center within the organizational hierarchy, indicating its position and importance within the organization's structure.

string
required

A code or label representing the cost center, aiding in its categorization and differentiation within the organization's financial and operational framework.

Body Params

Upsert cost center payload.

Upsert cost center payload.

string
required
length ≥ 1

The name or title of the cost center, offering a clear and descriptive label for easy recognition and understanding of its role and responsibilities.

boolean

An indicator denoting the current status or active state of the cost center, assisting in management and decision-making regarding financial operations and allocation.

Headers
string

Authorization token. Ex. Bearer ...

boolean
Defaults to false

If true all responses are mocked and generated randomly.

string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses
201

Created - Resource has been created.

204

No Content - Resource has been updated.

400

Bad Request - Returns the details of the error.

415

Unsupported Media Type - Returns the details of the error.

Language
LoadingLoading…