A integração entre o BackOffice Datasul e a Plataforma e-Commerce da Ciashop tem como objetivo realizar a comunicação da loja de comércio eletrônico com o ERP Datasul.
Linha CiashopTabela de Preço
Ciashop: Sistema vertical desenvolvido pela Ciashop, empresa do ecossistema TOTVS, que dispõe de módulos e aplicativos voltados para o e-commerce. Com a plataforma Framework Ciashop, é possível montar sua própria loja de comércio eletrônico, integrando esta loja com os principais marketplaces disponíveis no mercado.
Linha Datasul (BackOffice)
ERP Datasul: Sistema de BackOffice para gestão de empresas com ênfase no segmento de Manufatura. Disponibiliza módulos de gestão e controle da distribuição com foco nos requisitos comerciais, fiscais e tributários, entre eles: Pedidos de Venda, Faturamento e Embarques.
A forma de comunicação entre ERP e Ciashop se dará por meio de mensagens enviadas e recebidas de um Web service RESTful. Os Web services RESTful são serviços construídos com o estilo de arquitetura RESTful. A construção de Web services com a abordagem RESTful está surgindo como uma alternativa popular ao uso de tecnologias baseadas em SOAP para implantação de serviços na Internet, por ser mais leve e ter a capacidade de transmitir dados diretamente via HTTP.
A plataforma Framework Ciashop é uma plataforma em que o cliente pode montar sua própria loja de comércio eletrônico.
O Ciashop permite que o cliente monte sua própria loja virtual. Para estabelecer a estrutura da loja virtual com seus departamentos e itens postos à venda, o ERP deverá fornecer tais informações. A loja virtual estará integrada com o ERP transmitindo para este os clientes e pedidos cadastrados na loja virtual.
O conceito de Marketplace (MP), no comércio eletrônico, é a utilização de uma loja virtual de terceiros para vender os seus produtos. Sales Hub é um aplicativo disponível para Lojas Framework da Ciashop que concentra diversos marketplaces, tais como Extra e Walmart. Por meio deste aplicativo, é possível ofertar os produtos da loja nestes marketplaces e gerenciar os pedidos gerados nestes canais em sua própria loja.
O objetivo da integração é possibilitar a integração dos Estabelecimentos (Filiais), Cadastros de Famílias Comerciais, Itens, Preços do Item, Depósitos e Saldo em Estoque disponível do Datasul para o Ciashop. Assim como, a integração do recebimento de pedidos de venda oriundos do Ciashop e a atualização do status destes pedidos.
Versão\release 12.1.20
Parâmetros de integração ativo: Cadastros Gerais -> Cadastros Gerais -> Cadastros -> Função: Manutenção Cadastros Gerais Parâmetro Global (CD0101 - Aba Integr II)
Parâmetros de configuração da integração ativo: Menu -> Logística -> Pedidos -> Cadastros -> Função: Parâmetros Integração Ciashop
Vide tópico Pré-requisitos instalação/implantação/utilização.
Vide tópico Pré-requisitos instalação/implantação/utilização.
O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução das mensagens de integração e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Ciashop e Backoffice Datasul estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
Método | ID | Descrição | Origem | Destino | Web Services |
Cadastros | 01 | Família Comercial | Datasul | Ciashop | Departments |
02 | Itens | Datasul | Ciashop | Products | |
03 | Preço Item | Datasul | Ciashop | Prices | |
04 | Saldo Estoque | Datasul | Ciashop | Variants | |
05 | Estabelecimento | Datasul | Ciashop | Branch | |
06 | Depósito | Datasul | Ciashop | Warehouse | |
Processos | 05 | Receber pedidos | Ciashop | Datasul | Orders |
06 | Atualizar situação dos pedidos | Ciashop | Datasul | Orders | |
07 | Cancelar Pedido | Datasul | Ciashop | Orderstatuses | |
08 | Atualizar NF-e | Datasul | Ciashop | Invoices |
Os cadastros devem ser realizados no ERP Datasul e replicados para o Ciashop, por meio do programa de carga presente no ERP Datasul. Importante ressaltar que, qualquer movimentação na plataforma do Ciashop (inclusão, alteração, eliminação) não é replicada para o ERP Datasul. A operação de eliminação dos registros (referentes aos cadastros) no ERP Datasul, também não integra com o Ciashop.
Por meio do programa Integração Batch Ciashop - PD0624, é possível realizar a carga/atualização dos registros em lote, ele pode ser acessado pelo menu do Datasul em: Logística -> Pedidos -> Tarefas.
O sucesso das operações de inclusão e alteração de registros pode ser verificado acessando o programa Monitor Integração Ciashop - PD0625. Por meio deste programa, é possível realizar a consulta do envio dos registros referente aos cadastros de Estabelecimento, Família Comercial, Itens, Preço Item, Depósito, Saldo em Estoque, recepção dos pedidos e atualização da situação dos pedidos.
No programa Manutenção Categoria Item - PD0623, é possível definir todas as famílias comercias (Categoria) e seus respectivos itens (Produtos) que serão enviados ao Ciashop. Importante ressaltar que, os itens que serão enviados para o Ciashop precisam obrigatoriamente estarem cadastrados no programa Tabela Preço - CD1508, este cadastro é necessário, pois o preço do produto no Ciashop é o valor informado no campo Preço FOB do programa CD1508. Para que o saldo disponível em estoque do item seja enviado ao Ciashop, é necessário que este possua saldo em estoque disponível, caso o item não possua saldo, é possível realizar o cadastro por meio do programa Transações Diversas Estoque - CE0220.
Para o envio das informações de saldo e preço do item, serão considerados o depósito e a tabela de preço padrão informados no programa Parâmetros Integração Ciashop - PD0310. Obrigatoriamente, todos os itens enviados para o Ciashop deverão estar cadastrados na tabela de preço informada no programa PD0310, assim como deverão estar cadastrados com saldo em estoque para o depósito informado também no PD0310. Caso o cliente possua o módulo MultiPreço ou MultiCD da Ciashop, será possível parametrizar mais de uma tabela de preço por meio do programa Relacionamento Estabelecimento x Tabela de Preço Ciashop - PD0627 ou parametrizar mais de um depósito por meio do programa Relacionamento Estabelecimento x Depósito Ciashop - PD0628 para busca de preço e saldo do item.
Cadastros
Família Comercial:
Para que a integração do cadastro de Família Comercial seja realizada, é obrigatório:
Além disso, é necessário cadastrar esta família comercial no programa Manutenção Categoria Item - PD0623:
As famílias comerciais (no contexto Ciashop possuem a descrição de categorias), enviadas do BackOffice Datasul para o Ciashop, poderão ser consultadas no manager do Ciashop, por meio do menu: Categorias e Produtos -> Gerenciar Categorias:
Item:
Para que a integração do cadastro de itens seja realizada, é obrigatório marcar o parâmetro "Item" no programa Integração Batch Ciashop - PD0624, aba parâmetro:
Além disso, é necessário definir que este item será considerado na integração com o Ciashop por meio do programa Manutenção Categoria Item - PD0623:
É necessário informar para os itens que serão enviados ao Ciashop o código EAN/GTIN por meio do campo Cód GTIN (TRIB), que está localizado no programa Atualização Itens Faturamento - CD0903, aba Fiscal.
Os itens enviados do BackOffice Datasul para o Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Categorias e Produtos -> Catálogos de Produtos:
Preço/Tabela de Preço:
Para que a integração da atualização do preço do item seja realizada, é obrigatório:
Além disso, é necessário cadastrar os preços para todos os itens que serão enviados para o Ciashop por meio do programa Tabela Preço - CD1508:
Os preços enviados do BackOffice Datasul para o Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Categorias e Produtos -> Catálogos de Produtos -> Cadastros de Produtos -> Preço e Estoque:
Saldo em Estoque:
Para que a integração da atualização do saldo em estoque disponível dos itens seja realizada, é obrigatório:
O cadastro de saldo em estoque poderá ser realizado por meio do programa Transações Diversas Estoque - CE0220:
O saldo em estoque enviado do BackOffice Datasul para o Ciashop, poderá ser consultado no manager do Ciashop, por meio do menu: Categorias e Produtos -> Catálogos de Produtos -> Cadastros de Produtos -> Preço e Estoque:
Quando a funcionalidade de MultiCD estiver ativa na plataforma Ciashop, é possível consultar os depósitos e suas respectivas quantidades de saldo em estoque, para isso é necessário clicar no lápis localizado ao lado campo Estoque Armazém.
Após clicar no lápis, será aberta a tela que apresenta todos os depósitos disponíveis para o item selecionado:
Por meio do programa Monitor Integração Ciashop - PD0625, é possível realizar a consulta do envio dos registros referente aos cadastros de Estabelecimento, Família Comercial, Itens, Preço Item, Depósito, Saldo em Estoque, recepção dos pedidos e atualização da situação dos pedidos:
Segue o detalhamento dos campos:
Eliminar: Elimina a mensagem, neste caso, o registro também poderá ser enviado novamente caso não haja um outro registro como registro lido igual “sim” para o mesmo Nr Docto.
Buscar Pedido: Quando o tipo do documento for “Pedido” e este ainda não foi importado com sucesso (registro lido igual a “sim”), este poderá ser solicitado novamente ao Ciashop.
Atualizar Situação: Quando o tipo do documento for “Pedido”, e possível verificar o status deste pedido no Ciashop por meio deste botão. Caso o pedido esteja como cancelado no Ciashop, este pedido será cancelado automaticamente no ERP Datasul caso este pedido já esteja completado, caso contrário, não será possível cancelar o pedido. Só é possível cancelar um pedido no ERP Datasul, quando este já está completo no sistema.
Detalhar Pedido: Quando o tipo do documento for “Pedido”, e possível verificar maiores informações deste pedido por meio do botão Detalhar Pedido. Ao clicar neste botão, será chamado o programa PD1001 (Pedido Venda).
Confirmar Pagamento: Quando o tipo do pagamento for Boleto ou Transferência Bancária, permite ao usuário executar novamente a atualização da situação do pedido para pagamento aprovado.
No grid Ocorrências Integração do programa PD0625, é possível detalhar a mensagem de erro com um clique duplo caso necessário.
Recepção do Pedido de Venda:
Para que a recepção do pedido de venda seja realizada é obrigatório:
A recepção do pedido de venda é realizada por meio do parâmetro "Pedido Venda" no programa Integração Batch Ciashop (PD0624), aba parâmetro:
Os pedidos disponíveis no Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Listagem de Pedidos:
Atualização da situação do Pedido de Venda:
Para a atualização da situação do pedido de venda, é obrigatório:
A atualização da situação do pedido de venda é realizada por meio do parâmetro "Atualizar situação dos Pedidos " no programa Integração Batch Ciashop - PD0624, aba parâmetro:
A situação dos pedidos disponíveis no Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Listagem de Pedidos. Ou por meio do programa Monitor Integração Ciashop - PD0625 no BackOffice Datasul, coluna "Situação":
Envio da Nota Fiscal para o Ciashop:
O envio da nota fiscal para o Ciashop é realizado após o uso autorizado da Nota Fiscal que foi originada a partir de um pedido de venda oriundo do Ciashop :
No momento do envio da nota fiscal para o Ciashop será atualizado a situação do pedido para Empacotado.
Os dados da nota fiscal poderá ser consultada no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Informações do Pedido:
Ao clicar no botão Editar, será possível consultar maiores informações da Nota Fiscal:
Envio da URL de rastreamento para o Ciashop:
Para a atualização da situação do pedido de venda, é obrigatório:
O envio da URL de rastreamento para o Ciashop é realizado por meio do botão "Rastreamento" no programa Manutenção Notas Fiscais - FT0502, Aba Inf Gerais:
Ao clicar no botão Rastreamento, informar a URL de rastreamento, ao clicar no botão "OK", esta URL será enviada para o Ciashop:
Após informar a URL no Datasul, será atualizado no Ciashop o status do pedido para Enviado.
A URL de rastreamento poderá ser consultada no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Listagem de Pedidos -> Visualização do Pedido:
Consulta Pedido de Pagamento Ciashop:
Permite consultar as informações do pagamento do pedido de todos os pedidos de vendas que são oriundos da integração com o Ciashop:
Erros de integração:
Código | Erro | Rota de Integração | Situação | Relação |
55117 | Categoria não cadastrada na Ciashop! | DATASUL > CIASHOP | O item enviado está relacionado a uma Família Comercial (Categoria) não cadastrada na Ciashop. | Pedido de Vendas |
55118 | Categoria já existe em outro relacionamento! | DATASUL > CIASHOP | A Família Comercial (Categoria) enviada para Ciashop já está relacionada como "pai" ou como "filho" de outra Categoria. | Pedido de Vendas |
55119 | Item já integrado na Ciashop! | DATASUL > CIASHOP | O item já foi integrado na Ciashop! | Pedido de Vendas |
55120 | Categoria já foi integrada na Ciashop! | DATASUL > CIASHOP | A Família Comercial (Categoria) já foi integrada na Ciashop! | Pedido de Vendas |
55121 | Integração sem sucesso! | DATASUL > CIASHOP | A Integração referente a(o) não ocorreu devido a caracteres especiais não permitidos. | Pedido de Vendas |
55122 | URL já integrada na Ciashop! | DATASUL > CIASHOP | A URL já foi integrada na Ciashop. | Pedido de Vendas |
55123 | Preço não atualizado na Ciashop! | DATASUL > CIASHOP | O Preço não foi atualizado porque o item não foi integrado na Ciashop. | Pedido de Vendas |
55124 | Erro no Saldo em Estoque! | DATASUL > CIASHOP | Não existe Saldo em Estoque para o item no(s) Depósito(s) parametrizado(s) para Integração com a Ciashop. | Pedido de Vendas |
55125 | Erro no Saldo em Estoque para o Estabelecimento! | DATASUL > CIASHOP | Não existe Saldo em Estoque para o item parametrizados para Integração com a Ciashop. | Pedido de Vendas |
55126 | Erro no Saldo em Estoque! | DATASUL > CIASHOP | Não existe Saldo em Estoque disponível para o item em nenhum dos Depósitos parametrizados para Integração com a Ciashop. | Pedido de Vendas |
55127 | Saldo em Estoque permanece inalterado! | DATASUL > CIASHOP | O Saldo em Estoque do Item permanece inalterado desde o último envio para o Ciashop. | Pedido de Vendas |
55128 | Item não Cadastrado! | DATASUL > CIASHOP | O Item não está cadastrado na Tabela de Preço Padrão utilizada para integração com a Ciashop. | Pedido de Vendas |
55220 | Código EAN Inválido! | DATASUL > CIASHOP | Favor verificar se o código EAN está informado no cadastro do item, CD0903, pasta Fiscal, campo "Cod. GTIN (Trib)". Este código deve ser único por item, ou seja, o mesmo código EAN não poderá estar associado a mais de um item. | Pedido de Vendas |
55250 | Referência deve conter um tipo! | DATASUL > CIASHOP | Para itens com referência deve ser informado o tipo da referência no programa CD1506 (Manutenção Referência Item). | Pedido de Vendas |