Hivebuy

This REST API lets you communicate with Hivebuy from any external source. It requires you have an access token (Bearer) - this token can be obtained within your contact at Hivebuy

Hivebuy API - BETA

GET / CREATE / PATCH Catalogues inside Hivebuy

Catalogues

Get Catalogues

Get Single Catalogue

PATCH Catalogue

Create Catalogue

DELETE Catalogue

GET / CREATE / PATCH Catalogue Items inside Hivebuy

Catalogue Items

Get Catalogue Items

Get Catalogue Items (pagination)

Get Single Catalogue Item

CREATE Catalogue Item

PATCH Catalogue Item

DEACTIVATE Catalogue Item

DELETE Catalogue Item

BULK UPSERT Catalogue Items

GET / CREATE / PATCH Categories inside Hivebuy

GET Categories

GET Category

CREATE Category

PATCH Category

BULK UPSERT Categories

DELETE Category

Company Addresses

GET Company Addresses

GET Company Addresses(Pagination)

GET Company Address

PATCH Company Address

CREATE Company Address

DELETE Company Address

Contracts

GET Contracts

GET Contract

GET Contracts(Pagination)

CREATE Contract

PATCH Contract

DELETE Contract

GET / CREATE / PATCH Departments inside Hivebuy

Departments

Will return all departments for this company, depending on the permissions of the token user

Get Departments

Get Single Department

Get Departments(pagination)

Will create one single department. Only the name is mandatory, the other fields are optional.

legalEntity, members and approvers are UUIDs for the respective users/legalEntity

Create Department

PATCH Department

BULK UPSERT Departments

DELETE Department

GET / CREATE / PATCH Legal Entities inside Hivebuy

Legal Entities

GET Legal Entities

GET Legal Entity

CREATE Legal Entity

PATCH Legal Entitiy

BULK UPSERT Legal Entities

DELETE Legal Entity

GET / CREATE / PATCH Suppliers inside Hivebuy

Projects

GET Projects

GET Project

GET Project(pagination)

CREATE Project

PATCH Project

DELETE Project

Purchase Orders

POST Upload document

GET Purchase Orders

Suppliers

GET Suppliers

GET Suppliers (pagination)

GET Supplier

CREATE Supplier

PATCH Supplier

BULK UPSERT Suppliers

DELETE Supplier

User Sync

This endpoint has a logic:

- Create an invite with the given request body
    
- If that invite already exists -> update the invite
    
- If that invite was already accepted and the user exists -> update the user
    

Will return "200" when successfull

CREATE + UPDATE User

GET User

GET Users

Update Order Status

POST Order Status

Default

Hivebuy API

Documentation of all available endpoints for Hivebuy customers

Production

<p class="slate-p " ></p><p class="slate-p " >This section of the API allows users to interact with Hivebuy from external sources using an access token provided by Hivebuy. With this API, you can seamlessly communicate with Hivebuy and access essential data and functionalities for your projects.</p><p class="slate-p " >Please note that this API documentation is in <strong class="slate-bold">beta status</strong> and may not cover every detail. We are continuously improving it, so if you have any questions, feel free to reach out to us at support@hivebuy.de.</p><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >To create and manage your API Keys, go to the Hivebuy App and navigate to the <a href="https://app.hivebuy.de/api-keys" target="_blank">API Key page</a>.</p></div></div><p class="slate-p " ></p><h2 class="slate-h2 " >General Information</h2><p class="slate-p " ></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">RESTful Architecture</strong> – Designed for simplicity and scalability</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">JSON Responses</strong> – Standardized and easy-to-parse responses</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Authentication &amp; Security</strong> – Secure API calls with a Bearer Token specificly for your company</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Rate Limits</strong> – Fair usage policies to ensure reliability</div></li></ul><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=warning ><div class="callout-icon"><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p " >Please not that Hivebuy does not allow more than 100 requests per minute. </p></div></div><p class="slate-p " ></p><p class="slate-p " >To use this API, you will need to:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Get an API key</strong> – Go to the <a href="https://app.hivebuy.de" target="_blank">Hivebuy App</a> and navigate to <a href="https://app.hivebuy.de/api-keys" target="_blank">Company Management / Api Keys</a>. Create a key for a specific user and copy it.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Authenticate</strong> – Include your API key in each request as a Bearer Token</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Make a Request</strong> – Use our endpoints to interact with the API</div></li></ol><p class="slate-p " ></p>

