Manual de uso e tutoriais

Acesso e primeiro login

1. Abra alphazfm.alphamanaus.com.br e clique em Entrar no topo — ou vá direto ao painel da empresa em /empresa.
2. Informe e-mail e senha recebidos do administrador e clique em Entrar. Você cai no Dashboard (/painel). Depois de 5 senhas erradas a conta fica bloqueada por 15 minutos.
3. Troque a senha provisória e ative o autenticador em Gestão › Configurações › Autenticação em dois fatores: clique em Configurar autenticador, cadastre a chave no aplicativo (Google Authenticator, Microsoft Authenticator etc.), digite o código de 6 dígitos e clique em Ativar.
4. A partir daí o login pede também o código do aplicativo.

A sessão dura 15 minutos e se renova sozinha enquanto você usa o sistema. Para sair, use Sair no canto superior direito.

Como a tela é organizada

O menu à esquerda mostra só o que o seu perfil pode usar. No celular ele abre pelo botão Menu.

Como o sistema decide

Cinco regras explicam quase tudo o que você vai ver nas telas:

Toda alíquota vem de uma regra com fonte

Cada percentual está cadastrado como regra, com lei, artigo, vigência, link da fonte oficial e versão. Nada está escrito no código. É por isso que o resultado sempre mostra o fundamento.

Sem regra, sem número

Se não existe regra vigente para a data e a operação, o tributo aparece como RULE_NOT_FOUND e o cálculo como REVISÃO MANUAL NECESSÁRIA. O sistema não estima. Hoje isso acontece de propósito com a CBS a partir de 2027 e o IBS a partir de 2029, porque as alíquotas de referência ainda dependem de resolução do Senado.

Vale a data da operação

Uma venda de março de 2026 usa as regras vigentes em março de 2026, mesmo que você calcule em 2028.

Estar em Manaus não é estar habilitado

Benefício que depende de habilitação só é aplicado quando existe uma verificação da situação Suframa registrada como REGULAR e, para indústria incentivada, projeto técnico-econômico aprovado. Sem isso aparece MISSING_SUFRAMA_REQUIREMENT.

Nada é apagado

Recalcular cria a versão 2, 3, 4… do cálculo; usar crédito gera um lançamento novo; a nota importada nunca muda. A trilha de auditoria não pode ser alterada nem pelo banco de dados.

Roteiro de implantação

Para colocar uma empresa em uso, siga esta ordem. Cada etapa tem um tutorial abaixo.

1. Cadastre a empresa e as filiais (tutorial 1).
2. Registre a situação Suframa com o comprovante e cadastre o projeto aprovado, se for indústria (tutorial 2).
3. Cadastre os produtos e classifique cada um (tutorial 3).
4. Crie os usuários da equipe com o perfil certo (Usuários).
5. Importe as notas do mês (tutorial 8) e trate as divergências.
6. Acompanhe ingressos, créditos e alertas no dia a dia e apure no fim do mês (9, 10, 11).

Tutorial 1 · Cadastrar empresa e filiais

Perfil necessário: administrador do inquilino ou fiscal.

1. Vá em Empresas › Empresas e filiais e clique em Nova empresa.
2. Preencha CNPJ (o sistema confere os dígitos), razão social, UF e código IBGE do município. Manaus é 1302603.
3. Escolha o regime de IBS/CBS (regular, Simples Nacional, MEI) e, separadamente, o regime de IRPJ/CSLL (lucro real, presumido…). São coisas diferentes: uma empresa do lucro presumido pode estar no regime regular de IBS/CBS.
4. Se a empresa está na ZFM, marque Estabelecida na ZFM, informe o papel Suframa (destinatário, remetente credenciado ou ambos) e a inscrição.
5. Se é indústria com projeto aprovado pelo CAS, marque Indústria incentivada. Essa marca sozinha não dá benefício: ainda é preciso o tutorial 2.
6. Clique em Salvar. Para incluir filial, use adicionar na coluna Filiais; a filial precisa ter a mesma raiz de CNPJ.

Tutorial 2 · Registrar a situação Suframa e o projeto

Não existe API pública do CADSUF. Você consulta no portal da Suframa e registra o resultado aqui, com o comprovante.

