Cadastro de Filial

Última atualização em: 28 de julho, 2017

No InvoiCy é possível realizar a troca de empresas de matriz para filial, ou vice-versa, de acordo com os dados da empresa emissora. Para realizar esta troca de matriz para filial é necessário seguir os passos:

No Painel de Controle, no módulo “Empresa”, clique na opção “Dados da Empresa”.

Esta tela possui o campo “É filial?” e “Matriz”, onde é possível configurar uma empresa como matriz, ou relacionar a qual matriz pertence a empresa filial.

No campo “É filial?” deve-se marcar como Sim caso a empresa emissora pertencer a uma mesma base de CNPJ, e em seguida no campo “Matriz” deverá selecionar a empresa matriz que possui vínculo e clicar no botão “Salvar”. Na listagem de matriz aparecem apenas as empresas que possuem o mesmo CNPJ base e já estão cadastradas no InvoiCy como matriz.

Caso deseje alterar a empresa para Matriz basta selecionar no campo “É filial?” a opção Não e salvar as informações.

Caso for cadastrar uma empresa filial e sua matriz já estiver cadastrada na aplicação é possível simplificar o cadastrado utilizando algumas informações já cadastradas na matriz, como o certificado digital e caixa de e-mail para envio de e-mails da empresa.

Para cadastrar uma filial é necessário selecionar a empresa matriz no combobox de empresas, acessar o “Painel de Controle”, grupo “Empresa” e clicar no botão “Filiais”, como demonstra a imagem a seguir.

Na tela de Filiais clicar no botão ‘Nova Filial’, então será aberta a primeira etapa de informações da empresa e o campo de identificação de filial já estará preenchido como Sim, com o nome da matriz informado para visualização.

Na próxima etapa de Certificados, estarão disponíveis os dados do certificado digital, que poderá ser do tipo A1 ou A3. Ao optar pelo tipo A1 deverá informar um certificado com a extensão de arquivo “.PFX” e informar seu apelido e senha.

Já ao optar pelo tipo A3 não será necessário informar nenhum arquivo ou senha, apenas um apelido para o certificado. Para mais informações sobre o certificado digital da empresa leia o artigo Entenda a diferença entre certificado A1 e A3.

É importante destacar que para as empresas que emitem no módulo NFS-e não será possível fazer uso do certificado A3. E para as empresas que emitem em mais de um módulo a configuração do certificado digital será geral, ou seja, não será possível emitir NF-e com certificado A1 e CT-e com certificado A3, por exemplo.

Ao cadastrar o certificado existem 3 opções:

– Cadastrar novo certificado: esta será a opção padrão, onde o usuário poderá informar normalmente o seu certificado digital. A imagem abaixo demonstra a utilização dessa opção.

– Usar certificado da matriz: esta opção estará disponível apenas quando for cadastrada uma filial, e a matriz possuir um certificado digital cadastrado. Ao marcar essa opção os campos ficarão desabilitados e serão preenchidos automaticamente, conforme demonstra a imagem a seguir.

– Usar certificado já cadastrado: por fim, esta opção será habilitada apenas quando o parceiro possuir certificados cadastrados no painel de certificados do parceiro para a mesma raiz de CNPJ da empresa que está sendo cadastrada. Quando selecionada esta opção serão listados os certificados cadastrados para a mesma raiz de CNPJ, juntamente com seu apelido e data de vencimento. Os demais campos do cadastro estarão desabilitados.

Concluído o processo do certificado digital, na próxima etapa será possível configurar um Remetente padrão para receber os e-mails referentes a sua empresa.

Para receber e-mails de alertas e notificações do InvoiCy a empresa deve realizar o cadastro de uma caixa de e-mail, que o InvoiCy irá utilizar para enviar e-mails do emissor aos seus clientes.

Ao cadastrar uma caixa de e-mail existem 3 opções:

