Reguladores envolvidos
- SEFAZ (Secretaria da Fazenda estadual) — autoridade emissora da NF-e
- dLocal Go — agente tributario para CBS/IBS (reforma tributaria 2026-08-03)
Modelo BYO no Cepaos
O Cepaos adota o modelo BYO (Bring Your Own): a sua vinicola fornece o certificado digital A1 e as credenciais da SEFAZ; o Cepaos integra com o web service da SEFAZ do seu estado e a dLocal Go cuida dos calculos de CBS e IBS conforme a reforma tributaria. Voce mantem o controle do certificado e a dLocal Go cumpre o papel de agente tributario sem que o Cepaos precise emitir NF-e em nome proprio.
Requisitos previos
Confirme que voce tem:
- Certificado digital A1 (.pfx) com senha valida e vigencia minima de 90 dias.
- CSC (Codigo de Seguranca do Contribuinte) emitido pela SEFAZ do seu estado.
- Inscricao estadual ativa com regime tributario definido (Simples Nacional, Lucro Presumido ou Lucro Real).
- Cadastro de produtos com NCM 2204.10 (espumante), 2204.21 (vinho em garrafa ate 2L) ou 2204.22 (vinho em recipientes de 2 a 10L).
- Cadastro SISDEVIN ativo (ver artigo correlato).
- Conta dLocal Go vinculada a organizacao no Cepaos.
Passo a passo
1. Subir o certificado A1
Na barra lateral, va em Configuracoes > Integracoes > NF-e BR. Clique em Carregar certificado e selecione o arquivo .pfx. Digite a senha. O Cepaos criptografa o certificado com KMS antes de armazenar; a senha nao fica em texto plano em momento algum.
2. Configurar o CSC
Na aba SEFAZ, informe o ID do CSC e o token. Esses dados sao usados para gerar o codigo QR obrigatorio da NF-e.
3. Verificar conexao
Clique em Testar conexao. O Cepaos chama o servico de status da SEFAZ do seu estado. Se a resposta for HTTP 200 com status 107, esta tudo certo. Caso contrario, voce ve o codigo de retorno e a descricao do problema.
4. Configurar a dLocal Go como agente tributario
Na aba dLocal Go, autorize a integracao OAuth. A dLocal Go passa a calcular automaticamente:
- CBS (Contribuicao sobre Bens e Servicos) — aliquota federal unica de 8,8%.
- IBS (Imposto sobre Bens e Servicos) — aliquota estadual e municipal combinadas.
- IS (Imposto Seletivo) para vinhos com alcool acima do limite legal, quando aplicavel.
5. Emitir uma NF-e
Apos uma venda registrada no modulo Comercial, clique em Emitir NF-e. O Cepaos:
- Monta o XML conforme layout NT 2024.001 da SEFAZ.
- Calcula CBS/IBS via dLocal Go.
- Assina o XML com o certificado A1.
- Envia para a SEFAZ via web service NfeAutorizacao4.
- Aguarda o protocolo de autorizacao.
- Gera o DANFE em PDF com QR code.
O tempo medio de emissao e de 4 a 8 segundos.
6. Tratar rejeicoes
Se a SEFAZ rejeitar (codigo diferente de 100), o Cepaos exibe a mensagem oficial da rejeicao com link direto para o campo problematico. Os erros mais comuns sao:
- Codigo 539: duplicidade de chave de acesso (verifique a numeracao do RPS).
- Codigo 215: falha no schema XML (campo obrigatorio faltando).
- Codigo 776: certificado vencido ou revogado.
Prazo CBS/IBS — 2026-08-03
A reforma tributaria entra em vigor em 3 de agosto de 2026. A partir dessa data, toda NF-e emitida deve conter CBS e IBS calculados. O Cepaos ja esta preparado e a dLocal Go atua como agente tributario desde o primeiro dia.
Perguntas frequentes
Posso usar certificado A3 (token)?
Nao no modelo BYO atual. O A3 exige presenca fisica do token, o que nao funciona em ambiente cloud. Use A1.
A dLocal Go cobra por NF-e emitida?
A tarifa esta inclusa no contrato comercial dLocal Go. Consulte o seu account manager para o detalhe.
E se a SEFAZ estiver fora do ar?
O Cepaos enfileira a NF-e e tenta novamente em contingencia SVC-AN (Servico Virtual de Contingencia Ambiente Nacional).