izopi4a/econt-bundle

econt curier bundle for symfony

v1.0.1 2025-04-27 17:38 UTC

Requires

• php: ^8.4

MIT

• izopi4a

README

api docs by econt here: https://www.econt.com/developers/soap-json-api.html This doesn't cover all the Econt API. I developed what I needed, if you need help or more APIs just open an issue I will add them.

Install

composer require izopi4a/econt-bundle

Post install

add this to your enviorment variables

IZOPI4A_ECONT_USER=
IZOPI4A_ECONT_PASS=
IZOPI4A_ECONT_LOCALE=BG
IZOPI4A_ECONT_DEV=true

Usage

It is a service, so you can autowire it. Example:

#[Route('/{_locale<%app.supported_locales%>}', name: 'app_home')]
public function index(EcontService $econtService): Response
{

    $offices_in_sofia = $econtService->getOfficesInCity(41);
    
    dd($offices_in_sofia)
}

Calculating delivery

$sender = new \Izopi4a\EcontBundle\Service\Http\Payload\Party();
$sender->setTypeSender();
$sender->setOffice(1000);


$receiver = new \Izopi4a\EcontBundle\Service\Http\Payload\Party();
$receiver->setTypeReciever();
// to specify office use
//$receiver->setOffice(1100);
//to specify home address use
$receiver->setAddress(41, "Незабравка", 31, "");

$package = new \Izopi4a\EcontBundle\Service\Http\Payload\Package();
$package->setWeight(1);
$package->setDescription("обувки");
$package->setCount(2);
//to add cash on delivery uncomment
//$package->addCashOnDelivery(200);

$sender_contact = new \Izopi4a\EcontBundle\Service\Http\Payload\Contact();
$sender_contact->setName("Иван Иванов");
$sender_contact->addPhone("0888888888");
$sender_contact->setTypeSender();

$receiver_contact = new \Izopi4a\EcontBundle\Service\Http\Payload\Contact();
$receiver_contact->setName("Иван Иванов");
$receiver_contact->addPhone("0888888888");
$receiver_contact->setTypeReciever();

$shipment = $econtService->calculateDelivery($sender, $receiver, $package, $sender_contact, $receiver_contact);

//you can check for errors with $shipment->getErrors() or $shipment->hasErrors()

dd($shipment->getTotalPrice(), $shipment);

Getting all the cities

I didn't find an option to filter the cities, so Econt are returning ~6k cities, in my case I store them in my database so I can use them faster. Example entity / php bin/console make:entity City

<?php

namespace App\Entity;

use App\Repository\CityRepository;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: CityRepository::class)]
class City
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(length: 255)]
    private ?string $name_bg = null;

    #[ORM\Column(length: 255)]
    private ?string $name_en = null;

    #[ORM\Column(nullable: true)]
    private ?int $econt_id = null;

    #[ORM\Column(nullable: true)]
    private ?int $speedy_id = null;

    #[ORM\Column(length: 255)]
    private ?string $post_code = null;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getNameBg(): ?string
    {
        return $this->name_bg;
    }

    public function setNameBg(string $name_bg): static
    {
        $this->name_bg = $name_bg;

        return $this;
    }

    public function getNameEn(): ?string
    {
        return $this->name_en;
    }

    public function setNameEn(string $name_en): static
    {
        $this->name_en = $name_en;

        return $this;
    }

    public function getEcontId(): ?int
    {
        return $this->econt_id;
    }

    public function setEcontId(?int $econt_id): static
    {
        $this->econt_id = $econt_id;

        return $this;
    }

    public function getSpeedyId(): ?int
    {
        return $this->speedy_id;
    }

    public function setSpeedyId(?int $speedy_id): static
    {
        $this->speedy_id = $speedy_id;

        return $this;
    }

    public function getPostCode(): ?string
    {
        return $this->post_code;
    }

    public function setPostCode(string $post_code): static
    {
        $this->post_code = $post_code;

        return $this;
    }
}

and example command. Just use php bin/console to start the command. And then replace execute method

protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);
        $repo = $this->entityManager->getRepository(City::class);
        $inserted = 0;

        $items = $this->econtService->getAllCitiesInCountry();

        foreach ($items as $econtCity) {
            $exists = $repo->findOneBy(['econt_id' => $econtCity->getId()]);

            if (!$exists) {
                $city = new City();
                $city->setNameBg($econtCity->getName());
                $city->setNameEn($econtCity->getNameEn());
                $city->setEcontId($econtCity->getId());
                $city->setPostCode($econtCity->getPostCode());
                $this->entityManager->persist($city);
                $inserted++;
            }
        }

        $this->entityManager->flush();

        $io->success('Done. Inserted '.$inserted.' cities.');

        return Command::SUCCESS;
    }