mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 14:10:28 +01:00
2173 lines
70 KiB
Plaintext
2173 lines
70 KiB
Plaintext
<?php
|
|
|
|
if (!class_exists('Versanddienstleister')) {
|
|
require_once dirname(__DIR__) . '/class.versanddienstleister.php';
|
|
}
|
|
|
|
/**
|
|
* Request & Response Exceptions
|
|
*/
|
|
interface ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
/**
|
|
* Class ParcelOneReplacer
|
|
*
|
|
* Register some placeholders (with their values) as array
|
|
* and replace each substring of {KEY}, {key}, {{KEY}} or {{key}} with
|
|
* its value.
|
|
*/
|
|
class ParcelOneReplacer
|
|
{
|
|
private $replacements = [];
|
|
|
|
/**
|
|
* DPDe_Placeholders constructor.
|
|
*
|
|
* @param array $replacements
|
|
*/
|
|
public function __construct($replacements)
|
|
{
|
|
$replacements = array_filter($replacements, static function($e){
|
|
return is_string($e) || is_numeric($e);
|
|
});
|
|
$replacements = array_filter($replacements, 'is_string', ARRAY_FILTER_USE_KEY);
|
|
$replacements = array_change_key_case($replacements, CASE_UPPER);
|
|
|
|
$this->replacements = $replacements;
|
|
}
|
|
|
|
/**
|
|
* Search and replace variables in string.
|
|
*
|
|
* Replaces all placeholders in upper or lower case within single or double curly brackets
|
|
* @param string $message
|
|
*
|
|
* E.G.: Would convert "hello {customer}." to "hello awesome people."
|
|
* if array to __construct was like ['customer' => 'awesome people']
|
|
*
|
|
* @return string
|
|
*/
|
|
public function handle($message)
|
|
{
|
|
if (!is_string($message)) {
|
|
$type = gettype($message);
|
|
throw new RuntimeException(sprintf(
|
|
'Expected message as string, got %s.', $type
|
|
));
|
|
}
|
|
|
|
if (empty($this->replacements)) {
|
|
return $message;
|
|
}
|
|
|
|
foreach ($this->replacements as $key => $value) {
|
|
$value = (string) $value;
|
|
|
|
// key with one bracket
|
|
$key = '{' . trim($key, '{}') . '}';
|
|
$message = str_replace([$key, strtolower($key)], [$value, $value], $message);
|
|
// key with two brackets
|
|
$key = '{' . $key . '}';
|
|
$message = str_replace([$key, strtolower($key)], [$value, $value], $message);
|
|
}
|
|
|
|
return $message;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* This abstract class is designed to simplify a new 'delivery tool'
|
|
*
|
|
* Class AbstractVersandart
|
|
*/
|
|
abstract class AbstractVersandartParcelone extends Versanddienstleister
|
|
{
|
|
public $einstellungen = [];
|
|
public $export_drucker;
|
|
public $paketmarke_drucker;
|
|
|
|
/**
|
|
* Copied from other 'versandart modules', added
|
|
* the RuntimeException for json decode.
|
|
*
|
|
* AbstractVersandart constructor.
|
|
*
|
|
* @param app_t $app
|
|
* @param int $id
|
|
*/
|
|
final public function __construct($app, $id)
|
|
{
|
|
$this->id = $id;
|
|
$this->app = &$app;
|
|
$settings = $this->app->DB->Select("SELECT einstellungen_json FROM versandarten WHERE id = '$id' LIMIT 1");
|
|
|
|
$this->paketmarke_drucker = $this->app->DB->Select("SELECT paketmarke_drucker FROM versandarten WHERE id = '$id' LIMIT 1");
|
|
$this->export_drucker = $this->app->DB->Select("SELECT export_drucker FROM versandarten WHERE id = '$id' LIMIT 1");
|
|
|
|
if ($settings) {
|
|
$settings = json_decode($settings, true);
|
|
if (json_last_error()) {
|
|
throw new RuntimeException(sprintf(
|
|
'JSON decode failed in %s with %s.', get_class($this), json_last_error_msg()
|
|
));
|
|
}
|
|
} else {
|
|
$settings = [];
|
|
}
|
|
$this->einstellungen = $settings;
|
|
$this->ctrHook();
|
|
}
|
|
|
|
/**
|
|
* Just a hook run if the ctr had his job done.
|
|
*
|
|
* @return void
|
|
*/
|
|
abstract protected function ctrHook();
|
|
|
|
/**
|
|
*
|
|
* Called via 'versandzentrum'
|
|
* Thanks to 'sevensenders.php'
|
|
*
|
|
* @param int|string $id
|
|
* @param $sid
|
|
*
|
|
* @return array
|
|
*/
|
|
public function PaketmarkeDrucken($id, $sid)
|
|
{
|
|
$adressdaten = $this->GetAdressdaten($id, $sid);
|
|
$ret = $this->Paketmarke($sid, $id, '', false, $adressdaten);
|
|
|
|
if ($sid !== 'lieferschein') {
|
|
return $ret;
|
|
}
|
|
|
|
$deliveryNoteArr = $this->app->DB->SelectRow("SELECT adresse, versandart, projekt FROM lieferschein WHERE id = '$id' LIMIT 1");
|
|
$adresse = $deliveryNoteArr['adresse'];
|
|
$project = $deliveryNoteArr['projekt'];
|
|
$versandart = $deliveryNoteArr['versandart'];
|
|
$addressValidation = 2;
|
|
if ($ret) {
|
|
$addressValidation = 1;
|
|
}
|
|
|
|
$tracking = null;
|
|
// $tracking = $this->tracking; // $this->tracking is not set in 'sevensenders.php'
|
|
if (isset($adressdaten['tracking'])) {
|
|
$tracking = $adressdaten['tracking'];
|
|
}
|
|
$this->app->DB->Insert("INSERT INTO versand (versandunternehmen, tracking,
|
|
versendet_am,abgeschlossen,lieferschein,freigegeben,firma,adresse,projekt,paketmarkegedruckt,adressvalidation)
|
|
VALUES ('$versandart','$tracking',NOW(),1,'$id',1,'1','$adresse','$project',1,'$addressValidation') ");
|
|
if ($addressValidation === 1) {
|
|
$this->app->erp->LieferscheinProtokoll($id, 'Paketmarke automatisch gedruckt');
|
|
} elseif ($addressValidation === 2) {
|
|
$this->app->erp->LieferscheinProtokoll($id, 'automatisches Paketmarke Drucken fehlgeschlagen');
|
|
}
|
|
|
|
return $ret;
|
|
}
|
|
|
|
/**
|
|
* This method is the 'main' part of all delivery tools.
|
|
*
|
|
* Available via Lager -> Lieferschein
|
|
* index.php?module=lieferschein&action=paketmarke&id={id}
|
|
* or Lager -> Versandzentrum
|
|
* index.php?module=versanderzeugen&action=frankieren&id={id}
|
|
* or Lager -> Retoure
|
|
* index.php?module=retoure&action=paketmarke&id={id}
|
|
*
|
|
* called via erpapi->Paketmarke($parsetarget,$sid="",$zusatz="",$typ="DHL") as:
|
|
* $error = $obj->Paketmarke($sid!=''?$sid:'lieferschein',($sid=='versand'?$id:$tid), $parsetarget, $error);
|
|
*
|
|
* Reads the address data and package data via '$this->app->Secure->GetPOST' or from '$adressdaten' array.
|
|
*
|
|
* @param string $doctyp 'lieferschein' / 'versand' / 'retoure'
|
|
* @param string|int $id '1'
|
|
* @param string $target '#TAB1'
|
|
* @param bool $error
|
|
* @param null|array $adressdaten
|
|
*
|
|
* @return array
|
|
*/
|
|
final public function Paketmarke($doctyp, $id, $target = '', $error = false, &$adressdaten = null)
|
|
{
|
|
if (is_string($id) && is_numeric($id)) {
|
|
$id = (int)$id;
|
|
}
|
|
if (!is_int($id)) {
|
|
$type = gettype($id);
|
|
throw new ArgumentTypeException('Expected id as integer, got ' . $type);
|
|
}
|
|
if (!is_string($doctyp)) {
|
|
$type = gettype($doctyp);
|
|
throw new ArgumentTypeException('Expected doctyp as string, got ' . $type);
|
|
}
|
|
$allowedTypes = ['lieferschein', 'versand', 'retoure'];
|
|
if ($adressdaten === null) {
|
|
$doctyp = $this->getModuleName($doctyp, $allowedTypes);
|
|
}
|
|
if (!in_array($doctyp, $allowedTypes, true)) {
|
|
throw new RuntimeException('Only \'Lieferschein\' is supported, got ' . $doctyp);
|
|
}
|
|
|
|
$this->validateSettings();
|
|
|
|
if (is_array($adressdaten) && !empty($adressdaten)) {
|
|
|
|
$address = [
|
|
'name' => $adressdaten['name'],
|
|
'name2' => $adressdaten['name2'],
|
|
'name3' => $adressdaten['name3'],
|
|
'street' => $adressdaten['strassekomplett'],
|
|
'street_no' => $adressdaten['hausnummer'],
|
|
'plz' => $adressdaten['plz'],
|
|
'ort' => $adressdaten['ort'],
|
|
'email' => $adressdaten['email'],
|
|
'phone' => $adressdaten['phone'],
|
|
'land' => $adressdaten['land'],
|
|
// bundesstaat
|
|
];
|
|
|
|
// $anzahl = (int)isset($adressdaten["anzahl"])?$adressdaten["anzahl"]:0;
|
|
// $nummeraufbeleg = "";//$this->app->Secure->GetPOST("nummeraufbeleg");
|
|
// if ($anzahl <= 0 || !is_int($anzahl)) $anzahl = 1;
|
|
// $laenge = isset($adressdaten["laenge"])?$adressdaten["laenge"]:'';
|
|
// $breite = isset($adressdaten["breite"])?$adressdaten["breite"]:'';
|
|
// $hoehe = isset($adressdaten["hoehe"])?$adressdaten["hoehe"]:'';
|
|
|
|
$cash_on_delivery = isset($adressdaten['Nachnahme']) ? $adressdaten['Nachnahme'] : 0;
|
|
$packageData = [
|
|
'kg1' => $adressdaten['standardkg'],
|
|
'drucken' => '1',
|
|
'anders' => '',
|
|
'tracking_again' => '',
|
|
'module' => $doctyp,
|
|
|
|
'versandmit' => '', // $this->app->Secure->GetPOST('versandmit'),
|
|
'trackingsubmit' => '', // $this->app->Secure->GetPOST('trackingsubmit'),
|
|
'versandmitbutton' => '', // $this->app->Secure->GetPOST('versandmitbutton'),
|
|
'tracking' => '', // $this->app->Secure->GetPOST('tracking'),
|
|
'trackingsubmitcancel' => '', // $this->app->Secure->GetPOST('trackingsubmitcancel'),
|
|
'retourenlabel' => '', // $this->app->Secure->GetPOST('retourenlabel'),
|
|
'nachnahme' => (int)$cash_on_delivery,
|
|
'product' => '',
|
|
];
|
|
|
|
} else {
|
|
$address = [
|
|
'name' => $this->app->Secure->GetPOST('name'),
|
|
'name2' => $this->app->Secure->GetPOST('name2'),
|
|
'name3' => $this->app->Secure->GetPOST('name3'),
|
|
'street' => $this->app->Secure->GetPOST('strasse'),
|
|
'street_no' => $this->app->Secure->GetPOST('hausnummer'),
|
|
'plz' => $this->app->Secure->GetPOST('plz'),
|
|
'ort' => $this->app->Secure->GetPOST('ort'),
|
|
'email' => $this->app->Secure->GetPOST('email'),
|
|
'phone' => $this->app->Secure->GetPOST('phone'),
|
|
'land' => $this->app->Secure->GetPOST('land'),
|
|
];
|
|
$packageData = [
|
|
'kg1' => $this->app->Secure->GetPOST('kg1'),
|
|
'drucken' => $this->app->Secure->GetPOST('drucken'),
|
|
'anders' => $this->app->Secure->GetPOST('anders'),
|
|
'tracking_again' => $this->app->Secure->GetGET('tracking_again'),
|
|
'module' => $this->app->Secure->GetGET('module'),
|
|
'versandmit' => $this->app->Secure->GetPOST('versandmit'),
|
|
'trackingsubmit' => $this->app->Secure->GetPOST('trackingsubmit'),
|
|
'versandmitbutton' => $this->app->Secure->GetPOST('versandmitbutton'),
|
|
'tracking' => $this->app->Secure->GetPOST('tracking'),
|
|
'trackingsubmitcancel' => $this->app->Secure->GetPOST('trackingsubmitcancel'),
|
|
'retourenlabel' => $this->app->Secure->GetPOST('retourenlabel'),
|
|
// 'product' => $this->app->Secure->GetPOST('products'),
|
|
'nachnahme' => $this->app->Secure->GetPOST('nachnahme'),
|
|
];
|
|
}
|
|
|
|
// $packageData['clients_reference'] = $this->app->Secure->GetPOST('clients_reference');
|
|
// $packageData['shipment_reference'] = $this->app->Secure->GetPOST('shipment_reference');
|
|
$packageData['service'] = $this->app->Secure->GetPOST('service');
|
|
|
|
/*
|
|
* This is in 'sevensenders.php' only called, if $addressdata === null. But why?
|
|
*/
|
|
$this->setNachnahmeCheckbox($doctyp, $id);
|
|
|
|
$ret = [];
|
|
if (!empty($address)) {
|
|
try {
|
|
// throw new RuntimeException('Ooops - data missing');
|
|
$this->createPaketmarke($doctyp, $id, $target, $error, $address, $packageData);
|
|
} catch (Exception $e) {
|
|
$ret[] = $e->getMessage();
|
|
}
|
|
}
|
|
|
|
if ($target) {
|
|
$this->parseTemplate($target);
|
|
}
|
|
|
|
return $ret;
|
|
}
|
|
|
|
/**
|
|
* Get the module name.
|
|
*
|
|
* @param string $doctype
|
|
* @param array $allowedTypes
|
|
*
|
|
* @return string
|
|
*/
|
|
private function getModuleName($doctype, $allowedTypes)
|
|
{
|
|
// // in sevensenders:
|
|
// if($adressdaten === null){
|
|
// $module = $this->app->Secure->GetGET('module');
|
|
// }else{
|
|
// $module = $doctyp;
|
|
// }
|
|
|
|
$tmp = $this->app->Secure->GetGET('module');
|
|
if (is_array($tmp)) {
|
|
$tmp = array_filter($tmp);
|
|
$tmp = array_filter($tmp, 'is_string');
|
|
if (array_key_exists(0, $tmp)) {
|
|
$tmp = $tmp[0];
|
|
} else {
|
|
$tmp = '';
|
|
}
|
|
}
|
|
if (in_array($tmp, $allowedTypes, true)) {
|
|
return (string)$tmp;
|
|
}
|
|
|
|
return $doctype;
|
|
}
|
|
|
|
/**
|
|
* Check if all settings are set and not empty.
|
|
* Uses $this->settingsStructure() to get all
|
|
* required settings. Empty settings are not allowed!
|
|
* Respects select options (drop-down menus). Uses
|
|
* the shown labels in the exceptions.
|
|
*
|
|
* @throws RuntimeException
|
|
*/
|
|
protected function validateSettings()
|
|
{
|
|
$settings = $this->EinstellungenStruktur();
|
|
foreach ($settings as $key => $setting) {
|
|
$name = rtrim($setting['bezeichnung'], ':');
|
|
|
|
if (!array_key_exists($key, $this->einstellungen)) {
|
|
if (array_key_exists('optional', $setting) && $setting['optional'] === true) {
|
|
continue;
|
|
}
|
|
if (array_key_exists('typ', $setting) && strtolower((string)$setting['typ']) === 'checkbox') {
|
|
continue;
|
|
}
|
|
if (array_key_exists('default', $setting)) {
|
|
$value = $setting['default'];
|
|
// if default value is empty, don't run other validations.
|
|
|
|
$this->einstellungen[$key] = $value;
|
|
|
|
if (empty($value)) {
|
|
continue;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!array_key_exists($key, $this->einstellungen)) {
|
|
throw new RuntimeException(sprintf(
|
|
'Setting \'%s\' is missing.', $name
|
|
));
|
|
}
|
|
|
|
$value = $this->einstellungen[$key];
|
|
|
|
/*
|
|
* Check 'size' argument for maximum length.
|
|
*/
|
|
if (array_key_exists('maxLength', $setting) && is_numeric($setting['maxLength'])) {
|
|
$maxLength = (int) $setting['maxLength'];
|
|
if ($maxLength > 0 && strlen($value) > $maxLength) {
|
|
throw new RuntimeException(sprintf(
|
|
'Setting \'%s\' raised it\'s maximum length of %s.', $name, $maxLength
|
|
));
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Respect select fields.
|
|
*/
|
|
if (array_key_exists('optionen', $setting) && $setting['type'] === 'select') {
|
|
$options = $setting['optionen'];
|
|
$keys = array_keys($options);
|
|
|
|
if (!in_array($value, $keys, true)) {
|
|
$values = array_values($options);
|
|
$options = implode(', ', $values);
|
|
throw new RuntimeException(sprintf(
|
|
'Setting \'%s\' is not allowed, allowed values are: %s.', $name, $options
|
|
));
|
|
}
|
|
continue;
|
|
}
|
|
|
|
if (array_key_exists('regex', $setting) && is_string($setting['regex'])) {
|
|
|
|
$pattern = $setting['regex'];
|
|
$pattern = trim($pattern, '/');
|
|
$pattern = ltrim($pattern, '^');
|
|
$pattern = rtrim($pattern, '$');
|
|
$pattern = '/^' . $pattern . '$/';
|
|
$match = preg_match($pattern, $value);
|
|
|
|
if ($match === false) {
|
|
throw new RuntimeException(sprintf(
|
|
'Invalid regex pattern for \'%s\'.', $name
|
|
));
|
|
}
|
|
if ($match !== 1) {
|
|
throw new RuntimeException(sprintf(
|
|
'Setting \'%s\' does not match it\'s regex pattern.', $name
|
|
));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Print the created file.
|
|
*
|
|
* @param string $filename
|
|
* @param string $content
|
|
* @param int $versandId
|
|
*
|
|
* @throws RuntimeException
|
|
*/
|
|
protected function printFile($filename, $content, $versandId)
|
|
{
|
|
$printer = $this->getPrinter();
|
|
if (!$printer) {
|
|
throw new RuntimeException('No printer configured.');
|
|
}
|
|
|
|
if (!is_string($filename)) {
|
|
$type = gettype($filename);
|
|
throw new RuntimeException(sprintf(
|
|
'Expected filename as string, got %s.', $type
|
|
));
|
|
}
|
|
|
|
if (empty($filename)) {
|
|
throw new RuntimeException(
|
|
'Empty filename is not supported.'
|
|
);
|
|
}
|
|
|
|
if (!is_string($content)) {
|
|
$type = gettype($content);
|
|
throw new RuntimeException(sprintf(
|
|
'Expected content as string, got %s.', $type
|
|
));
|
|
}
|
|
|
|
if (empty($content)) {
|
|
throw new RuntimeException(sprintf(
|
|
'Empty content for document %s is not supported.', $filename
|
|
));
|
|
}
|
|
|
|
$tmpPath = $this->app->erp->GetTMP();
|
|
$full = $tmpPath . $filename;
|
|
|
|
if (!file_put_contents($full, $content)) {
|
|
throw new RuntimeException(sprintf(
|
|
'Could not write file \'%s\'.', $filename
|
|
));
|
|
}
|
|
|
|
$spoolerId = $this->app->printer->Drucken($printer, $full);
|
|
unlink($full);
|
|
|
|
if($versandId && $spoolerId) {
|
|
$this->app->DB->Update(
|
|
sprintf(
|
|
'UPDATE versand SET lastspooler_id = %d, lastprinter = %d WHERE id = %d',
|
|
$spoolerId, $printer, $versandId
|
|
)
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return the html structure displayed in the
|
|
* 'versandarten' module to add some extra
|
|
* input fields for api keys etc.
|
|
*
|
|
* Displayed via class 'Versanddienstleister' located
|
|
* in ../class.versanddienstleister.php
|
|
*
|
|
* @return array
|
|
*/
|
|
abstract protected function EinstellungenStruktur();
|
|
|
|
/**
|
|
* Set the 'nachnahme' checkbox field.
|
|
*
|
|
* Thanks to 'sevensenders.php'
|
|
*
|
|
* @param string $doctyp
|
|
* @param int|string $id
|
|
*/
|
|
private function setNachnahmeCheckbox($doctyp, $id)
|
|
{
|
|
if ($doctyp === 'lieferschein') {
|
|
$lieferschein = $id;
|
|
} elseif ($doctyp === 'retoure') {
|
|
$lieferschein = $this->app->DB->Select("SELECT lieferschein FROM retoure WHERE id='$id' LIMIT 1");
|
|
} else {
|
|
$lieferschein = $this->app->DB->Select("SELECT lieferschein FROM versand WHERE id='$id' LIMIT 1");
|
|
if ($lieferschein <= 0) {
|
|
$lieferschein = $id;
|
|
}
|
|
}
|
|
|
|
$rechnung = $this->app->DB->Select("SELECT id FROM rechnung WHERE lieferschein='$lieferschein' LIMIT 1");
|
|
$zahlungsweise = $this->app->DB->Select("SELECT zahlungsweise FROM rechnung WHERE id='$rechnung' LIMIT 1");
|
|
if ($zahlungsweise === 'nachnahme') {
|
|
$this->app->Tpl->Set('NACHNAHME', 'checked="checked"');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Create the package labels.
|
|
*
|
|
* Called via Paketmarke or PaketmarkeDrucken
|
|
*
|
|
* @param string $doctyp
|
|
* @param string $id
|
|
* @param string $target
|
|
* @param bool $error
|
|
* @param array $adressdaten
|
|
* @param array $packageData
|
|
*
|
|
* @return array list of error messages
|
|
*/
|
|
abstract protected function createPaketmarke($doctyp, $id, $target, $error, $adressdaten, $packageData);
|
|
|
|
/**
|
|
* Parse the template.
|
|
*
|
|
* @param string $target
|
|
*
|
|
* @return void
|
|
*/
|
|
abstract protected function parseTemplate($target);
|
|
|
|
/**
|
|
* May change the tracking id before inserting into the db.
|
|
*
|
|
* @param string $tracking
|
|
*
|
|
* @return string
|
|
*/
|
|
public function TrackingReplace($tracking)
|
|
{
|
|
return $tracking;
|
|
}
|
|
|
|
/**
|
|
* Extract the child's name and create
|
|
* a default module name via 'ucfirst'.
|
|
*
|
|
* E.G. converts child's class name
|
|
* 'Versandart_parcelone' to 'Parcelone'.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function GetBezeichnung()
|
|
{
|
|
$c = get_class($this);
|
|
$c = explode('_', $c);
|
|
$c = array_filter($c);
|
|
$c = array_pop($c);
|
|
$c = ucfirst($c);
|
|
|
|
return $c;
|
|
}
|
|
|
|
/**
|
|
* Load the data given by the current document type and it's id.
|
|
*
|
|
* @param string $documentTyp on of 'lieferschein', 'versand' or 'retoure'
|
|
* @param int $id
|
|
*
|
|
* @throws RuntimeException
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function getDocumentByID($documentTyp, $id)
|
|
{
|
|
/*
|
|
* var $documentTyp may be:
|
|
* - 'lieferschein'
|
|
* - 'versand'
|
|
* - 'retoure'
|
|
*
|
|
* - 'auftrag'
|
|
*/
|
|
$documentTyp = $this->app->DB->real_escape_string($documentTyp);
|
|
$sql = sprintf('SELECT * FROM %s WHERE id = %s LIMIT 1', $documentTyp, $id);
|
|
|
|
$data = $this->app->DB->SelectArr($sql);
|
|
$error = $this->app->DB->error();
|
|
|
|
if ($error) {
|
|
$error = htmlspecialchars($error);
|
|
$msg = sprintf('SQL SelectArr error: \'%s\', query was \'%s\'', $error, $sql);
|
|
throw new RuntimeException($msg);
|
|
}
|
|
|
|
if (!is_array($data) || !array_key_exists(0, $data) || !is_array($data[0]) || !$data[0]) {
|
|
throw new RuntimeException(sprintf(
|
|
'No data for document %s with id %s found.', $documentTyp, $id
|
|
));
|
|
}
|
|
|
|
$data = $data[0];
|
|
|
|
return $data;
|
|
}
|
|
|
|
/**
|
|
* Return the 'standard Paketmarkendrucker'.
|
|
*
|
|
* Checks GetPOST: drucken
|
|
* Checks GetGET: tracking_again
|
|
*
|
|
* @return int
|
|
*/
|
|
protected function getPrinter()
|
|
{
|
|
if (is_numeric($this->paketmarke_drucker) && $this->paketmarke_drucker) {
|
|
return $this->paketmarke_drucker;
|
|
}
|
|
|
|
$printer = (int) $this->app->erp->GetStandardPaketmarkendrucker();
|
|
if ($printer) {
|
|
return $printer;
|
|
}
|
|
|
|
return $this->export_drucker;
|
|
}
|
|
|
|
/**
|
|
* Get the current user name as escaped string.
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function getUserName()
|
|
{
|
|
$user = $this->app->User->GetName();
|
|
$user = $this->app->DB->real_escape_string($user);
|
|
|
|
return $user;
|
|
}
|
|
|
|
/**
|
|
* Load an address via it's id.
|
|
*
|
|
* @param string|int $id
|
|
* @param string|array $fields Filter these columns, default all
|
|
*
|
|
* @throws RuntimeException
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function loadAddress($id, $fields = '*')
|
|
{
|
|
if (is_string($id) && is_numeric($id)) {
|
|
$id = (int)$id;
|
|
}
|
|
if (!is_int($id)) {
|
|
$type = gettype($id);
|
|
throw new ArgumentTypeException('Expected addressID as int, got ' . $type);
|
|
}
|
|
|
|
$fields = (array)$fields;
|
|
$fields = array_values($fields);
|
|
$fields = array_filter($fields);
|
|
$fields = array_filter($fields, 'is_string');
|
|
if (in_array('*', $fields, true)) {
|
|
$fields = '*';
|
|
} else {
|
|
$tmp = [];
|
|
foreach ($fields as $field) {
|
|
$tmp[] = $this->app->DB->real_escape_string($field);
|
|
}
|
|
$fields = implode(', ', $tmp);
|
|
}
|
|
|
|
$sql = sprintf('SELECT %s FROM adresse WHERE id =\'%s\'', $fields, $id);
|
|
$query = $this->app->DB->Query($sql);
|
|
$address = $query->fetch_array(MYSQLI_ASSOC);
|
|
$error = $this->app->DB->error();
|
|
|
|
if ($error) {
|
|
$error = htmlspecialchars($error);
|
|
$msg = sprintf('SQL query error: \'%s\', query was \'%s\'', $error, $sql);
|
|
throw new RuntimeException($msg);
|
|
}
|
|
|
|
if (!is_array($address)) {
|
|
$type = gettype($address);
|
|
throw new ArgumentTypeException('Expected address as array, got ' . $type);
|
|
}
|
|
|
|
return $address;
|
|
}
|
|
|
|
/**
|
|
* Get the package weight from user input.
|
|
*
|
|
* @param array $packageData
|
|
*
|
|
* @throws RuntimeException
|
|
*
|
|
* @return float
|
|
*/
|
|
protected function getWeight($packageData)
|
|
{
|
|
if (!is_array($packageData)) {
|
|
$type = gettype($packageData);
|
|
throw new ArgumentTypeException('Expected package data as array, got ' . $type);
|
|
}
|
|
if (!array_key_exists('kg1', $packageData)) {
|
|
throw new RuntimeException('Weight (kg1) is missing.');
|
|
}
|
|
|
|
$weight = $packageData['kg1'];
|
|
if (empty($weight) && $weight !== '0') {
|
|
// wtf?! why is '0' string empty?
|
|
throw new RuntimeException('The package weight is required.');
|
|
}
|
|
if (is_string($weight)) {
|
|
$weight = str_replace(',', '.', $weight);
|
|
if (is_numeric($weight)) {
|
|
$weight = (float)$weight;
|
|
}
|
|
}
|
|
if (!is_float($weight)) {
|
|
$type = gettype($weight);
|
|
throw new ArgumentTypeException('Expected weight as float, got ' . $type);
|
|
}
|
|
if ($weight < 0) {
|
|
throw new RuntimeException('A negative package weight is not supported.');
|
|
}
|
|
|
|
return $weight;
|
|
}
|
|
|
|
/**
|
|
* Build an html select element.
|
|
*
|
|
* @param string $nameID Name and ID of select element.
|
|
* @param array $select associative array
|
|
* @param string|int|null|array $selected
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function buildSelectForm($nameID, $select, $selected = null)
|
|
{
|
|
$options = [];
|
|
$nameID = htmlspecialchars($nameID);
|
|
|
|
$options[] = sprintf('<select id="%s" name="%s" style="width:23em">', $nameID, $nameID);
|
|
foreach ($select as $key => $value) {
|
|
$key = htmlspecialchars($key);
|
|
$value = htmlspecialchars($value);
|
|
|
|
$mark = $selected === $key
|
|
? 'selected="selected"'
|
|
: '';
|
|
|
|
$options[] = sprintf('<option value="%s" %s>%s</option>', $key, $mark, $value);
|
|
}
|
|
$options[] = '</select>';
|
|
|
|
return implode('', $options);
|
|
}
|
|
}
|
|
|
|
class ArgumentTypeException extends RuntimeException implements ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
class ResponseException extends RuntimeException implements ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
class NotImplementedException extends RuntimeException implements ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
class EmptyResponseException extends ResponseException implements ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
class MissingArgumentException extends RuntimeException implements ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
class MissingResponseFieldException extends ResponseException implements ParcelOneExceptionInterface
|
|
{
|
|
/**
|
|
* MissingResponseFieldException constructor.
|
|
*
|
|
* Change the exception message -> wrap it, so its enough to pass only the missed argument name.
|
|
*
|
|
* @param string $message
|
|
* @param int $code
|
|
* @param Throwable|null $previous
|
|
*
|
|
* @return static
|
|
*/
|
|
final public static function fromFieldName($message, $code = 0, Throwable $previous = null)
|
|
{
|
|
if (!$message || !is_string($message)) {
|
|
$message = 'A field is missing.';
|
|
}
|
|
$message = sprintf('The field %s is missing.', $message);
|
|
|
|
return new static($message, $code, $previous);
|
|
}
|
|
}
|
|
|
|
class SoapExtensionMissingException extends RuntimeException implements ParcelOneExceptionInterface
|
|
{
|
|
}
|
|
|
|
if (!class_exists('SoapHeader')) {
|
|
/**
|
|
* This is just a fix, if php comes without the soap extension.
|
|
*
|
|
* So the following header classes can extend this class without raising an unhandled exception just by loading this
|
|
* file. A check if the soap extension exists is located in Versandart_parcelone::EinstellungenStruktur() so the
|
|
* user cannot setup this delivery service. In addition, a check is located in
|
|
* AbstractParcelOneRequest::__construct() so it's not possible to execute a soap request if the extension is
|
|
* missing.
|
|
*
|
|
* Class SoapHeader
|
|
*/
|
|
class SoapHeader
|
|
{
|
|
public function __construct($namespace, $name, $data = null, $mustunderstand = false, $actor = '')
|
|
{
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Define some constants if the soap extension is not available so at least the class instantiation runs as expected.
|
|
*
|
|
* @url: https://www.php.net/manual/en/soap.constants.php
|
|
*/
|
|
defined('SOAP_1_1') or define('SOAP_1_1', 1);
|
|
defined('WSDL_CACHE_NONE') or define('WSDL_CACHE_NONE', 0);
|
|
defined('SOAP_COMPRESSION_GZIP') or define('SOAP_COMPRESSION_GZIP', 0);
|
|
defined('SOAP_COMPRESSION_ACCEPT') or define('SOAP_COMPRESSION_ACCEPT', 32);
|
|
|
|
/**
|
|
* Headers from documentation package.
|
|
*
|
|
* classes:
|
|
* - AuthHeader
|
|
* - APIKeyHeader
|
|
* - CultureHeader
|
|
*
|
|
* Thanks to Jörk Sternsdorff from
|
|
* Awiwe Solutions GmbH
|
|
*/
|
|
class AuthHeader extends SoapHeader
|
|
{
|
|
private $wss_ns = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd';
|
|
private $wsu_ns = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd';
|
|
|
|
/**
|
|
* AuthHeader constructor.
|
|
*
|
|
* @param string $user
|
|
* @param string $pass
|
|
*/
|
|
public function __construct($user, $pass)
|
|
{
|
|
$created = gmdate('Y-m-d\TH:i:s\Z');
|
|
$nonce = mt_rand();
|
|
$passdigest = base64_encode(pack('H*', sha1(pack('H*', $nonce) . pack('a*', $created) . pack('a*', $pass))));
|
|
|
|
$auth = new stdClass();
|
|
$auth->Username = new SoapVar($user, XSD_STRING, NULL, $this->wss_ns, NULL, $this->wss_ns);
|
|
$auth->Password = new SoapVar($pass, XSD_STRING, NULL, $this->wss_ns, NULL, $this->wss_ns);
|
|
$auth->Nonce = new SoapVar($passdigest, XSD_STRING, NULL, $this->wss_ns, NULL, $this->wss_ns);
|
|
$auth->Created = new SoapVar($created, XSD_STRING, NULL, $this->wss_ns, NULL, $this->wsu_ns);
|
|
|
|
$username_token = new stdClass();
|
|
$username_token->UsernameToken = new SoapVar($auth, SOAP_ENC_OBJECT, NULL, $this->wss_ns, 'UsernameToken', $this->wss_ns);
|
|
|
|
$security_sv = new SoapVar(
|
|
new SoapVar($username_token, SOAP_ENC_OBJECT, NULL, $this->wss_ns, 'UsernameToken', $this->wss_ns),
|
|
SOAP_ENC_OBJECT, NULL, $this->wss_ns, 'Security', $this->wss_ns);
|
|
parent::__construct($this->wss_ns, 'Security', $security_sv, true);
|
|
}
|
|
}
|
|
|
|
class APIKeyHeader extends SoapHeader
|
|
{
|
|
public function __construct($apiKey)
|
|
{
|
|
parent::__construct('apikey', 'apikey', $apiKey, false);
|
|
}
|
|
}
|
|
|
|
class CultureHeader extends SoapHeader
|
|
{
|
|
public function __construct($culture)
|
|
{
|
|
parent::__construct('culture', 'culture', $culture, false);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Class AbstractParcelOneRequest
|
|
*
|
|
* This class holds only some functionality to
|
|
* build up the soap request. It supports some
|
|
* methods to set required header.
|
|
* Nothing more.
|
|
*
|
|
* @package ParcelOne
|
|
*/
|
|
abstract class AbstractParcelOneRequest
|
|
{
|
|
/*
|
|
* Support only PA1 as carrier.
|
|
*/
|
|
const DEFAULT_CARRIER = 'PA1';
|
|
|
|
/**
|
|
* this Key is used to identify this software and not the customer.
|
|
*/
|
|
const API_KEY = '0641C551-D23A-43BB-87A9-626DAE7FFE00';
|
|
|
|
/**
|
|
* The default software attribute is injected into every request.
|
|
* It's possible to 'override' this constant in child classes.
|
|
*/
|
|
const SOFTWARE = 'Xentral_ERP_Software';
|
|
|
|
const SERVICE = 'https://productionapi.awiwe.solutions/version4/shippingwcf/ShippingWCF.svc?wsdl';
|
|
const SANDBOX_SERVICE = 'https://sandboxapi.awiwe.solutions/version4/shippingwcfsandbox/shippingWCF.svc?wsdl';
|
|
|
|
const ENDPOINT = 'https://productionapi.awiwe.solutions/version4/shippingwcf/ShippingWCF.svc/Shippingwcf';
|
|
const SANDBOX_ENDPOINT = 'https://sandboxapi.awiwe.solutions/version4/shippingwcfsandbox/shippingWCF.svc/ShippingWCF';
|
|
/**
|
|
* @var AbstractParcelOneRequest|ParcelOneRequest
|
|
*/
|
|
static private $instance = null;
|
|
/**
|
|
* The Mandator ID
|
|
*
|
|
* ID at PARCEL.ONE, usually '1', if only one mandator.
|
|
*
|
|
* @var int 1
|
|
*/
|
|
protected $mandator = 1;
|
|
/**
|
|
* The Consigner ID
|
|
*
|
|
* ID at PARCEL.ONE, usually "1", if only one consigner.
|
|
*
|
|
* @var int
|
|
*/
|
|
protected $consigner = 1;
|
|
/**
|
|
* The carrier selected as second step in the settings.
|
|
*
|
|
* @var string default PA1 for Parcel.One
|
|
*/
|
|
protected $carrier = 'PA1';
|
|
/**
|
|
* @var string The product chosen in the settings.
|
|
*/
|
|
protected $product = '';
|
|
|
|
/**
|
|
* Options for the SoapClient constructor.
|
|
*
|
|
* Note: this property is private. Also child classes have to use
|
|
* the setOption / deleteOption methods.
|
|
*
|
|
* @var array
|
|
*/
|
|
private $options = [
|
|
'soap_version' => SOAP_1_1,
|
|
'exceptions' => true,
|
|
'trace' => false,
|
|
'cache_wsdl' => WSDL_CACHE_NONE,
|
|
'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
|
|
'location' => 'https://shippingwcf.awiwe.net/Shippingwcf.svc/Shippingwcf',
|
|
'connection_timeout' => 300
|
|
];
|
|
/**
|
|
* @var array of RequestHeaderInterface
|
|
*/
|
|
private $soapHeaders = [];
|
|
/**
|
|
* @var string
|
|
*/
|
|
private $url;
|
|
/**
|
|
* Cache here the created soap client.
|
|
*
|
|
* @var SoapClient
|
|
*/
|
|
private $client = null;
|
|
|
|
/**
|
|
* ParcelOneRequest constructor.
|
|
*
|
|
* @param bool $production
|
|
* @param int $mandator
|
|
* @param int $consigner
|
|
*/
|
|
final private function __construct($production = false, $mandator = 1, $consigner = 1)
|
|
{
|
|
if (!class_exists('SoapClient')) {
|
|
throw new SoapExtensionMissingException('SOAP support is not configured.');
|
|
}
|
|
|
|
$this->mandator = $mandator;
|
|
$this->consigner = $consigner;
|
|
|
|
$this->url = self::SANDBOX_SERVICE;
|
|
$this->options['location'] = self::SANDBOX_ENDPOINT;
|
|
if ($production) {
|
|
$this->url = self::SERVICE;
|
|
$this->options['location'] = self::ENDPOINT;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the singleton.
|
|
*
|
|
* @param array $settings
|
|
* @return AbstractParcelOneRequest|ParcelOneRequest
|
|
*/
|
|
final public static function getInstance($settings = [])
|
|
{
|
|
if (self::$instance !== null) {
|
|
if (empty(self::$instance->carrier) && array_key_exists('carrier', $settings)) {
|
|
self::$instance->carrier = $settings['carrier'];
|
|
}
|
|
if (empty(self::$instance->product) && array_key_exists('product', $settings)) {
|
|
self::$instance->product = $settings['product'];
|
|
}
|
|
return self::$instance;
|
|
}
|
|
|
|
$required = ['kdnr', 'password', 'sandbox'];
|
|
foreach ($required as $requirenment) {
|
|
if (!array_key_exists($requirenment, $settings)) {
|
|
throw new MissingArgumentException(sprintf(
|
|
'Setting %s is missing.', $requirenment
|
|
));
|
|
}
|
|
}
|
|
$required = array_flip($required);
|
|
$settings = array_intersect_key($settings, $required);
|
|
|
|
$production = true;
|
|
if (array_key_exists('sandbox', $settings)) {
|
|
$production = $settings['sandbox'] !== '1';
|
|
}
|
|
if (!array_key_exists('mandator', $settings)) {
|
|
$settings['mandator'] = 1;
|
|
}
|
|
$mandator = (int)$settings['mandator'];
|
|
$mandator = max(1, $mandator);
|
|
|
|
if (!array_key_exists('consigner', $settings)) {
|
|
$settings['consigner'] = 1;
|
|
}
|
|
$consigner = (int)$settings['consigner'];
|
|
$consigner = max(1, $consigner);
|
|
|
|
if (!array_key_exists('country', $settings)) {
|
|
$settings['country'] = 'de-DE';
|
|
}
|
|
|
|
$instance = new static($production, $mandator, $consigner);
|
|
$instance
|
|
->addSoapHeader(new AuthHeader($settings['kdnr'], $settings['password']))
|
|
->addSoapHeader(new CultureHeader($settings['country']))
|
|
->addSoapHeader(new APIKeyHeader(self::API_KEY));
|
|
|
|
self::$instance = $instance;
|
|
|
|
return $instance;
|
|
}
|
|
|
|
/**
|
|
* Don't allow 'on the fly' calls.
|
|
*
|
|
* Only the implemented SOAP methods are supported.
|
|
*
|
|
* @param string $name
|
|
* @param array $arguments
|
|
*
|
|
* @throws NotImplementedException
|
|
*
|
|
* @return mixed
|
|
*/
|
|
final public function __call($name, $arguments)
|
|
{
|
|
$class = get_class($this);
|
|
$message = sprintf(
|
|
'Method %s->%s is not implemented.', $class, $name
|
|
);
|
|
|
|
throw new NotImplementedException($message);
|
|
}
|
|
|
|
/**
|
|
* Make one call to the PARCEL.ONE API
|
|
*
|
|
* @param string $name
|
|
* @param array $arguments
|
|
*
|
|
* @throws SoapFault
|
|
*
|
|
* @throws EmptyResponseException
|
|
* @return stdClass|mixed
|
|
*/
|
|
final protected function call($name, $arguments = null)
|
|
{
|
|
$client = $this->getClient();
|
|
|
|
if (!is_string($name)) {
|
|
$type = gettype($name);
|
|
throw new InvalidArgumentException(sprintf(
|
|
'Expected method name as string, got %s.', $type
|
|
));
|
|
}
|
|
|
|
if ($arguments === null) {
|
|
$arguments = [];
|
|
}
|
|
if (!is_array($arguments)) {
|
|
$type = gettype($arguments);
|
|
throw new InvalidArgumentException(sprintf(
|
|
'Expected %s\'s arguments as array, got %s.', $name, $type
|
|
));
|
|
}
|
|
|
|
$arguments['Software'] = self::SOFTWARE;
|
|
|
|
/*
|
|
* Do some magic ;)
|
|
*/
|
|
$callback = [$client, $name];
|
|
|
|
// $response = call_user_func($callback, $arguments);
|
|
$response = $callback($arguments);
|
|
|
|
if (empty($response)) {
|
|
$message = sprintf('Method %s returned empty body.', $name);
|
|
throw new EmptyResponseException($message);
|
|
}
|
|
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Return the SOAP client.
|
|
*
|
|
* Set it up, if not available now.
|
|
*
|
|
* @throws SoapFault
|
|
*
|
|
* @return SoapClient
|
|
*/
|
|
final protected function getClient()
|
|
{
|
|
$client = $this->client;
|
|
if ($client === null) {
|
|
$client = new SoapClient($this->url, $this->options);
|
|
$client->__setSoapHeaders($this->soapHeaders);
|
|
$this->client = $client;
|
|
}
|
|
|
|
return $this->client;
|
|
}
|
|
|
|
/**
|
|
* Convert the stdClass object into an array.
|
|
*
|
|
* This method uses recursive calls.
|
|
*
|
|
* Thanks to https://stackoverflow.com/a/18576919
|
|
*
|
|
* @param stdClass|array $array
|
|
*
|
|
* @return array
|
|
*/
|
|
final protected function convert2array($array)
|
|
{
|
|
if (is_array($array)) {
|
|
foreach ($array as $key => $value) {
|
|
if (is_array($value)) {
|
|
$array[$key] = $this->convert2array($value);
|
|
}
|
|
if ($value instanceof stdClass) {
|
|
$array[$key] = $this->convert2array((array)$value);
|
|
}
|
|
}
|
|
}
|
|
if ($array instanceof stdClass) {
|
|
return $this->convert2array((array)$array);
|
|
}
|
|
return $array;
|
|
}
|
|
|
|
/**
|
|
* @param SoapHeader $header
|
|
*
|
|
* @return $this
|
|
*/
|
|
private function addSoapHeader(SoapHeader $header)
|
|
{
|
|
$this->client = null;
|
|
$this->soapHeaders[] = $header;
|
|
return $this;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Class ParcelOneRequest
|
|
*
|
|
* Implement here all API methods we support.
|
|
*/
|
|
class ParcelOneRequest extends AbstractParcelOneRequest
|
|
{
|
|
/**
|
|
* Get available Products for a mandator and Carrier
|
|
*
|
|
* @param int|string $level : [0, 1, 2, ..]
|
|
* - 0 = all levels returned;
|
|
* - 1 = only 1 level returned (only products),
|
|
* - >=2 = 2 levels returned (products and services info)
|
|
*
|
|
* @throws SoapFault
|
|
*
|
|
* @return array|stdClass
|
|
*/
|
|
public function getProducts($level = 1)
|
|
{
|
|
$level = is_numeric($level) ? $level : 1;
|
|
$level = max(0, (int)$level);
|
|
|
|
$arguments = [
|
|
'Mandator' => $this->mandator, // string, as field in settings?
|
|
'level' => $level, // int
|
|
'CEP' => $this->carrier, // string Carrier abbreviation (UPS, PA1 for Parcel One, ...).
|
|
];
|
|
|
|
$response = $this->call(__FUNCTION__, $arguments);
|
|
|
|
if (!isset($response->getProductsResult)) {
|
|
throw MissingResponseFieldException::fromFieldName('getProductsResult');
|
|
}
|
|
if (!isset($response->getProductsResult->Product)) {
|
|
throw MissingResponseFieldException::fromFieldName('getProductsResult->Product');
|
|
}
|
|
$response = $response->getProductsResult->Product;
|
|
$response = $this->convert2array($response);
|
|
|
|
$products = [];
|
|
// get as first the default product
|
|
foreach ($response as $product) {
|
|
if (array_key_exists('Default', $product) && $product['Default']) {
|
|
$id = $product['ProductID'];
|
|
$name = $product['ProductName'];
|
|
|
|
$products[$id] = $name;
|
|
}
|
|
}
|
|
// then add all other products
|
|
foreach ($response as $product) {
|
|
if (array_key_exists('Default', $product) && !$product['Default']) {
|
|
$id = $product['ProductID'];
|
|
$name = $product['ProductName'];
|
|
|
|
$products[$id] = $name;
|
|
}
|
|
}
|
|
|
|
return $products;
|
|
}
|
|
|
|
/**
|
|
* Register Forward and Return Shipments.
|
|
*
|
|
* @param $shippingData
|
|
*
|
|
* @throws SoapFault
|
|
*
|
|
* @return array
|
|
*/
|
|
public function registerShipments($shippingData)
|
|
{
|
|
$default = [
|
|
// MandatorID: required - Mandator ID at PARCEL.ONE, usually "1", if only one mandator.
|
|
'MandatorID' => $this->mandator,
|
|
// ConsignerID: required - Consigner ID at PARCEL.ONE, usually "1", if only one consigner.
|
|
'ConsignerID' => $this->consigner,
|
|
// CEPID: required - Carrier specification, possible values so far: UPS, PA1, DHL.
|
|
'CEPID' => $this->carrier,
|
|
// Software: required - Software specification of client, if possible with version number.
|
|
'Software' => self::SOFTWARE,
|
|
/*
|
|
* PrintDocuments: required - Flag to indicate,
|
|
* if Documents (for DHL also Export Documents) should be returned with this request
|
|
* (0=no, 1=yes).
|
|
*/
|
|
'PrintDocuments' => 1,
|
|
// DocumentFormat: required - only Format.Type = "PDF" needed.
|
|
'DocumentFormat' => ['Type' => 'PDF'],
|
|
// LabelFormat: required - only Format.Type = either "GIF" or "PDF" needed.
|
|
'LabelFormat' => ['Type' => 'PDF'],
|
|
// PrintLabel: required - Flag to indicate, if Label should be returned with this request (0=no, 1=yes).
|
|
'PrintLabel' => 1,
|
|
];
|
|
|
|
$shippingData = array_merge($shippingData, $default);
|
|
$shippingData = ['ShippingData' => [$shippingData]];
|
|
$response = $this->call(__FUNCTION__, $shippingData);
|
|
|
|
if (!isset($response->registerShipmentsResult)) {
|
|
throw MissingResponseFieldException::fromFieldName('registerShipmentsResult');
|
|
}
|
|
|
|
$response = $this->convert2array($response);
|
|
|
|
if (!isset($response['registerShipmentsResult'])) {
|
|
throw new ResponseException('Missing registerShipmentsResult response field.');
|
|
}
|
|
$response = $response['registerShipmentsResult'];
|
|
|
|
if (!isset($response['ShipmentResult'])) {
|
|
throw new ResponseException('Missing ShipmentResult response field.');
|
|
}
|
|
$response = $response['ShipmentResult'];
|
|
|
|
foreach ($response['ActionResult']['Errors'] as $e) {
|
|
if (!is_array($e)) {
|
|
continue;
|
|
}
|
|
if (!array_key_exists('Message', $e) || !$e['Message']) {
|
|
continue;
|
|
}
|
|
$msg = $e['Message'];
|
|
if (array_key_exists('StatusCode', $e) && $e['StatusCode']) {
|
|
$msg .= ' (' . (string)$e['StatusCode'] . ')';
|
|
}
|
|
throw new ResponseException($msg);
|
|
}
|
|
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Get available Carriers for a mandator, optionally filtered by countries list.
|
|
*
|
|
* CEP[] getCEPs(string Mandator, int level, String[] Countries);
|
|
*
|
|
* @param int|string level: [0, 1, 2, ..]
|
|
* 0 = all levels returned;
|
|
* 1 = only 1 level returned (only products),
|
|
* >=2 = 2 levels returned (products and services info)
|
|
*
|
|
* @throws SoapFault
|
|
*
|
|
* @return array|stdClass
|
|
*/
|
|
public function getCEPs($level = 1)
|
|
{
|
|
$arguments = [
|
|
'Mandator' => $this->mandator,
|
|
'level' => max(1, (int) $level),
|
|
];
|
|
|
|
$response = $this->call(__FUNCTION__, $arguments);
|
|
|
|
if (!isset($response->getCEPsResult)) {
|
|
throw new ResponseException('Missing getCEPsResult field.');
|
|
}
|
|
|
|
if (!isset($response->getCEPsResult->CEP)) {
|
|
throw new ResponseException('Missing CEP field.');
|
|
}
|
|
|
|
$response = $response->getCEPsResult->CEP;
|
|
$response = $this->convert2array($response);
|
|
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* @throws SoapFault
|
|
*/
|
|
public function getServices()
|
|
{
|
|
$arguments = [
|
|
'Mandator' => $this->mandator,
|
|
'CEP' => $this->carrier,
|
|
'Product' => $this->product,
|
|
];
|
|
|
|
$response = $this->call(__FUNCTION__, $arguments);
|
|
|
|
if (!isset($response->getServicesResult)) {
|
|
throw MissingResponseFieldException::fromFieldName('getServicesResult');
|
|
}
|
|
if (!isset($response->getServicesResult->Service)) {
|
|
throw MissingResponseFieldException::fromFieldName('getServicesResult::Service.');
|
|
}
|
|
|
|
$response = $response->getServicesResult->Service;
|
|
$response = $this->convert2array($response);
|
|
|
|
$services = [
|
|
'' => 'Kein Service'
|
|
];
|
|
// Search for the default service
|
|
foreach ($response as $service) {
|
|
if (array_key_exists('Default', $service) && $service['Default']) {
|
|
$id = $service['ServiceID'];
|
|
$name = $service['ServiceName'];
|
|
|
|
$services[$id] = $name;
|
|
}
|
|
}
|
|
// Append all other services
|
|
foreach ($response as $service) {
|
|
if (array_key_exists('Default', $service) && ! $service['Default']) {
|
|
$id = $service['ServiceID'];
|
|
$name = $service['ServiceName'];
|
|
|
|
$services[$id] = $name;
|
|
}
|
|
}
|
|
|
|
return $services;
|
|
}
|
|
|
|
// todo: implement here the necessary methods
|
|
}
|
|
|
|
/**
|
|
* API from PARCEL.ONE
|
|
*
|
|
* Note: the class name is expected as:
|
|
*
|
|
* Versandart_{filename}
|
|
*
|
|
* Where {filename} is lowercase and without the '.php' extension.
|
|
*
|
|
* @url: https://parcel.one/en
|
|
* @url: https://parcel.one/en/api
|
|
*/
|
|
class Versandart_parcelone extends AbstractVersandartParcelone
|
|
{
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function GetBezeichnung()
|
|
{
|
|
return 'PARCEL.ONE';
|
|
}
|
|
|
|
protected function ctrHook()
|
|
{
|
|
$current = [
|
|
'kdnr' => $this->app->Secure->GetPOST('kdnr'),
|
|
'password' => $this->app->Secure->GetPOST('password'),
|
|
'carrier_product' => $this->app->Secure->GetPOST('carrier_product'),
|
|
];
|
|
$current = array_filter($current);
|
|
// $this->einstellungen += $current;
|
|
$this->einstellungen = array_merge($this->einstellungen, $current);
|
|
|
|
if (array_key_exists('carrier_product', $this->einstellungen)) {
|
|
list($carrier, $product) = explode('.', $this->einstellungen['carrier_product']);
|
|
$this->einstellungen['carrier'] = $carrier;
|
|
$this->einstellungen['product'] = $product;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
protected function EinstellungenStruktur()
|
|
{
|
|
if (!class_exists('SoapClient')) {
|
|
$message = 'PHP SOAP Extension ist nicht konfiguriert. Diese Versandart kann nicht genutzt werden.';
|
|
$this->app->Tpl->Add('MESSAGE', sprintf('<div class="error">%s</div>', $message));
|
|
|
|
return [];
|
|
}
|
|
|
|
$select = [];
|
|
$settings = array_filter($this->einstellungen);
|
|
// $this->app->Tpl->Add('MESSAGE', '<div class="error">' . json_encode($this->einstellungen) . '</div>');
|
|
// $this->app->Tpl->Add('MESSAGE', '<div class="error">' . json_encode($settings) . '</div>');
|
|
|
|
try {
|
|
if (!empty($settings)) {
|
|
$carriers = [];
|
|
if (!array_key_exists('kdnr', $settings) || !array_key_exists('password', $settings)) {
|
|
$this->app->Tpl->Add('MESSAGE', '<div class="error">' . 'Bitte gültige API-Zugangsdaten angeben' . '</div>');
|
|
} else {
|
|
$request = ParcelOneRequest::getInstance($this->einstellungen);
|
|
$carriers = $request->getCEPs(2);
|
|
if (!array_key_exists('carrier_product', $settings)) {
|
|
$this->app->Tpl->Add('MESSAGE', '<div class="info">API-Key erfolgreich überprüft</div>');
|
|
}
|
|
}
|
|
|
|
if (!array_key_exists(0, $carriers)) {
|
|
// i'm not sure about the structure if multiple carriers are available.
|
|
$tmp = $carriers;
|
|
$carriers = [];
|
|
$carriers[] = $tmp;
|
|
unset($tmp);
|
|
}
|
|
|
|
foreach ($carriers as $carrier) {
|
|
$cepID = $carrier['CEPID'];
|
|
$cepName = $carrier['CEPLongname'];
|
|
|
|
foreach ($carrier['Products']['Product'] as $product) {
|
|
$productID = $product['ProductID'];
|
|
$productName = $product['ProductName'];
|
|
|
|
$select[$cepID . '.' . $productID] = $cepName . ': ' . $productName;
|
|
}
|
|
}
|
|
}
|
|
}catch (Exception $e) {
|
|
$this->app->Tpl->Add('MESSAGE', '<div class="error">' . $e->getMessage() . '</div>');
|
|
$select = [];
|
|
}
|
|
|
|
if (empty($select)) {
|
|
$select = ['Bitte Zugangsdaten berichtigen'];
|
|
} else if (!array_key_exists('carrier_product', $settings)) {
|
|
$this->app->Tpl->Add('MESSAGE', '<div class="info">Bitte ein Produkt wählen</div>');
|
|
} else {
|
|
$tmp = [];
|
|
$firstID = $settings['carrier_product'];
|
|
// add the chosen one as first element to $tmp
|
|
foreach ($select as $id => $name) {
|
|
if ($id === $firstID) {
|
|
$tmp[$id] = $name;
|
|
}
|
|
}
|
|
// append all other elements
|
|
foreach ($select as $id => $name) {
|
|
if ($id !== $firstID) {
|
|
$tmp[$id] = $name;
|
|
}
|
|
}
|
|
$select = $tmp;
|
|
unset($tmp);
|
|
}
|
|
|
|
return [
|
|
'kdnr' => [
|
|
'typ' => 'text',
|
|
'bezeichnung' => 'Kundennummer:',
|
|
'size' => 40,
|
|
],
|
|
'password' => [
|
|
'typ' => 'text',
|
|
'bezeichnung' => 'Passwort:',
|
|
'size' => 40,
|
|
],
|
|
'country' => [
|
|
'typ' => 'text',
|
|
'bezeichnung' => 'Absender Land:',
|
|
'size' => 2,
|
|
'placeholder' => 'DE',
|
|
'default' => 'DE',
|
|
'regex' => '^[A-Z]{2}$'
|
|
],
|
|
'international' => [
|
|
'size' => 40,
|
|
'typ' => 'select',
|
|
'default' => 'CN23',
|
|
'bezeichnung' => 'Zolldokumente:',
|
|
'optionen' => [
|
|
'' => 'Nicht benötigt',
|
|
'CN22' => 'CN22',
|
|
'CN23' => 'CN23',
|
|
],
|
|
],
|
|
'ref1' => [
|
|
'size' => 40,
|
|
'typ' => 'text',
|
|
'default' => '',
|
|
'bezeichnung' => 'Referenz 1:',
|
|
'placeholder' => 'Referenz 1 auf Label',
|
|
'info'=>'{LIEFERSCHEIN}, {AUFTRAG}, {PROJEKT}, {IHREBESTELLNUMMER}, {INTERNET}',
|
|
],
|
|
'ref2' => [
|
|
'size' => 40,
|
|
'typ' => 'text',
|
|
'default' => '',
|
|
'bezeichnung' => 'Referenz 2:',
|
|
'placeholder' => 'Referenz 2 auf Label',
|
|
'info'=>'{LIEFERSCHEIN}, {AUFTRAG}, {PROJEKT}, {IHREBESTELLNUMMER}, {INTERNET}',
|
|
],
|
|
'carrier_product' => [
|
|
'size' => 40,
|
|
'typ' => 'select',
|
|
'bezeichnung' => 'Spediteur & Produkt:',
|
|
'optionen' => $select,
|
|
],
|
|
'standardgewicht' => [
|
|
'size' => 40,
|
|
'typ' => 'text',
|
|
'bezeichnung' => 'Standardgewicht'
|
|
],
|
|
'autotracking' => [
|
|
'typ' => 'checkbox',
|
|
'bezeichnung' => 'Tracking übernehmen:'
|
|
],
|
|
'sandbox' => [
|
|
'typ' => 'checkbox',
|
|
'bezeichnung' => 'Sandbox Anbindung:'
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*
|
|
* @throws SoapFault
|
|
*/
|
|
protected function parseTemplate($target)
|
|
{
|
|
if (!array_key_exists('carrier', $this->einstellungen)) {
|
|
$this->app->Tpl->Add('MESSAGE', '<div class="error">Bitte die Einstellungen vervollständigen.</div>');
|
|
} else {
|
|
$request = ParcelOneRequest::getInstance($this->einstellungen);
|
|
|
|
$services = $request->getServices();
|
|
unset($services['']);
|
|
|
|
$html = '';
|
|
$frame = '<div><input type="checkbox" id="service_%s" name="service[]" value="%s"><label for="service_%s">%s</label></div>';
|
|
foreach ($services as $id => $service) {
|
|
$html .= sprintf($frame, $id, $id, $id, $service);
|
|
}
|
|
$services = $html;
|
|
|
|
$this->app->Tpl->Set('SERVICE', $services);
|
|
}
|
|
$this->app->Tpl->Parse($target, 'versandarten_parcelone.tpl');
|
|
}
|
|
|
|
public function VersandartMindestgewicht()
|
|
{
|
|
if(!empty($this->einstellungen['standardgewicht'])){
|
|
return str_replace(',','.',$this->einstellungen['standardgewicht']);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*
|
|
* @throws SoapFault
|
|
*/
|
|
protected function createPaketmarke($doctyp, $id, $target, $error, $adressdaten, $packageData)
|
|
{
|
|
$versandId = $doctyp==='versand'?$id:0;
|
|
if (!array_key_exists('carrier', $this->einstellungen)) {
|
|
$this->app->Tpl->Add('MESSAGE', '<div class="error">Bitte die Einstellungen vervollständigen.</div>');
|
|
return false;
|
|
}
|
|
|
|
// lieferschein, retoure & versand contain all an 'adresse' field.
|
|
$document = $this->getDocumentByID($doctyp, $id);
|
|
if (!array_key_exists('adresse', $document)) {
|
|
throw new MissingArgumentException(sprintf(
|
|
'Missed field for adresse in %s.', $doctyp
|
|
));
|
|
}
|
|
|
|
$lieferscheinID = $id;
|
|
if (array_key_exists('lieferscheinid', $document)) {
|
|
$lieferscheinID = $document['lieferscheinid'];
|
|
}
|
|
|
|
$address = $this->loadAddress($document['adresse']);
|
|
$items = $this->loadDeliveryPositions($id, $doctyp);
|
|
|
|
$auftragnummer = $this->getAuftragNummer($lieferscheinID);
|
|
$projektabkuerzung = $this->getProjectShortName($lieferscheinID);
|
|
// Source: ups.php
|
|
$ihrebestellnummer = $this->app->DB->Select("SELECT ihrebestellnummer FROM lieferschein WHERE id='$lieferscheinID' LIMIT 1");
|
|
$lieferscheinnummer = $this->app->DB->Select("SELECT belegnr FROM lieferschein WHERE id='$lieferscheinID' LIMIT 1");
|
|
$internet = $this->app->DB->Select("SELECT a.internet FROM lieferschein l LEFT JOIN auftrag a ON a.id=l.auftragid WHERE l.id='$lieferscheinID' LIMIT 1");
|
|
|
|
$replacer = new ParcelOneReplacer([
|
|
'IHREBESTELLNUMMER' => $ihrebestellnummer,
|
|
'LIEFERSCHEIN' => $lieferscheinnummer,
|
|
'PROJEKT' => $projektabkuerzung,
|
|
'AUFTRAG' => $auftragnummer,
|
|
'INTERNET' => $internet
|
|
]);
|
|
|
|
/*
|
|
* ShipTo Reference provided by client, string, max length 20
|
|
*/
|
|
$clientsReference = $this->einstellungen['ref2'];
|
|
$clientsReference = $replacer->handle((string) $clientsReference);
|
|
$clientsReference = substr($clientsReference, 0, 20);
|
|
|
|
/*
|
|
* Private Address = 1, B2B = 0
|
|
*/
|
|
$private = $address['firma'] !== '1' ? 1 : 0;
|
|
/*
|
|
* ReturnShipmentIndicator: required -
|
|
* 0 = Forward Shipment,
|
|
* all values > 0 = Return Shipment.
|
|
*
|
|
* For UPS the following are available:
|
|
* 2-Print and Mail Return Label by UPS;
|
|
* 3-Return Service 1-Attempt;
|
|
* 5-Return Service 3-Attempt;
|
|
* 8-Electronic Return Label by URL;
|
|
* 9-Print Return Label.
|
|
*
|
|
* For DHL and Parcel One so far not available.
|
|
*
|
|
* We only support Parcel One, so:
|
|
* 0 -> forward,
|
|
* 1 -> return
|
|
*/
|
|
$returnShipment = (int)$doctyp === 'retoure';
|
|
/*
|
|
* Parcel ID assigned at Shipping.
|
|
* will be reassigned at successfully shipping.
|
|
*/
|
|
$packageID = '';
|
|
/*
|
|
* Shipment Reference field provided by client for identification, string, max length 20.
|
|
*/
|
|
$shipmentRef = $this->einstellungen['ref1']; // $packageData['shipment_reference'];
|
|
$shipmentRef = $replacer->handle((string) $shipmentRef);
|
|
$shipmentRef = substr($shipmentRef, 0, 20);
|
|
|
|
/*
|
|
* Certificate No to print on CN23.
|
|
*/
|
|
$certificateNo = '';
|
|
/*
|
|
* optional - Invoice No to print on CN23. max. length: 20
|
|
* $lieferschein['belegnummer'] // 'ihrebestellnummer'
|
|
*/
|
|
$invoiceNo = '';
|
|
/*
|
|
* optional item category
|
|
* possible values:
|
|
* - 1: Gift
|
|
* - 2: Documents
|
|
* - 3: Commercial Sample
|
|
* - 4: Returned Goods
|
|
* - 5: Other
|
|
*/
|
|
$itemCategory = $returnShipment ? 4 : 5;
|
|
|
|
$weight = $this->getWeight($packageData);
|
|
if (!$weight) {
|
|
foreach ($items as $item) {
|
|
$weight += (float) $item['NetWeight'];
|
|
}
|
|
}
|
|
$weight = number_format($weight, 3);
|
|
|
|
$product = $this->einstellungen['product'];
|
|
$international = $this->getInternationalDocumentType($adressdaten['land']);
|
|
|
|
$destinationCountry = $adressdaten['land'];
|
|
$originCountry = $this->einstellungen['country'];
|
|
$printInternationalDocuments = 0;
|
|
if($destinationCountry != $originCountry){
|
|
$printInternationalDocuments = (int)(!$this->app->erp->IsEU($destinationCountry));
|
|
}
|
|
|
|
$shipment = [
|
|
'ProductID' => $product,
|
|
'ShipmentRef' => $shipmentRef,
|
|
'ReturnShipmentIndicator' => $returnShipment,
|
|
'ShipToData' => [
|
|
'Name1' => $adressdaten['name'],
|
|
'Name2' => $adressdaten['name2'],
|
|
'Name3' => $adressdaten['name3'],
|
|
/*
|
|
* PrivateAddressIndicator: optional/required
|
|
* - 1 Private Address,
|
|
* - 0 B2B-Address.
|
|
*/
|
|
'PrivateAddressIndicator' => $private,
|
|
'ShipmentAddress' => [
|
|
'City' => $adressdaten['ort'],
|
|
'PostalCode' => $adressdaten['plz'],
|
|
'Street' => $adressdaten['street'],
|
|
'Streetno' => $adressdaten['street_no'],
|
|
'Country' => $adressdaten['land'],
|
|
// 'State' => '',
|
|
// 'District' => '',
|
|
],
|
|
'Reference' => $clientsReference,
|
|
],
|
|
'Packages' => [
|
|
[
|
|
'PackageWeight' => [
|
|
'Value' => $weight,
|
|
],
|
|
'PackageID' => $packageID,
|
|
'IntDocData' => [
|
|
'ContentsDesc' => $items,
|
|
'ShipToRef' => $shipmentRef,
|
|
'ItemCategory' => $itemCategory,
|
|
'InvoiceNo' => (string)$invoiceNo,
|
|
'Invoice' => (int)(bool)$invoiceNo,
|
|
'PrintInternationalDocuments' => (int) ! empty($international),
|
|
'Explanation' => $clientsReference,
|
|
'ConsignerCustomsID' => '',
|
|
'CertificateNo' => (string)$certificateNo,
|
|
'Certificate' => (int)(bool)$certificateNo,
|
|
'TotalWeightkg' => $weight, // $weight, // '34.000', // "34.000",
|
|
// 'Postage' => '2.45', // "2.45", // optional - Postage Amount // Porto
|
|
'InternationalDocumentFormat' => [
|
|
'Type' => 'PDF',
|
|
'Size' => $international,
|
|
],
|
|
],
|
|
],
|
|
],
|
|
];
|
|
|
|
$service = $packageData['service'];
|
|
if (!empty($service) && is_array($service)) {
|
|
$services = [];
|
|
foreach ($service as $serviceID) {
|
|
// Parameter Services - Array of ShipmentService:
|
|
// Parameters: optional - so far not in use, for future use.
|
|
// ServiceID: required - Service ID, e.g. NN for COD, WERT for insurance, SA for Saturday Delivery, etc.
|
|
// Value: optional - Currency and Value specification, e.g. for Insurance or COD. Exception for DHL-BulkyGoods: Amount determines kind of bulkgoods: 0=Lang, 1=L, 2=XL, 3=XXL, default=XXL
|
|
$services[] = ['ServiceID' => $serviceID];
|
|
}
|
|
$shipment['Services'] = $services;
|
|
}
|
|
|
|
$request = ParcelOneRequest::getInstance($this->einstellungen);
|
|
$response = $request->registerShipments($shipment);
|
|
|
|
if (!array_key_exists('ActionResult', $response)) {
|
|
throw MissingResponseFieldException::fromFieldName('ActionResult');
|
|
}
|
|
$number = $this->extractActionResultID($response);
|
|
|
|
if ($this->einstellungen['autotracking'] === '1') {
|
|
$lieferscheinID = $id;
|
|
if (array_key_exists('lieferschein', $document)) {
|
|
$lieferscheinID = $document['lieferschein'];
|
|
}
|
|
$versandID = $doctyp === 'versand' ? $id : 0;
|
|
$this->SetTracking($number, $versandID, $lieferscheinID);
|
|
unset($versandID, $lieferscheinID);
|
|
}
|
|
|
|
if (!$packageData['drucken'] && !$packageData['tracking_again']) {
|
|
return [];
|
|
}
|
|
|
|
/*
|
|
* Let's print the two documents.
|
|
*/
|
|
if (array_key_exists('LabelsAvailable', $response) && $response['LabelsAvailable'] === 1) {
|
|
$label = 'Label_' . $number . '.pdf';
|
|
$content = $response['PackageResults']['ShipmentPackageResult']['Label'];
|
|
$content = base64_decode($content, true);
|
|
$this->printFile($label, $content, $versandId);
|
|
unset($label, $content);
|
|
}
|
|
|
|
if (array_key_exists('InternationalDocumentsNeeded', $response) &&
|
|
array_key_exists('InternationalDocumentsResults', $response) &&
|
|
array_key_exists('InternationalDocumentsAvailable', $response) &&
|
|
is_array($response['InternationalDocumentsResults']) &&
|
|
!empty($response['InternationalDocumentsResults']) &&
|
|
$response['InternationalDocumentsNeeded'] === 1 &&
|
|
$response['InternationalDocumentsAvailable'] === 1 && !empty($response['InternationalDocumentsResults'])) {
|
|
|
|
$internationalFile = $international . '_' . $number . '.pdf';
|
|
$content = $response['InternationalDocumentsResults']['ShipmentDocumentsResult']['Document'];
|
|
|
|
$content = base64_decode($content, true);
|
|
$this->printFile($internationalFile, $content, $versandId);
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Get the custom documents format.
|
|
*
|
|
* @param string $country like 'DE'
|
|
*
|
|
* @return string of '', 'CN22' or 'CN23';
|
|
*/
|
|
protected function getInternationalDocumentType($country)
|
|
{
|
|
$senderCountry = $this->app->erp->Firmendaten('land');
|
|
if ($country === $senderCountry) {
|
|
// no custom documents required
|
|
return '';
|
|
}
|
|
if ($this->app->erp->IstEU($country)) {
|
|
// no custom documents required
|
|
return '';
|
|
}
|
|
|
|
$international = $this->einstellungen['international'];
|
|
if (in_array($international, ['CN22', 'CN23'], true)) {
|
|
return $international;
|
|
}
|
|
|
|
return 'CN23';
|
|
}
|
|
|
|
/**
|
|
* Load contents & quantity for all items of one delivery.
|
|
*
|
|
* @param int|string $id delivery note id
|
|
* @param string $table
|
|
*
|
|
* @return array
|
|
*/
|
|
private function loadDeliveryPositions($id, $table)
|
|
{
|
|
if (is_string($id) && is_numeric($id)) {
|
|
$id = (int)$id;
|
|
}
|
|
if (!is_int($id)) {
|
|
$type = gettype($id);
|
|
throw new ArgumentTypeException('Expected order id as int, got ' . $type);
|
|
}
|
|
// $sql = '
|
|
//SELECT
|
|
// lp.menge,
|
|
// lp.bezeichnung,
|
|
// if(lp.zolleinzelwert >0 , lp.zolleinzelwert , ( ap.preis - (ap.preis / 100 * ap.rabatt ) ) ) as preis,
|
|
// lp.zolltarifnummer,
|
|
// if(lp.zollwaehrung != \'\' , lp.zollwaehrung, ap.waehrung) as waehrung,
|
|
// lp.artikel,
|
|
// lp.zolltarifnummer
|
|
//FROM
|
|
// lieferschein_position lp
|
|
//LEFT JOIN
|
|
// auftrag_position ap
|
|
//ON
|
|
// ap.id = lp.auftrag_position_id
|
|
// LEFT JOIN
|
|
// artikel a
|
|
// ON
|
|
// a.id = lp.artikel
|
|
// WHERE
|
|
// lp.lieferschein=\'%s\'
|
|
// AND
|
|
// ap.explodiert != 1
|
|
// AND
|
|
// a.lagerartikel = 1';
|
|
switch ($table) {
|
|
case 'versand':
|
|
$sql = '
|
|
SELECT
|
|
lp.bezeichnung as Contents,
|
|
lp.menge as Quantity,
|
|
lp.zollgesamtgewicht as NetWeight,
|
|
lp.zollgesamtwert as ItemValue,
|
|
lp.herkunftsland as Origin,
|
|
lp.zolltarifnummer as TariffNumber,
|
|
lp.zollwaehrung as Currency
|
|
FROM
|
|
lieferschein_position as lp,
|
|
versand as v
|
|
WHERE
|
|
lp.lieferschein = v.lieferschein
|
|
AND
|
|
v.id =\'%s\'';
|
|
break;
|
|
case 'lieferschein':
|
|
$sql = '
|
|
SELECT
|
|
bezeichnung as Contents,
|
|
menge as Quantity,
|
|
zollgesamtgewicht as NetWeight,
|
|
zollgesamtwert as ItemValue,
|
|
herkunftsland as Origin,
|
|
zolltarifnummer as TariffNumber,
|
|
zollwaehrung as Currency
|
|
FROM
|
|
lieferschein_position
|
|
WHERE
|
|
lieferschein =\'%s\'';
|
|
break;
|
|
case 'retoure':
|
|
$sql = '
|
|
SELECT
|
|
bezeichnung as Contents,
|
|
menge as Quantity,
|
|
herkunftsland as Origin,
|
|
zolltarifnummer as TariffNumber
|
|
FROM
|
|
retoure_position
|
|
WHERE
|
|
retoure =\'%s\'';
|
|
// zolleinzelgewicht as NetWeight,
|
|
// zolleinzelwert as ItemValue,
|
|
// zollwaehrung as Currency
|
|
break;
|
|
case 'auftrag':
|
|
$sql = '
|
|
SELECT
|
|
bezeichnung as Contents,
|
|
menge as Quantity,
|
|
zollgesamtgewicht as NetWeight,
|
|
zollgesamtwert as ItemValue,
|
|
herkunftsland as Origin,
|
|
zolltarifnummer as TariffNumber,
|
|
zollwaehrung as Currency
|
|
FROM
|
|
auftrag_position
|
|
WHERE
|
|
auftrag =\'%s\'';
|
|
break;
|
|
default:
|
|
throw new InvalidArgumentException(sprintf('Unknown table \'%s\'.', $table));
|
|
}
|
|
|
|
$sql = sprintf($sql, $id);
|
|
|
|
$positions = $this->app->DB->Query($sql);
|
|
$error = $this->app->DB->error();
|
|
|
|
if ($error) {
|
|
$error = htmlspecialchars($error);
|
|
$msg = sprintf('SQL query error: \'%s\', query was \'%s\'', $error, $sql);
|
|
throw new RuntimeException($msg);
|
|
}
|
|
|
|
$positions = $positions->fetch_all(MYSQLI_ASSOC);
|
|
$error = $this->app->DB->error();
|
|
if ($error) {
|
|
$error = htmlspecialchars($error);
|
|
$msg = sprintf('SQL query error: \'%s\', query was \'%s\'', $error, $sql);
|
|
throw new RuntimeException($msg);
|
|
}
|
|
|
|
if (!is_array($positions)) {
|
|
$type = gettype($positions);
|
|
throw new ArgumentTypeException('Expected positions as array, got ' . $type);
|
|
}
|
|
|
|
return (array)$positions;
|
|
}
|
|
|
|
/**
|
|
* Return a tracking number / package id
|
|
*
|
|
* @param $response
|
|
*
|
|
* @throws MissingResponseFieldException
|
|
*
|
|
* @return string|int
|
|
*/
|
|
private function extractActionResultID($response)
|
|
{
|
|
$number = null;
|
|
if (!is_array($response)) {
|
|
$type = gettype($response);
|
|
throw new ArgumentTypeException('Expected response as array, got ' . $type);
|
|
}
|
|
if (!array_key_exists('ActionResult', $response)) {
|
|
throw new MissingResponseFieldException('Field \'ActionResult\' in response is missing');
|
|
}
|
|
|
|
$actionResult = $response['ActionResult'];
|
|
if (array_key_exists('TrackingID', $actionResult)) {
|
|
return $actionResult['TrackingID'];
|
|
}
|
|
if (array_key_exists('ShipmentID', $actionResult)) {
|
|
return $actionResult['ShipmentID'];
|
|
}
|
|
if (array_key_exists('ShipmentRef', $actionResult)) {
|
|
return $actionResult['ShipmentRef'];
|
|
}
|
|
|
|
throw MissingResponseFieldException::fromFieldName('TrackingID/ShipmentID/ShipmentRef is missing.');
|
|
}
|
|
|
|
/**
|
|
* Source: ups.php
|
|
*
|
|
* @param int $lieferscheinID
|
|
* @return string
|
|
*/
|
|
public function getProjectShortName($lieferscheinID)
|
|
{
|
|
$projekt = $this->app->DB->Select("SELECT projekt FROM lieferschein WHERE id='$lieferscheinID' LIMIT 1");
|
|
return $this->app->DB->Select("SELECT abkuerzung FROM projekt WHERE id='$projekt' LIMIT 1");
|
|
}
|
|
|
|
/**
|
|
* Source: ups.php
|
|
*
|
|
* @param int $lieferscheinID
|
|
* @return int
|
|
*/
|
|
public function getAuftragNummer($lieferscheinID)
|
|
{
|
|
$auftragid = $this->app->DB->Select("SELECT auftragid FROM lieferschein WHERE id='$lieferscheinID' LIMIT 1");
|
|
if ($auftragid > 0 ) {
|
|
return $this->app->DB->Select("SELECT belegnr FROM auftrag WHERE id='$auftragid' LIMIT 1");
|
|
}
|
|
|
|
return '';
|
|
}
|
|
}
|