Ir para o conteúdo

Integrações - FoccoHub

Configuração de Integrações

Configuração de Integrações

No menu lateral do FoccoHUB é possível cadastrar uma nova integração clicando no botão “Nova Integração”. A empresa da nova integração é a mesma que está selecionada no menu à esquerda.

Ao iniciar o cadastro de uma plataforma, deve-se atentar para selecionar a plataforma que deseja realizar a integração com a modalidade correta. Sendo que não é possível cadastrar uma mesma plataforma duas vezes para a mesma empresa.

Após informar qual plataforma será utilizada, deve-se informar uma descrição para a plataforma, que a identificará nos demais processos assim como é possível selecionar algumas opções para a composição do estoque, sendo possível optar por pedidos liberados e bloqueados ou apenas liberados.

O mesmo se aplica para o campo de almoxarifado utilizado, que permite a escolha do local onde estará especificado o almoxarifado que deve ser considerado o estoque dos itens para integração com a plataforma.

Os campos de cliente dentro da UF e fora da UF são utilizados como cliente base na importação dos clientes recebidos nos pedidos de venda da plataforma.

Os campos “Método de Precificação” e “Aplicar política de desconto e/ou acréscimo” são referentes ao cálculo do preço do item do pedido de venda gerado.

Para cadastro da plataforma devem ser preenchidas as informações visíveis abaixo:

Cada integração possui campos de autenticação específicos, podendo ser um usuário e senha ou apenas um Token de acesso, variando de acordo com a plataforma. Para que a comunicação com a plataforma seja possível, todos os dados de Autenticação e URL da API devem ser preenchidos, caso contrário não será possível realizar nenhum tipo de sincronização com a plataforma.

O botão ativo, indica se a comunicação com a plataforma está ativa ou inativa. Caso a integração esteja desativada, não será executada nenhum tipo de envio ou recebimento de informação para a plataforma.

O cadastro de integração possui também uma parte dedicada a Configurações Avançadas, nesta parte do cadastro, é possível configurar parâmetros de sincronização, como ativar ou desativar processos automáticos, como sincronização e importação de pedidos ou definir intervalos padrões para cada sincronização.

Observação

Caso não seja informado um intervalo para a sincronização, o sistema assumirá um intervalo padrão de 15 minutos.

Caso a sincronização automática esteja desativada para os processos, ainda é possível sincroniza-los de forma manual, com exceção do processo de busca de notas fiscais, que pode ser realizado apenas de forma automática.

Cadastro de Parâmetros de De/Para da Plataforma

Cadastro de Parâmetros de De/Para da Plataforma

No cadastro de plataformas existe a aba “Parâmetros” que permite realizar o cadastro de operações de De/Para por plataforma. Esses cadastros são necessários para que seja possível realizar a sincronização com a plataforma corretamente, utilizando a nomenclatura cadastrada na plataforma de forma correta para cada uma das operações. Além disso, este cadastro de parâmetros é utilizado para definir algumas regras de negócio da integração como por exemplo: Tabela de Venda e Almoxarifado.

Para realizar o cadastro de um novo parâmetro/operação, deve-se clicar no botão novo na tela de listagem de parâmetros e na aba que irá abrir deve-se selecionar a operação que será cadastrado o De/Para. Nesse cadastro deve-se ser informado qual o código e/ou descrição do terceiro que será traduzido para qual código presente no FoccoERP.

Caso deseje utilizar um código no FoccoERP de forma genérica, independente do código enviado pela plataforma, deve-se, no momento do cadastro, deixar o campo “Código e Descrição do Terceiro” em branco, informando apenas o código no FoccoERP.

Observação

Podem ser cadastradas diversas respostas para uma mesma operação, desde que o código e descrição do terceiro sejam diferentes.

Para plataformas que é possível a identificação do canal de vendas, é possível realizar o cadastro de operações de De/Para por canal, caso isso seja possível, ao selecionar a operação será habilitado um campo para informar o identificador do canal.

