Prontidão

Antes de emitir: consulte a prontidão

GET /v1/companies/{id}/prontidao faz a mesma checagem que POST /v1/nfse faz antes de criar a nota. Consultar antes evita descobrir o problema na hora de emitir, e diz o que corrigir.

Cada item vem com situacao, e a resposta inteira leva a pior delas:

situacao	Significa	Próximo passo
ok	Requisito atendido.	Emitir.
aviso	Emite, mas vale olhar (certificado vencendo, parâmetro do município ainda desconhecido).	Emitir, e corrigir com calma.
bloqueio	A emissão é recusada com 412 empresa_nao_pronta, sem criar nada.	Corrigir antes. Tentar emitir não adianta.

Os itens

item	O que confere	Pode bloquear?
certificado	Certificado A1 presente e válido. Aviso nos últimos 30 dias.	Sim: ausente ou vencido
regime_tributario	Regime tributário configurado.	Sim
plano_emissao	Plano de Emissão ativo. Só em produção; no teste é sempre ok.	Sim
sandbox_municipio_proprio	Só com a chave de teste: a empresa emite pelo sistema da prefeitura, que não tem ambiente de teste.	Sim
regime_apuracao_simples	Regime de apuração, no Simples Nacional.	Não
municipio_emissao	Município da empresa conhecido.	Não
convenio_municipio	Se o município usa o Sistema Nacional, e como.	Não
serie_dps	Série da DPS.	Não
padroes_emissao	Padrões da empresa (código de serviço etc.).	Não
parametros_municipais	Parâmetros oficiais do município (alíquotas).	Não
nbs	NBS para o IBS/CBS, quando ele vale para a empresa.	Não
reducao_ibs_cbs	Redução de IBS/CBS prevista para o serviço.	Não

Cada item traz mensagem e correcao, em português, com o que fazer. Novos itens podem aparecer: trate qualquer item desconhecido pela situacao.

O webhook EMPRESA_PRONTIDAO_ALTERADA avisa quando um item muda de situação (conferido a cada 6 horas, só em produção). POST /v1/nfse/validacoes também devolve a prontidão, junto da validação da nota.