IN CadastroEmpresas.integrador

• Requisição
  • Soap: http://servidor/CadastroEmpresas.integrador.asmx
  • Rest/JSon: http://servidor/CadastroEmpresas.integrador.ashx/metodo
    • Tipo de registro: EMPCAD

Cadastrar

Método que tem por finalidade cadastrar a base de Empresa/Pessoas conforme os parâmetros e tipos indicados abaixo:

• Parâmetros:
  

{"minExpandLevel":2}

• pin
  • Obrigatório, Tipo: String 20
• statusRegistro
  • Tipo: String 1
  • L=Liberado, P=Pendente
  • Este parâmetro não é obrigatório, mas se for informado algo diferente de L ou P, por padrão, será cadastrado como P na tabela de integração
• codigoEmpresa
  • Tipo: String 6
  • Campo onde será inserido o código da empresa. Caso não for informado, o código será o próximo disponível para a sua ‘Divisão’.
• nomeCompleto
  • Obrigatório, Tipo: String 60
  • Existe uma verificação de caracteres inválidos: *, "?", "´", ":", "&", "|", "(", ")", "[", "]", "{", "}", ",", "%"
• contato
  • Tipo: String 30
• fone
  • Tipo: String 20
• faxFone
  • Tipo: String 20
• endereco
  • Tipo: String 40
• bairro
  • Tipo: String 20
• municipio
  • Tipo: String 30
• uf
  • Tipo: String 2
• Cep
  • Tipo: Int 8
• cnpjCpf
  • Tipo: String 14
• inscrito
  • Obrigatório, Tipo: Bool
• inscricao
  • Obrigatório, Tipo: String 20
  • Se o parâmetro "inscrito" for "false", o parâmetro "inscricao" deve ser “ISENTO”.
• conceito
  • Tipo: String 1
• codigoDivisao
  • Tipo: String 2
• dtNascimento
  • Tipo: Date
• codigoIndicacao
  • Tipo: String 6
• codigoRepresentante
  • Tipo: String 6
• percentualComissaoBaixa
  • Tipo: Float 3.2
• contabilCliente
  • Tipo: String 8
• codigoResponsavel
  • Tipo: String 6
• fantasia
  • Obrigatório, Tipo: String 20
• pessoa
  • Tipo: Bool
• codigoContabilFornecedor
  • Tipo: String 8
• codigoCondicaoPagamento
  • Tipo: String 3
• codigoTipoPagamento
  • Tipo: String 2
• codigoTipoOperacao
  • Tipo: String 5
• irrfAcumulado
  • Tipo: Float 13.2
• tipoEmpresa
  • Tipo: String 2
• atividade
  • Tipo: String 3
• funcionarios
  • Tipo: Int 6
• faturamento
  • Tipo: Float 13.2
• limiteCredito
  • Tipo: Float 13.2
• codigoMercado
  • Tipo: String 2
• enviarCarta
  • Tipo: String 1
• tabelaPrecos
  • Tipo: String 6
• agendaInterna
  • Tipo: String 6
• codigoPais
  • Tipo: String 3
• codigoCentralizadora
  • Tipo: String 6
• atrasoMedio
  • Tipo: Int 5
• numero
  • Tipo: String 10
• complemento
  • Tipo: String 15
• inscricaoMunicipal
  • Tipo: String 20
• suframa
  • Tipo: String 20
• tipoFrete
  • Tipo: String 1
• percentualIndenizacao
  • Tipo: Float 3.2
• percDescontoSugestaoItens
  • Tipo: Float 3.2
• percentualDesconto2
  • Tipo: Float 3.2
• jurosPadrao
  • Tipo: Float 3.2
• codigoUnidadeNegocio
  • Obrigatório, Tipo: String 3
• codigoPortadorPadrao
  • Tipo: String 3
• ativo
  • Tipo: Bool
• codigoContabilAdiantamentoCli
  • Tipo: String 8
• codigoContabilAdiantamentoForn
  • Tipo: String 8
• codigoCentroArmazenagem
  • Tipo: String 4
• codigoIndiceCredito
  • Tipo: String 5
• codigoRegiaoEntrega
  • Tipo: String 3
• dtValidadeCredito
  • Tipo: Date
• codigoSetor
  • Tipo: String 25
• codigoRegimeTriburario
  • Tipo: String 2
• dtUltimaConsultaCredito
  • Tipo: Date
• validadeCobrancaAdmin
  • Tipo: Date
• ultimaVenda
  • Tipo: Date
• prefixoCnae
  • Tipo: String 6
• basePrazoDiferenciado
  • Tipo: String 6
• possuiRetencaoIss
  • Tipo: String 6
• codigoCentroArmazenagemMatAlte
  • Tipo: String 6
• filtroDataDirf
  • Tipo: String 1
• tipoImovel
  • Tipo: String 1
• listarIss
  • Tipo: String 1
• diaVencimento
  • Tipo: String 2
• limiteFaturamento
  • Tipo: String 2
• grauRelacionamento
  • Tipo: String 2
• sufixoCnae
  • Tipo: String 3
