Posting specific shipping profiles
Endpoints: POST /admin/shipping_profiles
Purpose
The POST /admin/shipping_profiles endpoint is used to create a new shipping profile, defining how shipping rules are applied to orders. It allows specifying profile types, associating shipping rules, and setting a preference for rule application. This is essential for managing different shipping strategies efficiently.
Path Parameters
No path parameters for this endpoint.
Query Parameters
This endpoint does not have any query parameters.
Use Case
Use the POST /admin/shipping_profiles endpoint when setting up a new shipping profile with specific rules and configurations. This is useful when adding new shipping methods, defining cost-based rule preferences, or structuring profiles for different geographical regions.
Request Body
{
"shipping_profile": {
"id": SHIPPING_PROFILE_ID,
"default": IS_DEFAULT,
"profile_type": {
"type": PROFILE_TYPE,
"select": MODULE_NAME,
"rule": RULE_TYPE
},
"name": PROFILE_NAME,
"shipping_rules": [SHIPPING_RULE_IDS],
"rule_preference": RULE_PREFERENCE,
"description": PROFILE_DESCRIPTION
}
}
Response
A successful POST /admin/shipping_profiles request returns the newly created shipping profile, including its unique identifier (id), name, rule preference, associated shipping rules, and timestamps (created_at and updated_at)
{
"shipping_profile": {
"id": SHIPPING_PROFILE_ID,
"name": SHIPPING_PROFILE_NAME,
"rule_preference": RULE_PREFERENCE,
"shipping_rules": [
{
"id": SHIPPING_RULE_ID,
"name": SHIPPING_RULE_NAME,
"shipping_policy": {
"id": SHIPPING_POLICY_ID,
"name": SHIPPING_POLICY_NAME
}
}
],
"description": SHIPPING_PROFILE_DESCRIPTION,
"created_at": CREATED_AT,
"updated_at": UPDATED_AT
}
}
