Todas as coleções
Integrações e fórmulas externas
Integração com FoccoERP
Integração com FoccoERP

Documentação completa de nossa integração com o ERP Focco

Alessandra Gregatti avatar
Escrito por Alessandra Gregatti
Atualizado há mais de uma semana

Sumário

Mapa geral da integração

Instruções da ativação da integração

  1. Habilitação da integração

  2. Autorização da integração

  3. URL da API e FoccoERP

  4. URLs de importação

  5. Importação de pedidos dos últimos dois anos

  6. Importação de produtos

  7. Mapeamento de campos

  8. Ativação da integração

  9. Consulta a estoque, em tempo real, por campo de fórmulas externas

Mapa geral da integração

Clientes (Empresas e Pessoas):

  • Ploomes > Focco:

    • Criação: não disponível

    • Alteração: não disponível;

    • Exclusão: não disponível.

  • Focco > Ploomes

    • Criação: disponível para clientes com a propriedade "e-commerce" ativa. Clientes criados no Focco são trazidos ao Ploomes nos seguintes momentos:

      • Ao ativar a integração;

      • Ao clicar em “Atualizar” na seção "Atualize sua base de clientes", dentro da tela de configurações da integração;

      • A cada 24 horas;

      • Quando um pedido chega do Focco ao Ploomes (seja um pedido novo ou um pedido alterado) e o cliente não existe no Ploomes.

    • Alteração: disponível para clientes com a propriedade "e-commerce" ativa. Clientes alterados no Focco são alterados no Ploomes nos seguintes momentos:

      • Ao ativar a integração;

      • Ao clicar em “Atualizar” na seção "Atualize sua base de clientes", dentro da tela de configurações da integração;

      • A cada 24 horas;

      • Quando um pedido chega do Focco ao Ploomes (seja um pedido novo ou um pedido alterado).

    • Exclusão: não disponível.

Produtos:

  • Ploomes > Focco:

    • Criação: não disponível;

    • Alteração: não disponível;

    • Exclusão: não disponível.

  • Focco > Ploomes:

    • Criação: disponível para produtos com a propriedade "e-commerce" ativa e que possuam uma "Classificação". Produtos criados no Focco são trazidos ao Ploomes nos seguintes momentos:

      • Ao ativar a integração;

      • Ao clicar em “Atualizar” na seção "Atualize sua base de produtos", dentro da tela de configurações da integração;

      • A cada 24 horas;

      • Quando um pedido chega do Focco ao Ploomes (seja um pedido novo ou um pedido alterado) e o produto não existe no Ploomes.

    • Alteração: disponível para produtos com a propriedade "e-commerce" ativa e que possuam uma "Classificação". Produtos alterados no Focco são trazidos ao Ploomes nos seguintes momentos:

      • Ao ativar a integração;

      • Ao clicar em “Atualizar” na seção "Atualize sua base de produtos", dentro da tela de configurações da integração;

      • A cada 24 horas;

      • Quando um pedido chega do Focco ao Ploomes (seja um pedido novo ou um pedido alterado).

    • Exclusão: não disponível.

Vendas / Pedidos:

  • Ploomes > Focco:

    • Criação: disponível para vendas que tenham o campo Tipo de Pagamento preenchido e cujo cliente possua uma transportadora definida no seu cadastro no Focco. Vendas criadas no Ploomes são levadas ao Focco nos seguintes momentos:

      • Ao criar uma venda no Ploomes;

      • Obs.: o Focco pode ter regras específicas de bloqueio de pedido configuradas. Nestes casos, o pedido não será enviado, e o usuário que criou o pedido receberá uma notificação e um registro de interação explicando o erro retornado pelo Focco. O usuário deverá, então, ajustar o problema, excluir uma venda e gerar uma nova.

    • Alteração: não disponível;

    • Exclusão: não disponível.

  • Focco > Ploomes:

    • Criação: disponível. Pedidos de venda criados no Focco são trazidos ao Ploomes como vendas nos seguintes momentos:

      • Ao ativar a integração, caso eu ative a opção "Deseja importar todos os pedidos de venda dos ultimos dois anos?";

      • A cada 1 hora;

      • Ao clicar em “Atualizar integração” na extremidade inferior da tela de configurações da integração;

      • Obs.: pedidos de clientes sem a propriedade "e-commerce" ativada serão trazidos ao Ploomes. Isso significa que estes serão cadastrados no Ploomes mesmo sem a propriedade em questão.

    • Alteração: disponível. Pedidos de venda alterados no Focco são alterados no Ploomes nos seguintes momentos:

      • Ao ativar a integração, caso o Ploomes já possua vendas com ID Focco, elas serão atualizadas (caso sejam dos últimos 2 anos). Este mecanismo blinda o Ploomes de duplicidade de dados caso a integração seja ativada, inativada e reativada;

      • A cada 1 hora;

      • Ao clicar em “Atualizar integração” na extremidade inferior da tela de configurações da integração.

    • Exclusão: não disponível.

