stas-plov/jde-shipping

Library for interaction with the ZheldorExpedition API

v1.0.0 2024-10-15 08:11 UTC

Requires

• php: >=7.4
• ext-json: *
• doctrine/annotations: ^2.0
• jms/serializer: ^3.30
• symfony/http-client: ^5.4

Requires (Dev)

• phpunit/phpunit: ^11.3
• psr/log: ^1.0 || ^2.0 || ^3.0

MIT

• Stas Plov

• php
• rest
• api
• shipping
• jde

README

Features:

• Cost Calculation
  • Delivery cost calculation by addresses
  • Delivery cost calculation
  • SMART delivery cost calculation (by city names)
• Requests
  • New delivery request
  • List of requests
• Shipments
  • Receiving new shipment statuses
  • Shipment delivery status by waybill number
  • Simplified shipment delivery status by waybill number
  • Setting a delivery restriction on a shipment
• Services
  • Receiving a list of service codes
  • Receiving information on shipment services
  • Receiving a package of documents
  • Receiving payment data for services
• Geography
  • Searching for terminals by KLADR
  • Searching for cities by types
  • Searching by terminal type
  • Branch working hours
• Documents
  • Receiving documents
  • Receiving a list of document codes

Installation

composer require StasPlov/jde-shipping

How to use

$jdeShipping = new JdeShipping();

$jdeShipping->setUser('1234');
$jdeShipping->setToken('1234');

$geo = new GeoSearchRequest();
$geo ->setMode(1);

$result = $jdeShipping->getGeoSearch($geo);

Cost Calculation

Delivery cost calculation by addresses

$shipmentCalc = (new ShipmentCostCalcByAddressRequest())
	->setAddrFrom('владивосток')
	->setAddrTo('москва')
	->setType(1)
	->setWeight(2.167)
	->setWidth(0.121)
	->setHeight(0.121)
	->setLength(2.135)
	->setQuantity(1)
	->setPickup(1)
	->setDelivery(1)
	->setDeclared(3670)
	->setOversizeWeight(1)
	->setOversizeVolume(1)
	->setObrVolume(0.031);

$result = $this->jdeShipping->getShipmentCostCalcByAddress($shipmentCalc);

if($result->isOk()) {
	$cost = $result->getPrice();
}

Delivery cost calculation

$shipmentCalc = (new ShipmentCostCalcRequest())
	->setFrom('1010005858')
	->setTo('1125904247254472')
	->setType(1)
	->setWeight(216)
	->setVolume(0.41);

$result = $this->jdeShipping->getShipmentCostCalcByAddress($shipmentCalc);

if($result->isOk()) {
	$cost = $result->getPrice();
}

SMART delivery cost calculation (by city names)

$shipmentCalc = (new ShipmentCostCalcRequest())
	->setFrom('Москва')
	->setTo('Владивосток')
	->setType(1)
	->setWeight(216)
	->setVolume(0.41)
	->setSmart(true);
	

$result = $this->jdeShipping->getShipmentCostCalcByAddress($shipmentCalc);

if($result->isOk()) {
	$cost = $result->getPrice();
}

Order Requests

New delivery request

$order = (new OrderCreateRequest())
	->setFrom("1125899906842653")
	->setTo("1125899906842629")
	->setVolume(1)
	->setWeight(1)
	->setPositions(2)
	->setGruzdesc("Бытовая техника и электроника")
	->setPayer(JdeShipping::PAYER_SENDER)
	->setSender(
		(new PersonSender)
			->setAddr("Санкт-Петербург, Невский 30-2-12")
			->setTitle("ООО Отправитель")
			->setPhone("[phone]")
	)
	->setReceiver(
		(new PersonReceiver)
			->setAddr("г. Москва, ул. 2-й Лучевой просек, д. 5В")
			->setTitle("ООО Получатель")
			->setPhone("[phone]")
	);

$result = $this->jdeShipping->sendOrderCreate($geoKladr);

$orderNumber = $result->getOrderNumber();

List of requests

$geoKladr = new OrderListRequest();

$response = $this->jdeShipping->getOrderList($geoKladr);

if(!empty($result)) {
	$id = $result[0]->getId();
	$cargoStatus = $result[0]->getInfo()->getCargostatus()
}

Geography

Searching for terminals by KLADR

$geoKladr = (new GeoSearchByKladrRequest())
	->setKladrCode('5002700102400');

$result = $this->jdeShipping->getGeoSearchByKladr($geoKladr);

if(!empty($result)) {
	$city = $result[0]->getCity();
	$address = $result[0]->getAddr();
}