Árvore de páginas
Ir para o final dos metadados
Ir para o início dos metadados

Integração WMS Operador Logístico X ERP Datasul


Contexto de Negócio (Introdução)

Muitas empresas que atuam do ramo de transportes vêm se tornando operadores logísticos, visando atender de forma mais completa as necessidades dos seus clientes.

Atualmente, há vários clientes TOTVS que se encontram nesta situação, sendo que a partir do momento em que aceitam realizar a operação logística completa dos seus clientes, necessitam ter um sistema WMS que atenda às necessidades específicas de cada um, além de contemplar também a legislação fiscal específica deste segmento.


Sistemas Envolvidos

  • WMS Operador Logístico (Logix)
  • ERP Datasul


Escopo

O escopo da integração de processos do WMS Operador Logístico x ERP Datasul é:


Todas as mensagens de integração utilizadas seguem o padrão de mensagens padronizadas da TOTVS, a chamada TOTVSMessage.

No ambiente do WMS (Logix) são utilizadas e registradas apenas as informações relativas aos processos do armazém.

As informações que são exclusivas de módulos como Fiscal, Contabilidade e Financeiro serão controladas apenas no ERP Datasul.


Pré-requisitos Instalação / Implantação / Utilização

No WMS, os seguintes pré-requisitos devem ser verificados:

  • Versão: A partir da release 12.1.21.
  • WebService criado para permitir a comunicação com o ERP Datasul.
  • Instalação do EAI Logix, que deve estar configurado e com as mensagens de integração habilitadas no monitor (EAI10000).
  • Nos casos em que o WMS já esteja em uso no cliente antes desta integração padrão, ao gerar o primeiro documento (nota fiscal de retorno simbólico, nota fiscal por conta e ordem, nota fiscal de faturamento de serviços) o sistema verificará se o controle de numeração de transações de documentos precisa ser ajustado. Caso seja identificada esta necessidade será apresentada a mensagem abaixo:



    Se a resposta for Não, a geração do documento solicitado não será efetuada, interrompendo o processo em andamento.
    Se a resposta for Sim, o sistema primeiro atualizará este controle de numeração das transações, para depois dar continuidade na geração do documento.
    Este procedimento de atualização é necessário para que não sejam duplicados os números de transações de nota fiscal gerados anteriormente, o que causaria conflitos de informações geradas antes e após a implantação da integração.

No Datasul o relacionamento De / Para de códigos é visualizado pela opção disponível no TOTVS Monitor:

  1. Acesse o TOTVS Monitor.

  2. Clique na aba EAI 2.

  3. Clique na aba Aplicação Externa.

  4. Selecione o Aplicativo Externo.

  5. Clique no botão De-para.

  6. Em Estrutura, selecione o De-para e efetue a inclusão ou a alteração conforme a necessidade.



Importante!

É necessário verificar também que no registro de documentos de entrada no Datasul o número do documento irá conter zeros à esquerda, no Logix o documento (nota fiscal) é do tipo numérico.


Instalação / Configuração

Configuração do EAI Logix

Para configurar o EAI Logix devem ser executados os seguintes procedimentos:

  • Informe os dados abaixo no arquivo de configuração do TOTVSTEC (TotvsAppServer.ini ou AppServer.ini):

[HTTP]
Enable=1
Port=<escolha_uma_porta_disponivel>
path=c:\totvs\bin\smartclient\

[WEBSERVICES]
Enable=1
Environment=<ambiente>
Conout=0
Trace=0
NameSpace=http://www.totvs.com
URLLocation=http://<seu_ip>:<porta_escolhida_em_http>
Logix=1

[ONSTART]
Jobs=4GLJOBEAI1

[4GLJOBEAI1]
Environment=<ambiente>
Main=EAIStarter


  • Informe os dados abaixo no arquivo de profile do TOTVSTEC (TotvsProfile.pro):

eai.hostapplication=<nome para identificar o Logix na integração>
eai.debug=<0 para inativo ou 1 para ativo>
eai.configprovider=EAIConfigProviderLogix
eai.userid=<usuario Logix>
eai.companyid=<empresa Logix>


  • Configure as transações que serão enviadas e recebidas:

Execute o programa EAI10000 (Monitor EAI), acesse o menu Configuração > Host Application e confira se o nome colocado na chave eai.hostapplication do arquivo de configuração do TOTVSTEC aparece no campo Hospedeiro na interface.

Se o nome do aplicativo hospedeiro estiver aparecendo corretamente, clique no botão Modificar e responda Sim para Recarregar as Transações. Neste momento o EAI percorrerá o seu RPO para localizar os adapters existentes, os quais representarão as mensagens que o EAI trabalhará.

Ainda no programa EAI10000, acesse o menu Configuração > External Apps. O objetivo desta opção é registrar quais serão os EAIs externos que serão utilizados para se comunicar ou que serão comunicados.

Clique em Incluir e depois no botão Configurar. Selecione a Classe canal correspondente ao produto com o qual queira se comunicar. No quadro Propriedades preencha as informações solicitadas e clique em Confirmar. Para configuração do WebService do Datasul é necessário informar o usuário e a senha.

Feito isso, serão exibidas na tela principal as transações que o aplicativo externo possui e com o qual pode-se trocar informações. Clique em Confirmar para finalizar a parametrização.

Uma vez concluída a configuração dos aplicativos externos retorne à tela Configuração > Host Application e clique novamente em Modificar.

Responda Não para Recarregar as Transações. Em seguida dê dois cliques no campo Rotas de cada mensagem, para indicar para qual aplicativo externo a mesma será enviada, habilitando a rota desejada:


