Fale conosco
WhatsApp

Outros assuntos

Assuntos diversos. Podem ter ligação com o sistema ou não.

Mensalidade do Sistema

Homologação de Infraestrutura de Redes

Homologação de Infraestrutura de Redes

App Comandas - Sugestão de infraestrutura e configuração mínima necessária para rede de restaurantes e bares que utilizam o Aplicativos de Comandas da tryideas sistemas

 

É bom contratar técnicos experientes para dimensionar e instalar corretamente a infraestrutura a fim de que o tráfego de rede flua corretamente.

É necessário, também, ter em mente que:

a rede de um estabelecimento movimentado deve ser cofiada a verdadeiros profissionais de redes;

a ilustração na imagem acima é uma sugestão que pode ser melhorada/modificada;

bons equipamentos como Unifi e Mikrotik são sugeridos, embora possa ser usado equipamentos TPLink e Mercusys ou outros;

o sistema tem apresentado excelente funcionamento quando não há má configuração e dimensionamento de Rede, portanto se o estabelecimento estiver vazio e os testes são rápidos e ágeis, então quando o estabelecimento encher eles só serão lentos se houver equipamento fraco ou erro de configuração da infraestrutura;

é preciso dimensionar corretamente os equipamentos e quantidade de aparelhos wireless de acordo com os números máximos de pessoas que cabem no estabelecimento e em cada local do estabelecimento para que nunca haja sobrecarga em horários de pico, ou seja, a infraestrutura vai trabalhar ociosa na maior parte do tempo, e deve ser assim para que mesmo nos dias de maior movimento nada saia dos conformes.

 

 

Como consultar o código/descrição ANP do Produto?

O código e descrição da ANP(Agência Nacional do Petróleo, Gás Natural e Biocombustíveis) são informações obrigatórias para produtos como gás, combustíveis entre outros.

No Grupo de Combustíveis, foi adicionado o campo "Descrição ANP" que é obrigatório e deve ser informado com base no SIMP (Sistema de Informações de Movimentação de Produtos).

Este código/descrição deve ser informado no Cadastro do Produto para que quando seja realizada a emissão do documento fiscal não ocorra Rejeição pelo SEFAZ.

Clique em uma das opções:

 


Não tenho o código ANP

Caso não tenha o código ANP, será necessário buscarmos ele na Nota Fiscal Eletrônica de Entrada (aquela que o fornecedor emite para sua empresa).

1° Passo - Localizar a NFe de entrada

Para isto, você deve solicitar ao seu fornecedor que envie o Arquivo XML do documento fiscal que consta os produtos em questão.

Outra opção possível é consultar a Nota Fiscal Eletrônica pela chave de acesso. Essa consulta pode ser feita aqui.  No portal da nota fiscal eletrônica também é possível obter o XML.

Outra opção seria através da Manifestação do destinatário. Poderá salvar o XML. 

2° Passo - Abrir o arquivo XML

Você deverá abrir o arquivo XML clicando sobre o arquivo com o botão direito e indo na opção Abrir com > Internet Explorer.

Abrir arquivo XML com Internet Explorer

3° Passo - Localizar código ANP no arquivo XML

Após abrir o documento fiscal, aperte o atalho Ctrl F  do seu teclado e digite a seguinte informação na caixa de texto que irá surgir: cProdANP em seguida aperte a tecla Enter para que a busca seja feita.

Localizar código ANP no arquivo XML

Perceba que a localização do código está em amarelo, você deverá copiar o código que está entre <cProdANP> </cProdANP>.

4° Passo - Localizar a descrição ANP para o produto

Agora que você já possui o código ANP do seu produto, deveremos consultar a tabela onde constam respectiva descrição para o código.

Você deverá clicar aqui para acessar o documento em PDF com as descrições. Com o documento PDF aberto, aperte o atalho Ctrl F e cole o código que obtemos no passo anterior.

A primeira coluna é o Código ANP e a segunda coluna é a Descrição.

No caso do produto em questão, a descrição que deveremos inserir no cadastro do produto será GÁS LIQUEFEITO INTERMEDIÁRIO.

Com essas informações, você poderá dar seguimento no cadastro de Gás e Combustíveis/Óleos.

 


Tenho o código ANP e desejo verificar apenas qual a respectiva descrição

Caso você tenha o código ANP, poderá seguir a partir do 4° Passo do tópico anterior, onde é feita a busca na tabela.

 

Manual configurações Papel Impressora MP-4000 TH

Instalar:

  1. Virtual Serial Driver 
  2. Driver da impressora

Ambos estão na pasta Z:\Bematech - Drivers - Tem da MP - 4200

Impressora MP-4000 TH cortando papel após imprimir o 35° item de um total de 80 itens no Cupom NFCe.
Para corrigir esse problema siga os passos:

image6.jpg

image3.jpg

image2.jpg

image8.jpg

image1.jpg

image7.jpg

image4.jpg

image5.jpg

 

 

 

 

Como é calculado o custo unitário do produto na importação de XML?

Neste artigo estaremos mostrando como o sistema realiza o cálculo de custo unitário do produto no momento da importação de nota fiscal de entrada. 

Caso você ainda tenha dúvidas sobre como realizar o processo de importação de notas, basta consultar este material.

Para um melhor entendimento estaremos utilizando uma fórmula para realizar este cálculo, vamos lá?!

 

Separando os custos envolvidos

Primeiramente temos que separar os custos POR PRODUTO da nota fiscal, para isso usamos as seguintes fórmulas:

 

Calculando o custo final

Agora que você tem todos os custos envolvidos separadamente, basta incluirmos tudo isso numa fórmula final:

Custo final por produto = (Custo unitário do produto + Valor do seguro por produto + Valor de outras despesas acessórias por produto + Valor de IPI por produto + Valor de ICMS S.T. por produto + Valor de frete por produto) - Valor do desconto por produto;

 

Aplicando todos os conceitos

Nada melhor do que um exemplo para esclarecer o assunto! Para este cálculo vamos considerar os seguintes produtos em uma nota fiscal:

Nome do produto

Quantidade

Custo unitário

Custo total

Abacate 527 1,50 R$ 790,50
Brócolis 313 3,75 R$ 1.173,75
Laranja 869 2,49 R$ 2.163,81‬
   

Valor total dos produtos

R$ 4.128,06

   

Valor total de desconto

R$ 25,00

   

Valor total da nota(considerando impostos e aplicando desconto)

R$ 5.383,51‬

   

Quantidade total de produtos

1709

E também iremos considerar os seguintes impostos presentes nessa nota fiscal:

Valor total de IPI

Valor total de ICMS S.T.

Valor total do seguro

Valor total de outras despesas acessórias

Valor total do frete

R$ 195,79 R$ 289,48 R$ 284,93 R$ 127,35 R$ 357,90

 

Excelente! Agora vamos aplicar as fórmulas que aprendemos anteriormente, vamos começar pelo produto Abacate:

Todos os valores acima estão utilizando a regra padrão de arredondamento da matemática financeira.

Se o algarismo a ser eliminado for maior ou igual a cinco, acrescentamos uma unidade ao primeiro algarismo que está situado à sua esquerda. Se o algarismo a ser eliminado for menor que cinco, devemos manter inalterado o algarismo da esquerda. Fonte: Brasil Escola

Chegamos então aos seguintes resultados:

Agora basta juntarmos tudo para formarmos nosso custo final:

Custo final por produto = (1,50 + 0,1667 + 0,2094 + 0,1146 + 0,1694 + 0,0997) - 0,0146

Custo final do Abacate será R$ 2,2452 ou se preferir arredondar R$ 2,25

Agora que você já sabe como aplicar o custo em um dos produtos, basta repetir o mesmo processo para os demais.

* Lembrando que por padrão o sistema sempre trabalhará com 4 casas após a vírgula(essa opção é configurável), mas caso você opte por trabalhar apenas com duas casas após a vírgula basta arredondar os valores citados acima. 

