Set shipping/billing methods and additional data for cart and collect totals

PUT /V1/carts/mine/collect-totals

Set shipping/billing methods and additional data for cart and collect totals.

Body

paymentMethod object Required

Interface PaymentInterface
Hide paymentMethod attributes Show paymentMethod attributes object
- po_number string
  
  Purchase order number
- method string Required
  
  Payment method code
- additional_data array[string]
  
  Payment additional details
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Quote\Api\Data\PaymentInterface
  Hide extension_attributes attributes Show extension_attributes attributes object
  
  agreement_ids array[string]
  
  origin string
shippingCarrierCode string

The carrier code.
shippingMethodCode string

The shipping method code.
additionalData object

Additional data for totals collection.
Hide additionalData attributes Show additionalData attributes object
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Quote\Api\Data\TotalsAdditionalDataInterface
  Hide extension_attributes attribute Show extension_attributes attribute object
  
  gift_messages array[object]
  
  Interface MessageInterface
  
  Hide gift_messages attributes Show gift_messages attributes object
  
  gift_message_id integer
  
  Gift message ID. Otherwise, null.
  
  customer_id integer
  
  Customer ID. Otherwise, null.
  
  sender string Required
  
  Sender name.
  
  recipient string Required
  
  Recipient name.
  
  message string Required
  
  Message text.
  
  extension_attributes object
  
  ExtensionInterface class for @see \Magento\GiftMessage\Api\Data\MessageInterface
  
  Hide extension_attributes attributes Show extension_attributes attributes object
  
  entity_id string
  
  entity_type string
  
  wrapping_id integer
  
  wrapping_allow_gift_receipt boolean
  
  wrapping_add_printed_card boolean
- custom_attributes array[object]
  
  Interface for custom attribute value.
  Hide custom_attributes attributes Show custom_attributes attributes object
  
  attribute_code string Required
  
  Attribute code
  
  value string Required
  
  Attribute value

Responses

200

200 Success.
Hide response attributes Show response attributes object
- grand_total number
  
  Grand total in quote currency
- base_grand_total number
  
  Grand total in base currency
- subtotal number
  
  Subtotal in quote currency
- base_subtotal number
  
  Subtotal in base currency
- discount_amount number
  
  Discount amount in quote currency
- base_discount_amount number
  
  Discount amount in base currency
- subtotal_with_discount number
  
  Subtotal in quote currency with applied discount
- base_subtotal_with_discount number
  
  Subtotal in base currency with applied discount
- shipping_amount number
  
  Shipping amount in quote currency
- base_shipping_amount number
  
  Shipping amount in base currency
- shipping_discount_amount number
  
  Shipping discount amount in quote currency
- base_shipping_discount_amount number
  
  Shipping discount amount in base currency
- tax_amount number
  
  Tax amount in quote currency
- base_tax_amount number
  
  Tax amount in base currency
- weee_tax_applied_amount number Required
  
  Item weee tax applied amount in quote currency.
- shipping_tax_amount number
  
  Shipping tax amount in quote currency
- base_shipping_tax_amount number
  
  Shipping tax amount in base currency
- subtotal_incl_tax number
  
  Subtotal including tax in quote currency
- base_subtotal_incl_tax number
  
  Subtotal including tax in base currency
- shipping_incl_tax number
  
  Shipping including tax in quote currency
- base_shipping_incl_tax number
  
  Shipping including tax in base currency
- base_currency_code string
  
  Base currency code
- quote_currency_code string
  
  Quote currency code
- coupon_code string
  
  Applied coupon code
- items_qty integer
  
  Items qty
