simples¶
SimplesClient ¶
Cliente para consulta do Simples Nacional via BrasilAPI.
get_simples_status
async
¶
Consulta o status do Simples Nacional e MEI para um CNPJ.
SimplesStatus ¶
Bases: BaseModel
fonte_confirmada
class-attribute
instance-attribute
¶
False quando o resultado veio de um 404 da BrasilAPI: pode significar 'não optante' de fato ou apenas que a fonte não confirmou o dado (endpoint fora do ar, CNPJ inexistente etc). True = dado retornado pela API normalmente.
client ¶
schemas ¶
SimplesStatus ¶
Bases: BaseModel
fonte_confirmada
class-attribute
instance-attribute
¶
False quando o resultado veio de um 404 da BrasilAPI: pode significar 'não optante' de fato ou apenas que a fonte não confirmou o dado (endpoint fora do ar, CNPJ inexistente etc). True = dado retornado pela API normalmente.
tools ¶
Ferramentas MCP para Simples Nacional.
consultar_simples_nacional
async
¶
Consulta se uma empresa é optante do Simples Nacional ou MEI.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
cnpj
|
str
|
CNPJ da empresa (com ou sem formatação) |
required |
Returns:
| Type | Description |
|---|---|
SimplesStatus
|
SimplesStatus com situação no Simples e MEI, incluindo datas de opção/exclusão. |
Raises:
| Type | Description |
|---|---|
ValidationError
|
Se o CNPJ for inválido. |
NotFoundError
|
Se o CNPJ não for encontrado. |
APIError
|
Em caso de falha na API. |