Pronto! Agora você sabe qual o custo final do seu produto e como ele é calculado em seu sistema. 

Como configurar e-mails zimbra tryideas no Outlook e no Smartphone

Como configurar seu e-mail Zimbra tryideas no Outlook

 

Caso deseja configurar o e-mail Zimbra tryideas dentro do sistema de gestão para envio automático de email - Clique aqui.

 

Existem várias versões do Outllook sendo utilizadas no mercado, o passo a passo abaixo irá contemplar o Outlook na versão 2013, a lógica dos demais é a mesma, apenas o menu de acesso à configuração de uma conta pode ser diferente.

Primeiro, clique em ARQUIVO

Depois clique em Adicionar Conta e a tela abaixo irá aparecer. Selecione então a opção Configuração Manual e avance.

Na próxima tela selecione POP ou IMAP e avance novamente.

Na tela abaixo, você preencherá os campos com os dados a seguir, mas antes explico o que POP e o que é IMAP para que você possa escolher a melhor configuração no caso da sua empresa.

IMAP permite o acesso de vários clientes à mesma caixa de correio, mantendo as mensagens de e-mail disponíveis no servidor para mais tarde lhes aceder através do webmail. Ou seja, se você cadastrar seu e-mail em um aplicativo no celular , no Outlook no computador, e usar também no webmail, todos os comportamentos que fizer no e-mail serão refletidos em todos estes dispositivos. Um e-mail marcado como lido no celular, será marcado como lido no Outlook, por exemplo.

POP3 transfere as mensagens, removendo-as do servidor. Deste modo, os e-mails deixam de estar disponíveis através do webmail ou programa de e-mail. Ou seja, se você cadastrar seu e-mail em um aplicativo no celular, no Outlook no computador, e usar também no webmail, eles irão apenas baixar os e-mails para si, e não terão comunicação de volta de algum comportamento como marcar um e-mail como lido, isso não será refletido para as outras plataformas.

Abaixo a tela de preenchimento de informações, e a seguir a explicação de cada campo.

Nome: Seu nome, cargo ou setor

Endereço de e-mail: Seu e-mail

Tipo de conta: Se é IMAP ou POP3

Servidor de entrada de e-mails: zimbra1.tryideas.com.br

Servidor de saída de e-mails SMTP: zimbra1.tryideas.com.br

Nome de usuário: Seu e-mail novamente

Senha: Sua senha

Após essas informações serem preenchidas, clique no botão MAIS CONFIGURAÇÕES

Na tela que aparecer, na aba Servidor de Saída marque a opção Meu servidor de saída requer autenticação

Configurações de portas POP3 e IMAP no computador

E na aba Avançado, utilize as seguintes portas e configurações abaixo:

Se a configuração for POP3

Servidor de entrada (POP3): 110

Servidor de saída: 465

Criptografia: SSL no servidor de saída.

Se a configuração for IMAP:

Servidor de entrada (IMAP): 993

Criptografia: SSL no servidor de entrada.

Servidor de saída: 465

Criptografia: SSL no servidor de saída.

 

Exemplo de configuração de portas POP3

Exemplo de configuração de portas IMAP

Feito isso, pode dar um OK e avançar, o Outlook fará um teste de envio e recebimento para confirmar que tudo funciona como o esperado. Se houver algum problema no processo, confira novamente a explicação acima e se estiver tudo como recomendamos e ainda assim houverem problemas, nos contate no e-mail web@tryideas.com.br ou no telefone (45) 3055-7688.

 

Como configurar seu e-mail Zimbra tryideas no smartphone

Utilizarei nesse passo a passo o aplicativo GMAIL no Android, porém você pode utilizar no aplicativo de e-mail nativo do seu smartphone ou outro que faça a mesma função, a lógica será a mesma.

Dados de configuração:

Configurações de portas POP3 e IMAP no smartphone

 

Se a configuração for POP3

Servidor de entrada de e-mails: zimbra1.tryideas.com.br

Porta de entrada (POP3): 110

Servidor de saída de e-mails SMTP: zimbra1.tryideas.com.br

Porta de saída: 465

Criptografia: SSL no servidor de saída.

 

Se a configuração for IMAP:

Servidor de entrada de e-mails: zimbra1.tryideas.com.br

Porta de entrada (IMAP): 993

Criptografia: SSL no servidor de entrada.

Servidor de saída de e-mails SMTP: zimbra1.tryideas.com.br

Porta de saída: 465

Criptografia: SSL no servidor de saída.

 

Abra o app Gmail ou baixe ele na playstore ou no itunes

Vá para Configurações

Clique na seta a direita

Clique em Adicionar Conta

Clique em Outro

Digite seu endereço de e-mail;

Selecione Imap ou Pop3 (recomendamos IMAP);

Digite a senha;

Insira o servidor de entrada: zimbra1.tryideas.com.br e a porta de entrada 993 para imap com SSL/TLS, ou 110 para pop3;

Insira o servidor de saída: zimbra1.tryideas.com.br e a porta de saída 465 com conexão SSL/TLS;

Se essas etapas forem cumpridas como recomendamos, o e-mail estará operacional. Se ainda houverem dificuldades, entrem em contato conosco no e-mail web@tryideas.com.br ou no telefone (45) 3055-7688.

 

 

Baixar XML da Nota Fiscal Eletrônica (NFe) no Portal da Nota Fiscal Eletrônica

Para baixar uma nota usando o Portal da NFe primeiramente deve ser aberto o site: www.nfe.fazenda.gov.br

Com o site aberto clique em Consultar NF-e:

Insira a Chave de Acesso da nota em questão, seleciona a opção "Sou Humano" e clique em Continuar:

Vai ser aberto uma página com todas as informações da nota fiscal. Clique no botão Download do documento* (Requer que você selecione o certificado digital de sua empresa para baixar o XML):

Depois de clicar no botão para fazer o download do documento vai aparecer a seguinte mensagem, clie em OK:

Vai abrir a mensagem para selecionar o seu certificado digital, clique sobre e ele e na sequencia em OK:

Feito isso será baixado o arquivo XML da nota fiscal.

Somente é permitido o download do arquivo XML caso o CNPJ do certificado digital esteja figurando na nota fiscal em algum campo.

Liberação do sistema (quando utilizado apenas uma empresa no sistema)

Em caso de necessidade de liberação do sistema, seja por possuir Faturas em atraso, ou estar sem acesso a internet, basta utilizar as instruções a seguir.

I) Acesse o Menu COBRANÇA. Na tela que se abrir, você irá clicar na opção LIBERAR SISTEMA COM CÓDIGO. Em seguida, irá informar o código de liberação (informado por um de nossos técnicos) e clicar em LIBERAR.

II) Feito isso, o sistema vai abrir, e logo em seguida irá se fechar automaticamente.

III) Pronto, basta abrir o sistema novamente que estará liberado.

Observação: Este código de liberação só pode ser utilizado dentro do dia corrente.

Liberação do sistema (quando utilizado mais que uma empresa no sistema)

Em caso de necessidade de liberação do sistema, seja por possuir Faturas em atraso, ou estar sem acesso a internet, basta utilizar as instruções a seguir.

I) Acesse o Menu COBRANÇA. Na tela que se abrir, selecione a FILIAL, e em seguida clique na opção LIBERAR FILIAL COM CÓDIGO. Em seguida, irá informar o código de liberação (informado por um de nossos técnicos) e clicar em LIBERAR.

II) Feito isso, a Filial estará liberada e você já pode utilizá-la no sistema.

Observação: Este código de liberação só pode ser utilizado dentro do dia corrente.

Salvamento de Arquivos quando o cliente utiliza VM (Máquina virtual) fornecida pela tryideas

O processo de Salvamento de uma arquivo, quando o cliente utiliza nossa Máquina Virtual (VM) , é um pouco diferente.