Ao executar os procedimentos acima o EAI Logix está configurado para receber e enviar mensagens.

Configuração do EAI-2 Datasul

Para configurar o EAI-2 Datasul consulte a documentação em EAI 2.

Cadastramento de Programas no Menu Logix

Programa

Descrição

WMS6429

Exclusão Pedido Venda – Integração BackOffice

WMS6628

Integração Nota Fiscal Recebimento – Inclusão

WMS6629

Integração Nota Fiscal Recebimento – Exclusão

WMS80000

Monitor da Integração


Parâmetros Gerais Logix

Execute o programa LOG00087 (Manutenção de Parâmetros) e acesse o seguinte caminho: PROCESSO SAÍDAS → CADASTROS & TABELAS → CADASTROS & TABELAS

Os parâmetros abaixo fazem parte desta integração e devem ser devidamente atualizados antes da utilização:

Parâmetro

Objetivo

Código
Integra clientes, fornecedores e transportadoras com ERP Datasul?

Indica se o cadastro de clientes, fornecedores e transportadoras está integrado ao ERP Datasul.

Ao ativar este parâmetro a codificação destes cadastros passará a ser determinada pelo ERP Datasul, além da aplicação de outras regras especiais para atender à restrições deste produto.

Nota!

É necessário habilitar este parâmetro para que o Logix aplique algumas regras que se referem à restrições determinadas pelo ERP Datasul, referente ao cadastro de clientes, fornecedores e transportadoras.
integ_cli_forn_transp_datasul
Forma de codificação de clientes, fornecedores e transportadoras

Indica como será determinada a codificação do cadastro de clientes, fornecedores e transportadoras quando integrado ao ERP Datasul.

Opções:

1 - Determinado pelo ERP Datasul

2 - CNPJ/CPF e Inscrição Estadual

3 - De / Para de códigos

integ_codif_cli_forn_transp


Em: LOGIX WMS → LOGIX WMS → CADASTROS

Entre os parâmetros apresentados, verifique e atualize o que segue abaixo:

Parâmetro

Objetivo

Código

Prefixo para utilizar na codificação de itens controlados pelo WMS

Prefixo a ser utilizado na definição do código de um item, quando o grupo de estoque informado é controlado pelo WMS.

Nota!

Informe um valor neste campo caso queira que no ERP Datasul os itens integrados a partir do WMS tenham uma codificação diferenciada, ao invés de utilizar um sequencial simples.
wms_prefixo_codigo_item


Em: LOGIX WMS → LOGIX WMS → INTEGRAÇÃO COM OUTROS SISTEMAS

Entre os parâmetros apresentados, verifique e atualize o que segue abaixo:

Parâmetro

Objetivo

Código

Aplicativo externo utilizado para integração com backoffice

Aplicativo externo do EAI, utilizado para integração com BackOffice. Deve ser informado um aplicativo externo cadastrado na rotina EAI10000.

Este aplicativo será utilizado para o teste de conexão no monitor da integração (WMS80000).

wms_aplic_externo_backoffice

Número de segundos para timeout nas integrações pelo monitor

Número de segundos a ser considerado nas integrações processadas a partir do monitor da integração (WMS80000).

Caso não seja informado será considerado o tempo padrão (120 segundos).

wms_timeout_integracao_monitor

Número limite de tentativas de integração

Número máximo de tentativas de integração que cada mensagem poderá ter, para processamento via JOB.

Nota!

Para processamentos manuais não há limite de tentativas.
wms_limite_tentativas_integra

Tipo de integração do WMS com BackOffice

Indica se a integração com um BackOffice externo está ou não ativa e qual é este BackOffice.

Opções:

0 – A integração não está ativa

1 – Integração com Protheus

2 – Integração com Datasul

3 – Integração com RM

Nota!

Até o momento somente a integração com Protheus (opção 1) e Datasul (opção 2) estão implementadas. Para as demais integrações serão necessários desenvolvimentos complementares.
sistema_backoffice_integracao


Em: LOGIX WMS → OPERADOR LOGÍSTICO → EXPEDIÇÃO

Entre os parâmetros apresentados, verifique e atualize o que segue abaixo:

Parâmetro

Objetivo

Código
Integrar novo destinatário com ERP na inclusão da solicitação carga?

Indica se ao cadastrar um novo destinatário através do processamento de EDI ou XML de solicitação de carga, se o mesmo deve ser integrado ao ERP.

Opções:

  • G - Somente Depositante Armazém Geral: Somente efetuará a integração do novo destinatário se o regime de armazenagem do depositante associado à solicitação de carga for Armazém Geral.
  • F - Somente Depositante Filial: Somente efetuará a integração do novo destinatário se o regime de armazenagem do depositante associado à solicitação de carga for Filial.
  • A - Ambos: Efetuará a integração do novo destinatário independente do regime de armazenagem do depositante associado à solicitação de carga.
wms_integra_destinatario

Condição de pagamento para nota de retorno para faltas recebimento

Código da condição de pagamento a ser utilizada para emissão das notas fiscais de retorno simbólico referentes as faltas no recebimento.

wms_cnd_pgt_nf_devolucao

Condição de pagamento para notas de remessa por conta e ordem

Código da condição de pagamento utilizada na emissão das notas fiscais de remessa por conta e ordem.

wms_cnd_pgt_nf_conta_ordem

Condição de pagamento para notas de retorno simbólico

Código da condição de pagamento utilizada na emissão das notas fiscais de retorno simbólico, nos processos de expedição.