• toleranciaVencimento
  • Tipo: String 3
• nivelCredito
  • Tipo: String 3
• listarDirf
  • Tipo: Bool
• conveniada
  • Tipo: Bool
• creditoLiberado
  • Tipo: Bool
• percentualFrete
  • Tipo: Float 3.4
• codigoEan
  • Tipo: Float 13.1
• percentualAcrescimoLimite
  • Tipo: Float 8.6
• percentualAcrescimoPreco
  • Tipo: Float 8.6
• utilizaPrazoDiferenciado
  • Tipo: Float 11.2
• tgPadraoNfs
  • Tipo: Float 11.2
• limiteCreditoMensal
  • Tipo: Float 13.2
• optanteSimples
  • Tipo: Float 13.2
• Usrempr1
  • Tipo: String 20
• Usrempr2
  • Tipo: String 20
• cnaeServico
  • Tipo: String 20
• Usrempr4
  • Tipo: Date
• valorFrete
  • Tipo: Float 11.2

Retornos:
   Se sucesso:
      idRegistro - ID que representa este registro na tabela de integração.

   Se pin inválido:
      O usuário não possui direitos suficientes para executar esta rotina.

   Se algum parâmetro inválido:
      Parâmetro necessário não informado.

CadastrarEmpresas

Método que tem por finalidade cadastrar Empresa/Pessoas e contatos de empresas. Os dados da Empresa/Pessoas deverão estar em formato XML para requisições SOAP e JSON para requisições REST. Ambos com estrutura específica conforme descrito a seguir.

• Parâmetros:
  

{"minExpandLevel":2}

• pin
  • Obrigatório, Tipo: String 20
• statusRegistro
  • Tipo: String 1
  • L=Liberado, P=Pendente
  • Este parâmetro não é obrigatório, mas se for informado algo diferente de L ou P, por padrão, será cadastrado como P na tabela de integração
• empresasXml
  • Obrigatório para requisições SOAP. Tipo: String
  • Conteúdo de um arquivo XML com as Empresas, contatos e representantes
• empresasJson
  • Obrigatório para requisições REST/JSON. Tipo: String
  • Conteúdo de um arquivo JSON com as Empresa, contatos e representantes.

• Estrutura básica:
  

...

• Distribuição das Tags XML:

• <cadastroEmpresa>
  • <empresas>
    • <empresa>
      • <código/>
      • <nomeCompleto/>
      • <contato />
      • <fantasia/>
      • <pessoa/>
      • <fone/>
      • <faxFone/>
      • <endereco />
      • <bairro/>
      • <municipio/>
      • <numero/>
      • <complemento />
      • <uf/>
      • <cnpjCpf/>
      • <inscricao/>
      • <tipoInscricaoEstadual/>
      • <conceito>
        • <codigoConceito/>
        • <ordem/>
        • <descrição/>
        • <bloqueiaPedido/>
        • <bloqueiaNfSaida/>
        • <bloqueiaOrdem/>
        • <bloqueiaNfEntrada/>
        • <bloqueiaOrcamento/>
        • <bloqueiaSolicitacao/>
      • </conceito>
      • <divisao>
        • <codigoDivisao/>
        • <descrição/>
      • </divisao>
      • <aniversario/>
      • <cadastro/>
      • <indicacao>
        • <codigo />
        • <nomeCompleto/>
      • </indicacao>
      • <representante>
        • <codigo/>
        • <nomeCompleto/>
      • </representante>
      • <contabilCliente/>
      • <responsavel>
        • <codigo />
        • <nomeCompleto/>
      • </responsavel>
      • <contabilFornecedor/>
      • <condicaoPagamento/>
      • <tipoPagamento/>
      • <tipoOperacao>
        • <codigoTipoOperacao />
        • <descricao />
        • <codigoNatureza />
        • <descricaoNatureza />
      • </tipoOperacao>
      • <tipoEmpresa>
        • <codigo />
        • <descricao />
      • </tipoEmpresa>
      • <atividade>
        • <código/>
        • <descricao/>
      • </atividade>
      • <mercado>
        • <codigo />
        • <descricao />
      • </mercado>
      • <usuarioModificacao />
      • <enviarCarta/>
      • <tabelaDePreco>
        • <codigo />
        • <descricao />
      • </tabelaDePreco>
      • <agendaInterna />
      • <pais>
        • <codigo/>
        • <descricao/>
        • <codigoBacen/>
      • </pais>
      • <centralizadora>
        • <codigo/>
        • <nomeCompleto/>
      • </centralizadora>
      • <inscricaoMunicipal />
      • <suframa />
      • <tipoFrete />
      • <ultimaAtualizacao/>
      • <unidadeDeNegocio>
        • <codigo />
        • <descricao />
      • </unidadeDeNegocio>
      • <portadorPadrao />
      • <sessão/>
      • <contabilAdiantamentoCliente/>
      • <contabilAdiantamentoFornecedor/>
      • <centroArmazenagem>
        • <código/>
        • <descrição/>
      • </centroArmazenagem>
      • <indiceCredito />
      • <usuarioCriacao/>
      • <regiaoEntrega />
      • <setor>
        • <codigo />
        • <descricao />
      • </setor>
      • <regimeTributario />
      • <prefixoCNAE />
      • <basePrazoDiferenciado />
      • <possuiRetencaoISS />
      • <centroArmazeMaterialAlternativo>
        • <codigo />
        • <descricao />
      • </centroArmazeMaterialAlternativo>
      • <filtroDataDIRF />
      • <tipoImovel />
      • <listarISS />
      • <diaVencimento/>
      • <limiteFaturamento/>
      • <grauDeRelacionamento />
      • <sufixoCNAE />
      • <toleranciaVencimento />
      • <nivelDeCredito />
      • <creditoLiberado/>
      • <cnaeServico />
      • <contatos>
        • <contatoEmpresa>
          • <sequenciaContato/>
          • <pessoaContato/>
          • <email/>
          • <fone />
          • <recebeEmailNfe/>
          • <recebeEmailCartaCobranca/>
          • <recebeEmailCobranca/>
          • <recebeEmailBoleto/>
        • </contatoEmpresa>
      • </contatos>
      • <email/>
      • <recebeEmailNfe/>
      • <recebeEmailCartaCobranca/>
      • <recebeEmailCobranca/>
      • <recebeEmailBoleto/>
    • </empresa>
  • </empresas>
