> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/devices-and-settings/connectivity/data-forwarding/startrack.md).

# Startrack

Передавайте координаты транспортных средств из Navixy в SOAP-сервис Startrack, используемый операторами автопарков в Гватемале, Сальвадоре и Гондурасе.

Startrack получает координаты транспортных средств от Navixy и делает их доступными для своих инструментов мониторинга и управления. Операторы автопарков в Центральной Америке используют его, главным образом в Гватемале, Сальвадоре и Гондурасе, для управления автопарком, промышленных и строительных операций, а также перевозок с контролем температуры.

В Navixy выберите **Startrack** в **Протокол** раскрывающийся список.

## Что отправляет Navixy

Navixy отправляет по одному SOAP-запросу на каждую позицию в `receiveWithConfirmation` метод. Запрос содержит следующие поля:

| Поле                      | Содержимое                                                                       |
| ------------------------- | -------------------------------------------------------------------------------- |
| `vehicleId`               | Внешний ID устройства или идентификатор устройства Navixy, если External ID пуст |
| `dateAndTime`             | Когда устройство зафиксировало позицию, в формате ISO 8601                       |
| `y`                       | Широта в градусах                                                                |
| `x`                       | Долгота в градусах                                                               |
| `км/ч`                    | Скорость в километрах в час                                                      |
| `курс`                    | Направление движения в градусах                                                  |
| `ignitionIsOn`            | Включено ли зажигание                                                            |
| `locationIsValid`         | Является ли позиция корректным GPS-фиксом                                        |
| `trackingServiceProvider` | Всегда `navixy-retranslator`, указывая Navixy как источник                       |

Обратите внимание, что `x` — это долгота и `y` — это широта.

Startrack подтверждает принятую позицию с помощью `<ok>true</ok>` в ответе.

### Когда Navixy отправляет

Navixy отправляет каждое сообщение с корректными координатами. Сообщения без позиции пропускаются.

## Перед началом

Получите адрес конечной точки и порт у Startrack. К службе обычно обращаются по адресу `https://cempro.gps.gt/gpsDataService?wsdl` на порту `443`.

Вам также нужен идентификатор транспортного средства, который Startrack использует для каждого устройства; его следует указать в поле External ID.

Этот протокол не использует логин и пароль.

## Настройка ретрансляции

{% stepper %}
{% step %}

### Откройте блок «Ретрансляция»

Перейдите **Управление устройствами**, выберите устройство, затем найдите **Ретрансляция** блок.
{% endstep %}

{% step %}

### Откройте список протоколов

Нажмите **Протоколы**, затем нажмите **+** чтобы добавить конфигурацию.
{% endstep %}

{% step %}

### Введите настройки Startrack

Заполните поля следующим образом:

* **Название**: метка, идентифицирующая этот ретранслятор
* **Протокол**: **Startrack**
* **Адрес**: `https://cempro.gps.gt/gpsDataService?wsdl`
* **Порт**: `443`

Оставьте **Вход** и **Пароль** пустым.
{% endstep %}

{% step %}

### Включите и сохраните

Включите **Включено**, затем нажмите **Сохранить**. Ретранслятор, который не включен, ничего не отправляет.
{% endstep %}

{% step %}

### Привяжите ретранслятор к устройству

В блоке устройства **Ретрансляция** включите переключатель для созданного вами ретранслятора, затем нажмите **Сохранить**.
{% endstep %}

{% step %}

### Задайте External ID

Нажмите значок ссылки справа в строке ретранслятора, затем введите идентификатор транспортного средства, который использует Startrack. Navixy принимает здесь любое значение, поэтому значение, не совпадающее с записью Startrack, сохраняется, а затем игнорируется Startrack.

Повторите этот шаг и предыдущий для каждого устройства, которое пересылает данные в Startrack.
{% endstep %}
{% endstepper %}

## Управление ретрансляцией

Чтобы изменить или остановить пересылку данных в Startrack:

* Нажмите значок ссылки справа от строки ретранслятора, чтобы изменить External ID устройства.
* Выключите переключатель, чтобы остановить ретрансляцию для одного устройства и сохранить конфигурацию для остальных.
* Нажмите **Протоколы**, выберите строку и отредактируйте ее, чтобы изменить имя, адрес или порт. Изменение будет применяться ко всем устройствам, связанным с этим ретранслятором.
* Удалите конфигурацию из **Протоколы** списка, чтобы остановить ретрансляцию для всех устройств. Подтвердите в диалоговом окне.

## Устранение неполадок

Когда данные не отображаются в Startrack, проверьте следующее по порядку:

1. Ретранслятор включен, и для устройства активирован его переключатель.
2. Адрес и порт указаны верно.
3. External ID совпадает с идентификатором транспортного средства, зарегистрированным на стороне Startrack.
4. Устройство передает корректные координаты.
5. Startrack подтверждает, что получает данные.

### Проверьте конечную точку напрямую

Чтобы проверить, что конечная точка Startrack принимает данные, отправьте SOAP-запрос с `curl` с помощью подготовленного XML-файла. Успешный ответ выглядит так:

{% code overflow="wrap" %}

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:receiveWithConfirmationResponse xmlns:ns2="https://cempro.gps.gt">
      <return>
        <ok>true</ok>
        <result>isOk:true statuses:[ADDED_TO_RECORD_Q] Сообщения:[добавлено в очередь записи]</result>
      </return>
    </ns2:receiveWithConfirmationResponse>
  </soap:Body>
</soap:Envelope>
```

{% endcode %}

Вкладка `<ok>true</ok>` элемент и `ADDED_TO_RECORD_Q` статус вместе подтверждают, что Startrack поставил позицию в очередь на обработку.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/ru/guide/devices-and-settings/connectivity/data-forwarding/startrack.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.