wms_cnd_pgt_nf_retn_simb

Natureza de operação para depositantes com regime especial

Código da natureza de operação utilizada na emissão das notas fiscais dos depositantes que estão sob regime especial.

wms_nat_oper_depos_rgm_armz

Natureza de operação para nota de retorno para faltas recebimento

Código da natureza de operação utilizada na emissão das notas fiscais de retorno simbólico referentes às faltas de produtos no recebimento.

wms_nat_operacao_nf_devolucao

Natureza de operação para notas de remessa por conta e ordem

Código da natureza de operação utilizada na emissão das notas fiscais de remessa por conta e ordem.

wms_nat_oper_nf_conta_ordem

Natureza de operação para notas de retorno de mercadoria depositada

Código da natureza de operação utilizada na emissão das notas fiscais de retorno de mercadorias ao depositante.

wms_nat_oper_nf_retn_merc

Natureza de operação para notas fiscais de retorno simbólico

Código da natureza de operação utilizada na emissão das notas fiscais de retorno simbólico nos processos de expedição.

wms_nat_oper_nf_retn_simb

Natureza operação para NF por conta e ordem, para UF com Subst.Tribut.

Código da natureza de operação utilizada na emissão das notas fiscais de remessa por conta e ordem, quando o relacionamento da unidade de federação de destino das mercadorias x NCM do produto estiver cadastrado no VDP0696 (Configuração Fiscal) para o tributo “ICMS_ST” com origem “S” (Saída).

Ressaltamos que as informações de tributação deste cadastro não serão utilizadas na integração, pois será utilizada apenas a verificação da existência do relacionamento.

wms_nat_oper_nf_conta_ordem_st


Em: PROCESSO MANUFATURA → ENGENHARIA → ESTRUTURA DE PRODUTOS

Entre os parâmetros apresentados, verifique e atualize o que segue abaixo:

Parâmetro

Objetivo

Código
Indica se a empresa trabalha com o conceito de multiempresa

Indica se a empresa trabalha com conceito de multiempresa.

Opções:

  • S - Sim, indica que a empresa trabalha com o conceito de multi empresa.
  • N - Não, indica que a empresa não trabalha com o conceito de multi empresa.

Nota!

Para que a integração do cadastro de itens ocorra corretamente é necessário que este parâmetro esteja como "N".
multi_empresa


Em: PROCESSO MANUFATURA → ENGENHARIA → CADASTRO DE ITENS

Entre os parâmetros apresentados, verifique e atualize o que segue abaixo:

Parâmetro

Objetivo

Código
Número da próxima sequencia de itens (multiempresa)

Número que identificará a próxima sequência da codificação de itens, quando for utilizado o conceito de multiempresa para o cadastro de itens.

Nota!

Informe uma sequência de itens que ainda não exista no cadastro de itens do ERP Datasul, no momento da implantação da integração.
seq_auto_item_multi_empresa
Utiliza codificação automática de itens multiempresa

Indica se deve ou não ser utilizado o controle de numeração unificada para codificação de itens.

Este parâmetro somente será utilizado quando o parâmetro Aplica numeração automática no código do item estiver habilitado.

Nota!

Para que a integração do cadastro de itens ocorra corretamente é necessário que este parâmetro esteja como "S", fazendo com que no Logix o código do item seja único, independente da empresa onde o mesmo é cadastrado, assim como ocorre no ERP Datasul.
util_auto_item_multi_empresa


Parâmetros Operador Logístico - Datasul (CD00596)

É importante cadastrar o Estabelecimento como sendo um Operador Logístico no programa CD00596.

Também é necessário realizar algumas configurações adicionais para Operador Logístico no ERP Datasul. Para isso, consulte a FAQ: DUFN0025 - Parâmetros Gerais da Integração do Operador Logístico

Código Único

O que é?

É um controle de numeração automático que é disponibilizado e controlado pelo Datasul.

Ele será aplicado quando o parâmetro Forma de codificação de clientes, fornecedores e transportadoras estiver como "1".

Ele permite que os cadastros sejam integrados com o mesmo código em todos os sistemas que estão integrados, desde que pertença a mesma pessoa física ou jurídica, garantindo assim, que a consulta de um cadastro especifico seja realizado em qualquer um dos sistemas integrados pelo mesmo código de pesquisa.

Para que este controle seja realizado corretamente é necessário habilitar a mensagem CustomerVendorReserveId.

Para mais detalhes, consulte a FAQ: http://tdn.totvs.com/x/Z-ZeE 

Como funciona?

Ao realizar um cadastro de Cliente, Fornecedor ou Transportadora é solicitado o código único para o Datasul (responsável pelo controle e distribuição do código). O Logix receberá o código determinado pelo ERP Datasul e efetuará o cadastro do registro, enviando em seguida a mensagem CustomerVendor ou Carrier para efetivação no ERP.

Engine de Regras - Datasul (Aplicado no Processo de Recebimento)

O cadastro das regras deve ser realizado pela rotina CD0024.

Veja como utilizar o Engine de Regras:

 


Naturezas de Operação

Devem ser criadas regras para sugerir a natureza de operação nos documentos relativos ao processo de entrada (Recebimento, via mensagem InputDocument e na Regularização Fiscal, via mensagem CoverageDocument).

Para esta configuração deve ser utilizado o tipo de operação re-nat-oper-eai, na qual podem ser utilizadas as seguintes variáveis nas condições das regras:

VariávelDescriçãoTipoConteúdoObservação
cod-emitenteFornecedorInteiroEx: 4578
it-codigoItemCaractereEx: 72585424
cod-ncmNCM do item (Classificação Fiscal)CaractereEx: 19052010

