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.23
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
Atualização Parâmetros faturamento (FT0301) > O campo "ICMS Incluso no Preço" deverá estar marcado. O preço de tabela integrado para o e-commerce já possui o ICMS incluso.
Natureza Operação > O campo "Consumidor final" da aba ICMS deverá estar marcado. Os cálculos de impostos são aplicados para vendas com natureza de operação voltada ao consumidor final (pessoa física / pessoa jurídica).
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 Categoria x Itens Ciashop - 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, será considerado o depósito informado no programa Loja x Estabelecimento Ciashop - PD0310. Já para o envio do preço do item, será considerada a tabela de preço padrão informada no programa Loja Ciashop - PD0309 Obrigatoriamente, todos os itens enviados para o Ciashop deverão estar cadastrados na tabela de preço informada no programa PD0309, assim como deverão estar cadastrados com saldo em estoque para o depósito informado no programa 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 Loja x Tabelas de Preço Ciashop - PD0627 ou parametrizar mais de um depósito por meio do programa Loja x Depósitos Ciashop - PD0628 para o envio do preço e saldo do item.
Controle do saldo em estoque
Para melhor assertividade no controle dos estoques, o cliente deverá considerar uma das opções abaixo:
- Clientes que trabalham com alocação lógica no pedido devem ter um depósito exclusivo para vendas na Loja ou Marketplace, não poderão trabalhar com mais de um depósito.
- Clientes que trabalham com alocação física automática – o sistema já irá fazer o tratamento correto.
- Clientes que trabalham com alocação física manual – a alocação será feita de forma automática para os pedidos com origem igual a Ciashop.
- Os clientes que forem implantar a integração com Ciashop e não trabalharem com alocação no pedido terão que marcar o parâmetro para alocação física – manual e o parâmetro “Realocação Física/Lógica” deverá igual a Não Obrigatória. Desta forma não irá impactar na rotina atual, ou seja, não irá impactar a implantação de pedidos cuja a origem seja diferente de Ciashop e, para os pedidos com origem Ciashop o tratamento para baixa do estoque será feita de forma correta.
Cadastros
Natureza Operação Brinde: Informar neste campo uma natureza de operação estadual que será utilizada durante a implantação do pedido de venda de brinde no Datasul.
Natureza Interestadual Brinde:Informar neste campo uma natureza de operação interestadual que será utilizada durante a implantação do pedido de venda de brinde no Datasul.
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 Categoria x Itens Ciashop - 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 Categoria x Itens Ciashop - PD0623:
Caso necessário, é possível 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.
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:
Quando a integração for com a Loja do Ciashop, é necessário também que existam métodos de pagamentos cadastrados no programa Cadastro de Métodos de Pagamento Ciashop, de acordo com os métodos de pagamentos que foram disponibilizados na loja, como por exemplo: boleto, transferência bancaria, cartão de crédito ou faturado. Quando a integração for com marketplace, é necessário cadastrar um único método de pagamento, o método de pagamento a ser cadastrado no programa Cadastro de Métodos de Pagamento Ciashop deverá ser o "pagamentoNaoIdentificado" e com o tipo "Faturado".
Funcionamento dos tipos de métodos de pagamento
Tipo Método de Pagamento | Integração de Título a Receber | Funcionamento |
---|---|---|
Boleto | No Pedido de Venda | Será integrado um título a receber por pedido de venda com origem "PEDVDA". Informações obrigatórias: Espécie, Série Fiscal, Portador e Carteira Informações opcionais: Cliente e Representante Deverá ser informada um espécie de título do módulo de contas a receber parametrizada com os campos Contabilização = Não e Gera Antecipação = Sim (exemplo abaixo). Deverá ser informada uma série fiscal cadastrada no programa UTB113AA. Deverão ser informados um portador e carteira cadastrados e compatíveis com o banco emissor do boleto proveniente da plataforma Ciashop. Quando o título a receber integrado for liquidado integralmente, o pedido de venda será liberado para faturamento e será criada uma antecipação para o cliente com origem PEDVDA vinculada ao respectivo pedido. O titulo a receber proveniente do faturamento (nota fiscal) também será integrado ao módulo de contas a receber e será liquidado automaticamente na integração, usando a antecipação gerada na liquidação da baixa do título do boleto. Esta liquidação automática poderá ser desativada no programa ACR009AA, desmarcando a opção "Abater Antecip PEDVDA Automaticamente" (abaixo). Importante: Para pagamento com métodos de pagamento "Boleto", a plataforma da Ciashop informa o número bancário (nosso número). Desta forma, é possível usar a rotina de retorno de cobrança escritural para liquidas os títulos. |
Transferência Bancária | No Pedido de Venda | O funcionamento do tipo de método de pagamento "Transferência Bancária" é idêntica ao tipo de método de pagamento "Boleto" descrito acima. A única diferença é que a plataforma não informa o número bancário (porque não existe) e as liquidações deverão ser feitas manualmente no módulo de Contas a Receber. |
Cartão de Crédito | Na Nota Fiscal | No tipo de método de pagamento "Cartão de Crédito", o risco de crédito é assumido pela Administradora de Cartão, portanto, o pedido entra liberado para faturamento e os títulos são integrados a partir da nota fiscal. Além do módulo de Contas a Receber, as vendas com cartão de crédito são integradas com o módulo de Cobranças Especiais que controlará o parcelamento da venda e o percentual de comissão retida pelas administradoras. Informações obrigatórias: Portador, Carteira, Administradora e Bandeira. O cadastro de Administradora/Carteira deverá ser feito no programa ACR002AA. Informação opcional:Representante. |
Faturado | Na Nota Fiscal | No tipo de método de pagamento "Faturado", o pedido de venda deverá ter seu crédito aprovado para liberá-lo para faturamento e o título a receber será integrado a partir do faturamento (nota fiscal). Este deverá ser o tipo de método de pagamento quando se estiver trabalhando com Marketplaces, em que este recebe os valores do consumidor final e os repassa periodicamente para a empresa vendedora. Informações obrigatórias: Portador e Carteira Informação opcional: Cliente e Representante. |
Importante:
Estorno de títulos a receber e cancelamento de pedido de venda:
Para títulos a receber integrados a partir do pedido de venda (Boleta e Transferência Bancária) é possível estornar os títulos não pagos através do programa ACR546AA (abaixo). Este programa estornará os títulos a receber e cancelará o pedido de venda. Esta opção foi criada para facilitar o controle dos pagamento com boleto e transferência bancária, pois ocorre frequentemente que o cliente desiste da compra e não efetua o pagamento. Selecionar a opção "Somente títulos origem PEDVDA".
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 |