– Cadastrar nova caixa de e-mail: esta será a opção padrão, onde o usuário poderá cadastrar normalmente uma caixa de e-mail, como demonstra a imagem abaixo.

– Usar servidor de e-mail da matriz: esta opção estará disponível apenas quando for cadastrada uma filial, e a matriz possuir uma caixa de e-mail configurada. Ao marcar essa opção os campos ficarão desabilitados e serão preenchidos automaticamente, sendo possível editar apenas o nome do remetente, conforme demonstra a imagem a seguir.

– Usar servidor de e-mail já cadastrado: por fim, esta opção será habilitada apenas quando o parceiro possuir caixa de e-mail cadastrada na tela de servidores de e-mail. Quando selecionada esta opção serão listadas as caixas cadastradas, juntamente com seu apelido e o e-mail do usuário. Os demais campos do cadastro estarão desabilitados, permitindo apenas alterar o nome do remetente.

A próxima etapa possibilita cadastrar usuários para a empresa, que terão acesso ao InvoiCy. Você poderá criar novos usuários ou vincular usuários já existentes, veja as opções disponíveis:

– Cadastrar novos usuários: na tela de cadastro do novo usuário, deve-se preencher os campos da parte superior informando o Nome, E-mail, Senha e Status do usuário cadastrado.

Após deve-se definir as permissões do usuário, ou seja, as ações que ele poderá executar no sistema. Para isso, é possível vincular o usuário a um grupo de permissões, ou configurar separadamente os seus acessos.

Para consultar os detalhes do cadastro de um novo usuário, leia o artigo “Cadastrando um usuário”.

– Usar usuários da matriz: quando a empresa que está sendo cadastrada for uma filial, esta opção lhe possibilita utilizar os usuários já cadastrados para a empresa matriz, marcando essa opção os usuários serão copiados automaticamente para a empresa que está em processo de cadastro. Uma vez marcada a opção “Usar usuários da matriz”, não será mais permitido na etapa “4. Usuários” do Wizard selecionar as demais opções. Antes de confirmar a opção de usuários desejada, confirme se realmente esta é a ação correta que deseja executar.

– Usar usuários do grupo de empresa: Caso na etapa “1. Dados da empresa” (conforme demostra a imagem) do Wizard tenha sido vinculado a empresa em cadastro a um grupo de empresas, essa opção de “Usar usuários do grupo de empresa” será habilitada, e você poderá estar utilizando os usuários já cadastrados para as empresas que estejam neste grupo.

– Usar usuários já cadastrados: Ao marcar a opção de “Usar usuários já cadastrados” será apresentada a opção de “Selecionar usuários do parceiro”, ao utilizar essa opção uma lista com os usuários já cadastrados na aplicação será exibida, permitindo assim vincular usuários já cadastrados para a nova empresa a ser cadastrada.

Selecione os usuários que deseja utilizar para esta empresa que está cadastrando, aplique a seleção, e assim o usuário já cadastrado será vinculado também para esta empresa.

 

Na próxima etapa, Módulo NFS-e, encontram-se as configurações que são necessárias para o envio de NFS-e. Se você não integrar com este módulo não é necessário o preenchimento dos campos, podendo pular a etapa clicando no botão “Pular etapa”.

Para verificar se o seu município já está integrado vá até o Painel de Controle, no Módulo NFS-e, selecione a opção “Municípios Integrados”, efetuando uma pesquisa pelo seu município, e caso ele conste na consulta o mesmo já se encontra integrado com o sistema. Caso não conste na consulta veja o artigo Como solicitar um novo Município e qual o prazo para Integração para mais informações.

Ao término do Wizard é apresentado um resumo das informações da filial, como o apelido da empresa e a chave de acesso que deverá ser utilizada no ERP, AC ou DLL para validar a comunicação via Web Service.

Nessa etapa, é possível definir uma empresa como Empresa modelo, esta funcionalidade foi substituída pelas opções “Copiar configurações da empresa matriz” ou “Copiar configurações de outra empresa”