Formas de Pagamento:

  • Ploomes > Focco:

    • Criação: não disponível;

    • Alteração: não disponível;

    • Exclusão: não disponível.

  • Focco > Ploomes:

    • Criação: disponível. Formas de pagamento criadas no Focco são criadas no Ploomes nos seguintes momentos:

      • Ao ativar a integração;

      • A cada 1 minuto.

    • Alteração: disponível. Formas de pagamento alteradas no Focco são alteradas no Ploomes nos seguintes momentos:

      • Ao ativar a integração, caso o Ploomes já possua formas de pagamento com ID Focco, elas serão atualizadas. Este mecanismo blinda o Ploomes de duplicidade de dados caso a integração seja ativada, inativada e reativada;

      • A cada 1 minuto.

    • Exclusão: não disponível.

Integração com Clientes (Empresas e Pessoas):

  • Chave para vínculo entre um cliente cadastrado no Ploomes e um cliente cadastrado no Focco:

    • Chave principal: ID Cliente Focco;

    • Chave secundária: CNPJ/CPF.

  • Campos padrões do cadastro de clientes já existentes nos dois sistemas são mapeados de forma automática e não podem ser alterados;

  • Campos existentes no Focco ERP e não existentes no Ploomes poderão ser mapeados de acordo com a necessidade do usuário. Pode-se, inclusive, criar campos dinâmicos no Ploomes e utilizá-los no mapeamento;

  • Ao ativar a integração, dois campos dinâmicos de cliente são criados no Ploomes:

    • ID Cliente Focco;

    • Código Cliente Focco.

  • Os dois campos acima são utilizados para vincular um cliente do Ploomes a um cliente do Focco. Caso estes campos estejam vazios no Ploomes, a integração tentará vincular os clientes a partir do CNPJ/CPF. Caso ocorra um "match", o cliente do Ploomes será atualizado com o ID Cliente Focco e o Código Cliente Focco. Exemplo:

    • Cadastrei um cliente no Ploomes;

    • Em seguida, cadastrei o mesmo cliente no Focco;

    • Gerei uma venda no Ploomes;

    • Quando a venda chegar ao Focco, o cliente Ploomes não terá um ID Cliente Focco, nem um Código Cliente Focco. Neste momento, a integração buscará o cliente no Focco pelo CNPJ/CPF. Ao encontrá-lo, o cliente Ploomes receberá o ID Cliente Focco e o Código Cliente Focco, e o pedido será salvo no Focco.

  • Obs.: o Focco permite cadastro de dois clientes com o mesmo CNPJ/CPF. Nestes casos, quando a integração tentar realizar o vínculo por estes parâmetros e encontrar dois clientes, um deles será selecionado aleatoriamente.

Integração com Produtos

  • Chave para vínculo entre um produto cadastrado no Ploomes e um produto cadastrado no Focco:

    • Chave para trazer um produto do Focco ao Ploomes: Código;

    • Chave para enviar um produto dentro de um pedido do Ploomes ao Focco: Id Produto Focco;

  • Campos padrões do cadastro de produtos já existentes nos dois sistemas são mapeados de forma automática e não podem ser alterados;

  • Campos existentes no Focco ERP e não existentes no Ploomes poderão ser mapeados de acordo com a necessidade do usuário. Pode-se, inclusive, criar campos dinâmicos no Ploomes e utilizá-los no mapeamento.

  • Ao ativar a integração, dois campos dinâmicos de produto são criados no Ploomes:

    • ID Produto Focco;

    • Código Empresa Produto Focco.

  • O Código Empresa Produto Focco é apenas para referência, já que o Focco é multi empresas. O ID Produto Focco é utilizado como chave de integração, como explicado acima.

  • O campo de "Marcadores" do Ploomes será preenchido com o status do produto no Focco ("DISPONÍVEL FOCCO" e "INDISPONÍVEL FOCCO"). Isso permitirá criar filtros nos modelos de proposta, vendas e documentos no Ploomes que limite a listagem de produtos apenas para os disponíveis;

  • Obs.: produtos sem o parâmetro e-commerce ativado que chegarem ao Ploomes por pedidos gerados no Focco não terão nenhum marcador atrelado.

