> ## 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.
# Configuração por loja
> Decida onde cada forma de pagamento realmente cobra, e carregue os dados que ela precisa — sem ir loja por loja.
A mesma forma de pagamento não é cobrada em todo lugar. Dinheiro funciona no balcão e não no app. O processador de cartão está nos quiosques mas não no delivery. Uma loja que acabou de abrir não tem seu código bancário carregado ainda.
Uma rede com 40 lojas, 3 canais e 3 fulfillments tem **360 combinações**. Segurar isso uma por uma não escala, e uma combinação que está errada não é um detalhe pequeno: é um cliente que chega na tela de pagamento e não consegue pagar.
Esta tela é o mapa de todas elas. Navegue até **Operação → Configuração por loja**.
***
## A versão curta
**1. Duas coisas vivem aqui, e não funcionam do mesmo jeito.** *Onde* uma forma cobra é decidido por loja, canal **e fulfillment**. *Quais dados* ela usa é carregado por conta, loja ou terminal — sem fulfillment envolvido.
**2. Pausar não é remover.** Uma forma pausada mantém sua configuração e pode voltar com um clique. Uma removida para de ser oferecida.
**3. O menu ⋮ em uma linha alcança o canal inteiro**, não só a linha que você está olhando. Para uma única linha, use as caixas de seleção.
***
## O caminho simples
Você tem uma forma nova e quer que ela cobre em uma loja:
1. Encontre a loja na lista — busque por nome ou código.
2. Marque a caixa de seleção na **linha da loja**: isso seleciona todas as suas combinações.
3. **Adicionar formas** na barra azul.
4. Marque a forma e confirme.
Se a forma não precisa de dados, já está cobrando. Se precisa, aparece em âmbar como **Falta configurar** e a próxima seção diz como preencher.
Se suas formas são só dinheiro e cartão no balcão sem credenciais, este é o manual inteiro. O resto é para formas que precisam de dados.
***
## A ideia para levar: disponibilidade e configuração são separadas
Esta é a única coisa que vale entender, porque todo o resto segue dela.
| | Disponibilidade | Configuração |
| -------------------- | ------------------------------ | ---------------------------------------------- |
| **O que responde** | Onde esta forma cobra? | Quais dados ela usa para cobrar? |
| **Dividida por** | Loja × canal × **fulfillment** | Conta / loja / **terminal** |
| **Onde você define** | Os chips e a barra em massa | O painel que abre quando você clica em um chip |
A consequência é o que surpreende as pessoas: carregar as credenciais do Datafast da linha **Quiosque · Dine-In** também deixa **Quiosque · Takeaway** pronto. É o mesmo pinpad cobrando — o fulfillment não muda a máquina. O próprio painel diz isso acima do formulário:
> *A disponibilidade é por fulfillment, mas esta configuração não: o que você salvar aqui vale para Quiosque em todos os fulfillments, não só em Dine-In.*
Então você pode habilitar a forma no dine-in e não no takeaway, e ainda inserir seus dados uma vez.
***
## Lendo os chips
Cada combinação mostra suas formas como chips. A cor é o status inteiro de relance.
| Chip | Significa | O que acontece quando alguém paga |
| ----------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Verde**, o nome da forma | Cobrando | É oferecida e funciona |
| **Cinza**, com ícone de pausa | **Pausado** — desligado de propósito | **Não** é oferecida como pagável, mas o dispositivo ainda sabe que ela existe. Sua configuração está intacta |
| **Âmbar**, com ícone de aviso | **Falta configurar** — um campo obrigatório está faltando | Ainda é oferecida. A cobrança falha contra o provedor em vez da forma desaparecer |
| *Não mostrado* | Não oferecida ali | O dispositivo nem sabe sobre ela |
**Âmbar não para a cobrança.** *Falta configurar* é um aviso nesta tela, não um bloqueio. A forma chega ao dispositivo com dados incompletos e falha no balcão, na frente de um cliente. É o estado que você deveria estar caçando ativamente, não o que pode deixar para depois.
Um chip para uma forma com campos por terminal também mostra quantos dispositivos estão prontos: **2/3 terminais**. Um faltando significa um quiosque que não vai cobrar enquanto os outros dois fazem.
### A saúde da linha
Acima dos chips, cada linha carrega uma pílula resumindo — e é a mesma coisa que o filtro **Disponibilidade** busca:
* **Pronto para cobrar** — cada forma está bem.
* **Falta configurar** — pelo menos uma está faltando dados.
* **Sem formas de pagamento** — nada oferecido aqui. Ninguém pode pagar.
Uma linha onde **tudo está pausado** mostra como *Pronto para cobrar*: nada está faltando dados. É tecnicamente verdade e operacionalmente enganador — se uma loja não está cobrando e você não consegue descobrir por quê, olhe a cor dos chips, não a pílula.
***
## Carregando os dados de uma forma
Clique em um chip e o painel abre com os campos que a forma declarou, agrupados pelo nível em que cada um é preenchido.
| Seção | O que pede | Alcança |
| ---------------------------- | ----------------------------------------------------- | ---------------------------------- |
| **Configuração da conta** | Compartilhado por toda a conta | Cada loja, cada canal |
| **Configuração da loja** | Compartilhado por cada canal e fulfillment desta loja | Aquela loja |
| **Configuração do terminal** | Uma linha por terminal neste canal | Cada dispositivo por conta própria |
Campos obrigatórios carregam um asterisco e, ao lado de cada seção, uma marca diz se está completa: um check verde, ou um triângulo âmbar quando algo está faltando. Campos declarados como **Secreto** são digitados escondidos, do jeito que um campo de senha funciona.
**Salvar alterações** salva. Você pode salvar incompleto — a combinação fica em *Falta configurar* e nada te impede.
**Salvo não é o mesmo que sincronizado.** Se um quiosque estava offline, em vez da confirmação você recebe *"Salvo, mas estes quiosques não receberam a alteração: … Tente novamente em Terminais."* O Fire manteve sua mudança; aquele dispositivo não. Ele continua cobrando com a configuração anterior até que alguém pressione **Tentar novamente** no seu cartão em [Terminais](/pt/manuals/backoffice/terminals). Este aviso não é uma mensagem de erro que você pode dispensar.
O rodapé do painel também tem **Abrir a forma de pagamento**, que leva você ao [editor da forma](/pt/manuals/payments/payment-methods) — útil quando você nota no meio do carregamento que um campo está declarado no nível errado.
***
## Trabalhando em massa
Ninguém configura 360 combinações uma de cada vez. Há quatro maneiras de dizer *quais* você quer dizer:
| Como | O que seleciona |
| ----------------------------------------- | ------------------------------------ |
| Caixa de seleção em uma **linha filha** | Só aquela combinação |
| Caixa de seleção em uma **linha de loja** | Cada combinação naquela loja |
| Caixa de seleção no **cabeçalho** | Cada resultado filtrado |
| O menu **⋮** em uma linha | **O canal inteiro** para aquela loja |
Com algo selecionado, a barra azul oferece **Adicionar formas**, **Retomar**, **Pausar** e **Remover formas**.
**O menu ⋮ alcança mais linhas do que aquela em que você está.** Usá-lo em *Quiosque · Dine-In* aplica a **cada fulfillment de Quiosque** naquela loja. É proposital — os dados do pinpad não dependem de se a ordem é comida no local ou levada — mas significa que você desliga mais do que pode ver. Quando quer exatamente uma linha, use sua caixa de seleção.
### Cada ação só oferece o que pode agir
O diálogo não lista seu catálogo inteiro: lista as formas que a ação pode realmente mudar no que você selecionou.
| Ação | Lista | Se estiver vazia diz |
| -------------------- | ---------------------------------------------------------------------- | -------------------------------------- |
| **Adicionar formas** | O que ainda não está habilitado em *todas* as combinações selecionadas | *Aqui já se oferecem todas as formas.* |
| **Pausar** | O que está atualmente cobrando | *Aqui não há formas cobrando.* |
| **Retomar** | O que está pausado | *Aqui não há formas pausadas.* |
| **Remover formas** | Tudo que existe ali | *Aqui não se oferece nenhuma forma.* |
Um diálogo vazio é informação: está dizendo que não há nada para fazer, não que algo falhou.
### Pausar ou remover
Ambos param a cobrança. Não são a mesma coisa.
**Pausar** é a para um provedor que caiu. A combinação fica no mapa em cinza, o dispositivo ainda sabe que a forma existe — só não pode ser usada hoje — e **Retomar** traz de volta com tudo que tinha.
**Remover** tira a forma daquela combinação. A configuração que você carregou no nível de conta, loja e terminal sobrevive, mas a combinação em si se foi: para trazer de volta você usa **Adicionar formas** e verifica que não ficou em âmbar.
***
## Receitas: como lidar com casos do mundo real
1. Busque a loja por nome ou código.
2. Marque a caixa de seleção na **linha da loja** — isso pega todas as suas combinações.
3. **Adicionar formas** → marque a forma → confirme.
4. Olhe o chip que aparece. Verde significa pronto; âmbar significa que precisa de dados.
Se saiu âmbar, clique no chip e preencha o que está marcado com asterisco.
1. Filtre **Forma de pagamento** pela afetada.
2. Marque a caixa de seleção do cabeçalho: isso seleciona cada resultado filtrado.
3. **Pausar** → confirme.
Cada combinação fica cinza e mantém suas credenciais. Quando o provedor voltar: mesma seleção, **Retomar**.
Se o provedor está fora em todo lugar e para todo mundo, é mais rápido desmarcar **Ativo** na [própria forma](/pt/manuals/payments/payment-methods): pausa tudo de uma vez e reativar traz de volta exatamente o que desligou.
1. Encontre a linha da loja para o canal **Quiosque**.
2. Clique no chip do processador.
3. Vá para **Configuração do terminal**: há uma linha por quiosque naquele canal.
4. Preencha o valor para o novo dispositivo e **Salvar alterações**.
Você não precisa repetir para cada fulfillment: o que você salva aplica-se ao canal inteiro.
Você também pode fazer isso do próprio cartão do quiosque em [Terminais](/pt/manuals/backoffice/terminals), sob **Valores deste terminal**. Mesmo valor, duas portas.
Este é o caso onde o menu ⋮ é a ferramenta errada, porque pegaria o canal inteiro.
1. Filtre **Fulfillment** por *Delivery*.
2. Marque as caixas de seleção nas linhas que você quer — ou a do cabeçalho, se for cada loja.
3. **Remover formas** → marque a forma → confirme.
Linhas de dine-in não são tocadas: não foram selecionadas.
1. Filtre **Disponibilidade** por **Falta configurar**.
2. O que sobra é cada combinação que está oferecendo uma forma que não pode completar.
3. Trabalhe nelas clicando nos chips âmbar.
Vale fazer depois de abrir lojas ou adicionar campos a uma forma: são os dois momentos que geram âmbar em massa.
Ainda não há copiar-de-outra-loja, então o caminho mais rápido é:
1. Busque a nova loja e expanda.
2. Marque a caixa de seleção na **linha da loja**.
3. **Adicionar formas** → marque cada forma que deve aceitar → confirme.
4. Clique em cada chip âmbar e preencha a seção **Configuração da loja**. Valores de nível de conta já estão lá — são compartilhados.
Você só carrega o que é genuinamente por loja. É exatamente para isso que os níveis servem.
***
## Uma loja, seguida de ponta a ponta
*Laboratorio Ecuador*, canal Quiosque, dois fulfillments, três formas:
| Combinação | Datáfono Medianet | Datafast | DeUna |
| ------------------- | ----------------- | ------------------------- | --------- |
| Quiosque · Dine-In | 🟢 cobrando | 🟠 faltando `merchant_id` | ⚪ pausado |
| Quiosque · Takeaway | 🟢 cobrando | 🟠 faltando `merchant_id` | ⚪ pausado |
Saúde da linha para ambas: **Falta configurar**.
Alguém clica no chip Datafast, preenche `merchant_id` sob **Configuração da conta** e salva. O que acontece:
* **Ambas as linhas ficam verdes de uma vez.** O campo era de nível de conta: um valor, e cada loja, canal e fulfillment oferecendo Datafast está corrigido com ele.
* **DeUna fica cinza.** Ninguém pediu para voltar — pausar foi uma decisão, e nada desfaz decisões por conta própria.
* Se o campo faltando fosse `store_code` (nível de loja), a correção teria alcançado as duas linhas daquela loja e nenhuma outra. Se fosse `pinpad_ip` (nível de terminal), teria consertado um quiosque.
**O nível do campo que está faltando é o que diz quanto vale uma única correção.**
***
## Erros que custam dinheiro
**Usar Remover quando quis dizer Pausar.** Remover tira a combinação do mapa; o dispositivo para de saber que a forma existe. Trazer de volta significa adicionar de novo e verificar que não volta âmbar. Para uma interrupção temporária, **Pausar**.
**Agir através do menu ⋮ pensando que é uma linha.** Alcança o canal inteiro para aquela loja. Se você só quis dizer *Dine-In*, também desligou *Takeaway*, *Delivery*, e todo o resto que aquele canal tem.
**Deixar um chip âmbar para depois.** *Falta configurar* não para a cobrança: deixa passar e falha no balcão. É o único estado onde o cliente descobre antes de você.
**Ler "Salvo, mas estes quiosques não receberam a alteração" como uma confirmação.** É amarelo por uma razão. Aqueles dispositivos continuam cobrando com a configuração anterior até que alguém pressione **Tentar novamente** no terminal.
**Confiar na pílula verde em uma linha onde tudo está pausado.** *Pronto para cobrar* significa "nada está faltando dados", não "dinheiro está entrando". Uma linha com cada forma cinza não está cobrando nada.
***
## Glossário
| Termo | O que significa |
| ---------------------- | --------------------------------------------------------------------------------- |
| **Combinação** | Uma loja + um canal + um fulfillment. Cada uma é uma linha. |
| **Disponibilidade** | Se uma forma é oferecida em uma combinação. |
| **Configuração** | Os valores que uma forma usa para cobrar. Carregados por conta, loja ou terminal. |
| **Pausado** | Oferecida mas desligada de propósito. Mantém sua configuração. |
| **Falta configurar** | Oferecida mas faltando um campo obrigatório. Não para a cobrança. |
| **Pronto para cobrar** | A linha não tem formas faltando dados. |
| **Escopo** | O conjunto de combinações a que uma ação em massa se aplica. |
***
## Perguntas frequentes
Porque a ação não pode fazer nada com ela ali. **Pausar** só lista o que está cobrando, **Retomar** só o que está pausado, **Adicionar formas** só o que não está ainda em *todas* as combinações selecionadas. Um diálogo vazio significa que não há nada para fazer.
Não. Configuração não é por fulfillment. O que você salva aplica-se àquele canal em cada um de seus fulfillments — e se o campo é de nível de conta, a cada loja também.
Três causas usuais: nenhum vendor selecionado no cabeçalho (sem vendor não há canais, e sem canais não há linhas), um filtro ativo — verifique **Disponibilidade** e **Forma de pagamento** — ou a conta genuinamente não tem formas ativas, caso em que há um banner âmbar no topo dizendo isso.
Escopo. Pausar aqui afeta as combinações que você selecionou. Desativar a forma em [Formas de pagamento](/pt/manuals/payments/payment-methods) afeta cada loja de uma vez — e reativar restaura apenas o que a desativação desligou, deixando qualquer coisa pausada manualmente como estava.
Sim, e esse é o ponto do aviso. Viaja com dados incompletos. O que quebra é a cobrança contra o provedor, não a exibição da forma.
Ainda não. Hoje esta tela sincroniza para **quiosques**. O POS ainda recebe suas formas de pagamento através de seu próprio snapshot.
***
## O que vem por aí
Coisas que esta tela **não** faz hoje:
* **Não copia configuração de uma loja para outra.** Uma nova loja é configurada selecionando-a e adicionando as formas.
* **Não te impede de salvar uma configuração incompleta.** *Falta configurar* é um aviso, nunca um bloqueio.
* **Não mascara segredos armazenados.** Um campo marcado como *Secreto* é digitado escondido; trate o que você coloca ali de acordo.
* **Não sincroniza para o POS**, só para quiosques.
* **Não pagina.** Cada combinação é renderizada em uma tabela; recolher por loja é a válvula de alívio.
* **Não busca por canal ou forma**, só por nome ou código de loja. Para isso, use os filtros.