- items array[object]
  
  Interface TotalsItemInterface
  
  Hide items attributes Show items attributes object
  
  item_id integer Required
  
  Item id
  
  price number Required
  
  Item price in quote currency.
  
  base_price number Required
  
  Item price in base currency.
  
  qty number Required
  
  Item quantity.
  
  row_total number Required
  
  Row total in quote currency.
  
  base_row_total number Required
  
  Row total in base currency.
  
  row_total_with_discount number
  
  Row total with discount in quote currency. Otherwise, null.
  
  tax_amount number
  
  Tax amount in quote currency. Otherwise, null.
  
  base_tax_amount number
  
  Tax amount in base currency. Otherwise, null.
  
  tax_percent number
  
  Tax percent. Otherwise, null.
  
  discount_amount number
  
  Discount amount in quote currency. Otherwise, null.
  
  base_discount_amount number
  
  Discount amount in base currency. Otherwise, null.
  
  discount_percent number
  
  Discount percent. Otherwise, null.
  
  price_incl_tax number
  
  Price including tax in quote currency. Otherwise, null.
  
  base_price_incl_tax number
  
  Price including tax in base currency. Otherwise, null.
  
  row_total_incl_tax number
  
  Row total including tax in quote currency. Otherwise, null.
  
  base_row_total_incl_tax number
  
  Row total including tax in base currency. Otherwise, null.
  
  options string Required
  
  Item price in quote currency.
  
  weee_tax_applied_amount number Required
  
  Item weee tax applied amount in quote currency.
  
  weee_tax_applied string Required
  
  Item weee tax applied in quote currency.
  
  extension_attributes object
  
  ExtensionInterface class for @see \Magento\Quote\Api\Data\TotalsItemInterface
  
  Hide extension_attributes attributes Show extension_attributes attributes object
  
  negotiable_quote_item_totals object
  
  Extension attribute for quote item totals model.
  
  Hide negotiable_quote_item_totals attributes Show negotiable_quote_item_totals attributes object
  
  cost number Required
  
  Cost for quote item.
  
  catalog_price number Required
  
  Catalog price for quote item.
  
  base_catalog_price number Required
  
  Catalog price for quote item in base currency.
  
  catalog_price_incl_tax number Required
  
  Catalog price with included tax for quote item.
  
  base_catalog_price_incl_tax number Required
  
  Catalog price with included tax for quote item in base currency.
  
  cart_price number Required
  
  Cart price for quote item.
  
  base_cart_price number Required
  
  Cart price for quote item in base currency.
  
  cart_tax number Required
  
  Tax from catalog price for quote item.
  
  base_cart_tax number Required
  
  Tax from catalog price for quote item in base currency.
  
  cart_price_incl_tax number Required
  
  Cart price with included tax for quote item.
  
  base_cart_price_incl_tax number Required
  
  Cart price with included tax for quote item in base currency.
  
  extension_attributes object
  
  ExtensionInterface class for @see \Magento\NegotiableQuote\Api\Data\NegotiableQuoteItemTotalsInterface
  
  sku string
  
  manufacturer_name string
  
  regular_price_incl_tax string
  
  name string
  
  Product name. Otherwise, null.
- total_segments array[object] Required
  
  Interface TotalsInterface
  
  Hide total_segments attributes Show total_segments attributes object
  
  code string Required
  
  Code
  
  title string
  
  Total title
  
  value number Required
  
  Total value
  
  area string
  
  Display area code.
  
  extension_attributes object
  
  ExtensionInterface class for @see \Magento\Quote\Api\Data\TotalSegmentInterface
  
  Hide extension_attributes attributes Show extension_attributes attributes object
  
  tax_grandtotal_details array[object]
  
  Interface GrandTotalDetailsInterface
  
  Hide tax_grandtotal_details attributes Show tax_grandtotal_details attributes object
  
  amount number Required
  
  Tax amount value
  
  rates array[object] Required
  
  Interface GrandTotalRatesInterface
  
  Hide rates attributes Show rates attributes object
  
  percent string Required
  
  Tax percentage value
  
  title string Required
  
  Rate title
  
  group_id integer Required
  
  Group identifier
  
  gift_cards string
  
  gw_order_id string
  
  gw_item_ids array[string]
  
  gw_allow_gift_receipt string
  
  gw_add_card string
  
  gw_price string
  
  gw_base_price string
  
  gw_items_price string
  
  gw_items_base_price string
  
  gw_card_price string
  
  gw_card_base_price string
  
  gw_base_tax_amount string
  
  gw_tax_amount string
  
  gw_items_base_tax_amount string
  
  gw_items_tax_amount string
  
  gw_card_base_tax_amount string
  
  gw_card_tax_amount string
  
  gw_price_incl_tax string
  
  gw_base_price_incl_tax string
  
  gw_card_price_incl_tax string
  
  gw_card_base_price_incl_tax string
  
  gw_items_price_incl_tax string
  
  gw_items_base_price_incl_tax string
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Quote\Api\Data\TotalsInterface
  
  Hide extension_attributes attributes Show extension_attributes attributes object
  
  coupon_label string
  
  negotiable_quote_totals object
  
  Extension attribute for quote totals model.
  
  Hide negotiable_quote_totals attributes Show negotiable_quote_totals attributes object
  
  items_count integer Required
  
  The number of different items or products in the cart.
  
  quote_status string Required
  
  Negotiable quote status.
  
  created_at string Required
  
  The cart creation date and time.
  
  updated_at string Required
  
  The cart last update date and time.
  
  customer_group integer Required
  
  Customer group id.
  
  base_to_quote_rate number Required
  
  Base currency to quote currency rate.
  
  cost_total number Required
  
  Total cost for quote.
  
  base_cost_total number Required
  
  Total cost for quote in base currency.
  
  original_total number Required
  
  Original quote total.
  
  base_original_total number Required
  
  Original quote total in base currency.
  
  original_tax number Required
  
  Original tax amount for quote.
  
  base_original_tax number Required
  
  Original tax amount for quote in base currency.
  
  original_price_incl_tax number Required
  
  Original price with included tax for quote.
  
  base_original_price_incl_tax number Required
  
  Original price with included tax for quote in base currency.
  
  negotiated_price_type integer Required
  
  Negotiable quote type.
  
  negotiated_price_value number Required
  
  Negotiable price value for quote.
  
  base_customer_balance_amount number
  
  customer_balance_amount number
  
  coupon_codes array[string]
  
  coupons_labels array[string]
  
  reward_points_balance number
  
  reward_currency_amount number
  
  base_reward_currency_amount number