Isso porque o sistema está em um Servidor Remoto, e na hora de Salvar algum arquivo, no momento em que abrir a janela de opções para selecionar o local de Salvamento, você fará um pouco diferente do jeito que está acostumado a fazer, para assim conseguir salvar no seu Computador.

O processo é Simples, basta seguir os passos a seguir:

1) Para salvar um arquivo você deve escolher uma Pasta que esteja no Disco C do computador, você pode utilizar uma pasta já existente em seu Disco C, ou pode criar uma Nova Pasta com o nome que desejar;

2) No momento em que a janela de opções abrir, para você escolher o local de salvamento, você vai escolher as opções conforme a sequência de imagens abaixo:

A) Selecione a opção THIS PC

B) Em seguida, selecione a opção C on (Nome da máquina). Observe que em nosso exemplo, o nome DESKTOP-2EFOOT7 é o nome da máquina usada para este exemplo, para você a opção aparecerá diferente, pois conterá o nome da sua máquina.

C) Feito isso, aparecerão as pastas que estão em seu Disco C

image-1554064334470.png

D) Por último, basta selecionar a pasta Acesso Remoto para o salvamento, e clicar em OK

E) Pronto, o arquivo foi salvo no local escolhido.

Obs: Essa pasta Acesso Remoto deverá ser criada dentro do Disco C e depois terá que ter um atalho na Área de Trabalho, para o cliente localizar ela mais fácil. 

 

Importação de parceiros para o sistema através de planilha

Neste guia vamos tratar a importação de clientes e fornecedores para o seu sistema através de uma planilha do Excel . Essa funcionalidade é interessante para quem tem uma grande quantidade de clientes cadastrados com os dados corretos e atualizados.

 


1° Passo - Obter os dados

A primeira etapa e mais importante é obter os cadastros dos seus clientes. O sistema permite a importação apenas de dados que estão organizados numa planilha (no formato XLS e XLSX , padrões do Excel ).

É de extrema importância que seus cadastros estejam com CPF ou CNPJs corretos, caso contrário essas informações não serão registradas no sistema.

 


2° Passo - Localize a tela de importação

Agora que você já tem todos os dados, vá até o sistema.

Para acessar uma tela de importação, você deve abrir o menu Cadastros e procurar pela opção Gerenciar Cadastros .

Em seguida, faça uma busca utilizando a palavra chave importar, você irá encontrar uma opção chamada Importar Planilha do Excel. Clique sobre ela e será aberta a tela de importação.

 


3° Passo - Carregue a planilha com os clientes/fornecedores

Clique na opção Arquivo(Clique para Selecionar), será aberta uma tela para você selecionar a planilha do Excel que foi obtida no Passo 1.

Em seguida você deverá informar o nome da planilha no Excel(O nome da planilha fica na parte inferior da tela do Excel, onde estão localizadas as abas - exemplo na imagem acima).

Agora você deverá marcar a opção Parceiros nos dados que serão importados e então clicar em Carregar.

Você deverá organizar a disposição das colunas(como mostra a animação abaixo) de modo que fiquem de acordo com essa ordem, pois o sistema necessita dessa disposição de informações para importar os dados corretamente.

Importação-de-parceiros-no-sistema.gif

No exemplo acima é possível ver que a ordem das colunas pode ser alterada apenas arrastando a coluna para o local adequado.

Ordem das colunas na importação

 


4° Passo - Exclusão de colunas adicionais(opcional)

Caso a planilha que você esteja importando tenha mais colunas do que funcionalidade permite(17 colunas no máximo), as mesmas não serão importadas, portanto é muito importante que você remova essas colunas antes de efetivar a importação.

exclusão-de-colunas---importação-de-parceiros.gif

Para isso, basta apertar com o botão direito sobre a coluna que deseja remover e então apertar em Remover Esta Coluna, conforme a animação acima.

Agora é só clicar em Gravar e o sistema exibirá uma barra de progresso da importação. Após ser exibida a mensagem de concluído você poderá conferir na Consulta de Parceiros seus clientes importados.

É de extrema importância que seus cadastros estejam com CPF ou CNPJs corretos, caso contrário essas informações não serão registradas no sistema.

 

Certificado Digital, o que é e quais são os tipos

O que é o Certificado Digital?

É um arquivo eletrônico (ou  cartão A3) que identifica quem é seu titular, seja ele pessoa física e ou Jurídica. Seu principal benefício é realizar assinaturas digitais, identificando o titular, atestando a autenticidade da operação e confirmando a integridade do documento assinado, tudo o que for feito por meio do certificado tem validade jurídica, similar a sua assinatura de próprio punho, só que do mundo virtual. 

Em resumo, é um “Documento Eletrônico de Identidade”, como exemplo, quando se vai realizar uma transação de forma presencial, costuma-se solicitar um documento que comprove sua identidade, porém, na Internet, como as transações são feitas eletronicamente o Certificado Digital surge como forma de garantir a identidade das partes envolvidas. Os tipos de certificados mais comuns são o A1 e o A3.

 

Diferença entre Certificados Digitais A1 e A3

 

Certificado Digital A1

O certificado do tipo A1 é emitido diretamente no computador, pode ser armazenado em seu navegador de internet ou na nuvem, este tipo de certificado possibilita que seja feita cópias de segurança e posteriormente a instalação em outros computadores. Pode ser acessado de qualquer dispositivo, de qualquer lugar do mundo, com total segurança e com muita praticidade.
Validade: O prazo de validade desse tipo de Certificado é de 1 ano.

Vantagens:
Desvantagens:

 

Certificado Digital A3

O certificado do tipo A3 pode ser armazenado em um dispositivo criptográfico, que pode ser um cartão inteligente (necessita de uma leitora), token, ambos protegidos por senha e uma alta camada de criptografia.
Validade: O prazo de validade desse tipo de certificado varia entre 1 até 3 anos.

Vantagens:
Desvantagens:

 

O tipo de certificado digital a ser escolhido depende muito do sistema ou aplicação onde o mesmo será utilizado, agora que você já conhece os tipos de certificado digital, suas vantagens e desvantagens, poderá escolher o que melhor se adapta a sua necessidade e da sua empresa.

Importação de produtos para o sistema através de planilha

Neste guia vamos tratar da importação de Produtos para o seu sistema através de uma planilha do Excel. Essa funcionalidade é interessante para quem tem uma quantidade grande de produtos cadastrados com os dados corretos.

 


1° Passo - Obter os dados

A primeira etapa é obter os cadastros dos seus produtos. O sistema permite a importação apenas de dados que estão organizados numa planilha(no formato XLS e XLSX, padrões do Excel).

É de extrema importância que seus cadastros estejam com NCM, CEST e Código de Barras(CEAN) corretos, caso contrário essas informações não serão registradas no sistema.


2° Passo - Localize a tela de importação

Agora que você já tem todos os dados, vá até o sistema.

Para acessar a tela de importação, você deve abrir o menu Cadastros e procurar pela opção Gerenciar Cadastros.

Em seguida, faça uma busca utilizando a palavra chave importar, você irá encontrar uma opção chamada Importar Planilha do Excel. Clique sobre ela e será aberta a tela de importação.

 


3° Passo - Carregue a planilha com os produtos

Clique na opção Arquivo(Clique para Selecionar), será aberta uma tela para você selecionar a planilha do Excel que foi obtida no Passo 1.

Em seguida você deverá informar o nome da planilha no Excel(O nome da planilha fica na parte inferior da tela do Excel, onde estão localizadas as abas - exemplo na imagem).

Agora você deverá marcar a opção Produtos nos dados que serão importados e então clicar em Carregar.

prod.jpg

Você deverá organizar a disposição das colunas(como mostra a animação abaixo) de modo que fiquem de acordo com essa ordem, pois o sistema necessita dessa disposição de informações para importar os dados corretamente.

Ordem das colunas na importação

5YCOh7cREV.gif

 