Programa de cadastro: CD0603

Relacionamento com o Item: RE0106

cfop-saidaCFOP saída sequência item NFCaractereEx: 5105TAG: OutputOperationFiscalCode
cfop-saida-nf-relacCFOP saída NF relacionadaCaractereEx: 5105Na NF de cobertura há a NF relacionada (provisória). Este é o CFOP de saída da NF relacionada
cfop-entradaCFOP entradaCaractereEx: 1905Tag: OperationFiscalCode
perc-red-bc-icms% de redução da base de cálculo do ICMSDecimalEx: 15.00 → (15%)Tag presente somente na mensagem CoverageDocument (PercentageReductionBasisICMS)
ipi-aliqAlíquota de IPIDecimalEx: 15.00 → (15%)Tag: IPITaxRate
icms-aliqAlíquota de ICMSDecimalEx: 12.00 → (12%)Tag: ICMSTaxRate
ge-codigoGrupo de estoque do itemInteiroEx: 21Rotina CD0204, campo item.ge-codigo
fm-codigoFamília de material do itemCaractereEx: WAFERSRotina CD0204, campo item.fm-codigo
cod-gr-fornGrupo de fornecedorInteiroEx: 12Rotina CD0401, campo emitente.cod-gr-forn
uf-emitUF do emitenteCaractereEx: SPRotina CD0401, campo emitente.estado
uf-estabUF do estabelecimentoCaractereEx: SCRotina CD0403, campo estabelec.estado
cidade-emiteCidade do emitenteCaractereEx: JOINVILLERotina CD0401, campo emitente.cidade
cod-deposCódigo do depósitoCaractereEx: ALMTag: WarehouseId
cod-depositanteCódigo do depositanteInteiroEx: 4698
uf-depositanteUF do depositanteCaractereEx: RJRotina CD0401, campo emitente.estado
tipo-operTipo de operaçãoInteiroEx: 14

Opções:

0 - Não definido

1 - Compra

2 - Devolução

3 - Transferência

4 - Entrada beneficiamento

5 - Retorno beneficiamento

6 - Entrada consignação

7 - Fatura consignação

8 - Devolução consignação

9 - Devolução consignação simbólica

10 - Nota de rateio

11 - Material agregado

12 - Reajuste preço consignação

13 - Provisória armazenagem

14 - Definitiva armazenagem

15 - Regularização armazenagem


O cadastro de naturezas de operação é realizado pela  rotina CD0606.

Conta de Aplicação / Centro de Custo de Aplicação / Conta Transitória

A conta de aplicação e o centro de custo de aplicação são informações obrigatórias quando o item é de controle Físico ou Débito Direto, se o documento em questão não baixar estoque (que é o caso das notas fiscais provisórias).

Contudo, essas são informações que o WMS não possui para enviar para o Datasul, portanto, existem duas opções:

  1. Alterar o item no programa CD0138 informando a conta e centro de custo padrões do item
  2. Criar Engine de Regras para o tipo de operação re-conta-apl-eai, com a finalidade de sugerir essas informações:
    • Os retornos da regra de conta aplicação podem ser a conta e o centro de custo;
    • Retorno da conta: re-conta-apl-eai;
    • Retorno do centro de custo: re-ccusto-apl-eai;
    • Se a conta não utiliza centro de custo não precisa do retorno do centro de custo.

Para configuração do Engine de Regras podem ser utilizadas as mesmas variáveis indicadas para a sugestão da natureza de operação.

Para a conta transitória não é obrigatório o cadastramento do Engine de Regras. Se o mesmo não estiver cadastrado, o sistema buscará essa informação no cadastro do Estabelecimento Estoque (CD0611).

Para informações detalhadas acesse: Configurador de Regras para sugestão de Conta Transitória no Recebimento Fiscal.

Programas base para configuração e utilização do Engine de Regras:

  • CD0025 - Cadastro de tipo de operação (Ex: re-conta-apl-eai)
  • CD0024 - Cadastro do tipo de operação por estabelecimento, Regras, Condições e Retorno das regras.
  • CD0034 - Se marcado no CD0025 que gera Log de execução para a operação, neste programa pode ser gerado relatório da execução do engine.

Relacionamento De/Para de Empresa/Filial no Logix

Para que uma mensagem de integração possa ser recebida é necessário informar o código da empresa e/ou filial do sistema de origem.

Quando uma mensagem é recebida pelo Logix, a partir da Empresa Externa e Filial Externa existentes na TOTVSMessage, o sistema identificará qual é a Empresa Logix para atualização dos dados.

Estas informações são registradas no EAI10000 (Controle de Mensagens EAI), no cadastro de Aplicativos Externos, na opção De/Para Empresas.

Relacionamento De / Para de Empresa/Estabelecimento no Datasul

Acesse o TOTVS Monitor > Folder EAI-2 > Folder Aplicação Externa;

Selecione Aplicativo Externo > Botão De para;

Em Estrutura, selecione o De-para e faça a inclusão ou alteração conforme a necessidade.

Empresa: CompanyInternalId - fnd_empres

Estabelecimento: BranchInternalId - estabelec
Exemplo:

EmpresaLogix = 31

EstabelecimentoDatasul = 101

Importante!

O Logix não tem a entidade estabelecimento. Para diferenciar os estabelecimentos deverá ser relacionado o código do estabelecimento Datasul x Empresa Logix.

Relacionamento De / Para de Local / Prédio no Logix