This section of the API allows users to interact with Hivebuy from external sources using an access token provided by Hivebuy. With this API, you can seamlessly communicate with Hivebuy and access essential data and functionalities for your projects.

Please note that this API documentation is in 

 and may not cover every detail. We are continuously improving it, so if you have any questions, feel free to reach out to us at support@hivebuy.de.

<p class="slate-p " >GET / CREATE / PATCH Catalogues inside Hivebuy</p><p class="slate-p " >Internal catalog master data in Hivebuy is essential for streamlining procurement by providing predefined product selections for users. These catalogs are created by the procurement team and contain items that employees can directly order.</p><p class="slate-p " ><strong class="slate-bold">Key functionalities:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Standardized product selection for efficient and controlled purchasing</div></li><li class="slate-li " ><div style="position:relative">Assignment of catalogs to specific legal entities and departments</div></li><li class="slate-li " ><div style="position:relative">Simplified ordering process for users with predefined products and suppliers</div></li></ul><p class="slate-p " ><strong class="slate-bold">Use cases include:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Providing office supplies, IT equipment, or frequently used materials in a structured catalog</div></li><li class="slate-li " ><div style="position:relative">Ensuring compliance with preferred suppliers and negotiated conditions</div></li><li class="slate-li " ><div style="position:relative">Restricting catalog availability to specific entities or departments for better cost control</div></li></ul><p class="slate-p " ></p><h3 class="slate-h3 " >Field Update: Transition from<strong class="slate-bold">“name”</strong>to<strong class="slate-bold">“names”</strong>(Multi-language Support)</h3><h4 class="slate-h4 " >New</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Replaced “<strong class="slate-bold">name</strong>” field with a &quot;<strong class="slate-bold">names</strong>&quot; object to support multi-language localization.</div></li><li class="slate-li " ><div style="position:relative">Example:</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Old: “name” : “Official Supplies”</div></li><li class="slate-li " ><div style="position:relative">New: &quot;names&quot;: {&quot;en&quot;: &quot;Official Supplies&quot;}</div></li></ul></li><li class="slate-li " ><div style="position:relative">All new implementations should use the <strong class="slate-bold">“names”</strong> object instead.</div></li></ul><h4 class="slate-h4 " >Action Required</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Update your payloads and consumers to use <strong class="slate-bold">“names”</strong> instead of <strong class="slate-bold">“name”.</strong> </div></li></ul><p class="slate-p " ></p>

Internal catalog master data in Hivebuy is essential for streamlining procurement by providing predefined product selections for users. These catalogs are created by the procurement team and contain items that employees can directly order.

<p class="slate-p " >GET / CREATE / PATCH Catalogue Items inside Hivebuy</p><p class="slate-p " >Catalog item master data in Hivebuy is essential for ensuring a structured and efficient procurement process. Catalog items are predefined products or services that users can order directly from internal catalogs managed by the procurement team.</p><h3 class="slate-h3 " >Field Update: Transition from<strong class="slate-bold">“name”</strong>to<strong class="slate-bold">“names”</strong>(Multi-language Support)</h3><h4 class="slate-h4 " >New</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Replaced “<strong class="slate-bold">name</strong>” field with a &quot;<strong class="slate-bold">names</strong>&quot; object to support multi-language localization.</div></li><li class="slate-li " ><div style="position:relative">Example:</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Old: “name” : “Official Supplies”</div></li><li class="slate-li " ><div style="position:relative">New: &quot;names&quot;: {&quot;en&quot;: &quot;Official Supplies&quot;}</div></li></ul></li><li class="slate-li " ><div style="position:relative">All new implementations should use the <strong class="slate-bold">“names”</strong> object instead.</div></li></ul><h4 class="slate-h4 " >Action Required</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Update your payloads and consumers to use <strong class="slate-bold">“names”</strong> instead of <strong class="slate-bold">“name”.</strong> </div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Catalog item master data in Hivebuy is essential for ensuring a structured and efficient procurement process. Catalog items are predefined products or services that users can order directly from internal catalogs managed by the procurement team.

<p class="slate-p " >This section enables users to retrieve a comprehensive list of catalogue items available from suppliers. It provides detailed information about each item and its variants, supporting tasks such as browsing inventory, integrating product data, or building custom catalog displays. <strong class="slate-bold">Note:</strong> Only a limited number of items are returned per request due to default pagination. </p><p class="slate-p " ></p>

This section enables users to retrieve a comprehensive list of catalogue items available from suppliers. It provides detailed information about each item and its variants, supporting tasks such as browsing inventory, integrating product data, or building custom catalog displays. 

 Only a limited number of items are returned per request due to default pagination. 