1. No portal da Suframa, consulte a situação cadastral da empresa e salve o comprovante em PDF (ou uma imagem).
2. No sistema, vá em Suframa › Situação, bloco Registrar verificação.
3. Escolha a empresa, digite a inscrição (8 ou 9 dígitos), a situação mostrada no portal e a data de validade, se houver.
4. Anexe o comprovante. Situação REGULAR sem comprovante é recusada. O arquivo é guardado com um código de integridade (hash) que prova que não foi trocado depois.
5. Clique em Registrar. O histórico de verificações aparece no cartão da empresa.
6. Para indústria, vá em Suframa › Projetos e cadastre número do projeto, data de aprovação no CAS, validade, produto e NCM.

No cartão da empresa, o botão Score de conformidade mostra uma nota de 0 a 100 (crítico, atenção, bom, excelente) e o motivo de cada ponto perdido.

Tutorial 3 · Cadastrar produto e classificação tributária

1. Vá em Produtos › Produtos, preencha código, descrição e NCM e clique em Cadastrar.
2. Clique no código do produto para abrir a ficha.
3. Em Novo perfil tributário, escolha o cClassTrib na lista oficial. O CST é preenchido sozinho (são os três primeiros dígitos).
4. Informe a vigência a partir de. Quando a classificação mudar, cadastre um perfil novo com a nova data; o anterior é encerrado na véspera e fica no histórico.
5. Para ZFM, preencha a categoria do bem (consumo final, capital, intermediário, informática ou crédito-estímulo de ICMS 100% do AM). Ela define o percentual do crédito presumido do art. 450.
6. Se o produto estiver na lista do art. 441 (armas, fumo, bebidas alcoólicas, automóveis de passageiros, petróleo e combustíveis, perfumaria e cosméticos), marque a categoria. Para cosméticos das posições 33.03 a 33.07 o sistema reconhece pelo NCM.
7. Para o IPI zero do art. 454, informe a alíquota da TIPI em 31/12/2023, se foi industrializado na ZFM em 2024, se é bem de TIC e se consta da lista oficial. O sistema diz se o produto se enquadra.
8. Clique em Registrar perfil.

Para consultar um NCM na base oficial da Receita Federal, use Produtos › NCM e CEST. A resposta mostra a descrição e se o NCM está sujeito ao Imposto Seletivo.

Tutorial 4 · Simular uma operação e ler o resultado

1. Abra Simuladores › Tributário.
2. Escolha a empresa e se ela é o emitente (venda) ou o destinatário (compra).
3. Escolha a operação, a data e o produto cadastrado (ou digite o NCM).
4. Informe quantidade e preço unitário com ponto decimal, por exemplo 1250.50.
5. Descreva a outra parte: UF, regime, situação Suframa verificada, e se está na ZFM, é indústria incentivada, consumidor final ou a União.
6. Em Mostrar valores e condições adicionais ficam desconto incondicional, frete, seguro, outras despesas, valor agregado (industrialização por encomenda), entrega dentro da ZFM e as condições que só um documento comprova.
7. Clique em Simular.

Como ler o resultado

A simulação tem a faixa “Simulação — não é apuração oficial” e não grava nada.

Exemplo real com as regras de 2026

Venda de R$ 100.000,00 de uma empresa de São Paulo para outra de São Paulo, regime regular, data 08/10/2026:

O aviso do art. 348 aparece junto: em 2026 o valor compensa PIS/Cofins do mesmo período e fica dispensado o recolhimento para quem cumpre as obrigações acessórias. Para optante do Simples Nacional, as alíquotas de 2026 aparecem como NOT_APPLICABLE (art. 348, III, c).

Tutorial 5 · Simulador ZFM, artigo por artigo

1. Abra Simuladores › ZFM e preencha a operação como no tutorial 4.
2. Clique em Verificar elegibilidade.
3. Leia a tabela dos artigos 443 a 455. Cada linha diz APPLIED, CONDITIONAL, NOT_APPLIED, NOT_IN_FORCE (ainda não vigente) ou NOT_RELEVANT, e o motivo.
4. Ao lado ficam a documentação exigida e os riscos (por exemplo, estorno se o ingresso não for comprovado).

Os benefícios cadastrados e quando começam

Tutorial 6 · Comparar 2026 a 2033