– Sim, importar configurações da matriz: Se essa opção for marcada, os parâmetros configurados para a empresa matriz, juntamente com a logomarca serão replicados para a empresa que está sendo cadastrada. Antes de executar a importação dos dados, responda a mensagem de confirmação apresentada.

ReplicarDadosMatriz

 Sim, copiar configurações de outra empresa: Escolhida essa opção, é habilitado um botão de “Selecionar empresa” o qual lhe dará acesso as empresas do parceiro, buscando primeiramente as empresas definidas como empresa modelo (destacadas em negrito), ou ainda você terá a opção de pesquisar qualquer outra empresa já cadastrada.

Porém, poderá ser selecionada apenas uma empresa para que seja utilizada como replicação dos dados, se mais empresas foram selecionadas, será utilizada a primeira empresa da etapa “Seleção de empresa para a replicação”.

Ao finalizar as configurações do cadastro da filial serão apresentados os dados da empresa para que você possa seguir com a integração, através do botão “Finalizar” confirme o cadastro da empresa.

Após finalizar o processo o envio de notas já está autorizado para esta empresa. Posteriormente é possível consultar o status da licença acessando o painel de controle e clicando na opção “Módulos contratados”.

Cadastrar uma empresa via interface Web

Última atualização em: 13 de outubro, 2017

Este artigo descreverá passo-a-passo como cadastrar uma nova empresa via Wizard na aplicação InvoiCy. Proceda com os seguintes passos para realizar o Wizard de cadastro de empresas.

1. Acesso ao Wizard

No Painel de Controle, no grupo “Configurações do Parceiro – Gerenciamento”, clique na opção “Nova Empresa”.

 

Nova empresa.jpg

2. Dados da empresa

Este Wizard tem o objetivo de auxiliar no cadastro das empresas, que é dividido em 6 etapas. A primeira etapa corresponde aos dados da empresa emissora, onde todos os campos obrigatórios que apresentam um asterisco devem ser preenchidos para prosseguir com o cadastro.

Ao fazer o cadastro pode-se fazer o vínculo a um grupo, através da opção ‘Grupo de Empresas’, para melhor organização das empresas do parceiro. Todos os grupos cadastrados pelo parceiro aparecerão na listagem para seleção, conforme pode-se verificar na imagem abaixo. Para mais informações sobre o cadastro de grupos leia o artigo Cadastrando Grupos de Empresas.

Para receber e-mails do InvoiCy é necessário informar um endereço válido no campo “E-mail para notificações”. Se o usuário possuir um e-mail para notificação já cadastrado, ao começar a digitar o mesmo já aparecerá disponível para seleção. Para saber mais sobre os e-mails para notificações leia Tela de e-mails para notificações.

 

Após preencher todos os campos deve-se clicar em “Cadastrar”, onde conforme descrito na mensagem o processo já poderá incidir em cobrança. Caso não deseje continuar com o cadastro deverá clicar na opção “Sair do Wizard”. Clicando na opção “Cadastrar” será gerada a “Chave de acesso” do emissor e será apresentada a tela de Licenciamento.

3. Licenciamento

Após preencher as informações na primeira etapa de dados da empresa será apresentada a etapa de licenciamento, com os módulos disponíveis para solicitação de licença.

Nesta tela é possível solicitar as licenças para os módulos que o emissor irá utilizar, onde cada solicitação de licença irá gerar uma cobrança. Após clicar em “Solicitar licença” o Wizard avança para a segunda etapa referente ao carregamento do certificado digital.

Para mais informações sobre o processo de licenciamento da empresa acesse o artigo Licenciamento das empresas.

4. Escolha do certificado

Após solicitar uma licença para a empresa é necessário realizar o envio do certificado digital, que poderá ser do tipo A1 ou A3. Ao optar pelo tipo A1 deverá informar um certificado com a extensão de arquivo “.PFX” e informar seu apelido e senha.

