feat(Cart): support tax rounding mode

Closes #290

Author: Jens Schulze

src/Model/Cart/Cart.php

@@ -63,6 +63,8 @@
  * @method string getAnonymousId()
  * @method Cart setAnonymousId(string $anonymousId = null)
  * @method string getLocale()
+ * @method string getTaxRoundingMode()
+ * @method Cart setTaxRoundingMode(string $taxRoundingMode = null)
  * @method CartReference getReference()
  */
 class Cart extends Resource
@@ -72,6 +74,9 @@ class Cart extends Resource
     const TAX_MODE_PLATFORM = 'Platform';
     const TAX_MODE_EXTERNAL = 'External';
     const TAX_MODE_DISABLED = 'Disabled';
+    const TAX_ROUNDING_MODE_HALF_EVEN = 'HalfEven';
+    const TAX_ROUNDING_MODE_HALF_UP = 'HalfUp';
+    const TAX_ROUNDING_MODE_HALF_DOWN = 'HalfDown';
 
     public function fieldDefinitions()
     {
@@ -105,6 +110,7 @@ public function fieldDefinitions()
             'taxMode' => [static::TYPE => 'string'],
             'anonymousId' => [static::TYPE => 'string'],
             'locale' => [static::TYPE => 'string'],
+            'taxRoundingMode' => [static::TYPE => 'string'],
         ];
     }
 

src/Model/Cart/CartDraft.php

@@ -42,6 +42,8 @@
  * @method string getAnonymousId()
  * @method CartDraft setAnonymousId(string $anonymousId = null)
  * @method string getLocale()
+ * @method string getTaxRoundingMode()
+ * @method CartDraft setTaxRoundingMode(string $taxRoundingMode = null)
  */
 class CartDraft extends JsonObject
 {
@@ -64,6 +66,7 @@ public function fieldDefinitions()
             'taxMode' => [static::TYPE => 'string'],
             'anonymousId' => [static::TYPE => 'string'],
             'locale' => [static::TYPE => 'string'],
+            'taxRoundingMode' => [static::TYPE => 'string'],
         ];
     }
 

src/Model/Order/ImportOrder.php

@@ -54,6 +54,8 @@
  * @method ImportOrder setCustom(CustomFieldObjectDraft $custom = null)
  * @method string getInventoryMode()
  * @method ImportOrder setInventoryMode(string $inventoryMode = null)
+ * @method string getTaxRoundingMode()
+ * @method ImportOrder setTaxRoundingMode(string $taxRoundingMode = null)
  */
 class ImportOrder extends JsonObject
 {
@@ -81,6 +83,7 @@ public function fieldDefinitions()
             ],
             'custom' => [static::TYPE => '\Commercetools\Core\Model\CustomField\CustomFieldObjectDraft'],
             'inventoryMode' => [static::TYPE => 'string'],
+            'taxRoundingMode' => [static::TYPE => 'string'],
         ];
     }
 }

src/Model/Order/Order.php

@@ -85,10 +85,19 @@
  * @method string getAnonymousId()
  * @method Order setAnonymousId(string $anonymousId = null)
  * @method string getLocale()
+ * @method string getTaxRoundingMode()
+ * @method Order setTaxRoundingMode(string $taxRoundingMode = null)
  * @method OrderReference getReference()
  */
 class Order extends Resource
 {
+    const TAX_MODE_PLATFORM = 'Platform';
+    const TAX_MODE_EXTERNAL = 'External';
+    const TAX_MODE_DISABLED = 'Disabled';
+    const TAX_ROUNDING_MODE_HALF_EVEN = 'HalfEven';
+    const TAX_ROUNDING_MODE_HALF_UP = 'HalfUp';
+    const TAX_ROUNDING_MODE_HALF_DOWN = 'HalfDown';
+
     use LocaleTrait;
 
     public function fieldDefinitions()
@@ -134,6 +143,7 @@ public function fieldDefinitions()
             'paymentInfo' => [static::TYPE => '\Commercetools\Core\Model\Payment\PaymentInfo'],
             'anonymousId' => [static::TYPE => 'string'],
             'locale' => [static::TYPE => 'string'],
+            'taxRoundingMode' => [static::TYPE => 'string'],
         ];
     }
 }

