> ## 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. # Políticas de menu > Exija que todo produto tenha seus códigos, para que os pedidos parem de chegar ao X-MART com linhas que ninguém consegue identificar. Um produto viaja para o X-MART com o seu **External ID**, e esse é o código com o qual os pedidos dele voltam identificados. Um produto que não o tem continua vendendo — e os pedidos dele chegam sem esse código, então ninguém mais adiante consegue associar a linha a nada. Isso só é descoberto semanas depois, quando alguém concilia e os números não fecham. Esta tela existe para que a conta possa dizer **"nenhum produto deste tipo entra no ar sem o seu código"**, e o Fire faz isso valer nos momentos em que consegue. Vá em **Restaurant OS → Settings → Menu policies**. ![Tela Menu policies com a matriz Required codes: tipos de produto por External ID e Code](https://mintcdn.com/firepos/ehR-GmCF-ETSjLOC/images/manuals/backoffice/menu-policies/01-configuracion.png?fit=max\&auto=format\&n=ehR-GmCF-ETSjLOC\&q=85\&s=478b7a88f57a660000470f0167cfda95) *** ## O mínimo que você precisa saber > [!NOTE] > > **1. Ela vem desligada.** Enquanto ninguém a configurar, nada muda: nenhum produto é obrigado a ter algum código e nenhum é sinalizado. > > **2. É uma matriz, e é por vendor.** As linhas são os tipos de produto — **Product**, **Combo**, **Modifier**, **Packaging** — e as colunas são os dois códigos, **External ID** e **Code**. Cada célula é um interruptor: ligado, o código é obrigatório para esse tipo; desligado, não é. > > **3. Ela bloqueia o que é novo e sinaliza o que já existe.** Criar um produto ou salvar a ficha dele sem um código obrigatório é recusado. Os produtos que já não têm o código **não** são bloqueados: continuam vendendo e publicando, e recebem um chip **Missing code** para que você os corrija. *** ## A tela No alto, ao lado do título, o selo **Vendor** diz qual vendor você está configurando — aqui, *Sandbox Brasil*. É o vendor escolhido no seletor do alto do backoffice, e a política pertence somente a esse vendor. A descrição diz *"Quais códigos os produtos deste vendor devem ter para poder salvá-los."* À direita, **Help** abre um painel lateral que explica a tela, e **See products that do not comply** abre a lista de produtos já filtrada. Esse botão só aparece quando a política que você **salvou** exige algum código. O cartão **Required codes** contém a matriz. A nota dele diz: *"A regra é aplicada conforme o tipo do produto. Uma opção de uma pergunta criada como Produto segue a linha Produto."* | Coluna | O que é | | - | - | | **External ID** — *Chega nos pedidos* | O código com o qual o produto viaja para o X-MART e com o qual os pedidos voltam identificados | | **Code** — *É impresso no ticket* | O código operacional do ponto de venda (PLU). É o que se imprime | Você muda os interruptores e depois confirma com **Save changes**. **Discard** descarta o que você mudou. Ao salvar, o Fire confirma com uma mensagem genérica; se não conseguir, mostra a mensagem do servidor tal como vem, em inglês. > [!NOTE] > > Para ver **Menu policies**, o seu perfil precisa ter acesso a ela — se o perfil está configurado com submenus explícitos, um administrador precisa concedê-lo. Sem isso, o item não aparece no menu e abrir o endereço leva você a *acesso negado*. Para **salvar**, o acesso não basta: você também precisa de permissão sobre o **vendor inteiro**. Quem está limitado a uma loja pode ler a política, mas não pode alterá-la. > [!WARNING] > > **Mudar a política não muda nada nos produtos.** Ela não preenche códigos nem tira nenhum produto de venda. Só muda o que o Fire bloqueia daqui em diante e quais produtos mostram **Missing code**. *** ## O caminho simples Quase toda conta precisa de uma coluna: **External ID**, para os tipos que vende. 1. Abra **Restaurant OS → Settings → Menu policies** e confira o selo **Vendor**. 2. Na coluna **External ID**, ligue **Product**. Faça o mesmo com **Combo** e **Modifier** se eles também viajam nos pedidos. 3. Toque em **Save changes**. 4. Toque em **See products that do not comply** e percorra a lista. > [!TIP] > > Se o seu único objetivo é que nenhum produto chegue ao X-MART sem o seu identificador, isso é tudo o que você precisa. **Code** é outra questão — veja abaixo. *** ## Os dois códigos não são a mesma coisa | | **External ID** | **Code** | | - | - | - | | Para que serve | É o código com o qual o produto **viaja para o X-MART**, e com o qual os pedidos voltam identificados | O código operacional do ponto de venda (PLU). **É o que o ticket imprime** | | O que acontece se faltar | Os pedidos chegam sem esse código | O ticket imprime o External ID no lugar dele, se o produto tiver um | | Onde você o digita | Aba **General** do produto | Aba **General** do produto. No diálogo **Add option** de um grupo de modificadores ele se chama **PLU** | > [!WARNING] > > **Na planilha, a coluna código é o External ID, e a coluna plu é o Code.** Na ficha do produto os nomes são **External ID** e **Code**. É uma confusão real: veja [Importar e exportar](https://docs.fire.rest/pt/manuals/backoffice/data-transfers.md). *** ## O que a política faz e o que não faz ### Qual campo recebe o asterisco Sem política, **External ID** e **Code** não levam asterisco. Com uma, um campo só recebe o asterisco se o vendor exige esse código **para esse tipo de produto**. Na captura da [ficha do produto](https://docs.fire.rest/pt/manuals/backoffice/products.md#códigos-e-a-política-de-menu), um *Product* mostra os dois asteriscos porque, nesse ambiente, a política exige os dois códigos para **Product**. Com um **Fulfillment type** escolhido na ficha, os códigos são herdados e ficam bloqueados, então não mostram asterisco. ### O que ela bloqueia O Fire recusa nestes casos, e somente quando o tipo do produto exige um código que ele não tem: | Quando | O que acontece | | - | - | | **Criar um produto** | O produto não é criado até que tenha os códigos que o seu tipo exige. | | **Criar uma opção** com **Add option** em um grupo de modificadores | O mesmo: a opção é um produto novo, nasce como **Product** e segue a linha **Product**. | | **Salvar a aba General** | O salvamento é recusado. O erro aparece no campo vazio. | | **Salvar a ficha com uma mudança de tipo pendente** | A exigência do tipo **novo** é conferida no próximo salvamento, **em qualquer aba**: até Pricing ou Categories podem ser recusadas até que o código seja preenchido. | Um código que só tem espaços conta como vazio. Fora isso, as abas — preços, categorias, imagens, grupos de modificadores, sugestões e disponibilidade — salvam normalmente, com ou sem o código do produto. Preços, categorias e menus não esperam pelo código. Tocar nas pílulas **Modifier / Product / Combo** da ficha não dispara nada: só muda a tela e marca a ficha como **Unsaved**. Os asteriscos passam a ser os do tipo novo na hora, mas a conferência acontece quando você salva. **Packaging** não tem pílulas (o tipo dele não pode ser mudado), mas a linha dele vale ao criar e ao salvar **General**. **Como você vê:** * **Salvar General** marca o campo vazio em vermelho com *Obrigatório pela política de menu do vendor*, e também aparece uma mensagem com o mesmo motivo. ![Aba General com o campo Code em vermelho e o texto Obrigatório pela política de menu do vendor abaixo dele](https://mintcdn.com/firepos/vPicrHYYrfN_FcFY/images/manuals/backoffice/products/politica-general-error.png?fit=max\&auto=format\&n=vPicrHYYrfN_FcFY\&q=85\&s=8c04b12f73891a2b0050b9e00de4b282) * **Criar um produto** marca cada campo que falta da mesma forma. * **Add option** marca os campos dentro do diálogo — sem mensagem fora dele — e mantém você na aba **General** do diálogo. * **Salvar outra aba** com uma mudança de tipo pendente mostra a mensagem *"A política de menu do vendor exige {fields} para {type}."*, com a dica *"Preencha na aba Geral."* e um botão **Go to General**. ### O que ela só sinaliza Os produtos que **já existiam** sem o código não são bloqueados. Continuam vendendo e publicando, e a sincronização dos menus não olha para a política. Eles são marcados em dois lugares: * **Na lista de produtos**, um chip **Missing code** ao lado do nome. Passe o mouse e o tooltip diz o que falta: *Falta: Código*, *Falta: ID externo* ou *Falta: ID externo e Código*. A lista também ganha um filtro, **Any code status**, com uma única opção, **Missing code**. Ele só aparece quando a política exige algo, e **Clear filters** aparece enquanto houver algum filtro ativo. * **Na ficha do produto**, um aviso acima das abas, visível em **todas** elas: *"Este produto não tem {fields}. A política do vendor o exige para {type}; os pedidos que o incluírem chegam sem esse código."* Ele se baseia nos dados **salvos**: fica enquanto você digita e some quando você salva. Não aparece ao criar. Com uma mudança de tipo pendente, já usa o tipo novo. ![Lista de produtos filtrada por Missing code, com o chip ao lado de cada nome](https://mintcdn.com/firepos/vPicrHYYrfN_FcFY/images/manuals/backoffice/products/politica-listado.png?fit=max\&auto=format\&n=vPicrHYYrfN_FcFY\&q=85\&s=098fe256a925e12bd28ba0ff19a7afab) ![Ficha do produto com o aviso de que o produto não tem Code, acima das abas](https://mintcdn.com/firepos/vPicrHYYrfN_FcFY/images/manuals/backoffice/products/politica-aviso-ficha.png?fit=max\&auto=format\&n=vPicrHYYrfN_FcFY\&q=85\&s=6db7877661419abd925d4fa3ac1b7c7c) > [!NOTE] > > **Por que ela não bloqueia os antigos.** Ligar a política não pode tirar produtos de venda: um restaurante em plena operação perderia pratos. O custo de deixar assim é real, porém — os pedidos desses produtos continuam chegando sem código até alguém corrigi-los. O chip e o aviso são o que mantém isso visível. ### O que ela não cobre * **Grupos de modificadores.** Um grupo é criado sem código e está tudo bem: ele não tem linha na matriz. A política cobre as **opções** (que são produtos), não o grupo. * **Atribuir um produto existente como opção.** Com **Search and assign product** nada é validado, então um produto que não cumpre é atribuído sem aviso. A regra vale quando um produto é escrito, não quando é atribuído. * **Restaurar um backup.** Ele não omite nada: veja [Importar e exportar](https://docs.fire.rest/pt/manuals/backoffice/data-transfers.md). *** ## Receitas: como se resolvem os casos reais > [accordion] Os pedidos estão chegando ao X-MART com linhas sem código > > 1. Abra **Menu policies** e ligue **External ID** para **Product** (e **Combo** ou **Modifier** se eles também aparecem nos pedidos). > 2. Toque em **Save changes**. > 3. Toque em **See products that do not comply**. > 4. Abra cada produto e preencha o **External ID** em **General**. > 5. Salve e sincronize os menus que os contêm em [Atribuição de menus](https://docs.fire.rest/pt/manuals/backoffice/menu-assignments.md). > > Até você corrigir um produto, os pedidos dele continuam chegando sem código. > [accordion] Não consigo criar ou salvar um produto: 'Obrigatório pela política de menu do vendor' > > A sua conta exige um código para esse tipo e o campo está vazio. Preencha o campo marcado em vermelho e salve de novo. Se você digitou só espaços, conta como vazio. > [accordion] Não consigo salvar Pricing, Categories ou outra aba > > Confira se você tocou nas pílulas **Modifier / Product / Combo** sem salvar. A ficha ainda carrega essa mudança de tipo e a política do tipo novo é conferida a cada salvamento. Preencha o código em **General** — o botão **Go to General** leva você até lá — ou desfaça a mudança de tipo. > [accordion] Um produto mostra Missing code mas está vendendo normal > > É o esperado. A política não bloqueia produtos que já existiam. O chip avisa que os pedidos dele chegam sem esse código: preencha-o e o chip some. > [accordion] Preciso do PLU em todo ticket > > Ligue **Code** para os tipos que imprimem. **Code** é o que o ticket imprime, então exija-o só onde um ticket precisa dele. > [accordion] Encontrar todos os produtos que preciso corrigir > > Na lista de produtos, abra o filtro **Any code status** e escolha **Missing code**. Ou toque em **See products that do not comply** em **Menu policies**: ele abre a lista já filtrada. *** ## Casos, de ponta a ponta Com **External ID** ligado para **Product** e **Code** desligado: | O que você faz | Resultado | | - | - | | Criar um **Product** sem External ID | Recusado: *Obrigatório pela política de menu do vendor* | | Criar um **Product** com External ID e sem Code | Criado | | Editar o preço de um produto existente sem External ID | Salvo: a aba **Pricing** não é validada. O produto continua mostrando **Missing code** | | Salvar a aba **General** desse mesmo produto sem tocar no External ID | Recusado: a política vale para essa aba | | Tocar na pílula **Product** de um **Modifier** sem External ID e depois salvar qualquer aba | Recusado nesse salvamento, porque o tipo novo o exige | | Criar um **Combo** sem External ID | Criado: **External ID** não está ligado para **Combo** | *** ## Erros que saem caros > [!WARNING] > > **Supor que um produto sem o seu código parou de vender.** Ele continua vendendo. O risco é o contrário: os pedidos chegam sem código e nada os detém. Confira a lista depois de ligar a política. > [!WARNING] > > **Exigir Code quando você queria External ID.** **Code** é o que o ticket imprime. Se o objetivo é que o X-MART receba a linha identificada, a coluna é **External ID**. > [!WARNING] > > **Configurar a política no vendor errado.** A matriz é por vendor: confira o selo **Vendor** antes de tocar em **Save changes**. > [!WARNING] > > **Importar uma planilha e supor que ela corrige os códigos.** Com a política ligada, as linhas que criam um produto sem o código, ou o esvaziam, são deixadas de fora. Veja [Importar e exportar](https://docs.fire.rest/pt/manuals/backoffice/data-transfers.md). *** ## Glossário | Termo | O que significa | | - | - | | **Menu policy** | A matriz, por vendor, de quais códigos cada tipo de produto exige | | **External ID** | O código com o qual o produto viaja para o X-MART e com o qual os pedidos voltam identificados | | **Code** | O código operacional do ponto de venda (PLU). É o que o ticket imprime | | **Missing code** (na interface em português: *Falta código*) | Chip num produto que não tem um código que o seu tipo exige | | **Any code status** (na interface em português: *Qualquer código*) | Filtro da lista de produtos; a opção **Missing code** mostra só os produtos que não têm um código exigido | | **Vendor** | A marca ou o negócio dentro da conta | *** ## Perguntas frequentes > [accordion] A política vem ligada por padrão? > > Não. Ela vem desligada: nada é exigido e nada é sinalizado até que alguém a configure. Um vendor com todos os interruptores desligados é o mesmo que um vendor nunca configurado. > [accordion] Ela vale para produtos que já existem? > > Ela não os bloqueia, mas os sinaliza. Eles continuam vendendo e publicando, com um chip **Missing code** na lista e um aviso na ficha. Só são recusados quando alguém salva a aba **General** deles ou, com uma mudança de tipo pendente, qualquer aba. > [accordion] Ela vale também para o ID do grupo de modificadores? > > Não. Um grupo é criado sem código e não está na matriz. A política vale para os produtos por trás das opções dele. > [accordion] Ela vale se eu carrego produtos por planilha? > > Sim, para as linhas que criam um produto ou esvaziam um código que ele tinha: são deixadas de fora com uma observação. Restaurar um backup não omite nada, só avisa. Veja [Importar e exportar](https://docs.fire.rest/pt/manuals/backoffice/data-transfers.md). > [accordion] Por que não vejo Menu policies? > > O seu perfil não tem acesso a ela. Se ele está configurado com submenus explícitos, um administrador precisa concedê-lo. Abrir o endereço diretamente leva você a *acesso negado*. > [accordion] Por que eu vejo a tela mas não consigo salvar? > > Salvar exige permissão sobre o vendor inteiro, não só acesso à tela. Se você administra apenas algumas lojas, peça a alguém com permissão sobre o vendor inteiro. > [accordion] Por que não vejo o filtro Any code status? > > Ele só aparece quando a política exige algum código. Com tudo desligado não há o que filtrar. *** ## Se você administra várias contas A mesma configuração também está disponível na administração: **Super Admin → System Administration → Accounts →** o detalhe da conta **→** aba **Menu policies**. É a mesma matriz, mas mostra **todos os países e vendors da conta de uma vez**: um cartão por país e, dentro dele, cada vendor com os seus próprios **Required codes**. Um único **Save changes** salva todos, e **Cancel** descarta o que você mudou. A descrição da aba diz *"Quais códigos do produto são obrigatórios, por vendor e tipo de produto."* Diferente do Restaurant OS, ela não depende do acesso de menu do seu perfil: é para superadministradores da plataforma. ![Aba Menu policies no detalhe da conta do Super Admin, com o cartão Brasil e a matriz do vendor Sandbox Brasil](https://mintcdn.com/firepos/ehR-GmCF-ETSjLOC/images/manuals/backoffice/menu-policies/02-super-admin.png?fit=max\&auto=format\&n=ehR-GmCF-ETSjLOC\&q=85\&s=7fd2321655ec2ad7d4e5379e7a986993) *** ## O que ela não faz * Ela **não preenche códigos** nem tira produtos de venda: bloqueia o que é novo e sinaliza o que já existe. * Ela **não valida** as outras abas do produto enquanto o tipo não mudou: preços, categorias, imagens, grupos de modificadores, sugestões e disponibilidade salvam normalmente. * Ela **não exige código no próprio grupo de modificadores** e **não confere** um produto que você atribui a um grupo como opção. * Ela **não omite nada** ao restaurar um backup: só avisa. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.