Já ao optar pelo tipo A3 não será necessário informar nenhum arquivo ou senha, apenas um apelido para o certificado. Para mais informações sobre o certificado digital da empresa leia o artigo Entenda a diferença entre certificado A1 e A3.

É importante destacar que para as empresas que emitem no módulo NFS-e não será possível fazer uso do certificado A3. E para as empresas que emitem em mais de um módulo a configuração do certificado digital será geral, ou seja, não será possível emitir NF-e com certificado A1 e CT-e com certificado A3, por exemplo.

Ao cadastrar o certificado existem 3 opções:

– Cadastrar novo certificado: esta será a opção padrão, onde o usuário poderá informar normalmente o seu certificado digital. A imagem abaixo demonstra a utilização dessa opção.

 

– Usar certificado da matriz: esta opção estará disponível apenas quando for cadastrada uma filial, e a matriz possuir um certificado digital cadastrado. Ao marcar essa opção os campos ficarão desabilitados e serão preenchidos automaticamente, conforme demonstra a imagem a seguir.

 

– Usar certificado já cadastrado: por fim, esta opção será habilitada apenas quando o parceiro possuir certificados cadastrados no painel de certificados do parceiro para a mesma raiz de CNPJ da empresa que está sendo cadastrada. Quando selecionada esta opção serão listados os certificados cadastrados para a mesma raiz de CNPJ, juntamente com seu apelido e data de vencimento. Os demais campos do cadastro estarão desabilitados.

 

Esta e todas as demais etapas do Wizard são possíveis de serem puladas, mas isto não elimina o cadastro da empresa, somente o deixará incompleto.

5. Caixa de E-mail

Nessa etapa é possível configurar um Remetente padrão para receber os e-mails referentes a sua empresa.

Para receber e-mails de alertas e notificações do InvoiCy a empresa deve realizar o cadastro de uma caixa de e-mail, que o InvoiCy irá utilizar para enviar e-mails do emissor aos seus clientes.

Ao cadastrar uma caixa de e-mail existem 3 opções:

– Cadastrar nova caixa de e-mail: esta será a opção padrão, onde o usuário poderá cadastrar normalmente uma caixa de e-mail, como demonstra a imagem abaixo.

 

– Usar servidor de e-mail da matriz: esta opção estará disponível apenas quando for cadastrada uma filial, e a matriz possuir uma caixa de e-mail configurada. Ao marcar essa opção os campos ficarão desabilitados e serão preenchidos automaticamente, sendo possível editar apenas o nome do remetente, conforme demonstra a imagem a seguir.

 

– Usar servidor de e-mail já cadastrado: por fim, esta opção será habilitada apenas quando o parceiro possuir caixa de e-mail cadastrada na tela de servidores de e-mail. Quando selecionada esta opção serão listadas as caixas cadastradas, juntamente com seu apelido e o e-mail do usuário. Os demais campos do cadastro estarão desabilitados, permitindo apenas alterar o nome do remetente.

 

6. Usuários

Essa etapa possibilita cadastrar usuários para a empresa, que terão acesso ao InvoiCy. Agora no Wizard para nova empresa você já poderá criar novos usuários ou vincular usuários já existentes, veja as opções disponíveis:

 

– Cadastrar novos usuários: na tela de cadastro do novo usuário, deve-se preencher os campos da parte superior informando o Nome, E-mail, Senha e Status do usuário cadastrado.

 

Após deve-se definir as permissões do usuário, ou seja, as ações que ele poderá executar no sistema. Para isso, é possível vincular o usuário a um grupo de permissões, ou configurar separadamente os seus acessos.

 

Para consultar os detalhes do cadastro de um novo usuário, leia o artigo “Cadastrando um usuário”.