401

401 Unauthorized
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Error details
  
  Hide errors attributes Show errors attributes object
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters item
  
  Hide parameters attributes Show parameters attributes object
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters item
  
  Hide parameters attributes Show parameters attributes object
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
default

Unexpected error
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Error details
  
  Hide errors attributes Show errors attributes object
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters item
  
  Hide parameters attributes Show parameters attributes object
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters item
  
  Hide parameters attributes Show parameters attributes object
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace

PUT /V1/carts/mine/collect-totals

curl \
 -X PUT https://magento2.winkelstraat.mac/rest/all/V1/carts/mine/collect-totals \
 -d '{"paymentMethod":{"po_number":"string","method":"string","additional_data":["string"],"extension_attributes":{"agreement_ids":["string"],"origin":"string"}},"shippingCarrierCode":"string","shippingMethodCode":"string","additionalData":{"extension_attributes":{"gift_messages":[{"gift_message_id":42,"customer_id":42,"sender":"string","recipient":"string","message":"string","extension_attributes":{"entity_id":"string","entity_type":"string","wrapping_id":42,"wrapping_allow_gift_receipt":true,"wrapping_add_printed_card":true}}]},"custom_attributes":[{"attribute_code":"string","value":"string"}]}}'

Request examples

{
  "paymentMethod": {
    "po_number": "string",
    "method": "string",
    "additional_data": [
      "string"
    ],
    "extension_attributes": {
      "agreement_ids": [
        "string"
      ],
      "origin": "string"
    }
  },
  "shippingCarrierCode": "string",
  "shippingMethodCode": "string",
  "additionalData": {
    "extension_attributes": {
      "gift_messages": [
        {
          "gift_message_id": 42,
          "customer_id": 42,
          "sender": "string",
          "recipient": "string",
          "message": "string",
          "extension_attributes": {
            "entity_id": "string",
            "entity_type": "string",
            "wrapping_id": 42,
            "wrapping_allow_gift_receipt": true,
            "wrapping_add_printed_card": true
          }
        }
      ]
    },
    "custom_attributes": [
      {
        "attribute_code": "string",
        "value": "string"
      }
    ]
  }
}

Response examples (200)

