Kevin Adametz
0f641ef33a
- Sidebar-Menü „Bestellungen" in „Versand" umbenannt (layout-sidenav), sonst nur Blade-Formatierung. - Entwicklungspläne in ISO-Datumsformat umbenannt (entwicklungsplan-aktualisiert-*). - dev/dhl-for-woocommerce/ (DHL-Plugin) + dev/partnercenter-api.zip + PastedGraphic hinzugefügt. - .claude/ bewusst NICHT eingecheckt (lokale Claude-Code-Konfiguration). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
449 lines
13 KiB
PHP
449 lines
13 KiB
PHP
<?php
|
|
|
|
use PR\DHL\REST_API\Drivers\JSON_API_Driver;
|
|
use PR\DHL\REST_API\Drivers\Logging_Driver;
|
|
use PR\DHL\REST_API\Drivers\WP_API_Driver;
|
|
use PR\DHL\REST_API\Interfaces\API_Auth_Interface;
|
|
use PR\DHL\REST_API\Interfaces\API_Driver_Interface;
|
|
use PR\DHL\REST_API\Paket\Auth;
|
|
use PR\DHL\REST_API\Paket\Client;
|
|
use PR\DHL\REST_API\Paket\Pickup_Request_Info;
|
|
|
|
// Exit if accessed directly or class already exists
|
|
if (! defined('ABSPATH') || class_exists('PR_DHL_API_REST_Paket', false)) {
|
|
return;
|
|
}
|
|
|
|
class PR_DHL_API_REST_Paket extends PR_DHL_API
|
|
{
|
|
/**
|
|
* The URL to the API.
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
const API_URL_PRODUCTION = 'https://api-eu.dhl.com/parcel/de/transportation/pickup/v3';
|
|
|
|
/**
|
|
* The URL to the sandbox API.
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
const API_URL_SANDBOX = 'https://api-sandbox.dhl.com/parcel/de/transportation/pickup/v3';
|
|
|
|
/**
|
|
* The API driver instance.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @var API_Driver_Interface
|
|
*/
|
|
public $api_driver;
|
|
|
|
/**
|
|
* The API authorization instance.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @var Auth
|
|
*/
|
|
public $api_auth;
|
|
|
|
/**
|
|
* The API client instance.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @var Client
|
|
*/
|
|
public $api_client;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @param string $country_code The country code.
|
|
*
|
|
* @throws Exception If an error occurred while creating the API driver, auth or client.
|
|
*/
|
|
public function __construct($country_code)
|
|
{
|
|
$this->country_code = $country_code;
|
|
|
|
try {
|
|
$this->api_driver = $this->create_api_driver();
|
|
$this->api_auth = $this->create_api_auth();
|
|
$this->api_client = $this->create_api_client();
|
|
} catch (Exception $e) {
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Initializes the API client instance.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @return Client
|
|
*
|
|
* @throws Exception If failed to create the API client.
|
|
*/
|
|
protected function create_api_client()
|
|
{
|
|
// Create the API client, using this instance's driver and auth objects
|
|
return new Client(
|
|
$this->get_customer_portal_username(),
|
|
$this->get_customer_portal_password(),
|
|
$this->get_api_url(),
|
|
$this->api_driver,
|
|
$this->api_auth
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Initializes the API driver instance.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @return API_Driver_Interface
|
|
*
|
|
* @throws Exception If failed to create the API driver.
|
|
*/
|
|
protected function create_api_driver()
|
|
{
|
|
// Use a standard WordPress-driven API driver to send requests using WordPress' functions
|
|
$driver = new WP_API_Driver;
|
|
|
|
// This will log requests given to the original driver and log responses returned from it
|
|
$driver = new Logging_Driver(PR_DHL(), $driver);
|
|
|
|
// This will prepare requests given to the previous driver for JSON content
|
|
// and parse responses returned from it as JSON.
|
|
$driver = new JSON_API_Driver($driver);
|
|
|
|
// , decorated using the JSON driver decorator class
|
|
return $driver;
|
|
}
|
|
|
|
/**
|
|
* Initializes the API auth instance.
|
|
*
|
|
* @return API_Auth_Interface
|
|
*
|
|
* @throws Exception If failed to create the API auth.
|
|
*/
|
|
protected function create_api_auth()
|
|
{
|
|
// Get the saved DHL customer API credentials
|
|
[$username, $password] = $this->get_api_creds();
|
|
|
|
// Create the auth object using this instance's API driver and URL
|
|
return new Auth(
|
|
$this->api_driver,
|
|
$this->get_api_url(),
|
|
$username,
|
|
$password,
|
|
$this->get_api_key(),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
public function is_dhl_paket()
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Retrieves the API URL.
|
|
*
|
|
* @return string
|
|
*
|
|
* @throws Exception If failed to determine if using the sandbox API or not.
|
|
*/
|
|
public function get_api_url()
|
|
{
|
|
$is_sandbox = $this->get_setting('dhl_sandbox');
|
|
$is_sandbox = filter_var($is_sandbox, FILTER_VALIDATE_BOOLEAN);
|
|
$api_url = ($is_sandbox) ? static::API_URL_SANDBOX : static::API_URL_PRODUCTION;
|
|
|
|
return $api_url;
|
|
}
|
|
|
|
/**
|
|
* Retrieves the API credentials.
|
|
*
|
|
* @return array The client ID and client secret.
|
|
*
|
|
* @throws Exception If failed to retrieve the API credentials.
|
|
*/
|
|
public function get_api_creds()
|
|
{
|
|
$customer_portal_login = $this->get_customer_portal_login();
|
|
|
|
return [
|
|
$customer_portal_login['username'],
|
|
$customer_portal_login['pass'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Retrieves the Customer Portal login credentials.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @return array The customer username and password for Business portal API calls.
|
|
*/
|
|
public function get_customer_portal_login()
|
|
{
|
|
$is_sandbox = $this->get_setting('dhl_sandbox');
|
|
$is_sandbox = filter_var($is_sandbox, FILTER_VALIDATE_BOOLEAN);
|
|
if ($is_sandbox) {
|
|
$sandbox = $this->sandbox_info_customer_portal();
|
|
|
|
return [
|
|
'username' => $sandbox['username'],
|
|
'pass' => $sandbox['pass'],
|
|
];
|
|
|
|
} else {
|
|
return [
|
|
'username' => $this->get_setting('dhl_api_user'),
|
|
'pass' => $this->get_setting('dhl_api_pwd'),
|
|
];
|
|
}
|
|
}
|
|
|
|
public function get_customer_portal_username()
|
|
{
|
|
$customer_login = $this->get_customer_portal_login();
|
|
|
|
return $customer_login['username'];
|
|
}
|
|
|
|
public function get_customer_portal_password()
|
|
{
|
|
$customer_login = $this->get_customer_portal_login();
|
|
|
|
return $customer_login['pass'];
|
|
}
|
|
|
|
/**
|
|
* Retrieves the Sandbox DHL Pickup Account Number
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @return string
|
|
*
|
|
* @throws Exception If failed to retrieve the EKP from the settings.
|
|
*/
|
|
public function maybe_get_sandbox_account_number()
|
|
{
|
|
$is_sandbox = $this->get_setting('dhl_sandbox');
|
|
$is_sandbox = filter_var($is_sandbox, FILTER_VALIDATE_BOOLEAN);
|
|
if ($is_sandbox) {
|
|
$sandbox_info = $this->sandbox_info_customer_portal();
|
|
|
|
return $sandbox_info['account_no'];
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a single setting.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @param string $key The key of the setting to retrieve.
|
|
* @param string $default The value to return if the setting is not saved.
|
|
* @return mixed The setting value.
|
|
*/
|
|
public function get_setting($key, $default = '')
|
|
{
|
|
$settings = $this->get_settings();
|
|
|
|
return isset($settings[$key]) ? $settings[$key] : $default;
|
|
}
|
|
|
|
/**
|
|
* Retrieves all of the Deutsche Post settings.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @return array An associative array of the settings keys mapping to their values.
|
|
*/
|
|
public function get_settings()
|
|
{
|
|
return get_option('woocommerce_pr_dhl_paket_settings', []);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
public function dhl_test_connection($client_id, $client_secret)
|
|
{
|
|
// try {
|
|
// Test the given ID and secret
|
|
// $token = $this->api_auth->test_connection( $client_id, $client_secret );
|
|
// Save the token if successful
|
|
// $this->api_auth->save_token( $token );
|
|
//
|
|
// return $token;
|
|
// } catch ( Exception $e ) {
|
|
// $this->api_auth->save_token( null );
|
|
// throw $e;
|
|
// }
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
public function dhl_reset_connection()
|
|
{
|
|
// return $this->api_auth->revoke();
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
public function get_dhl_products_domestic()
|
|
{
|
|
$country_code = $this->country_code;
|
|
|
|
$germany_dom = [
|
|
'V01PAK' => esc_html__('DHL Paket', 'dhl-for-woocommerce'),
|
|
'V01PRIO' => esc_html__('DHL Paket PRIO', 'dhl-for-woocommerce'),
|
|
'V62KP' => esc_html__('DHL Kleinpaket', 'dhl-for-woocommerce'),
|
|
];
|
|
|
|
$dhl_prod_dom = [];
|
|
|
|
switch ($country_code) {
|
|
case 'DE':
|
|
$dhl_prod_dom = $germany_dom;
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return apply_filters('pr_shipping_dhl_paket_products_domestic', $dhl_prod_dom);
|
|
}
|
|
|
|
public function get_dhl_products_international()
|
|
{
|
|
$country_code = $this->country_code;
|
|
|
|
$germany_int = [
|
|
'V55PAK' => esc_html__('DHL Paket Connect', 'dhl-for-woocommerce'),
|
|
'V54EPAK' => esc_html__('DHL Europaket (B2B)', 'dhl-for-woocommerce'),
|
|
'V53WPAK' => esc_html__('DHL Paket International', 'dhl-for-woocommerce'),
|
|
'V66WPI' => esc_html__('DHL Warenpost International', 'dhl-for-woocommerce'),
|
|
];
|
|
|
|
$dhl_prod_int = [];
|
|
|
|
switch ($country_code) {
|
|
case 'DE':
|
|
$dhl_prod_int = $germany_int;
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return apply_filters('pr_shipping_dhl_paket_products_international', $dhl_prod_int);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @since [*next-version*]
|
|
*/
|
|
public function request_dhl_pickup($args, $forcePortalPickupAddressMatch = true)
|
|
{
|
|
$uom = get_option('woocommerce_weight_unit');
|
|
|
|
// Maybe override account billing number here for Sandbox user
|
|
if ($this->maybe_get_sandbox_account_number()) {
|
|
$args['dhl_pickup_billing_number'] = $this->maybe_get_sandbox_account_number();
|
|
}
|
|
|
|
try {
|
|
$request_pickup_info = new Pickup_Request_Info($args, $uom);
|
|
} catch (Exception $e) {
|
|
throw $e;
|
|
}
|
|
|
|
// Verify pickup address with DHL portal pickup address first
|
|
if ($forcePortalPickupAddressMatch) {
|
|
$postalCode = $request_pickup_info->pickup_address['postalCode'];
|
|
$localAddress = $request_pickup_info->pickup_address;
|
|
|
|
try {
|
|
$pickup_location_response = $this->api_client->get_pickup_location($postalCode);
|
|
|
|
$foundPickupLocMatch = false;
|
|
foreach ($pickup_location_response as $pickup_address) {
|
|
$portalAddress = $pickup_address->pickupAddress ?? null;
|
|
if (strtolower(preg_replace('/[^A-Za-z0-9]/', '', $portalAddress->addressStreet)) == strtolower(preg_replace('/[^A-Za-z0-9]/', '', $localAddress['addressStreet']))
|
|
&& strtolower(preg_replace('/[^A-Za-z0-9]/', '', $portalAddress->addressHouse)) == strtolower(preg_replace('/[^A-Za-z0-9]/', '', $localAddress['addressHouse']))
|
|
&& strtolower(preg_replace('/[^A-Za-z0-9]/', '', $portalAddress->city)) == strtolower(preg_replace('/[^A-Za-z0-9]/', '', $localAddress['city']))
|
|
&& strtolower(preg_replace('/[^A-Za-z0-9]/', '', $portalAddress->postalCode)) == strtolower(preg_replace('/[^A-Za-z0-9]/', '', $localAddress['postalCode']))
|
|
) {
|
|
$foundPickupLocMatch = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (! $foundPickupLocMatch) {
|
|
throw new Exception(
|
|
esc_html__('Your Shipper Address must match a Pickup address on your DHL Portal.', 'dhl-for-woocommerce')
|
|
);
|
|
}
|
|
} catch (Exception $e) {
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
// Create the shipping label
|
|
try {
|
|
$request_pickup_response = $this->api_client->create_pickup_request($request_pickup_info);
|
|
} catch (Exception $e) {
|
|
throw $e;
|
|
}
|
|
|
|
return $request_pickup_response;
|
|
}
|
|
|
|
public function sandbox_info_customer_portal()
|
|
{
|
|
return [
|
|
'username' => 'user-valid',
|
|
'pass' => 'SandboxPasswort2023!',
|
|
'account_no' => '22222222220801',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Retrieves the API KEY.
|
|
*
|
|
* @since [*next-version*]
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_api_key()
|
|
{
|
|
$api_key = defined('PR_DHL_GLOBAL_API') ? PR_DHL_GLOBAL_API : '';
|
|
|
|
return $api_key;
|
|
}
|
|
}
|