O sistema utiliza uma hierarquia de busca do mais específico para o mais abrangente no momento da busca da resposta do parâmetro/operação, ou seja, primeiro será buscada uma resposta com a correspondência de código/descrição do terceiro e canal, caso não encontrar buscará resposta por código/descrição do terceiro e caso ainda não tiver encontrado a resposta buscará a resposta genérica, sendo ela, sem a informação de canal e código/descrição do terceiro.

Particularidades de cada plataforma

Particularidades de cada plataforma
Anymarket

Fulfillment

A identificação do pedido Fulfillment é feita pela plataforma e quando realizado o recebimento de um pedido do tipo Fulfillment efetua-se a inclusão do mesmo com o Status informado no "Status do pedido de venda Fulfillment" das configurações por empresa.

Pedidos do tipo Fulfillment, não estarão disponíveis para importação para o ERP.

Fila de Pedidos

A plataforma utiliza o conceito de fila de pedidos, o que exige que o sistema envie uma solicitação de remoção dos pedidos da fila após os mesmos serem importados para o FoccoHUB. Esse processo é automático e a solicitação de remoção do pedido da fila gera um log que pode ser consultado no FoccoHUB.

Dooca

Kits

A montagem de kits não é realizada no FoccoHUB, e deve ser criada diretamente no site da Dooca. Ao receber um kit, o FoccoHUB desmembra os itens individualmente.

N49

Venda de Serviços

Quando realizada a importação de pedidos, é possível que um ou mais itens do pedido sejam itens de serviço. Para estes itens o sistema executará a hierarquia padrão de busca de tipo de nota do FoccoERP, independentemente do modo de busca de tipo de nota configurado para a plataforma.

Skyhub

Fila de Pedidos

A plataforma utiliza o conceito de fila de pedidos, o que exige que o sistema envie uma solicitação de remoção dos pedidos da fila após os mesmos serem importados para o FoccoHUB. Esse processo é automático e a solicitação de remoção do pedido da fila gera um log que pode ser consultado no FoccoHUB.

Vtex

Multiempresa

Quando configurado, os estoques de diferentes empresas se somam para realizar a venda de um mesmo produto cadastrado na Vtex. Por exemplo, um produto contém 10 unidades na empresa X e outras 10 unidades na empresa Y. Para realizar uma venda de 15 unidades, ambos estoques das empresas cadastradas serão consumidos. No momento do recebimento de pedidos da plataforma, será feita a identificação de qual empresa será feito o consumo do estoque, criando pedidos com as quantidades correspondentes em cada empresa.

Fila de Pedidos

A plataforma utiliza o conceito de fila de pedidos, o que exige que o sistema envie uma solicitação de remoção dos pedidos da fila após os mesmos serem importados para o FoccoHUB. Esse processo é automático e a solicitação de remoção do pedido da fila gera um log que pode ser consultado no FoccoHUB.

Utiliza CNPJ da Doca

Quando selecionado para utilizar o CNPJ da Doca o pedido será importado na empresa do estoque e não da capa do pedido.

2020Manager / Supplier Portal

Indicador de destino de faturamento

Quando realizada a importação de pedidos, serão identificados os pedidos que tem o faturamento pela loja, nestes casos o cliente/estabelecimento correspondente obrigatoriamente deverá estar cadastrado no FoccoERP.

Parâmetro de uso de Webhooks (Utiliza Webhooks)

Indica se a plataforma "Utiliza Webhooks" para integração de pedidos. Se marcado, não será realizada a consulta automática de pedidos e os pedidos serão recebidos sob demanda, conforme os gatilhos disparados pela plataforma. Este indicador é marcado de forma automática quando o Webhook for configurado (a configuração do Webhook é feita de forma automática caso o ambiente estiver apto para uso deste recurso).

Geração de Máscaras

Quando realizada a importação de pedidos, a geração das máscaras busca pela máscara correspondente no FoccoERP seguindo a seguinte hierarquia:

1 - Especificação de Máscara Completa Informada:

Caso tenham sido informados os campos Especificação/TAG da Máscara Completa e Caracter Delimitador de Respostas nas Configurações Avançadas, irá validar se existe uma especificação igual à informada no campo Especificação/TAG da Máscara Completa. Caso exista, será considerado o conteúdo da resposta informada na especificação para geração da máscara completa do item.

