> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# stores.sync

> Disparado quando o Fire precisa propagar um lote grande de configurações de loja de uma vez.

`stores.sync` é a contraparte em lote de [`store.updated`](/pt/webhook-reference/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

```json theme={null}
{
  "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`

| Campo        | Tipo      | Descrição                                                                                          |
| ------------ | --------- | -------------------------------------------------------------------------------------------------- |
| `account`    | string    | Identificador da conta — exigido por sistemas downstream                                           |
| `country`    | string    | Identificador do país — exigido por sistemas downstream                                            |
| `batchIndex` | integer   | Posição deste lote (1-based)                                                                       |
| `batchTotal` | integer   | Número total de lotes nesta sincronização                                                          |
| `stores`     | object\[] | Configurações de loja — mesma estrutura de [`store.updated`](/pt/webhook-reference/store-updated)  |
| `channels`   | object\[] | Configurações de canal — mesma estrutura de [`store.updated`](/pt/webhook-reference/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.

<Note>
  Cada evento de lote é entregue e reenviado de forma independente. Se um lote falhar, somente esse lote é reenviado — não toda a sincronização.
</Note>

## 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`](/pt/webhook-reference/store-updated) em vez disso.