É necessário configurar no Logix um De/Para referente ao código do local/prédio, que corresponde no ERP Datasul ao código do depósito.

Para isso, cadastre o relacionamento no VDP10141 para a tabela "LOCAL" e sistema de integração "EAI".

Configuração das Naturezas de Operação - Recebimento / Regularização Fiscal

O Datasul deve possuir no mínimo três naturezas de operação de entrada cadastradas para utilização nas mensagens InputDocument (Documento de Entrada)  e CoverageDocument (Regularização Fiscal).

Cada Natureza deve ter seus campos corretamente preenchidos, conforme orientação e necessidade do usuário.

É imprescindível que a Natureza de operação e a Engine de Regras da natureza de operação estejam configuradas corretamente para que o processo funcione adequadamente.

1. A primeira Natureza de operação será utilizada para receber as NOTAS FISCAIS PROVISÓRIAS do WMS Logix. Os demais campos devem ser cadastrados conforme necessidade do usuário, porém, os campos abaixo devem ser da seguinte forma:

Programa

Nome Campo

Conteúdo

CD0606

Terceiros

Desmarcado=Não Controla

CD0606Tipo CompraNormal


2. A segunda Natureza de operação será utilizada para receber as NOTAS FISCAIS DEFINITIVAS do WMS Logix. Os demais campos devem ser cadastrados conforme necessidade do usuário, porém, os campos abaixo devem ser da seguinte forma:

Programa

Nome Campo

Conteúdo

CD0606

Terceiros

Marcado=Controla

CD0606Tipo OperaçãoRemessa Beneficiamento
CD0606Tipo CompraNormal


3. A terceira Natureza de Operação será utilizada para receber as NOTAS FISCAIS DEFINITIVAS do WMS Logix, resultantes do processo de Regularização Fiscal (cobertura). Os demais campos devem ser cadastrados conforme necessidade do usuário, porém, os campos abaixo devem ser da seguinte forma:

Programa

Nome Campo

Conteúdo

CD0606

Terceiros

Marcado=Controla

CD0606Tipo OperaçãoRemessa Beneficiamento
CD0606Tipo CompraNormal

Configuração das Naturezas de Operação - Faturamento

O WMS envia na tag TypeOperation (existente na mensagem SalesOrder) o código da natureza de operação parametrizada para cada processo, conforme indicado no LOG00087 em LOGIX WMS → OPERADOR LOGÍSTICO → EXPEDIÇÃO.

A partir do conteúdo desta tag o ERP Datasul definirá a natureza de operação a ser utilizada na nota fiscal a ser emitida, utilizando a funcionalidade de Sugestão da Natureza de Operação, conforme detalhado neste link: DPED0082 - Sugestão Automática da Natureza de Operação.


Controle de Versão

O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução dos layouts 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.


Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim, as equipes de suporte dos produtos WMS Operador Logístico e ERP Datasul estarão aptas a efetuar a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.


Transações / Entidades / Mensagens Únicas

Para esta integração estão previstas as mensagens abaixo:

WMS Operador Logístico

Datasul

TOTVSMessage

Registro NF Entrada WMS

Recebimento

InputDocument

Regularização Fiscal

Recebimento

CoverageDocument

Expedição

Faturamento NF Retorno

SalesOrder(*)

Expedição

Faturamento NF Conta e Ordem

SalesOrder(*)

Expedição

Faturamento NF Serviço

SalesOrder(*)

Recebimento com Falta

Faturamento NF Retorno

SalesOrder(*)

Falta de Inventário

Faturamento NF Retorno

SalesOrder(*)

Montagem/Desmontagem de Kits

Faturamento NF Retorno

SalesOrder(*)

Nota!

(*) A mensagem SalesOrder é única para todos os tipos de nota fiscal que necessitam ser gerados.


Para que cada processo indicado acima possa ocorrer é necessário que os principais cadastros também sejam integrados previamente.

São eles:

Cadastro

Onde é utilizado

TOTVSMessage

Fornecedor

Registro NF Entrada WMS (InputDocument)

Regularização Fiscal (CoverageDocument)

CustomerVendor(*)

Cliente

Expedição (SalesOrder)

Regularização Fiscal (CoverageDocument)

CustomerVendor(*)

Transportador

Expedição (SalesOrder)

Carrier

Reserva de CódigoCadastro de Clientes, Fornecedores e Transportadoras (CustomerVendor e Carrier)CustomerVendorReserveId
Locais de EntregaCadastro de Clientes (CustomerVendor)CustomerShippingAddress

Item (Produto)

Registro NF Entrada WMS (InputDocument)

Regularização Fiscal (CoverageDocument)

Expedição (SalesOrder)

Item

Nota!

(*) A mensagem CustomerVendor é única para fornecedores e clientes, o que diferenciará um cadastro de outro será a tag _Type, que poderá ter os valores “Customer” (Cliente), “Vendor” (Fornecedor) ou “Both” (Ambos).


Fluxo das Informações

As mensagens de integração existentes entre o WMS Operador Logístico e o ERP Datasul são:


Cadastros

1.1 Cadastro de Fornecedor / Cadastro de Cliente – CustomerVendor

Nesta mensagem serão integradas as informações principais dos cadastros de fornecedores e de clientes, que dentro do EAI é identificada pelo nome CustomerVendor.

O envio desta mensagem no Logix ocorre a partir destes programas, quando uma manutenção é realizada:

  • VDP0815 - Cadastro Cliente/Fornecedor (versão 10.2/11.0)
  • VDP10000 - Cadastro Cliente/Fornecedor (versão 12)