2 - Característica Igual à Especificação:

Verifica se existe uma característica no FoccoERP cadastrada com o código igual ao código da especificação recebido da plataforma, na empresa do pedido.

3 - Característica Igual à Especificação (Sem Prefixo):

Caso não tenha sido localizado pela regra anterior (1), verifica se existe uma característica no FoccoERP cadastrada com o código igual ao código da especificação recebido da plataforma REMOVENDO O PREFIXO configurado no parâmetro 10 - PREFIXO UTILIZADO NO CADASTRO DE CARACTERÍSTICAS NO SOFTWARE DE PROJETO do programa de Parâmetros De Descrição de Configurados (FUTL0125 DEC DEC), para a empresa do pedido.

4 - Característica "Caract. Promob" Igual à Especificação:

Caso não tenha sido localizado pela regra anterior (2), verifica se existe uma característica no FoccoERP cadastrada no campo Caract. Promob do programa Manutenção de Características (FENG0102) igual ao código da especificação recebido da plataforma, na empresa do pedido.

5 - Característica "Caract. Promob" Igual à Especificação (Sem Prefixo):

Caso não tenha sido localizado pela regra anterior (2), verifica se existe uma característica no FoccoERP cadastrada no campo Caract. Promob do programa Manutenção de Características (FENG0102) igual ao código da especificação recebido da plataforma REMOVENDO O PREFIXO configurado no parâmetro 10 - PREFIXO UTILIZADO NO CADASTRO DE CARACTERÍSTICAS NO SOFTWARE DE PROJETO do programa de Parâmetros De Descrição de Configurados (FUTL0125 DEC DEC), para a empresa do pedido.

6 - Característica Igual ao Cadastro de De/Para da Plataforma:

Caso não tenha sido localizado pela regra anterior (4), verifica se existe uma característica no cadastro de De/Para da plataforma com o código igual ao código da especificação recebido da plataforma.

Produtos

Produtos

Para atender à necessidade de diferentes plataformas e possibilitar o cadastro de informações específicas para vendas online, foi criando um cadastro de produtos específicos para este fim, neste cadastro é realizada a manutenção de cada produto que será comercializado nas plataformas fazendo o vínculo com o produto correspondente do FoccoERP, para identificação no momento do recebimento de pedidos.

Para que um produto seja enviado para as plataformas o mesmo deve possuir seu cadastro no FoccoHUB. Para realizar esse cadastro deve-se acessar a aba de Produtos no FoccoHUB e cadastrar ou importar os produtos que serão sincronizados com as plataformas.

Ao realizar o cadastro de um novo produto o usuário encontrará as seguintes abas:

Produto

Possui as principais informações do produto, que serão gerados para a capa do produto no FoccoHUB.

  • Informações do Produto: Permite definir “Informações do Produto” através de um editor de HTML - informações estas que serão utilizadas nas plataformas como informações de vitrine/descrição do produto.

  • Modelo de Informações do Produto: Permite definir o modelo/template para a geração das informações do produto. Ao selecionar algum modelo, o campo "Informações do Produto" será gerado automaticamente e as alterações feitas manualmente neste serão descartadas.

  • Imagens: Campo onde é possível cadastrar uma ou N imagens para o produto através de URLs, desde que esta imagem esteja disponível/acessível na Web.

  • Produto simples: É o tipo de produto mais básico e o mais utilizado em qualquer loja virtual. Ele é denominado como "simples" porque é um produto que não possui atributos de variação (como por exemplo, cor, tamanho, peso, etc.). O produto simples possui características únicas, por exemplo: TV LCD 32” Samsung, Violão, etc.

  • Produto configurável/ com variação: Este tipo de produto é usado quando você precisar cadastrar um produto que possui a mesma base, mas varia em uma ou mais características, como tamanho, voltagem, cor, etc. Um exemplo clássico é o cadastro de uma camiseta, nos tamanhos P, M, G e GG (ou seja, um conjunto de produtos iguais que varia apenas o tamanho). Geralmente esse tipo de produto está relacionado com ação do cliente, pois pode impactar no preço ou estoque ou em ambos conforme a escolha.