– Usar usuários da matriz: quando a empresa que está sendo cadastrada for uma filial, esta opção lhe possibilita utilizar os usuários já cadastrados para a empresa matriz, marcando essa opção os usuários serão copiados automaticamente para a empresa que está em processo de cadastro. Uma vez marcada a opção “Usar usuários da matriz”, não será mais permitido na etapa “4. Usuários” do Wizard selecionar as demais opções. Antes de confirmar a opção de usuários desejada, confirme se realmente esta é a ação correta que deseja executar.

– Usar usuários do grupo de empresa: Caso na etapa “1. Dados da empresa” (conforme demostra a imagem) do Wizard tenha sido vinculado a empresa em cadastro a um grupo de empresas, essa opção de “Usar usuários do grupo de empresa” será habilitada, e você poderá estar utilizando os usuários já cadastrados para as empresas que estejam neste grupo.

 

– Usar usuários já cadastrados: Ao marcar a opção de “Usar usuários já cadastrados” será apresentada a opção de “Selecionar usuários do parceiro”, ao utilizar essa opção uma lista com os usuários já cadastrados na aplicação será exibida, permitindo assim vincular usuários já cadastrados para a nova empresa a ser cadastrada.

 

Selecione os usuários que deseja utilizar para esta empresa que está cadastrando, aplique a seleção, e assim o usuário já cadastrado será vinculado também para esta empresa.

 

7. Módulo NFS-e

Nesta etapa encontram-se as configurações que são necessárias para o envio de NFS-e. Somente será apresentada essa etapa caso você parceiro possuir licença para o módulo NFS-e, caso contrário será direcionado para a etapa final do Wizard. Porém se a etapa Módulo NFS-e for habilitada devido ao parceiro ter alguma empresa NFS-e, mas sua empresa atual não integrar com este módulo não é necessário o preenchimento dos campos, podendo pular a etapa clicando no botão “Pular etapa”.

 

Para verificar se o seu município já está integrado vá até o Painel de Controle, no Módulo NFS-e, selecione “Municípios Integrados” efetuando uma pesquisa pelo seu município, e caso ele conste na consulta o mesmo já se encontra integrado com o sistema. Caso não conste na consulta veja o artigo Como solicitar um novo Município e qual o prazo para Integração para mais informações.

8. Final

Ao término do Wizard é apresentado um resumo com as informações da empresa, como o apelido da empresa e a chave de acesso que deverá ser utilizada no ERP, AC ou DLL para validar a comunicação.

Nessa etapa, é possível definir uma empresa como Empresa modelo, esta funcionalidade foi substituída pelas opções “Copiar configurações da empresa matriz” ou “Copiar configurações de outra empresa”

– Sim, importar configurações da matriz: Se essa opção for marcada, os parâmetros configurados para a empresa matriz, juntamente com a logomarca serão replicados para a empresa que está sendo cadastrada. Antes de executar a importação dos dados, responda a mensagem de confirmação apresentada.

ReplicarDadosMatriz

Sim, copiar configurações de outra empresa: Escolhida essa opção, é habilitado um botão de “Selecionar empresa” o qual lhe dará acesso as empresas do parceiro, buscando primeiramente as empresas definidas como empresa modelo (destacadas em negrito), ou ainda você terá a opção de pesquisar qualquer outra empresa já cadastrada.

 

Porém, poderá ser selecionada apenas uma empresa para que seja utilizada como replicação dos dados, se mais empresas foram selecionadas, será utilizada a primeira empresa da etapa “Seleção de empresa para a replicação”.

 

Ao finalizar as configurações de cadastro de empresa serão apresentados os dados da empresa para que você possa seguir com a integração, através do botão “Finalizar” confirme o cadastro da empresa.

 

Cadastrar uma Empresa via Web Service – Antigo

Última atualização em: 13 de julho, 2015

 

Neste artigo iremos demonstrar como realizar o cadastro de uma empresa através do Web Service do InvoiCy.