1. Abra Simuladores › 2026 a 2033 e preencha a operação.
2. Clique em Comparar anos. A tabela mostra IBS estadual, IBS municipal, CBS, IS, total do modelo novo, tributos antigos e créditos presumidos, ano a ano.
3. Anos sem alíquota publicada aparecem como pendente. Tributos antigos (ICMS, IPI, PIS/Cofins, ISS) só aparecem quando houver regra cadastrada para eles.

Tutorial 7 · Registrar, reprocessar e reproduzir um cálculo

1. No simulador tributário, com a empresa escolhida, clique em Calcular e registrar. O cálculo é gravado como versão 1 e os créditos presumidos que a sua empresa aproveita entram no controle de créditos.
2. Veja os cálculos em Tributação › Cálculos e abra um deles.
3. Para recalcular com as regras de hoje, escreva o motivo e clique em Reprocessar. Nasce a versão 2; a 1 continua lá.
4. Comparar v1 × v2 mostra a diferença por tributo e a regra responsável.
5. Reproduzir refaz uma versão antiga com as regras e o motor da época e confirma que o resultado é o mesmo. É a prova para fiscalização.

Tutorial 8 · Importar XML e tratar divergências

1. Vá em Documentos › Importar XML.
2. Escolha um XML (NF-e, NFC-e, CT-e ou MDF-e) ou um ZIP com vários XMLs e clique em Importar.
3. XML único é processado na hora. ZIP vira um lote com barra de progresso, total, processados, sucesso, duplicados, erros e tempo estimado.
4. Abra o documento em Documentos › NF-e, NFC-e, CT-e, MDF-e. Ali estão os dados, os eventos, os itens e as divergências.
5. Cada divergência diz o quê, por quê, o valor, a regra, a fonte e como corrigir.
6. Em Auditoria › Divergências, mude a situação de cada uma (em análise, confirmada, falso positivo, corrigida, ignorada) com uma justificativa.

Divergências mais comuns

A mesma nota (mesma chave de acesso) não entra duas vezes. Arquivos com DOCTYPE/ENTITY, com extensão que não bate com o conteúdo ou com caminho no nome são recusados. Texto dentro do XML nunca é tratado como instrução.

Tutorial 9 · PIN e ingressos na ZFM

Toda nota importada com a alíquota zero do art. 445 (cClassTrib 200022) cria um controle de ingresso com prazo de 120 dias a contar da emissão (Decreto 12.955/2026, art. 529 § 6º).

1. Abra Suframa › PIN e ingressos e clique na linha da nota.
2. Informe o PIN ou protocolo e clique em Registrar PIN. Depois marque Ingressou e Vistoriado conforme acontecer.
3. Quando a Suframa registrar o evento de internamento, anexe o comprovante e clique em Internamento comprovado.
4. Se o prazo não vai dar, clique em Pedir prorrogação (210 dias) antes do vencimento (art. 529 § 7º). Depois de vencido, o sistema não aceita.

Tutorial 10 · Créditos: usar, estornar e acompanhar o vencimento

1. Abra Tributação › Créditos. Cada linha mostra o original, o utilizado, o saldo, o vencimento e o fundamento.
2. Clique num crédito para ver o extrato (cada criação, uso, estorno e expiração).
3. Para usar, informe valor, o tributo que está sendo abatido, data e motivo, e clique em Utilizar.
4. Para estornar (perfil com permissão de aprovar), informe valor e motivo e clique em Estornar.

Regras do art. 452: crédito presumido de IBS só abate IBS e de CBS só abate CBS, não vira dinheiro, e vence 5 anos depois do primeiro dia do mês seguinte à apropriação. Exemplo: apropriado em 15/03/2027, vale até 31/03/2032. O sistema avisa com 180, 90 e 30 dias de antecedência e, vencido, lança a expiração sozinho.

Tutorial 11 · Apuração do mês

1. Abra Tributação › IBS, CBS e IS.
2. Escolha a empresa, ano e mês e informe os créditos ordinários do período (arts. 47 a 56).
3. Clique em Apurar. Aparecem débitos, créditos, créditos presumidos, o crédito do art. 450 § 1º, o valor a recolher e o saldo credor, com o passo a passo da conta.
4. Confira e clique em Fechar. Período fechado não é recalculado; se precisar, use Reabrir, que gera uma nova versão da apuração.

O crédito do art. 450 § 1º segue o § 6º incluído pela LC 227/2026: o percentual incide sobre cada débito de IBS e o crédito nunca entra na própria base. Os botões no topo exportam os relatórios de IBS, CBS e IS.