4° Passo - Exclusão de colunas adicionais(opcional)

Caso a planilha que você esteja importando tenha mais colunas do que funcionalidade permite(11 colunas no máximo), as mesmas não serão importadas, portanto é muito importante que você remova essas colunas antes de efetivar a importação.

exclusão-de-colunas---importação-de-produtos.gif

Para isso, basta apertar com o botão direito sobre a coluna que deseja remover e então apertar em Remover Esta Coluna, conforme a animação acima.

Agora é só clicar em Gravar e o sistema exibirá uma barra de progresso da importação. Após ser exibida a mensagem de concluído você poderá conferir na Consulta de Produtos seus clientes importados.

É de extrema importância que seus cadastros estejam com NCM, CEST e Código de Barras(CEAN) corretos, caso contrário essas informações não serão registradas no sistema.

Especificações para Integração com o sistema tryideas via API

Especificações para Integração com o sistema tryideas via API

Integração de Pedidos

Iremos descrever neste capítulo, como realizar a integração de Pedidos via api, com o sistema tryideas.

 

 

No campo "codeOrder", utilizar o ID ou algum identificador do Pedido, para evitar o salvamento de Pedidos repetidos, e possibilitar futuras Consultas e Cancelamentos via chamada na api.

Serviços disponíveis
Enviar Pedido:
Endereço IP/SincronizacaoTryApp/api/Orders/SendOrders

Retorno:
true - salvou o pedido com sucesso; ou
erro + a descrição do problema ocorrido.

Consultar Pedido:
Endereço IP/SincronizacaoTryApp/api/Orders/SearchOrders

Retorno:
true - pedido foi localizado (está salvo);
false - pedido não foi localizado com o "codeOrder" informado; ou
erro + a descrição do problema ocorrido.

Cancelar Pedido:
Endereço IP/SincronizacaoTryApp/api/Orders/CancelOrder

Retorno:
true - pedido foi cancelado com sucesso;
nao encontrado - pedido não foi localizado com o "codeOrder" informado; ou
erro + a descrição do problema ocorrido.
Especificações para Integração com o sistema tryideas via API

Integração de Pedido Delivery

Iremos descrever neste capítulo, como realizar a integração de Pedidos via api, com o sistema tryideas.

 

 

No campo "codeOrder", utilizar o ID ou algum identificador do Pedido, para evitar o salvamento de Pedidos repetidos, e possibilitar futuras Consultas e Cancelamentos via chamada na api.

 

Serviços disponíveis
Enviar Pedido:
Endereço IP/SincronizacaoTryApp/api/Orders/SendOrders

Retorno:
true - salvou o pedido com sucesso; ou
erro + a descrição do problema ocorrido.

Consultar Pedido:
Endereço IP/SincronizacaoTryApp/api/Orders/SearchOrders

 

Retorno:
true - pedido foi localizado (está salvo);
false - pedido não foi localizado com o "codeOrder" informado; ou
erro + a descrição do problema ocorrido.

Cancelar Pedido:
Endereço IP/SincronizacaoTryApp/api/Orders/CancelOrder

Retorno:
true - pedido foi cancelado com sucesso;
nao encontrado - pedido não foi localizado com o "codeOrder" informado; ou
erro + a descrição do problema ocorrido.
Especificações para Integração com o sistema tryideas via API

Consultar Ordem de Serviço

Especificações para Integração com o sistema tryideas via API

Obter os Produtos cadastrados

Os serviços abaixo, retornam algumas informações dos itens cadastrados no sistema tryideas.

 

Serviço que obtêm todos os Produtos cadastrados:

Endereço IP/SincronizacaoTryApp/api/Products/GetAllProductsInfo

Json a ser enviado na chamada do serviço.

idFilial - Código do Emitente no sistema tryideas.

idContaEstoque - Campo opcional. Utilizado nos casos em que a empresa trabalha com mais de uma conta de Estoque.

idTabelaPreco - Campo opcional. Utilizado nos casos em que é necessário obter o valor do item, considerando uma variação de preço, já cadastrada e configurada no sistema tryideas.


 

Serviço que obtêm todos os Produtos que tiveram alguma alteração, após uma determinada data:

Endereço IP/SincronizacaoTryApp/api/Products/GetModifyProductsInfo

Json a ser enviado na chamada do serviço.

idFilial - Código do Emitente no sistema tryideas.

idContaEstoque - Campo opcional. Utilizado nos casos em que a empresa trabalha com mais de uma conta de Estoque.

dataUltimaSincronizacao - Data e Hora da última chamada a este serviço, ou ao mencionado acima. Serão retornados os itens que tiveram alguma alteração após a data informada neste campo.

idTabelaPreco - Campo opcional. Utilizado nos casos em que é necessário obter o valor do item, considerando uma variação de preço, já cadastrada e configurada no sistema tryideas.


Campos retornados:

- Código do Produto;

- Código da Classificação do Produto;

- Preço de Venda;

- Quantidade em Estoque;

Json de retorno das chamadas acima.

Especificações para Integração com o sistema tryideas via API

Consulta de Pedidos

Para realizar uma consulta dos Pedidos, faça uma chamada à API utilizando os parâmetros abaixo.

Endereço IP/SincronizacaoTryApp/api/Orders/GetOrders

idFilial - Código do emitente no sistema tryideas.

idOperacao - Código da operação no sistema tryideas. Poderá ser enviado o código desejado, caso queira os pedidos de determinada operação, ou então "0" (zero), para retornar de todas.

dataUltimaSincronizacao - após cada requisição, a data e hora naquele momento deverá ser armazenada, para ser enviada neste campo na próxima solicitação. Apenas os pedidos que tiveram alguma alteração ou inclusão após esta data, serão retornados.

 


 

O retorno da chamada será uma lista de pedidos, algo conforme o exemplo abaixo.

codeOrder - número do pedido no sistema tryideas.

statusPedido - opções disponíveis: recebido, faturado, producao, expedicao ou cancelado.

codProduto - poderá estar no formato "código" ou "código-classificação".

Por exemplo: 1-10 onde 1 é o código do produto e 10 o código da Classificação (variação) deste produto.

Como fornecer uma conexão remota através do aplicativo AERO ADMIN

Este conteúdo vai te mostrar como você fornecer uma conexão remota ao seu computador, utilizando o Aplicativo AERO ADMIN.

O primeiro passo é você ter este aplicativo instalado em seu computador.

Caso você não o tenha, acesse: https://www.aeroadmin.com/en

A partir daí, vamos enumerar os passos:

1 - Clique em

2 - Após ter ocorrido o Download, Execute o aplicativo

3 - Na tela que se abrir, você terá a informação do SEU ID e também da SENHA/PIN. Forneça estas duas informações.

 

4 - Para a conexão remota se concretizar, você precisará permitir a conexão, aceitando a opção que vai aparecer na sua tela:

Pronto ! A conexão remota vai ser realizada.

Importação da Tabela de NCM's

Este manual visa explicar de forma detalhada como é realizada a manutenção e importação de novos NCM's através de Tabela disponibilizada pela Receita Federal.

Esta tabela vem sendo atualizada regulamente, e com isso se faz necessário mantermos os cadastros dos produtos atualizados, considerando os novos códigos e também os antigos que são removidos e não serão mais aceitos nas notas fiscais, podendo ocorrer rejeição no envio do documento fiscal, para a Receita Estadual.

 

Menu: Cadastros > Gerenciar Cadastros > Importar Tabela NCM.

Após abrir a tela citada no menu acima, observe que a mesma possui duas opções, Arquivo Json e Planilha Excel.

Arquivo Json (recomendável)

Utilize preferencialmente esta opção para importar a tabela, pois o sistema fará o download automaticamente, tornando o processo muito mais prático do que a Planilha do Excel.

Observe na animação abaixo, como é realizado o processo de importação dos dados da Tabela NCM através do Arquivo Json. Basta clicar em Carregar dados, e aguardar o sistema carregar os dados e analisar as informações.