1.2 Cadastro de Transportador – Carrier

Nesta mensagem serão integradas as informações principais do cadastro de transportadoras, que dentro do EAI é identificada pelo nome Carrier.

O envio desta mensagem no Logix ocorre a partir destes programas, quando uma manutenção é realizada:

  • VDP0815 - Cadastro de Cliente/Fornecedor (versão 10.2/11.0)
  • VDP10000 - Cadastro de Cliente/Fornecedor (versão 12)

1.3 Cadastro de Locais de Entrega – CustomerShippingAddress

Nesta mensagem serão integradas as informações dos locais de entrega do cliente, que dentro do EAI é identificada pelo nome CustomerShippingAddress.

O envio desta mensagem no Logix ocorre a partir destes programas, quando uma manutenção é realizada:

  • VDP0815 - Cadastro de Cliente/Fornecedor (versão 10.2/11.0)
  • VDP10000 - Cadastro de Cliente/Fornecedor (versão 12)

1.4 Cadastro de Item – Item

Nesta mensagem serão integradas as informações principais do cadastro de item, que dentro do EAI é identificada pelo nome Item.

O envio desta mensagem no Logix ocorre a partir destes programas, quando uma manutenção é realizada:

  • MAN9922 - Cadastro de Item (versão 10.2/11.0)
  • MAN10021 - Cadastro de Item (versão 12)

Para os itens a serem utilizados no processo de faturamento de serviço é necessário informar o campo Serviço prestado na opção Comercial do MAN10021 (Cadastro de Itens).

Esta informação é obrigatória para emissão da NFS-e (Nota Fiscal de Serviço Eletrônica) e corresponde ao código do SPED Fiscal, que pode ser consultado neste link: http://sped.rfb.gov.br/pagina/show/1601

No Datasul podem ser cadastrados os seguintes De-para de códigos entre o Logix→Datasul:

TransaçãoDe-para (Estrutura)CampoTAG XML Valor ExternoObservação
ItemItemInternalId - itemCódigo do ItemInternalId
ItemBranchInternalId - estabelecCódigo do EstabelecimentoBranchInternalId*Obrigatório
ItemFamilyInternalId - familiaCódigo da Família MateriaisFamilyInternalId

*Obrigatório

Nota!

É a partir do código da família material que são sugeridos diversos defaults do Item no ERP Datasul!
ItemStockGroupInternalId - grup-estoqueCódigo do Grupo EstoqueStockGroupInternalIdNo Datasul são permitidos apenas 2 dígitos no formato inteiro.
ItemUnitOfMeasureInternalId -tab-unidadeCódigo da Unidade MedidaUnitOfMeasureInternalId
ItemComercialFamilyInternalId - fam-comercCódigo da Familia ComercialComercialFamilyInternalId
ItemWarehouseInternalId - depositoCódigo do DepósitoWarehouseInternalIdNo Datasul são permitidos apenas 3 dígitos no formato alfanumérico.
ItemCostCenterInternalId - ccustoCentro de CustoCostCenterInternalId
ItemFiscalClassificationInternalId - classif-fiscClassificação FiscalFiscalClassificationInternalId
ItemCustomerVendorInternalId - emitenteCódigo do EmitenteCustomerInternalIdUtilizado apenas quando é cadastrado o Item Cliente no Datasul, o cadastro do Item do Depositante permanecerá nesse cadastro.

Importante!

  • Quando o item for cadastrado como Controla Estoque no Logix, no Datasul se o Estabelecimento for Operador Logístico (cd00596), o item será cadastrado com o tipo de Controle Consignado.
  • Essa informação pode ser consultada no programa CD0138.

Item Cliente (Item Depositante no Logix)

Ao receber a mensagem de item o Datasul processa a lista de itens cliente que vem na mensagem, TAG ListOfCustomerItemInformation:

Programa: CD0504 - Atualização Itens Cliente

Campo no qual fica gravado o código do Depositante: Item Cliente.


Processos

1.1 Nota Fiscal Recebimento WMS – InputDocument

Nesta mensagem serão integradas as informações das notas fiscais de recebimento, que dentro do EAI é identificada pelo nome InputDocument.

O envio desta mensagem no Logix ocorre a partir destes programas:

  • WMS6628 – Integração Nota Fiscal Recebimento – Inclusão
    • A mensagem é enviada com o tipo de operação “upsert” (inclusão/modificação);
    •  Notas fiscais consideradas:
      • Notas fiscais Provisórias (tipo “A”).
      • Notas fiscais Definitivas (tipo “B”) marcadas para recebimento de produtos (que não são apenas para regularização fiscal).
    • Para os depositantes com contrato no regime de “Filial” não são processadas as notas fiscais.
    • Os demais tipos de notas fiscais não são tratados nesta integração.
  • WMS6629 - Integração Nota Fiscal Recebimento – Exclusão
    • A mensagem é enviada com o tipo de operação “delete” (exclusão);
    •  Notas fiscais consideradas:
      • Notas fiscais Provisórias (tipo “A”).
      • Notas fiscais Definitivas (tipo “B”) marcadas para recebimento de produtos (que não são apenas para regularização fiscal).
    • Para os depositantes com contrato no regime de “Filial” não são processadas as notas fiscais.
    • Os demais tipos de notas fiscais não são tratados nesta integração.
  • WMS6156 – Regularização Fiscal
    • A mensagem é enviada com o tipo de operação “upsert” (inclusão/modificação), quando a regularização fiscal é processada e como “delete” (exclusão), quando é cancelada.
    • Somente envia a mensagem para nota fiscal Definitiva – tipo “B” – que esteja regularizando outra nota fiscal Definitiva.
    • Nesta situação, a mensagem CoverageDocument (Regularização Fiscal) não é enviada.