src/Request/Carts/Command/CartChangeTaxRoundingModeAction.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * @author @jayS-de <jens.schulze@commercetools.de>
+ */
+
+namespace Commercetools\Core\Request\Carts\Command;
+
+use Commercetools\Core\Model\Common\Context;
+use Commercetools\Core\Request\AbstractAction;
+
+/**
+ * @package Commercetools\Core\Request\Carts\Command
+ * @link http://dev.commercetools.com/http-api-projects-carts.html#change-tax-roundingmode
+ * @method string getAction()
+ * @method CartChangeTaxRoundingModeAction setAction(string $action = null)
+ * @method string getTaxRoundingMode()
+ * @method CartChangeTaxRoundingModeAction setTaxRoundingMode(string $taxRoundingMode = null)
+ */
+class CartChangeTaxRoundingModeAction extends AbstractAction
+{
+    public function fieldDefinitions()
+    {
+        return [
+            'action' => [static::TYPE => 'string'],
+            'taxRoundingMode' => [static::TYPE => 'string'],
+        ];
+    }
+
+    /**
+     * @param array $data
+     * @param Context|callable $context
+     */
+    public function __construct(array $data = [], $context = null)
+    {
+        parent::__construct($data, $context);
+        $this->setAction('changeTaxRoundingMode');
+    }
+
+    /**
+     * @param string $roundingMode
+     * @param Context|callable $context
+     * @return CartChangeLineItemQuantityAction
+     */
+    public static function ofTaxRoundingMode($roundingMode, $context = null)
+    {
+        return static::of($context)->setTaxRoundingMode($roundingMode);
+    }
+}

tests/fixtures/models.yaml

@@ -25,6 +25,7 @@ cart:
     - taxMode
     - anonymousId
     - locale
+    - taxRoundingMode
 lineItem:
   domain: cart
   model: LineItem
@@ -365,6 +366,7 @@ order:
     - paymentInfo
     - anonymousId
     - locale
+    - taxRoundingMode
 syncInfo:
   domain: order
   model: SyncInfo
@@ -850,7 +852,7 @@ importOrder:
     - completedAt
     - custom
     - inventoryMode
-
+    - taxRoundingMode
 lineItemImportDraft:
   domain: order
   model: lineItemImportDraft

tests/integration/Cart/CartUpdateRequestTest.php

@@ -6,6 +6,7 @@
 namespace Commercetools\Core\Cart;
 
 use Commercetools\Core\ApiTestCase;
+use Commercetools\Core\Model\Cart\Cart;
 use Commercetools\Core\Model\Cart\CartDraft;
 use Commercetools\Core\Model\Cart\CustomLineItemDraft;
 use Commercetools\Core\Model\Cart\CustomLineItemDraftCollection;
@@ -39,6 +40,7 @@
 use Commercetools\Core\Request\Carts\Command\CartChangeCustomLineItemMoneyAction;
 use Commercetools\Core\Request\Carts\Command\CartChangeCustomLineItemQuantityAction;
 use Commercetools\Core\Request\Carts\Command\CartChangeLineItemQuantityAction;
+use Commercetools\Core\Request\Carts\Command\CartChangeTaxRoundingModeAction;
 use Commercetools\Core\Request\Carts\Command\CartRecalculateAction;
 use Commercetools\Core\Request\Carts\Command\CartRemoveCustomLineItemAction;
 use Commercetools\Core\Request\Carts\Command\CartRemoveDiscountCodeAction;
@@ -276,7 +278,7 @@ public function testUnsetExternalLineItemPriceQuantityChange()
         $this->assertSame(100, $cart->getLineItems()->current()->getPrice()->getValue()->getCentAmount());
         $this->assertSame(200, $cart->getLineItems()->current()->getTotalPrice()->getCentAmount());
     }
-    
+
     public function testCustomLineItem()
     {
         $draft = $this->getDraft();
@@ -1112,6 +1114,33 @@ public function testInvalidLocale($locale)
         $this->assertTrue($response->isError());
     }
 
+    public function testTaxRoundingMode()
+    {
+        $draft = $this->getDraft();
+        $cart = $this->createCart($draft);
+
+        $this->assertSame(Cart::TAX_ROUNDING_MODE_HALF_EVEN, $cart->getTaxRoundingMode());
+
+        $request = CartUpdateRequest::ofIdAndVersion($cart->getId(), $cart->getVersion())
+            ->addAction(CartChangeTaxRoundingModeAction::ofTaxRoundingMode(Cart::TAX_ROUNDING_MODE_HALF_DOWN))
+        ;
+        $response = $request->executeWithClient($this->getClient());
+        $cart = $request->mapResponse($response);
+
+        $this->deleteRequest->setVersion($cart->getVersion());
+
+        $this->assertSame(Cart::TAX_ROUNDING_MODE_HALF_DOWN, $cart->getTaxRoundingMode());
+    }
+
+    public function testCreateWithTaxRoundingMode()
+    {
+        $draft = $this->getDraft();
+        $draft->setTaxRoundingMode(Cart::TAX_ROUNDING_MODE_HALF_DOWN);
+        $cart = $this->createCart($draft);
+
+        $this->assertSame(Cart::TAX_ROUNDING_MODE_HALF_DOWN, $cart->getTaxRoundingMode());
+    }
+
     /**
      * @return CartDraft
      */