Maginium
Admin Api
Admin Api
  • About
  • API reference
    • CustomerGroups
      • Permissions
      • Default
      • Search
    • Customers
      • Confirm
      • BillingAddress
      • ShippingAddress
      • Carts
      • Me
        • Activate
        • Password
        • BillingAddress
        • ShippingAddress
      • Search
      • Activate
      • Password
        • ResetLinkToken
      • ResetPassword
      • Validate
      • IsEmailAvailable
      • Addresses
      • Permissions
        • Readonly
    • CmsPage
      • Search
    • CmsBlock
      • Search
    • Products
      • Media
        • Types
      • Options
        • Types
      • Links
        • Types
        • Attributes
      • Websites
      • Downloadable links
        • Samples
      • Attributes
        • Options
        • Types
      • Attribute sets
        • Attributes
        • Groups
          • List
        • Sets
          • List
      • Tier prices
      • Types
      • Tier prices information
      • Tier prices delete
      • Base prices information
      • Base prices
      • Cost information
      • Cost
      • Cost delete
      • Special price information
      • Special price
      • Special price delete
      • StockItems
      • Group prices
        • Tiers
          • Price
    • Categories
      • Attributes
        • Options
      • Products
      • Move
      • List
    • StockItems
      • LowStock
        • /
    • Carts
      • Items
      • Selected payment method
      • Billing address
      • Coupons
      • Gift message
      • Order
      • Shipping methods
      • Estimate shipping methods by address id
      • Estimate shipping methods
      • Payment methods
      • Totals
      • Shipping information
      • Totals information
      • Mine
        • Items
        • Selected payment method
        • Billing address
        • Coupons
        • Payment information
        • Gift message
        • Order
        • Shipping methods
        • Estimate shipping methods by address id
        • Estimate shipping methods
        • Payment methods
        • Totals
        • Collect totals
        • Shipping information
        • Totals information
        • Set payment information
      • Licence
        • List
      • /
      • Search
    • Guest carts
      • Items
      • Selected payment method
      • Billing address
      • Coupons
      • Payment information
      • Gift message
      • Order
      • Shipping methods
      • Estimate shipping methods
      • Payment methods
      • Collect totals
      • Totals
      • Shipping information
      • Totals information
      • Set payment information
    • Orders
      • Comments
      • Statuses
      • Cancel
      • Emails
      • Hold
      • Unhold
      • Items
      • Create
    • Invoices
      • Comments
      • Emails
      • Void
      • Capture
      • /
    • Creditmemo
      • Comments
      • Emails
      • Refund
    • Shipment
      • Comments
      • Emails
      • Label
      • Track
      • /
    • Transactions
    • TaxRates
      • Search
    • TaxRules
      • Search
    • TaxClasses
      • Search
    • SalesRules
      • Search
    • Coupons
      • Search
      • Generate
      • DeleteByIds
      • DeleteByCodes
    • Bulk
      • Detailed status
      • Status
      • Operation status
    • Modules
    • Search
    • Addresses
    • Products render info
    • StockStatuses
    • Creditmemos
    • Shipments
    • Amazon shipping address
    • Amazon billing address
    • Store
      • StoreViews
      • StoreGroups
      • Websites
      • StoreConfigs
    • Adobestock
      • Asset
        • Search
        • List
      • Search
    • Directory
      • Countries
      • Currency
    • Eav
      • Attribute sets
        • List
    • AttributeMetadata
      • Customer
        • Attribute
        • Form
        • Custom
      • CustomerAddress
        • Attribute
        • Form
        • Custom
    • Bundle products
      • Links
      • Options
        • Children
        • All
        • Types
        • Add
      • Children
    • Order
      • Refund
      • Ship
      • Invoice
      • Notify orders are ready for pickup
    • Configurable products
      • Children
      • Options
        • All
      • Child
      • Variation
    • Inventory
      • Sources
      • Stocks
      • Stock source links
      • Source items
      • Low quantity notification
      • Get sources assigned to stock ordered by priority
      • Stock source links delete
      • Source items delete
      • Bulk product source assign
      • Bulk product source unassign
      • Bulk product source transfer
      • Bulk partial source transfer
      • Get distance provider code
      • Get distance
      • Get latlng from address
      • Get latslngs from address
      • Export stock salable qty
      • Dump stock index data
      • Get product salable quantity
      • Is product salable
      • Are products salable
      • Is product salable for requested qty
      • Stock resolver
      • Source selection algorithm list
      • Source selection algorithm result
      • Low quantity notifications delete
      • Are product salable for requested qty
        • /
      • In store pickup
        • Pickup locations
          • /
    • Invoice
      • Refund
    • Analytics
      • Link
    • Amazon
      • Order ref
    • Applepay
      • Auth
    • Address
      • Cleanse
    • Guest address
      • Cleanse
    • Vertex address validation
      • Vertex address
    • Integration
      • Admin
        • Token
      • Customer
        • Token