Tutorial 12 · Regras próprias e fluxo de aprovação

As regras oficiais (marcadas como OFFICIAL) são mantidas pela plataforma. A sua empresa pode criar regras próprias, sempre marcadas como CUSTOM_RULE e nunca confundidas com as oficiais.

1. Abra Tributação › Regras, filtre pela situação e clique no código para ver os detalhes, o fundamento, a trilha de aprovação e as versões.
2. Para avançar, escreva um comentário e clique na próxima etapa. Cada passo grava quem, quando, IP e comentário.
3. Quem criou a regra não pode aprová-la; outra pessoa com permissão faz isso.
4. Antes de aprovar, o sistema valida fundamento, percentual, vigência e possíveis conflitos. Pendências aparecem em amarelo.
5. Para mudar uma regra ativa, crie uma nova versão. Ao ativar a nova, a anterior termina na véspera; cálculos de datas antigas continuam usando a anterior.

Os 308 rascunhos importados da tabela oficial cClassTrib (por exemplo, redução de 40% para bares e restaurantes, art. 275) só passam a valer depois de percorrer esse fluxo.

Tutorial 13 · Acompanhar a legislação

1. Legislação › Normas e fontes lista as fontes oficiais monitoradas todo dia às 06:00 (horário de Manaus): EC 132/2023, LC 214/2025, LC 227/2026, Decreto 12.955/2026, dados abertos da Receita, CGIBS, Suframa e Portal NF-e.
2. Em Ler artigo da versão baixada, escolha a norma e o número do artigo para ler o texto vigente.
3. Legislação › Alterações e aprovações mostra o que mudou, artigo por artigo, e as regras afetadas.
4. O Simulador de impacto recalcula os cálculos recentes como se um rascunho já estivesse ativo e mostra quanto mudaria. Nada é gravado.

Detectar uma mudança nunca altera a produção. A mudança segue o fluxo DETECTED → ANALYZED → DRAFTED → REVIEW → APPROVED → DEPLOYED, e só fica implantada quando as regras vinculadas estiverem ativas.

Tutorial 14 · PPB e P&D

1. Em Suframa › PPB, cadastre o processo produtivo básico com a portaria de origem e as etapas obrigatórias, uma por linha.
2. No checklist, escolha empresa e PPB, marque as etapas cumpridas e informe o código de integridade (hash) do comprovante de cada uma. Só conta etapa com comprovante.
3. Em Suframa › P&D (PDI), registre o valor exigido, o realizado e o prazo. Os alertas são PDI_PENDING, PDI_INSUFFICIENT e PDI_OVERDUE.

O código de integridade de um arquivo aparece quando você o anexa como evidência na tela da Suframa.

Painéis, alertas e oportunidades

Relatórios

Em Gestão › Relatórios, escolha o período e baixe em PDF, XLSX, CSV ou JSON: IBS, CBS, IS, créditos, créditos presumidos, ZFM, Suframa, PPB, PDI, PIN, ingressos, divergências, oportunidades, trilha de auditoria, legislação, exportação contábil mensal e uso. Toda exportação fica registrada na trilha.

Usuários, perfis e contador multicliente

Em Gestão › Configurações › Usuários, informe e-mail, nome, senha (10 ou mais caracteres, com maiúscula, minúscula, número e símbolo) e o perfil.

Contador multicliente: ao criar o usuário, selecione em Restringir a empresas só as empresas que ele pode ver. Ele não enxerga as demais. Usuários desativados perdem a sessão na hora. Em Meus dados (LGPD) cada pessoa exporta os próprios dados.

Integrações e AlphaERP

Em Gestão › Integrações você vê a situação real de cada integração e cria acessos para outros sistemas.

1. Em API Key, dê um nome (por exemplo, AlphaERP) e clique em Criar chave. Copie a chave e o segredo na hora: eles não aparecem de novo.
2. O sistema que chama assina cada pedido: cabeçalhos x-api-key, x-timestamp (segundos) e x-signature = HMAC-SHA256 do segredo sobre timestamp.corpo. Pedidos com mais de 5 minutos são recusados.
3. Envie Idempotency-Key para que uma repetição devolva a mesma resposta em vez de calcular de novo.
4. Use Rotacionar para trocar o segredo sem derrubar o sistema (o anterior vale até a próxima troca) e Revogar para cortar o acesso.