Importante!

  • Após a nota fiscal ter sido integrada ao Datasul não será mais possível a sua manutenção ou exclusão no Logix.
  • Para que isso ocorra será necessário executar a exclusão da integração da nota fiscal (WMS6629).


Datasul:

Podem ser cadastrados os seguintes De-para no EAI-2 e que são considerados na transação InputDocument:

TransaçãoDe-para (Estrutura)CampoTAG XML Valor ExternoObservação
InputDocumentItemInternalId - itemCódigo do ItemItemCodeInternalId
InputDocument
BranchInternalId - estabelecCódigo do EstabelecimentoBranchInternalId*Obrigatório
InputDocument
UserId - docum-estUsuário de MateriaisUserId

*Obrigatório se os códigos de usuário forem diferentes.

Nota!

Criando o De-para com * (asterisco) no Lado Logix (Valor Externo) o sistema entende que qualquer usuário do Logix será traduzido para aquele usuário Datasul informado.

Se não estiver cadastrado o usuário no Datasul e não tiver o De-para ocorre o erro: 6203

InputDocument
InputDocumentInternalId - docum-estChave do documento de entradaInternalIdGravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação
InputDocument
InputDocumentItemInternalId - item-doc-estChave da sequência de item do documento de entradaInternalId + sequênciaGravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação + "|" + Sequência

Importante!

  • A conta contábil transitória de fornecedores da Nota fiscal provisória (tipo “A” no Logix e tipo 13 no Datasul) não pode ficar com débito no Datasul!
  • Isso é resolvido criando uma regra no engine de conta transitória do documento para sugerir a mesma conta de aplicação do item na conta transitória do documento, fazendo com que os lançamentos contábeis se anulem.
  • Engine de conta aplicação do item: re-conta-apl-eai
  • Engine de conta transitória do documento: re-conta-transit
  • A nota fiscal provisória não alimenta estoque e nem saldo em poder de terceiros! A nota fiscal que irá gerar o estoque e terceiros é a nota fiscal de regularização fiscal (CoverageDocument)!
  • A nota fiscal definitiva sim alimenta estoque e saldo em poder de terceiros!


1.2 Regularização Fiscal – CoverageDocument

Nesta mensagem serão integradas as informações da regularização fiscal, que dentro do EAI é identificada pelo nome CoverageDocument.

O envio desta mensagem no Logix ocorre a partir do programa WMS6156 (Regularização Fiscal):

  • A mensagem é enviada com o tipo de operação “upsert” (inclusão/modificação) quando a regularização fiscal é processada e como “delete” (exclusão) quando é cancelada.
  • Somente envia a mensagem para nota fiscal Definitiva – tipo “B” – que esteja regularizando apenas notas fiscais Provisórias.
  • Se a nota fiscal for Definitiva e estiver regularizando outra nota fiscal Definitiva será enviada apenas a mensagem InputDocument.

Podem ser cadastrados os seguintes De-para no EAI-2 e que são considerados na transação CoverageDocument:

TransaçãoDe-para (Estrutura)CampoTAG XML Valor ExternoObservação
CoverageDocumentItemInternalId - itemCódigo do ItemItemInternalId
CoverageDocumentBranchInternalId - estabelecCódigo do EstabelecimentoBranchInternalId*Obrigatório
CoverageDocumentUserId - docum-estUsuário de MateriaisUserId

*Obrigatório se os códigos de usuário forem diferentes.

Nota!

Criando o De-para com * (asterisco) no Lado Logix (Valor Externo) o sistema entende que qualquer usuário do Logix será traduzido para aquele usuário Datasul informado.

Se não estiver cadastrado o usuário no Datasul e não tiver o De-para ocorre o erro: 6203

CoverageDocumentInputDocumentInternalId - docum-estChave do documento de entradaInternalIdGravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação
CoverageDocumentInputDocumentItemInternalId - item-doc-estChave da sequência de item do documento de entradaInternalId + sequênciaGravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação + "|" + Sequência


1.3 NF Retorno Simbólico – SalesOrder

Nesta mensagem serão integradas as informações para que o ERP Datasul emita a nota fiscal de retorno simbólico para o depositante.

No EAI esta mensagem é identificada pelo nome SalesOrder.

O envio desta mensagem no Logix ocorre a partir destes programas:

  • WMS9745 – Emissão de Documentos;
  • WMS6496 – Liberação Veículo para Portaria (quando está parametrizado para gerar NF de retorno simbólico automático em caso de falta);
  • SUP50001 – Conta-corrente Inventário;
  • WMS7013 – Montagem / Desmontagem de Kit;
  • WMS6429 – Integração de Pedidos de Venda – Exclusão.

1.4 NF Conta e Ordem – SalesOrder

Nesta mensagem serão integradas as informações para que o ERP Datasul emita a nota fiscal por conta e ordem.

A nota fiscal por conta e ordem somente deve ser gerada nos casos em que a unidade de federação do depositante for diferente da unidade de federação da empresa (operador logístico).

No EAI esta mensagem é identificada pelo nome SalesOrder.

O envio desta mensagem no Logix ocorre a partir destes programas:

  • WMS9745 – Emissão de Documentos;
  • WMS6429 – Integração de Pedidos de Venda – Exclusão.

1.5 NF Faturamento Serviço – SalesOrder

