Listar tiendas - Fire spark

{
  "data": [
    {
      "id": "pos-location-01",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
      "brand_id": "0001",
      "name": "Main Street",
      "status": "ACTIVE",
      "timezone": "America/Guayaquil",
      "contact": {
        "email": "main@merchant.com",
        "phone": "+593991234567",
        "name": "Main Street"
      },
      "location": {
        "latitude": -2.1894,
        "longitude": -79.8891,
        "address_line_1": "Calle Principal 456",
        "city": "Guayaquil",
        "country": "Ecuador",
        "postal_code": "090101",
        "business_name": "Main Street Restaurant"
      },
      "instructions": null,
      "coverage_zones": [],
      "availability": {
        "schedules": null,
        "temporary_closed_reason": null,
        "temporary_closed_until": null,
        "status": "OPEN"
      },
      "channel_ids": ["web", "app"],
      "fulfillment_ids": ["delivery", "pickup"],
      "labels": [],
      "tags": {},
      "cms_template_id": null,
      "cms": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}

Devuelve las tiendas del comercio autenticado. Úsalo para mapear tiendas de Fire spark a ubicaciones de POS o RMS antes de sincronizar menús.

Requiere un access token con el scope stores:read. Ver Token para obtenerlo.

Solicitud

curl "https://firespark.cloud/api/integrations/v1/stores?brand_id=0001&limit=20" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Parámetros de query

Parámetro	Tipo	Default	Descripción
`brand_id`	string	—	Filtra por marca. Identificador externo — alfanumérico, `_` y `-`. 1–64 caracteres. Si se omite, se devuelven todas las tiendas del comercio.
`channel_id`	string	—	Solo devuelve tiendas que tengan este canal activo en `channel_ids`.
`fulfillment_id`	string	—	Solo devuelve tiendas que tengan este fulfillment activo en `fulfillment_ids`.
`limit`	integer	`20`	Máximo de tiendas por página. Mínimo `1`, máximo `100`.
`cursor`	string	—	Cursor de `pagination.next_cursor` de una respuesta anterior. Omítelo en la primera página.

Respuesta

La respuesta envuelve una página de tiendas en data y paginación en pagination. Cada tienda incluye contacto, ubicación, disponibilidad, canales y fulfillments activos, zonas de cobertura y metadatos de plantilla CMS.

{
  "data": [
    {
      "id": "pos-location-01",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
      "brand_id": "0001",
      "name": "Main Street",
      "status": "ACTIVE",
      "timezone": "America/Guayaquil",
      "contact": {
        "email": "main@merchant.com",
        "phone": "+593991234567",
        "name": "Main Street"
      },
      "location": {
        "latitude": -2.1894,
        "longitude": -79.8891,
        "address_line_1": "Calle Principal 456",
        "city": "Guayaquil",
        "country": "Ecuador",
        "postal_code": "090101",
        "business_name": "Main Street Restaurant"
      },
      "instructions": null,
      "coverage_zones": [],
      "availability": {
        "schedules": null,
        "temporary_closed_reason": null,
        "temporary_closed_until": null,
        "status": "OPEN"
      },
      "channel_ids": ["web", "app"],
      "fulfillment_ids": ["delivery", "pickup"],
      "labels": [],
      "tags": {},
      "cms_template_id": null,
      "cms": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}