Configurar o faturamento eletrônico de uma entidade

Guia de administração 9 min de leitura Atualizado em agosto de 2026

Tudo em faturamento eletrônico depende de um único registro de configuração por entidade. Este artigo mostra como criá-lo, as quatro coisas que uma atualização não fará por você e como comprovar que a cadeia inteira funciona antes que faturas reais dependam dela.

Como chegar lá. Abra o Iniciador de aplicativos (o ícone de grade no canto superior esquerdo) → REDA Financials → a guia Configuração de fatura eletrônica → Novo.
Acesso que você precisará. O conjunto de permissões Accounting Admin v2, mais a permissão padrão do Salesforce Personalizar aplicativo para as etapas de layout de página e segurança de campo da seção 3. Se você não enxerga a guia, falta o conjunto de permissões — consulte Atribuição de conjuntos de permissões.

Faça isso primeiro em um sandbox. Transmitir uma fatura é um ato legal. Configure e teste no ambiente de testes do seu órgão fiscal antes de ligar a transmissão em produção, para que um erro produza uma rejeição de teste e não uma real. Consulte o Guia de testes em sandbox.

Antes de começar

Três coisas precisam ser verdadeiras, e conferi-las agora é muito mais rápido do que depurá-las depois.

Pré-requisito	Por quê	Como conferir
A entidade existe e está configurada	A configuração é por entidade: um registro para cada empresa legal que transmite.	Abra a guia Entidades. Consulte Criando uma Entidade.
Há uma extensão instalada para o seu país	Cada órgão fiscal recebe de um jeito. O aplicativo base fornece a estrutura e a trilha de auditoria; a conexão com um órgão específico vem de um pacote de extensão instalado ao lado dele.	Pergunte a quem fez a sua implementação. Sem ela, os documentos podem ser preparados, mas não transmitidos.
Os clientes têm identificadores fiscais válidos	O motivo de rejeição mais comum, com boa margem, é um identificador fiscal do cliente que o órgão não consegue localizar no próprio cadastro.	Confira por amostragem o identificador fiscal das contas de cliente para as quais você mais fatura.

1. Crie o registro de Configuração de fatura eletrônica

Vá em Iniciador de aplicativos → REDA Financials → Configuração de fatura eletrônica e clique em Novo.
Entidade — escolha a empresa legal a que esta configuração se aplica. Um registro por entidade; não tente cobrir várias com um só.
Código do país — o país cujas regras se aplicam, no código padrão de duas letras.
Ambiente — Sandbox enquanto você testa e Produção apenas quando estiver pronto para transmitir de verdade. Errar aqui é a diferença entre um ensaio e uma transmissão real.
Tipos de documento — quais documentos estão no escopo. Selecione Fatura de venda. Um tipo de documento que você não selecionar simplesmente nunca é transmitido. A lista oferece outros tipos, mas se algum deles se aplica a você depende inteiramente da conexão de país que estiver instalada: pergunte a quem a instalou antes de selecionar um, em vez de supor que está coberto.
Enviar automaticamente ao contabilizar — leia a próxima seção antes de decidir.
Ativo — deixe desmarcado até terminar o restante da configuração abaixo. Nada é transmitido enquanto está desligado, que é exatamente o que você quer no meio da configuração.
Salve.

O que você deve ver. O registro é salvo, e o cartão Consulta de status de fatura eletrônica na guia Operações do Console de Administração passa a informar pelo menos uma configuração ativa assim que você marcar Ativo. Essa contagem é a confirmação mais rápida de que o aplicativo enxerga a sua configuração.

2. Transmissão automática ou manual?

Enviar automaticamente ao contabilizar decide o que acontece no momento em que uma fatura é contabilizada. As duas opções são legítimas; elas servem a empresas diferentes.

	Marcado — automático	Desmarcado — manual
Ao contabilizar	A fatura é liberada para transmissão na hora.	Um Histórico é criado e aguarda em Rascunho até alguém liberá-lo.
Combina com	Volume alto, faturamento rotineiro, confiança na qualidade dos dados.	Volume baixo, valor alto ou uma etapa de conferência antes que algo chegue ao órgão fiscal.
Fique atento a	Um erro de dados é transmitido antes que alguém perceba; corrigi-lo exige uma nota de crédito.	Nada é transmitido se ninguém lembrar de liberar. Alguém precisa ser dono da fila.

