Company management

In the GPS-Trace platform, the company entity plays a crucial role.

When creating an account in the GPS-Trace Console, the GPS-Trace platform automatically approves the company's card with two necessary fields - company name and country.

Additionally, the company's card can be further supplemented with additional company information. If desired, you can be featured on the Dealer Map, located on the gps-trace.com website, allowing any site visitor (potential client) to find the dealer and contact them through the provided contact details on the company card, which will be duplicated on Dealer Map on the website.

Moreover, a filled company card plays a significant role in using Forguard and Tags solution. Thus, clients using these applications will always see information about company within the application.

Company Info

The second card, which plays a crucial role in your desire to use Forguard and Tags solutions, is the company's payment information card.

When filling out the information in the company's payment information card and upon approval by the GPS-Trace platform, you are given the opportunity to use Forguard and Tags solutions (manage accounts, utilize a flexible billing system, customize the application design for your clients, and much more) after agreeing to the offer.

Company Payment Info

Get company card information

This endpoint is used to get information about the company's card of the dealer.

GET /provider/company

200 Response example:

{
  "data": {
    "name": "Company",
    "address": "Chemin de la Lande de Langoyet, Langoyet, France",
    "coordinates": {
      "lat": 48.140432438188135,
      "lon": -2.7207960130671154
    },
    "country_code": "FR",
    "approved": true,
    "created_at": number,
    "updated_at": number,
    "marketing_info": {
      "phones": [
        "string",
        "string"
      ],
      "areas": [
        "company.areas.installation",
      ],
      "working_days": [ 1, 2, 3, 4, 5, 6 ],
      "schedule": "9:00-18:00",
      "about": "Track your vehicle!",
      "shown": true
    },
    "account_id": number
  }
}

name: name of the company
address: address of the company
coordinates: geographical coordinates of the company's location
lat: latitude coordinate
lon: longitude coordinate
country_code: country code of the company's location
approved: indicates whether the company is approved (true/false). Any changes made by service providers to the company's profile later are reviewed by the GPS-Trace team and approved by them
created_at: timestamp indicating when the company was created
updated_at: timestamp indicating when the company was last updated
marketing_info: marketing info about the company
phones: array of phone numbers associated with the company
areas: array of areas where the company operates. You can choose between the following list:
- company.areas.installation
- company.areas.selling
- company.areas.maintenance
- company.areas.soft
- company.areas.other
working_days: array of integers representing the working days of the company (1 for Monday, 2 for Tuesday, etc.)
schedule: working schedule of the company
about: brief description of the company
shown: indicates whether the company's information is shown on the Dealer Map (true/false)
account_id: unique identifier of the account associated with the company

Update company card information

This endpoint is used to update partial information on the company's card.

PATCH /provider/company

Request body example:

{
  "name": "Test Company",
  "marketing_info": {
    "website": "test.com",
    "email": "test@test.com",
    "working_days": [
      1,
      2
    ],
    "phones": [
      "+12345678790"
    ],
    "areas": [
      "company.areas.other",
      "company.areas.soft"
    ],
    "schedule": "10 00 - 20 00",
    "about": "Ille-et-Vilaine, Brittany, Metropolitan France",
    "shown": true
  }
}

name: name of the company
marketing_info: marketing info about the company
phones: an array of phone numbers associated with the company
areas: an array of areas where the company operates. You can choose between the following list:
- company.areas.installation
- company.areas.selling
- company.areas.maintenance
- company.areas.soft
- company.areas.other
working_days: an array of integers representing the working days of the company (1 for Monday, 2 for Tuesday, etc.)
schedule: the working schedule of the company
about: a brief description of the company
shown: indicates whether the company's information is shown on the Dealer Map (true/false)

The response contains the current information about the company. Any changes made to the company's card are first reviewed and approved by the GPS-Trace platform. Once approved, the updated information appears on the company's profile.

200 Response example:

{
  "name": "Test Company",
  "address": "Chemin de la Lande de Langoyet, Langoyet, France",
  "coordinates": {
    "lat": 48.140432438188135,
    "lon": -2.7207960130671154
  },
  "country_code": "FR",
  "approved": true,
  "created_at": number,
  "updated_at": number,
  "marketing_info": {
    "phones": [
      "string",
      "string"
    ],
    "areas": [
      "company.areas.installation",
      "company.areas.selling",
      "company.areas.maintenance",
      "company.areas.soft"
    ],
    "working_days": [ 1,2,3,4,5,6,7 ],
    "schedule": "9:00-18:00",
    "about": "Track your vehicle!",
    "shown": true
  },
  "account_id": number
}

name: name of the company
marketing_info: marketing info about the company
phones: array of phone numbers associated with the company
areas: array of areas where the company operates. You can choose between the following list:
- company.areas.installation
- company.areas.selling
- company.areas.maintenance
- company.areas.soft
- company.areas.other
working_days: array of integers representing the working days of the company (1 for Monday, 2 for Tuesday, etc.)
schedule: working schedule of the company
about: a brief description of the company
shown: indicates whether the company's information is shown on the Dealer Map (true/false)
address: address of the company
coordinates: geographical coordinates of the company's location
lat: latitude coordinate
lon: longitude coordinate
country_code: country code of the company's location
approved: indicates whether the company is approved (true/false). Any changes made by service providers to the company's profile later are reviewed by the GPS-Trace team and approved by them
created_at: timestamp indicating when the company was created
updated_at: timestamp indicating when the company was last updated
account_id: unique identifier of the account associated with the company

Get company payment information

This endpoint is used to get information about the company's payment information in the GPS-Trace Console.

GET /provider/company/payment-info

200 Response example:

{
  "id": number,
  "verified": true,
  "agreement": true,
  "name": "string",
  "email": "string",
  "vat": "string",
  "reg_number": "string",
  "address": {
    "city": "string",
    "country": "string",
    "line1": "string",
    "line2": "string",
    "postal_code": "string",
    "state": "string"
  },
  "created_at": number,
  "updated_at": number,
  "calculated_at": number,
  "invoiced_at": number,
  "auto_send_invoice": false,
  "auto_charge": false,
  "data": {}
}

id: the unique identifier of the company
verified: indicates whether the company's payment information is verified (true/false)
agreement: indicates whether you have agreed to the offer (true/false)
name: the name of the company
email: the email address associated with the company
vat: the VAT (Value Added Tax) number of the company
reg_number: the registration number of the company
address: the address details of the company
city: the city of the company's address
country: the country of the company's address
line1: the first line of the company's address
line2: the second line of the company's address
postal_code: the postal code of the company's address
state: the state or region of the company's address
created_at: the timestamp indicating when the company was created
updated_at: the timestamp indicating when the company was last updated
calculated_at: the timestamp indicating when the billing information calculation was last updated
invoiced_at: the timestamp indicating when the company was last invoiced
auto_send_invoice: controls automatic email delivery of invoices
auto_charge: controls automatic payment collection from customer's payment method