Fazenda SC - Certidão Negativa de Débitos

O que é#

A certidão de débitos tributários emitida pela Fazenda de Santa Catarina tem como finalidade confirmar se uma pessoa física ou jurídica possui pendências financeiras relacionadas aos impostos no estado de Santa Catarina.

Sobre a requisição#

Método: POST

Endereço: https://api.plexi.com.br/api/maestro/fazenda-sc/certidao-negativa-debitos

URL Base: https://api.plexi.com.br/

Parâmetros do header#

Nome	Tipo	Obrigatório?	Descrição
Authorization	String	Sim	Chave de API gerada no cadastro no Plexi, prefixada com `Bearer`
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.
cpfSolicitante	string	Sim quando `cpfCnpj` for um CNPJ	CPF do solicitante

Retornos possíveis da requisição#

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#

Status 201#

A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.

JSON

{
  "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42"
}

Status 422#

Significa que ocorreu um erro de validação dos dados enviados.

JSON

{
  "message": "The given data was invalid.",
  "errors": {
    "cpf": [
      "O campo cpf é obrigatório."
    ],
    "nome": [
      "O campo nome é obrigatório."
    ]
  }
}

Resultados da pesquisa ( retornados no callback ou fazendo requisição à API de respostas )#

Valores possíveis do campo "status"#

Status	Significado
negativo	NÃO foram encontrados débitos para o documento pesquisado
positivo	Foram encontrados débitos para o documento pesquisado
erro	Erro ao buscar informações, seja por documento ou outro dado incorreto

Respostas com registro encontrado quando usado CPF ou CNPJ#

JSON

{
  "nome": "EMPRESA EXEMPLO LTDA",
  "cpfCnpj": "99.999.999/9999-99",
  "status": "negativo",
  "dataHoraEmissao": "01/01/2020 09:00:00",
  "pendencias": null,
  "inscricaoEstadual": false,
  "numeroCertidao": "99999999999999",
  "dataValidade": "01/01/2020",
  "pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/..."
}

JSON

{
  "nome": "EMPRESA EXEMPLO LTDA",
  "cpfCnpj": "99.999.999/9999-99",
  "status": "positivo",
  "dataHoraEmissao": "01/01/2020 18:00:00",
  "pendencias": [
    "SEF/SC, para informações, contate o seu contabilista (se possuir inscrição estadual) ou as Gerências Regionais da Secretaria da Fazenda",
    "TRIBUNAL DE JUSTIÇA DE SANTA CATARINAPara obter detalhes do débito e emitir o boleto, acesse: https://tjsc.thema.inf.br/grp/acessoexterno/programaAcessoExterno.faces?codigo=999999. Em caso de dúvidas envie e-mail para dof.gecof@tjsc.jus.br ."
  ],
  "inscricaoEstadual": null,
  "numeroCertidao": null,
  "dataValidade": null,
  "pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/..."
}

Resposta com erro#

JSON

{
  "status": "erro",
  "mensagem": "Cpf ou cnpj inexistente.",
  "pdf": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/..."
}