Se estiver em dúvida, comece no manual. Passe para o automático depois de algumas semanas vendo aceitações limpas.

3. Torne visíveis os campos novos — a etapa que passa batido

A atualização instalou os campos novos. Ela não os mostrou para ninguém. Isso falha de duas formas independentes, e deixar passar qualquer uma delas mantém o recurso funcionando de forma invisível: uma atualização nunca adiciona um campo a um layout de página que você tenha personalizado, e a segurança de campo que vem nos conjuntos de permissões da REDA só alcança usuários com esses conjuntos atribuídos. Se a sua organização usa os próprios conjuntos de permissões ou perfis — a maioria usa —, você mesmo precisa conceder o acesso aos campos.

Objeto	Campo	Os usuários devem ter	Coloque em
Fatura de venda	Status de fatura eletrônica	Somente leitura — quem define é o sistema	Uma seção Faturamento eletrônico
Fatura de venda	UUID de fatura eletrônica	Somente leitura — quem emite é o órgão fiscal	Uma seção Faturamento eletrônico
Fatura de venda	Ignorar fatura eletrônica	Editável, para quem puder excluir uma fatura	Uma seção Faturamento eletrônico
Histórico de fatura eletrônica	ID do documento do provedor	Somente leitura	Detalhes do histórico

Coloque-os nos seus layouts. Configuração → Gerenciador de objetos → Fatura de venda → Layouts de página → abra cada layout que os seus usuários realmente usam → arraste os três campos para uma seção Faturamento eletrônico (crie a seção se não houver) → Salvar. Repita em todo layout e tipo de registro em uso — um campo colocado em um layout é invisível nos demais. Depois faça o mesmo em Histórico de fatura eletrônica para o ID do documento do provedor.
Conceda a segurança em nível de campo se você não usa os conjuntos de permissões da REDA. Configuração → Gerenciador de objetos → o objeto → Campos e relacionamentos → o campo → Definir segurança em nível de campo → marque Visível para os seus próprios perfis ou conjuntos de permissões. Mantenha Somente leitura marcado em tudo, exceto em Ignorar fatura eletrônica.
Conceda acesso ao objeto e à guia de Configuração de fatura eletrônica e Histórico de fatura eletrônica nos seus próprios conjuntos de permissões, para que as pessoas certas consigam abri-los.
Adicione Ignorar fatura eletrônica ao conjunto de campos Interface. Configuração → Gerenciador de objetos → Fatura de venda → Conjuntos de campos → Interface → arraste Ignorar fatura eletrônica para a caixa de selecionados → Salvar. O formulário da fatura é uma tela personalizada, então o layout de página exibe este campo, mas não consegue capturá-lo. Sem esta etapa a caixa de seleção fica visível e inutilizável.
Adicione a ação Enviar / Reenviar ao layout do Histórico de fatura eletrônica. Configuração → Gerenciador de objetos → Histórico de fatura eletrônica → Layouts de página → abra o layout → Ações móveis e do Lightning → arraste Enviar / Reenviar para a barra de ações → Salvar. A ação vem com o pacote, mas uma atualização não a acrescenta a um layout que a sua organização já tinha. Sem ela ninguém consegue transmitir um Histórico retido nem repetir a tentativa de um que falhou.

Acrescente os status do Histórico que uma versão introduz — a atualização não fará isso. Uma atualização do pacote não acrescenta valores novos a uma lista de opções de uma organização que já tem o campo, então um status introduzido por uma versão fica ausente até um administrador acrescentá-lo à mão. Vá em Configuração → Gerenciador de objetos → Histórico de fatura eletrônica → Campos e relacionamentos → Status e leia a lista de valores: Rascunho, Pronto para enviar, Na fila, Enviado, Aceito, Rejeitado, Erro, Cancelado. A versão 1.610 introduziu Pronto para enviar, então em qualquer organização atualizada para ela esse valor precisa ser acrescentado, com essa grafia exata. É o status para o qual um Histórico vai no momento em que é liberado para transmissão, então sem ele um Histórico liberado não tem para onde ir.

Teste como um usuário comum, nunca como você mesmo. Administradores enxergam campos independentemente da segurança em nível de campo, então conferir como administrador não prova absolutamente nada. Faça login como — ou peça a — um usuário de contas a receber e confirme que ele vê o Status de fatura eletrônica e consegue marcar Ignorar fatura eletrônica.

4. Coloque a consulta de status para rodar

