Manual de Integração 2.2.28
Manual de Integração 2.2.28
Manual de Integração 2.2.28
versão 2.2.28
Histórico de revisões
WS15
Inclusão novos objeto:
Responsavel
EnderecoContabil
WS01
Novo Objeto
ClassificacaoRisco
WS02
Novo Objeto
classificacao_risco
InscricaoAdicional
EnderecoSubstitutoTributario
DadosItcmd
DadosDoacao
Alteração do tipo
nu_participacao_quotas para Integer
nu_valor_quotas alterar para Integer
Aumento do tamanho
ds_registro_cartorio para 100 caracteres
WS29
1
Inclusão de novos campos no objeto dados_resposta
id
co_tipo_modelo_documento
WS33
Incluída informação no limite de taxas retornadas.
WS01
Alteração do Campos no objeto Endereco
nu_area_total String(11) para String(15)
nu_area_utilizada String(11) para String(15)
WS02
Inclusão no novo campos no objeto Empresa:
filiais
WS04, WS06
Aumento do campo: ds_nome_arquivo para String(400)
WS32
Aumento do campo co_tributo para String(13)
UF
Atualizado o código da UF “MS “
2
2.2.26 19/11/2019 Novos Serviços WS07, WS25 e WS26 Maxwell
Azevedo
WS02
- Adição de novos itens na tabela de apoio do campo
nu_tipo_arquivo:
4 - Capa de Processo - Enquadramento
5 - Capa de Processo - Requerimento Empresário
6 - Capa de Processo - Contrato Social
8 - Capa de Processo - Procuração
10 - Capa de Processo - Emancipação
11 - Consolidação
12 - Rerratificação
13 - Capa de Processo - Consolidação
14 - Capa de Processo - Rerratificação
15 - Documento de Extinção
16 - Distrato
17 - Ata de Liquidação
18 - Ata de Assembleia Geral de Constituição
20 - Ata de Extinção de Filial
21 - DTE
22 - Documento de Interesse
23 -Livro
24 - Termo de Autenticação
25 - Carta
26 - Balanço
27 - Comunicado
28 - Declaração
30 - Ofício Judicial
31 - Ofício Administrativo
32 - Revogação de Procuração
2.2.25 09/10/2019 Alteração e novos campos dos campos no WS02 Erica Helena
ClausulaContratual
dados_conselheiro passando a ser um array do objeto
Conselheiro.
IntegralizacaoCapital
bens_movel_imovel passando a ser um array do objeto
BensMovelImovel.
SimplesNacional
Foram removidos os campos dt_inclusao e dt_exclusao e
adicionados os campos periodo_simples, periodo_mei
ClausulaContratual
Ajusta nomenclatura do campo: integracalizacao_capital,
is_exlusao_reuniao_assembleia
3
Ajusta nomenclatura do objeto: IntegralizacaoCapital
Novos objetos
PeriodoSimples
- dt_inclusao
- dt_exclusao
PeriodoMei
- dt_inclusao
- dt_exclusao
WS02
- Adição de novo item na tabela de apoio do campo
co_tipo_pratica_comercio_exterior: 4 - Não pratica comércio
exterior
WS06
- Alteração do tamanho do campo ds_nome_arquivo;
- Alteração no tamanho ds_retorno_exigencia;
WS31
- Adição do objeto endereco para CRC no retorno da
requisição;
WS02
Removida a obrigatoriedade dos campos
DadosSolicitacao
- dt_solicitacao
- is_vinculado
- solicitante
DadosRegistro
- co_protocolo
- co_ato
- eventos
Empresa
- co_enquadramento
- co_tipo_unidade
- ds_objeto_social
- responsavel_legal
- dt_assinatura_ata
- dt_constituicao
- dt_inicio_atividades
4
Endereco, EnderecoResponsavelContabil
- co_cep
- co_tipo_logradouro
- ds_tipo_logradouro
- ds_endereco
- nu_numero
- ds_bairro
- co_municipio_tom
NaturezaImovel
- co_tipo_natureza
FormaAtuacao
- co_forma_atuacao
ResponsavelContabil
- co_cpf_cnpj
- ds_nome
- ds_email
- nu_ddd_telefone
- nu_telefone
- nu_ddd_celular
- nu_celular
- dados_conselho
- endereço
Responsavel
- nu_cpf
- ds_nome
- ds_email
- nu_ddd_telefone
- nu_telefone
- nu_ddd_celular
- nu_celular
- dados_conselho
- endereco
DadosConselho
- co_uf_crc
- nu_sequencia
- dt_registro
- co_tipo_classificacao_crc
- nu_tipo_crc
- nu_crc
Socio
- co_tipo_pessoa
- nu_cpf_cnpj
- ds_nome
- qualificacoes
5
PessoaFisica
- dt_nascimento
- co_nacionalidade
- co_sexo
EnderecoSocio
- co_pais
Empresa
- nu_cnpj_matriz
- nu_registro_matriz
Atividade
- is_exerce_no_endereco
ResponsavelContabil
- responsável
Socio
- dados_pessoa_fisica
- dados_pessoa_juridica
PessoaFisica
- co_estado_civil
EnderecoSocio
- co_municipio
- co_municipio_tom
- co_uf
- co_cep
- co_tipo_logradouro
- ds_tipo_logradouro
- ds_endereco
- nu_numero
- ds_bairro
- ds_endereco_completo
Naturezaimovel
- nu_inscricao
6
DadosRegistro
- nu_arquivamento String(11) para String(14)
Socio
- ds_nome String(200) para String(400)
EnderecoSocio
- ds_cidade_exterior
Empresa
- ds_caixa_postal
- nu_cnpj_sucessora
- simples_nacional
- dt_termino_exercicio_social
- dt_termino_integralizacao
- dt_inicio_integralizacao
- clausula_contratuais
PessoaFisica
- co_cpf_conjuge
- ds_nome_conjuge
SimplesNacional
- is_indicador_simples_nacional
- dt_inclusao
- dt_exclusao
- is_indicador_mei
ClausulaContratuais
- is_regencia_supletiva
- is_exclusao_extrajudicial
- is_exclusao_reuniao_assembleia
- is_foro_matriz
- is_foro_arbitral
- co_uf
- co_municipio_foro
- dt_termino_exercicio
- integralizacao_capital
- is_conselho_fiscal
- dados_conselheiro
IntegralizacaoCapital
- nu_capital_integralizado_dinheiro
- bens_movel_imovel
Conselheiro
7
- co_cpf_conselheiro
- ds_nome_conselheiro
- co_cpf_suplente
- ds_nome_suplente
BensMovelImovel
- ds_tipo_bem
- ds_descricao
- nu_valor
- co_cpf_cnpj_titular
- ds_nome_titular
- dt_aquisicao
- co_inscricao_municipal
- nu_area_imovel
- ds_registro_cartorio
- ds_nome_cartorio
- endereco
EnderecoImovel
- co_cep
- ds_endereco
- co_numero
- ds_complemento
- ds_bairro
- co_uf
- co_municipio
WS04
Removida obrigatoriedade dos campos
- ds_nome_empresarial
WS20
Aumentado o tamanho do campo:
- ds_nome_aprovado String(300) para String(400)
WS21
Adcionada validações dos campos:
- dt_resposta
- dt_validade
8
- Adição de momento de envio do recurso para cancelamento
do processo pela Junta Comercial, observar a descrição do
serviço;
WS01 e WS02
- Correção no tamanho no manual do campo ds_pergunta para
500 no objeto questionario;
WS03 e WS04
- Alteração no tamanho do campo ds_pergunta para 800 no
objeto questionario.
WS02
- Alteração na validação do campo ds_endereco dentro do
objeto EnderecoSocio quando MEI.
WS02
- Ajustando o tamanho dos campos “ds_nome_empresarial” de
144 para 200 caracteres;
- Ajustando o tamanho do campo “ds_nome” dentro dos arrays
“Solicitante”, “ResponsavelContabil”, “Responsavel”, “Socio” e
“ResponsavelLegal” de 100 para 200 caracteres;
WS04
9
- Ajustando o tamanho dos campos “ds_nome_empresarial”
de 144 para 200 caracteres;
WS31
- Ajustando o tamanho do campo “ds_nome” dentro dos arrays
“DadosCRC” e “Responsavel” de 100 para 200 caracteres;
WS32
- Ajustando o tamanho dos campos “ds_nome” de 100 para
200 caracteres;
WS02
- Ajuste na regra para envio do campo nu_numero no objeto
de endereço da empresa e no endereço do sócio para o
serviço WS02 quando MEI; *
- Ajuste na descrição nu_valor_participacao no objeto
qualificação do WS02 de #############,## para
#############.##; *
- Ajuste no objeto documento_identificacao onde não será
mais obrigatório o objeto no WS02; *
- Ajuste do tamanho dos campos nu_registro,
nu_registro_matriz, nu_registro_anterior do objeto empresa
do WS02 e nu_registro do objeto dados_pessoa_juridica do
ws02; *
- Ajuste no tamanho do campo nu_cpf no objeto solicitante e
responsavel do WS02 para 11; *
- Ajuste no tipo do atributo endereço
EnderecoResponsavelEmpresa para
EnderecoResponsavelContabil no WS02, a alteração está
dentro do objeto responsavel -> responsavel_contabil do
ws02; *
- Ajuste no Tipo do nu_participacao_quotas e
nu_valor_quotas de Integer para Bigint no WS02; *
- Ajuste no tamanho do campo ds_complemento de 156 para
162 nos serviços WS01 e WS02; *
10
- Ajuste no tamanho e formato do campo nu_ano_registro, de
10 para 4 e no formato de YYY-MM-DD para YYYY no WS02;
*
- Adicionado o atributo ds_nome, nu_ddd_celular e
nu_celular dentro do objeto responsavel que está dentro
objeto responsavelContabil no WS02;
- Adicionado os atributos ds_email, nu_ddd_telefone,
nu_telefone, nu_ddd_celular, nu_celular para o
responsavelContabil no WS02;
- Adicionado os campos is_documento_provisorio e
dt_documento_validade dentro do objeto
documento_identificacao localizado no objeto PessoaFisica
do objeto Socio no WS02;
- Adicionado o campo is_espolio dentro do objeto
PessoaFisica no objeto Socio no WS02;
- Adicionado o campo co_enquadramento no objeto
PessoaJuridica dentro do objeto sócio no WS02;
WS21
- Ajuste nas situações permitidas para status resposta no
WS21; *
WS31
- Ajuste do objeto EnderecoResponsavelEmpresa para
EnderecoResponsavelContabil no ws31 e o tipo do atributo
endereço EnderecoResponsavelEmpresa para
EnderecoResponsavelContabil ws31; *
- Adicionado o campo ds_nome para o objeto
RESPONSAVEL, localizado dentro do objeto DadosCRC no
WS31;
WS32
- Ajuste no tipo nu_nosso_numero e nu_documento de
Integer para String no response body do WS32; *
- Adicionado os atributos co_tributo, co_ tributo_detalhe,
co_municipio, endereco_sacado, co_pais e
ds_endereco_completo no request do WS32 e alteração da
URL;
WS33
- Adicionado os atributos ds_observacao e status_taxa no
response do WS33;
Tabela de Erros
- Adicionado na tabela Tabela de erros específicos do WS um
código para Nosso número Inexistente;
- Adicionado novo erro 202 9010 Requisição já processada
na tabela de erros comuns;
11
- Adicionados novos erros específicos 9916, 9917 e 9918
para o WS21 na tabela de erros específicos;
2.2.14 13/04/2018 - Adicionado atributo co_uf do responsável contábil no WS02 Jafet Gomes
e WS31.
2.2.11 23/02/2018 - Retirado os códigos de retorno de erro 9912, 9913 e 9914 Genison
da Tabela de erros específicos; Ribeiro/Jafet
- Alterado formato de autenticação dos serviços; Gomes
- Alteração em todos os objetos de envio de arquivo;
- Adicionado atributo arquivos_entidade_registro no WS02;
- Removidos serviços WS25 e WS26. O download de
arquivos será realizado através de serviço único WS24;
- Removida obrigatoriedade dos campos nu_ddd_telefone,
nu_telefone, ds_email do objeto Solicitante;
- Removida obrigatoriedade dos campos nu_ddd_telefone,
nu_telefone e nu_capital_social do objeto Empresa;
12
- Removida obrigatoriedade dos campos co_tipo_imovel,
nu_area_total, nu_area_utilizada e natureza_imovel do objeto
Endereço (da empresa);
- Removida obrigatoriedade do campo
is_exerce_no_endereco do objeto Atividade. Adicionada
observação sobre obrigatoriedade;
- Removida obrigatoriedade dos campos ds_email,
nu_ddd_telefone, nu_telefone do objeto Socio;
- Removida obrigatoriedade do campo endereco do objeto
Socio;
- Removida obrigatoriedade dos campos nu_ddd_telefone,
nu_telefone e ds_email do objeto ResponsavelLegal;
- Campo co_protocolo_registro alterado para envio de vários
protocolos no WS05;
2.2.9 08/02/2018 - Alterado tipo de dado e formato do complemento no WS30. Genison Ribeiro
2.2.8 07/02/2018 -Alterado nome dos campos do response – 201 dos serviços Edmilson Mota /
WS01, WS02, WS03, WS04, WS05, WS06, WS20, WS21 e Jafet Gomes
WS22.
-Adicionado o parâmetro <co_protocolo_redesim> no request
do WS24, WS25 e WS26;
-Alterado o tipo do campo “nu_autorizacao” no WS01 e
WS02;
-Alterado do campo “nu_id” para “id” DadosConsultaPrevia -
WS01, DadosSolicitacao - WS02, DadosDocumento - WS03,
DadosSolicitacaoDocumento - WS04,
DadosCancelamentoSolicitacao - WS05 e
DadosRetornoExigencias - WS06;
-Retirado duplicidade de campos de co_uf_naturalidade no
WS02;
-Retirada a obrigatoriedade do campo “is_empresa_lider” do
WS02;
-Adicionada a obrigatoriedade nos campos “co_estado_civil”,
“dt_nascimento”, “co_nacionalidade”, co_sexo e no objeto
“documento_identificacao” do WS02;
-Adicionado objeto substituto_tributario no objeto Empresa do
WS02;
-Correção nome do campo de "dt_solicitacao" para
"is_vinculado" no objeto "DadosSolicitacao" do WS02.
-Alterado obrigatoriedade do campo “utilizacao_solo” de “S”
para “N”, caso seja informado “Não” na coleta de dados será
“Nulo”, ref. objeto “DadosConsultaPrevia” do WS01 e
“Empresa” do WS02.
-Alterado obrigatoriedade do campo “co_status_empresa” e
“co_situacao_empresa” de “S” para “N” e acrescentando a
observação “Exclusivo para Junta Comercial.” no objeto
“Empresa” do WS02.
13
2.2.7 30/01/2018 -Removendo os atributos (“co_situacao_empresa” e Edmilson Mota
“co_status_empresa” ) do array DadosRegistro do WS02.
-Adicionando os atributos “co_situacao_empresa” e
“co_status_empresa” no objeto “Empresa” do WS02.
-Adicionando “co_uf” no objeto “Endereco” do WS01.
-Alterado o nome do atributo “nu_seq_pessoa” do objeto
“Empresa” do WS02.
-Alterado o nome do atributo “co_utilizacao_solo” do objeto
“UtilizacaoSolo” do WS01.
-Alterado o nome do atributo “co_tipo_utilizacao_solo” , para
“co_utilizacao_solo” em WS01 E WS02 (só na coluna
“descrição”).
-Alterado o tipo do atributo “ds_orgao_expedidor” de Integer,
para String(30).
2.2.6 18/01/2018 - Correção nos códigos http dos retornos de erros 9005 e Jafet Gomes
9008.
- Alteração do tipo do objeto do questionário para o tipo
Pergunta, nos serviços WS01, WS02, WS03 e WS04.
- Adição do campo nu_id nos objetos DadosConsultaPrevia -
WS01, DadosSolicitacao - WS02, DadosDocumento - WS03,
DadosSolicitacaoDocumento - WS04,
DadosCancelamentoSolicitacao - WS05 e
DadosRetornoExigencias - WS06 para informar o campo
indicador do dado salvo na base do órgão integrado.
2.2.5 15/01/2018 -Ajustes em campos com letras maiúsculas, acentos e Jafet Gomes
caracteres especiais no WS01 (controle, solicitante,
atividades, eventos, socios, endereco).
-Correção do tipo do campo is_atividade_principal para
Boolean do objeto AtividadeEspecializada do WS01.
-Correção da url do WS30 com caractere especial.
-Adicionados tipos de retorno de erro específicos para os
serviços WS24, WS25, WS26, WS30 e WS31.
-Ajustes nas urls e descrição dos parâmetros de request dos
serviços de verbo HTTP GET.
-Adicionado o campo ds_orgao no objeto controle dos
serviços WS01, WS20, WS21 e WS22.
-Alteração no tipo de verbo HTTP para POST nos serviços
WS20, WS21 e WS22.
-Retirada do parâmetro nu_identificador_orgao do request e
acréscimo de um objeto de tipo array de detalhamentos do
cep dentro do objeto cep do WS30.
-Alteração no tipo de dado para String e adequado o nome do
campo para nu_latitude e nu_longitude no objeto Point dos
serviços WS01 e WS02.
2.2.4 11/01/2018 Criar o Objeto do tipo POINT (cordenadas geográficas). Edmilson Mota
O campo “co_tipo_modelo_documento” será obrigatório, caso
“is_retorno_documento” = true.
14
2.2.3 02/01/2018 Alterado o tipo de CAMPO para armazenamento das Marcus Bruno /
Coordenadas Geográficas (latitude e longitude), para o tipo Edmilson Mota /
POINT (Geometry 16 bytes); Philipe
Fernandes
Criação das tabelas específicas para Response (Específica e
Comum);
Remoção dos campos ds_latitude e ds_longitude (substituído
por coordenada_geografica);
Trocar “URL:HTTP” por “URL:HTTPS”;
Trocar “Verbo HTTP: PATCH” por “Verbo HTTP: PUT”
Remover o campo “ds_orgao” – Objeto Controle - WS01;
Removendo o array de sublotes do WS30;
Transformando em array o cep do WS30;
Adicionando os atributos co_situacao_empresa e
co_status_empresa no array DadosRegistro do WS02;
Removendo o atributo ds_atividade do array
AtividadeEspecializada do serviço WS02;
Incluir cochetes no tipo “Questionario[]” no serviço WS01
Trocar nome do objeto “Pergunta[]” por “Questionario[]” no
WS02;
Correção do tipo String(5) para Boolean, nos campos que
são lógicos (true / false).
Remover campo “ds_atividade” String(250) -Descrição da
atividade especializada.
Incluir observação “atividades_especializadas” OBS: Uso
exclusivo da prefeitura.
2.2.2 20/12/2017 Aumentando o tamanho dos campos do Objeto Social e do Marcus Bruno
nu_inscricao;
WS01 – Atributo: nu_cnpj_entidade_registro_matriz;
WS02 – Atributo: nu_cnpj_entidade_registro_matriz;
WS02 – Removendo atributo co_situacao_empresa;
Adicionando regra no atributo formas_atuacao;
Transformando os dados_entidade_registro em Array;
Padronizando o tamanho dos campos de e-mail para 150
caracteres;
2.2.1 14/12/2017 Código de sucesso alterado para os serviços que utilizam Genison Ribeiro
POST e PATCH
2.2.0 08/12/2017 Objetos contendo arquivos (tipo File) foram alterados; Genison Ribeiro
Adicionados serviços WS24, WS25 e WS26 responsáveis
pela disponibilização de arquivos anexados ao processo;
Objetos de retorno de todos os serviços alterados;
URI de serviços alteradas;
2.0.10 30/11/2017 Alteração das URIs dos serviços disponibilizados no Genison Ribeiro
SIGFÁCIL.
15
2.0.9 22/11/2017 WS02 – Atributos is_empresa_satelite, Genison Ribeiro
nu_cnpj_operador_logistico, is_operador_logistico e
co_tipo_pratica_comercio_exterior adicionados ao objeto
Empresa.
2.0.8 21/11/2017 WS02 - Atributo co_uf adicionado ao endereço de empresa e Genison Ribeiro
sócio;
WS02 - Atributo dados_empresa passa a ser
dados_solicitacao;
WS02 - Objeto DadosEmpresa passa a ser DadosSolicitacao;
WS02 - Obrigatoriedades redefinidas no endereço dos sócios
(EnderecoSocio) para atender o envio de endereço de sócios
residentes no exterior;
WS02 - Atributo ds_endereco_completo adicionado no
endereço dos sócios (EnderecoSocio) para atender o envio
de endereço de sócios residentes no exterior;
WS02 - Atributo dados_ato_legal adicionado.
2.0.6 16/11/2017 WS03, WS04 - Atributo co_cnpj alterados para nu_cnpj, Genison Ribeiro
utilizando o padrão dos demais serviços.
2.0.5 09/11/2017 WS02 - Atributo co_uf adicionado nos objetos Endereco da Genison Ribeiro
Empresa e Socio;
WS02 - Atributo dt_autenticacao adicionado no objeto
DadosEmpresas;
WS01, WS02: Atributo ds_latitude e ds_longitude
adicionados nos objetos de Endereco;
Adicionados verbos HTTP a serem utilizados em cada
recurso;
2.0.2 20/10/2017 WS02 - Adicionado atributo opcional co_nacionalidade nos Genison Ribeiro
dados de pessoa física do objeto Socio.
2.0.1 16/10/2017 WS02, WS03 - Adicionado atributo opcional questionario. Genison Ribeiro
16
Sumário
1. Introdução 22
2. Padrão dos serviços 23
3. Segurança 24
4. Recebimento de dados pelos órgãos integrados 25
4.1. WS01 - Solicitação de consulta prévia 26
4.1.1. Descrição 26
4.1.2. Dados adicionais 26
4.1.3. Request 26
4.1.4. Response 32
4.1.4.1. Requisição Mal Formada 400 - (BAD REQUEST) 32
4.1.4.1.1. Response - Tabela de erros específicos do WS01 33
4.1.4.1.2. Response - Tabela de códigos de retorno comuns 33
4.1.4.2. Sucesso – 201 (Resource Created) 33
WS02 – Dados de empresas 33
4.1.5. Descrição 33
4.1.6. Dados adicionais 34
4.1.7. Request 34
4.1.8. Response 51
4.1.8.1.1. Response - Tabela de códigos de retorno comuns 51
4.1.8.2. Sucesso – 201 (Resource Created) 51
4.2. WS03 – Mudança de status de documentos 52
4.2.1. Descrição 52
4.2.2. Dados adicionais 52
4.2.3. Request 52
4.2.4. Response 53
4.2.4.1.1. Response - Tabela de códigos de retorno comuns 54
4.2.4.2. Sucesso – 201 (Resource Created) 54
4.3. WS04 - Solicitação de documentos 54
4.3.1. Descrição 54
4.3.2. Dados adicionais 54
4.3.3. Request 54
4.3.4. Response 56
17
4.3.4.1.1. Response - Tabela de códigos de retorno comuns 57
4.3.4.2. Sucesso – 201 (Resource Created) 57
4.4. WS05 - Cancelamento de solicitação 57
4.4.1. Descrição 57
4.4.2. Dados adicionais 57
4.4.3. Request 57
4.4.4. Response 58
4.4.4.1.1. Response - Tabela de códigos de retorno comuns 59
4.4.4.2. Sucesso – 201 (Resource Created) 59
4.5. WS06 - Retorno de exigências 59
4.5.1. Descrição 59
4.5.2. Dados adicionais 59
4.5.3. Request 59
4.5.4. Response 61
4.5.4.1.1. Response - Tabela de códigos de retorno comuns 61
4.5.4.2. Sucesso – 201 (Resource Created) 61
4.6. WS07 – Dados Simples Nacional 62
4.6.1. Descrição 62
4.6.2. Dados adicionais 62
4.6.3. Request 62
4.6.4. Response 63
4.6.4.1.1. Response - Tabela de códigos de retorno comuns 64
4.6.4.2. Sucesso – 201 (Resource Created) 64
4.7. WS15 – Dados Produtor Rural 65
4.7.1. Descrição 65
4.7.2. Dados adicionais 65
4.7.3. Request 65
4.7.4. Response 70
4.7.4.1.1. Response - Tabela de códigos de retorno comuns 71
4.7.4.2. Sucesso – 201 (Resource Created) 71
5. Recebimento de dados pelo Integrador Estadual 71
5.1. WS20 - Resposta de consulta prévia 72
5.1.1. Descrição 72
5.1.2. Dados adicionais 72
5.1.3. Request 73
18
5.1.4. Response 74
5.1.4.1.1. Response - Tabela de erros específicos do WS20 74
5.1.4.1.2. Response - Tabela de códigos de retorno comuns 75
5.1.4.2. Sucesso – 201 (Resource Created) 75
5.2. WS21 - Resposta de solicitação de documentos e baixa 75
5.2.1. Descrição 75
5.2.2. Dados adicionais 75
5.2.3. Request 75
5.2.4. Response 77
5.2.4.1.1. Response - Tabela de erros específicos do WS21 78
5.2.4.1.2. Response - Tabela de códigos de retorno comuns 79
5.2.4.2. Sucesso – 201 (Resource Created) 79
5.3. WS22 - Andamento da solicitação 79
5.3.1. Descrição 79
5.3.2. Dados adicionais 80
5.3.3. Request 80
5.3.4. Response 81
5.3.4.1.1. Response - Tabela de erros específicos do WS22 81
5.3.4.1.2. Response - Tabela de códigos de retorno comuns 82
5.3.4.2. Sucesso – 201 (Resource Created) 82
5.4. WS23 – Consulta dados DBE 82
5.4.1. Descrição 82
5.4.2. Dados adicionais 82
5.4.3. Request 83
5.4.4. Response 83
5.4.4.1.1. Response - Tabela de erros específicos do WS23 83
5.4.4.1.2. Response - Tabela de códigos de retorno comuns 84
5.4.4.2. Sucesso – 200 (success) 84
5.5. WS24 – Busca de arquivos 84
5.5.1. Descrição 84
5.5.2. Dados adicionais 84
5.5.3. Request 84
5.5.4. Response 85
5.5.4.1.1. Response - Tabela de códigos de retorno comuns 85
5.5.4.1.2. Response – Tabela de erros específicos do WS24 85
19
5.5.4.2. Sucesso – 200 (success) 85
5.6. WS25 – Busca de dados Simples Nacional 86
5.6.1. Descrição 86
5.6.2. Dados adicionais 86
5.6.3. Request 86
5.6.4. Response 86
5.6.4.1.1. Response - Tabela de códigos de retorno comuns 87
5.6.4.1.2. Response – Tabela de erros específicos do WS25 87
5.6.4.2. Sucesso – 200 (success) 87
5.7. WS26 – Marcação de CNPJ de interesse 88
5.7.1. Descrição 88
5.7.2. Dados adicionais 88
5.7.3. Request 88
5.7.4. Response 89
5.7.4.1.1. Response - Tabela de códigos de retorno comuns 89
5.7.4.2. Sucesso – 201 (Resource Created) 89
5.8. WS29 – Envio Dados Processo 90
5.8.1. Descrição 90
5.8.2. Dados adicionais 90
5.8.3. Request 90
5.8.4. Response 91
5.8.4.1.1. Response - Tabela de códigos de retorno comuns 91
5.8.4.2. Sucesso – 201 (Resource Created) 91
5.9. WS42 – Recupera Dados Empresa 92
5.9.1. Descrição 92
5.9.2. Dados adicionais 92
5.9.3. Request 92
5.9.4. Response 92
5.9.4.1. Sucesso – 201 (Resource Created) 92
5.9.4.2. Response Erro 98
5.9.4.2.1. Response - Tabela de códigos de retorno comuns 98
6. Serviços complementares fora do escopo da REDESIM 98
6.1. WS30 – Consulta de endereço 99
6.1.1. Descrição 99
6.1.2. Dados adicionais 99
20
6.1.3. Request 99
6.1.4. Response 99
6.1.4.1.1. Response - Tabela de códigos de retorno comuns 100
6.1.4.1.2. Response – Tabela de erros específicos do WS30 100
6.1.4.2. Sucesso – 200 (success) 100
6.2. WS31 – Consulta dados do CRC 101
6.2.1. Descrição 101
6.2.2. Dados adicionais 101
6.2.3. Request 101
6.2.4. Response 102
6.2.4.1.1. Response - Tabela de códigos de retorno comuns 102
6.2.4.1.2. Response – Tabela de erros específicos do WS31 102
6.2.4.2. Sucesso – 200 (success) 102
6.3. WS32 – Gerar documento de arrecadação 104
6.3.1. Descrição 104
6.3.2. Dados adicionais 104
6.3.3. Request 105
6.3.4. Response 105
6.3.4.1.1. Response - Tabela de códigos de retorno comuns 106
6.3.4.2. Sucesso – 200 (success) 106
6.4. WS33 – Busca pagamentos 107
6.4.1. Descrição 107
6.4.2. Dados adicionais 107
6.4.3. Request 107
6.4.4. Response 107
6.4.4.1.1. Response - Tabela de códigos de retorno comuns 108
6.4.4.2. Sucesso – 200 (success) 108
7. Tabelas 108
21
1. Introdução
Dúvidas sobre o processo devem ser direcionadas a nossa equipe técnica, através do e-
mail [email protected] ou através do telefone (83) 3031-0123.
22
2. Padrão dos serviços
Os serviços descritos abaixo deverão ser serviços RESTful. Todas as orientações acerca
de validações e endpoints devem ser implementados de acordo com o que consta neste
manual.
Como padrão, para os requests e retornos dos serviços deverá ser utilizado JSON
(JavaScript Object Notation).
Os serviços de envio de dados aos órgãos integrados deverão ser implementados de
forma que se algum parâmetro adicional for passado, o mesmo não seja rejeitado. Isto é
necessário para que os órgãos recebam as informações normalmente mesmo se campos
adicionais forem adicionados pela Vox Tecnologia ao longo do avanço dos leiautes de
integração.
23
3. Segurança
Os tokens e configuração de autorização dos serviços permitidos pelo órgão deverão ser
solicitados à Vox Tecnologia previamente.
24
4. Recebimento de dados pelos órgãos integrados
Sempre que existir necessidade de informação aos órgãos integrados sobre solicitações
de consulta prévia e documentos ou de atualização do órgão sobre o andamento pelos
outros órgãos interessados no processo ou pelo cliente, será disparado consumo a um
dos serviços listados abaixo, cujo desenvolvimento e manutenção são de
responsabilidade do órgão integrado.
Todos os dados enviados através dos serviços são os dados atualizados da empresa.
No caso do serviço WS01 – Solicitação de consulta prévia são os dados consolidados de
inscrição ou alteração da empresa. Por exemplo, se uma empresa solicita a remoção de
atividades exercidas, as atividades enviadas serão o conjunto final após a alteração ser
realizada.
No caso do serviço WS02 – Dados de empresas, os dados enviados serão os atualizados,
exceto o quadro societário, que indicará a data de saída do
sócio/representante/administrador que foi realizada naquele evento.
Cada órgão integrado irá utilizar um conjunto de serviços diferentes de acordo com sua
responsabilidade e necessidades no processo. É possível verificar a utilização dos
serviços de acordo com o perfil do órgão conforme tabela abaixo:
25
PERFIL
SERVIÇO Meio Junta
Prefeitura Bombeiros VISA SEFAZ Cartório OAB
Ambiente Comercial
WS01 -
Solicitação de x x x
consulta prévia
WS02 - Dados de
x x x x x x x x
empresas
WS03 - Mudança
de status de x x x x x
documentos
WS04 -
Solicitação de x x x x x
documentos
WS05 -
Cancelamento de x x x x
solicitação
WS06 - Retorno
x x x x x
de exigências
WS07 – Dados
x x x x x
Simples Nacional
Tabela 1 – Serviços de envio de dados aos órgãos integrados x necessidade por perfil
4.1.1. Descrição
Serviço que possui a finalidade de informar ao órgão responsável pelas análises de
viabilidade (nome e localização) que uma solicitação foi realizada no Integrador
Estadual. A fila para envio através deste serviço será incrementada sempre que uma
solicitação de evento que necessite consulta de viabilidade for realizada.
URL: https://<url-do-orgao-integrado>/v1/integracao/consultas-previas
Verbo HTTP: POST
4.1.3. Request
26
Request Body
Controle
DadosConsultaPrevia
27
Array de objetos do tipo Atividade,
atividades Atividade[] - S listando as atividades da empresa.
Array de objetos do tipo EventoRedesim,
contendo os eventos REDESIM
eventos EventoRedesim[] - S solicitados.
Código da natureza jurídica da empresa
co_natureza_juridica String 5 S da solicitação. Ver tabela
Código do enquadramento da empresa.
co_enquadramento Integer - S Ver tabela
Array de objetos do tipo Sócio listando os
socios Socio[] - N dados do sócio, titular ou empresário.
Objeto contendo os dados de endereço
endereco Endereco - S da empresa.
co_tipo_unidade Integer - S Código do tipo de unidade. Ver tabela
Array de objetos do tipo
FormaAtuacaoDto, listando as formas de
atuação da empresa.
Obrigatório quando o tipo de unidade for
formas_atuacao FormaAtuacao[] - N 0.
Objeto contendo dados referentes à
utilizacao_solo UtilizacaoSolo - N utilização do solo.
Array de objetos do tipo Pergunta
contendo as perguntas e respostas da
coleta adicional de dados da consulta
questionario Pergunta[] - N prévia.
CNPJ da entidade de registro que
empresa dará entrada ao processo.
Solicitante
28
ds_email String 150 N E-mail.
OpcaoNome
Atividade
AtividadeEspecializada
Socio
Endereco
FormaAtuacao
Point
30
Formato: -##.################ (negativo) ou
nu_longitude String 20 S ##.################ (positivo).
NaturezaImovel
UtilizacaoSolo
Arquivo
EventoRedesim
Pergunta
31
pergunta está disponível na funcionalidade de
“Perguntas” já que são dados dinâmicos,
definidos por cada órgão integrado.
ds_pergunta String 500 S Descrição da pergunta cadastrada no sistema.
ds_resposta String 5000 S Resposta da pergunta.
ClassificacaoRisco
PerguntaClassificacaoRisco
4.1.4. Response
Response
Erro
32
ds_valor String 2000 S Valor inválido
O município possui
Atividade CNAE possui especialização especialização de CNAE e o
400 9801
e apenas a raiz foi informada serviço não enviou este
detalhamento
Response body
Tipo OB Descrição
4.1.5. Descrição
Serviço responsável por informar aos órgãos interessados na solicitação todos os
dados atualizados¹ da empresa que realizou eventos de inscrição, alteração² ou
baixa, independente do tipo de evento que foi realizado.
Após a finalização do processo no órgão de registro ou quando houver um
cancelamento³ do processo e feita comunicação desse procedimento ao Integrador
Estadual, a instrução para envio dos dados será inserida em fila para distribuição a
todos os órgãos interessados.
Caso existam documentos que são emitidos automaticamente pelo sistema próprio do
órgão ou nos casos de deferimento de baixa automaticamente, o processo de emissão
deste documento ou baixa deve iniciar logo após o recebimento destas informações
da empresa e respondido ao integrador estadual através do WS21 – Resposta de
solicitação de documentos e baixa.
URL: https://<url-do-orgao-integrado>/v1/integracao/empresas
Verbo HTTP: POST
4.1.7. Request
Request Body
Controle
DadosSolicitacao
34
Data de autenticação do processo na
entidade de registro. Formato: YYYY-MM-
dt_autenticacao String 19 N DD HH:MM:SS
co_recibo_dbe String 10 N Código do recibo do DBE.
Código de identificação do DBE (apenas
nu_identificacao_dbe String 14 N números).
Código do tipo de entidade de registro
responsável pelo registro da empresa. Ver
co_tipo_entidade_registro Integer - S tabela
Número do CNPJ da entidade de registro
nu_cnpj_entidade_registro String 14 N responsável pelo registro da empresa.
CNPJ da entidade de registro do
nu_cnpj_entidade_registro_matriz String 14 N estabelecimento da matriz.
Campo indicando se é um processo
vinculado:
- true;
is_vinculado Boolean - N - false.
solicitante Solicitante - N Objeto contendo os dados do solicitante.
Array de objetos contendo os dados
referentes a atos e eventos utilizados pela
dados_entidade_registro DadosRegistro[] - N entidade de registro.
Array de objetos contendo os arquivos
arquivos_entidade_registro ArquivosRegistro[] - N autenticados pelo órgão de registro.
Array de objetos EventoRedesimDto
contendo os eventos realizados para a
eventos_redesim EventoRedesim[] - S empresa naquela solicitação
empresa Empresa - S Objeto contendo os dados da empresa.
dados_ato_legal DadosAtoLegal - N Objeto contendo os dados de ato legal.
Objeto contendo dados de questionários
adicionais coletados pelos diversos órgãos
questionario Pergunta[] - N envolvidos no processo.
Objeto contendo informações sobre a
classificação_risco ClassificacaoRisco - N classificação de risco.
Solicitante
35
DadosRegistro
ArquivosRegistro
Evento
EventoRedesim
Empresa
36
Número de registro anterior nos
casos em que existe evento de
nu_registro_anterior String 40 N alteração de natureza jurídica.
Número do sequencial da pessoa
jurídica no sistema da Junta
nu_seq_pessoa Integer - N Comercial (SIARCO).
Nome empresarial sem partícula de
ds_nome_empresarial String 400 S porte.
ds_nome_fantasia String 150 N Nome fantasia.
Número do CNPJ da matriz.
nu_cnpj_matriz String 14 N
nu_registro_matriz String 40 N Número de registro da Matriz.
nu_ddd_telefone String 4 N DDD do telefone.
Número do telefone (apenas
nu_telefone String 10 N números).
ds_email String 150 N Endereço de e-mail da empresa.
ds_sitio String 100 N Endereço do site da empresa.
Código da natureza jurídica da
co_natureza_juridica String 5 S empresa. Ver tabela
Código do enquadramento da
co_enquadramento Integer - N empresa. Ver tabela
Código do tipo de unidade. Ver
co_tipo_unidade Integer - N tabela
Array de objetos do tipo
FormaAtuacaoDto.
37
Data de início das atividades da
empresa.
dt_inicio_atividades String 10 N Formato: YYYY-MM-DD
Data de término de atividades da
empresa.
dt_termino_atividades String 10 N Formato: YYYY-MM-DD
Data de último arquivamento de
processo para a empresa.
dt_ultimo_arquivamento String 10 N Formato: YYYY-MM-DD
Informa se é uma empresa satélite:
- true;
is_empresa_satelite Boolean - N - false
CNPJ do operador logístico (apenas
números).
Obrigatório se is_empresa_satelite =
nu_cnpj_operador_logistico String 14 N true.
Informa se é um operador logístico:
- true;
is_operador_logistico Boolean - N - false
Tipo de prática de comércio exterior.
co_tipo_pratica_comercio_exterior Integer - N Ver tabela
Objeto contendo os dados do
responsavel_contabil ResponsavelContabil - N responsável contábil pela empresa.
Objeto contendo os dados de
endereco Endereco - N endereço da empresa.
Objeto contendo os dados de
utilizacao_solo UtilizacaoSolo - N utilização do solo pela empresa.
Descreve a situação da empresa na
entidade de registro. Ver tabela
co_situacao_empresa String 2 N Exclusivo para Junta Comercial.
Descreve o status da empresa na
entidade de registro. Ver tabela
co_status_empresa String 2 N Exclusivo para Junta Comercial.
Objeto contento os dados de
substituição tributária.
Obrigatório e enviado somente nos
substituto_tributario SubstitutoTributario - N eventos de substituição tributária.
nu_cnpj_sucessora String 14 N CNPJ da empresa sucessora.
Objeto contendo informações se a
empresa é optante pelo Simples
simples_nacional SimplesNacional - N nacional.
ds_caixa_postal String 20 N Caixa postal da empresa
Data do término do exercício social
da empresa.
dt_termino_exercicio_social String 10 N Formato: YYYY-MM-DD
Data de início da integralização do
capital.
dt_inicio_integralizacao String 10 N Formato: YYYY-MM-DD
Data de término da integralização do
dt_termino_integralizacao String 10 N capital.
38
Formato: YYYY-MM-DD
Objeto contendo os dados do
dados_itcmd DadosItcmd - N Imposto ITCMD da empresa.
Objeto contendo os dados referente
clausula_contratual ClausulaContratual - N a clausula contratual.
Array de objeto do tipo filiais,
filiais Filial[] - N contendo dados das filiais da matriz.
Endereco
NaturezaImovel
Point
39
Campo Tipo Tamanho OB Descrição
Formato: -##.################ (negativo) ou
nu_latitude String 20 S ##.################ (positivo).
Formato: -##.################ (negativo) ou
nu_longitude String 20 S ##.################ (positivo).
UtilizacaoSolo
Arquivo
FormaAtuacao
Atividade
AtividadeEspecializada
40
Campo Tipo Tamanho OB Descrição
co_cnae_especializada String 17 S Código CNAE especializado da prefeitura.
Indica se é a atividade principal:
- true;
is_atividade_principal Boolean - S - false.
Indica se a atividade é exercida no endereço:
- true;
is_exerce_no_endereco Boolean - S - false.
ResponsavelContabil
1 = Pessoa física;
nu_tipo_pessoa Integer - S 2 = Pessoa jurídica;
Objeto contendo os dados do contador
responsável pela empresa de
responsavel Responsavel - N contabilidade.
Objeto contendo dados do conselho de
dados_conselho DadosConselho - N classe (CRC) do responsável contábil.
Objeto contendo dados do endereço do
endereco EnderecoResponsavelContabil - N responsável contábil.
Responsavel
DadosConselho
EnderecoResponsavelContabil
Socio
PessoaFisica
1 = Masculino;
co_sexo Integer - N 2 = Feminino;
Objeto contendo os dados do documento
documento_identificacao DocumentoIdentificacao - N de identificação da pessoa.
ds_cargo String 300 N Descrição do cargo.
ds_mae String 100 N Nome da mãe.
ds_pai String 100 N Nome do pai.
Indica se pessoa é emancipada (true ou
is_emancipado Boolean - N false)
Código do motivo da emancipação. Ver
co_motivo_emancipacao Integer - N tabela
Informa se o sócio é um espolio (true ou
is_espolio Boolean - N false)
43
co_cpf_conjuge String 11 N CPF do cônjuge
ds_nome_conjuge String 200 N Nome do cônjuge.
DocumentoIdentificacao
PessoaJuridica
EnderecoSocio
44
co_municipio_tom Integer - N Código do município (TOM). Ver tabela
co_uf Integer - N Código da UF. Ver tabela
co_cep String 8 N CEP (apenas números).
co_tipo_logradouro Integer - N Código do tipo de logradouro. Ver tabela
Qualificacao
ResponsavelLegal
45
nu_telefone String 10 N Número do telefone (apenas números).
Pergunta
DadosAtoLegal
SubstitutoTributario
SimplesNacional
PeriodoSimples
PeriodoMei
ClausulaContratual
47
Data de término do exercício contratuais.
dt_termino_exercicio String 10 N Formato: YYYY-MM-DD
Objeto contendo dados da integralização
integralizacao_capital IntegralizacaoCapital - N do capital social.
Indicador se a empresa terá conselho
fiscal:
- true;
is_conselho_fiscal Boolean - N - false.
Array do objeto contendo os dados dos
dados_conselheiro Conselheiro[] - N conselheiros.
IntegralizacaoCapital
Conselheiro
BensMovelImovel
EnderecoImovel
Filial
ClassificacaoRisco
49
PerguntaClassificacaoRisco
InscricaoAdicional
EnderecoSubstitutoTributario
DadosItcmd
DadosDoacao
4.1.8. Response
Response
Erro
Response body
Tipo OB Descrição
51
4.2. WS03 – Mudança de status de documentos
4.2.1. Descrição
Serviço que possui a finalidade de informar aos órgãos que possuem interesse em
determinado processo a mudança de status de documentos de emissão automática
do próprio órgão ou de todos os documentos dos demais órgãos que possuem
interesse e emitem documento para o processo.
URL: https://<url-do-orgao-integrado>/v1/integracao/status-documentos
Verbo HTTP: POST
4.2.3. Request
Request Body
Controle
DadosDocumento
52
Data do evento.
dt_evento String 10 S Formato: YYYY-MM-DD.
Data de validade do documento emitido.
dt_validade String 10 N Formato: YYYY-MM-DD.
Tipo de documento que teve a situação alterada.
co_tipo_modelo_documento Integer - S Ver tabela
co_situacao Integer - S Situação do documento. Ver tabela
Número do documento.
Exigencia
Pergunta
4.2.4. Response
53
Response
Erro
Response body
Tipo OB Descrição
4.3.1. Descrição
Serviço que possui a finalidade de informar sobre a solicitação de um documento pelo
usuário para determinado órgão.
Sempre que houver solicitação de documento, no acompanhamento de solicitação, o
órgão será notificado através deste serviço. Após o processamento do consumo, a
resposta do órgão integrado para este documento deverá ocorrer através do WS21 -
Resposta de solicitação de documentos e baixa.
URL: https://<url-do-orgao-integrado>/v1/integracao/solicitacoes-documentos
Verbo HTTP: POST
4.3.3. Request
54
Request Body
Controle
DadosSolicitacaoDocumento
55
de seleção de atividades para o documento
solicitado. Nestes casos, a primeira atividade
preenchida no array será a atividade principal
selecionada pelo usuário.
anexos Arquivo[] - N Array de objetos do tipo Arquivo, com os
documentos anexados referentes a solicitação de
licenciamento.
Empresa
Pergunta
Atividade
Arquivo
4.3.4. Response
Erro
Response body
Tipo OB Descrição
4.4.1. Descrição
Este serviço será acionado sempre que houver o cancelamento de uma solicitação
no Integrador Estadual, informando a todos os órgãos interessados no processo
sobre o cancelamento.
URL: https://<url-do-orgao-integrado>/v1/integracao/cancelamentos-solicitacao
Verbo HTTP: POST
4.4.3. Request
Request Body
57
Campo Tipo Tamanho OB Descrição
Objeto contendo os campos de
controle da mensagem para
identificação e validação dos
controle Controle - S dados.
Objeto contendo os dados do
dados_cancelamento_solicitacao DadosCancelamentoSolicitacao - S cancelamento da solicitação.
Controle
DadosCancelamentoSolicitacao
ProtocoloRegistro
4.4.4. Response
Response
58
Erro
Response body
Tipo OB Descrição
4.5.1. Descrição
Este serviço possui a finalidade de informar ao órgão que colocou um documento ou
solicitação de baixa em exigência de que o solicitante já realizou a resposta a esta
exigência.
O retorno será dado sempre que houver uma resposta de exigência, de documentos
ou baixa, pelo solicitante no acompanhamento de processo.
URL: https://<url-do-orgao-integrado>/v1/integracao/retorno-exigencias
Verbo HTTP: POST
4.5.3. Request
Request Body
Controle
DadosRetornoExigencias
Exigencia
Arquivo
60
ds_nome_arquivo String 400 S Nome do arquivo
URL do serviço a ser consumido para recuperar o
arquivo.
4.5.4. Response
Response
Erro
Response body
Tipo OB Descrição
61
4.6. WS07 – Dados Simples Nacional
4.6.1. Descrição
Este serviço possui a finalidade de informar aos órgãos interessados sobre os dados
do simples nacional.
URL: https://<url-do-orgao-integrado>/v1/integracao/dados-simples-nacional
Verbo HTTP: POST
4.6.3. Request
Request Body
Controle
DadosSimplesNacional
62
Array contendo dados do objeto
periodo_simples PeriodoSimples[] - N PeriodoSimples.
Indicação de inscrição da empresa no MEI:
-true;
is_indicador_mei Boolean - N - false.
periodo_mei PeriodoMei[] - N Array contendo dados do objeto PeriodoMei.
PeriodoSimples
PeriodoMei
4.6.4. Response
Response
Erro
63
4.6.4.1.1. Response - Tabela de códigos de retorno comuns
Response body
Tipo OB Descrição
64
4.7. WS15 – Dados Produtor Rural
4.7.1. Descrição
Este serviço possui a finalidade de informar aos órgãos interessados sobre os dados
do produtor rural.
URL: https://<url-do-orgao-integrado>/v1/integracao/dados-produtor-rural
Verbo HTTP: POST
4.7.3. Request
Request Body
Controle
DadosSolicitacao
65
Array de objeto do tipo Atividade, contendo
atividade Atividade[] - S as atividade do processo.
Array de objeto contendo dados do arquivo
anexo Arquivo[] - N anexados.
Solicitante
ResponsavelContabil
1 = Pessoa física;
nu_tipo_pessoa Integer - S 2 = Pessoa jurídica;
Objeto contendo os dados do contador
responsável pela empresa de
responsavel Responsavel - N contabilidade.
Objeto contendo dados do conselho de
dados_conselho DadosConselho - N classe (CRC) do responsável contábil.
Objeto contendo dados do endereço do
endereco EnderecoContabil - N responsável contábil.
Responsavel
66
Objeto contendo os dados do conselho
de classe (CRC) do contador
responsável pela empresa de
dados_conselho DadosConselho - N contabilidade.
DadosConselho
EnderecoContabil
DadosProdutorRural
67
Número DDD do telefone do produtor
nu_ddd Integer - S rural.
Número do telefone do produtor rural
nu_telefone Integer - S (apenas número).
dados_imovel DadosImovel - S Objeto contendo os dados do imóvel.
Campo para informar se será utilizado o
mesmo endereço da propriedade como
correspondência.
- True;
is_utilizada_mesmo_endereco Boolean - S - False.
Objeto contendo os dados do Endereço
de correspondência.
Campo obrigatório quando o
endereco_correspondencia EnderecoCorrespondencia - N is_utilizada_mesmo_endereco for false.
Documento
DadosImovel
Endereco
68
ds_endereco String 100 S Endereço, sem a indicação do tipo de logradouro
nu_numero String 7 S Número do endereço
ds_bairro String 50 S Bairro do produtor rural
ds_complemento String 156 N Complemento do endereço
co_municipio Integer S Código IBGE do município (sem dígito verificador).
- Ver tabela
co_uf Integer S Código da UF do endereço do produtor rural. Ver
- tabela
ds_ponto_referencia String 300 N Ponto de referência.
nu_area_total String S Área total do imóvel.
15 Formato: ############.##
nu_area_producao String S Área de uso do imóvel.
15 Formato: ############.##
coordenadas_geograficas Point - S Objeto contendo as coordenadas geográficas.
Point
EnderecoCorrespondencia
69
Questionario
Evento
Atividade
Arquivo
4.7.4. Response
4.7.4.1. Requisição Mal Formada 400 – BAD REQUEST
Response
70
Erro
Response body
Tipo OB Descrição
Cada órgão integrado irá utilizar um conjunto de serviços diferentes de acordo com sua
responsabilidade e necessidades no processo. É possível verificar a utilização dos
serviços de acordo com o perfil do órgão conforme tabela abaixo:
PERFIL
SERVIÇOS Meio Junta
Prefeitura Bombeiros VISA SEFAZ Cartório OAB
Ambiente Comercial
WS20 - Resposta
de consulta x x x
prévia
WS21 - Resposta
de solicitação de
x x x x x
documentos e
baixa
WS22 -
Andamento da x x
solicitação
WS23 – Consulta
x x
dados DBE
WS24 – Busca de
x x x x x x x x
arquivos
WS25 – Busca de
dados simples x x x x x
nacional
WS26 –
Marcação CNPJ x
de interesse
WS29 – Envio
x x x x x x X
dados processo
WS42 – Busca
x x x x x x x x
Dados Empresa
Tabela 2 – Serviços de envio de dados pelos órgãos integrados x necessidade por perfil
5.1.1. Descrição
Serviço que possui a finalidade de receber a resposta das análises de viabilidade
(nome e localização) realizadas pelos órgãos responsáveis.
5.1.3. Request
Mensagem
Controle
DadosRespostaconsultaPrevia
5.1.4. Response
Response
Erro
Nova situação
(co_situacao_consulta) de
consulta prévia não permitida.
As transições permitidas são:
Nova situação da consulta não
400 9908
permitida. Em análise -> Deferida;
Em análise -> Indeferida;
Em análise -> Análise especial;
Análise especial -> Deferida;
Análise especial -> Indeferida;
74
O código de órgão enviado não
corresponde ao órgão
401 9909 Órgão não responde consulta prévia
responsável pela resposta de
consulta prévia.
Response body
Tipo OB Descrição
5.2.1. Descrição
Serviço que possui a finalidade de receber a resposta das solicitações de documentos
ou de baixa.
Através deste serviço será possível responder às solicitações, permitindo as
alterações de situação dos documentos solicitados, assim como as solicitações de
baixa de empresa.
5.2.3. Request
Request Body
75
Objeto contendo os campos de controle da
mensagem para identificação e validação dos
controle Controle - S dados.
Objeto contendo os dados do andamento da
dados_resposta DadosResposta - S solicitação.
Controle
DadosResposta
Exigencia
Atividade
5.2.4. Response
Response
Erro
77
5.2.4.1.1. Response - Tabela de erros específicos do WS21
78
5.2.4.1.2. Response - Tabela de códigos de retorno comuns
Response body
Tipo OB Descrição
5.3.1. Descrição
Através deste serviço será possível informar ao integrador estadual todo o andamento
do processo no órgão de registro.
Também é através deste serviço será possível indeferir à solicitação junto à Receita
Federal, utilizando o campo is_indefere_dbe. Se este campo for preenchido no
consumo, o SIGFÁCIL irá realizar consumo do serviço S06 na Receita Federal,
solicitando o indeferimento da solicitação no aplicativo de coleta web (DBE).
79
5.3.2. Dados adicionais
5.3.3. Request
Request Body
Controle
DadosAndamentoSolicitacao
80
- true;
- false.
5.3.4. Response
Response
Erro
81
Novo status da solicitação não
permitido. As transições
permitidas são:
Em análise;
Novo status da solicitação não Em análise -> Indeferido;
400 9901
permitido Em análise -> Em exigência;
Em exigência -> Em análise;
Em análise -> Deferido;
Deferido -> Autenticado;
Em exigência -> Em exigência
(apenas indeferindo DBE);
Response body
Tipo OB Descrição
5.4.1. Descrição
O retorno deste serviço conterá um campo em que será retornado XML exatamente
no formato de retorno do consumo ao S35 da Receita Federal. Toda a descrição de
dados (tamanho, tipo, ocorrências, obrigatoriedade) contidas no XML de retorno
seguem a documentação da Receita Federal.
82
URL PROD: https://integracao.voxtecnologia.com.br/v1/integracao/consulta-dados-
dbe/<nu_identificador_orgao>/<co_recibo_solicitacao>/<nu_identificacao_solicitacao
>
URL DEMO: https://demo-integracao.voxtecnologia.com.br/v1/integracao/consulta-
dados-
dbe/<nu_identificador_orgao>/<co_recibo_solicitacao>/<nu_identificacao_solicitacao
>
5.4.3. Request
5.4.4. Response
Response
Erro
83
Erro ao consumir S35 na
Erro no consumo do S35 - Receita Federal pelos motivos
500 9910
<mensagem_de_erro> indicados na mensagem de
erro.
Response body
5.5.1. Descrição
5.5.3. Request
84
Número identificador do órgão que está realizando
nu_identificador_orgao Integer - S o consumo ao serviço.
Hash contendo informações do arquivo que está
hash Text - S sendo recuperado.
5.5.4. Response
Response
Erro
Response body
85
5.6. WS25 – Busca de dados Simples Nacional
5.6.1. Descrição
5.6.3. Request
5.6.4. Response
Response
Erro
86
5.6.4.1.1. Response - Tabela de códigos de retorno comuns
Response body
DadosSimplesNacional
PeriodoSimples
PeriodoMei
87
Campo Tipo Tamanho OB Descrição
Data de inclusão MEI.
dt_inclusao String(10) 10 N Formato: YYYY-MM-DD
Data de exclusão MEI.
dt_exclusao String(10) 10 N Formato: YYYY-MM-DD
5.7.1. Descrição
Serviço que possui a finalidade de receber o interesse dos órgãos em CNPJs.
5.7.3. Request
Mensagem
Controle
MarcacaoInteresse
88
Campo Tipo Tamanho OB Descrição
Array de objetos contendo os dados das empresas
Empresa Empresa[] - S de interesse do órgão.
Empresa
5.7.4. Response
Response
Erro
Response body
Tipo OB Descrição
89
5.8. WS29 – Envio Dados Processo
5.8.1. Descrição
Serviço que possui a finalidade de reenviar os dados do WS02.
5.8.3. Request
Controle
DadosResposta
90
N Código do tipo de modelo de documento.
co_tipo_modelo_do Ver tabela
cumento Integer - Obrigatório para os co_servico: 3, 4 e 6.
Data do envio.
dt_envio String 19 S Formato: YYYY-MM-DD HH:MM:SS.
Protocolo
5.8.4. Response
Response
Erro
Response body
Tipo OB Descrição
91
5.9. WS42 – Recupera Dados Empresa
5.9.1. Descrição
Serviço que possui a finalidade de retornar os dados da Empresa.
Por se tratar de serviço tipo GET, os parâmetros devem ser enviados na URL.
Ao enviar a requisição, deve ser acrescentado ao header o auth-orgao com o
Código do órgão solicitante.
5.9.3. Request
Request Body
5.9.4. Response
92
Campo Tipo Tamanho OB Descrição
Objeto contendo os campos de
controle da mensagem para
controle Controle - S identificação e validação dos dados.
Objeto contendo os dados da
empresa Empresa - S empresa.
controle
Empresa
FormaAtuacao
Endereco
94
co_cep String 8 N Código do CEP da empresa.
Descrição do logradouro (sem o
ds_endereco String 100 N tipo de logradouro).
nu_numero String 7 N Número.
ds_bairro String 50 N Bairro.
Lista de complementos do
endereço da empresa, separados
por ";" com o máximo de 6
ds_complemento String 162 N complementos. Ver tabela
Código do município (TOM). Ver
co_municipio_tom Number - N tabela
co_uf Number - N Código da UF. Ver tabela
Atividade
Socio
95
Objeto contendo dados referentes à
dados_pessoa_juridica PessoaJuridica - N pessoa jurídica.
PessoaFisica
1 = Masculino;
co_sexo Number - N 2 = Feminino;
Objeto contendo os dados do
documento de identificação da
documento_identificacao DocumentoIdentificacao - N pessoa.
ds_cargo String 300 N Descrição do cargo.
Indica se pessoa é emancipada
is_emancipado Boolean - N (true ou false)
DocumentacaoIdentificacao
PessoaJuridica
96
nu_registro String 40 N Número de registro da empresa.
EnderecoSocio
Qualificacao
ResponsavelLegal
97
CPF do responsável legal (apenas
nu_cpf String 11 S números).
ds_nome String 200 S Nome do responsável legal.
Response
Erro
Cada órgão integrado irá utilizar um conjunto de serviços diferentes de acordo com sua
responsabilidade e necessidades no processo. É possível verificar a utilização dos serviços
de acordo com o perfil do órgão conforme tabela abaixo:
PERFIL
SERVIÇOS Meio Junta
Prefeitura Bombeiros VISA SEFAZ Cartório OAB
Ambiente Comercial
WS30 – Consulta
x
de endereço
WS31 – Consulta
x
dados do CRC
98
WS32 – Gerar
documento de x x x x x x x x
arrecadação
WS33 – Busca
x x x x x x x x
pagamentos
Tabela 3 – Serviços de coleta de dados nos órgãos integrados x necessidade por perfil
6.1.1. Descrição
URL: https://<url-do-orgao-integrado
>/v1/integracao/endereco/<nu_inscricao_imobiliaria>
Verbo HTTP: GET
6.1.3. Request
6.1.4. Response
Response
Erro
99
ds_retorno String 2000 S Descrição do erro Interno
Response body
Endereco
Complemento
100
Campo Tipo Tamanho OB Descrição
Ceps
Detalhamentos
Campo Tipo Tamanho OB Descrição
6.2.1. Descrição
URL: https://<url-do-orgao-integrado
>/v1/integracao/contabilista/<nu_identificador_orgao>/<nu_registro_crc>
Verbo HTTP: GET
6.2.3. Request
101
6.2.4. Response
Response
Erro
Response body
DadosCRC
102
ds_nome String 200 S Nome do responsável contábil.
Responsavel
DadosConselho
103
nu_sequencia String 10 S Número sequencial do CRC.
EnderecoResponsavelContabil
6.3.1. Descrição
URL:https://<url-do-orgao-integrado>/v1/integracao/gerar-
dar?nu_identificador_orgao=<nu_identificador_orgao>&nu_tipo_operacao=<nu_tipo
_operacao>&co_protocolo=<co_protocolo>&co_cpf_cnpj=<co_cpf_cnpj>&ds_nome=
<ds_nome>&nu_valor_taxa=<nu_valor_taxa>&co_tributo=<co_tributo>&co_tributo_d
etalhe=<co_tributo_detalhe>&dt_vencimento=<dt_vencimento>&co_municipio=<co_
municipio>&co_pais=<co_pais>&endereco_sacado=<endereco_sacado> OU
ds_endereco_completo=<ds_endereco_completo>
104
Verbo HTTP: GET
6.3.3. Request
6.3.4. Response
Response
105
Campo Tipo Tamanho OB Descrição
Response body
Taxa
Data de vencimento.
dt_vencimento String 10 S Formato: YYYY-MM-DD
106
ds_tributo String 40 N Descrição do tributo.
6.4.1. Descrição
6.4.3. Request
6.4.4. Response
107
Response
Response body
Pagamento
Data de vencimento.
dt_pagamento String 10 S Formato: YYYY-MM-DD
7. Tabelas
108
HTTP Code Código Descrição Observação
109
Em exigência -> Em exigência
(apenas indeferindo DBE);
110
Indeferido -> Em análise
Indeferido -> Emitido
Indeferido -> Em exigência
Indeferido -> Revogado
Indeferido -> Cassado
Indeferido -> Anulado
Indeferido -> Suspenso
Nova situação
(co_situacao_consulta) de consulta
prévia não permitida. As transições
permitidas são:
Nova situação da consulta não
400 9908 WS20
permitida Em análise -> Deferida;
Em análise -> Indeferida;
Em análise -> Análise especial;
Análise especial -> Deferida;
Análise especial -> Indeferida;
111
Erro ao consultar a inscrição
404 9911 WS30 Inscrição Imobiliária Inexistente
imobiliária.
112