Zep System
Cadastros e configurações
Parâmetro de funcionamento
Acesse o parâmetro de funcionamento na guia "Status" e defina os status abaixo:
- Documento Pendente
- NFe Compartilhada ao Órgão.
Esses status são utilizados durante o processamento das operações.
Cadastro da tabela de preço
Crie uma tabela de preço para vinculo ao pedido de venda. Para cadastrar a tabela de preço deve seguir alguns critérios:
-Não permite "Lançar Descontos";
-A condição de pagamento é a combinada com a Integradora.
Cadastro de Intermediador
Cadastre o intermediador de venda com os dados da Zep-System.
Processamentos Específicos
INTEGRAÇÕES: Inicializar
Execução do Processamento
O 1º processamento específico que devemos executar é o INTEGRAÇÕES: INICIALIZAÇÃO. Este processamento irá gerar todos os parâmetros necessário para utilização da integração.
Obs.: Todos os processamentos possuem observações importantes que devem ter uma atenção especial.
Após executá-lo, será verificado se existe uma unidade de codificação na TekStore. Caso exista, será apresentado a mensagem abaixo e o processo será finalizado.
A unit de configuração existente para o cliente. Favor acessar a TekStore para realizar os ajustes necessários. Unit encontrada: P10_INTEGRACOES_CONFIGURACAO_XXXX Processo será finalizado!
Se não encontrar a unit de configuração para o cliente na TekStore, será exibido uma tela com os canais disponíveis para o cliente. O usuário deverá selecionar o canal e prosseguir para o próximo passo.
Após selecionar o canal, será exibido a tela abaixo onde deve ser parametrizado usando todas as configurações.
Após executa-la, será apresentado ao usuário uma tela com as informações para configuração da unidade de codificação.
Importante verificar se o cliente já utiliza a integração Venda a Ordem para outra Integradora. Neste caso, será necessário ajustar a unidade de codificação na TekStore manualmente após execução do processamento de inicialização.
Para novos clientes siga os passos indicados:
- Adicionar Unit com o tipo de codificação JSON e nome indicado na tela na TekStore(Suporte). Esse cadastro deverá ser realizado por um consultor Tek-System.
- Não precisa preencher as informações pertinente a Venda a ordem, pode gerar apenas o Json para ser vinculado na TekStore.
- Copiar código JSON gerado como padrão para a codificação da Unit criada.
Formação do Nome da Unit: INTEGRACOES_CONFIGURACAO_XXXX
- INTEGRACOES_CONFIGURACAO: Nomenclatura padrão.
- XXXX: Código como cliente Tek-System.
Configuração do Canal utilizada pela Zep System
{
"canal": "ZEP SYSTEM",
"Integracao_CodOrgao": 26,
"Integracao_Ambiente": 0,
"Integracao_Token": "123",
"VendaOrdem": false,
"TransacaoVenda": 1,
"TransacaoAssistencia": 0,
"Integracao_CodTabPrecos": 15,
"Integracao_CodCondicaoPrecoVenda": 1,
"ModalidadeFrete": 0,
"Integracao_NaoUtilizaAutenticacaoPadrao": true,
"Integracao_UsuariosNotificacoes": "A",
"Integracao_EmailsNotificacoes": "",
"Integracao_Identificacao": 0
}
- canal...................................: Canal correspondente a ZEP SYSTEM. - Integracao_CodOrgao.....................: Código do órgão cadastrado no sistema correspondente a Zep System. - Integracao_Ambiente.....................: Indicar ambiente de utilização, 0-Homologação/1-Produção. - Integracao_UrlCliente...................: Cada Cliente terá sua própria Url. - Integracao_Token........................: Token de integração do cliente. - VendaOrdem..............................: A Zep System não é venda a Ordem, deve ser informado false. - TransacaoVenda..........................: Transação para venda. - TransacaoAssistencia....................: Atualmente a Zep System não trabalha com assistência, mais já foi criado a tag para facilitar caso venha a trabalhar. - Integracao_CodTabPrecos.................: Código tabela de Preço para vinculo ao documento. - Integracao_CodCondicaoPrecoVenda........: Código condição de pagamento para vinculo ao documento. - ModalidadeFrete.........................: Modalidade de frete. - BuscaItemPelaReferencia.................: Geralmente será falso, deve ser habilitado para clientes que já utiliza a Zep System com outros códigos. - Integracao_NaoUtilizaAutenticacaoPadrao : Informar falso para Zep System pois não utiliza formato padrão de autenticação. - Integracao_UsuariosNotificacoes.........: Usuários para notificações da integração. - Integracao_EmailsNotificacoes...........: E-mails para notificações da integração. - Integracao_Identificacao................: Informa 0 como padrão, não será utilizado pela Zep System.
INTEGRAÇÕES: Importar Documentos (Pedidos/Assist.)
Processamento específico para importação de documentos. Ao executa-lo será exibido uma tela para selecionar todos os documentos que deseja importar, após importar os documentos, não será possível importar o mesmo documento novamente.
Após importação é exibido um detalhamento do que foi importado e também é gravado um arquivo texto no documento com todas as informações importadas da Integração.
Quando o pedido entrar no sistema receberá o status configurado nos parâmetros, padrão DOCUMENTO IMPORTADO.
INTEGRAÇÕES: Compartilhar NFe
Após realizar faturamento do pedido de venda, executar processamento "INTEGRAÇÕES: Compartilhar NFe" para envio dos dados de faturamento para Zep System.
Ao executar será exibido uma tela com filtros de documentos e em seguida será executado o processo.
Após execução desse processamento o status do pedido irá mudar para o configurado nos parâmetros, padrão NFE COMPARTILHADO COM ÓRGÃO.
Agendamento dos processos no Agendador de Tarefas do Windows
Importante: Levante um TekServer somente para execução destes processamentos.
Para realizar o agendamento dos processos no Agendador de Tarefas do Windows, acesse Painel de Controle -> Ferramentas Administrativas -> Agendador de Tarefas.
Selecione Biblioteca do Agendador de Tarefas e clique em Nova Pasta para criar uma pasta chamada Tek-System.
Em seguida selecione a pasta Tek-System e clique em Criar Tarefa...
Na tela "Criar Tarefa" deve seguir um padrão para o nome conforme exemplo abaixo.
Na guia Ações clique em Novo para informar o script a ser executado neste agendamento. Ao clicar em Novo será aberto a tela abaixo.
No campo Programa/Script adicione o script para agendamento conforme descrito abaixo. A execução do processamento é realizada pelo módulo ExecMetodoInterpERP.exe, para executar as funções abaixo é necessário preencher alguns parâmetros, são:
- -T: Token relacionado ao cadastro de usuário;
- -P: Porta de conexão com o TekServer;
- -E: Código da empresa;
- -M: Nome do método a ser executado.
Confira se o módulo ExecMetodoInterpERP.exe está no diretório "C:\tek-system\execmc\". Este módulo fica localizado no diretório dos executáveis do sistema.
Importante: Antes de criar o agendamento para cada script abaixo, faça um teste de execução através do prompt de comando. Para testar a funcionamento do script, copie e cole-o no prompt de comando e tecle Enter para ver o resultado.
Abaixo contém todos os script para cada processamento. o Automatizar a atualização de saldos:
- Automatizar a importação de pedidos do site:
C:\tek-system\execmc\ExecMetodoInterpERP.exe -T:TOKEN -P:5700 -E:1 -M:TEK_INTEGRACOES_PROC_DOCUMENTOS.IMPORTAR('ZEP SYSTEM')
- Compartilhar Notas Fiscais com WebService
C:\tek-system\execmc\ExecMetodoInterpERP.exe -T:TOKEN -P:5700 -E:1 -M:TEK_INTEGRACOES_PROC_COMPARTILHAR_NFE.COMPARTILHAR('ZEP SYSTEM')