Integração WMS Operador Logístico X ERP Datasul
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.
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) serão utilizadas e registradas apenas 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.
No WMS, os seguintes pré-requisitos devem ser verificados:
No Datasul relacionamento De/Para de códigos é visualizado através da opção disponível no TOTVS Monitor:
Acessar o TOTVS Monitor;
Clicar no Folder "EAI 2“;
Clicar no Folder "Aplicação Externa“;
Selecionar o Aplicativo Externo;
Clicar no botão "De-para“;
No combo-box "Estrutura“, selecione o De-para e faça a inclusão ou alteração conforme a necessidade.
É 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.
Configuração do EAI Logix
Para configurar o EAI Logix devem ser executados os seguintes procedimentos:
Ao executar os procedimentos acima o EAI Logix está configurado para receber e enviar mensagens.
Configuração do EAI-2 Datasul
?
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
Executar o programa LOG00087 (Manutenção de Parâmetros) e acessar 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 |
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. |
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 |
Código Único
O que é Código Único ?É 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 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. |
Em:
LOGIX WMS → LOGIX WMS → INTEGRAÇÃO COM OUTROS SISTEMAS
Entre os parâmetros apresentados, verificar e atualizar o que segue abaixo:
Parâmetro | Objetivo |
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). |
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). |
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. OBS: Para processamentos manuais não há limite de tentativas. |
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 OBS: 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. |
Em:
LOGIX WMS → OPERADOR LOGÍSTICO → EXPEDIÇÃO
Entre os parâmetros apresentados, verificar e atualizar o que segue abaixo:
Parâmetro | Objetivo |
Integrar novo destinatário com ERP na inclusão da solicitação de 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. |
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. |
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. |
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. |
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. |
Natureza de operação para notas de retorno para faltas recebimento* | Código da natureza de operação utilizada na emissão das notas fiscais de retorno simbólico referente às faltas de produtos no recebimento. |
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. |
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. |
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. |
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). Vale ressaltar que as informações de tributação deste cadastro não serão utilizadas na integração, será utilizada a apenas a verificação da existência do relacionamento. |
(*) Estes parâmetros já existiam antes desta integração.
Engine de regras - Datasul
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), dentro do cadastro de "Aplicativos Externos", na opção "De/Para Empresas".
Relacionamento De/Para de Empresa/Estabelecimento no Datasul:
Acessar o TOTVS Monitor -> Folder EAI-2 -> Folder Aplicação Externa -> Selecionar Aplicativo Externo -> Botão "De para":
No combo-box "Estrutura“, selecione o De-para e faça a inclusão ou alteração conforme a necessidade.
Empresa: CompanyInternalId - fnd_empres
Estabelecimento: BranchInternalId - estabelec
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.
Exemplo:
EmpresaLogix = 31
EstabelecimentoDatasul = 101
Importante!
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 a Natureza de operação e Engine de regras da natureza de operação estarem configurada corretamente para o correto funcionamento do processo.
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 maneira:
Programa | Nome Campo | Conteúdo |
CD0606 | Terceiros | Desmarcado=Não Controla |
CD0606 | Tipo Compra | Normal |
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 maneira:
Programa | Nome Campo | Conteúdo |
CD0606 | Terceiros | Marcado=Controla |
CD0606 | Tipo Operação | Remessa Beneficiamento |
CD0606 | Tipo Compra | Normal |
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 maneira:
Programa | Nome Campo | Conteúdo |
CD0606 | Terceiros | Marcado=Controla |
CD0606 | Tipo Operação | Remessa Beneficiamento |
CD0606 | Tipo Compra | Normal |
É necessário também realizar algumas configurações para Operador Logístico no ERP Datasul, para isso consultar a FAQ: DUFN0025 - Parâmetros Gerais da Integração do Operador Logístico
************ [AQUI] ADICIONAR CONFIGURAÇÕES NATUREZAS PROCESSO DE FATURAMENTO ***************************
O grupo TOTVS, representado por suas marcas, irá 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.
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 fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
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 previamente os principais cadastros também estejam integrados. 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 |
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).
As mensagens de integração existentes entre o WMS Operador Logístico e o ERP Datasul são:
Nesta mensagem serão integradas as informações principais dos cadastros de fornecedores e de clientes, que dentro do EAI é identificada pelo nome CustomerVendor.
No Logix o envio desta mensagem ocorre a partir destes programas, quando uma manutenção é realizada:
Nesta mensagem serão integradas as informações principais do cadastro de transportadoras, que dentro do EAI é identificada pelo nome Carrier.
No Logix o envio desta mensagem ocorre a partir destes programas, quando uma manutenção é realizada:
Nesta mensagem serão integradas as informações principais do cadastro de item, que dentro do EAI é identificada pelo nome Item.
No Logix o envio desta mensagem ocorre a partir destes programas, quando uma manutenção é realizada:
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
Nesta mensagem serão integradas as informações das notas fiscais de recebimento, que dentro do EAI é identificada pelo nome InputDocument.
No Logix o envio desta mensagem ocorre a partir destes programas:
É importante destacar que 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).
Nesta mensagem serão integradas as informações da regularização fiscal, que dentro do EAI é identificada pelo nome CoverageDocument.
No Logix o envio desta mensagem ocorre a partir do programa WMS6156 (Regularização Fiscal):
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.
No Logix o envio desta mensagem ocorre a partir destes programas:
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.
No Logix o envio desta mensagem ocorre a partir destes programas:
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.
As informações tratadas atualmente nesta mensagem são:
No Logix o envio desta mensagem ocorre a partir destes programas:
Os passos para viabilizar a integração são:
Para realizar o monitoramento das transações no Datasul acesse o TOTVS Monitor:
-Acessar 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”.
-Acessar o folder “EAI-2”, depois clicar no folder “Monitor".
-Mensagens com Situação: DELIVERED foram integradas com sucesso;
-Mensagens com Situação: BUSINESSERROR não foram integradas pois ocorreu erro de negócio;
-Para que sejam listadas as situações BUSINESSERROR clicar em Filtro e marcar “Considerar mensagens arquivadas?”;
-Para consultar o erro clicar na mensagem e no subnível haverá o conteúdo de retorno para o aplicativo externo.
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 irá aparecer 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. |