Developer reference

add_filter( 'woocommerce_shipping_smart_send_shipping_is_available', function ( bool $available, array $package, \Smart_Send\Shipping_Method\Method $method ): bool {
	return $available && 'DK' === ( $package['destination']['country'] ?? '' );
}, 10, 3 );

add_filter( 'woocommerce_shipping_smart_send_shipping_is_free_shipping', '__return_false' );

add_action( 'woocommerce_smart_send_shipping_shipping_add_rate', function ( \Smart_Send\Shipping_Method\Method $method, array $rate ): void {
	if ( ! isset( $method->rates[ $rate['id'] ] ) ) {
		return;
	}
	$rate['cost']  = (float) $method->rates[ $rate['id'] ]->get_cost() + 10;
	$rate['id']   .= ':extra-handling';
	$rate['label'] = 'Delivery with extra handling';
	$method->add_rate( $rate );
}, 10, 2 );

add_filter( 'smart_send_pickup_point_search_params', function ( array $params ): array {
	$params['postal_code'] = trim( $params['postal_code'] );
	return $params;
} );

add_filter( 'smart_send_pickup_points_found', function ( array $points, array $params ): array {
	$saturday = array();
	$other    = array();
	foreach ( $points as $point ) {
		$open_saturday = false;
		foreach ( $point->get_opening_hours() as $interval ) {
			if ( 'saturday' === $interval['day'] ) {
				$open_saturday = true;
				break;
			}
		}
		if ( $open_saturday ) {
			$saturday[] = $point;
		} else {
			$other[] = $point;
		}
	}
	return array_slice( array_merge( $saturday, $other ), 0, 5 );
}, 10, 2 );

add_filter( 'smart_send_pickup_point_label', function ( string $label, \Smart_Send\Delivery\Pickup_Point $point ): string {
	return $label . ' (#' . $point->get_agent_no() . ')';
}, 10, 2 );

add_filter( 'smart_send_pickup_point_timeout', function ( int $seconds ): int {
	return 6;
} );

add_filter( 'woocommerce_settings_api_form_fields_smart_send_shipping', function ( array $fields ): array {
	$fields['api_token_validate']['description'] = 'Save the API token before validating it.';
	return $fields;
} );

add_filter( 'woocommerce_shipping_instance_form_fields_smart_send_shipping', function ( array $fields ): array {
	$fields['title']['description'] = 'Shown to the customer at checkout.';
	return $fields;
} );

add_filter( 'smart_send_fulfillment_shipping_methods', function ( array $carriers, \WC_Order $order, bool $is_return ): array {
	if ( $is_return ) {
		return $carriers;
	}
	return array_values( array_filter( $carriers, function ( array $carrier ): bool {
		return 'postnord' === $carrier['code'];
	} ) );
}, 10, 3 );

add_filter( 'smart_send_delivery_details', function ( \Smart_Send\Delivery\Delivery_Details $details, \WC_Order $order, bool $is_return ): \Smart_Send\Delivery\Delivery_Details {
	if ( $is_return || null !== $details->get_parcel_plan() ) {
		return $details;
	}
	$items = array_values( $order->get_items() );
	if ( 1 !== count( $items ) || 3.0 !== (float) $items[0]->get_quantity() ) {
		return $details;
	}
	$item  = $items[0];
	$first = new \Smart_Send\Delivery\Parcel_Spec();
	$first->add_item( $item->get_id(), 2, $item->get_name() )
		->set_length( 30 )->set_width( 20 )->set_height( 15 );
	$second = new \Smart_Send\Delivery\Parcel_Spec();
	$second->add_item( $item->get_id(), 1, $item->get_name() )
		->set_length( 30 )->set_width( 20 )->set_height( 10 );
	$plan = new \Smart_Send\Delivery\Parcel_Plan();
	$plan->add_spec( $first )->add_spec( $second );
	return $details->set_parcel_plan( $plan );
}, 10, 3 );

add_filter( 'smart_send_parcel_default_weight', function ( float $weight, \Smart_Send\Delivery\Parcel_Spec $spec, \WC_Order $order ): float {
	return $weight + 0.20;
}, 10, 3 );

add_filter( 'smart_send_order_receiver', function ( array $address, int $order_id ): array {
	$address['country'] = strtoupper( $address['country'] );
	return $address;
}, 10, 2 );

add_filter( 'smart_send_receiver_phone', function ( ?string $phone, \WC_Order $order ): ?string {
	return null === $phone ? null : preg_replace( '/\s+/', '', $phone );
}, 10, 2 );

add_filter( 'smart_send_payload_receiver', function ( array $receiver, \WC_Order $order ): array {
	if ( null !== $receiver['email'] ) {
		$receiver['email'] = trim( $receiver['email'] );
	}
	return $receiver;
}, 10, 2 );

add_filter( 'smart_send_payload_items', function ( array $items, \WC_Order $order ): array {
	foreach ( $items as &$item ) {
		if ( is_string( $item['description'] ) ) {
			$item['description'] = trim( $item['description'] );
		}
	}
	unset( $item );
	return $items;
}, 10, 2 );

add_filter( 'smart_send_payload_totals', function ( array $totals, \WC_Order $order ): array {
	wc_get_logger()->info( 'Booking value', array(
		'source'   => 'my-shop-shipping',
		'currency' => $totals['currency'],
		'total'    => $totals['total_net_amount'] + $totals['total_tax_amount'],
	) );
	return $totals;
}, 10, 2 );

add_filter( 'smart_send_shipment_freetext', '__return_null' );

