Saltar ligações

Importação de encomendas do WooCommerce para a FileMaker

Interface FileMaker WooCommerce

Interface WooCommerce para FileMakerA loja online WooCommerce está a tornar-se cada vez mais popular, sobretudo graças à enorme disseminação de sites baseados em WordPress. Inúmeros plugins estão agora disponíveis para a plataforma WooCommerce, e já não é um problema configurar o WooCommerce para a Alemanha de uma forma legalmente compatível. Como muitas outras lojas online e sistemas web, o WooCommerce tem uma API RESTful que pode ser usada para aceder aos dados da loja online. Neste artigo, apresentamos instruções com uma pequena solução FileMaker que pode ser usada para transferir encomendas de uma loja online WooCommerce para uma API FileMaker.Base de dados podem ser importados. A solução utiliza a WooCommerce RESTful API v3 e converte o fluxo de dados JSON fornecido em dados que podem ser lidos pela FileMaker. Para simplificar a programação do Interface a API RESTful e para ler os dados JSON, o MBS Plugin FileMaker da Monkeybread Software. A base de dados de amostra é exemplar e pode, em princípio, ser utilizada para outros sistemas de lojas em linha, tais como Artigos de lojaMagento ou Gambio Pode ser utilizado o GX3.

Iniciar sessão na API RESTful do WooCommerce

Para poder ler os dados de uma loja virtual WooCommerce, a API RESTful deve primeiro ser activada no WooCommerce. Esta definição pode ser efectuada no backend do WordPress em [WooCommerce > Configurações] no registo [API] pode ser feito.

Ativar a API REST no WooCommerce

Clicar no botão [Guardar alterações]para confirmar a ativação da interface. No passo seguinte, crie uma nova chave API. Para o fazer, clique no separador [Chave/Aplicações] e, em seguida, clicar no botão [Adicionar chave].

Criar chave da API do WooCommerce

No terreno [Descrição] pode adicionar uma descrição à sua escolha. Selecione um utilizador que deve ser autorizado a aceder à API RESTful do WooCommerce. Dependendo se o utilizador também deve escrever dados no sistema da loja através da interface, pode atribuir as autorizações apropriadas. A autorização "Read" é suficiente para a solução FileMaker aqui apresentada. De seguida, clique no botão [Criar chave API].

Chave da API do WooCommerce

Agora tome nota do conteúdo dos dois campos "Key (Consumer Key)" e "Consumer Secret". Este passo é importante porque deixará de poder ver o conteúdo destes campos no futuro, uma vez que os dados da chave são armazenados sob a forma de máscara.

Interface no FileMaker para a API REST do WooCommerce

A solução de exemplo apresentada neste artigo pode ser utilizada para transferir encomendas de lojas e dados de clientes associados, tais como endereços de faturação e entrega, de uma loja online WooCommerce para uma base de dados FileMaker. O ficheiro de exemplo (ou a sua própria solução) pode ser facilmente expandido para incluir funções e tabelas adicionais. O WooCommerce fornece os seguintes pontos de extremidade para aceder à API RESTful:

  • Cupões
  • Clientes
  • Ordens (utilizadas no ficheiro de exemplo)
  • Notas de encomenda
  • Reembolsos
  • Produtos
  • Atributos do produto
  • Termos do atributo do produto
  • Categorias de produtos
  • Classes de expedição de produtos
  • Etiquetas de produtos
  • Relatórios
  • Taxas de imposto
  • Classes de impostos

Com o WooCommerce RESTful API, muitas outras fontes de dados também podem ser lidas e/ou processadas com a FileMaker, tais como cupões, produtos, atributos de produtos ou mesmo classes de impostos. No nosso exemplo de solução FileMaker, utilizamos o ponto de extremidade "Orders" para importar encomendas do WooCommerce para a FileMaker.

A solução de exemplo requer o plugin MBS FileMaker

Para o desenvolvimento da interface, o Plugin MBS FileMaker da Monkeybread Software. O plugin oferece todas as funções necessárias para uma interface com a API RESTful. Em alternativa, as funções da aplicação gratuita Plugin de elementos de base se o software for reprogramado em conformidade.

Definições predefinidas na solução FileMaker

