---
title: Branding
description: Personalize o portal do cliente, o console administrativo e os e-mails com sua marca, logotipo, cores e moeda.
url: https://nexcmp.com/pt/docs/customers/branding/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Branding {#branding}

> **Onde encontrar no admin:** System › Settings › Brand (`/settings/branding`). Relacionado: System › Settings › General (`/settings`) para URLs e dados do vendedor nas faturas.

## O que faz {#what-it-does}

O NexCMP é white-label: o produto não traz nome de fornecedor e tudo o que seus clientes veem é a **sua** marca. As configurações de marca se aplicam às páginas de login e cadastro, ao portal, ao console de administração e aos e-mails.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Função | Um administrador. |
| Arquivos | Logotipos: SVG, PNG, JPEG, WEBP ou ICO, **até 512 KB cada**. |
| Dependências | Nenhum. |

## Etapas {#steps}

1. Abra **System › Settings › Brand**.
2. No cartão **Identity**, preencha:

   | Campo | Notas |
   |---|---|
   | **Brand name** (obrigatório) | Até 60 caracteres. Exibido no portal, em e-mails, faturas e páginas legais. |
   | **Nome do vendedor nas faturas** | Até 120 caracteres. Vazio significa o nome da marca. |
   | **Brand color** | Uma cor `#rrggbb`; o pequeno botão ao lado do campo a redefine para a cor integrada. |
   | **Site currency** | **USD**: os preços e saldos são exibidos apenas em USD, sem alternância de moeda. **VND**: também exibe o valor convertido à taxa de câmbio armazenada (consulte [Currency and exchange rates](https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates/)). |

3. Clique em **Save**.
4. No cartão **Logo & favicon**, faça o upload das três imagens — **Logo (light background)**, **Logo (dark background)** e **Favicon** — usando **Upload** (ou **Replace**); **Remove** exclui uma delas.

![Página de marca com os campos de identidade e as três imagens carregadas](https://nexcmp.com/pt/docs/images/customers/branding-01-brand.webp)

### Configurações relacionadas em General {#related-settings-in-general}

**System › Settings › General** possui duas abas que completam o cenário:

| Aba | Campos |
|---|---|
| **Branding & URLs** | Nome da marca (e-mail, faturas), idioma padrão (inglês ou vietnamita), **Customer app URL**, **Console URL**, **Admin URL** (link de representação do revendedor) e **Partner console URL** (links de convite, e-mails do revendedor). O assistente de configuração preenche estes campos com `https://<domain>`, `https://<domain>/admin` e `https://<domain>/console`. |
| **Seller & invoicing** | Nome da entidade jurídica, CNPJ/ID fiscal, endereço, e-mail de contato e o prefixo do número da fatura. Consulte [Invoices and ledger](https://nexcmp.com/pt/docs/billing/invoices-and-ledger/). |

O **From name** dos e-mails é definido em **System › Settings › Email** ([SMTP and e-mails](https://nexcmp.com/pt/docs/administration/smtp-and-emails/)).

## Os arquivos enviados são verificados {#uploaded-files-are-checked}

- As imagens rasterizadas são reconhecidas pelo conteúdo (e não pelo nome do arquivo) e medidas.
- **Os arquivos SVG são reconstruídos** a partir de uma lista segura de formas. Um arquivo contendo scripts, `foreignObject`, atributos de evento, links externos, `url(...)` apontando para fora, um DOCTYPE ou entidades é **recusado** (`svg_unsafe`).
- Um arquivo muito grande é recusado com `asset_too_large`, um tipo incorreto com `asset_type` e dimensões incorretas com `asset_dimensions`.
- Os arquivos são servidos a partir do seu próprio domínio com cabeçalhos rígidos de segurança.

## Verificar {#verify}

1. Abra a página de login do portal em uma janela anônima: o logotipo, o nome e a cor são exibidos.
2. Verifique a aba do navegador para o favicon (os navegadores armazenam favicons em cache; recarregue com o cache limpo se ainda vir o antigo).
3. Dispare um e-mail de teste (por exemplo, **Send reset link** para um cliente de teste) e verifique o nome da marca no assunto e no rodapé.

## Limites e notas {#limits-notes}

- O logotipo para o fundo escuro é usado quando o cliente ou administrador alterna para o tema escuro.
- Os revendedores têm sua própria marca; eles podem enviar PNG, JPEG, WEBP ou ICO de até 256 KB (sem SVG). Consulte [Resellers](https://nexcmp.com/pt/docs/customers/resellers/).
- Uma alteração na cor da marca ou no logotipo aparece no próximo carregamento de página; e-mails já enviados não são alterados.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| Upload recusado: `svg_unsafe` | O SVG contém scripts, links ou referências externas | Exporte um SVG simples (sem script, sem imagens externas) ou use PNG. |
| `asset_too_large` | Arquivo acima de 512 KB | Comprima ou redimensione a imagem. |
| `asset_type` | Não é SVG, PNG, JPEG, WEBP ou ICO | Converta o arquivo. |
| `invalid_argument: primary` | A cor não é `#rrggbb` | Use um valor hexadecimal de seis dígitos. |
| Logotipo antigo ainda visível | Cache do navegador | Recarregue forçadamente; os favicons podem demorar mais. |
| Preços exibidos apenas em USD | A moeda do site é USD | Mude para VND e certifique-se de que uma taxa de câmbio esteja armazenada. |