add_filter( 'smart_send_booking_request', function ( \Smart_Send\Booking\Shipment $shipment, \WC_Order $order, bool $is_return ): \Smart_Send\Booking\Shipment {
	if ( ! $is_return ) {
		$shipment->set_internal_reference( 'WEB-' . $order->get_order_number() );
	}
	return $shipment;
}, 10, 3 );

add_action( 'smart_send_booking_completed', function ( \Smart_Send\Booking\Booked_Shipment $booked, \Smart_Send\Booking\Shipment $request, \WC_Order $order ): void {
	wc_get_logger()->info( 'Smart Send shipment booked', array(
		'source'      => 'my-shop-shipping',
		'order_id'    => $order->get_id(),
		'shipment_id' => $booked->get_shipment_id(),
		'direction'   => $booked->is_return() ? 'return' : 'outbound',
	) );
}, 10, 3 );

add_action( 'smart_send_booking_failed', function ( \Smart_Send\Booking\Exceptions\Booking_Exception $error, \Smart_Send\Booking\Shipment $request, \WC_Order $order ): void {
	wc_get_logger()->warning( 'Smart Send booking failed', array(
		'source'      => 'my-shop-shipping',
		'order_id'    => $order->get_id(),
		'response_id' => $error->response_id(),
	) );
}, 10, 3 );

add_filter( 'smart_send_fulfillment_save_documents', '__return_false' );

add_filter( 'smart_send_fulfillment_order_note', function ( string $note, \Smart_Send\Booking\Booked_Shipment $shipment, \WC_Order $order ): string {
	return esc_html( 'Smart Send shipment ' . $shipment->get_shipment_id() );
}, 10, 3 );

add_filter( 'smart_send_fulfillment_tracking', '__return_false' );

add_filter( 'smart_send_fulfillment_order_status', '__return_false' );

add_action( 'smart_send_order_fulfilled', function ( \WC_Order $order, \Smart_Send\Fulfillment\Fulfillment_Result $result ): void {
	foreach ( $result->shipments() as $shipment ) {
		$label = $shipment->label_document();
		wc_get_logger()->info( 'Smart Send order updated', array(
			'source'        => 'my-shop-shipping',
			'order_id'      => $order->get_id(),
			'shipment_id'   => $shipment->get_shipment_id(),
			'note_id'       => $result->get_order_note_id( $shipment ),
			'has_document'  => null !== $label,
			'warning_count' => count( $result->get_warnings( $shipment ) ),
		) );
	}
	if ( null !== $result->get_return_error() ) {
		wc_get_logger()->warning( 'Return booking needs attention', array(
			'source'   => 'my-shop-shipping',
			'order_id' => $order->get_id(),
		) );
	}
}, 10, 2 );

add_filter( 'smart_send_api_endpoint', function ( string $host ): string {
	if ( 'staging' !== wp_get_environment_type() ) {
		return $host;
	}
	return 'https://app.smartsend.dev';
} );

add_filter( 'smart_send_sslverify', '__return_true' );

add_filter( 'smart_send_logging', function ( string $message, string $level, array $context ) {
	return 'debug' === $level ? null : $message;
}, 10, 3 );

add_filter( 'smart_send_configuration_url', function ( string $url ): string {
	return admin_url( 'admin.php?page=wc-settings&tab=shipping&section=smart_send_shipping' );
} );

add_filter( 'smart_send_support_url', function ( string $url ): string {
	return home_url( '/shipping-help/' );
} );

add_filter( 'ss_in_plugin_update_message', function ( string $notice ): string {
	return $notice . '<p>Review your shop customizations before updating.</p>';
} );

function my_shop_get_order_pickup_point( \WC_Order $order ): ?array {
	$point = SS_SHIPPING_WC()->order_meta()->read( $order )->get_pickup_point();

	if ( null === $point ) {
		return null;
	}

	return array(
		'agent_no'      => $point->get_agent_no(),
		'carrier'       => $point->get_carrier(),
		'company'       => $point->get_company(),
		'address_line1' => $point->get_address_line1(),
		'address_line2' => $point->get_address_line2(),
		'postal_code'   => $point->get_postal_code(),
		'city'          => $point->get_city(),
		'country'       => $point->get_country(),
	);
}

function my_shop_get_order_shipping_methods( \WC_Order $order ): array {
	$shipping_lines = array();

	foreach ( $order->get_shipping_methods() as $item_id => $item ) {
		$shipping_lines[] = array(
			'order_item_id' => (int) $item_id,
			'method_id'     => $item->get_method_id(),
			'instance_id'   => $item->get_instance_id(),
			'title'         => $item->get_method_title(),
		);
	}

	$resolver      = SS_SHIPPING_WC()->method_resolver();
	$return_method = '';
	$return_error  = null;

	try {
		$return_method = $resolver->resolve_return( $order );
	} catch ( \Smart_Send\Booking\Exceptions\Booking_Exception $exception ) {
		$return_error = $exception->getMessage();
	}

	return array(
		'shipping_lines' => $shipping_lines,
		'outbound'       => $resolver->resolve_outbound( $order ),
		'return'         => $return_method,
		'return_error'   => $return_error,
		'auto_return'    => $resolver->is_auto_return_enabled( $order ),
	);
}

function my_shop_get_order_bookings( \WC_Order $order ): array {
	$shipments = SS_SHIPPING_WC()->shipment_ids();

	return array(
		'latest_outbound_id' => $shipments->get( $order, false ),
		'latest_return_id'   => $shipments->get( $order, true ),
		'history'           => $shipments->labels( $order ),
	);
}