Para produtos configuráveis, deve ser definido um ou mais “atributos de variação” que corresponde à uma lista de valores para um determinado atributo/característica e cada variação/SKU terá uma resposta diferente para esta característica.

Plataformas

Indica em qual(is) plataforma(s) o produto está com a comunicação ativa e se possui estoque sob encomenda.

  • Estoque por encomenda: É possível configurar, por plataforma, para que seja realizado o envio de uma quantidade de estoque padrão (999) para a plataforma, desta forma, não será calculado o estoque disponível e considera-se que esse produto será comercializado sob encomenda, ou seja, será produzido ou estará disponível em estoque no momento do recebimento dos pedidos.

Observação

Quando é definido o estoque sob encomenda para uma plataforma é considerado que todas as variações do produto para a plataforma são comercializadas neste formato.

Atributos

Indica os atributos ativos para o produto, ou seja, quais as características que serão consideradas no cadastro do produto.

Os atributos de variação que terão sua combinação de características configuradas por variação, são os atributos do tipo “lista de valores”. Quando selecionado um ou mais atributos do tipo “lista de valores” será habilitado no cadastro de variações a configuração da combinação, que compreende na resposta de cada característica/atributo “lista de valores”.

Quando ativo atributos do tipo Texto e HTML, será possível realizar a resposta de cada atributo por variação, editando individualmente cada uma das variações do produto.

Atributos do tipo "Aplicação - Veículos" indicam informações de veículos que tiverem dados vinculados no Catálogo Digital de Veículos.

Variações

Aqui é realizado o cadastro e manutenção de variações do produto do FOCCOHUB, fazendo o vínculo do produto com os itens do FoccoERP, possibilitando adicionar imagem e especificar dados para cada variação.

Quando selecionado um item do FoccoERP serão buscadas automaticamente algumas informações do cadastro do FoccoERP para pré preenchimento de campos da variação. Além disso, quando o produto possui atributos do tipo “lista de valores” ativos, será habilitado o campo “combinação”, para que seja realizada a resposta para cada um dos atributos/características de lista de valores.

Importante

Não é permitido o cadastro de mais de uma variação com a mesma combinação de resposta de atributos “lista de valores”. Sendo assim, caso o produto não possua atributos de variação (“lista de valores”), será possível realizar o cadastro de apenas uma variação para o produto.

Seções

Possibilita vincular/adicionar seções de atributos ao produto, uma sessão de atributos é um grupo de atributos com respostas pré-definidas que normalmente é utilizada, para agilizar o cadastro de produtos que possuem as mesmas especificações. Uma seção normalmente é utilizada para fichas técnicas, por exemplo, onde existe um conjunto de atributos com respostas normalmente idênticas, variando apenas algumas especificações. Desta forma, quando a seção for vinculada ao produto e estiver ativa serão considerados para envio para as plataformas, todos os atributos da seção, sem a necessidade do cadastro e resposta individual de cada um dos atributos para o produto.

Importante

No cadastro de seções são definidas respostas padrões para cada um dos atributos da mesma, caso os atributos não tenham sua resposta alterada/informada no cadastro do produto, será considerada a resposta padrão do atributo para envio para a plataforma. Já quando alterada/informada a resposta do atributo da sessão no cadastro do produto, essa será a resposta considerada para o mesmo.

Estoque e Preço

Pré-visualização de informações de preço e estoque do produto que serão enviadas para as plataformas. Essas informações são compostas conforme as configurações e parâmetros (De/Para) definidos para cada uma das plataformas. As informações de preço e estoque sempre é formulada por variação/SKU, por se tratar da informação do produto físico vendido na plataforma.

Integração

Contém os registros de envio do produto para as plataformas. Neste local é possível visualizar a situação de cada envio para as plataformas, visualizando o motivo de possíveis erros no envio de produtos para as mesmas. A integração dos produtos com as plataformas é feita de forma automática caso tenha sido habilitado para a plataforma o envio automático de produtos.

