Fazenda RS - Certidão de Situação Fiscal
O que é
A certidão de débitos tributários da Fazenda do Rio Grande do Sul atesta que a pessoa ou empresa tem ou não débitos tributários do Rio Grande do Sul.
Sobre a requisição:
Método: POST
Endereço: URL Base + /api/maestro/fazenda-rs/certidao-situacao-fiscal
URL Base:
Parâmetros do header
Nome | Tipo | Obrigatório? | Descrição |
|---|---|---|---|
Authorization | String | Sim | Chave de API gerada no cadastro no Plexi, prefixada com |
Callback | String | Não | URL para onde o resultado da requisição será enviado via HTTP POST. |
Parâmetros do body
Nome | Tipo | Obrigatório? | Descrição |
|---|---|---|---|
cpfCnpj | string | Sim | CPF ou CNPJ a ser pesquisado. |
Estrutura da resposta
Status | Significado | Descrição | Informações retornadas |
|---|---|---|---|
201 | Created | Solicitação criada | Campo requestId, com o ID da requisição criada. |
422 | Unprocessable Entity | A solicitação contém erro | Em quais campos houve erro. |
Exemplos de retornos quando você faz a requisição:
Status 201
Status 422
Exemplos de retornos do resultado da pesquisa
Valores possíveis do campo “status“
Status | Significado |
|---|---|
indefinido | Não é possível informar se a pessoa ou empresa possui débitos relacionados ao documento pesquisado |
negativo | NÃO foram encontrados débitos para o documento pesquisado |
erro | Houve algum erro na geração da certidão |
Respostas com registro encontrado
{
"status": "negativo",
"cpfCnpj": "02.012.862/0001-60",
"nome": "EMPRESA S/A.",
"numeroCertidao": "0021328705",
"numeroAutenticacao": "0031364604",
"dataValidade": "27/11/2022",
"pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/..."
}{
"status": "indefinido",
"pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/..."
}
Erro
{
"status": "erro",
"mensagem": "Dados disponíveis não geraram certidão negativa. Consulte o e-CAC ou o serviço Certidão de Situação Fiscal no site.",
"pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/..."
}