Integração com Pedidos de Vendas e Produtos da Venda

  • Chave para vínculo entre uma venda cadastrada no Ploomes e um pedido cadastrado no Focco: ID Pedido de Venda Focco;

  • Campos padrões do cadastro de vendas/pedidos já existentes nos dois sistemas são mapeados de forma automática e não podem ser alterados;

  • Campos existentes no Focco ERP e não existentes no Ploomes poderão ser mapeados de acordo com a necessidade do usuário. Pode-se, inclusive, criar campos dinâmicos no Ploomes e utilizá-los no mapeamento.

  • Ao ativar a integração, alguns campos dinâmicos de venda e produtos da venda são criados no Ploomes:

    • Venda:

      • ID Pedido de Venda Focco: utilizado como chave de integração, como explicado acima;

      • Status Pedido de Venda Focco: informação sobre o status do pedido ao usuário;

      • Tipo de Pagamento Focco: campo de preenchimento obrigatório durante a criação da venda no Ploomes para envio ao Focco.

    • Produto da venda:

      • Valor ICMS Sub Prod. Venda: ICMS calculado pelo Focco e devolvido ao Ploomes. Apenas informação ao usuário;

      • Valor IPI Sub Prod. Venda: IPI calculado pelo Focco e devolvido ao Ploomes. Apenas informação ao usuário

Instruções de ativação da integração

1) Habilitação da Integração

Entre em Administração e, em Integrações Plug and Play, procure pelo ícone do Focco. Em seguida, clique em “Habilitar Integração”.

2) Autorização da Integração

Em seguida, clique em Autorizar a Integração, como mostra a imagem abaixo:

Feito isso, você chegará à tela abaixo, onde deverá preencher a URL da sua API Focco ERP (explicado no item a seguir), bem como suas credenciais de acesso ao ERP.

3) URL da API Focco ERP

Para conseguir a URL da API Focco ERP, você precisa solicitar à equipe da Focco ou copiar a URL que você já utiliza para acessar o Focco ERP, como mostra a imagem abaixo (é preciso manter a barra (“/”) após o ".br"):

4) URLs de importação

Para criar as URLs de importação, é necessário seguir os passos abaixo:

  1. Acesse sua conta Focco;

  2. No Menu de Programas, pesquise por “FINT0200”;

  3. Clique em “Cadastro de Programas do Integrador”:

  4. Dentro da janela que se abrir (exemplificada abaixo), copie qualquer uma das opções da coluna “chave” que está destacada em vermelho. Guarde essa informação em um bloco de notas da seguinte maneira: ?chave=CHAVE_COPIADA

  5. Volte ao Focco e pesquise no Menu de Programa por “FINT0202”. Em seguida, clique em “Cadastro de Processo de Exportação”:

  6. Aqui, vamos criar os processos de exportações: (I) exportador dos pedidos criados até dois anos atrás, (II) exportador dos pedidos criados ou atualizados no dia corrente, (III) exportador de clientes e (IV) exportador de produtos:

    1. Exportador (I):

      1. No campo Mnemônico, insira o nome VENDA;

      2. No campo Método, escolha a opção API;

      3. No campo Descrição, você pode escrever o que preferir;

      4. No campo Select, insira o seguinte script:

select    

ped.id

, ped.num_pedido

, est.cli_id

, cli.cod_cli

, est.CNPJ

, est.cpf

, est.descricao

, to_char(ped.dt_emis,'dd/mm/rrrr') dt_emis 

     , to_char(ped.modified_on,'dd/mm/rrrr') dt_mod 

from tpedidos_venda ped

inner join testabelecimentos est on (ped.est_id_fat = est.id)

left join tclientes cli on (est.cli_id = cli.ID)

where ped.dt_emis >= TRUNC(SYSDATE)-730

v. Clique em Salvar;

vi. Clique em Validar SQL;

vii. Com tudo certo, clique em Ativo;

viii. Clique em Salvar.

ix. Agora, copie o texto contido no campo GET, junte com o que foi gerado no item 4 (?chave=CHAVE_COPIADA), removendo a primeira barra (“/”) e salve em um bloco de notas. Esta será sua URL de Importação do Ploomes de pedidos de vendas. O resultado final será algo assim: /FoccoIntegrador/api/v1/Exportacao/venda?chave=CHAVE_COPIADA