• </cadastroEmpresa>

• Distribuição das Tags Json:

{"minExpandLevel":6}

• {
  • "empresas":[
    • {
      • "codigo":"",
      • "nomeCompleto":"",
      • "contato":"",
      • "fantasia":"",
      • "pessoa":"",
      • "fone":"",
      • "faxFone":"",
      • "endereco":"",
      • "bairro":"",
      • "municipio":"",
      • "numero":"",
      • "complemento":"",
      • "uf":"",
      • "cnpjCpf":"",
      • "inscricao":"",
      • "tipoInscricaoEstadual":"",
      • "conceito":{
        • "codigoConceito":"",
        • "ordem":"",
        • "descricao":"",
        • "bloqueiaPedido":"",
        • "bloqueiaNfSaida":"",
        • "bloqueiaOrdem":"",
        • "bloqueiaNfEntrada":"",
        • "bloqueiaOrcamento":"",
        • "bloqueiaSolicitacao":"",
        • "descricao":"",
      • "cadastro":"",
      • "indicacao":{
        • "codigo":"",
        • "nomeCompleto":"",
        • "nomeCompleto":"",
      • "responsavel":{
        • "codigo":"",
        • "nomeCompleto":"",
      • "condicaoPagamento":"",
      • "tipoPagamento":"",
      • "tipoOperacao":{
        • "codigoTipoOperacao":"",
        • "descricao":"",
        • "codigoNatureza":"",
        • "descricaoNatureza":"",
        • "descricao":"",
        • "descricao":"",
        • "descricao":"",
      • "enviarCarta":"",
      • "tabelaDePreco":{
        • "codigo":"",
        • "descricao":"",
      • "pais":{
        • "codigo":"",
        • "descricao":"",
        • "codigoBacen":"",
        • "nomeCompleto":"",
      • "suframa":"",
      • "tipoFrete":"",
      • "ultimaAtualizacao":"",
      • "unidadeDeNegocio":{
        • "codigo":"",
        • "descricao":"",
      • "sessao":"",
      • "contabilAdiantamentoCliente":"",
      • "contabilAdiantamentoFornecedor":"",
      • "centroArmazenagem":{
        • "codigo":"",
        • "descricao":"",
      • "usuarioCriacao":"",
      • "regiaoEntrega":"",
      • "setor":{
        • "codigo":"",
        • "descricao":"",
      • "prefixoCNAE":"",
      • "basePrazoDiferenciado":"",
      • "possuiRetencaoISS":"",
      • "centroArmazeMaterialAlternativo":{
        • "codigo":"",
        • "descricao":"",
      • "tipoImovel":"",
      • "listarISS":"",
      • "diaVencimento":"",
      • "limiteFaturamento":"",
      • "grauDeRelacionamento":"",
      • "sufixoCNAE":"",
      • "toleranciaVencimento":"",
      • "nivelDeCredito":"",
      • "creditoLiberado":"",
      • "cnaeServico":"",
      • "contatos":[
        • {
          • "sequenciaContato":"",
          • "pessoaContato":"",
          • "email":"",
          • "fone":"",
          • "recebeEmailNfe":"",
          • "recebeEmailCartaCobranca":"",
          • "recebeEmailCobranca":"",
          • "recebeEmailBoleto":"",
      • "recebeEmailNfe":"",
      • "recebeEmailCartaCobranca":"",
      • "recebeEmailCobranca":"",
      • "recebeEmailBoleto":
    • }
  • ]
• }

Retornos:
   Se sucesso:
      idRegistro - ID que representa este registro na tabela de integração.

   Se pin inválido:
      O usuário não possui direitos suficientes para executar esta rotina.

   Se algum parâmetro inválido:
      Parâmetro necessário não informado.