Saltar para o conteúdo principal
stores.sync é a contraparte em lote de store.updated. O Fire o emite quando várias lojas precisam ser propagadas em massa — por exemplo, durante o onboarding inicial ou uma mudança massiva de configuração. O Fire divide automaticamente os lotes grandes e emite vários eventos stores.sync com até 50 lojas cada. Seu sistema deve tratar cada evento de forma independente.

Payload

{
  "event": "stores.sync",
  "id": "evt_abc125",
  "createdAt": "2025-01-15T15:05:00Z",
  "data": {
    "account": "1",
    "country": "6",
    "batchIndex": 1,
    "batchTotal": 3,
    "stores": [
      {
        "name": "New store 805",
        "active": true,
        "storeId": 805,
        "vendorId": 16,
        "storeCode": "T005",
        "schedulesByChannel": [
          {
            "channelId": "0F049503-85CF-E511-80C6-000D3A3261F3",
            "schedules": [
              {
                "day": "FRIDAY",
                "endTime": "22:30",
                "startTime": "10:00"
              }
            ]
          }
        ],
        "taxesInfo": {
          "taxRate": 0,
          "vatRatePercentage": 12
        },
        "contactInfo": {
          "phone": "23955400",
          "address": "PICHINCHA / QUITO / INAQUITO / AV. AMERICA N37-288 Y VILLALENGUA"
        },
        "deliveryInfo": {
          "cookTime": "10",
          "deliveryId": 46356,
          "minimumOrder": "0.00",
          "shippingCost": 1.99
        },
        "locationInfo": {
          "city": "QUITO",
          "latitude": "-0.17250869436401206",
          "longitude": "-78.49125266075134"
        },
        "storeChannels": [
          "0F049503-85CF-E511-80C6-000D3A3261F3"
        ]
      }
    ],
    "channels": [
      {
        "active": true,
        "channel": "Llevar",
        "vendorId": 16,
        "channelId": "0E049503-85CF-E511-80C6-000D3A3261F3",
        "channelReferenceName": "Llevar PICKUP",
        "services": [
          {
            "code": "DELIVERY",
            "serviceId": "3",
            "referenceName": "Domicilios Llevar"
          },
          {
            "code": "TAKEAWAY",
            "serviceId": "1",
            "referenceName": "Retiro en tienda"
          }
        ]
      }
    ]
  }
}

Campos

data

CampoTipoDescrição
accountstringIdentificador da conta — exigido por sistemas downstream
countrystringIdentificador do país — exigido por sistemas downstream
batchIndexintegerPosição deste lote (1-based)
batchTotalintegerNúmero total de lotes nesta sincronização
storesobject[]Configurações de loja — mesma estrutura de store.updated
channelsobject[]Configurações de canal — mesma estrutura de store.updated

Processamento

Processe cada evento stores.sync de forma independente. Use batchIndex e batchTotal para acompanhar o progresso se seu sistema precisar saber quando uma sincronização completa termina.
Cada evento de lote é entregue e reenviado de forma independente. Se um lote falhar, somente esse lote é reenviado — não toda a sincronização.

Quando o Fire emite este evento?

  • Durante o onboarding inicial de um cliente
  • Após uma mudança massiva de configuração que afeta muitas lojas
  • Em solicitações explícitas de sincronização disparadas pelo dashboard do Fire
Para mudanças individuais de loja em operação normal, o Fire emite store.updated em vez disso.