Muitas empresas que atuam no ramo de transportes têm se tornado 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 as 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) 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.
No WMS, os seguintes pré-requisitos devem ser verificados:
No Datasul o relacionamento De / Para de códigos é visualizado pela opção disponível no TOTVS Monitor:
Acesse o TOTVS Monitor.
Clique na aba EAI 2.
Clique na aba Aplicação Externa.
Selecione o Aplicativo Externo.
Clique no botão De-para.
Em Estrutura, selecione o De-para e efetue a inclusão ou a 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 e no Logix o documento (nota fiscal) é do tipo numérico. |
Para configurar o EAI Logix devem ser executados os seguintes procedimentos:
[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
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>
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.
Para configurar o EAI-2 Datasul consulte a documentação em EAI 2.
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 |
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.
| 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.
| 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.
| 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
| 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:
| 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:
| 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.
| 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.
| util_auto_item_multi_empresa |
É 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
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.
O cadastro das regras deve ser realizado pela rotina CD0024.
Veja como utilizar o Engine de Regras:
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ável | Descrição | Tipo | Conteúdo | Observação |
---|---|---|---|---|
cod-emitente | Fornecedor | Inteiro | Ex: 4578 | |
it-codigo | Item | Caractere | Ex: 72585424 | |
cod-ncm | NCM do item (Classificação Fiscal) | Caractere | Ex: 19052010 | Programa de cadastro: CD0603 Relacionamento com o Item: RE0106 |
cfop-saida | CFOP saída sequência item NF | Caractere | Ex: 5105 | TAG: OutputOperationFiscalCode |
cfop-saida-nf-relac | CFOP saída NF relacionada | Caractere | Ex: 5105 | Na NF de cobertura há a NF relacionada (provisória). Este é o CFOP de saída da NF relacionada |
cfop-entrada | CFOP entrada | Caractere | Ex: 1905 | Tag: OperationFiscalCode |
perc-red-bc-icms | % de redução da base de cálculo do ICMS | Decimal | Ex: 15.00 → (15%) | Tag presente somente na mensagem CoverageDocument (PercentageReductionBasisICMS) |
ipi-aliq | Alíquota de IPI | Decimal | Ex: 15.00 → (15%) | Tag: IPITaxRate |
icms-aliq | Alíquota de ICMS | Decimal | Ex: 12.00 → (12%) | Tag: ICMSTaxRate |
ge-codigo | Grupo de estoque do item | Inteiro | Ex: 21 | Rotina CD0204, campo item.ge-codigo |
fm-codigo | Família de material do item | Caractere | Ex: WAFERS | Rotina CD0204, campo item.fm-codigo |
cod-gr-forn | Grupo de fornecedor | Inteiro | Ex: 12 | Rotina CD0401, campo emitente.cod-gr-forn |
uf-emit | UF do emitente | Caractere | Ex: SP | Rotina CD0401, campo emitente.estado |
uf-estab | UF do estabelecimento | Caractere | Ex: SC | Rotina CD0403, campo estabelec.estado |
cidade-emite | Cidade do emitente | Caractere | Ex: JOINVILLE | Rotina CD0401, campo emitente.cidade |
cod-depos | Código do depósito | Caractere | Ex: ALM | Tag: WarehouseId |
cod-depositante | Código do depositante | Inteiro | Ex: 4698 | |
uf-depositante | UF do depositante | Caractere | Ex: RJ | Rotina CD0401, campo emitente.estado |
tipo-oper | Tipo de operação | Inteiro | Ex: 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.
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, definitivas e de regularização fiscal).
Contudo, essas são informações que o WMS não possui para enviar para o Datasul, portanto, existem duas opções:
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:
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.
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
O Logix não tem a entidade estabelecimento. Para diferenciar os estabelecimentos deverá ser relacionado o código do estabelecimento Datasul x Empresa 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".
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 |
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 forma:
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 forma:
Programa | Nome Campo | Conteúdo |
CD0606 | Terceiros | Marcado=Controla |
CD0606 | Tipo Operação | Remessa Beneficiamento |
CD0606 | Tipo Compra | Normal |
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.
RE1001 - Manutenção de documentos - DATASUL
Foi disponibilizada a função "Bloq-RE1001-POL" que pode ser ativada por meio do programa de ativação de funções (CD7070), essa função tem o objetivo de bloquear a alteração e eliminação de informações dos documentos integrados via Plataforma do Operador Logístico, quando ativada o documento que estará disponível no RE1001 não poderá ser eliminado ou alterado. Recomendamos ativar essa função para evitar possíveis divergências de informações entre os sistemas Datasul e Logix.
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.
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.
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(*) |
(*) 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ódigo | Cadastro de Clientes, Fornecedores e Transportadoras (CustomerVendor e Carrier) | CustomerVendorReserveId |
Locais de Entrega | Cadastro de Clientes (CustomerVendor) | CustomerShippingAddress |
Item (Produto) | Registro NF Entrada WMS (InputDocument) Regularização Fiscal (CoverageDocument) Expedição (SalesOrder) | Item |
(*) 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.
O envio desta mensagem no Logix 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.
O envio desta mensagem no Logix ocorre a partir destes programas, quando uma manutenção é realizada:
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:
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:
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ção | De-para (Estrutura) | Campo | TAG XML Valor Externo | Observação | |
Item | ItemInternalId - item | Código do Item | InternalId | ||
Item | BranchInternalId - estabelec | Código do Estabelecimento | BranchInternalId | *Obrigatório | |
Item | FamilyInternalId - familia | Código da Família Materiais | FamilyInternalId | *Obrigatório
| |
Item | StockGroupInternalId - grup-estoque | Código do Grupo Estoque | StockGroupInternalId | No Datasul são permitidos apenas 2 dígitos no formato inteiro. | |
Item | UnitOfMeasureInternalId -tab-unidade | Código da Unidade Medida | UnitOfMeasureInternalId | ||
Item | ComercialFamilyInternalId - fam-comerc | Código da Familia Comercial | ComercialFamilyInternalId | ||
Item | WarehouseInternalId - deposito | Código do Depósito | WarehouseInternalId | No Datasul são permitidos apenas 3 dígitos no formato alfanumérico. | |
Item | CostCenterInternalId - ccusto | Centro de Custo | CostCenterInternalId | ||
Item | FiscalClassificationInternalId - classif-fisc | Classificação Fiscal | FiscalClassificationInternalId | ||
Item | CustomerVendorInternalId - emitente | Código do Emitente | CustomerInternalId | Utilizado apenas quando é cadastrado o Item Cliente no Datasul, o cadastro do Item do Depositante permanecerá nesse cadastro. |
|
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.
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:
|
Datasul:
Podem ser cadastrados os seguintes De-para no EAI-2 e que são considerados na transação InputDocument:
Transação | De-para (Estrutura) | Campo | TAG XML Valor Externo | Observação | |
InputDocument | ItemInternalId - item | Código do Item | ItemCodeInternalId | ||
InputDocument | BranchInternalId - estabelec | Código do Estabelecimento | BranchInternalId | *Obrigatório | |
InputDocument | UserId - docum-est | Usuário de Materiais | UserId | *Obrigatório se os códigos de usuário forem diferentes.
Se não estiver cadastrado o usuário no Datasul e não tiver o De-para ocorre o erro: 6203 | |
InputDocument | InputDocumentInternalId - docum-est | Chave do documento de entrada | InternalId | Gravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação | |
InputDocument | InputDocumentItemInternalId - item-doc-est | Chave da sequência de item do documento de entrada | InternalId + sequência | Gravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação + "|" + Sequência |
|
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):
Podem ser cadastrados os seguintes De-para no EAI-2 e que são considerados na transação CoverageDocument:
Transação | De-para (Estrutura) | Campo | TAG XML Valor Externo | Observação | |
CoverageDocument | ItemInternalId - item | Código do Item | ItemInternalId | ||
CoverageDocument | BranchInternalId - estabelec | Código do Estabelecimento | BranchInternalId | *Obrigatório | |
CoverageDocument | UserId - docum-est | Usuário de Materiais | UserId | *Obrigatório se os códigos de usuário forem diferentes.
Se não estiver cadastrado o usuário no Datasul e não tiver o De-para ocorre o erro: 6203 | |
CoverageDocument | InputDocumentInternalId - docum-est | Chave do documento de entrada | InternalId | Gravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação | |
CoverageDocument | InputDocumentItemInternalId - item-doc-est | Chave da sequência de item do documento de entrada | InternalId + sequência | Gravado da seguinte forma: Série Docto + "|" + Número Docto + "|" + Emitente + "|" + Natureza Operação + "|" + Sequência |
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:
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:
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:
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.
Os passos para viabilizar a integração são:
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. |
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.