{"section":"tutorials","requestedLocale":"pt","requestedSlug":"campos-contabeis","locale":"pt","slug":"campos-contabeis","path":"docs/pt/tutorials/b2b/b2b-buyer-portal/campos-contabeis.md","branch":"main","content":"Os **campos contábeis** permitem coletar informações adicionais das compras no [B2B Buyer Portal](https://help.vtex.com/pt/docs/tutorials/b2b-buyer-portal-pt), como centro de custo, número interno de pedido de compra (PO) e outros dados de controle. A plataforma associa essas informações ao pedido, ajudando a empresa a padronizar dados, aplicar regras internas e facilitar auditorias.\n\n> ⚠️ Esta funcionalidade está disponível apenas para lojas que usam [B2B Buyer Portal](https://help.vtex.com/pt/docs/tutorials/b2b-buyer-portal-pt), atualmente disponível para contas selecionadas.\n\n## Uso dos campos contábeis\n\nOs campos contábeis permitem que sua empresa:\n\n- Padronize informações de compra entre [unidades organizacionais](https://help.vtex.com/pt/docs/tutorials/unidades-organizacionais) e compradores.\n- Exija informações obrigatórias antes de finalizar o pedido.\n- Reduza erros de preenchimento durante o checkout.\n- Melhore a rastreabilidade, a auditoria e a conformidade.\n\n## Perfis\n\nOs campos contábeis envolvem dois perfis:\n\n- **Administrador**: cria os campos necessários para a empresa e define onde cada campo aparece no checkout.\n- **Comprador**: preenche os campos durante a compra.\n\n## Aplicação dos campos\n\nO administrador pode configurar cada campo para ser aplicado em um dos seguintes níveis:\n\n- **Pedido**: aplica-se à compra inteira.\n- **Item**: aplica-se a cada produto no carrinho.\n- **Endereço**: aplica-se às informações de entrega ou cobrança.\n\n## Tipos de campo\n\nO comportamento de preenchimento de um campo contábil depende de como o administrador cria o campo: pela Conta da Organização ou pela [Custom Fields API](https://developers.vtex.com/docs/api-reference/custom-fields-api).\n\n### Campos criados na Conta da Organização\n\nOs campos criados na interface da Conta da Organização são campos de lista por padrão. No checkout, o comprador seleciona um dos valores predefinidos, que o administrador gerencia na página de detalhes do campo.\n\nAo criar o campo, o administrador também pode marcar a opção **Habilitar campo de texto livre** para permitir que os compradores insiram um valor manualmente no checkout, além de selecionar um valor da lista.\n\n### Campos criados via API\n\nAo criar um campo contábil pela Custom Fields API, o administrador deve escolher um dos seguintes tipos:\n\n- **Texto (`text`):** Aceita qualquer sequência de caracteres, sem validação de formato. Se o campo estiver configurado como obrigatório, a plataforma verifica apenas se o comprador o preencheu.\n- **Número (`number`):** Aceita apenas números. Use esse tipo quando o valor precisa seguir um formato estritamente numérico.\n- **Opção (`option`):** Exibe uma lista de valores predefinidos para seleção, o que permite a padronização de dados. É o único tipo criado via API que pode ter um valor padrão por unidade organizacional.\n\n## Configuração dos campos\n\nAo criar um campo, o administrador define o seguinte:\n\n- Rótulo do campo.\n- Nível de entrada (pedido ou item).\n- Requisito de preenchimento (obrigatório ou opcional).\n- Preenchimento com texto livre no checkout (apenas campos criados na Conta da Organização).\n- Tipo `text`, `number` ou `option` (apenas campos criados via API).\n- Status habilitado ou desabilitado (apenas campos criados via API).\n\nO administrador pode criar e excluir permanentemente campos contábeis diretamente na Conta da Organização, em **Contratos > [contrato] > Campos contábeis**, além de gerenciar as configurações e os valores de cada campo. Para o passo a passo, acesse [Adicionar ou editar campos contábeis](https://help.vtex.com/pt/docs/tutorials/adicionar-ou-editar-campos-contabeis).\n\n## Valores padrão no checkout\n\nPara reduzir o preenchimento manual e evitar inconsistências, você pode configurar valores padrão por unidade organizacional.\n\nVocê pode definir os seguintes itens como padrão:\n\n- Endereço.\n- Cartão.\n- Campos contábeis com valores predefinidos: campos de lista criados na Conta da Organização e campos do tipo `option` criados via API.\n\nPara os campos criados na Conta da Organização, você define o valor padrão na página de detalhes do campo, usando a opção **Definir como padrão** no menu de opções do valor.\n\n> ℹ️ Para mais informações sobre como adicionar ou configurar campos contábeis, acesse [Adicionar ou editar campos contábeis](https://help.vtex.com/pt/docs/tutorials/adicionar-ou-editar-campos-contabeis).\n\n## Alocação de budgets a campos contábeis\n\nVocê pode usar campos contábeis como entidades vinculadas em alocações de budget, distribuindo um budget entre os valores de um campo. Por exemplo, você pode atribuir um limite de gastos a cada centro de custo. Isso permite que a organização controle os gastos com base nas informações contábeis coletadas no checkout. Para mais informações, acesse [Visão geral de Budgets](https://help.vtex.com/pt/docs/tutorials/visao-geral-de-budgets).\n\n## Resultados para administradores\n\n- Informações consistentes entre unidades organizacionais.\n- Melhor aplicação de regras internas de compra.\n- Mais segurança para relatórios e auditorias.\n\n## Resultados para compradores\n\n- Os campos aparecem no checkout com instruções claras.\n- O checkout preenche automaticamente os valores padrão configurados para a unidade organizacional.\n- O comprador finaliza o pedido com menos retrabalho e menor risco de erro.\n\n## Exemplos de uso\n\n### Exigir informações obrigatórias em todos os pedidos\n\n- **Cenário:** a empresa precisa registrar o **centro de custo** e o **número de PO** em todos os pedidos.\n- **Configuração:** criar campos obrigatórios no nível de pedido (`option` para centro de custo e `text` ou `number` para o número de PO).\n- **Resultado:** o comprador só consegue finalizar o pedido após fornecer todas as informações, garantindo conformidade.\n\n### Preencher automaticamente campos do checkout por unidade organizacional\n\n- **Cenário:** a empresa quer reduzir erros e tempo de compra em múltiplas unidades.\n- **Configuração:** definir valores padrão por unidade organizacional para endereço, cartão e campos contábeis com valores predefinidos.\n- **Resultado:** o checkout preenche os campos automaticamente após o login, reduzindo o esforço.\n\n### Classificar projetos ou atividades\n\n- **Cenário:** a empresa precisa vincular cada item comprado a um projeto ou atividade.\n- **Configuração:** criar um campo `option` no nível de item com uma lista de projetos ou atividades ativos.\n- **Resultado:** o campo vincula cada item a um projeto, facilitando o rateio e o controle de custos.\n\n### Diferenciar compras para revenda e consumo interno\n\n- **Cenário:** a empresa precisa identificar o tipo de compra no pedido.\n- **Configuração:** criar um campo `option` no nível de pedido com valores predefinidos, como revenda e consumo interno.\n- **Resultado:** permite que a empresa segmente os pedidos e aplique regras fiscais ou comerciais.\n\n### Segmentar para relatórios gerenciais\n\n- **Cenário:** o time financeiro precisa classificar pedidos por tipo de despesa.\n- **Configuração:** criar campos `option` padronizados no nível de pedido (exemplo: CAPEX, OPEX).\n- **Resultado:** o time financeiro pode filtrar relatórios sem tratamento manual posterior.\n\n### Exigir justificativa para compras específicas\n\n- **Cenário:** a empresa exige justificativa em compras sensíveis ou acima de determinado valor.\n- **Configuração:** criar um campo `text` obrigatório no nível de pedido.\n- **Resultado:** a plataforma registra a justificativa no pedido para revisão ou auditoria.\n\n### Padronizar e centralizar a governança\n\n- **Cenário:** a empresa precisa evitar variações no preenchimento.\n- **Configuração:** usar campos do tipo `option` em vez de texto livre e definir valores padrão por unidade organizacional.\n- **Resultado:** informações mais consistentes e auditáveis em toda a operação.\n\n### Controlar compliance em empresas reguladas\n\n- **Cenário:** a empresa precisa registrar códigos regulatórios por item.\n- **Configuração:** criar um campo obrigatório no nível de item (por exemplo, do tipo `text` ou `option`).\n- **Resultado:** cada item comprado inclui as informações necessárias para auditorias regulatórias."}