The authorization token required for accessing the endpoint.

Authorization

page

pageSize

Number of records returned in this response.

totalRecords

totalPages

currentPage

totalDbRecords

results

Specifies which page number of the result set to retrieve.

Defines how many records to return per page.

A search term to filter items by name, description, or other searchable fields. Example: search=Hivebuy returns only items that match this term.

search

Typically used to filter results to a specific catalogue or collection of items. 

catalogues

Number of records returned in this response.



Former field for the item name. Use names instead.

name

Object containing the item name in one or more languages

names

description

article

List of item variant objects that include price, quantity, and specific attributes.

itemVariants

companySupplier

images

contract

createdAt

Date and time when the item was last updated.

updatedAt

Used if the supplier is not part of the system

unlistedSupplier

recurrence

minimalQuantity

Step/increment in which quantities must be ordered.



quantityStep

Indicates if the item is currently active or available.

active

externalArticle

UUID of the category this item is associated with.

List of catalogue UUIDs this item belongs to.

Indicates whether the item is currently active and visible in the catalogue.

shortName

List of catalogue IDs this item belongs to

Recurrence rule or cycle (if applicable).



Indicates whether the item is active and orderable.



General description of the item (may be empty)

Recurrence rule or cycle (if applicable).

{id}

List of keywords or labels assigned to the item for search and filtering purposes.--------

Timestamp indicating when the item was originally created in the system

Timestamp indicating the most recent update to the item’s information

The minimum quantity required to purchase or order the item

The increment step for quantity adjustments when ordering the item.

Boolean indicating whether the item is currently active and available for orders.

External reference or identifier linking the item to an external catalog or system

item_variants

type

errors

<p class="slate-p " >The <strong class="slate-bold">Bulk Upsert</strong> operation enables inserting or updating multiple catalogue item records in a single request.</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">If a catalogue item already exists, it will be <strong class="slate-bold">updated</strong> with the new data. </div></li><li class="slate-li " ><div style="position:relative">If the catalogue item does not exist, it will be <strong class="slate-bold">inserted</strong> as a new record.</div></li></ul><p class="slate-p " ></p>

 operation enables inserting or updating multiple catalogue item records in a single request.

<p class="slate-p " >Product category master data in Hivebuy is essential for structuring procurement processes and enhancing reporting. Product categories serve as an additional classification method alongside cost centers and projects, enabling better spend analysis and control.</p><p class="slate-p " ><strong class="slate-bold">Key functionalities:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Grouping of similar products and services for streamlined purchasing</div></li><li class="slate-li " ><div style="position:relative">Improved spend visibility and reporting across different categories</div></li><li class="slate-li " ><div style="position:relative">Better supplier management by aligning purchases with relevant product groups</div></li></ul><p class="slate-p " ><strong class="slate-bold">Use cases include:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Categorizing office supplies, IT equipment, or production materials</div></li><li class="slate-li " ><div style="position:relative">Analyzing spend by product category for cost optimization</div></li><li class="slate-li " ><div style="position:relative">Defining procurement strategies based on category-specific insights</div></li></ul><p class="slate-p " >By utilizing product category master data, organizations can gain a clearer overview of procurement activities and make more informed purchasing decisions.</p><p class="slate-p " >The Categories section allows users to manage and organize different categories within the Hivebuy platform. Users can create, update, and view various categories to streamline their products and services effectively. This section is essential for maintaining a structured and organized system within the platform.</p><p class="slate-p " ></p><h3 class="slate-h3 " >Field Update: Transition from  <strong class="slate-bold">“name”</strong> to <strong class="slate-bold">“names”</strong> (Multi-language Support)</h3><h4 class="slate-h4 " >New</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Replaced “<strong class="slate-bold">name</strong>” field with a &quot;<strong class="slate-bold">names</strong>&quot; object to support multi-language localization.</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Example:</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Old: “name” : “Official Supplies”</div></li><li class="slate-li " ><div style="position:relative">New: &quot;names&quot;: {&quot;en&quot;: &quot;Official Supplies&quot;}</div></li></ul></li></ul></li><li class="slate-li " ><div style="position:relative">The <strong class="slate-bold">&quot;name&quot;</strong> field is still accepted for backward compatibility but will be <strong class="slate-bold">removed in a future release</strong>. </div></li><li class="slate-li " ><div style="position:relative">All new implementations should use the <strong class="slate-bold">“names”</strong> object instead.</div></li></ul><h4 class="slate-h4 " >Action Required</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Update your payloads and consumers to use <strong class="slate-bold">“names”</strong> instead of <strong class="slate-bold">“name”.</strong>
 Support for “name” will be removed in an upcoming version.</div></li></ul><p class="slate-p " ></p>

