Histórico da Página

Objetivo

Nesta documentação estão descritos os procedimentos para realizar a integração automatizada para importar os produtos da Simplus para o ERP.

Caminho

Integrador > Configuração

Pré-Requisitos e Restrições

Ter atualizado ERP, a partir da versão 19.04.066 ou 20.01.012.

Para a correta utilização, é necessária a instalação de algumas APIs Consinco: API de Autenticação – versão 6.1.0.0, Comercial Geral API e Comercial Produto API v1/v2.

Ter realizado a instalação da Aplicação para Integração Simplus Consinco pelo Consinco Web Setup. Clique aqui e acesse a documentação. No No Consinco Web Setup na tela tela Nova Publicação, no campo campo Nome, informe informe Consinco_Simplus.

Ter ajustado as configurações de uso do Integrador. Clique aqui e acesse a documentação.

Ter gerado um Token para acessar o Integrador. Clique aqui e acesse a documentação.

Ter solicitado um Token de acesso da Simplus. Para maiores informações, acesse acesse https://simplustec.com/.

Passo a Passo

Configurando Divisões

Acesse: Integrador Integrador > Configuração.

Ao acessar o integrador pela primeira vez, deve-se definir a configuração inicial para utilização do sistema que consiste em:

Salvar divisões padrão;
Salvar token, empresa e intervalo.

Na área Divisões Divisões Padrão, selecione os campos indicados de acordo com a necessidade.

Após a escolha da configuração da divisão, clique em em Salvar divisão.

Nota: As divisões aqui adicionadas serão incluídas para todos os produtos importados.

Image Modified

Imagem 1 – Divisões Padrão

Configurando Empresa, Token e Intervalo

Após salvar uma ou mais divisões, preencha os seguintes campos:

Token Simplus: Token de acesso ao sistema Simplus (pode ser adquirido entrando em contato com a Simplus e solicitando acesso ao seu CNPJ);
Empresa: Seleciona uma empresa que esteja vinculada a uma divisão já adicionada;
Intervalo importação automática: Define o intervalo que o sistema irá importar todos os produtos existentes na Simplus para o seu ERP.

Image Modified

Imagem 2 – Configurar Empresa, Token e Intervalo

Clique no botão botão Salvar.

Image Modified

Imagem 3 – Botão Salvar

Será exibida a mensagem informando que a configuração foi salva com sucesso.

Image Modified

Imagem 4 – Mensagem Configuração Salva com Sucesso

O sistema está configurado e pronto para uso.

Filtro de Produtos

Clique no menu menu Produtos.

Nota: Ao deixar todos os filtros vazios e clicar em salvar, o sistema retornará todos os produtos cadastrados na Simplus e poderá ocorrer uma demora nos resultados da tela.

Serão exibidos os filtros:

Última atualização: Inicialmente Inicialmente, a tela de produtos retorna todos os produtos atualizados a partir da data atual -1. A imagem abaixo foi gerada em 18/10/2019, então o sistema retornará por padrão o filtro do dia 17/10/2019 em diante.

Image Modified

Imagem 5 – Filtro Última Atualização

GTIN: Ao Ao utilizar este filtro, o sistema irá ignorar a informação do campo última atualização e irá retornar somente o produto do GTIN informado. Ao pesquisar pelo GTIN, a última atualização do produto não é fornecida na consulta pelo GTIN, não sendo possível, neste caso, exibir em tela.

Image Modified

Imagem 6 – Filtro Última Atualização

Filtro nos Resultados da Tela

É possível também utilizar o campo campo Pesquisar no no início da grid de resultados.

Nota: Este campo pesquisa somente nas informações já retornadas no último filtro.

Será utilizado como exemplo para pesquisa, o CNPJ de um fornecedor específico, mas pode ser utilizado para filtrar qualquer informação das colunas do resultado da busca.

Após selecionar somente o CNPJ de um fornecedor, é possível utilizar o campo campo Todos para para importar todos os produtos deste fornecedor.

Image Modified

Imagem 7 – Filtro Pesquisar

Importação dos produtos

Ao importar um produto para o ERP, se o produto já está cadastrado na base de dados, as informações são atualizadas. Se o produto ainda não está cadastrado, é feita uma verificação se já existe família com a mesma descrição, para inserir o novo produto a uma família já existente. Se ainda não existe a família, é feito o cadastro básico da família, com algumas informações, que podem ser disponibilizadas pela Simplus, como código CEST, código NCM, alíquota padrão de IPI etc.

Dados de

