webmasterskaya/cccb-soap-client

PHP-SOAP клиент для работы с web-сервисами ЕДИНОЙ ИНФОРМАЦИОННОЙ СИСТЕМЫ «Спецсвязь» (ЕИС «Спецсвязь»)

0.0.1 2022-12-27 21:02 UTC

This package is auto-updated.

Last update: 2024-04-13 19:12:07 UTC


README

Веб-сервис предназначен для автоматизации обмена данными между информационными системами контрагентов ФГУП ГЦСС и Единой информационной системой «Спецсвязь».

Warning Читайте комментарии в коде! Там всё доступно расписано

Установка

composer reqiure webmasterskaya/cccb-soap-client

Как пользоваться

<?php 

// Получение экземпляра клиента
/** @var \Webmasterskaya\Soap\CCCB\CccbClient $client */
$client = \Webmasterskaya\Soap\CCCB\CccbClientFactory::create([
    'login' => 'WebServiceLogin', // Ваш логин доступа к ЕИС «Спецсвязь». Выдается сотрниками ИТ блока ФГУП ГЦСС
    'password' => 'WebServicePassword', // Ваш пароль доступа к ЕИС «Спецсвязь». Выдается сотрниками ИТ блока ФГУП ГЦСС
    'contract_guid' => '00000000-0000-0000-0000-000000000000', // Ваш идентификатор договора контрагента. Выдается сотрниками ИТ блока ФГУП ГЦСС
    'service_guid' => '00000000-0000-0000-0000-000000000000', // Ваш идентификатор услуги (по заключенному договору). Выдается сотрниками ИТ блока ФГУП ГЦСС
]);

// Вызвать метод вебсервиса

/** @var \Webmasterskaya\Soap\CCCB\Type\ProbResponse $probResponse */
$probResponse = $client->probe();

echo $probResponse->getReturn(); // Выведет "Пробный вызов веб-сервиса"

Доступные методы веб-сервиса

Notice На самом деле методов куда болше, но их назначение и поведение не документировано

Метод Объект запроса Объект ответа Описание
prob() Prob ProbResponse Пробный вызов веб-сервиса
newApplication() NewApplication NewApplicationResponse Метод создаёт новую заявку на отправление в ЕИС и возвращает параметры созданной заявки
getParcelInfo() GetParcelInfo GetParcelInfoResponse Метод возвращает информацию об отправлении с указанным приемным номером.
getCost() GetCost GetCostResponse Метод возвращает рассчитанную стоимость доставки отправления
detailedAccountReport() DetailedAccountReport DetailedAccountReportResponse Метод возвращает информацию о принятых отправлениях договора за последние 3 месяца.
cancelApplication() CancelApplication CancelApplicationResponse Метод отменяет заявку на отправление в ЕИС
automatizationInfo() AutomatizationInfo AutomatizationInfoResponse Метод возвращает информацию об УСС, который обслуживает адрес, переданный в качестве входного параметра.
getParcelHistory() GetParcelHistory GetParcelHistoryResponse Метод возвращает характеристики отправления и всю историю событий по этому отправлению.
writeParcelCharacteristics() WriteParcelCharacteristics WriteParcelCharacteristicsResponse Метод записывает в базу ЕИС характеристики отправления.
getContractInfo() GetContractInfo GetContractInfoResponse Метод возвращает информацию о принятых за последние 3 месяца отправлениях по договору.
getF1Info() GetF1Info GetF1InfoResponse Метод возвращает информацию по отправлениям из реестра Ф1.

Хотите помочь?

На данный момент у проекта "горят" следующие задачи:

  • Привести docblock в порядок
  • Написать исчерпывающее описание всех методов и типов данных web-ервиса
  • Привести код к PSR-12
  • Настроить php-cs-fixer
  • Настроить Psalm
  • Бесконечно искать и править баги