Create a company

Companies in XetaSuite represent parts suppliers and/or maintenance providers.

Company types

A Company can have one or more types:

Type	Description
`ITEM_PROVIDER`	Spare parts supplier
`MAINTENANCE_PROVIDER`	Maintenance contractor

Create a Company

Access the Companies module

From the sidebar, click Companies (only available at headquarters).
Click “New company”

The creation form opens in a modal.
Fill in the information

Field Required Description
Name ✅ Company name
Email ❌ Contact email
Phone ❌ Phone number
Address ❌ Postal address
Types ✅ Parts supplier and/or Maintenance provider
Save

Click Create to save.

Field	Required	Description
Name	✅	Company name
Email	❌	Contact email
Phone	❌	Phone number
Address	❌	Postal address
Types	✅	Parts supplier and/or Maintenance provider

API - Create a Company

Endpoint

POST /api/v1/companies

Payload

{
    "name": "ACME Corp",
    "email": "contact@acme.com",
    "phone": "+1 555 123 4567",
    "address": "123 Example Street, New York, NY 10001",
    "types": ["ITEM_PROVIDER", "MAINTENANCE_PROVIDER"]
}

Response

{
    "data": {
        "id": 1,
        "name": "ACME Corp",
        "email": "contact@acme.com",
        "phone": "+1 555 123 4567",
        "address": "123 Example Street, New York, NY 10001",
        "types": ["ITEM_PROVIDER", "MAINTENANCE_PROVIDER"],
        "item_count": 0,
        "created_at": "2024-01-15T10:30:00Z",
        "updated_at": "2024-01-15T10:30:00Z"
    }
}

Required permissions

Action	Permission
View list	`company.viewAny`
View a supplier	`company.view`
Create	`company.create`
Modify	`company.update`
Delete	`company.delete`

Deletion and data preservation

When a Company is deleted:

Items keep a reference to the company name (company_name field)
Item movements preserve the supplier name
Item prices preserve the supplier name

This allows maintaining traceability even after a supplier is deleted.