x. Após concluídas as etapas acima, clique em Cancelar;

b. Exportador (II):

i. No campo Mnemônico, insira o nome VENDA_DIARIA;

ii. No campo Select, insira o seguinte script:

select    
	ped.id
	, ped.num_pedido
	, est.cli_id
	, cli.cod_cli
	, est.CNPJ
	, est.cpf
	, est.descricao
	, to_char(ped.dt_emis,'dd/mm/rrrr') dt_emis 
    	, to_char(ped.modified_on,'dd/mm/rrrr') dt_mod 
from tpedidos_venda ped
inner join testabelecimentos est on (ped.est_id_fat = est.id)
left join tclientes cli on (est.cli_id = cli.ID)
where ped.dt_emis >= TRUNC(SYSDATE)-730

c. Repita os passos "v" a "ix" do Exportador (I). Esta será sua URL de Importação do Ploomes de pedidos de vendas do dia. O resultado final será algo assim: /FoccoIntegrador/api/v1/Exportacao/venda_diaria?chave=CHAVE_COPIADA

d. Após concluídas as etapas acima, clique em Cancelar;

7. Exportador (III):

a. No campo Mnemônico, insira o nome CLIENTE;

b. No campo Select, insira o seguinte script:

select 

est.cli_id

, cli.cod_cli

, est.CNPJ

, est.cpf

, est.descricao

     , to_char(est.dt_cad,'dd/mm/rrrr') dt_cad

from testabelecimentos est 

inner join tclientes cli on (est.cli_id = cli.ID)

c. Repita os passos "v" a "ix" do Exportador (I). Esta será sua URL de Importação do Ploomes de clientes. O resultado final será algo assim: /FoccoIntegrador/api/v1/Exportacao/cliente?chave=CHAVE_COPIADA

d. Após concluídas as etapas acima, clique em Cancelar;

8. Exportador (IV):

a. No campo Mnemônico, insira o nome PRODUTO;

b. No campo Select, use o seguinte script:

select 

it.id,

    it.cod_item, 

     it.desc_tecnica,

ctb_clas.descricao

from titens it

inner join  titens_empr itempr on (it.id = itempr.item_id)

inner join titens_contabil ctb on (itempr.id = ctb.itempr_id)

inner join tgrp_clas_ite ctb_clas  on (ctb.grp_clas_id = ctb_clas.id)

c. Repita os passos "v" a "ix" do Exportador (I). Esta será sua URL de Importação do Ploomes de produtos. O resultado final será algo assim: /FoccoIntegrador/api/v1/Exportacao/produto?chave=CHAVE_COPIADA

9. Agora, copie e cole as URLs de Importação do Ploomes para seus respectivos campos na configuração da integração dentro da interface do Ploomes. O Exportador (II), relacionado aos pedidos de venda do dia, não precisará ser copiado no Ploomes, já que nossa integração o utilizará de outra forma. A imagem abaixo mostra um exemplo de como as informações devem aparecer no Ploomes:

5) Importação de pedidos dos últimos dois anos

Caso deseje trazer ao Ploomes o histórico de pedidos do Focco dos últimos dois anos, você deve marcar o campo abaixo como na imagem:

6) Importação de produtos

Como produtos podem existir em grande volume, você deverá puxar produtos e suas atualizações do Focco ao Ploomes sob demanda. Para isso, será necessário clicar no botão da imagem abaixo, localizado dentro da tela de Configurações da Integração.

7) Mapeamento de campos

Para definir quais informações são trafegadas de um sistema ao outro (de acordo com o Mapa Geral da Integração) e em qual campo elas são armazenadas, basta escolher um campo na coluna Focco e o seu correspondente na coluna Ploomes.

8) Ativação da integração

Com todas as configurações acima finalizadas, basta clicar em Ativar Integração.

Obs: Neste momento, todos os clientes, pedidos de venda (se a opção for ativada), tipos de pagamento e status de pedido serão replicados do Focco ERP para o Ploomes.

9) Consulta a estoque, em tempo real, por campo de fórmulas externas

Quando você ativa a integração, uma URL é gerada automaticamente na parte inferior da tela de configurações da integração do Ploomes, como mostra a imagem abaixo:

Com esta URL, você pode criar um novo campo de produto de proposta, produto de venda ou produto de documento, e seguir os passos abaixo para configurá-lo para puxar, em tempo real, a disponibilidade em estoque de um determinado produto no Focco ERP:

Respondeu à sua pergunta?