WS Consulta Cadastro
Descrição
Este método permite realizar consulta ao WebService da NFe de Consulta Cadastro.
URL da Chamada
| POST http://ws.tn3.com.br:8080/v1/consultacadastro |
Exemplo da Chamada
curl -H 'Content-Type: application/json' -s -XPOST
http://ws.tn3.com.br:8080/v1/consultacadastro
-d {
"uf":"RS",
"amb":"2",
"identif":"05511674000174"
}
Parâmetros de Entrada
| Parâmetro | Descrição | Dado | Obrigatório |
| uf | UF onde será realizado a consulta | String (somente permitido siglas de UF existentes) |
Sim |
| amb | Ambiente de consulta | Inteiro (1: Produção 2: Homologação) |
Sim |
| Identif | CNPJ ou CPF que será realizado a consulta | String | Sim |
| Ie | Informar a inscrição municipal do “identif” caso necessário. | String | Não |
| Hash | informar a hash única de identificação do cliente que está utilizando o serviço de consulta. Esta Hash será disponibilizada pela TN3 quando o cliente solicitar a aquisição do produto. |
String | Sim |
Resposta do Serviço
HTTP Status Code = 200 (OK)
{
"cnpj":"0256022000184",
"uf":"RS",
"cstat":"111",
"motivo":"Consulta cadastro com uma ocorrencia",
"dhcons":"2018-01-09 10:08:54",
"cuf":"43",
"infcadie":"303092193",
"infcadcnpj":"0256022000184",
"infcaduf":"RS",
"infcadsit":"1",
"infcadnome":"TRANSPS MODELO LTDA",
"infcadregapur":"GERAL",
"infcadcnae":"4930202",
"infcadiniativ":"1997-12-01",
"infcadultsit":"1997-12-24",
"infcadenderlgr":"RUA SILVA SO",
"infcadendernro":"603",
"infcadendercompl":"SALA 01",
"infcadenderbairro":"INDUSTRIAL",
"infcadendercodmun":"4307005",
"infcadendernomemun":"Erechim",
"infcadendercep":"99700000"
}
Atributos da Resposta
| Atributo | Descrição | Dado | Obrigat. |
| cnpj | CNPJ do contribuinte | String | |
| cpf | CPF do contribuinte; | String | |
| ie | Inscrição Estadual do contribuinte; | String | |
| uf | Sigla da UF consultada, utilizar SU para SUFRAMA; | String | |
| cstat | Código do status da mensagem enviada; | Inteiro | |
| motivo | Descrição literal do status do serviço solicitado; | String | |
| dhcons | Data da Consulta; | Data | |
| cuf | Código da UF de atendimento; | Inteiro | |
| infcadie | Número da Inscrição Estadual do contribuinte | String | |
| infcadcnpj | Número do CNPJ do contribuinte; | String | |
| infcadcpf | Número do CPF do contribuinte; | String | |
| infcaduf: | Sigla da UF de localização do contribuinte. Em algumas situações, a UF de localização pode ser diferente da UF consultada. Ex. IE de Substituto Tributário; | String | |
| infcadsit | Situação cadastral do contribuinte: 0 não habilitado – 1 habilitado; | Inteiro | |
| infcadnome | Razão Social ou nome do contribuinte; | String | |
| infcadfant | Nome Fantasia do contribuinte; | String | |
| infcadregapur | Regime de Apuração do ICMS; | String | |
| infcadcnae | CNAE Fiscal do contribuinte; | String | |
| infcadiniativ | Data de início de atividades do contribuinte; | Data | |
| infcadultsit | Data da última modificação da situação cadastral; | Data | |
| infcadbaixa | Data de ocorrência da baixa do contribuinte; | Data | |
| infcadieunica | Inscrição Estadual Única; | String | |
| infcadieatual | Inscrição Estadual atual; | String | |
| infcadenderlgr | Logradouro; | String | |
| infcadendernro | Número; | String | |
| infcadendercompl | Complemento; | String | |
| infcadenderbairro | Bairro; | String | |
| infcadendercodmun | Código do município (utilizar a tabela do IBGE), | Inteiro | |
| infcadendernomemun | Nome do município; | String | |
| infcadendercep | CEP; | Inteiro |
