1. Go to this page and download the library: Download cvxvp/rpost library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
cvxvp / rpost example snippets
$CategoryList = new \LapayGroup\RussianPost\CategoryList();
$categoryList = $CategoryList->parseToArray();
$CategoryList = new \LapayGroup\RussianPost\CategoryList();
$CategoryList->setCategoryDelete([100,200,300]);
$categoryList = $CategoryList->parseToArray();
try {
$objectId = 2020; // Письмо с объявленной ценностью
// Минимальный набор параметров для расчета стоимости отправления
$params = [
'weight' => 20, // Вес в граммах
'sumoc' => 10000, // Сумма объявленной ценности в копейках
'from' => 109012 // Почтовый индекс места отправления
];
// Список ID дополнительных услуг
// 2 - Заказное уведомление о вручении
// 21 - СМС-уведомление о вручении
$services = [2,21];
$TariffCalculation = new \LapayGroup\RussianPost\TariffCalculation();
$calcInfo = $TariffCalculation->calculate($objectId, $params, $services);
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostTarrificatorException $e) {
// Обработка ошибок тарификатора
$errors = $e->getErrors(); // Массив вида [['msg' => 'текст ошибки', 'code' => код ошибки]]
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$log = new Logger('name');
$log->pushHandler(new StreamHandler('log.txt', Logger::INFO));
// Логирование расчета тарифа
$tariffCalculation = new \LapayGroup\RussianPost\TariffCalculation();
$tariffCalculation->setLogger($log);
$res = $tariffCalculation->calculate(23030, ['from' => 101000, 'to' => 101000, 'weight' => 100, 'sumoc' => 0]);
// Логирования API отправки
$otpravkaApi = new \LapayGroup\RussianPost\Providers\OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$otpravkaApi->setLogger($log);
$addressList = new \LapayGroup\RussianPost\AddressList();
$addressList->add('115551 Кширское шоссе 94-1, 1');
$result = $otpravkaApi->clearAddress($addressList);
// Логирование API трекинга
$config['auth']['tracking']['login'] = 'login';
$config['auth']['tracking']['password'] = 'password';
$Tracking = new \LapayGroup\RussianPost\Providers\Tracking('single', $config);
$Tracking->setLogger($log);
$result = $Tracking->getOperationsByRpo('10944022440321');
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\Tracking;
$Tracking = new Tracking('single', Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $Tracking->getOperationsByRpo('10944022440321');
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\Tracking;
$Tracking = new Tracking('single', Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $Tracking->getNpayInfo('10944022440321');
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\Tracking;
$Tracking = new Tracking('pack', Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $Tracking->getTickets(['10944022440321', '11172522364055', '10944022490302']);
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\Tracking;
$Tracking = new Tracking('pack', Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $Tracking->getOperationsByTicket('20180506151902355WANVOUGROWKXUN');
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$addressList = new \LapayGroup\RussianPost\AddressList();
$addressList->add('115551 Кширское шоссе 94-1, 1');
$result = $otpravkaApi->clearAddress($addressList);
/*
Array
(
[0] => Array
(
[address-type] => DEFAULT
[corpus] => 1
[house] => 94
[id] => 0
[index] => 115551
[original-address] => 115551 Кширское шоссе 94-1, 1
[place] => г. Москва
[quality-code] => GOOD
[region] => г. Москва
[room] => 1
[street] => шоссе Каширское
[validation-code] => VALIDATED
)
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$fioList = new \LapayGroup\RussianPost\FioList();
$fioList->add('Иванов Петр игоревич');
$result = $otpravkaApi->clearFio($fioList);
/*
Array
(
[0] => Array
(
[id] => 0
[middle-name] => Игоревич
[name] => Петр
[original-fio] => Иванов Петр игоревич
[quality-code] => EDITED
[surname] => Иванов
)
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$phoneList = new \LapayGroup\RussianPost\PhoneList();
$phoneList->add('9260120935');
$result = $otpravkaApi->clearPhone($phoneList);
/*
Array
(
[0] => Array
(
[id] => 0
[original-phone] => 9260120935
[phone-city-code] => 926
[phone-country-code] => 7
[phone-extension] =>
[phone-number] => 0120935
[quality-code] => GOOD
)
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
$OtpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$list = $OtpravkaApi->shippingPoints();
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
use LapayGroup\RussianPost\ParcelInfo;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$parcelInfo = new ParcelInfo();
$parcelInfo->setIndexFrom($list[0]['operator-postcode']); // Индекс пункта сдачи из функции $OtpravkaApi->shippingPoints()
$parcelInfo->setIndexTo(644015);
$parcelInfo->setMailCategory('ORDINARY'); // https://otpravka.pochta.ru/specification#/enums-base-mail-category
$parcelInfo->setMailType('POSTAL_PARCEL'); // https://otpravka.pochta.ru/specification#/enums-base-mail-type
$parcelInfo->setWeight(1000);
$parcelInfo->setFragile(true);
$tariffInfo = $otpravkaApi->getDeliveryTariff($parcelInfo);
echo $tariffInfo->getTotalRate()/100 . ' руб.';
/*
LapayGroup\RussianPost\TariffInfo Object
(
[totalRate:LapayGroup\RussianPost\TariffInfo:private] => 30658
[totalNds:LapayGroup\RussianPost\TariffInfo:private] => 6132
[aviaRate:LapayGroup\RussianPost\TariffInfo:private] => 0
[aviaNds:LapayGroup\RussianPost\TariffInfo:private] => 0
[deliveryMinDays:LapayGroup\RussianPost\TariffInfo:private] => 1
[deliveryMaxDays:LapayGroup\RussianPost\TariffInfo:private] => 3
[fragileRate:LapayGroup\RussianPost\TariffInfo:p rivate] => 7075
[fragileNds:LapayGroup\RussianPost\TariffInfo:private] => 1415
[groundRate:LapayGroup\RussianPost\TariffInfo:private] => 30658
[groundNds:LapayGroup\RussianPost\TariffInfo:private] => 6132
[insuranceRate:LapayGroup\RussianPost\TariffInfo:private] => 0
[insuranceNds:LapayGroup\RussianPost\TariffInfo:private] => 0
[noticeRate:LapayGroup\RussianPost\TariffInfo:private] => 0
[noticeNds:LapayGroup\RussianPost\TariffInfo:private] => 0
[oversizeRate:LapayGroup\RussianPost\TariffInfo:private] => 0
[oversizeNds:LapayGroup\RussianPost\TariffInfo:private] => 0
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
use LapayGroup\RussianPost\ParcelInfo;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$parcelInfo = new ParcelInfo();
$parcelInfo->setIndexFrom($list[0]['operator-postcode']); // Индекс пункта сдачи из функции $OtpravkaApi->shippingPoints()
$parcelInfo->setMailCategory('ORDINARY'); // https://otpravka.pochta.ru/specification#/enums-base-mail-category
$parcelInfo->setWeight(1000);
$parcelInfo->setFragile(true);
// Параметры только для ЕКОМ
$parcelInfo->setMailType('ECOM'); // Вид РПО ЕКОМ https://otpravka.pochta.ru/specification#/enums-base-mail-type
$parcelInfo->setDeliveryPointindex(644015); // Вместо индекса назначения указывается индекс ПВЗ
$parcelInfo->setEntriesType('SALE_OF_GOODS'); // Категория вложения https://otpravka.pochta.ru/specification#/enums-base-entries-type
$parcelInfo->setFunctionalityChecking(true); // Признак услуги проверки работоспособности
$parcelInfo->setGoodsValue(1588000); // Стоимость
$parcelInfo->setWithFitting(true); // Признак услуги 'Возможность примерки'
$tariffInfo = $otpravkaApi->getDeliveryTariff($parcelInfo);
echo $tariffInfo->getTotalRate()/100 . ' руб.';
/*
LapayGroup\RussianPost\TariffInfo Object
(
[functionalityCheckingRate:LapayGroup\RussianPost\TariffInfo:private] => 30658
[functionalityCheckingNds:LapayGroup\RussianPost\TariffInfo:private] => 6132
[withFittingRate:LapayGroup\RussianPost\TariffInfo:private] => 0
[withFittingNds:LapayGroup\RussianPost\TariffInfo:private] => 0
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$res = $otpravkaApi->getDeliveryPeriod(\LapayGroup\RussianPost\PostType::EMS, 115551, 115551);
/*
Array
(
[version] => 1.2.10.28
[date] => 20190621
[datefirst] => 20190411
[posttype] => 7
[posttypename] => EMS
[from] => 115551
[fromname] => МОСКВА 551
[to] => 115551
[toname] => МОСКВА 551
[route] => 43-45000000-45000000
[routename] => МОСКВА 551-МОСКВА 551
[delivery] => Array
(
[min] => 1
[max] => 1
)
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->getBalance();
/*
Array
(
[balance] => 0
[balance-date] => 2019-06-21
[work-with-balance] => 1
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$recepient = new \LapayGroup\RussianPost\Entity\Recipient();
$recepient->setAddress('650905 ЯГУНОВСКИЙ, КЕМЕРОВСКАЯ ОБЛАСТЬ, УЛ БЕЛОЗЕРНАЯ, ДОМ 21,КВ 1');
$recepient->setName('Иванов Петр Николаевич');
$recepient->setPhone('79260112367');
try {
$res = $otpravkaApi->untrustworthyRecipient($recepient);
/*
Array
(
[raw-address] => 650905 ЯГУНОВСКИЙ, КЕМЕРОВСКАЯ ОБЛАСТЬ, УЛ БЕЛОЗЕРНАЯ,ДОМ 21,КВ 1
[raw-full-name] => Иванов Петр Николаевич
[raw-telephone] => 79260112367
[unreliability] => RELIABLE
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
// Обработка списка получателей
$recepients[0] = $recepient;
$recepients[1] = $recepient;
try {
$res = $otpravkaApi->untrustworthyRecipients($recepients);
/*
Array
(
[0] => Array
(
[raw-address] => 650905 ЯГУНОВСКИЙ, КЕМЕРОВСКАЯ ОБЛАСТЬ, УЛ БЕЛОЗЕРНАЯ,ДОМ 21,КВ 1
[raw-full-name] => Иванов Петр Николаевич
[raw-telephone] => 79260112367
[unreliability] => RELIABLE
),
[1] => Array
(
[raw-address] => 650905 ЯГУНОВСКИЙ, КЕМЕРåОВСКАЯ ОБЛАСТЬ, УЛ БЕЛОЗЕРНАЯ,ДОМ 21,КВ 1
[raw-full-name] => Иванов Петр Николаевич
[raw-telephone] => 79260112367
[unreliability] => RELIABLE
)
)
*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->sendingF103form(28); // return boolean
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->generateDocCheckingAct(28, OtpravkaApi::PRINT_FILE);
// TODO если у Вас есть пример ответа, просьба приложить его через pull request :)
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->generateReturnLabel(123456, OtpravkaApi::PRINT_FILE, OtpravkaApi::PRINT_TYPE_PAPER);
// TODO если у Вас есть пример ответа, просьба приложить его через pull request :)
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->archivingBatch([25]);
/*
Array (
[0] => Array
(
[batch-name] => 25
)
)*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->unarchivingBatch([25]);
/*
Array Успешный ответ
(
[0] => Array
(
[batch-name] => 25
)
)
Array Ответ с ошибкой
(
[0] => Array
(
[batch-name] => 26
[error-code] => NOT_FOUND
)
)*/
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->returnShipment(123456, \LapayGroup\RussianPost\Enum\MailType::UNDEFINED);
// Успешный ответ
/*Array
(
[return-barcode] => 1234567890 // ШПИ возвратного отправления
)
// Ответ с ошибкой
/*Array
(
[errors] => Array
(
[0] => Array
(
[code] => DIRECT_SHIPMENT_NOT_FOUND
[description] => Прямое отправление не найдено
)
)
)*/
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$addressFrom = new \LapayGroup\RussianPost\Entity\AddressReturn();
$addressFrom->setAddressType(\LapayGroup\RussianPost\Enum\AddressType::DEFAULT);
$addressFrom->setIndex(125009);
$addressFrom->setPlace('Москва');
$addressFrom->setRegion('Москва');
$addressTo = new \LapayGroup\RussianPost\Entity\AddressReturn();
$addressTo->setAddressType(\LapayGroup\RussianPost\Enum\AddressType::DEFAULT);
$addressTo->setIndex(115551);
$addressTo->setPlace('Москва');
$addressTo->setRegion('Москва');
$return_shipment = new \LapayGroup\RussianPost\Entity\ReturnShipment();
$return_shipment->setMailType(\LapayGroup\RussianPost\Enum\MailType::UNDEFINED);
$return_shipment->setSenderName('Иванов Иван');
$return_shipment->setRecipientName('Петров Петр');
$return_shipment->setOrderNum(1234);
$return_shipment->setAddressFrom($addressFrom);
$return_shipment->setAddressTo($addressTo);
$result = $otpravkaApi->createReturnShipment([$return_shipment->asArr()]);
// Успешный ответ
// TODO добавьте в PR, если у кого есть реальный пример, пожалуйста :-)
// Ответ с ошибкой
/*Array
(
[0] => Array
(
[errors] => Array
(
[0] => Array
(
[code] => FREE_ER_ADDRESS_NOT_ENABLED
[description] => Свободный ввод адреса не доступен
)
)
[position] => 0
)
)*/
}
catch (\InvalidArgumentException $e) {
// Обработка ошибки заполнения параметров
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$result = $otpravkaApi->deleteReturnShipment(123456);
/*Array
(
[code] => RETURN_SHIPMENT_NOT_FOUND
[description] => Возвратное отправление не найдено
)*/
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
try {
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$addressFrom = new \LapayGroup\RussianPost\Entity\AddressReturn();
$addressFrom->setAddressType(\LapayGroup\RussianPost\Enum\AddressType::DEFAULT);
$addressFrom->setIndex(125009);
$addressFrom->setPlace('Москва');
$addressFrom->setRegion('Москва');
$addressTo = new \LapayGroup\RussianPost\Entity\AddressReturn();
$addressTo->setAddressType(\LapayGroup\RussianPost\Enum\AddressType::DEFAULT);
$addressTo->setIndex(115551);
$addressTo->setPlace('Москва');
$addressTo->setRegion('Москва');
$return_shipment = new \LapayGroup\RussianPost\Entity\ReturnShipment();
$return_shipment->setMailType(\LapayGroup\RussianPost\Enum\MailType::UNDEFINED);
$return_shipment->setSenderName('Иванов Иван');
$return_shipment->setRecipientName('Петров Петр');
$return_shipment->setOrderNum(1234);
$return_shipment->setAddressFrom($addressFrom);
$return_shipment->setAddressTo($addressTo);
$result = $otpravkaApi->editReturnShipment($return_shipment, 123456);
// Успешный ответ
// TODO добавьте в PR, если у кого есть реальный пример, пожалуйста :-)
// Ответ с ошибкой
/* Array
(
[errors] => Array
(
[0] => Array
(
[code] => FREE_ER_ADDRESS_NOT_ENABLED
[description] => Свободный ввод адреса не доступен
)
)
)*/
}
catch (\InvalidArgumentException $e) {
// Обработка ошибки заполнения параметров
}
catch (\LapayGroup\RussianPost\Exceptions\RussianPostException $e) {
// Обработка ошибочного ответа от API ПРФ
}
catch (\Exception $e) {
// Обработка нештатной ситуации
}
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$list = $otpravkaApi->shippingPoints();
use Symfony\Component\Yaml\Yaml;
use LapayGroup\RussianPost\Providers\OtpravkaApi;
$otpravkaApi = new OtpravkaApi(Yaml::parse(file_get_contents('path_to_config.yaml')));
$info = $otpravkaApi->settings();
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.