Para realizar a integração com as plataformas de forma manual, é possível selecionar os produtos que deseja sincronizar, na listagem de produtos do FoccoHUB, e clicar no botão sincronizar escolhendo a plataforma que se deseja enviar as informações dos produtos selecionados.

Geração de produtos em lote

Geração de produtos do FoccoHUB a partir do cadastro de itens do FoccoERP, com o objetivo de automatizar a geração/cadastro dos produtos do FoccoHUB a partir do cadastro de itens pré-existentes no FoccoERP.

Tela Principal - Busca e Seleção de Itens do FoccoERP

Filtros e seleção de itens do FoccoERP que serão gerados no FoccoHUB.

  • Código dos itens (separados por vírgula).

  • Classificação de itens (seleção de múltiplas classificações de itens). Somente serão consideradas as classificações de itens que estiverem informadas nas configurações do FoccoHUB por empresa.

  • Fornecedor Preferencial.

  • Marca.

Interface de Dados Complementares

Interface de configurações de dados complementares para geração dos produtos.

  • Template de Informações do Produto - seleção de um Template HTML, conforme os cadastros de Template HTML FUTL0245.

  • Formato de Geração de SKUs (seleção de qual será o formato de geração de SKUs).

  • Plataformas Ativas (seleção de uma ou mais plataformas dentre as plataformas cadastradas para a empresa selecionada (no menu do FoccoHUB)).

  • Categoria.

Bloco Atributos

Seleção de atributos e respostas que deverão ser preenchidos/incluídos nos cadastros de produtos gerados através dos campos:

  • Atributos (listagem dos atributos ativos).

  • Valor (resposta para o atributo, conforme o tipo do atributo selecionado.).

  • Botão adicionar (Empilhar o atributo + resposta na lista de atributos).

Bloco Seções

Seleção de 1 ou múltiplas seções para que as mesmas sejam consideradas na inclusão/geração dos produtos no FoccoHUB.

  • Seções: seções disponíveis/cadastradas para a empresa.

Interface de Resultado da Geração de Produtos em Lote

Esta modal/interface tem o objetivo de mostrar o resultado da geração dos produtos no FoccoHUB para cada um dos itens do ERP selecionados na etapa inicial a partir dos itens abaixo:

  • Código.

  • Descrição.

  • Máscara.

  • SKU.

  • Mensagem (resultado da geração).

  • Situação (sucesso, existente ou erro).

Atualização automática de Informações do produto (Vitrine) e Descrição

Quando realizada alteração em cadastros de itens do FoccoERP, sendo algo que impacte nas informações de produto (Vitrine) e/ou descrição da capa do produto no Marketplace, a mesma será replicada de forma automática para o(os) produto(s) correspondentes no FoccoHUB. Para o correto funcionamento, algumas configurações deverão ser aplicadas.

Configurações necessárias para a atualização

  • O parâmetro "Atualização automática quando alterado item no FoccoERP" deverá estar respondido no programa de configurações por empresa do FoccoHub ( Configurações FoccoHub ).

  • Os produtos considerados para atualização automática, serão os que possuírem o campo "Modelo de informações do Produto" informado na capa do produto e que possuirem o item do ERP correspondente vinculado na variação.

Campos

Os seguintes campos relacionados aos itens no FoccoERP irão disparar a atualização automática, caso existirem as condições citadas acima:

  • Código do item ( FITE0200 ).

  • Descrição de produto para vendas em e-commerce ( FITE0200 ).

  • Descrição do item ( FITE0200 ).

  • Descrição complementar ( FITE0200 ).

  • Dados especiais do produto ( FITE0200 ).

  • Marca do item ( FITE0200 ).

  • Observação/Complemento para vendas em e-commerce ( FITE0200 ).

  • Código do item do fornecedor ( FFOR0202 ).

  • Indicador de e-commerce ( FFOR0202 ).

  • Descrição da marca ( FITE0271 ).

Exportação e Importação de Produtos e Variações

Exportação

  • Permite a exportação de cadastro de produtos do FoccoHUB para planilha Excel em um padrão pré-definido, gerando uma linha para cada variação de produto.