Órgãos fiscais respondem no próprio ritmo, então um trabalho agendado recolhe os vereditos deles. Ele é obrigatório: um trabalho agendado não pode ser entregue dentro de um pacote instalado, então cada organização cria o seu. Pule esta etapa e as suas faturas serão transmitidas corretamente e depois nunca sairão de Enviado.

Abra Iniciador de aplicativos → REDA Financials Admin → Console de Administração Financeira → Operações, expanda o cartão Consulta de status de fatura eletrônica e clique em Iniciar. O detalhe completo — inclusive o que cada contagem do cartão significa — está no manual da Consulta de status de fatura eletrônica.

5. Comprove que funciona e só então entre no ar

Marque Ativo no registro de Configuração de fatura eletrônica, com Ambiente ainda em Sandbox.
Contabilize uma fatura de teste comum para um cliente cujo identificador fiscal você considere confiável.
Abra a guia Históricos de fatura eletrônica. Deve existir um Histórico para essa fatura poucos instantes depois da contabilização.
Use Executar agora no cartão de Operações em vez de esperar pelo próximo ciclo.
Confirme que o Histórico chega a Aceito e que a fatura agora exibe um UUID de fatura eletrônica. Isso comprova a cadeia inteira, de ponta a ponta.
Contabilize de propósito uma fatura para um cliente com identificador fiscal errado e confirme que ela volta como Rejeitado, com um motivo legível. Saber com o que uma falha se parece antes que ela aconteça de verdade vale os dez minutos.
Só então mude o Ambiente para Produção.

Solução de problemas

Sintoma	Causa provável	O que fazer
Nenhum Histórico aparece quando uma fatura é contabilizada	Nenhuma configuração ativa cobre aquela entidade ou aquele tipo de documento, ou a fatura está marcada como Ignorar fatura eletrônica.	Verifique se Ativo está marcado, se a entidade da fatura corresponde à da Configuração e se o tipo de documento dela está em Tipos de documento.
Os usuários não conseguem ver os campos novos	Layout ou segurança em nível de campo — normalmente os dois, e normalmente porque a organização usa os próprios conjuntos de permissões.	Percorra a seção 3 e teste de novo como usuário comum, não como administrador.
Ignorar fatura eletrônica está visível, mas não pode ser marcado	Ele está no layout, mas não no conjunto de campos Interface.	Seção 3, etapa 4.
Os Históricos chegam a Enviado e param	A consulta de status não está rodando.	Seção 4. Esta é, de longe, a omissão mais comum na entrada em produção.
Tudo volta Rejeitado pelo mesmo motivo	Um problema sistemático de dados — quase sempre os identificadores fiscais dos clientes.	Leia o motivo em um Histórico, corrija o dado de origem do cliente e reemita.
Os Históricos terminam em Erro em vez de um veredito	O documento nunca chegou ao órgão fiscal — conexão, credenciais ou ambiente.	Confirme que o Ambiente corresponde às credenciais em uso e depois fale com quem instalou a extensão de país.

Para onde ir depois

Faturamento eletrônico: como funciona — os conceitos por trás desta configuração.
Consulta de status de fatura eletrônica — o trabalho agendado obrigatório.
Ler um Histórico de fatura eletrônica — resolver rejeições e erros.
Faturamento eletrônico na fatura de venda — o que a sua equipe de contas a receber vai ver.

Perguntas frequentes

Não — um registro por entidade. Cada entidade é um declarante legal separado, com o próprio cadastro, então elas são configuradas e, se preciso, desligadas de forma independente.

As faturas novas param de gerar Históricos imediatamente. Os Históricos existentes não são tocados e mantêm o histórico deles. É uma forma segura de pausar a transmissão.

Só se a conexão de país que você tem instalada tratar delas — selecionar um tipo de documento não o torna transmissível por si só. Confirme com quem instalou a sua conexão quais tipos de documento ela cobre e adicione apenas esses a Tipos de documento. Tudo o que você deixar de fora nunca é transmitido.

Eles foram removidos daquele layout, não do aplicativo. Adicione-os de novo no Gerenciador de objetos — e lembre-se de que uma atualização futura também não vai recolocá-los em um layout personalizado.

Os seus registros de Configuração vêm junto, mas os trabalhos agendados não — eles são dados da organização. Depois de cada atualização, coloque a consulta de status para rodar de novo e confirme que o Ambiente continua em Sandbox, para que faturas de teste não sejam transmitidas de verdade.