Appwilio\RussianPostSDK\Dispatching\Endpoints\Batches\Batches

Complexity

Total Complexity

9

Size/Duplication

Total Lines	76
Duplicated Lines	0 %

Test Coverage

Coverage

16.66%

Importance

Changes	1
Bugs	0	Features	0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
A	getOrders()	0	3	1
A	getByName()	0	6	2
A	findOrderByTrackingNumber()	0	3	1
A	find()	0	5	2
A	getOrderById()	0	6	2

<?php

/**
 * This file is part of RussianPost SDK package.
 *
 * © Appwilio (http://appwilio.com), greabock (https://github.com/greabock), JhaoDa (https://github.com/jhaoda)
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Appwilio\RussianPostSDK\Dispatching\Endpoints\Batches;

use Appwilio\RussianPostSDK\Core\ArrayOf;
use Appwilio\RussianPostSDK\Core\GenericRequest;
use Appwilio\RussianPostSDK\Dispatching\Http\ApiClient;
use Appwilio\RussianPostSDK\Dispatching\Exceptions\BadRequest;
use Appwilio\RussianPostSDK\Dispatching\Endpoints\Orders\Entites\Order;
use Appwilio\RussianPostSDK\Dispatching\Endpoints\Batches\Entites\Batch;
use Appwilio\RussianPostSDK\Dispatching\Endpoints\Orders\Exceptions\OrderNotFound;
use Appwilio\RussianPostSDK\Dispatching\Endpoints\Batches\Exceptions\BatchNotFound;
use Appwilio\RussianPostSDK\Dispatching\Endpoints\Batches\Requests\FindBatchRequest;

final class Batches
{
    /** @var ApiClient */
    private $client;

    public function __construct(ApiClient $client)
    {
        $this->client = $client;
    }

    /**
     * Получение партии по имени (идентификатору).
     *
     * @see https://otpravka.pochta.ru/specification#/batches-find_batch
     *
     * @param  string  $name  имя (идентификатор) партии
     *
     * @throws OrderNotFound
     *
     * @return Batch
     */
    public function getByName(string $name): Batch
    {
        try {
            return $this->client->get("/1.0/batch/{$name}", null, Batch::class);
        } catch (BadRequest $e) {
            throw new BatchNotFound($name, $e);
        }
    }

    /**
     * Поиск партий.
     *
     * @see https://otpravka.pochta.ru/specification#/batches-search_all_batches
     *
     * @param  FindBatchRequest  $request
     *
     * @return iterable|Batch[]|null
     */
    public function find(FindBatchRequest $request): ?iterable
    {
        $response = $this->client->get('/1.0/batch', $request, new ArrayOf(Batch::class));

        return empty($response) ? null : $response;
    }

    /**
     * Запрос данных о заказах в партии.
     *
     * @see https://otpravka.pochta.ru/specification#/batches-get_info_about_orders_in_batch
     *
     * @param  string  $name
     *
     * @return Order[]
     */
    public function getOrders(string $name)
    {
        return $this->client->get("/1.0/batch/{$name}/shipment", null, new ArrayOf(Order::class));
    }

    public function getOrderById(string $id): Order
    {
        try {
            return $this->client->get("/1.0/shipment/{$id}", null, Order::class);
        } catch (BadRequest $e) {
            throw new OrderNotFound($id, $e);
        }
    }

    /**
     * @param  string  $barcode
     * @return Order|null
     */
    public function findOrderByTrackingNumber(string $barcode): ?Order
    {
        return $this->client->get('/1.0/shipment/search', GenericRequest::create(['query' => $barcode]), Order::class);
    }
}