A partir de agora, assumimos que você já leu o artigo Integrar com o InvoiCy NFS-e. Caso ainda não tenha lido o artigo, recomendamos que realize a leitura do mesmo, para facilitar o entendimento deste artigo.

O cadastramento da empresa é muito simples. Para que isso se torne possível, siga os seguintes passos:

     1. Consumindo o Web Service
Primeiramente, você deve realizar o consumo do Web Service de Cadastro de prestador – https://gnfse.gnfe.com.br/apnuc208.aspx?wsdl

     2. Criar os XML para o envio
O XML deve ser convertido para String, porém, apenas neste serviço não é preciso gerar a chave de comunicação (EmpCK), apenas o XML deve ser convertido para texto, conforme instruções abaixo. Para mais informações sobre a EmpCK consulte o artigo Como gerar o código Hash MD5?

     3. Armazenar os dados de retorno
Caso a empresa seja cadastrada com sucesso, é preciso guardar o Código da Empresa no InvoiCy e a chave de acesso, informações fundamentais para a emissão com a empresa. Para obter mais informações sobre a chave de acesso consulte o artigo Verificando a chave de acesso da empresa.

Para obter os Layouts de envio e retorno do Cadastro de Empresas, faça o download do arquivo CadastroEmpresa.zip. Nele você encontrará também o arquivo XSD e XML de exemplo.

O documento XML deve ser convertido para texto, e inserido entre as TAGS do SOAP de envio. Veja abaixo um exemplo:

Nos casos em que for usada uma ferramenta RAD para consumo do Web Service através de componente nativo, por exemplo Visual Studio utilizando Web Reference, a conversão do XML para texto irá ocorrer de forma automática. Para os casos em que o desenvolvedor preferir codificar toda a comunicação sem utilizar componentes, além de ser necessário escrever todo o XML do SOAP, também deverá ser feita a conversão do XML do documento para texto, substituindo os caracteres “<”, “>” e “ “ ” (aspas) por “<”, “>” e “”” respectivamente, de acordo com a tabela da W3C: http://www.w3schools.com/html/html_entities.asp.

Para facilitar a geração do XML de integração, disponibilizamos o XML de envio, bem como um arquivo de esquema XSD que poderá servir como base. É recomendável que após a geração do arquivo XML e antes do consumo do Web Service, o mesmo seja validado contra o arquivo de esquema. Maiores detalhes no artigo Validação de arquivos XML.

    4. Realize a leitura do retorno do cadastro de Empresa
Após o envio do XML, precisamos realizar a leitura do retorno do processamento do cadastro. O retorno recebido segue a seguinte estrutura SOAP:

A estrutura SOAP acima demonstra o retorno do envio de apenas uma empresa. O seu sistema deve ler o retorno, validando as informações conforme o layout de retorno. O retorno apresentará o status de cada processo, desde o cadastro da empresa, a instalação do certificado, a validação da licença e o cadastro do usuário.

Para saber mais sobre os possíveis códigos de retorno ao cadastrar uma empresa via Web Service, acesse o artigo Códigos de Retorno Cadastro de Empresa via Web Service.

Agora que você já cadastrou a empresa, podemos dar prosseguimento ao próximo passo.

Seu próximo passo é: Emitir uma NFS-e.

Artigos Relacionados:

Cadastrando um usuário

Última atualização em: 11 de julho, 2017

Olá! Neste artigo iremos descrever os passos necessários para cadastrar um novo usuário para uma empresa no InvoiCy.

Ao acessar a Plataforma InvoiCy deve-se escolher na combobox de empresas, localizado na parte superior direita da aplicação, para qual empresa deseja incluir o novo usuário. Após selecionar a empresa, no menu lateral esquerdo clicar em Painel de Controle.

Estando no Painel de Controle, no grupo Empresas clicar na opção ‘Usuários’, como demonstra a imagem a seguir.

Ao acessar a tela de usuários da empresa, serão listados todos os usuários cadastrados para a respectiva empresa, com as opções de excluir, editar, vincular o usuário à mais empresas ou visualizar seus logs.