Nesta mensagem serão integradas as informações para que o ERP Datasul emita a nota fiscal de faturamento de serviço.

No EAI esta mensagem é identificada pelo nome SalesOrder.

O envio desta mensagem no Logix ocorre a partir destes programas:

  • WMS6412 – Preparação e Geração Faturamento Serviço;
  • WMS6429 – Integração de Pedidos de Venda – Exclusão.


Limitações / Restrições Gerais

No cadastro de Cidades (VDP3080) é obrigatório o preenchimento do campo Munícipio IBGE, pois esta informação será a chave de comunicação para identificação dos municípios entre os dois sistemas.

No cadastro de Países do Logix (VDP3180) é obrigatório o preenchimento do campo Siscomex ou País BACEN, pois estas informações serão utilizadas para identificação do país entre os dois sistemas. No Datasul é necessário informar o código Siscomex no cadastro CD0181 (EMS2) e também o código país DIRF no cadastro bas_pais (EMS5). O código Siscomex informado no Logix deve ser o mesmo informado no código DIRF informado no Datasul. Por exemplo, para o Brasil deve ser informado o código "105".

As unidades de medida e condições de pagamento deverão estar cadastradas nos dois sistemas com os mesmos códigos, pois não há de/para para estas informações.

Para os depositantes identificados sob o regime de Filial não serão integradas as informações dos documentos (nota fiscal recebimento, regularização fiscal, NF de retorno simbólico, NF de conta/ordem).

Quando o depositante não for emitente de nota fiscal (parâmetro “É emitente de NF rem.armazenagem (integração)?” na rotina WMS60013 (Contrato), opção Expedição-Embarque/Fiscal, não será permitido realizar a regularização fiscal (WMS6156) utilizando uma NF/Sequência definitiva para duas ou mais NF/Sequência provisórias. Nesta situação, a nota fiscal de entrada a ser emitida no ERP Datasul já deverá ter sido gerada com várias sequências de maneira que seja possível efetuar o relacionamento 1 para 1.


Como Fazer

Os passos para viabilizar a integração são:

  • No Logix ou no ERP Datasul, efetue o cadastro das seguintes informações: Clientes, Fornecedores e Transportadoras.
  • No Logix, cadastre um novo depositante e efetue toda a parametrização necessária para a operação de WMS.
  • No Logix, cadastre um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
  • No Logix, efetue um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
  • No Datasul, consulte a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
  • No Logix, efetue um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
  • No Datasul, verifique se foi efetuado corretamente o relacionamento entre os dois documentos. Acesse o documento fiscal referenciado no RE1001:



  • No Logix, efetue um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de nota fiscal.
  • No Logix é possível consultar o número e série da nota fiscal gerada para os retornos simbólicos e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço, o número da nota fiscal está disponível no programa WMS6411 (Movimentos a Faturar).
  • As informações das integrações de Documentos de Entrada (WMS6628 e WMS6629), Regularização Fiscal (WMS6156) e Documentos de Saída (WMS9745 e WMS6429) poderão ser consultadas pelo Monitor de Integração, rotina WMS80000. Nesta rotina também é possível reprocessar documentos que permaneceram pendentes.
  • Para realizar o monitoramento das transações no Datasul acesse o TOTVS Monitor:
    1. Acesse o Monitor do EAI-2 no Datasul:
      Exemplo: Se a URL do Datasul é http://cordas:8480/menu-html/ para acessar o monitor basta substituir o contexto “menu-html” por “totvs-monitor”.
    2. Acesse a aba/pasta EAI-2 e, em seguida, clique na aba/pasta Monitor.
    3. Mensagens com Situação: DELIVERED foram integradas com sucesso.
    4. Mensagens com Situação: BUSINESSERROR não foram integradas pois ocorreu erro de negócio.
    5. Para que sejam listadas as situações BUSINESSERROR, clique em Filtro e assinale Considerar mensagens arquivadas?.
    6. Para consultar a inconsistência, clique na mensagem e, no subnível, haverá o conteúdo de retorno para o aplicativo externo.





Situações Comuns (Opcional)

Quando uma mensagem é enviada do Logix para o Datasul podem ocorrer situações em que o WebService não estará totalmente funcional.

Nestes casos uma mensagem de erro genérica será apresentada na tela.

Exemplo:

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

Para resolver este problema verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService.

Abaixo seguem algumas consistências e mensagens que podem ocorrer durante os processos, indicando a possível solução para o problema:

Rotina

Problema / Mensagem

Solução

WMS9745

WMS6496

Mensagem: “A nota fiscal xxxxxx ainda não está integrada.”

Falta realizar a integração da nota fiscal de recebimento relacionada aos produtos que estão sendo expedidos ou retornados fiscalmente.

Para efetuar a integração deve-se executar a rotina WMS6628 (Integração Nota Fiscal Recebimento – Inclusão).

WMS9745


Os textos obrigatórios para as notas fiscais não estão sendo gerados na DANFE.

Falta cadastrar os textos necessários no programa WMS0748 (Textos para Notas Fiscais WMS).

Considerar os textos para cada tipo de nota fiscal a ser emitida.


Checklist de Suporte da Aplicação

Verifique se os WebServices criados estão devidamente configurados. Para isso, tente abrir no seu navegador internet o endereço dos WebServices. No WebService do Datasul e do Logix você deve conseguir visualizar na lista de serviços o “EAISERVICE”. 

Efetue o teste de comunicação entre os sistemas utilizando uma mensagem simples de cadastro (sugestão: Fornecedor). Envie um cadastro do Logix para o Datasul e do Datasul para o Logix.