PHPackages                             alfamart24/laravel-gtd-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. alfamart24/laravel-gtd-api

ActiveLibrary[API Development](/categories/api)

alfamart24/laravel-gtd-api
==========================

api TK GTD for laravel

376PHP

Since Oct 30Pushed 7y ago2 watchersCompare

[ Source](https://github.com/alfamart24/laravel-gtd-api)[ Packagist](https://packagist.org/packages/alfamart24/laravel-gtd-api)[ RSS](/packages/alfamart24-laravel-gtd-api/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (2)Used By (0)

Laravel TK GTD api
==================

[](#laravel-tk-gtd-api)

Api для работы с ТК GTD.
Рализована работа калькулятора, создание ордера и многих других функций. По мере разработки буду обновлять документацию.
По вопросам работы пишите в телеграмм WStanley

Installation
============

[](#installation)

```
composer require alfamart24/laravel-gtd-api:dev-master

```

Usage
=====

[](#usage)

Добавляем токен в файл .env

```
TOKEN_GTD=

```

Подключаем сервис в контроллере:

```
use Alfamart24\Gtdapi\GtdService;

$service = new GtdService();

```

Реализованные функции:
----------------------

[](#реализованные-функции)

#### Получение списка городов - `geography/city/get-list`

[](#получение-списка-городов---geographycityget-list)

```
$service->cityGeography()->all()

```

#### Получение списка электронных адресов - `geography/email/get-list`

[](#получение-списка-электронных-адресов---geographyemailget-list)

```
$service->email()->all()

```

#### Получение списка телефонов - `geography/phone/get-list`

[](#получение-списка-телефонов---geographyphoneget-list)

```
$service->phone()->all()

```

#### Получение списка режимов работы - `geography/schedule/get-list`

[](#получение-списка-режимов-работы---geographyscheduleget-list)

```
$service->schedule()->all()

```

#### Получение списка видов графиков работы - `geography/schedule-group/get-list`

[](#получение-списка-видов-графиков-работы---geographyschedule-groupget-list)

```
$service->scheduleGroup()->all()

```

#### Расчет стоимости - `order/calculate`

[](#расчет-стоимости---ordercalculate)

```
Получение всего отвера от сервера:
$service->calculate(...)->all()

Заполнение свойств метода с ответа (подробнее см ниже)
$service->calculate(...)->calculateResult()

```

#### Получение списка валют - `order/currency/get-list`

[](#получение-списка-валют---ordercurrencyget-list)

```
$service->currency()->all()

```

#### Список страховых агентов - `order/insurance/get-list`

[](#список-страховых-агентов---orderinsuranceget-list)

```
$service->insurance()->all()

```

#### Оформление заказа - `order/service/get-list`

[](#оформление-заказа---orderserviceget-list)

```
$service->service()->all()

```

#### Статус заказа - `order/status/get`

[](#статус-заказа---orderstatusget)

```
$service->status(...)->all()

```

#### Список городов - `tdd/city/get-list`

[](#список-городов---tddcityget-list)

```
$service->cityTdd()->all()

```

#### Получение списка стран - `tdd/country/get-list`

[](#получение-списка-стран---tddcountryget-list)

```
$service->country()->all()

```

#### Список регионов - `tdd/region/get-list`

[](#список-регионов---tddregionget-list)

```
$service->region()->all()

```

Примеры работы с функциями:
---------------------------

[](#примеры-работы-с-функциями)

#### Список городов - `tdd/city/get-list`

[](#список-городов---tddcityget-list-1)

Чтобы получить весь список городов используем all().
 all() используется для получения полного ответа от сервера.

```
Получение всего ответа от сервера
$cyties = $service->cityTdd()->all()

Вернет массив вида [код города => имя города]
$cyties = $service->cityTdd()->cities()

```

Для отправки запроса передаем параметры в функцию

```
$cyti = $service->cityTdd(
                [
                    "code"         => "660002900000",
                    "region_code"  => "66",
                    "country_code" => "RU"
                ])->all()

```

Либо так

```
$cyti = $service->cityTdd(["code" => "660002900000"])->all()

```

Какие параметры принимает конкретная функция вы можете узнать из документации, либо в классе функции, в поле optional перечислены необязательные параметры, в поле necessary перечислены обязательные параметры.

#### Список страховых агентов - `order/insurance/get-list`

[](#список-страховых-агентов---orderinsuranceget-list-1)

Чтобы получить весь ответ от сервера используем all()

```
$response = $service->insurance()->all()

```

В полном ответе от сервера содержатся типы данных `agent` и `cargo_type`
Получение только типа `agent`

```
$agents = $service->insurance()->agent()

```

Получение типа `cargo_type`

```
$cargoType = $service->insurance()->cargo_type()

```

С детальной информацией об ответах от сервера вы можете ознакомиться в документации.

Расчет стоимости перевозки
--------------------------

[](#расчет-стоимости-перевозки)

#### Расчет стоимости - `order/calculate`

[](#расчет-стоимости---ordercalculate-1)

#### Есть 2 варианта расчета стоимости:

[](#есть-2-варианта-расчета-стоимости)

### С указанием объема багажа `volume`

[](#с-указанием-объема-багажа-volume)

Получение полного ответа от сервера

```
$response = $service->calculate($request->all())->all();

```

Заполнение полей метода ответом от сервера

```
$response = $service->calculate($request->all())->calculateResult();

Поля:
$response->standart
$response->economy
$response->express
$response->standard_courier
$response->express_courier

Получение цены:
$response->cost('standart')

Проверить верно ли произведен расчет можно(нужно) вот так
$response->error = 'Ошибка расчета' - переданы неправильные параметры
$response->error = null             - поля ответа заполнены(расчет верный)

```

Обязательные параметры для расчета стоимости:

```
'city_pickup_code'      => 'Код города откуда',
'city_delivery_code'    => 'Код города куда',
'declared_price'        => 'Объявленная стоимость груза (руб)',
'count_place'           => 'Количество мест в позиции',
'weight'                => 'Масса КГ позиции',
'volume'                => 'Объем М³ позиции',

```

Необязательные параметры, для более дтального расчета, также можно передать в функцию:

```
'have_doc'              => 'Есть документы подтверждающие стоимость груза',
'insurance'             => 'Услуга страхования груза',
'insurance_agent_code'  => 'Код страхового агента',
'service'               => 'массив кодов услуг',
'pick_up'               => 'Забор груза по городу',
'delivery'              => 'Доставка груза по городу',
'cargo_type_code'       => 'Код характера груза',
'currency_code'         => 'Валюта результата расчета',
'all_places_same'       => 'Все места одинаковы по размеру'

```

Параметры о месте багажа ожидаются такого формата:

```
"count_place" => [
    0 => "1"
    1 => "3"],
"weight" => [
    0 => "2"
    1 => "3"],
"volume" => [
    0 => "8"
    1 => "2"],

```

Пример поля `input` на форме калькулятора:

```

```

Также у функции `canculate` есть зависимые параметры, с полной работой функции вы можете ознакомиться в документации.
Функция не отправит запрос пока не передадут все требуемяе параметры для расчета стоимости, выпадающие исключения подскажут чего не хватает.

Получить стоимость перевозки можно так

```
$response = $service->calculate($request->all())->calculateResult();

$price = $response->cost('standart')
$price = $response->cost('economy')
$price = $response->cost('express')
$price = $response->cost('standard_courier')
$price = $response->cost('express_courier')

```

Либо сразу так

```
$price = $service->calculate($request->all())->calculateResult()->cost('standart');

```

### С указанием размеров багажа `height`, `width`, `length`

[](#с-указанием-размеров-багажа-height-width-length)

В случае работы с размерами в функцию требуется передать флаг `false` вторым параметром, ианче расчет будет вестись как для объема.
Получение полного ответа от сервера

```
$response = $service->calculate($request->all(), false)->all();

```

Обязательные параметры для расчета:

```
'city_pickup_code'      => 'Код города откуда',
'city_delivery_code'    => 'Код города куда',
'declared_price'        => 'Объявленная стоимость груза (руб)',
'count_place'           => 'Количество мест в позиции',
'weight'                => 'Масса КГ позиции',
'height'                => 'Высота груза (см) позиции',
'width'                 => 'Ширина груза (см) позиции',
'length'                => 'Длина груза (см) позиции',

```

Необязательные параметры, для более дтального расчета, также можно передать в функцию:

```
'have_doc'              => 'Есть документы подтверждающие стоимость груза',
'insurance'             => 'Услуга страхования груза',
'insurance_agent_code'  => 'Код страхового агента',
'service'               => 'массив кодов услуг',
'pick_up'               => 'Забор груза по городу',
'delivery'              => 'Доставка груза по городу',
'cargo_type_code'       => 'Код характера груза',
'currency_code'         => 'Валюта результата расчета',
'all_places_same'       => 'Все места одинаковы по размеру'

```

Параметры о месте багажа ожидаются такого формата:

```
"count_place" => [
    0 => "1"
    1 => "3"],
"weight" => [
    0 => "2"
    1 => "3"],
"height" => [
    0 => "8"
    1 => "2"],
"width" => [
    0 => "4"
    1 => "6"],
"length" => [
    0 => "1"
    1 => "8"],

```

Пример поля `input` на форме калькулятора:

```

```

Также у функции `canculate` есть зависимые параметры, с полной работой функции вы можете ознакомиться в документации.
Функция не отправит запрос пока не передадут все требуемяе параметры для расчета стоимости, выпадающие исключения подскажут чего не хватает.

Получить стоимость перевозки можно так

```
$response = $service->calculate($request->all())->calculateResult();

$price = $response->cost('standart')
$price = $response->cost('economy')
$price = $response->cost('express')
$price = $response->cost('standard_courier')
$price = $response->cost('express_courier')

```

Либо сразу так

```
$price = $service->calculate($request->all())->calculateResult()->cost('standart');

```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/05856406861badbd95ac66e8bb62ad2530e5c44695c5bd26c2297ebab00e2016?d=identicon)[Butochnikov](/maintainers/Butochnikov)

---

Top Contributors

[![VVStanley](https://avatars.githubusercontent.com/u/19286641?v=4)](https://github.com/VVStanley "VVStanley (30 commits)")[![Butochnikov](https://avatars.githubusercontent.com/u/4212297?v=4)](https://github.com/Butochnikov "Butochnikov (2 commits)")

### Embed Badge

![Health badge](/badges/alfamart24-laravel-gtd-api/health.svg)

```
[![Health](https://phpackages.com/badges/alfamart24-laravel-gtd-api/health.svg)](https://phpackages.com/packages/alfamart24-laravel-gtd-api)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)