Ucommerce
  • Ucommerce Next Gen
    • Getting Started
      • Prerequisites
      • Licensing
      • Ucommerce Templates
      • Headless Template
      • MVC Template
    • Headless
      • Postman Collection
      • Headless API Authentication
        • Token endpoint - Authorization Header
        • Authorization Scopes
        • Refreshing the Access Token
      • Reference
        • Cart
        • Cart / Order Line Items
        • Shipment
        • Billing
        • Promotion Codes
        • Price Groups
        • Payment Methods
        • Countries
        • Shipping Methods
        • Catalogs
        • Cart Custom Properties
        • Line Item Custom Properties
        • Orders
        • Views for Cart modifying operations
      • Custom Headless APIs
      • Error Handling
      • Pagination
      • Deprecation
    • Backoffice Authentication
      • Microsoft Entra ID Example
      • Auth0 Authentication Example
    • Definitions
      • What is a Definition
    • Search and indexing
      • Configuration
      • Indexing
        • Index Definitions
        • Facets
        • Indexing Prices
        • Suggestions
        • Custom Data
      • Searching
    • Payment Providers
      • Stripe Provider Integration
      • Implementing a custom payment provider
    • Data Import
    • Miscellaneous
      • Media
      • Price Group Inheritance
      • Price Group Criteria
      • Soft Deletion Of Entities
      • Logging
      • OpenTelemetry
    • Extensions
      • Extending Pipelines
        • Order Processing Pipelines
        • Checkout Pipelines
      • Changing Service Behavior
        • Images
        • Content
      • Custom Headless APIs
      • Extend the Backoffice
        • Custom UI Components
      • Custom Editor UI
      • Custom Promotion Criteria
      • Custom Price Group Criteria
    • How-To
      • Migrate from Classic
        • Common database issues
      • Entities from code
        • Bootstrapping data on startup
        • Product Definitions & Fields
      • Discover pipelines and their tasks
      • Executing a pipeline
    • Integrations
      • Umbraco Media Delivery API
      • App Slices
        • Product Picker
  • Release Notes
  • Contact Us
Powered by GitBook
On this page
  • Prerequisites
  • Add shipping information
  • Request
  • Response
  • Error Handling
  • Related Articles

Was this helpful?

  1. Ucommerce Next Gen
  2. Headless
  3. Reference

Shipment

PreviousCart / Order Line ItemsNextBilling

Last updated 1 year ago

Was this helpful?

You can enable a mini cart view in the following requests to show changes to the cart immediately. Find out more in the Views for Cart modifying operations

Prerequisites

  • access_token from Headless API Authentication

  • cartId from

  • countryId from from Countries

  • shippingMethodId from Shipping Methods

  • priceGroupId from the cart or from Price Groups

Add shipping information

Request

curl -D- -X POST <base_url>/api/v1/carts/<cartId>/shipping \
        -H 'Authorization: Bearer <ACCESS_TOKEN>'
        -H 'Content-Type: application/json' \
        -d '{
            "priceGroupId": "<priceGroupId>",
            "shippingMethodId": "<shippingMethodId>",
            "shippingAddress": {
                    "attention":"<attention>",
                    "city": "<city>",
                    "companyName":"<companyName>",
                    "countryId": "<countryId>",
                    "email":"<email>",
                    "firstName": "<firstName>",
                    "lastName": "<lastName>",
                    "line1": "<addressLine1>",
                    "line2": "<addressLine2>",
                    "mobileNumber":"<mobileNumber>",
                    "phoneNumber":"<phoneNumber>",
                    "postalCode": "<postalCode>",
                    "state":"<state>",
                },
            }'

Response

{
"success": "true"
}

Error Handling

Error
Description

BadRequest (400)

Missing or incorrect access token; Bad or missing request data; pipeline execution fails; etc.

Unauthorized (401)

The token is expired.

Forbidden (403)

The token does not have access to this endpoint.

NotFound (404)

Cart not found; Country not found; Price group not found.

Error Response Example

{
"errors":
    [
        {
            "error-description": "Country not found.",
            "error": "NotFound"
        }
    ]
}

Related Articles

Error Handling
Create a Cart