Importação

  • Permite a importação de cadastro de produtos do FoccoHUB via arquivo/planilha Excel, no mesmo padrão do arquivo exportado pelo processo acima.

Importante

Quando informado o "Código do modelo de Template HTML" no arquivo, as informações do produto (vitrine) serão geradas e o conteúdo informado no campo "Informações do produto" será desconsiderado.

Configuração de Integrações

Configuração de Integrações

Preços e estoque seguem as regras do FoccoERP. Os preços devem estar registrados em uma tabela de venda e o estoque em um almoxarifado. Os mesmos são informados dentro da plataforma na guia DE/PARA na operação almoxarifado e tabela de venda. Se a plataforma não contempla estas informações, deixe em branco.

Todos os itens do pedido irão entrar com o preço da tabela de venda e no almoxarifado parametrizado, como no envio de preço e estoque para a plataforma, caso a plataforma tenha o processo de envio de preços e estoque.

Se a tabela de venda sofrer modificação de preço ou ocorrer movimentações de estoque no almoxarifado a atualização é enviada automaticamente para as plataformas, caso o envio de preço e/ou estoque estiver configurado para ocorrer de forma automática (configuração feita no cadastro da plataforma).

Detalhes do Envio de Preços

Os preços são enviados para as plataformas conforme tabela de preço configurada na plataforma, é permitido o envio de preços de tabelas de venda com preço informado e também tabelas de preço com a formação de preço por custo médio. Além disso, o cálculo do preço é feito considerando a formação de preço por regras utilizado normalmente para itens configurados.

Detalhes do Envio de Estoque

O estoque é enviado para a plataforma conforme estoque calculado para o almoxarifado configurado para a plataforma. A quantidade de estoque disponibilizada/enviada para a plataforma é a quantidade em estoque disponível, descontando a quantidade comprometida, conforme configuração por plataforma. Além disso, quando um item possui seu tipo de estrutura como "Comercial" é feito o cálculo da disponibilidade de estoque considerando o estoque de seus volumes (primeiro nível de sua estrutura) e quando o produto do FoccoHUB está configurado em seu cadastro como "Estoque Sob Encomenda" é enviada a quantidade 999 para a plataforma correspondente.

O almoxarifado considerado para cálculo do estoque é conforme a configuração da plataforma, onde é possível definir o almoxarifado utilizado. Além disso, é possível definir um percentual de estoque para envio para a plataforma, neste caso será enviado para a plataforma o percentual informado da quantidade disponível em estoque para o item/produto.

Cadastro de Atributos

Cadastro de Atributos

Os atributos são as características dos produtos, como cores, tamanho, marca, aplicação etc., ou seja, todos os campos que temos disponíveis no cadastro de um produto além dos campos básicos/padrões são atributos.

A maioria das plataformas já traz consigo os atributos mais conhecidos, porém na maioria das vezes é necessário a utilização de novas características aplicáveis aos produtos comercializados pela empresa, como voltagem, diâmetro, tamanho, cor, etc.

Lembrado que o uso e configurações de atributos é totalmente flexível e tem por objetivo justamente permitir que cada empresa adeque o cadastro de produtos do FoccoHUB ao seu negócio e às necessidades das plataformas utilizadas.

No FoccoHUB temos diferentes tipos de atributos:

Atributos Lista de Valores

Utilizado para gerar combinações de características nos produtos. Os atributos de tipo Lista de Valores ficam disponíveis na configuração da variação do produto quando ativos para o produto. Exemplos de atributos de Lista de Valores: Cor, Voltagem, Tamanho, etc. Abaixo exemplo de cadastro de atributo Lista de Valores:

Atributo que Compõem Seção

Geralmente utilizado para informações especificas do produto que compõe a ficha técnica, atributos de seção ficarão disponíveis para serem configurados/vinculados nas seções do produto. Exemplos: Marca, Garantia, Manual, Aplicação, Alimentação, etc.

Atributos que compõe sessão pode ser do tipo texto ou HTML, não sendo permitida a utilização de atributos lista de valores para este fim.

Atributos Texto ou HTML

Atributos que não são do tipo Lista de Valores são por padrão