title: Shipping Method
description: >-
  A Shipping Method represents a way in which an Order or Return can be shipped.
  Shipping Methods are created from a Shipping Option, but may contain
  additional details that can be necessary for the Fulfillment Provider to
  handle the shipment. If the shipping method is created for a return, it may be
  associated with a claim or a swap that the return is part of.
type: object
required:
  - cart_id
  - claim_order_id
  - data
  - id
  - order_id
  - price
  - return_id
  - shipping_option_id
  - swap_id
properties:
  id:
    description: The shipping method's ID
    type: string
    example: sm_01F0YET7DR2E7CYVSDHM593QG2
  shipping_option_id:
    description: The ID of the Shipping Option that the Shipping Method is built from.
    type: string
    example: so_01G1G5V27GYX4QXNARRQCW1N8T
  order_id:
    description: The ID of the order that the shipping method is used in.
    nullable: true
    type: string
    example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
  order:
    description: The details of the order that the shipping method is used in.
    x-expandable: order
    nullable: true
    type: object
  claim_order_id:
    description: The ID of the claim that the shipping method is used in.
    nullable: true
    type: string
    example: null
  claim_order:
    description: The details of the claim that the shipping method is used in.
    x-expandable: claim_order
    nullable: true
    type: object
  cart_id:
    description: The ID of the cart that the shipping method is used in.
    nullable: true
    type: string
    example: cart_01G8ZH853Y6TFXWPG5EYE81X63
  cart:
    description: The details of the cart that the shipping method is used in.
    x-expandable: cart
    nullable: true
    type: object
  swap_id:
    description: The ID of the swap that the shipping method is used in.
    nullable: true
    type: string
    example: null
  swap:
    description: The details of the swap that the shipping method is used in.
    x-expandable: swap
    nullable: true
    type: object
  return_id:
    description: The ID of the return that the shipping method is used in.
    nullable: true
    type: string
    example: null
  return_order:
    description: The details of the return that the shipping method is used in.
    x-expandable: return_order
    nullable: true
    type: object
  shipping_option:
    description: The details of the shipping option the method was created from.
    x-expandable: shipping_option
    nullable: true
    $ref: ./ShippingOption.yaml
  tax_lines:
    description: The details of the tax lines applied on the shipping method.
    type: array
    x-expandable: tax_lines
    items:
      $ref: ./ShippingMethodTaxLine.yaml
  price:
    description: >-
      The amount to charge for the Shipping Method. The currency of the price is
      defined by the Region that the Order that the Shipping Method belongs to
      is a part of.
    type: integer
    example: 200
  data:
    description: >-
      Additional data that the Fulfillment Provider needs to fulfill the
      shipment. This is used in combination with the Shipping Options data, and
      may contain information such as a drop point id.
    type: object
    example: {}
  includes_tax:
    description: Whether the shipping method price include tax
    type: boolean
    x-featureFlag: tax_inclusive_pricing
    default: false
  subtotal:
    description: The subtotal of the shipping
    type: integer
    example: 8000
  total:
    description: The total amount of the shipping
    type: integer
    example: 8200
  tax_total:
    description: The total of tax
    type: integer
    example: 0