Tabela-NCM.gif

Após carregar os dados da tabela, será possível visualizar os detalhes analisados pelo sistema no rodapé da tela.

Observe que são exibidas algumas informações como:

- Novos NCMs; Esta quantidade representa os NCMs novos, ou seja, que ainda não estão cadastrados no sistema;

- NCMs a serem removidos: Exibe a quantidade de NCMs cadastrados no sistema que estão inválidos ou foram removidos da tabela, e precisam ser removidos, para evitar informar algum destes códigos no cadastro do produto e causar a rejeição do documento fiscal por NCM inválido.

Caso queira visualizar quais são os NCMs inválidos que devem ser removidos, clique no local indicado "visualizar os códigos".

- Itens com NCM inválido: Irá exibir se possui produtos com NCM inválido no cadastro, ou seja, que precisam ser revisados e corrigidos para evitar rejeição na emissão do documento fiscal;

 

 
Cadastrar Novos NCMs

O primeiro passo a ser realizado é cadastrar os novos NCMs, para isso clique no botão Cadastrar Novos NCMs no rodapé da tela. Esta opção também irá remover os NCMs inválidos que estão cadastrados.

Aguarde o final do processo, e confirme as mensagens que serão exibidas.

Ajustar NCMs inválidos no cadastro do Item

Após cadastrar os novos NCMs, podemos realizar a manutenção dos NCMs que estão incorretos no cadastro do Produto, para isso clique no botão Ajustar NCMs dos itens.

Uma tela será aberta, conforme animação abaixo. Serão carregados todos os itens ativos, que possuam o NCM incorreto. Observe que é possível definir o NCM manualmente no campo, ou então utilizar o recurso que facilita os ajustes, onde você irá selecionar o NCM antigo, e o novo, ao qual deseja alterar. Desta forma o sistema irá localizar os itens com o NCM antigo, e vincular o novo selecionado.

Ajuste-NCM.gif

Após finalizar as alterações desejadas, clique na opção Salvar.

 

Planilha do Excel

Utilize esta opção apenas em últimos casos, ou quando a opção pelo arquivo json não funcionar.

Realize o Download da Tabela através do site da Receita Federal, ou então no direto pelo Portal Siscomex.

Selecione a opção XLSX sem descrição concatenada, e clique na opção Download. Salve o arquivo em um local de fácil acesso, pois iremos precisar deste arquivo.

O próximo passo é selecionar e importar o arquivo do passo acima. Na tela de Importação da Tabela NCM, selecione a opção Planilha Excel, e selecione o arquivo conforme animação abaixo, e após clique em Carregar dados.

Tabela-NCM-Excel.gif

A planilha geralmente está com as colunas na sequencia correta, caso não esteja, um erro poderá ser exibido, pois o sistema não conseguiu ler os dados conforme a estrutura esperada.

Os próximos passos já foram explicados acima, na opção Arquivo Json, volte e veja os detalhes de como cadastrar os novos NCMs e ajustar os incorretos.

 

Tabela de Código de UF do IBGE

A seguinte codificação adotada pelo IBGE deverá ser utilizada para representar o código da UF, segue abaixo uma lista de tabelas de UF por região do Brasil.

 

Região Norte

Código Estado Sigla
11 Rondônia RO
12 Acre AC
13 Amazonas AM
14 Roraima RR
15 Pará PA
16 Amapá AP
17 Tocantins TO

 


Região Nordeste

Código Estado Sigla
21 Maranhão MA
22 Piauí PI
23 Ceará CE
24 Rio Grande do Norte RN
25 Paraíba PB
26 Pernambuco PE
27 Alagoas AL
28 Sergipe SE
29 Bahia BA

 


Região Sudeste

Código Estado Sigla
31 Minas Gerais MG
32 Espirito Santo ES
33 Rio de Janeiro RJ
35 São Paulo SP

 


Região Sul

Código Estado Sigla
41 Paraná PR
42 Santa Catarina SC
43 Rio Grande do Sul RS

 


Região Centro-Oeste

Código Estado Sigla
50 Mato Grosso do Sul MS
51 Mato Grosso MT
52 Goiás GO
53 Distrito Federal DF

 

 

 

GNRE - Guia Nacional de Recolhimento de Tributos Estaduais

O sistema tryideas possui integração para a geração de guias para pagamento de tributos estaduais, facilitando o processo de preenchimento e geração do lote.

 

Implementação da integração: Versão 766

 