Product category master data in Hivebuy is essential for structuring procurement processes and enhancing reporting. Product categories serve as an additional classification method alongside cost centers and projects, enabling better spend analysis and control.

By utilizing product category master data, organizations can gain a clearer overview of procurement activities and make more informed purchasing decisions.

The Categories section allows users to manage and organize different categories within the Hivebuy platform. Users can create, update, and view various categories to streamline their products and services effectively. This section is essential for maintaining a structured and organized system within the platform.

<p class="slate-p " >This endpoint allows you to manage and retrieve all relevant <strong class="slate-bold">company delivery and invoice addresses</strong>. You can configure default addresses for both types, ensuring consistency across purchasing and invoicing operations.</p><p class="slate-p " >Additionally, the API supports assigning <strong class="slate-bold">personal addresses to individual users</strong>, which are automatically used as the <strong class="slate-bold">default delivery address</strong> in their <strong class="slate-bold">Purchase Requests</strong>.</p><h3 class="slate-h3 " >Key Features:</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Define and update <strong class="slate-bold">company-level delivery and invoice addresses</strong> </div></li><li class="slate-li " ><div style="position:relative">Set <strong class="slate-bold">default addresses</strong> per type (Delivery / Invoice) </div></li><li class="slate-li " ><div style="position:relative">Assign <strong class="slate-bold">user-specific addresses</strong> for personalized Purchase Request defaults </div></li></ul><h3 class="slate-h3 " > Use Cases:</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Streamlining purchase workflows by predefining delivery destinations </div></li><li class="slate-li " ><div style="position:relative">Ensuring accurate invoice routing by associating proper billing addresses </div></li><li class="slate-li " ><div style="position:relative">Supporting distributed teams with per-user delivery defaults</div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

This endpoint allows you to manage and retrieve all relevant 

. You can configure default addresses for both types, ensuring consistency across purchasing and invoicing operations.

Additionally, the API supports assigning 

<p class="slate-p " >The Contracts section allows users to manage the agreements and legal contracts associated with their accounts or transactions. This section enables users to view, create, update, and delete contracts as needed, providing a centralized hub for all legal documentation related to their interactions on the platform. Users can easily access and maintain their contracts through this section, ensuring compliance and clarity in their business dealings.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " ><strong class="slate-bold">Key Features</strong></h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Create, retrieve, and update company contract records </div></li><li class="slate-li " ><div style="position:relative">Attach multiple documents (PDFs etc.) to a contract </div></li><li class="slate-li " ><div style="position:relative">Track net, gross, and license-related amounts with currency support </div></li><li class="slate-li " ><div style="position:relative">Set approval requirements for controlled procurement </div></li></ul><h3 class="slate-h3 " ></h3><p class="slate-p " ></p><p class="slate-p " ></p>

The Contracts section allows users to manage the agreements and legal contracts associated with their accounts or transactions. This section enables users to view, create, update, and delete contracts as needed, providing a centralized hub for all legal documentation related to their interactions on the platform. Users can easily access and maintain their contracts through this section, ensuring compliance and clarity in their business dealings.

<p class="slate-p " >GET / CREATE / PATCH Departments inside Hivebuy</p><p class="slate-p " >Department master data in Hivebuy is essential for organizing procurement processes and aligning purchases with financial structures. Each department is linked to a corresponding cost center, ensuring accurate cost allocation and reporting.</p><p class="slate-p " ><strong class="slate-bold">Key functionalities:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Assignment of purchases to specific departments for better cost tracking</div></li><li class="slate-li " ><div style="position:relative">Clear mapping to cost centers for financial transparency</div></li><li class="slate-li " ><div style="position:relative">Improved reporting and budget control across departments</div></li></ul><p class="slate-p " ><strong class="slate-bold">Use cases include:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Structuring procurement activities by department, such as Marketing, IT, or Finance</div></li><li class="slate-li " ><div style="position:relative">Monitoring departmental budgets and expenses efficiently</div></li><li class="slate-li " ><div style="position:relative">Ensuring approvals and purchasing workflows are aligned with department responsibilities</div></li></ul><p class="slate-p " >By using department master data, organizations can optimize financial tracking, improve procurement efficiency, and maintain a structured overview of expenses.</p><p class="slate-p " ></p>

