Shipment::addAction

public function addAction(array $fields)
{
	$data = [];

	$data['ORDER']['ID'] = $fields['ORDER_ID'];
	$data['ORDER']['SHIPMENTS'] = [$fields];

	$builder = $this->getBuilder(
		new SettingsContainer([
			'deleteShipmentIfNotExists' => false,
			'deleteShipmentItemIfNotExists' => false,
		])
	);
	$builder->buildEntityShipments($data);

	if($builder->getErrorsContainer()->getErrorCollection()->count()>0)
	{
		$this->addErrors($builder->getErrorsContainer()->getErrors());
		return null;
	}

	$order = $builder->getOrder();

	$idx=0;
	$collection = $order->getShipmentCollection();
	/** @var BitrixSaleShipment $shipment */
	foreach($collection as $shipment)
	{
		if($shipment->getId() <= 0)
		{
			$idx = $shipment->getInternalIndex();
			break;
		}
	}

	$r = $order->save();
	if(!$r->isSuccess())
	{
		$this->addErrors($r->getErrors());
		return null;
	}
	elseif ($r->hasWarnings())
	{
		$this->addErrors($r->getWarnings());
		return null;
	}

	/** @var BitrixSaleShipment $entity */
	$entity = $order->getShipmentCollection()->getItemByIndex($idx);
	return ['SHIPMENT'=>$this->get($entity)];
}