Saltar al contenido
docs
EN
Preparación y envíosMétodos

Listar métodos de envío

Lista métodos de envío; onlyAvailable=true filtra según las capacidades de las ubicaciones.

GET/v1/shipping/methods
Requiere un token de acceso con el permiso settings:read.

Parámetros de consulta

limit?integer

Cantidad máxima de resultados por devolver.

Formatoint32
cursor?string

Cursor de la respuesta anterior. Omítelo en la primera página.

search?string

Búsqueda de texto libre.

sortBy?string

Campo por el que se ordena.

sortDirection?string

Dirección del ordenamiento: asc o desc.

Valor en

  • "asc"
  • "desc"
isActive?boolean

Solo elementos activos.

visibleInCheckout?boolean
onlyAvailable?boolean
postalCode?string
type?string

Solo este tipo.

Valor en

  • "regular"
  • "express"
  • "sameDay"
  • "pickup"
  • "localDelivery"
shippingProfileId?string

Identificador del perfil de envío.

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.ecomiq.pe/api/v1/shipping/methods" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004321806",      "storeId": "7204558912004327977",      "sellerId": "7204558912004323447",      "name": "Envío estándar",      "displayName": "Envío estándar",      "type": "regular",      "isActive": true,      "visibleInCheckout": true,      "sortOrder": 1,      "shippingProfileId": "7204558912004329819",      "minOrderAmount": 178,      "maxOrderAmount": 178,      "minWeight": 0.3,      "maxWeight": 0.3,      "allowSplitFulfillment": false,      "availableDays": [        "monday"      ],      "basePrice": 89,      "currency": "PEN",      "estimatedDeliveryDays": 30,      "estimatedDeliveryHours": 1,      "metadata": {},      "connectionId": "7204558912004329542",      "pickupPointIds": [        "7204558912004324876"      ],      "rates": [        {          "id": "7204558912004321806",          "storeId": "7204558912004327977",          "sellerId": "7204558912004323447",          "shippingMethodId": "7204558912004325207",          "type": "flat",          "price": 89,          "currency": "PEN",          "minOrderPrice": 89,          "maxOrderPrice": 89,          "postalCodes": [            "15074"          ],          "isActive": true,          "description": "Polo de algodón pima para uso diario.",          "discountPercentage": 10,          "zoneCode": "LIMA",          "minWeight": 0.3,          "maxWeight": 0.3,          "minValue": 1,          "maxValue": 1,          "basePrice": 89,          "pricePerKg": 89,          "pricePerUnit": 89,          "taxIncluded": false,          "surcharge": 1,          "metadata": {},          "createdOn": "2026-09-28T15:30:00Z",          "updatedOn": "2026-09-28T15:30:00Z",          "baseLanguage": "Envío estándar",          "translations": {            "key": {              "description": "Polo de algodón pima para uso diario."            }          }        }      ],      "createdOn": "2026-09-28T15:30:00Z",      "updatedOn": "2026-09-28T15:30:00Z",      "baseLanguage": "Envío estándar",      "translations": {        "key": {          "displayName": "Envío estándar"        }      }    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}