Department master data in Hivebuy is essential for organizing procurement processes and aligning purchases with financial structures. Each department is linked to a corresponding cost center, ensuring accurate cost allocation and reporting.

By using department master data, organizations can optimize financial tracking, improve procurement efficiency, and maintain a structured overview of expenses.

<p class="slate-p " >Legal entity master data in Hivebuy is crucial for structuring procurement processes across different company entities. Legal entities represent the various companies within an organization, ensuring accurate financial reporting and compliance.</p><p class="slate-p " ><strong class="slate-bold">Key functionalities:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Clear assignment of purchases to specific legal entities</div></li><li class="slate-li " ><div style="position:relative">Improved financial reporting and transparency across multiple entities</div></li><li class="slate-li " ><div style="position:relative">Compliance with tax and regulatory requirements</div></li></ul><p class="slate-p " ><strong class="slate-bold">Use cases include:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Managing procurement for subsidiaries, branches, or international entities</div></li><li class="slate-li " ><div style="position:relative">Ensuring correct invoicing and tax handling per legal entity</div></li><li class="slate-li " ><div style="position:relative">Structuring approvals and budget tracking based on legal entity assignment</div></li></ul><p class="slate-p " >By leveraging legal entity master data, organizations can maintain financial accuracy, streamline procurement operations, and ensure compliance across all company entities.</p><p class="slate-p " ></p>

Legal entity master data in Hivebuy is crucial for structuring procurement processes across different company entities. Legal entities represent the various companies within an organization, ensuring accurate financial reporting and compliance.

By leveraging legal entity master data, organizations can maintain financial accuracy, streamline procurement operations, and ensure compliance across all company entities.

<p class="slate-p " >GET / CREATE / PATCH Projects inside Hivebuy</p><p class="slate-p " >Project master data in Hivebuy is used as an additional reporting option alongside cost centers. It allows individual projects and orders to be represented as cost carriers. Projects can be assigned to multiple departments (cost centers), enabling flexible cost allocation.</p><p class="slate-p " ><strong class="slate-bold">Use cases include:</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Customer projects</div></li><li class="slate-li " ><div style="position:relative">Individual company events</div></li><li class="slate-li " ><div style="position:relative">Internal projects, such as software implementation projects</div></li></ul><p class="slate-p " >By leveraging project master data, organizations can improve financial tracking and gain better insights into project-related expenses.</p><p class="slate-p " ></p>

GET / CREATE / PATCH Projects inside Hivebuy

Project master data in Hivebuy is used as an additional reporting option alongside cost centers. It allows individual projects and orders to be represented as cost carriers. Projects can be assigned to multiple departments (cost centers), enabling flexible cost allocation.

By leveraging project master data, organizations can improve financial tracking and gain better insights into project-related expenses.

<div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p slate-indent-0" style="0px">The Hivebuy Purchase Order API has a default result length of 10 entries. You can increase this to a maximum of 30 entries by using the parameter <code class="slate-code">pageSize</code></p></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

<p class="slate-p " >Supplier master data in Hivebuy is essential for ensuring seamless procurement processes. </p><p class="slate-p " >These data records can be regularly transferred from ERP and accounting systems to Hivebuy, but only suppliers relevant to the Hivebuy scope should be included. </p><p class="slate-p " >Supplier master data consists of <strong class="slate-bold">address and payment details</strong>, as well as information on whether purchase orders should be <strong class="slate-bold">sent directly to the supplier </strong>via email. Additionally, Hivebuy provides a <strong class="slate-bold">change log that tracks modifications to master data</strong>, allowing users to see when and what changes were made.</p><p class="slate-p " ></p>

Supplier master data in Hivebuy is essential for ensuring seamless procurement processes. 

These data records can be regularly transferred from ERP and accounting systems to Hivebuy, but only suppliers relevant to the Hivebuy scope should be included. 

, as well as information on whether purchase orders should be 

via email. Additionally, Hivebuy provides a 

change log that tracks modifications to master data

, allowing users to see when and what changes were made.

<p class="slate-p " >The User Sync section enables seamless synchronization of external user data with Hivebuy. Users can create invitations, manage user properties, and access a full list of all users within their system. This functionality streamlines the integration process and enhances user management capabilities.</p><p class="slate-p " ></p>

The User Sync section enables seamless synchronization of external user data with Hivebuy. Users can create invitations, manage user properties, and access a full list of all users within their system. This functionality streamlines the integration process and enhances user management capabilities.

Sections