OrderShippingFeesModificationUpdated
v0.0.1

OrderShippingFeesModificationUpdated

This event is triggered when an order shipping fees modification has been updated, this will include when the operation is e.g. started, restarted, completed, or failed.

If only the final outcome events are desired, we recommend listening for ShippingFeesModified, or ShippingFeesModifiedFailed.

OrderShippingFeesModificationUpdated Schema (json)
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "OrderShippingFeesModificationChanged",
  "required": ["detail-type", "resources", "detail", "id", "source", "time", "region", "version", "account"],
  "type": "object",
  "properties": {
    "account": {
      "type": "string"
    },
    "detail": {
      "$ref": "#/definitions/Detail"
    },
    "detail-type": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "resources": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source": {
      "type": "string"
    },
    "time": {
      "format": "date-time",
      "type": "string"
    },
    "version": {
      "type": "string"
    }
  },
  "definitions": {
    "Detail": {
      "properties": {
        "data": {
          "$ref": "#/definitions/Data"
        },
        "metadata": {
          "$ref": "#/definitions/Metadata"
        }
      },
      "required": ["metadata", "data"],
      "type": "object"
    },
    "Metadata": {
      "type": "object",
      "required": ["awsRequestId"],
      "properties": {
        "awsRequestId": {
          "type": "string"
        },
        "isTruncated": {
          "type": "boolean"
        }
      }
    },
    "Data": {
      "$ref": "#/definitions/OrderShippingFeesModification"
    },
    "OrderShippingFeesModification": {
      "type": "object",
      "required": [
        "id",
        "orderId",
        "orderReference",
        "paymentProvider",
        "shippingFees",
        "created",
        "updated",
        "restarts",
        "revision"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The shipping fees modification id"
        },
        "orderId": {
          "type": "string",
          "description": "The order id"
        },
        "orderReference": {
          "type": "string",
          "description": "The order short reference"
        },
        "paymentProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "shippingProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "giftCardProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "giftCardProductProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "voucherProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "promotionProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "bonusProvider": {
          "$ref": "#/definitions/ProviderStatus"
        },
        "shippingFees": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/ShippingFeeModification"
          }
        },
        "reason": {
          "$ref": "#/definitions/Reason"
        },
        "created": {
          "type": "string",
          "format": "date-time",
          "description": "Created date for the shipping fees modification"
        },
        "updated": {
          "type": "string",
          "format": "date-time",
          "description": "Updated date for the shipping fees modification"
        },
        "started": {
          "type": "string",
          "format": "date-time",
          "description": "Started date for the shipping fees modification"
        },
        "completed": {
          "type": "string",
          "format": "date-time",
          "description": "Completed date for the shipping fees modification"
        },
        "failed": {
          "type": "string",
          "format": "date-time",
          "description": "Failed date for the shipping fees modification"
        },
        "restarted": {
          "type": "string",
          "format": "date-time",
          "description": "Restarted date for the shipping fees modification"
        },
        "restarts": {
          "description": "The number of restarts",
          "type": "integer"
        },
        "revision": {
          "description": "The revision number of the shipping fees modification",
          "type": "integer"
        }
      }
    },
    "ProviderStatus": {
      "type": "object",
      "required": ["providerId", "providerName"],
      "properties": {
        "providerId": {
          "type": "string",
          "description": "The id for the provider"
        },
        "providerName": {
          "type": "string",
          "description": "The name of the provider"
        },
        "status": {
          "$ref": "#/definitions/ProviderStatusLog"
        }
      }
    },
    "ProviderStatusLog": {
      "type": "object",
      "required": ["current", "history"],
      "properties": {
        "current": {
          "type": "string",
          "description": "The latest status for the provider"
        },
        "history": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/ProviderStatusLogEntry"
          }
        }
      }
    },
    "ProviderStatusLogEntry": {
      "type": "object",
      "required": ["status", "timestamp", "type"],
      "properties": {
        "message": {
          "type": "string",
          "description": "Optional message for the status"
        },
        "errorMessage": {
          "type": "string",
          "description": "Optional error message from the provider"
        },
        "status": {
          "type": "string",
          "description": "The actual status"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp for the status"
        },
        "type": {
          "type": "string",
          "description": "Status type"
        }
      }
    },
    "Reason": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "Optional code for the reason, useful for BI tracking"
        },
        "cause": {
          "type": "string",
          "description": "Optional human readable cause for the reason"
        }
      }
    },
    "ModificationType": {
      "title": "ModificationType",
      "type": "string",
      "enum": ["UPDATE"]
    },
    "ShippingFeeModification": {
      "type": "object",
      "required": ["modificationType", "data"],
      "properties": {
        "modificationType": {
          "$ref": "#/definitions/ModificationType"
        },
        "data": {
          "oneOf": [
            {
              "$ref": "#/definitions/ShippingFeeModificationUpdate"
            }
          ]
        },
        "prev": {
          "$ref": "#/definitions/ShippingFeeModificationUpdatePrevious"
        }
      }
    },
    "ShippingFeeModificationUpdatePrevious": {
      "allOf": [
        {
          "$ref": "#/definitions/ShippingFeeModificationUpdate"
        }
      ],
      "description": "Read only field containing the previous data"
    },
    "ShippingFeeModificationUpdate": {
      "type": "object",
      "required": ["id"],
      "properties": {
        "id": {
          "type": "string",
          "description": "The id for the updated shipping fee"
        },
        "taxGroupId": {
          "type": "string",
          "description": "Updated taxGroupId for the shipping fee"
        },
        "price": {
          "$ref": "#/definitions/ShippingFeeModificationUpdatePrice"
        }
      }
    },
    "ShippingFeeModificationUpdatePrice": {
      "type": "object",
      "required": [
        "basePriceAmount",
        "salePriceAmount",
        "discountAmount",
        "taxAmount",
        "taxPercentage",
        "taxPercentageDecimals"
      ],
      "properties": {
        "basePriceAmount": {
          "type": "integer",
          "description": "Updated base price of the created shipping fee"
        },
        "salePriceAmount": {
          "type": "integer",
          "description": "Updated sale price of the created shipping fee"
        },
        "discountAmount": {
          "type": "integer",
          "description": "Updated discount amount of the shipping fee"
        },
        "taxAmount": {
          "type": "integer",
          "description": "Updated tax amount of the shipping fee"
        },
        "taxPercentage": {
          "type": "integer",
          "description": "Updated tax percentage of the shipping fee"
        },
        "taxPercentageDecimals": {
          "type": "integer",
          "description": "Updated tax percentage decimals of the shipping fee"
        }
      }
    }
  }
}
Last updated on 2026/3/3