// Node.js — cálculo pelo AlphaERP
const corpo = JSON.stringify({ date: '2026-10-08', operation: 'SALE',
  issuer: { uf: 'AM', regime: 'REGULAR' }, recipient: { uf: 'SP', regime: 'REGULAR' },
  product: { ncm: '85171300' }, quantity: '1', unitPrice: '1000.00' });
const ts = Math.floor(Date.now() / 1000);
const sig = crypto.createHmac('sha256', SEGREDO).update(`${ts}.${corpo}`).digest('hex');
await fetch('https://alphazfm.alphamanaus.com.br/api/v1/integration/alphaerp/tax-results', {
  method: 'POST', body: corpo,
  headers: { 'content-type': 'application/json', 'x-api-key': CHAVE,
             'x-timestamp': String(ts), 'x-signature': sig, 'idempotency-key': 'pedido-123' } });

A resposta traz taxes.ibs, taxes.cbs, taxes.is, créditos, créditos presumidos, benefícios, avisos, erros, fundamento e versão do motor. A documentação completa da API fica em /api/docs.

Webhooks: cadastre uma URL HTTPS para receber avisos de nota importada, cálculo feito, divergência, benefício detectado, crédito criado ou vencendo, mudança na Suframa e mudança na legislação. Confira a assinatura no cabeçalho x-alphazfm-signature.

Credenciais: endpoint, client ID, segredo e senha do certificado são guardados criptografados. Guardar credencial não liga a integração: ela continua NOT_CONFIGURED até ser homologada.

Administração da plataforma

Só para o administrador da plataforma, em /plataforma (login próprio; usuários de empresa são recusados). O console tem cinco abas:

Mensagens e situações

O que ainda não está ligado

Glossário

IBS

Imposto sobre Bens e Serviços, de estados e municípios; tem parcela estadual e municipal.

CBS

Contribuição Social sobre Bens e Serviços, federal.

IS

Imposto Seletivo, sobre bens e serviços prejudiciais à saúde ou ao meio ambiente.

CST

Código de situação tributária do IBS/CBS (3 dígitos).

cClassTrib

Classificação tributária do item (6 dígitos); os três primeiros são o CST.

cCredPres

Código do crédito presumido no leiaute da NF-e.

ZFM

Zona Franca de Manaus: parte dos municípios de Manaus, Rio Preto da Eva e Itacoatiara.

Indústria incentivada

Indústria com inscrição Suframa regular e projeto técnico-econômico aprovado pelo CAS (LC 214, arts. 440 e 442).

CAS

Conselho de Administração da Suframa.

PPB

Processo produtivo básico: etapas mínimas de fabricação exigidas por portaria.

PDI / P&D

Investimento obrigatório em pesquisa, desenvolvimento e inovação.

PIN / internamento

Protocolo e evento que comprovam a entrada da mercadoria na ZFM.

Bem intermediário

Produto destinado a incorporação ou consumo na fabricação de outro bem, ou à embalagem, entregue a estabelecimento industrial.

Saldo devedor

Débitos do período menos créditos permitidos; base do crédito do art. 450 § 1º.

Vigência

Período em que a regra produz efeito, contado pela data da operação.

Perguntas frequentes

Minha empresa está em Manaus. Por que não recebeu benefício?

Porque ainda não há verificação Suframa registrada como regular (e, para indústria, projeto aprovado). Faça o tutorial 2.

Por que a CBS de 2027 não tem valor?

A LC 214/2025 manda usar a alíquota de referência que o Senado ainda vai fixar. Quando for publicada, a regra entra pelo fluxo de aprovação e os cálculos passam a mostrar o valor.

Posso apagar um cálculo errado?

Não. Corrija o cadastro e use Reprocessar; a versão nova fica registrada com o motivo e a antiga serve de histórico.

Importei a mesma nota duas vezes. O que acontece?

A segunda é reconhecida como duplicada pela chave de acesso e não é gravada.

Uma oportunidade de R$ 30 mil significa que vou economizar esse valor?

Não necessariamente. Oportunidade é potencial: precisa ser validada pelo contador antes de qualquer ajuste.

Quem pode ver os dados da minha empresa?

Só os usuários do seu inquilino, conforme o perfil, e o administrador da plataforma para suporte. Cada acesso fica registrado.