Integracao Loja Integrada
Esta integração envia dados conforme parametrizações realizadas e codificadas para o ecommerce Loja Integrada. São enviados os cadastros básicos principais inerentes e necessários para o funcionamento do mesmo.
Neste documento são detalhados quais registros e campos são enviados, limitações e configurações a serem realizadas.
A documentação da API Loja Integrada pode ser encontrada em https://lojaintegrada.docs.apiary.io/.
O ERP irá automaticamente verificar e enviar somente os registros criados/atualizados desde a última sincronização, sem nenhuma interferência ou controle do usuário.
Infelizmente o retorno de erros e falhas deste ecommerce são fracas e não claras, sendo erros genéricos. Os erros possíveis serão mapeados aqui, mas infelizmente a sua confirmação será por tentativa e erro.
Configuração básica
Configure as propriedades de acesso e uso desta integração em 1809_Configuracao_Servicos_Terceiros. As propriedades a serem configuradas são:
- Chave API: Chave API fornecida pela loja integrada. Cada estabelecimento tem a sua chave.
- Chave Aplicação API: Chave Aplicação API fornecida pela loja integrada. Chave única da Touch Comp.
- Identificador da tabela de preços: Identificador da tabela de preços que será utilizada para determinar quais produtos estarão no site e seus preços. Somente serão enviados os produtos que estiverem nesta tabela de preço. Você deve informar apenas o identificador da mesma. A tabela é cadastrada no recurso 177- Tabela de Preços Base
- Dias Envio: Caso não seja informado no produto, será enviado este valor quanto ao prazo de postagem.
- Dias Envio Sem estoque: Caso não seja informado no produto, será enviado este valor quanto ao prazo de postagem.
- Identificador do Centro de Estoque: Identificador do Centro de estoque que estão os produtos disponíveis para o ecommerce, cadastrado no recurso 805 - Centro Estocagem.
- Empresa: Empresa configurada para envio dos dados.
- Itens a serem sincronizados: Informe quais itens serão enviados pelo ERP. Informe os códigos de cada item separados por ;. Por exemplo: 10;20;30;40;50;. Neste caso serão enviados todos os itens. Verifique na tabela abaixo os códigos de cada item.
| Código do item | Item | Observação |
|---|---|---|
| 10 | Categorias de Produtos | Conforme recurso 1869. Somente são enviados categorias dos produtos enviados. |
| 20 | Fabricantes/Marcas | Conforme recurso 59. Somente são enviados fabricantes/marcas dos produtos enviados. |
| 30 | Produtos | Conforme produtos na tabela de preços, recurso 65. Somente são enviados produtos que existem na tabela de preços. |
| 40 | Preços | Conforme tabela de preços, recurso 177. |
| 50 | Estoque | Conforme inventário, centro de estoque, empresa. |
Posteriormente, ative e também configure a tarefa no ERP 1673_Tarefas_Servidor.
Registros
Categorias
As categorias são utilizadas nos sites de maneira a facilitar a busca de produtos. O Touch Comp ERP possui atualmente dois níveis de categorias e ainda um produto está limitado a basicamente uma categoria em si. Isto porquê, são enviados os registros de 57 - Espécie e 58 - Subespécie. Apesar de um registro único no site, no ERP a categoria está nestas duas tabelas, e as mesmas serão aglutinadas para serem enviadas.
| Campo | Origem | Destino |
|---|---|---|
| ID | id | identificador da plataforma, Campo código de sincronização da espécie/subespécie. |
| ID ERP | id_externo | identificador da espécie/subespécie |
| Descrição | descricao | descrição/nome da espécie/subespécie |
| Categoria Pai | categoria_pai | vazio/nulo se espécie ou identificador da espécie vinculada a subespécie. |
Marcas
No caso das marcas, o ERP irá enviar os dados do 59 - Fabricante.
| Campo | Origem | Destino |
|---|---|---|
| ID | id | identificador da plataforma, Campo código de sincronização. |
| ID ERP | id_externo | identificador do fabricante |
| Nome | nome | nome/descrição do fabricante |
| Apelido | apelido | nome/descrição do fabricante |
| Descrição | descricao | nome/descrição do fabricante |
| Imagem | imagem | não enviado |
Grade
No caso das grades, o ERP irá enviar os dados do 55 - Derivação de Grades.
Este dado não está sendo enviado no momento, pois para produtos simples não é suportado pelo site.
| Campo | Origem | Destino |
|---|---|---|
| ID | id | identificador da plataforma, Campo código de sincronização. |
| ID ERP | id_externo | identificador da grade |
| Nome | nome | nome/descrição da grade |
| Nome | nome_visivel | nome/descrição da grade |
| Variações | variacoes | não enviado |
Produtos
Os dados enviados são correspondentes ao recurso 65 - Produtos e Serviços.
Atenção para os campos Altura, Largura e Comprimento. No ERP os mesmos são informados em Metros. Na plataforma são informados em centimetros. Ao enviar, estes valores são multiplicados automaticamente por 1000.
- Somente são enviados os produtos que estão na tabela de preços, conforme seção configurações. Produtos sem preço não são enviados.
| Campo | Origem | Destino |
|---|---|---|
| ID | id | identificador da plataforma, Campo código de sincronização. |
| ID ERP | id_externo | identificador da produto |
| Altura | altura | Altura |
| Apelido | apelido | nome auxiliar do produto |
| Ativo | ativo | campo Ativo do produto e tabela de preços. Caso o produto esteja inativado no seu cadastro ou na tabela de preços será enviado como inativo. |
| Bloqueado | bloqueado | Produto Info Ecommerce, campo bloqueado |
| Categorias | categorias | Espécie/Subespécie vinculada ao produto |
| Data Cadastro | data_criacao | Data de Cadastro |
| Data de Modificação | data_modificacao | Data de Atualização |
| Descrição Completa | descricao_completa | Campo Observações |
| Em Destaque | destaque | Produto Info Ecommerce, campo Destaque |
| GTIN/EAN/Codigo Barras | gtin | Código de Barras Ativo e marcado como "Usar como EAN". Caso não encontre, enviará o código de barras Ativo. Caso não encontre, não será enviado |
| Imagem Principal | imagem_principal | não enviado |
| Imagens | imagens | não enviado |
| Largura do Produto | largura | Largura do produto |
| Marca | marca | Fabricante |
| MPN | mpn | não enviado |
| NCM | ncm | NCM |
| Nome do Produto | nome | nome |
| Produto Pai | pai | não enviado |
| Peso | peso | Peso unitário (Kg) |
| Profundidade | profundidade | Comprimento |
| Usado | usado | Produto Info Ecommerce, campo Usado |
| SKU | codigo sku | Enviado o Produto Info Ecommerce, campo SKU. Caso vazio, será enviado código auxiliar do produto, caso vazio será enviado o identificador do produto |
| Variações | variacoes | não enviado, tipo de envio de produto simplificado. |
Preços
Os preços são enviados conforme recurso 177- Tabela de Preços Base.
| Campo | Origem | Destino |
|---|---|---|
| ID | id | identificador da plataforma, Campo código de sincronização. |
| Valor Promocional | promocional | Valor de Venda |
| Valor de Venda Anterior | cheio | Valor de Venda Anterior |
| Valor de Custo | custo | Valor de Custo |
Estoque
O estoque é enviado conforme posição atual, conforme centro de estoque e empresa previamente configurados.
Atenção! O ERP suporta a quantidade do produto em decimal, mas o site apenas em números inteiros. Assim, caso o produto esteja em quantidade decimal, será automaticamente convertido em unidades. Por exemplo: quantidade do produto 1,50, será enviado 1.
| Campo | Origem | Destino |
|---|---|---|
| ID | id | identificador da plataforma, Campo código de sincronização. |
| Gerenciado pela Plataforma | gerenciado | Enviado sempre verdadeiro. Consulte manual Loja Integradora para detalhes |
| Quantidade | quantidade | Quantidade em Estoque |
| Quantidade Reservada | quantidade_reservada | Enviado como 0 |
| Quantidade Disponivel | quantidade_disponivel | Quantidade em Estoque |
| Situação em Estoque | situacao_em_estoque | Enviado Dias De Envio, conforme seção configurações |
| Situação sem Estoque | situacao_sem_estoque | Enviado -1(Não disponível) |
Configurações
Serão necessários algumas configurações prévias para que o serviço de sincronização seja iniciado. As configurações devem ser informadas no recurso 1809- Configuração Serviços de Terceiros.
- Chave API: Chave a ser liberada pela Loja Integradora para comunicação. Esta chave é de responsabilidade dos mesmos.
- Código aplicação API: Código da Aplicação/Token a ser liberada pela Loja Integradora para comunicação. Esta campo é de responsabilidade dos mesmos.
- ID Tabela Base: Identificador da tabela de preços base a ser utilizada. Esta tabela define os produtos, estoques, e preços que serão enviados. Produtos não existentes nesta tabela não serão enviados.
- Dias Envio: Este campo é utilizado para informar a Loja integradora o tempo em dias para envio dos produtos.
- Id Centro Estoque: Id do Centro de estoque a ser utilizado para leitura do estoque e envio de informações do mesmo ao site. Você deve ter um centro de estoque específico para este fim.
- Id Empresa: Id da empresa base para envio/recebimento de informações do site. No caso do estoque por exemplo, será enviado as informações desta empresa e centro de estoque.
Após configurar estes dados no recurso 1809, você deve configurar a Tarefa/serviço que efetivamente irá enviar os dados ao ecommerce. Esta configuração deverá ser realizada no recurso 1673 - Tarefas. Neste recurso você informar com qual frequência o ERP deverá ler os registros, identificar atualizações e assim enviá-las para o site. Lembre-se também de informar o Id das configurações que já foram cadastradas no recurso 1809.
Códigos de Erros
E.TSK.0021.001 - Categoria de Produtos
- Verifique se a categoria informada no erro já não está cadastrada no site. Verifique tanto pelo identificador, código, quanto pela descrição.
E.TSK.0021.020 - Fabricante/Marca
- Verifique se o fabricante informado no erro já não está cadastrada no site. Verifique tanto pelo identificador, código, quanto pela descrição.
- Não informe apelido ou nome fantasia/observação. Caso informe certifique de serem diferentes. Certifique que no apelido não deve conter espaços ou caracteres especiais.
E.TSK.0021.040 - Grade de Produtos
- Verifique se a grade informada no erro já não está cadastrada no site. Verifique tanto pelo identificador, código, quanto pela descrição.
E.TSK.0021.060 - Produtos
- Verifique se o produto informado no erro já não está cadastrada no site. Verifique tanto pelo identificador, código auxiliar, quanto pela descrição/nome.
E.TSK.0021.080 - Preços
- Nenhuma ação até o momento.
E.TSK.0021.100 - Estoque
- Nenhuma ação até o momento.