A: Partial cancellations

1. Structure the order as follows:

   • 1 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e.g. 10% or 5,00 €)

2. Execute a partial cancellation for Article A.

3. Cancel Article B, Shipping costs and the voucher.

use Stegback\Ratepay\Services\RatepayReturn;
$product = [
      'total_amount' => '189.00',
      'item' => [
         [
          'product_id' => 12731,
          'product_quantity' => 6,
          'product_price' => '31.5',
          'product_name' => 'Articale 1',
          ],
        ],
     ];

     $ratepay = new RatepayReturn;
     $ratepay = $ratepay->cancellation('part',$product,$transaction);
     return $ratepay;

B: Full cancellation

1. Structure the order as follows:

   • 1 x Article A

   • 1 x Article B

   • Shipping costs

2. Cancel the full order.

$product = [
      'total_amount' => '0',
     ];
$ratepay = new RatepayReturn;
$ratepay = $ratepay->cancellation('full',$product,$transaction);
return $ratepay;

C: Partial deliveries

1. Structure the order as follows:

   • 2 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e.g. -10% or -5,00 €)

2. Execute a partial delivery for the following items:

   • 1 x Article A

   • Shipping costs

   • Voucher for discount

3. Execute a second delivery for the remaining articles.

use Stegback\Ratepay\Services\RatepayShippmentApi;
$product = [
             "id" => '12731',
            "quantity" =>  6,
            "cost_per_item" => '31.5',
           "product_name" => "10m Anschlusskabel mit Schuko Steckverbinder und HMS Feldstecker",
          ];
$data = [
         'transactionId' => $transaction,
         'order_id' => '14065',
         'shipping_provider' => 'DSV',
         'tracking_number' => '123',
          'invoice_id' => '1213',
          'totalAmount' => '189.00',
          'products' => $product, 
          'discountAmount' => '0', 
          'shippingAmount' => '0'
         ];

$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data);
return $ratepay;

D: Partial cancellation & remaining delivery

1. The order should be structured as follows:

   • 1 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e.g. -5,00 €)

2. Perform a partial cancellation for article A.

3. Execute a delivery for the remaining articles.

$product = [
                    'total_amount' => '3398',
                    'item' => [
                        [
                            'product_id' => 33045136,
                            'product_quantity' => 2,
                            'product_price' => '1699',
                            'product_name' => '10 x 310W Easy Peak Power Solarmodule',
                        ],
                    ],
                    'discount' => 0,
                    'shipping' => 0,
                ];

$ratepay = new RatepayReturn;
$ratepay = $ratepay->cancellation('partial',$product,$transaction);

 $product = [
                    [ 
                        "id" => '33061501',
                        "quantity" =>  1,
                        "cost_per_item" => '1099',
                        "product_name" => "10 x 410w Bifazial Glas-Glas Full-Black Ht54-18x(Pd)-F Pv Modul",
                    ],
                    [ 
                        "id" => '33064616',
                        "quantity" =>  1,
                        "cost_per_item" => '105.75',
                        "product_name" => "100 Watt Solar Komplettsystem für Wohnmobile, Wohnwagen und Boote, Silber Rahmen Solarmodul- 46cm",
                    ]
                ];

                $data = [
                    'transactionId' => $transaction,
                    'order_id' => '14065',
                    'shipping_provider' => 'DSV',
                    'tracking_number' => '123',
                    'invoice_id' => '1213',
                    'totalAmount' => '1204.75',
                    'products' => $product, 
                    'discountAmount' => '0', 
                    'shippingAmount' => '0'
                ];

$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data);
return $ratepay;

E: Partial returns

1. The order should be structured as follows:

   • 2 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e. g. -10%)

2. Perform a delivery for all articles.

3. Execute a partial return with the following articles:

   • 1 x Article A

4. Finally return the remaining articles:

   • 1 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e. g. -10%)

$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data);
 
$ratepay = new RatepayReturn;
$ratepay = $ratepay->return('part',$product,$transaction);
return $ratepay;

F: Full return

1. The order should be structured as follows:

   • 2 x Article A

   • Shipping costs

   • Voucher for discount (e.g. -10% or -5,00 €)

2. Perform a full delivery.

3. Finally return all articles.

$ratepay = new RatepayReturn;
$ratepay = $ratepay->return('full',$product,$transaction);
return $ratepay;

G: Discount before delivery

1. The order should be structured as follows:

   • 1 x Article A

2. Add a discount with a negative value, after placing the order.

3. Execute a full delivery.

$data = [
         'transactionId' => $transaction,
         'order_id' => '14065',
         'shipping_provider' => 'DSV',
         'tracking_number' => '123',
         'invoice_id' => '1213',
         'totalAmount' => '1204.75',
         'products' => $product, 
         'discountAmount' => '10', // add discount at the time of shipping
         'shippingAmount' => '0' 
    ];
$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data); 
return $ratepay;

H: Add article (if contractually agreed)

1. The order should be structured as follows:

   • 1 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e.g. -10% or -5,00 €)

2. Add another item in addition.

3. Execute a full delivery.

  $ratepay = new RatepayReturn;
  $ratepay = $ratepay->changeOrder($transaction,$newProduct);

  $ratepay = new RatepayShippmentApi;
  $ratepay = $ratepay->deliveryConfirm($data);

  return $ratepay;

I: Exchange article

1. The order should be structured as follows:

   • 1 x Article A

   • 1 x Article B

   • Shipping costs

   • Voucher for discount (e. g. -10% or -5,00 €)

2. Perform a full delivery

3. Return Article A

4. Add another item

   • 1 x Article C

5. Perfom a delivery for Article C

$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data);
$ratepay = new RatepayReturn;
$ratepay = $ratepay->return('part',$product,$transaction);
$ratepay = new RatepayReturn;
$ratepay = $ratepay->changeOrder($transaction,$newProduct);
return $ratepay;

K: Discount & additional charge (if contractually agreed)

1. The order should be structured as follows:

   • 3 x Article A

   • 3 x Article B

   • Shipping costs

2. Add a discount, after placing the order.

3. Perfom a partial delivery for the following articles:

   • 1 x Article A

   • 1 x Article B

   • Discount

4. Add an additional debit / charge (e.g. fee)

5. Perform a partial delivery for the remaining articles:

   • 2 x Article A

   • 2 x Article B

6. Finally, add another discount.

L: Partial cancellation & partial return

1. The order should be structured as follows:

   • 2 x Article A

   • 2 x Article B

   • 2 x Article C

   • Shipping costs

2. Perform a partial delivery for 3 articles + shipping costs:

   • 2 x Article A

   • 1 x Article B

   • Shipping costs

3. Perform a partial cancellation for Article C.

4. Execute a partial return for the following articles:

   • 1 x Article A

   • 1 x Article B

5. Make a partial delivery for the remaining articles:

   • 1 x Article B

   • 1 x Article C

6. Complete a full return for the remaining three articles.

  // part delivery
$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data); // add discount 1 qty from 2
                
$ratepay = new RatepayReturn;
$ratepay = $ratepay->cancellation('part',$product,$transaction);

$ratepay = new RatepayReturn;
$ratepay = $ratepay->return('part',$product,$transaction);

$ratepay = new RatepayShippmentApi;
$ratepay = $ratepay->deliveryConfirm($data); // add discount
                
$ratepay = new RatepayReturn;
$ratepay = $ratepay->return('full',$product,$transaction);