{
  "grand_total": 42.0,
  "base_grand_total": 42.0,
  "subtotal": 42.0,
  "base_subtotal": 42.0,
  "discount_amount": 42.0,
  "base_discount_amount": 42.0,
  "subtotal_with_discount": 42.0,
  "base_subtotal_with_discount": 42.0,
  "shipping_amount": 42.0,
  "base_shipping_amount": 42.0,
  "shipping_discount_amount": 42.0,
  "base_shipping_discount_amount": 42.0,
  "tax_amount": 42.0,
  "base_tax_amount": 42.0,
  "weee_tax_applied_amount": 42.0,
  "shipping_tax_amount": 42.0,
  "base_shipping_tax_amount": 42.0,
  "subtotal_incl_tax": 42.0,
  "base_subtotal_incl_tax": 42.0,
  "shipping_incl_tax": 42.0,
  "base_shipping_incl_tax": 42.0,
  "base_currency_code": "string",
  "quote_currency_code": "string",
  "coupon_code": "string",
  "items_qty": 42,
  "items": [
    {
      "item_id": 42,
      "price": 42.0,
      "base_price": 42.0,
      "qty": 42.0,
      "row_total": 42.0,
      "base_row_total": 42.0,
      "row_total_with_discount": 42.0,
      "tax_amount": 42.0,
      "base_tax_amount": 42.0,
      "tax_percent": 42.0,
      "discount_amount": 42.0,
      "base_discount_amount": 42.0,
      "discount_percent": 42.0,
      "price_incl_tax": 42.0,
      "base_price_incl_tax": 42.0,
      "row_total_incl_tax": 42.0,
      "base_row_total_incl_tax": 42.0,
      "options": "string",
      "weee_tax_applied_amount": 42.0,
      "weee_tax_applied": "string",
      "extension_attributes": {
        "negotiable_quote_item_totals": {
          "cost": 42.0,
          "catalog_price": 42.0,
          "base_catalog_price": 42.0,
          "catalog_price_incl_tax": 42.0,
          "base_catalog_price_incl_tax": 42.0,
          "cart_price": 42.0,
          "base_cart_price": 42.0,
          "cart_tax": 42.0,
          "base_cart_tax": 42.0,
          "cart_price_incl_tax": 42.0,
          "base_cart_price_incl_tax": 42.0,
          "extension_attributes": {}
        },
        "sku": "string",
        "manufacturer_name": "string",
        "regular_price_incl_tax": "string"
      },
      "name": "string"
    }
  ],
  "total_segments": [
    {
      "code": "string",
      "title": "string",
      "value": 42.0,
      "area": "string",
      "extension_attributes": {
        "tax_grandtotal_details": [
          {
            "amount": 42.0,
            "rates": [
              {
                "percent": "string",
                "title": "string"
              }
            ],
            "group_id": 42
          }
        ],
        "gift_cards": "string",
        "gw_order_id": "string",
        "gw_item_ids": [
          "string"
        ],
        "gw_allow_gift_receipt": "string",
        "gw_add_card": "string",
        "gw_price": "string",
        "gw_base_price": "string",
        "gw_items_price": "string",
        "gw_items_base_price": "string",
        "gw_card_price": "string",
        "gw_card_base_price": "string",
        "gw_base_tax_amount": "string",
        "gw_tax_amount": "string",
        "gw_items_base_tax_amount": "string",
        "gw_items_tax_amount": "string",
        "gw_card_base_tax_amount": "string",
        "gw_card_tax_amount": "string",
        "gw_price_incl_tax": "string",
        "gw_base_price_incl_tax": "string",
        "gw_card_price_incl_tax": "string",
        "gw_card_base_price_incl_tax": "string",
        "gw_items_price_incl_tax": "string",
        "gw_items_base_price_incl_tax": "string"
      }
    }
  ],
  "extension_attributes": {
    "coupon_label": "string",
    "negotiable_quote_totals": {
      "items_count": 42,
      "quote_status": "string",
      "created_at": "string",
      "updated_at": "string",
      "customer_group": 42,
      "base_to_quote_rate": 42.0,
      "cost_total": 42.0,
      "base_cost_total": 42.0,
      "original_total": 42.0,
      "base_original_total": 42.0,
      "original_tax": 42.0,
      "base_original_tax": 42.0,
      "original_price_incl_tax": 42.0,
      "base_original_price_incl_tax": 42.0,
      "negotiated_price_type": 42,
      "negotiated_price_value": 42.0
    },
    "base_customer_balance_amount": 42.0,
    "customer_balance_amount": 42.0,
    "coupon_codes": [
      "string"
    ],
    "coupons_labels": [
      "string"
    ],
    "reward_points_balance": 42.0,
    "reward_currency_amount": 42.0,
    "base_reward_currency_amount": 42.0
  }
}

Response examples (401)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (default)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}