Powered by GitBook
On this page
  1. API reference
  2. Shipment

/

PreviousTrackNextTransactions

sales Shipment Repository V1Save Post

post

Performs persist operations for a specified shipment.

Header parameters
Content-TypestringOptionalExample: application/json
Body
objectOptionalExample: {"entity":{"order_id":"<integer>","items":[{"order_item_id":"<integer>","qty":"<number>","additional_data":"<string>","description":"<string>","entity_id":"<integer>","name":"<string>","parent_id":"<integer>","price":"<number>","product_id":"<integer>","row_total":"<number>","sku":"<string>","weight":"<number>","extension_attributes":"<object>"},{"order_item_id":"<integer>","qty":"<number>","additional_data":"<string>","description":"<string>","entity_id":"<integer>","name":"<string>","parent_id":"<integer>","price":"<number>","product_id":"<integer>","row_total":"<number>","sku":"<string>","weight":"<number>","extension_attributes":"<object>"}],"tracks":[{"order_id":"<integer>","parent_id":"<integer>","weight":"<number>","qty":"<number>","description":"<string>","track_number":"<string>","title":"<string>","carrier_code":"<string>","created_at":"<string>","entity_id":"<integer>","updated_at":"<string>","extension_attributes":"<object>"},{"order_id":"<integer>","parent_id":"<integer>","weight":"<number>","qty":"<number>","description":"<string>","track_number":"<string>","title":"<string>","carrier_code":"<string>","created_at":"<string>","entity_id":"<integer>","updated_at":"<string>","extension_attributes":"<object>"}],"comments":[{"is_customer_notified":"<integer>","parent_id":"<integer>","comment":"<string>","is_visible_on_front":"<integer>","extension_attributes":"<object>","created_at":"<string>","entity_id":"<integer>"},{"is_customer_notified":"<integer>","parent_id":"<integer>","comment":"<string>","is_visible_on_front":"<integer>","extension_attributes":"<object>","created_at":"<string>","entity_id":"<integer>"}],"billing_address_id":"<integer>","created_at":"<string>","customer_id":"<integer>","email_sent":"<integer>","entity_id":"<integer>","increment_id":"<string>","packages":[{"extension_attributes":"<object>"},{"extension_attributes":"<object>"}],"shipment_status":"<integer>","shipping_address_id":"<integer>","shipping_label":"<string>","store_id":"<integer>","total_qty":"<number>","total_weight":"<number>","updated_at":"<string>","extension_attributes":{"source_code":"<string>"}}}
Responses
200
OK
application/json
Responseobject
401
Unauthorized
application/json
500
Internal Server Error
application/json
post
POST /V1/shipment/ HTTP/1.1
Host: {{baseurl}}
Content-Type: application/json
Accept: */*
Content-Length: 2132

{
  "entity": {
    "order_id": "<integer>",
    "items": [
      {
        "order_item_id": "<integer>",
        "qty": "<number>",
        "additional_data": "<string>",
        "description": "<string>",
        "entity_id": "<integer>",
        "name": "<string>",
        "parent_id": "<integer>",
        "price": "<number>",
        "product_id": "<integer>",
        "row_total": "<number>",
        "sku": "<string>",
        "weight": "<number>",
        "extension_attributes": "<object>"
      },
      {
        "order_item_id": "<integer>",
        "qty": "<number>",
        "additional_data": "<string>",
        "description": "<string>",
        "entity_id": "<integer>",
        "name": "<string>",
        "parent_id": "<integer>",
        "price": "<number>",
        "product_id": "<integer>",
        "row_total": "<number>",
        "sku": "<string>",
        "weight": "<number>",
        "extension_attributes": "<object>"
      }
    ],
    "tracks": [
      {
        "order_id": "<integer>",
        "parent_id": "<integer>",
        "weight": "<number>",
        "qty": "<number>",
        "description": "<string>",
        "track_number": "<string>",
        "title": "<string>",
        "carrier_code": "<string>",
        "created_at": "<string>",
        "entity_id": "<integer>",
        "updated_at": "<string>",
        "extension_attributes": "<object>"
      },
      {
        "order_id": "<integer>",
        "parent_id": "<integer>",
        "weight": "<number>",
        "qty": "<number>",
        "description": "<string>",
        "track_number": "<string>",
        "title": "<string>",
        "carrier_code": "<string>",
        "created_at": "<string>",
        "entity_id": "<integer>",
        "updated_at": "<string>",
        "extension_attributes": "<object>"
      }
    ],
    "comments": [
      {
        "is_customer_notified": "<integer>",
        "parent_id": "<integer>",
        "comment": "<string>",
        "is_visible_on_front": "<integer>",
        "extension_attributes": "<object>",
        "created_at": "<string>",
        "entity_id": "<integer>"
      },
      {
        "is_customer_notified": "<integer>",
        "parent_id": "<integer>",
        "comment": "<string>",
        "is_visible_on_front": "<integer>",
        "extension_attributes": "<object>",
        "created_at": "<string>",
        "entity_id": "<integer>"
      }
    ],
    "billing_address_id": "<integer>",
    "created_at": "<string>",
    "customer_id": "<integer>",
    "email_sent": "<integer>",
    "entity_id": "<integer>",
    "increment_id": "<string>",
    "packages": [
      {
        "extension_attributes": "<object>"
      },
      {
        "extension_attributes": "<object>"
      }
    ],
    "shipment_status": "<integer>",
    "shipping_address_id": "<integer>",
    "shipping_label": "<string>",
    "store_id": "<integer>",
    "total_qty": "<number>",
    "total_weight": "<number>",
    "updated_at": "<string>",
    "extension_attributes": {
      "source_code": "<string>"
    }
  }
}
{
  "order_id": "<integer>",
  "items": [
    {
      "order_item_id": "<integer>",
      "qty": "<number>",
      "additional_data": "<string>",
      "description": "<string>",
      "entity_id": "<integer>",
      "name": "<string>",
      "parent_id": "<integer>",
      "price": "<number>",
      "product_id": "<integer>",
      "row_total": "<number>",
      "sku": "<string>",
      "weight": "<number>",
      "extension_attributes": "<object>"
    },
    {
      "order_item_id": "<integer>",
      "qty": "<number>",
      "additional_data": "<string>",
      "description": "<string>",
      "entity_id": "<integer>",
      "name": "<string>",
      "parent_id": "<integer>",
      "price": "<number>",
      "product_id": "<integer>",
      "row_total": "<number>",
      "sku": "<string>",
      "weight": "<number>",
      "extension_attributes": "<object>"
    }
  ],
  "tracks": [
    {
      "order_id": "<integer>",
      "parent_id": "<integer>",
      "weight": "<number>",
      "qty": "<number>",
      "description": "<string>",
      "track_number": "<string>",
      "title": "<string>",
      "carrier_code": "<string>",
      "created_at": "<string>",
      "entity_id": "<integer>",
      "updated_at": "<string>",
      "extension_attributes": "<object>"
    },
    {
      "order_id": "<integer>",
      "parent_id": "<integer>",
      "weight": "<number>",
      "qty": "<number>",
      "description": "<string>",
      "track_number": "<string>",
      "title": "<string>",
      "carrier_code": "<string>",
      "created_at": "<string>",
      "entity_id": "<integer>",
      "updated_at": "<string>",
      "extension_attributes": "<object>"
    }
  ],
  "comments": [
    {
      "is_customer_notified": "<integer>",
      "parent_id": "<integer>",
      "comment": "<string>",
      "is_visible_on_front": "<integer>",
      "extension_attributes": "<object>",
      "created_at": "<string>",
      "entity_id": "<integer>"
    },
    {
      "is_customer_notified": "<integer>",
      "parent_id": "<integer>",
      "comment": "<string>",
      "is_visible_on_front": "<integer>",
      "extension_attributes": "<object>",
      "created_at": "<string>",
      "entity_id": "<integer>"
    }
  ],
  "billing_address_id": "<integer>",
  "created_at": "<string>",
  "customer_id": "<integer>",
  "email_sent": "<integer>",
  "entity_id": "<integer>",
  "increment_id": "<string>",
  "packages": [
    {
      "extension_attributes": "<object>"
    },
    {
      "extension_attributes": "<object>"
    }
  ],
  "shipment_status": "<integer>",
  "shipping_address_id": "<integer>",
  "shipping_label": "<string>",
  "store_id": "<integer>",
  "total_qty": "<number>",
  "total_weight": "<number>",
  "updated_at": "<string>",
  "extension_attributes": {
    "source_code": "<string>"
  }
}