Preparación

Antes de emitir: consulta la preparación

GET /v1/companies/{id}/prontidao hace la misma verificación que POST /v1/nfse hace antes de crear la nota fiscal. Consultarla antes evita descubrir el problema al momento de emitir, e indica qué corregir.

Cada ítem viene con situacao, y la respuesta completa lleva la peor de ellas:

situacao	Significa	Próximo paso
ok	Requisito cumplido.	Emitir.
aviso	Emite, pero vale la pena revisarlo (certificado por vencer, parámetro del municipio aún desconocido).	Emitir, y corregir con calma.
bloqueio	La emisión se rechaza con 412 empresa_nao_pronta, sin crear nada.	Corregir antes. Intentar emitir no sirve.

Los ítems

item	Qué verifica	¿Puede bloquear?
certificado	Certificado A1 presente y válido. Aviso en los últimos 30 días.	Sí: ausente o vencido
regime_tributario	Régimen tributario configurado.	Sí
plano_emissao	Plan de Emisión activo. Solo en producción; en prueba siempre es ok.	Sí
sandbox_municipio_proprio	Solo con la clave de prueba: la empresa emite por el sistema de la alcaldía, que no tiene entorno de pruebas.	Sí
regime_apuracao_simples	Régimen de cálculo, en el Simples Nacional.	No
municipio_emissao	Municipio de la empresa conocido.	No
convenio_municipio	Si el municipio usa el Sistema Nacional, y cómo.	No
serie_dps	Serie de la DPS.	No
padroes_emissao	Valores predeterminados de la empresa (código de servicio, etc.).	No
parametros_municipais	Parámetros oficiales del municipio (alícuotas).	No
nbs	NBS para el IBS/CBS, cuando aplica a la empresa.	No
reducao_ibs_cbs	Reducción de IBS/CBS prevista para el servicio.	No

Cada ítem trae mensagem y correcao, en portugués, con qué hacer. Pueden aparecer ítems nuevos: trata cualquier item desconocido según su situacao.

El webhook EMPRESA_PRONTIDAO_ALTERADA avisa cuando un ítem cambia de situación (se verifica cada 6 horas, solo en producción). POST /v1/nfse/validacoes también devuelve la preparación, junto con la validación de la nota fiscal.