---
title: "Criar regra de frete"
method: POST
path: "/{alias}/customers/clusters/{clusterId}/shipping-rules"
tags: ["Clientes - Regras de frete dos clusters"]
---

# Criar regra de frete

`POST /{alias}/customers/clusters/{clusterId}/shipping-rules`

Cria uma nova regra de frete para um cluster específico

## Path parameters

- `alias` string, required
- `clusterId` integer, required

## Request body

- ClusterShippingRequest — Representa os dados necessários para criar ou atualizar uma regra de frete do cluster
  - `cluster_id` integer, required — ID do cluster
  - `country` string, required — País da regra de frete
  - `zipcode_min` integer, required — CEP inicial
  - `zipcode_max` integer, required — CEP final
  - `min_order_value` string, required — Valor mínimo para compra
  - `shipment_percent` number, required — Valor base de desconto para entrega

## Response `200`

Regra de frete criada com sucesso

- object
  - `data` ClusterShipping[]
    - `id` integer
    - `cluster_id` integer
    - `name` string
    - `country` string
    - `zipcode_min` integer
    - `zipcode_max` integer
    - `min_order_value` number, float
    - `shipment_discount_percent` number, float
    - `created_at` BaseTimestamp
      - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer — Número de representação do timezone.
      - `timezone` string — Fuso horário associado.
    - `updated_at` BaseTimestamp
      - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer — Número de representação do timezone.
      - `timezone` string — Fuso horário associado.

## Other responses

- `400` — Requisição inválida
- `404` — Cluster não encontrado

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)