Pode descarregar a versão de teste da solução FileMaker para a interface de uma loja online WooCommerce em descarregar aqui. A solução está na .formato fmp12 para FileMaker 13 a 15 e requer o plugin MBS FileMaker pelo menos na versão 4.4. Depois de descompactar o arquivo zip e iniciar a solução com a FileMaker, deve primeiro introduzir os dados para a API RESTful da sua loja virtual WooCommerce.

Interface FileMaker para a API REST do WooCommerce

Introduzir todos os dados nos campos assinalados a amarelo:

  • URL DA API - URL do seu servidor e a extensão /wp-api/v3
  • Ponto final - Padrão: /orders
  • Objeto de início - Padrão: encomendas
  • Chave do consumidor - Chave do consumidor que criou e registou no backend do WordPress
  • Segredo do consumidor - Segredo do consumidor que criou e registou no backend do WordPress

Se todos os dados tiverem sido introduzidos corretamente, clicar no botão [Importação de dados]. importa todas as encomendas da loja virtual WooCommerce especificada e os dados do cliente associados.

Estrutura da base de dados de amostra FileMaker

A base de dados de amostra para importação de ordens de cliente tem uma estrutura simples e contém as seguintes tabelas de dados:

  • Encomendas - Registo de dados mestre de uma encomenda, que contém os seguintes campos:
    • __ORDERS (dados do objeto inicial "orders", apenas para fins ilustrativos)
    • Número de encomenda (número de encomenda do WooCommerce)
    • _ID_Fremdsystem (Chave primária [post_id] do WooCommerce)
    • _pk_Order_ID (chave primária)
    • Observações (observações do WooCommerce)
    • Estado da encomenda
    • Montante_total_bruto
    • Montante_total_líquido
    • Montante_IVA
    • Montante_VAT_itens
    • Montante_IVA_custos de expedição
    • Montante_desconto
    • Montante_Custos_de_Envio
    • Montante_Subtotal
    • Data_Ordem
    • E_Mail
    • JSON_Ausgabe (Campo global para a saída dos dados JSON, é utilizado no Script utilizado)
    • Cliente_No_WC
    • LiAdr_Address (endereço de entrega)
    • LiAdr_Companhia
    • LiAdr_Código do país
    • Nome_do_LiAdr
    • LiAdr_Cidade
    • LiAdr_PLZ
    • LiAdr_primeiro_nome
    • Taxa de IVA
    • ReAdr_Address (endereço de faturação)
    • ReAdr_Companhia
    • ReAdr_Código do país
    • ReAdr_Name
    • ReAdr_Cidade
    • ReAdr_PLZ
    • ReAdr_primeiro_nome
    • Estado_pago
    • Telefone
    • Método de envio
    • Moeda
    • Método de pagamento
  • Cargos - Tabela de itens de ordem, contém os seguintes campos:
    • Número de encomenda (número de encomenda do WooCommerce)
    • _pk_Position_ID (chave primária)
    • Quantidade
    • Artigo_No
    • Descrição do artigo
    • Montante_IVA
    • Montante_líquido
    • id (chave primária do WooCommerce)
    • product_id (ID do produto no WooCommerce)
  • Definições - Definições para a API RESTful do WooCommerce
    • Sistema externo (Global) - Nome do sistema externo (apenas utilizado se forem utilizados vários sistemas externos)
    • rf_URL (Global) - URL do servidor com o caminho para a API
    • rf_Benutzer (Global) - Nome de utilizador/chave de consumidor para a API RESTful
    • rf_Password (Global) - Palavra-passe/Segredo do consumidor
    • rf_Status_SSL (Global) - Estado, se o SSL deve ser utilizado ou não
    • rf_Endpoint (Global) - Ponto final da API RESTful
    • Objeto rf_Start (Global) - Objeto de início dentro do ponto final

As tabelas "Orders" e "Items" estão ligadas através da chave "_Order number". Os campos nestas tabelas podem ser renomeados conforme necessário para integração nas suas próprias soluções FileMaker. A tabela "Settings" não contém uma ligação porque todos os campos foram definidos globalmente. Se for necessário ligar vários sistemas de terceiros com RESTful API, é aconselhável não definir os campos como campos globais e adicionar uma chave primária para selecionar o sistema de terceiros.

Iniciar sessão na API RESTful