Inclusão de Produtos
PostProductDTO
API Consinco	Descrição	Correspondente Simplus	Observação
dataFamily	Será usado quando se tratar da inclusão de família para o produto.	seqFamily	Será usado quando for informada uma família já existente.	complement	Adicionando este complemento à descrição da família, forma-se a descrição do produto.
reducedDescription	Descrição Reduzida	#{produto.descricaoCurta}	Limite: 24
manufacturingProcessIndicator
genericDescription	Descrição Genérica	#{produto.descricaoLonga}	Limite: 60
anpCode	Código ANP	#{codigo-agencia-nacional-do-petroleo-anp}	anpDescription	Descrição ANP	#{descricao-agencia-nacional-do-petroleo-anp}	zeroBalancePriceIndicator
productControlTemperatureIndicator	Indicador de Controle de Temperatura do Produto	#{controle-temperatura}	Conversão Sim = S e Não = N.
replicationIndicator	issueTaxCodeInNFEIndicator
PostProductCodeDTO
Obs.: Aqui poderão ser cadastrados mais de um. Códigos internos no fornecedor e GTIN de várias embalagens.
API Consinco	Descrição	Correspondente Simplus	Observação
supplierCnpj	CNPJ do Fornecedor	#{produto.fabricante.cnpj}	Informar apenas para códigos do tipo "F". Para os demais tipos, o valor é 0.
seqNetwork	codeType	Tipo do Código	F = quando se tratar de código interno do fornecedor (#{produto.codigoInterno}); D = Quando se tratar de GTIN com 14 posições para embalagem fechada (#{produto.composicoesLogisticas.niveis[N].gtin}); E = para os demais GTINs de 13, 12 ou 8 algarismos	packingQuantity	Quantidade de Embalagem	#{produto.composicoesLogisticas.niveis[N].quantidade}
accessCode	Código de Acesso	#{produto.codigoInterno} ou #{produto.composicoesLogisticas.niveis[N].gtin}	Depende do tipo
usageForSaleIndicator	EANTaxableNFEIndicator	Indica que utiliza EAN para Tribuitação NFe	"S", quando #{produto.composicoesLogisticas.niveis[N].quantidade} é 1 e "N" para as demais	usageForNFEIndicator
PostProductImageDTO
API Consinco	Descrição	Correspondente Simplus	Observação
description	image	Imagem do Produto	#{produto.imagemPrincipal.url}	mainIndicator	pictureLayout

Dados de Inclusão de FamíliaPostFamilyDTOAPI ConsincoDescriçãoCorrespondente SimplusObservaçãofamilySugerir uma descrição com base na descrição do produto (#{produto.descricao}), limitado a 35 posições. O usuário poderá alterar.weighableallowsDecimalseqBrandPara listar as marcas, utilizar método "GET api/v2/sm_products/brands", link "http://187.72.107.68:8342/SMProductsApi".

Simplus
Cadastro de Família (Max Cadastro > menu Produto > aplicação Família (MAX0049))
Campo do ERP	Campo de referência Simplus	Observação
aba Geral > Família	#{produto.descricao}	Como a Simplus não trata conceito de família, são consideradas as primeiras 35 posições da descrição do produto para criar a família
aba Dados Fiscais > Código NCM	#{produto.classificacaoFiscal.ncm}
aba Dados Fiscais > Código CEST	#{produto.classificacaoFiscal.cestCodigo}	Quando existe para o produto
aba Dados Fiscais > Dados do IPI > Aliq. Padrão Entrada	#{produto.classificacaoFiscal.aliquotaIPI}
aba Dados Fiscais > Dados do Imposto de Importação > Alíquota II

containerIndicatorallowsMultiplicationusesStockBatchIndicatoripiAliquotAlíquota de IPI

#{produto.classificacaoFiscal.

aliquotaIPI

aliquotaII}

nfPisSituation

Quando existe para o produto

aba Dados Fiscais > Dados do PIS/Cofins > Entrada > CST PIS

Situação do PIS na NF

#{produto.composicoesLogisticas.niveis[N].dadosComerciais[N].cstEntrada}

Considerar do nível em que a quantidade é 1. Se não houver, incluir valor nulo.

Quando a Simplus disponibiliza informação

aba Dados Fiscais > Dados do PIS/Cofins > Entrada > CST COFINS

nfCofinsSituationSituação do Cofins na NF

#{produto.composicoesLogisticas.niveis[N].dadosComerciais[N].cstEntrada}

Considerar do nível em que a quantidade é 1. Se não houver, incluir valor nulo.

Quando a Simplus disponibiliza informação

aba Dados Fiscais > Dados do PIS/Cofins > Saída > CST PIS

nfPisLeaveSituation

#{produto.composicoesLogisticas.niveis[N].dadosComerciais[N].cstSaida}

Considerar do nível em que a quantidade é 1. Se não houver, incluir valor nulo.

Quando a Simplus disponibiliza informação

aba Dados Fiscais > Dados do PIS/Cofins > Saída > CST COFINS

nfCofinsLeaveSituation

#{produto.composicoesLogisticas.niveis[N].dadosComerciais[N].cstSaida}

Considerar do nível em que a quantidade é 1. Se não houver, incluir valor nulo.

Quando a Simplus disponibiliza informação

aba Embalagens > Quantidade

nbmshCodeCódigo NBMSH#{produto.classificacaoFiscal.ncm}cestCodeCódigo CEST#{produto.classificacaoFiscal.cestCodigo}percentageImportTaxPorcentagem de Imposto de Importação#{produto.classificacaoFiscal.aliquotaII}revenueIndicatorsimilarIndicatorreplicationIndicatorrevenueTypetaxationPisCofinsIndicatorpisCofinsSimpleSituationPostFamilyPackingDTOObs.: Aqui podem ter várias embalagens.API ConsincoDescriçãoCorrespondente SimplusObservaçãopackingQuantity

#{produto.composicoesLogisticas.niveis[N].quantidade}

packing


aba Embalagens > Embalagem	#{produto.composicoesLogisticas.niveis[N].unidadeEmbalagem}

Aqui o tamanho máximo é 2. Portanto, deve haver conversão. CAIXA = CX, UNIDADE = UN, FARDO = FD.

Ocorre conversão da informação

aba Embalagens > Peso Bruto (kg)

grossWeightPeso Bruto

#{produto.composicoesLogisticas.niveis[N].pesoBruto}

Realizar a conversão para KG,