O primeiro passo a ser realizado, é solicitar a habilitação do uso do webservice, através do seguinte link. Informe o CNPJ, Razão Social e E-mail. (https://www.gnre.pe.gov.br:444/gnre/portal/automacao.jsp#)

Para o uso do webservice, é necessário possuir o Certificado Digital da empresa, que deverá estar previamente instalado e configurado.


 

Quando a empresa possui IE na UF de destino, a guia do Difal é paga mensalmente, e não por Nota Fiscal.

Cadastro e Consulta de Inscrição Estadual em outras UF's

Caso a empresa possua inscrição estadual em outros estados, iremos realizar a configuração no sistema para identificar essa IE.

Acesse o menu: Cadastros > Gerenciar Cadastros, e localize a opção Cadastrar IE em outra UF.

Selecione a Filial, o Estado e informe a Inscrição Estadual da empresa na UF selecionada, e ou o Número do Convênio.

O Estado do Rio Grande do Norte exige o Número do Convênio na geração da GNRE com Receita 100102, desta forma para automatizar o processo de geração, este cadastro deverá ser realizado previamente.

Para consultar as IE já cadastradas em outros estados, é só acessar o menu Consultar IE outras UFs:

Na tela de consulta também pode ser feita a edição de algum cadastro efetuado, só clicar no botão Editar, alterar o que precisar e clicar em Gravar (F5).

A tela acima também permite configurar as UF's na qual a guia não deverá ser gerada. Basta selecionar a opção "Não gerar GNRE para a UF", desta forma as notas selecionadas com destinatário para estas UF's não terão a guia gerada.


 

Geração de guia do DIFAL pela Nota Fiscal

Após a emissão da Nota Fiscal destinada a consumidor final de outra UF, ou seja, em operações interestaduais, podemos realizar a geração da guia para pagamento e posterior envio da mercadoria para o Estado do destinatário.

Para este processo, localize a Nota Fiscal gerada através do menu: Movimento (ou Nota Fiscal no plano básico) > Consultar Nota (NFe/NFCe). Com a Nota Fiscal selecionada, clique sobre a opção Gerar GNRE, conforme destacado na imagem abaixo.

A seguinte tela será exibida, onde a UF Favorecida estará selecionada, conforme o Estado de domicílio do Destinatário da Nota Fiscal, e as informações estarão previamente carregadas, sendo necessário uma simples conferência dos valores para garantir que tudo esteja pronto para o envio e processamento da guia.

Os campos em Negrito, são obrigatórios, e os demais são opcionais, que poderão ou não ser informados.

Ao editar a Receita para conferir as informações, a seguinte tela será exibida, podendo possuir outras informações dependendo do Estado do Destinatário.

As opções e campos exibidos na tela acima, variam para cada UF, e por Receita. Cada Estado possui as suas próprias configurações, desta forma, dependendo da Receita selecionada, os campos e opções serão recriadas, afim de se exibir as informações exigidas e/ou válidas para a UF favorecida.

Após o preenchimento das informações, clique na opção Adicionar Receita, ou então no atalho F5 do teclado.

Confirme as informações da tela inicial, e se tudo estiver ok, clique na opção Gravar (F5), para realizar o processamento do lote.

Abaixo temos uma ilustração do processo de geração da guia através da Nota Fiscal.

GNRE.gif

Na Consulta de Notas, podemos incluir uma coluna com um identificador, que irá exibir se a Nota Fiscal já teve a guia gerada, para facilitar os controles internos.


 

Consulta de GNRE

Para realizar a consulta das guias geradas, ou então para verificar algum possível erro ocorrido no momento da geração, acesse o menu: Banco > Consultar GNRE.

Editar - clicando sobre o botão, ou com dois cliques sobre o registro selecionado, é possível editar as informações, caso tenha ocorrido alguma rejeição no processamento do lote.

Enviar - em caso de algum erro no envio do lote, é possível solicitar o reenvio. OBS: ao gerar uma nova guia, ou ao editar, quando salvar o registro, o mesmo é transmitido automaticamente.

Consultar Status - esta opção permite consultar o status do processamento da GNRE, nos casos em que ocorre uma demora no processamento após o envio.

Imprimir Guia - esta opção permite a visualização/impressão da guia para pagamento.

Nova Guia - ao clicar sobre esta opção, a tela de geração da GNRE será exibida, para uma emissão manual.

 

Para visualizar as informações preenchidas no momento da geração da GNRE, expanda o registro desejado clicando sobre a opção "+" no inicio da linha. Também é possível consultar os erros ocorridos na aba Histórico Eventos, caso alguma informações preenchida não esteja de acordo com o esperado pelo serviço do webservice.

GNRE_Dados.gif

 

Importar Tabela IBPT ou Cadastrar e Consultar Códigos IBPT

Importar Tabela IBPT 

Este manual visa explicar de forma detalhada como importar a tabela IBPT para nosso sistema TryErp.

Para obter a tabela atualizado, você precisa conectar sua conta no site de olho no imposto, se não tiver uma conta cadastrada, você pode cadastrar clicando aqui.

Para cadastrar e baixar a tabela do site de olho no imposto, você pode estar pegando as informações necessárias com seu contador.

 

Assim que estiver com a nova tabela IBPT baixada, iremos para o sistema para importar essa nova tabela.

Nas três opções que vai encontrar, selecione importar tabela IBPT.

Cadastrar códigos IBPT 

Consultar Códigos IBPT

Para consultar código IBPT,

 

Integração Loggi

A Loggi é uma plataforma logística que conecta empresas e consumidores a uma ampla rede de entregas, oferecendo soluções ágeis e eficientes para transporte de mercadorias. Com tecnologia avançada, a Loggi permite calcular cotações de frete em tempo real, gerar pacotes e etiquetas para envio, além de fornecer rastreamento detalhado das entregas.

Este documento apresenta o funcionamento dos principais recursos integrados à Loggi, incluindo:

Esses recursos garantem maior controle sobre o fluxo logístico, otimizando a gestão de envios e proporcionando uma experiência mais transparente para clientes e parceiros.


 

Configuração

Para utilizar os recursos da Loggi, será necessário realizamos algumas configurações. Abra o menu Configurações > Configurações Adicionais e localize a aba Frete Envios.

 

Após definir as configurações, clique em Salvar para realizar um teste de autenticação com a plataforma, onde será validado se as credenciais informadas estão corretas.


 

Cadastro das Embalagens

Para realizar a cotação de frete ou a criação da pré-postagem, é necessário que as embalagens já estejam previamente cadastradas no sistema.

Para realizar o cadastro da embalagem, acesse o menu: Cadastros > Produtos > Cadastrar Produto.

Realize o cadastro de todas as variações de embalagens que possui, para que ao realizar a cotação do Frete ou a Pré-Postagem, o sistema consiga localizar a embalagem adequada de forma automática.


 

Cotação de Frete

Para realizar a cotação de frete de forma correta e obter os valores precisos, é essencial que todas as informações estejam devidamente preenchidas. Abaixo estão os requisitos fundamentais que devem ser atendidos antes de iniciar o processo de cotação:

1. Dados do Emitente

O emitente deve estar cadastrado corretamente no sistema, e em caso de Drop Off, configure corretamente os dados do Ponto de Postagem, contendo o endereço correto. Este ponto de postagem deverá estar definido nas configurações adicionais do Frete Envios que tratamos no parágrafo acima.

2. Dados do Destinatário

Assim como o emitente, o destinatário deve possuir cadastro completo com:

3. Produtos a serem enviados

Todos os produtos incluídos na cotação devem estar previamente cadastrados no sistema. Para cada item, é necessário observar os seguintes pontos:

4. Endereços corretos e validados

Os endereços de origem e destino devem ser informados com precisão para garantir que a cotação seja gerada corretamente.

5. Cálculo das medidas Totais

O cálculo das dimensões do pacote deve atender aos limites da transportadora, garantindo que:

Importante: Caso algum dos dados acima esteja incorreto ou incompleto, a cotação poderá ser imprecisa ou até mesmo não ser gerada. Certifique-se de revisar todas as informações antes de prosseguir.

O cálculo assume uma disposição eficiente dos produtos no pacote, tentando minimizar o volume sem ultrapassar os limites individuais de cada item.

O cálculo é realizado considerando o empilhamento dos itens, ou seja, é considerado o maior comprimento e largura, e com base nisso, um acréscimo na altura é realizado para cada item. Se os limites máximos forem atingidos, um novo pacote será gerado.

A consulta da cotação do valor do Frete, está disponível nas seguintes telas:

Nas telas citadas acima, na parte superior localize a seguinte opção, conforme ilustrado na imagem abaixo.

Ao clicar no botão, uma nova tela será exibida, contendo as informações que foram definidas na tela de emissão, confira os dados se estão todos corretos, e clique na opção Calcular Frete. Uma consulta será realizada, e em caso de sucesso na comunicação, as opções de envio serão exibidas na tela, contendo o valor cotado, o prazo de dias para a entrega, o tipo da entrega e da coleta, entre outras informações.

Para confirmar a cotação, selecione-a na lista, e clique no botão Selecionar no rodapé da tela. Com isso, o valor selecionado será aplicado ao Pedido ou a Nota Fiscal, sendo considerado este valor no frete, recalculando o valor total do registro.


 

Geração de Pacotes

Após a realização do Faturamento do Pedido e/ou da Emissão da Nota Fiscal, a próxima etapa é a Geração dos Pacotes. Esse processo utiliza as mesmas informações definidas na cotação para garantir que o envio seja realizado corretamente. A seguir, estão os requisitos e passos necessários para a geração dos pacotes.

1. Utilização das Informações da Cotação

Todas as informações fornecidas na cotação serão reaproveitadas automaticamente na geração dos pacotes, incluindo:

2. Consolidação dos Produtos em Pacotes

Os produtos informados na cotação serão agrupados em pacotes de acordo com suas dimensões e pesos, respeitando os seguintes critérios:

3. Conferência dos Pacotes

Antes de finalizar a geração dos pacotes, é importante revisar:

4. Finalização e preparação para Envio

Após a conferência, os pacotes podem ser finalizados e preparados para envio. Abaixo iremos detalhar os passos para a geração dos pacotes.

Caso algum produto não tenha sido incluído corretamente ou as dimensões e pesos não estejam adequados, o envio poderá ser comprometido. Sempre verifique as informações antes de concluir a geração dos pacotes.

 

Na Consulta de Notas, disponível no menu Movimento > Consultar Nota > Notas (NFe/NFCe), localize e selecione a Nota Fiscal que deseja gerar o pacote, e clique na opção Pacote Envio (se o botão estiver oculto, solicite ao suporte para habilitá-lo na tela).

A tela de Geração de Pacotes será exibida, com os campos previamente preenchidos. Confira as informações, endereços, Pesos e Medidas calculados, e clique em Enviar Pacotes.

Se as informações estiverem ok, e nenhum problema ocorrer, uma nova tela para realizar a geração das Etiquetas será exibido.


 

Consulta de Pacotes

Essa tela permite a consulta e gerenciamento de pacotes gerados para envio, apresentando campos de filtro e botões de ação para facilitar a operação.

Menu: Cadastros > Gerenciar Cadastros > Consultar Frete Envios.

Botões de Ação:

Na parte inferior da tela, há diversos botões para gerenciar os pacotes:

A tela de Consulta de Pacotes utiliza um sistema de cores para facilitar a identificação do status de cada pacote, tornando a gestão e acompanhamento mais intuitivos.

Essa diferenciação por cores agiliza a verificação do status, permitindo que os usuários tomem ações rapidamente, como corrigir erros, reenviar pacotes ou verificar detalhes de cancelamento.

Detalhamento de algumas colunas:

A tela de consulta possui diversas colunas com informações relacionadas aos pacotes gerados, bem como as notas fiscais vinculadas. Dentre as colunas exibidas por padrão, existem ainda outras que estão ocultas, e podem ser habilitadas conforme a necessidade. (Para consultar a documentação de personalização de colunas, consulte o manual clicando aqui).

Vamos destacar abaixo algumas colunas e suas particulariedades:

Dados Gerais do Envio:

Dados do Pacote:

Nesta grid, podemos visualizar os Pacotes gerados para o envio, bem como as suas dimensões, peso, Código de Rastreio e de Barras, Tipo do Frete, entre outros, como a URL de rastreio descrita abaixo.

Notas Fiscais:

Expandindo os dados do Pacote, podemos visualizar as Notas Fiscais relacionadas ao pacote, onde constam as informações como Número, Série, Data de Emissão, Chave de Acesso, entre outros.


 

Geração de Etiquetas

Nessa tela, podemos definir algumas opções para a geração das etiquetas a serem coladas nos pacotes, conforme detalhado abaixo:


 

Realizar Rastreio

A funcionalidade do rastreio, permite acompanhar em tempo real o status das entregas, garantindo verificar cada etapa do transporte das mercadorias. Através do rastreamento, é possível verificar onde o pacote está, se já foi coletado, em trânsito ou entregue ao destinatário.

Na consulta de pacotes, selecione o registro desejado, e clique sobre a opção Realizar Rastreio. A seguinte tela será exibida, contendo a última informação de status do pacote.

Para visualizar todo o histórico, clique na seta "+" no início da linha, onde a grid será expandida exibindo todos os status do pacote.


 

Cancelar Envio

Esta opção permite cancelar o envio de um pacote, desde que o mesmo não tenha sido concluído, retornando-o ao remetente. *Cobranças extras poderão ser aplicadas.

Detalhes importantes:

Ao clicar sobre a opção, uma mensagem de confirmação será exibida, solicitando se deseja realmente solicitar o cancelamento do envio.

Apenas Pacotes registrados podem ser cancelados, ou seja, que possuem o status 202 e estejam na cor verde. Se o pacote já estiver cancelado, e for solicitado o cancelamento, um aviso será exibido.


 

Conferência de Notas Fiscais com Pacote Gerado

Para conferir as Notas Fiscais que possuem ou não pacote de envio gerado, basta realizar a consulta pela tela no menu:
Movimento > Consultar Nota > Consultar NFe/NFCe.

A coluna "Pacote Gerado?" é o indicador se existe um pacote gerado para a Nota Fiscal ou não. A coluna está oculta por padrão, basta inseri-la na grid e salvar o layout, para que o campo sempre esteja visível.

 

Integração Correios

Esta documentação descreve o processo de integração do sistema tryideas com os Correios, permitindo a automação de diversas operações logísticas, como cotação de frete, geração de pré-postagem, emissão de rótulos e cancelamento de pré-postagem.

Através dessa integração, o ERP facilita o envio de mercadorias, garantindo mais eficiência e precisão no cálculo de custos e no gerenciamento das remessas. Os principais benefícios incluem:

A seguir, serão apresentados os requisitos técnicos, fluxos de integração e exemplos práticos para facilitar a implementação e utilização desses serviços dentro do ERP.


 

Configuração

Para utilizar a integração com os Correios, será necessário realizamos algumas configurações. Abra o menu Configurações > Configurações Adicionais e localize a aba Frete Envios.

Após definir as configurações, clique em Salvar para realizar um teste de autenticação com a plataforma, onde será validado se as credenciais informadas estão corretas.

 

Geração de código de acesso as API's

Caso já possua um código gerado, utilize o mesmo, pois este pode estar configurado em outras aplicações ou plataformas, e uma regeração deste código irá parar os outros serviços.

Caso ainda não possua este código de API gerado, abra o seguinte link https://cws.correios.com.br/acesso-componentes. Informe o Usuário e Senha, e clique em Regerar código. Copie o código gerado, salve-o em algum local seguro.

O código gerado acima, iremos colar no campo Client Secret, conforme descrito nas configurações acima, e após preencher todas as informações, clique no campo Salvar para realizar a autenticação.


 

Cadastro das Embalagens

Para realizar a cotação de frete ou a criação da pré-postagem, é necessário que as embalagens já estejam previamente cadastradas no sistema.

Para realizar o cadastro da embalagem, acesse o menu: Cadastros > Produtos > Cadastrar Produto.

Realize o cadastro de todas as variações de embalagens que possui, para que ao realizar a cotação do Frete ou a Pré-Postagem, o sistema consiga localizar a embalagem adequada de forma automática.


 

Cotação de Frete

Para realizar a cotação de frete de forma correta e obter os valores precisos, é essencial que todas as informações estejam devidamente preenchidas. Abaixo estão os requisitos fundamentais que devem ser atendidos antes de iniciar o processo de cotação:

1. Dados do Emitente

O emitente deve estar cadastrado corretamente no sistema, e em caso de Drop Off, configure corretamente os dados do Ponto de Postagem, contendo o endereço correto. Este ponto de postagem deverá estar definido nas configurações adicionais do Frete Envios que tratamos no parágrafo acima.

2. Dados do Destinatário

Assim como o emitente, o destinatário deve possuir cadastro completo com:

3. Produtos a serem enviados

Todos os produtos incluídos na cotação devem estar previamente cadastrados no sistema. Para cada item, é necessário observar os seguintes pontos:

4. Endereços corretos e validados

Os endereços de origem e destino devem ser informados com precisão para garantir que a cotação seja gerada corretamente.

5. Cálculo das medidas Totais

O cálculo das dimensões do pacote deve atender aos limites da transportadora, garantindo que:

Importante: Caso algum dos dados acima esteja incorreto ou incompleto, a cotação poderá ser imprecisa ou até mesmo não ser gerada. Certifique-se de revisar todas as informações antes de prosseguir.

O cálculo assume uma disposição eficiente dos produtos no pacote, tentando minimizar o volume sem ultrapassar os limites individuais de cada item.

O cálculo é realizado considerando o empilhamento dos itens, ou seja, é considerado o maior comprimento e largura, e com base nisso, um acréscimo na altura é realizado para cada item. Se os limites máximos forem atingidos, um novo pacote será gerado.

A consulta da cotação do valor do Frete, está disponível nas seguintes telas:

Nas telas citadas acima, na parte superior localize a seguinte opção, conforme ilustrado na imagem abaixo.

Ao clicar no botão, uma nova tela será exibida, contendo as informações que foram definidas na tela de emissão, confira os dados se estão todos corretos, e clique na opção Calcular Frete. Uma consulta será realizada, e em caso de sucesso na comunicação, as opções de envio serão exibidas na tela, contendo o valor cotado, o prazo de dias para a entrega, o tipo da entrega e da coleta, entre outras informações.

Para confirmar a cotação, selecione-a na lista, e clique no botão Selecionar no rodapé da tela. Com isso, o valor selecionado será aplicado ao Pedido ou a Nota Fiscal, sendo considerado este valor no frete, recalculando o valor total do movimento.


 

Pré-Postagem Nacional (objetos registrados)

Após a realização do Faturamento do Pedido e/ou da Emissão da Nota Fiscal, a próxima etapa é a Criação da Pré-Postagem. Esse processo deverá utilizar as mesmas informações definidas na cotação para garantir que o envio seja realizado corretamente. A seguir, estão os requisitos e passos necessários para a geração dos pacotes.

1. Utilização das Informações da Cotação

Todas as informações fornecidas na cotação serão reaproveitadas automaticamente na geração dos pacotes, incluindo:

2. Consolidação dos Produtos em Embalagem adequada

Os produtos informados na cotação serão agrupados de acordo com suas dimensões e pesos, localizando a embalagem ideal para utilizar a menor possível. Alguns critérios no cadastro da embalagem deve ser considerados:

3. Conferência dos Pacotes

Antes de finalizar a geração da pré-postagem, é importante revisar:

4. Finalização e preparação para Envio

Após a conferência, os pacotes podem ser finalizados e preparados para envio. Abaixo iremos detalhar os passos para a geração dos pacotes.

Caso algum produto não tenha sido incluído corretamente ou as dimensões e pesos não estejam adequados, o envio poderá ser comprometido. Sempre verifique as informações antes de concluir a geração dos pacotes.

 

Na Consulta de Notas, disponível no menu Movimento > Consultar Nota > Notas (NFe/NFCe), localize e selecione a Nota Fiscal que deseja gerar o pacote, e clique na opção Pacote Envio (se o botão estiver oculto, solicite ao suporte para habilitá-lo na tela).

A tela de Geração de Pacotes será exibida, com os campos previamente preenchidos. Confira as informações, endereços, Pesos e Medidas calculados, e clique em Enviar Pacotes.


 

Consulta de Pacotes

Essa tela permite a consulta e gerenciamento de pacotes gerados para envio, apresentando campos de filtro e botões de ação para facilitar a operação.

Menu: Cadastros > Gerenciar Cadastros > Consultar Frete Envios.

Botões de Ação:

Na parte inferior da tela, há diversos botões para gerenciar os pacotes:

A tela de Consulta de Pacotes utiliza um sistema de cores para facilitar a identificação do status de cada pacote, tornando a gestão e acompanhamento mais intuitivos.

Essa diferenciação por cores agiliza a verificação do status, permitindo que os usuários tomem ações rapidamente, como corrigir erros, reenviar pacotes ou verificar detalhes de cancelamento.

Detalhamento de algumas colunas:

A tela de consulta possui diversas colunas com informações relacionadas aos pacotes gerados, bem como as notas fiscais vinculadas. Dentre as colunas exibidas por padrão, existem ainda outras que estão ocultas, e podem ser habilitadas conforme a necessidade. (Para consultar a documentação de personalização de colunas, consulte o manual clicando aqui).

Vamos destacar abaixo algumas colunas e suas particulariedades:

Dados Gerais do Envio:

Dados do Pacote:

Nesta grid, podemos visualizar os Pacotes gerados para o envio, bem como as suas dimensões, peso, Código do Objeto, Tipo do Frete, entre outros, como a URL de rastreio descrita abaixo.

Notas Fiscais:

Expandindo os dados do Pacote, podemos visualizar as Notas Fiscais relacionadas ao pacote, onde constam as informações como Número, Série, Data de Emissão, Chave de Acesso, entre outros.


 

Geração de Etiquetas

Nessa tela, podemos definir algumas opções para a geração das etiquetas a serem coladas nos pacotes, conforme detalhado abaixo:

Na realização de testes, algumas opções de etiqueta não estavam funcionando, retornando um erro por parte da api dos Correios.


 

Realizar Rastreio

A funcionalidade do rastreio, permite acompanhar em tempo real o status das entregas, garantindo verificar cada etapa do transporte das mercadorias. Através do rastreamento, é possível verificar onde o pacote está, se já foi coletado, em trânsito ou entregue ao destinatário.

Na consulta de pacotes, selecione o registro desejado, e clique sobre a opção Realizar Rastreio. A seguinte tela será exibida, contendo a última informação de status do pacote.

Para visualizar todo o histórico, clique na seta "+" no início da linha, onde a grid será expandida exibindo todos os status do pacote.


 

Cancelar Pré-Postagem

Esta opção permite cancelar a pré-postagem gerada, desde que o mesmo ainda não tenha sido postado.

Ao clicar sobre a opção, uma mensagem de confirmação será exibida, solicitando se deseja realmente solicitar o cancelamento do envio.

Apenas Pacotes registrados podem ser cancelados, ou seja, que possuem o status 200 e estejam na cor verde. Se o pacote já estiver cancelado, e for solicitado o cancelamento, um aviso será exibido.


 

Conferência de Notas Fiscais com Pacote Gerado

Para conferir as Notas Fiscais que possuem ou não pacote de envio gerado, basta realizar a consulta pela tela no menu:
Movimento > Consultar Nota > Consultar NFe/NFCe.

A coluna "Pacote Gerado?" é o indicador se existe um pacote gerado para a Nota Fiscal ou não. A coluna está oculta por padrão, basta inseri-la na grid e salvar o layout, para que o campo sempre esteja visível.

 

 

Como localizar arquivos do seu computador utilizando HTML5 ou Remote App

Nesse manual estaremos conferindo como salvar e localizar arquivos quando seu sistema é online. Faremos tanto por HTML5, quanto por Remote App, que são as duas formas de conexão ao sistema online.

 

POR HTML5:

Darei 2 exemplos aqui de salvamento de arquivo, um de nota fiscal e um de ticket.

  1. Nota Fiscal:

Integração Galderma

Manual do passo a passo para configuração do sistema visando realizar a integração com a Galderma:

1 - Dados de integração do emitente na tela Configurações > Configurações Adicionais > aba Galderma:

Selecionar a filial, informar a URL, o token e a commercial table.

URL produção: https://canal.mygaldermastore.com.br/rest/reseller

URL homologação: https://canal-staging.mygaldermastore.com.br/rest/reseller

Token: informado pela Galderma;

Commercial Table: informado pela Galderma;

2 - Configurar parâmetro na Marca, indicando que aqueles produtos vinculados a mesma são Galderma: Cadastros > Gerenciar Cadastros> Consultar ou Cadastrar Marcas, ative o parâmetro Produto Galderma;

3 - Configurar a operação, indicando que ela irá realizar o envio para a API. Menu Cadastros > Gerenciar Cadastros > Consultar Operações, aba Mais Opções na edição da operação;

Marcar o parâmetro Realizar o Envio Galderma;

4 - Configurar a condição de pagamento com o código Galderma, conforme essas opções:

Utilizar o campo Código Integração Galderma, em Cadastros > Financeiro > Consultar Condição de Pagamento:

5 - Configurar o parâmetro nas Configurações > Configurações Globais > NFe/Movimento > Configurações da NFe, parâmetro Exigir Informar a Chave da NFe Devolvida, para o sistema avisar e exigir durante a emissão de uma devolução, que a chave da nota devolvida sejam referenciada.

Se faz necessário devolver uma nota por vez, devido a integração.

6 - No produto, configurar o campo Cód. Barras Etiqueta conforme o SKU disponibilizado pela Galderma, além de vincular a Marca que foi anteriormente configurada. O campo está disponível em Cadastros > Produtos > Consultar Produtos > segunda aba do cadastro, em Dados Adicionais (Opcional):

Exemplo do preenchimento da marca:

SKU's de teste para homologação:

7 - Para realizar homologações, utilize: CNPJ 74439343000193 ou CPF 00556659503;

Validações e Processo de Envio

Ao gerar uma nota fiscal, o sistema realizará as seguintes validações:

Se houver produtos de outras marcas misturados:

Após a emissão e autorização da nota:

  1. O sistema consultará automaticamente a base da Galderma para verificar se o CNPJ ou CPF já existe.

  2. Se existir, a nota será enviada imediatamente.

  3. Se não existir, a nota ficará pendente e será possível consultá-la e reenviá-la manualmente pela tela de consulta de integrações:

galderma.jpeg

Essa tela disponibiliza:

Se houver erros no momento da consulta ou envio, eles serão listados para correção e reprocessamento.