A solução de amostra da FileMaker contém dois scripts parciais com os quais os dados de encomenda da loja online podem ser importados para a FileMaker. No script "ts.Query_REST_API", o início de sessão na Servidor. Para o efeito, o plugin MBS chama as funções cURL correspondentes com a seguinte sequência:

  • Abrir nova sessão cURL
  • Definir URL para a API REST
  • Definir dados de início de sessão
  • Definir opção de cabeçalho
  • Definir SSL
  • Ativar as mensagens de registo
  • Executar consulta com mensagem de erro
  • Resultado no terreno [Ordens::JSON_Output] escrever
  • Fechar a sessão cURL, Limpeza

Script FileMaker: 'ts.Query_REST_API'

Ler dados JSON da interface

O segundo subscrito "ts.Parse_JSON_Orders_WC" lê os dados JSON fornecidos pelo servidor e insere-os nos campos individuais das tabelas "Orders" e "Items". Todos os dados do objeto inicial "orders" (ver campo "Start object" nas definições) são primeiro transferidos para a tabela Variável $ordersJSON é escrito. Segue-se um ciclo de execução principal para ler todas as encomendas e um outro ciclo de execução para importar todos os itens de uma encomenda. O servidor já não é acedido neste script.

Subscrito FileMaker 'Analisar JSON'

Todos os campos do endereço de expedição (shipping_address), do endereço de faturação (billing_address) e das rubricas (line_items) estão localizados numa estrutura em árvore e devem ser preenchidos com o comando:

MBS( "JSON.GetObjectItemTree"; json; names )

podem ser lidos a partir da árvore correspondente. Todos os outros campos podem ser lidos normalmente utilizando as funções MBS( "JSON.GetStringValue"; json ) ou MBS( "JSON.GetIntegerValue"; json ).

Descarregar base de dados de amostra FileMaker

Pode descarregar a base de dados de amostra da FileMaker descarregar aqui e testá-lo com qualquer loja virtual WooCommerce. A versão pública está bloqueada para a edição de definições de campos e scripts. Gostaria de começar imediatamente com a solução de amostra e personalizá-la de acordo com os seus próprios requisitos? Então é bem-vindo a Contactar-nos connosco.

Deixar um comentário

  1. Parece-me ser isso que estou à procura. O inverso também é possível? Ou seja, escrever as alterações de volta na base de dados mysql?

    1. Os plugins utilizados na solução de exemplo também suportam naturalmente o processo inverso, que permite que os dados sejam escritos na base de dados do WooCommerce através da API RESTful.

  2. Após o lançamento do FMP 16 com a API RESTful integrada e Json, será agora possível ligar ao WC sem o plug-in MBC?

    1. Sim, com a FileMaker 16 tudo isto deve agora ser possível sem utilizar o plugin MBS. No entanto, a solução só funciona na FileMaker 16 e não em versões anteriores.

      1. Muito interessante, será necessário atualizar o seu exemplo para ter isto em conta?

        1. Sim, se as funções devem ser executadas nativamente com as novas funções da FileMaker 16, as funções baseadas em MBS devem ser reprogramadas de acordo.

          1. Estão a planear criar uma versão nativa do FMP 16 sem o plug-in MBS?
            se sim, estou muito interessado

          2. Não, não tenciono desenvolver uma versão nativa da FileMaker para esta solução, uma vez que geralmente utilizo o plugin MBS para este tipo de funções.

  3. Olá, existe alguma experiência se a demonstração atual também funciona com a versão atual do Woocommerce e fm 19? Obrigado pela atenção

    1. Olá, o software não deve ter qualquer problema com a FileMaker 19 - mas neste caso poderia provavelmente resolver tudo com recursos integrados, deixando de ser necessário o plugin MBS FileMaker. No que diz respeito à loja, o software já não está atualizado e poderá ter de ser adaptado às versões mais recentes do WooCommerce. No entanto, isto não altera o princípio básico.

    2. O princípio básico não mudou desde o desenvolvimento até hoje, exceto que possivelmente foram adicionados mais campos na interface do WooCommerce.

Partilhar esta página:

Um software ERP tão flexível como a sua empresa.
Teremos todo o prazer em o aconselhar.

Software ERP personalizável para Mac, Windows e iOS.

Você está aqui: Importar encomendas do WooCommerce para a FileMaker através da RESTful API