Se desejar cadastrar um novo usuário basta clicar na opção ‘Novo usuário’, como demonstra a imagem abaixo, e clicar em continuar.

Na tela de cadastro do novo usuário, deve-se preencher os campos da parte superior informando o Nome, E-mail, Senha e Status do usuário cadastrado.

Após deve-se definir as permissões do usuário, ou seja, as ações que ele poderá executar no sistema. Para isso, é possível vincular o usuário a um grupo de permissões, ou configurar separadamente os seus acessos.

Ao lado esquerdo das permissões são listados os grupos de permissões pertencentes a empresa, onde ao clicar sobre um grupo, suas permissões serão habilitadas e destacadas com uma cor ao lado, para melhor identificação do usuário. Ao clicar novamente sobre o grupo selecionado as opções serão desabilitadas.

Para configurar as permissões do módulo NFC-e referente a correção de documentos rejeitados em contingência, basta clicar sobre o link ‘Correção de NFC-e rejeitadas em contingência’. Destacando que esta funcionalidade não está disponível no ambiente Cloud.

Ao clicar nesse link será aberta uma janela popup com as permissões disponíveis para configuração. Ao passar o mouse sobre as cores é possível identificar qual grupo cada cor está representando.

Existem também as permissões para ‘Notificações’, onde é possível gerenciar os tipos de e-mails e notificações gerados pelo InvoiCy que o usuário irá receber.

Notificações

Ao finalizar as configurações das permissões basta clicar em Salvar, no final da tela, e o cadastro do usuário será efetuado.

Após cadastrar o usuário é possível vincular o mesmo a outras empresas já cadastradas, através da tela de usuários da empresa, opção ‘Empresas do usuário’ localizada na grid, conforme apresentado abaixo.

Ao clicar nessa opção o usuário será direcionado para a nova tela de usuários do parceiro, onde deverá editar o usuário desejado e vincular as suas empresas. A imagem abaixo demonstra essa tela.

Ao editar o usuário, será possível visualizar quais empresas estão vinculadas a ele, e ao clicar na opção ‘Vincular empresas’, será aberta uma tela com todas as empresas do parceiro para seleção.

É importante destacar que será atribuído apenas o usuário para as empresas selecionadas, sem as permissões configuradas, nesse caso será necessário atribuir as permissões novamente.

Outro ponto importante é que o InvoiCy também permite cadastrar um mesmo usuário para múltiplas empresas simultaneamente, agilizando assim o cadastro de usuários para grandes redes de empresas. Para mais informações sobre essa funcionalidade leia o artigo Cadastro de usuários multiempresa.

Além de poder cadastrar um novo usuário é possível:

– Usar usuários da matriz: essa opção estará disponível apenas quando for cadastrada uma filial, e a matriz possuir usuários cadastrados. Ao marcar essa opção todos usuários da empresa matriz serão copiados automaticamente para esta nova empresa filial.

– Usar usuários do grupo de empresa: essa opção estará disponível apenas quando a empresa pertencer a um grupo de empresas. Ao selecionar essa opção serão copiados os usuários de todas as empresas que também estiverem vinculadas ao mesmo grupo de empresas.

– Usar usuários já cadastrados: Ao marcar a opção de “Usar usuários já cadastrados” será apresentado a opção de “Selecionar usuários do parceiro”, ao utilizar essa opção uma lista com os usuários já cadastrados na aplicação é exibida, permitindo assim vincular usuários já cadastrados para a nova empresa a ser cadastrada.

Personalização das permissões de acesso do usuário para a empresa

Ao cadastrar um usuário pela nova tela de usuários do parceiro, e fazer o vínculo com as empresas, automaticamente o mesmo será apresentado na tela de usuários da empresa para a qual foi vinculado. Sendo assim, sempre que o usuário sofrer alguma alteração através da tela de usuários do parceiro, esta será replicada para o usuário de cada empresa em específico.

