Manual de integração

CONSULT VALID
EXCLUSIVO CONTRATO WHITE LABEL

ATUALIZAÇÃO: 11/2022
1 – CONSULT VALID – HABILITAÇÃO AUTOMÁTICA

Link para acesso ao WS é:

a. HOMOLOGAÇÃO: http://consultthis.com.br/ws/WSDLjH.php, a variável deve ser passada via

POST e deve conter o seguintes nome: wCadastro.

b. PRODUÇÃO: http://consultthis.com.br/ws/WSDLj.php. Após os testes de homologação, as

alterações na HOMOLOGAÇÃO serão transferidas para a PRODUÇÃO. O acesso dar-se-á da
mesma forma que ocorreu na HOMOLOGAÇÃO.

1.1 – Modelo de layout do ARQUIVO DE ENVIO (formato JSON)

{
"IDENTIFICACAO":
[{
"CNPJ":"17256512000116", "RTRIB":"3", "DATA":"2022-11-25", "HORA":"13:44"
}],
"CONTATO":
[{
"NOM_CONTATO":"LEONARDO LEITE", "eMAIL_CONTATO":"profleoleite@gmail.com", "DDDCEL":"31",
"NUMCEL":"997012234", "DDDFIX":"31", "NUMFIX":"322724781"
}],
"SOFTHOUSE":
[{
"CNPJ_SOFT":"14599029000146", "INTEGRACAO":"1"
}]
}

Rua José Cláudio Rezende, 300 - 3° andar - Estoril - CEP 30.494-230 - Telefone (31) 3567-1289
www.consultsi.com.br
1.2 – Detalhamento do layout do ARQUIVO DE ENVIO (formato JSON)

DESCRIÇÃO TIPO TAM REQ

"IDENTIFICAÇÃO": [{
"CNPJ": "", Número do CNPJ do cliente que fará uso do validador N 14 SIM
tributário Valid. ***
"UF": "", Sigla da Unidade da Federação onde o estabelecimento está C 2 SIM
localizado.
"RTRIB": "", Indicador regime tributário da pessoa jurídica: C 1 SIM
1 – Simples nacional
2 – Lucro Presumido
3 – Lucro Real
""DATA: "", Data da geração do arquivo JSON, formato YYYY-mm-dd D 10
"HORA": ""}], Horário da geração do arquivo JSON, formato HH:mm:ss H 8

"CONTATO": [{ DADOS DO RESPONSÁVEL NA EMPRESA CLIENTE

"NOM_CONTATO":"", Nome do contato que irá responder pelos assuntos do C 80 SIM
validador fiscal e tributário na empresa cliente.
"eMAIL_CONTATO":"", Email do contato na empresa cliente C 160 SIM
"DDDCEL":"", DDD do celular do contato na empresa cliente N 3 SIM
"NUMCEL":"", Número do celular do contato na empresa cliente N 9 SIM
"DDDFIX":"", DDD do telefone fixo do contato na empresa cliente N 3
"NUMFIX":""}] Número do telefone fixo do contato na empresa cliente N 8

"SOFTHOUSE": [{ DADOS DA EMPRESA PARCEIRA

"CNPJ_SOFT":"", Número do CNPJ do parceiro com a Consult. N 14 SIM
"INTEGRACAO":""}] Código que identifica qual software será realizada a n 1 SIM
integração:
1 - Valid

*** Deve-se considerar os ‘0’ (Zeros) à esquerda.

O Valid verifica se os campos REQ (Requeridos) foram informados ou não, a ausência de um dado irá
resultar no descarte do registro, uma mensagem de erro será retornada.

Rua José Cláudio Rezende, 300 - 3° andar - Estoril - CEP 30.494-230 - Telefone (31) 3567-1289
www.consultsi.com.br
1.3 Tipos de mensagens de RETORNO

a) ARQUIVO JSON SEM INFORMAÇÃO

{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:32:39"
},
"ERRO": [
{
"COD_INTERNO": "400",
"MSGERR": " ARQUIVO JSON SEM INFORMAÇÃO"
}
]}

b) ARQUIVO JSON CORROMPIDO

{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:32:39"
},
"ERRO": [
{
"COD_INTERNO": "401",
"MSGERR": "ARQUIVO JSON CORROMPIDO"
}
]}
c) CNPJ NÃO INFORMADO CLIENTE/SOFTHOUSE
{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:32:39"
},
"ERRO": [
{
"COD_INTERNO": "402",
"MSGERR": " CNPJ NÃO INFORMADO CLIENTE/SOFTHOUSE"
}
]}

d) CNPJ CLIENTE JÁ CADASTRADO / SOFTHOUSE INATIVO NO SISTEMA

{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:32:39"
},
"ERRO": [
{
"COD_INTERNO": "403",
"MSGERR": "CNPJ CLIENTE JÁ CADASTRADO / SOFTHOUSE INATIVO NO SISTEMA"
}
]}

Rua José Cláudio Rezende, 300 - 3° andar - Estoril - CEP 30.494-230 - Telefone (31) 3567-1289
www.consultsi.com.br
e) CNPJ INVÁLIDO NA RECEITA FEDERAL
{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:32:39"
},
"ERRO": [
{
"COD_INTERNO": "404",
"MSGERR": "CNPJ INVÁLIDO NA RECEITA FEDERAL"
}
]}
f) REGIME TRIBUTÁRIO INVÁLIDO
{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:32:39"
},
"ERRO": [
{
"COD_INTERNO": "405",
"MSGERR": " REGIME TRIBUTÁRIO INVÁLIDO"
}
]}

g) VALIDAÇÃO DADOS DE CONTATO

{"CABECALHO": {
"STATUS": "ERRO",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:48:53"
},
"ERRO": [
{
"COD_INTERNO": "406",
"MSGERR": "NOME CONTATO NÃO INFORMADO"
},
{
"COD_INTERNO": "406",
"MSGERR": "eMAIL INFORMADO INVALIDO"
},
{
"COD_INTERNO": "406",
"MSGERR": "CELULAR NÃO INFORMADO"
}
]}

Rua José Cláudio Rezende, 300 - 3° andar - Estoril - CEP 30.494-230 - Telefone (31) 3567-1289
www.consultsi.com.br
h) CADASTRO REALIZADO COM SUCESSO
{"CABECALHO": {
"STATUS": "OK",
"DT_TRANS": "2022-11-29",
"HR_TRANS": "16:48:53"
}}

Rua José Cláudio Rezende, 300 - 3° andar - Estoril - CEP 30.494-230 - Telefone (31) 3567-1289
www.consultsi.com.br