WORLD_BUISINESS : Atleast one item data is required

[visualight]

I don't understand what's missing for an international delivery. The API returns: "Atleast one item data is required" and refuses to create the label.

Here's my code :

$delivery_costs = $transporter->delivery_costs;

                    switch ($carrierData['weight']) {
                        case 2000:
                            $delivery_price = 'cost_1';
                            break;
                        default:
                            $delivery_price = 'cost_2';
                            break;
                    }

                    if (is_numeric($delivery_costs[$carrierData['country']][$delivery_price])) {
                        $temp_price = (float)$delivery_costs[$carrierData['country']][$delivery_price];

                        if ($temp_price >= 0.00 && $temp_price <= 999.99) {
                            $formatted_price = number_format($temp_price, 2);
                        } else {
                            // La valeur est en dehors des limites autorisées
                            $formatted_price = "0.00";
                        }
                    } else {
                        // La valeur n'est pas numérique
                        $formatted_price = "0.00";
                    }

                    $customsInfo = new Box\CustomsInfo\CustomsInfo();
                    $customsInfo->setParcelValue($carrierData['total']); // INT
                    $customsInfo->setCurrency(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_CURRENCY_EUR);
                    $customsInfo->setAmtPostagePaidByAddresse($formatted_price); //FLOAT : String
                    $customsInfo->setContentDescription('FASHION');
                    $customsInfo->setShipmentType(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_SHIPMENT_TYPE_GOODS);
                    $customsInfo->setParcelReturnInstructions(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_PARCEL_RETURN_INSTRUCTION_RTS);
                    $customsInfo->setPrivateAddress(true);

                    $international = new Box\International();
                    $international->setProduct(Bpost\ProductConfiguration\Product::PRODUCT_NAME_BPACK_WORLD_BUSINESS);
                    $international->setReceiver($receiver);
                    $international->setParcelWeight($carrierData['weight']);
                    $international->setCustomsInfo($customsInfo);

                    $box->setInternationalBox($international);

[WhereIsLucas]

Hi,

Did you sort it out in any way ?
Go the same problem.

Thanks,

Lucas

[visualight]

Hi,

Did you sort it out in any way ? Go the same problem.

Thanks,

Lucas

Hello Lucas,

The Bpost API is poorly done and poorly documented I think (same with the Mondial Relay API).

Make sure you clean up the data before trying to generate labels.

Here's a working code

$carrierData = [
    'company' => $user->delivery->company,
    'name' => $user->delivery->firstname.' '.$user->delivery->lastname,
    'address1' => $user->delivery->address1,
    'number' => $user->delivery->number,
    'address2' => $user->delivery->address2,
    'zip' => $user->delivery->zip,
    'city' => $user->delivery->city,
    'country' => $user->delivery->country,
    'total' => ((int)ceil((float)$transaction->total) * 100),
];

// Enlève caractères spéciaux
$carrierData = cleanArray($carrierData);

$carrierData['reference'] = 'TR_'.$transaction->id;
$carrierData['phone'] = $user->phone;
$carrierData['email'] = $user->email;

$weight = [];
foreach ($cart as $item){
    $weight[] = (int)$item->weight;
}

$weight = max($weight);
if (count($cart) > 1) {
    $weight = 2;
}

if($weight === 1) {
    $weight = '2000';
} else {
    $weight = '5000';
}

$carrierData['weight'] = $weight;

$label_data = $this->genBpostLabel($carrierData);

public function genBpostLabel($carrierData)
{
    $transporter = Transporter::find(1);

    if($transporter)
    {
        try
        {
            $orderReference = $carrierData['reference'];

            $bpost = new Bpost($transporter->api_key, $transporter->api_secret);

            $receiverAddress = new Address();
            $receiverAddress->setStreetName($carrierData['address1']);
            $receiverAddress->setNumber($carrierData['number']);
            $receiverAddress->setPostalCode($carrierData['zip']);
            $receiverAddress->setLocality($carrierData['city']);
            $receiverAddress->setCountryCode($carrierData['country']);

            $receiver = new Receiver();
            $receiver->setAddress($receiverAddress);

            if($carrierData['company']){
                $receiver->setCompany($carrierData['company']);
            }

            $receiver->setName($carrierData['name']);
            $receiver->setPhoneNumber($carrierData['phone']);
            $receiver->setEmailAddress($carrierData['email']);

            $box = new Box();

            if($carrierData['country'] === 'BE')
            {
                $atHome = new AtHome();
                $atHome->setProduct(Bpost\ProductConfiguration\Product::PRODUCT_NAME_BPACK_24H_BUSINESS);
                $atHome->setWeight($carrierData['weight']);

                if($carrierData['address2']){
                    $atHome->setDesiredDeliveryPlace($carrierData['address2']);
                }

                $atHome->setReceiver($receiver);

                $box->setNationalBox($atHome);
            }
            else
            {
                $delivery_costs = $transporter->delivery_costs;

                switch ($carrierData['weight']) {
                    case 2000:
                        $delivery_price = 'cost_1';
                        break;
                    default:
                        $delivery_price = 'cost_2';
                        break;
                }

                if (is_numeric($delivery_costs[$carrierData['country']][$delivery_price])) {
                    $temp_price = (float)$delivery_costs[$carrierData['country']][$delivery_price];

                    if ($temp_price >= 0.00 && $temp_price <= 999.99) {
                        $formatted_price = number_format($temp_price, 2);
                    } else {
                        // La valeur est en dehors des limites autorisées
                        $formatted_price = "0.00";
                    }
                } else {
                    // La valeur n'est pas numérique
                    $formatted_price = "0.00";
                }

                $customsInfo = new Box\CustomsInfo\CustomsInfo();
                $customsInfo->setParcelValue($carrierData['total']);
                $customsInfo->setCurrency(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_CURRENCY_EUR);
                $customsInfo->setAmtPostagePaidByAddresse($formatted_price);
                $customsInfo->setContentDescription('FASHION');
                $customsInfo->setShipmentType(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_SHIPMENT_TYPE_GOODS);
                $customsInfo->setParcelReturnInstructions(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_PARCEL_RETURN_INSTRUCTION_RTS);
                $customsInfo->setPrivateAddress(true);

                $parcelContent = new Box\International\ParcelContent();
                $parcelContent
                    ->setNumberOfItemType(1)
                    ->setValueOfItem($carrierData['total'])
                    ->setItemDescription('FASHION')
                    ->setNettoWeight($carrierData['weight'])
                    ->setHsTariffCode(62)
                    ->setOriginOfGoods('BE');


                $international = new Box\International();
                $international->setProduct(Bpost\ProductConfiguration\Product::PRODUCT_NAME_BPACK_WORLD_BUSINESS);
                $international->setReceiver($receiver);
                $international->setParcelWeight($carrierData['weight']);
                $international->setCustomsInfo($customsInfo);

                $international->addParcelContent($parcelContent);

                $box->setInternationalBox($international);
            }


            $order = new Bpost\Order($orderReference);
            $order->addBox($box);

            $bpost->createOrReplaceOrder($order);

            $labels = $bpost->createLabelForOrder(
                $orderReference,
                Bpost::LABEL_FORMAT_A6,
                false,
                true
            );

            foreach ($labels as $label) {
                $barcode = $label->getBarcode();
                $bytes = $label->getBytes();

                $local = Storage::disk('public');
                $local->put('labels/bpost/'.$barcode.'.pdf', $bytes, 'public');
            }

            return json_encode(['provider' => 'bpost', 'tracking' => $barcode, 'file' => $barcode.'.pdf']);
        }
        catch (\Exception $e) {
            dd($e->getMessage());
        }
    }
    return false;
}

/**
 * HELPER : CLEAN SPECIAL CHAR
 * @param $array
 * @return mixed
 */
function cleanArray($array)
{
    foreach($array as $key => $value)
    {
        $cleanedValue = iconv('UTF-8', 'ASCII//TRANSLIT', $value);
        $cleanedValue = str_replace(',', ' ', $cleanedValue);
        $cleanedValue = str_replace('&', ' and ', $cleanedValue);
        $cleanedValue = preg_replace('/[^a-zA-Z0-9\s]/', '', $cleanedValue);
        $array[$key] = $cleanedValue;
    }

    return $array;
}

[visualight]

Hi,
Did you sort it out in any way ? Go the same problem.
Thanks,
Lucas

Hello Lucas,

The Bpost API is poorly done and poorly documented I think (same with the Mondial Relay API).

Make sure you clean up the data before trying to generate labels.

Here's a working code

$carrierData = [
    'company' => $user->delivery->company,
    'name' => $user->delivery->firstname.' '.$user->delivery->lastname,
    'address1' => $user->delivery->address1,
    'number' => $user->delivery->number,
    'address2' => $user->delivery->address2,
    'zip' => $user->delivery->zip,
    'city' => $user->delivery->city,
    'country' => $user->delivery->country,
    'total' => ((int)ceil((float)$transaction->total) * 100),
];

// Enlève caractères spéciaux
$carrierData = cleanArray($carrierData);

$carrierData['reference'] = 'TR_'.$transaction->id;
$carrierData['phone'] = $user->phone;
$carrierData['email'] = $user->email;

$weight = [];
foreach ($cart as $item){
    $weight[] = (int)$item->weight;
}

$weight = max($weight);
if (count($cart) > 1) {
    $weight = 2;
}

if($weight === 1) {
    $weight = '2000';
} else {
    $weight = '5000';
}

$carrierData['weight'] = $weight;

$label_data = $this->genBpostLabel($carrierData);