Agora, suponhamos que você tenha o usuário contador cadastrado para todas as suas empresas, mas para a empresa Matriz você deseja liberar mais algumas permissões para ele, então você acessa a tela de usuários da empresa Matriz e altera o usuário contador, configurando as permissões desejadas.

A partir desse momento o usuário contador passa a ser um usuário personalizado para a empresa Matriz, então todas as alterações realizadas nesse usuário, a partir da tela de usuários do parceiro, não serão impactadas para o usuário contador na empresa Matriz, apenas para as demais empresas.

Cadastrar uma Empresa via Web Service

Última atualização em: 10 de julho, 2014

 

Neste artigo iremos demonstrar como realizar o cadastro de uma empresa através do Web Service do InvoiCy.

A partir de agora, assumimos que você já leu o artigo Integrar com o InvoiCy NFS-e. Caso ainda não tenha lido o artigo, recomendamos que realize a leitura do mesmo, para facilitar o entendimento deste artigo.

O cadastramento da empresa é muito simples. Para que isso se torne possível, siga os seguintes passos:

     1. Consumindo o Web Service
Primeiramente, você deve realizar o consumo do Web Service de Cadastro de prestador – https://gnfse.gnfe.com.br/apnuc208.aspx?wsdl

     2. Criar os XML para o envio
O XML deve ser convertido para String, porém, apenas neste serviço não é preciso gerar a chave de comunicação (EmpCK), apenas o XML deve ser convertido para texto, conforme instruções abaixo. Para mais informações sobre a EmpCK consulte o artigo Como gerar o código Hash MD5?

     3. Armazenar os dados de retorno
Caso a empresa seja cadastrada com sucesso, é preciso guardar o Código da Empresa no InvoiCy e a chave de acesso, informações fundamentais para a emissão com a empresa. Para obter mais informações sobre a chave de acesso consulte o artigo Verificando a chave de acesso da empresa.

Para obter os Layouts de envio e retorno do Cadastro de Empresas, faça o download do arquivo CadastroEmpresa.zip. Nele você encontrará também o arquivo XSD e XML de exemplo.

O documento XML deve ser convertido para texto, e inserido entre as TAGS do SOAP de envio. Veja abaixo um exemplo:

Nos casos em que for usada uma ferramenta RAD para consumo do Web Service através de componente nativo, por exemplo Visual Studio utilizando Web Reference, a conversão do XML para texto irá ocorrer de forma automática. Para os casos em que o desenvolvedor preferir codificar toda a comunicação sem utilizar componentes, além de ser necessário escrever todo o XML do SOAP, também deverá ser feita a conversão do XML do documento para texto, substituindo os caracteres “<”, “>” e “ “ ” (aspas) por “<”, “>” e “”” respectivamente, de acordo com a tabela da W3C: http://www.w3schools.com/html/html_entities.asp.

Para facilitar a geração do XML de integração, disponibilizamos o XML de envio, bem como um arquivo de esquema XSD que poderá servir como base. É recomendável que após a geração do arquivo XML e antes do consumo do Web Service, o mesmo seja validado contra o arquivo de esquema. Maiores detalhes no artigo Validação de arquivos XML.

    4. Realize a leitura do retorno do cadastro de Empresa
Após o envio do XML, precisamos realizar a leitura do retorno do processamento do cadastro. O retorno recebido segue a seguinte estrutura SOAP:

A estrutura SOAP acima demonstra o retorno do envio de apenas uma empresa. O seu sistema deve ler o retorno, validando as informações conforme o layout de retorno. O retorno apresentará o status de cada processo, desde o cadastro da empresa, a instalação do certificado, a validação da licença e o cadastro do usuário.

Agora que você já cadastrou a empresa, podemos dar prosseguimento ao próximo passo.

Seu próximo passo é: Emitir uma NFS-e.

Artigos Relacionados: