Sendcloud - Obtener Tarifas

Descripcion

Este modulo obtiene los precios de envio disponibles en Sendcloud para un paquete dado. Recibe el pais de origen, pais de destino, peso y opcionalmente un ID de metodo de envio especifico y la unidad de peso. Realiza una peticion GET al endpoint /shipping-price con los parametros correspondientes. Retorna las tarifas disponibles con ID del metodo, transportista, nombre, precio, moneda y rangos de peso. Identifica automaticamente la tarifa mas economica.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Sendcloud (provider: sendcloud)
shipping_method_id	text	No	ID del metodo de envio (si vacio, devuelve todos)
from_country	text	Si	Codigo ISO 2 letras del pais de origen (por defecto: ES)
to_country	text	Si	Codigo ISO 2 letras del pais de destino
weight	text	Si	Peso del paquete en kilogramos (ej: 1.500)
weight_unit	select	No	Unidad de peso: kilogram (por defecto), gram, pound, ounce

Credenciales

Se requiere una credencial de tipo sendcloud con los siguientes campos:

public_key: Public Key de Sendcloud
secret_key: Secret Key de Sendcloud

Salida

{
  "success": true,
  "rates": [
    {
      "shipping_method_id": 8,
      "carrier": "correos_express",
      "name": "Correos Express Paq 24h",
      "price": "5.50",
      "currency": "EUR",
      "min_weight": "0.001",
      "max_weight": "5.000"
    }
  ],
  "rates_count": 4,
  "cheapest": {
    "shipping_method_id": 12,
    "carrier": "correos",
    "name": "Correos Paq Standard",
    "price": "3.80",
    "currency": "EUR"
  },
  "message": "4 tarifas obtenidas"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_sendcloud",
  "from_country": "ES",
  "to_country": "ES",
  "weight": "1.500"
}

API Utilizada

Endpoint: GET /shipping-price
Base: Sendcloud API (via helper _sendcloudHelper)
Documentacion: https://docs.sendcloud.sc/api/v2/

Notas

Si no se especifica shipping_method_id, se devuelven todas las tarifas disponibles
La moneda por defecto es EUR
El peso por defecto es en kilogramos; se puede cambiar la unidad con weight_unit
Las tarifas incluyen rangos de peso (min_weight, max_weight) para cada metodo