public function genBpostLabel($carrierData)
{
    $transporter = Transporter::find(1);

    if($transporter)
    {
        try
        {
            $orderReference = $carrierData['reference'];

            $bpost = new Bpost($transporter->api_key, $transporter->api_secret);

            $receiverAddress = new Address();
            $receiverAddress->setStreetName($carrierData['address1']);
            $receiverAddress->setNumber($carrierData['number']);
            $receiverAddress->setPostalCode($carrierData['zip']);
            $receiverAddress->setLocality($carrierData['city']);
            $receiverAddress->setCountryCode($carrierData['country']);

            $receiver = new Receiver();
            $receiver->setAddress($receiverAddress);

            if($carrierData['company']){
                $receiver->setCompany($carrierData['company']);
            }

            $receiver->setName($carrierData['name']);
            $receiver->setPhoneNumber($carrierData['phone']);
            $receiver->setEmailAddress($carrierData['email']);

            $box = new Box();

            if($carrierData['country'] === 'BE')
            {
                $atHome = new AtHome();
                $atHome->setProduct(Bpost\ProductConfiguration\Product::PRODUCT_NAME_BPACK_24H_BUSINESS);
                $atHome->setWeight($carrierData['weight']);

                if($carrierData['address2']){
                    $atHome->setDesiredDeliveryPlace($carrierData['address2']);
                }

                $atHome->setReceiver($receiver);

                $box->setNationalBox($atHome);
            }
            else
            {
                $delivery_costs = $transporter->delivery_costs;

                switch ($carrierData['weight']) {
                    case 2000:
                        $delivery_price = 'cost_1';
                        break;
                    default:
                        $delivery_price = 'cost_2';
                        break;
                }

                if (is_numeric($delivery_costs[$carrierData['country']][$delivery_price])) {
                    $temp_price = (float)$delivery_costs[$carrierData['country']][$delivery_price];

                    if ($temp_price >= 0.00 && $temp_price <= 999.99) {
                        $formatted_price = number_format($temp_price, 2);
                    } else {
                        // La valeur est en dehors des limites autorisées
                        $formatted_price = "0.00";
                    }
                } else {
                    // La valeur n'est pas numérique
                    $formatted_price = "0.00";
                }

                $customsInfo = new Box\CustomsInfo\CustomsInfo();
                $customsInfo->setParcelValue($carrierData['total']);
                $customsInfo->setCurrency(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_CURRENCY_EUR);
                $customsInfo->setAmtPostagePaidByAddresse($formatted_price);
                $customsInfo->setContentDescription('FASHION');
                $customsInfo->setShipmentType(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_SHIPMENT_TYPE_GOODS);
                $customsInfo->setParcelReturnInstructions(Bpost\Order\Box\CustomsInfo\CustomsInfo::CUSTOM_INFO_PARCEL_RETURN_INSTRUCTION_RTS);
                $customsInfo->setPrivateAddress(true);

                $parcelContent = new Box\International\ParcelContent();
                $parcelContent
                    ->setNumberOfItemType(1)
                    ->setValueOfItem($carrierData['total'])
                    ->setItemDescription('FASHION')
                    ->setNettoWeight($carrierData['weight'])
                    ->setHsTariffCode(62)
                    ->setOriginOfGoods('BE');


                $international = new Box\International();
                $international->setProduct(Bpost\ProductConfiguration\Product::PRODUCT_NAME_BPACK_WORLD_BUSINESS);
                $international->setReceiver($receiver);
                $international->setParcelWeight($carrierData['weight']);
                $international->setCustomsInfo($customsInfo);

                $international->addParcelContent($parcelContent);

                $box->setInternationalBox($international);
            }


            $order = new Bpost\Order($orderReference);
            $order->addBox($box);

            $bpost->createOrReplaceOrder($order);

            $labels = $bpost->createLabelForOrder(
                $orderReference,
                Bpost::LABEL_FORMAT_A6,
                false,
                true
            );

            foreach ($labels as $label) {
                $barcode = $label->getBarcode();
                $bytes = $label->getBytes();

                $local = Storage::disk('public');
                $local->put('labels/bpost/'.$barcode.'.pdf', $bytes, 'public');
            }

            return json_encode(['provider' => 'bpost', 'tracking' => $barcode, 'file' => $barcode.'.pdf']);
        }
        catch (\Exception $e) {
            dd($e->getMessage());
        }
    }
    return false;
}

/**
 * HELPER : CLEAN SPECIAL CHAR
 * @param $array
 * @return mixed
 */
function cleanArray($array)
{
    foreach($array as $key => $value)
    {
        $cleanedValue = iconv('UTF-8', 'ASCII//TRANSLIT', $value);
        $cleanedValue = str_replace(',', ' ', $cleanedValue);
        $cleanedValue = str_replace('&', ' and ', $cleanedValue);
        $cleanedValue = preg_replace('/[^a-zA-Z0-9\s]/', '', $cleanedValue);
        $array[$key] = $cleanedValue;
    }

    return $array;
}

Note : Use of the BPOST API also requires a pro contract with BPOST.

[WhereIsLucas]

Indeed the documentation is really bad, and I did not find any way to reverse engineer this problem.
Thanks for your quick reply !