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

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) 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.

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.20.
  • Webservice criado para permitir a comunicação com o ERP Datasul.
  • Instalação do EAI Logix, que deverá 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 irá 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 irá 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 relacionamento De/Para de códigos é visualizado através da opção disponível no TOTVS Monitor:

  1. Acessar o TOTVS Monitor;
  2. Clicar no Folder "EAI 2“;
  3. Clicar no Folder "Aplicação Externa“;
  4. Selecionar o Aplicativo Externo;
  5. Clicar no botão "De-para“;
  6. 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.


Instalação/Configuração

Configuração do EAI Logix

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

  • Informar 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


  • Informar 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>


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

    Executar o programa EAI10000 (Monitor EAI), acesse o menu Configuração > Host Application e conferir 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 irá percorrer o seu RPO para localizar os adapters existentes. Estes adapters representarão as mensagens que o EAI irá trabalhar.

    Ainda no programa EAI10000, acessar 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”. Selecionar a “Classe canal” correspondente ao produto com o qual queira se comunicar. No quadro “Propriedades” preencher as informações solicitadas e clicar em “Confirmar”. Para configuração do webservice do Datasul é necessário informar o usuário e senha.

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

    Depois de terminar a configuração dos aplicativos externos volte para a 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

?


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


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

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 maneira:

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 maneira:

Programa

Nome Campo

Conteúdo

CD0606

Terceiros

Marcado=Controla

CD0606Tipo OperaçãoRemessa Beneficiamento
CD0606Tipo CompraNormal


************ ADICIONAR CONFIGURAÇÕES CADASTROS DE CLIENTES, FORNECEDORES, TRANSPORTADORAS NO DATASUL ***************************


************ ADICIONAR CONFIGURAÇÕES NATUREZAS PROCESSO DE FATURAMENTO ***************************


Controle de Versão

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.

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 fazer 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 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).


Fluxo das Informações

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

************ MENSAGENS *******************

Fluxo de um processo padrão de WMS, desde o recebimento dos produtos até a sua expedição:

************* FLUXO WMS *************

Notas:

  • O fluxo exposto acima representa apenas a utilização do CESV – Controle de Entrada e Saída de Veículos – porém as mesmas integrações se aplicam também quando é utilizado apenas o controle de Documental.
  • A integração da nota fiscal de recebimento foi exemplificada apenas entre os processos Registro da NF Entrada e Planejamento do Recebimento, mas pode ocorrer também entre quaisquer processos após o Registro da NF Entrada e antes da Integração Regularização Fiscal.


Além das integrações indicadas acima, existem as outras integrações de movimentos que não estão ligados ao processo normal do WMS. São eles:

  • NF Faturamento de Serviço: Ocorre quando é realizado o processamento no programa WMS6412 (Geração NF).
  • Recebimento com Falta: Quando o recebimento for realizado através de uma nota fiscal definitiva e ocorrer falta de produtos é necessário devolver simbolicamente esta quantidade faltante para o depositante. Para isso é utilizada a opção “Gerar NF Retorno” na rotina WMS6196/WMS6496 (Liberação de Veículo para Saída).
  • Falta de Inventário: No fechamento do conta corrente do inventário, caso exista uma falta de produto é necessário realizar um retorno simbólico para o depositante.
  • Montagem/Desmontagem de Kits: Quando é realizada uma montagem de kits deve ocorrer o retorno simbólico dos componentes utilizados na montagem, pois os mesmos passarão a ser identificados por um novo produto. O mesmo ocorrerá na desmontagem de um kit, onde o produto do kit é que deverá ser retornado simbolicamente. Estes processamentos são realizados através da rotina WMS7013 (Solicitação de Montagem de Kit).


Cadastros

1.1          Cadastro de Fornecedor – CustomerVendor

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


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

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


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_Code(**)

Código do fornecedor

FORNECEDOR.cod_fornecedor

_ShortName

Nome reduzido do fornecedor

VDP_CLI_FORNEC_CPL.razao_social_reduz (se estiver preenchido) ou então FORNECEDOR.raz_social_reduz

_Name

Nome do fornecedor

VDP_CLI_FORNEC_CPL.razao_social (se estiver preenchido) ou então FORNECEDOR.raz_social

_Type(***)

Tipo de registro (Cliente = “Customer”; Fornecedor = “Vendor”; Ambos = “Both”)

Para esta mensagem será “Vendor”


_EntityType

Tipo de pessoa (Pessoa Física = “Person”; Pessoa Jurídica = “Company”)

Se o fornecedor tiver CPF, será considerado “Person”, caso contrário será “Company”

_RegisterDate

Data de cadastro do fornecedor

FORNECEDOR.dat_cadast

_RegisterSituation

Situação do fornecedor (Ativo = “Active”; Inativo = “Inactive”)

FORNECEDOR.ies_fornec_ativo

_GovernmentalInformation

Esta tag pode conter até 5 (cinco) informações diferentes, que são diferenciadas pelo atributo _Name:

_Name

_Scope

_Id

_ExpiresOn

“CPF”

“Federal”

CPF do fornecedor (quando Pessoa Física)

NULL

“CNPJ”

“Federal”

CNPJ do fornecedor (quando Pessoa Jurídica)

NULL

“Inscricao Estadual”

“State”

Número da Inscrição Estadual do fornecedor

NULL

“Inscricao Municipal”

“Municipal”

Número da Inscrição Municipal do fornecedor

NULL

“Suframa”

“Federal”

NULL

Data de validação do registro no SUFRAMA

CPF → FORNECEDOR.num_cgc_cpf


CNPJ → FORNECEDOR.num_cgc_cpf


Inscrição Estadual → FORNECEDOR.ins_estadual


Inscrição Municipal → FORNEC_COMPL.ins_municipal


Suframa → FORNECEDOR.ies_zona_franca

OBS: Quando a tag estiver preenchida, considera como “S”, caso contrário considera como “N”).

_Address.

_Address

Endereço do fornecedor

VDP_CLI_FORNEC_CPL.logradouro (se estiver preenchido) ou então FORNECEDOR.end_fornec

_Address.

_Number

Número do endereço do fornecedor

VDP_CLI_FORNEC_CPL.num_iden_lograd

_Address.

_Complement

Complemento do endereço do fornecedor

VDP_CLI_FORNEC_CPL.compl_endereco

_Address.

_City.

_Code

Código da cidade do endereço do fornecedor. Será considerado o código IBGE, conforme cadastro nacional.

FORNECEDOR.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_Address.

_City.

_Description

Nome da cidade do fornecedor

CIDADES.den_cidade

_Address.

_District

Bairro do fornecedor

VDP_CLI_FORNEC_CPL.bairro (se estiver preenchido) ou então FORNECEDOR.den_bairro

_Address.

_State.

_Code

Sigla do estado (UF) do fornecedor

FORNECEDOR.cod_uni_feder

OBS: Se a UF do fornecedor não for uma das unidades de federação brasileiras é fixado o valor “EX” (Exterior).

_Address.

_State.

_Description

Nome do estado (UF) do fornecedor

UNI_FEDER.den_uni_feder

_Address.

_Country.

_Code

Código do país do fornecedor

UNI_FEDER.cod_pais

_Address.

_Country.

_Description

Nome do país do fornecedor

PAISES.den_pais

_Address.

_ZIPCode

Código de Endereçamento Postal (CEP) do fornecedor

FORNECEDOR.cod_cep

OBS: São considerados apenas os dígitos.

_ListOfCommunicationInformation.

_PhoneNumber

Número do telefone do fornecedor

VDP_CLI_FORNEC_CPL.telefone_1 (se estiver preenchido) ou então FORNECEDOR.num_telefone

_ListOfCommunicationInformation.

_FaxNumber

Número do fax do fornecedor

FORNECEDOR.num_fax

_ListOfCommunicationInformation.

_HomePage

Home (site) do fornecedor

VDP_CLI_FORNEC_CPL.endereco_web (se estiver preenchido) ou então FORNEC_COMPL.endereco_web

_ListOfCommunicationInformation.

_Email

Email principal do fornecedor

VDP_CLI_FORNEC_CPL.correio_eletronico (se estiver preenchido) ou então FORNEC_COMPL.e_mail

_ListOfContacts.

_Code

Código do contato (número seqüencial)

SUP_CNTT_FORNEC.sequencia_contato

_ListOfContacts.

_Name

Nome do contato do fornecedor

SUP_CNTT_FORNEC.nom_contato

_ListOfContacts.

_CommunicationInformation.

_PhoneNumber

Telefone do contato do fornecedor

SUP_CNTT_FORNEC.telefone

_ListOfContacts.

_CommunicationInformation.

_FaxNumber

Fax do contato do fornecedor

SUP_CNTT_FORNEC.fax

_ListOfBankingInformation.

_BankCode

Código do banco do fornecedor

FORNECEDOR.cod_banco

_ListOfBankingInformation.

_BankName

Nome do banco do fornecedor

BANCOS.nom_banco

_ListOfBankingInformation.

_BranchCode

Número da agência bancária do fornecedor

FORNECEDOR.num_agencia

_ListOfBankingInformation.

_BranchName

Dígito da agência bancária do fornecedor

FORNECEDOR.num_agencia

_ListOfBankingInformation.

_CheckingAccountNumber

Número da conta corrente do fornecedor

FORNECEDOR.num_conta_banco

_ListOfBankingInformation.

_CheckingAccountNumberKey

Dígito da conta corrente do fornecedor

FORNECEDOR.num_conta_banco

_VendorInformation.

_VendorType.

_Code

Tipo de fornecedor (1 = “Fornecedor”; 3 = “Cliente”; 4 = “Fornecedor/Cliente”; 5 = “Fornecedor/Transportador”; 6 = “Produtor Rural”; 7 = “Prestador de Serviço”; 8 = “Munícipio”; 9 = “Cooperado”; I = “Microempreendor Individual”)

FORNECEDOR.ies_tip_fornec

_VendorInformation.

_VendorType.

_Description

Descrição do tipo de fornecedor

Conforme o tipo de fornecedor

_FiscalInformation.

_TaxPayer.

_Attributes.

_TaxName

Tipo de informação de imposto que será tratada

“IPI” (valor fixo)

_FiscalInformation.

_TaxPayer.

_Attributes.

_isPayer

Indica se o fornecedor é ou não contribuinte de IPI

FORNECEDOR.ies_contrib_ipi

OBS: Se for igual a “N”, será considerado valor “false”, caso contrário será considerado valor “true”.

_FiscalInformation.

_TaxPayer.

_Attributes.

_Mode

Possibilita a identificação de fornecedor contribuinte de IPI no modo “simples”.

FORNECEDOR.ies_contrib_ipi

OBS: Se for igual a “E”, será considerado valor “simples”, caso contrário será considerado valor NULL.

Notas:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.

(**) Quando é realizado o envio de mensagem, considera-se o próprio código do Logix. Quando é realizado o recebimento de uma mensagem, o conteúdo desta tag será o código cadastrado no sistema de origem, que no Logix estará cadastrado como “Código Externo” no programa VDP10143 (Consulta Código Externo Cliente/Fornecedor). A partir deste código externo o Logix identificará qual é o seu código, para então proceder as atualizações.

(***) A mensagem CustomerVendor foi criada para atender a integração de clientes e de fornecedores. O que diferenciará um tipo de outro será a tag “Type”, que para fornecedores receberá o valor “Vendor”.

(***) Nos casos de registros do tipo “Ambos” (onde uma empresa é cliente e fornecedor ao mesmo tempo), o Logix enviará duas mensagens para o Protheus, uma com o tipo “Customer” e outra com o tipo “Vendor”. No recebimento da mensagem, porém, está previsto receber o tipo “Both” (Ambos), onde neste caso o Logix realizará a atualização dos dois cadastros.


Somente fornecedores com tipo diferente de “2” (Transportador) é que serão considerados para envio de mensagem.


Como no Protheus o fornecedor é identificado através de um código composto (Código + Loja), não foi possível utilizar o mesmo código nos dois sistemas. Para resolver esta situação foi necessário criar um relacionamento “De/Para” entre os códigos interno e externo, que será alimentado automaticamente no envio e no recebimento da mensagem.


Como funciona – Envio:

  • Quando o Logix enviar uma mensagem de fornecedor, sempre será preenchida a tag _Code com o código do Logix (FORNECEDOR.cod_fornecedor).
  • Quando a atualização das informações do fornecedor for finalizada com sucesso pelo Protheus, ele retornará o seu código gerado para que seja registrada de forma automática o relacionamento entre os códigos no programa VDP10143 (Consulta Código Externo Cliente/Fornecedor).


Como funciona – Recebimento:

  • Quando o Logix receber uma mensagem de fornecedor, será verificado através do conteúdo da  tag _Code se existe o código externo registrado no programa VDP10143 (Consulta Código Externo Cliente/Fornecedor).
  • Se o código externo for encontrado, será considerado o código do fornecedor Logix que está relacionado à este código externo.
  • Se o código externo não for encontrado, o sistema entenderá que se trata de um novo fornecedor, e portanto providenciará o cadastramento do mesmo.
  • Nesta situação, o código do fornecedor no Logix será determinado conforme as regras já existentes, que poderá ser:
  • Automático Sequencial: O código do Logix será determinado através do parâmetro de controle de numeração de fornecedores (LOG00087).
  • Automático CNPJ/CPF: O código do Logix será igual ao CNPJ ou CPF do fornecedor, considerando apenas os dígitos.
  • Manual: Será igual ao código externo enviado na mensagem (tag _Code).
    • Em todas as situações acima sempre será registrado automaticamente o relacionamento De/Para de códigos no programa VDP10143, evitando que o usuário tenha que efetuar o relacionamento manualmente.
    • Após todos os procedimentos e atualizações o Logix retornará uma mensagem de resposta para o Protheus enviando qual foi o seu código gerado, para que o relacionamento automático também possa ser realizado neste sistema.


1.2          Cadastro de Cliente – CustomerVendor


Nesta mensagem serão integradas as informações principais do cadastro 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:

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


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_Code(**)

Código do cliente

CLIENTES.cod_cliente

_ShortName

Nome reduzido do cliente

VDP_CLI_FORNEC_CPL.razao_social_reduz (se estiver preenchido) ou então CLIENTES.nom_reduzido

_Name

Nome do cliente

VDP_CLI_FORNEC_CPL.razao_social (se estiver preenchido) ou então CLIENTES.nom_cliente

_Type(***)

Tipo de registro (Cliente = “Customer”; Fornecedor = “Vendor”; Ambos = “Both”)

Para esta mensagem será “Customer”

_EntityType

Tipo de pessoa (Pessoa Física = “Person”; Pessoa Jurídica = “Company”)

Se o cliente tiver CPF, será considerado “Person”, caso contrário será “Company”

_RegisterDate

Data de cadastro do cliente

CLIENTES.dat_cadastro

_RegisterSituation

Situação do cliente (Ativo = “Active”; Inativo = “Inactive”; Cancelado = “Canceled”; Pendente = “Pending”; Suspenso = “Suspended”)

CLIENTES.ies_situacao

_GovernmentalInformation

Esta tag pode conter até 5 (cinco) informações diferentes, que são diferenciadas pelo atributo _Name:

_Name

_Scope

_Id

_ExpiresOn

“CPF”

“Federal”

CPF do fornecedor (quando Pessoa Física)

NULL

“CNPJ”

“Federal”

CNPJ do fornecedor (quando Pessoa Jurídica)

NULL

“Inscricao Estadual”

“State”

Número da Inscrição Estadual do fornecedor

NULL

“Inscricao Municipal”

“Municipal”

Número da Inscrição Municipal do fornecedor

NULL

“Suframa”

“Federal”

Número do registro no SUFRAMA

Data de validação do registro no SUFRAMA

CPF → CLIENTES.num_cgc_cpf


CNPJ → CLIENTES.num_cgc_cpf


Inscrição Estadual → CLIENTES.ins_estadual


Inscrição Municipal → VDP_CLI_PARAMETRO.texto_parametro (filtrar pelo parâmetro “ins_municipal”)


Suframa → CLIENTES.num_suframa e VDP_CLI_PARAMETRO.dat_parametro (filtrar pelo parâmetro “dat_validade_suframa”)


_Address.

_Address

Endereço do cliente

VDP_CLI_FORNEC_CPL.logradouro (se estiver preenchido) ou então CLIENTES.end_cliente

_Address.

_Number

Número do endereço do cliente

VDP_CLI_FORNEC_CPL.num_iden_lograd

_Address.

_Complement

Complemento do endereço do cliente

VDP_CLI_FORNEC_CPL.compl_endereco

_Address.

_City.

_Code

Código da cidade do endereço do cliente. Será considerado o código IBGE, conforme cadastro nacional.

CLIENTES.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_Address.

_City.

_Description

Nome da cidade do cliente

CIDADES.den_cidade

_Address.

_District

Bairro do cliente

VDP_CLI_FORNEC_CPL.bairro (se estiver preenchido) ou então CLIENTES.den_bairro

_Address.

_State.

_Code

Sigla do estado (UF) do cliente

CLIENTES.cod_uni_feder

OBS: Se a UF do cliente não for uma das unidades de federação brasileiras é fixado o valor “EX” (Exterior).

_Address.

_State.

_Description

Nome do estado (UF) do cliente

UNI_FEDER.den_uni_feder

_Address.

_Country.

_Code

Código do país do cliente

UNI_FEDER.cod_pais

_Address.

_Country.

_Description

Nome do país do cliente

PAISES.den_pais

_Address.

_ZIPCode

Código de Endereçamento Postal (CEP) do cliente

CLIENTES.cod_cep

OBS: São considerados apenas os dígitos.

_Address.

_POBox

Número da caixa postal do cliente

CLIENTES.num_caixa_postal

_ShippingAddress.

_Address

Endereço de entrega do cliente

CLI_END_ENT.logradouro

_ShippingAddress.

_Number

Número do endereço de entrega do cliente

CLI_END_ENT.num_iden_lograd

_ShippingAddress.

_Complement

Complemento do endereço de cobrança do cliente

CLI_END_ENT.complemento_endereco

_ShippingAddress.

_City.

_Code

Código da cidade do endereço de entrega do cliente. Será considerado o código IBGE, conforme cadastro nacional.

CLI_END_ENT.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_ShippingAddress.

_City.

_Description

Nome da cidade de entrega do cliente

CIDADES.den_cidade

_ShippingAddress.

_District

Bairro de entrega do cliente

CLI_END_ENT.den_bairro

_ShippingAddress.

_State.

_Code

Sigla do estado (UF) de entrega do cliente

CIDADES.cod_uni_feder

OBS: Se a UF do cliente não for uma das unidades de federação brasileiras é fixado o valor “EX” (Exterior).

_ShippingAddress.

_State.

_Description

Nome do estado (UF) de entrega do cliente

UNI_FEDER.den_uni_feder

_ShippingAddress.

_Country.

_Code

Código do país de entrega do cliente

UNI_FEDER.cod_pais

_ShippingAddress.

_Country.

_Description

Nome do país de entrega do cliente

PAISES.den_pais

_ShippingAddress.

_ZIPCode

Código de Endereçamento Postal (CEP) de entrega do cliente

CLI_END_ENT.cod_cep

OBS: São considerados apenas os dígitos.

_ListOfCommunicationInformation.

_PhoneNumber

Número do telefone do cliente

VDP_CLI_FORNEC_CPL.telefone_1 (se estiver preenchido) ou então CLIENTES.num_telefone

_ListOfCommunicationInformation.

_FaxNumber

Número do fax do cliente

CLIENTES.num_fax

_ListOfCommunicationInformation.

_HomePage

Home (site) do cliente

VDP_CLI_FORNEC_CPL.endereco_web (se estiver preenchido) ou então VDP_CLIENTE_COMPL.endereco_web

_ListOfCommunicationInformation.

_Email

Email principal do cliente

VDP_CLI_FORNEC_CPL.correio_eletronico (se estiver preenchido) ou então VDP_CLIENTE_COMPL.email

_ListOfContacts.

_Code

Código do contato do cliente

CLI_CONTATOS.num_contato

_ListOfContacts.

_Name

Nome do contato do cliente

CLI_CONTATOS.nom_contato

_ListOfContacts.

_Department

Departamento do contato do cliente

CLI_CONTATOS.departno

_ListOfContacts.

_CommunicationInformation.

_PhoneNumber

Telefone do contato do cliente

CLI_CONTATOS.num_telefone

_ListOfContacts.

_CommunicationInformation.

_PhoneExtension

Ramal do contato do cliente

CLI_CONTATOS.num_ramal

_ListOfContacts.

_CommunicationInformation.

_FaxNumber

Fax do contato do cliente

CLI_CONTATOS.num_fax

_ListOfContacts.

_CommunicationInformation.

_Email

Fax do contato do cliente

CLI_CONTATOS.email

_Billinginformation.

_Address

Endereço de cobrança do cliente

CLI_END_DET_COBRANCA_ENTREGA.logradouro

_Billinginformation.

_Number

Número do endereço de cobrança do cliente

CLI_END_DET_COBRANCA_ENTREGA.num_iden_lograd

_Billinginformation.

_Complement

Complemento do endereço de cobrança do cliente

CLI_END_DET_COBRANCA_ENTREGA.complemento_endereco

_Billinginformation.

_City.

_Code

Código da cidade do endereço de cobrança do cliente. Será considerado o código IBGE, conforme cadastro nacional.

CLI_END_DET_COBRANCA_ENTREGA.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_Billinginformation.

_City.

_Description

Nome da cidade de cobrança do cliente

CIDADES.den_cidade

_Billinginformation.

_District

Bairro de cobrança do cliente

CLI_END_COB.den_bairro

_Billinginformation.

_State.

_Code

Sigla do estado (UF) de cobrança do cliente

CIDADES.cod_uni_feder

OBS: Se a UF do cliente não for uma das unidades de federação brasileiras é fixado o valor “EX” (Exterior).

_Billinginformation.

_State.

_Description

Nome do estado (UF) de cobrança do cliente

UNI_FEDER.den_uni_feder

_Billinginformation.

_Country.

_Code

Código do país de cobrança do cliente

UNI_FEDER.cod_pais

_Billinginformation.

_Country.

_Description

Nome do país de cobrança do cliente

PAISES.den_pais

_Billinginformation.

_ZIPCode

Código de Endereçamento Postal (CEP) de cobrança do cliente

CLI_END_COB.cod_cep

OBS: São considerados apenas os dígitos.

_CreditInformation.

_CreditLimit

Limite de crédito do cliente

CLI_CREDITO.val_limite_cred

_CreditInformation.

_CreditLimitCurrency

Código da moeda na qual está expresso o valor de limite de crédito do cliente

PAR_CON.cod_moeda_padrao

_CreditInformation.

_CreditLimitDate

Data do limite de crédito do cliente

CLI_CREDITO.dat_val_lmt_cr

_CreditInformation.

_LatePeriods

Quantidade de dias para atraso de pagamento de duplicatas

CLI_CREDITO.qtd_dias_atr_dupl

Notas:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.

(**) Quando é realizado o envio de mensagem, considera-se o próprio código do Logix. Quando é realizado o recebimento de uma mensagem, o conteúdo desta tag será o código cadastrado no sistema de origem, que no Logix estará cadastrado como “Código Externo” no programa VDP10143 (Consulta Código Externo Cliente/Fornecedor). A partir deste código externo o Logix identificará qual é o seu código, para então proceder as atualizações.

(***) A mensagem CustomerVendor foi criada para atender a integração de clientes e de fornecedores. O que diferenciará um tipo de outro será a tag “Type”, que para fornecedores receberá o valor “Customer”.

(***) Nos casos de registros do tipo “Ambos” (onde uma empresa é cliente e fornecedor ao mesmo tempo), o Logix enviará duas mensagens para o Protheus, uma com o tipo “Customer” e outra com o tipo “Vendor”. No recebimento da mensagem, porém, está previsto receber o tipo “Both” (Ambos), onde neste caso o Logix realizará a atualização dos dois cadastros.


Para a integração do cadastro de clientes existe a mesma situação indicada no cadastro de fornecedores, onde não foi possível utilizar o mesmo código nos dois sistemas. A solução adotada para o cadastro de fornecedores se aplica também ao cadastro de clientes, veja o seu funcionamento no item 5.1. Cadastro de Fornecedor – CustomerVendor.


1.3          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.


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

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


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId(**)

Código da empresa

Variável global p_cod_empresa

_BranchId(**)

Código da filial

Somente é tratado no recebimento da mensagem, para identificar o código da empresa Logix onde deve ser efetuada a atualização

_Code(***)

Código do item

ITEM.cod_item

_Name

Descrição do item

ITEM.den_item

_ShortName

Descrição reduzida do item

ITEM.den_item_reduz

_Active

Indica se o item está ou não ativo

ITEM.ies_situacao

OBS: Se for “A” (Ativo) considera como “true”, caso contrário considera como “false”.

_StockGroupCode

Código do grupo de controle de estoque

ITEM.gru_ctr_estoq

OBS: Para esta informação é tratado o relacionamento De/Para de Grupos de Controle de Estoque.

_StockGroupDescription

Descrição do grupo de controle de estoque

GRUPO_CTR_ESTOQ.den_gru_ctr_estoq

_UnitOfMeasureCode

Código da unidade de medida

ITEM.cod_unid_med

_ObtainingType

Forma de obtenção do item

ITEM.ies_tip_item

OBS: Se for “C” (Comprado) considera como “1” (Comprado), caso contrário considera como “2” (Fabricado).

_ComercialFamilyCode

Código da família comercial do item. No Logix será identificado pelo cadastro de “Grupo de Item”

ITEM_VDP.cod_grupo_item

_ComercialFamilyDescription

Descrição da família comercial do item

GRUPO_ITEM.den_grupo_item

_DeployDate

Data da implantação do item

ITEM.dat_cadastro

_ReleaseDate

Data de liberação do item. No Logix será a própria data de cadastro

ITEM.dat_cadastro

_StandardWarehouseCode

Código do local (armazém) padrão do item

ITEM.cod_local_estoq

OBS: Para esta informação é tratado o relacionamento De/Para de Locais de Estoque.

_StandardWarehouseDescription

Descrição do local (armazém) padrão do item

LOCAL.den_local

_MultipleLot

Lote múltiplo

Se o tipo do item for “Produzido” ou “Final” será o campo ITEM_MAN.qtd_prog_multipla, caso contrário será o campo ITEM_SUP.qtd_lote_multiplo.

_EconomicLot

Lote econômico

Se o tipo do item for “Produzido” ou “Final” será igual a “0” (zero), caso contrário será o campo ITEM_SUP.qtd_lote_economic.

_MinimumLot

Lote mínimo

Se o tipo do item for “Produzido” ou “Final” será o campo ITEM_MAN.qtd_prog_minima, caso contrário será o campo ITEM_SUP.qtd_lote_minimo.

_QualityControl

Indica se o item tem controle de qualidade

ITEM.ies_tem_inspecao

OBS: Se for “S” considera como “true”, caso contrário considera como “false”.

_ControlType

Indica o tipo de controle de estoque do item

ITEM.ies_ctr_estoq

OBS: Se for “S” considera como “2” (Total), caso contrário considera como “4” (Débito Direto).

_NetWeight

Peso unitário do item

ITEM.pes_unit

_FamilyCode

Código da família do item

ITEM.cod_familia

_FamilyDescription

Descrição da família do item

FAMILIA.den_familia

_Origin

Origem do produto

MAN_INF_COM_ITEM.val_flag onde o campo “informacao_compl” seja igual a “integra_origem”.

_FiscalInformation.

_Code(****)

Código da classificação fiscal do item (NCM)

ITEM.cod_cla_fisc

OBS: O Logix enviará este código sem a máscara (somente os números).

_CustomerItemInformations.

_CustomerCode

Código do cliente/depositante

Se for item controlado pelo WMS será o campo WMS_ITEM_COMPLEMENTO.deposit, caso contrário será o campo CLIENTE_ITEM.cod_cliente_matriz.

_CustomerItemInformations.

_CustomerItemCode

Código do item do cliente/depositante

Se for item controlado pelo WMS será o campo WMS_ITEM_COMPLEMENTO.item_deposit, caso contrário será o campo CLIENTE_ITEM.cod_item_cliente.

Notas:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.

(**) No recebimento da mensagem é verificado o relacionamento de/para de Empresa/Filial externa no programa LOG00083 (Cadastro de Empresas), para que seja identificada qual é a empresa Logix onde deve ser atualizado o cadastro.

(***) Quando é realizado o envio de mensagem, considera-se o próprio código do Logix. Quando é realizado o recebimento de uma mensagem, o conteúdo desta tag será o código cadastrado no sistema de origem, que no Logix estará cadastrado como “Código Externo” no programa MAN72011 (Consulta Código Externo Item). A partir deste código externo o Logix identificará qual é o seu código, para então proceder as atualizações.

(****) Quando o produto é cadastrado no Logix, a NCM (Classificação Fiscal) é gravada como “0” (zero). Porém este valor é inválido para o Protheus. Desta forma, o Logix irá enviar para o Protheus a classificação fiscal padrão definida no parâmetro “Classificação fiscal padrão”. Depois da conclusão do cadastro do produto no Logix o usuário deve complementar as informações na aba “Fiscal”, registrando a classificação fiscal correta, atualizando esta informação no Protheus.


Como os itens de compras (não controlados pelo WMS) serão cadastrados diretamente no Datasul e no Logix é obrigatório que o código de item seja sequencial no segmento de Operador Logístico, não foi possível utilizar o mesmo código nos dois sistemas. Para resolver esta situação foi necessário criar um relacionamento “De/Para” entre os códigos interno e externo, que será alimentado automaticamente no envio e no recebimento da mensagem.


Como funciona – Envio:

  • Quando o Logix enviar uma mensagem de item, sempre será preenchida a tag _Code com o código do Logix (ITEM.cod_item).
  • Quando a atualização das informações do item for finalizada com sucesso pelo Protheus, ele retornará o seu código gerado para que seja registrada de forma automática o relacionamento entre os códigos no programa MAN72011 (Consulta Código Externo Item).


Como funciona – Recebimento:

  • Quando o Logix receber uma mensagem de item, será verificado através do conteúdo da  tag _Code se existe o código externo registrado no programa MAN72011 (Consulta Código Externo Item).
  • Se o código externo for encontrado, será considerado o código do item Logix que está relacionado à este código externo.
  • Se o código externo não for encontrado, o sistema entenderá que se trata de um novo item, e portanto providenciará o cadastramento do mesmo.
  • Nesta situação, o código do item no Logix será determinado conforme as regras já existentes, que poderá ser de forma automática (seqüencial) ou manual (neste caso o código Logix será igual ao código Protheus).
  • Em todas as situações acima será registrado automaticamente o relacionamento De/Para de códigos no programa MAN72011 quando o parâmetro “Utiliza De/Para de itens na integração via EAI?” estiver ativo, evitando que o usuário tenha que efetuar o relacionamento manualmente.
  • Após todos os procedimentos e atualizações o Logix retornará uma mensagem de resposta para o Protheus enviando qual foi o seu código gerado, para que o relacionamento automático também possa ser realizado neste sistema.


1.4          Cadastro de Cidade – City


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


No Logix o envio desta mensagem ocorre a partir deste programa, quando uma manutenção é realizada:

  • VDP3080 - Cadastro de Cidades


As informações tratadas atualmente nesta mensagem são:


Tag

Descrição

Origem / Destino da Informação

_Code

Código da cidade

OBF_CIDADE_IBGE.cidade_logix

_OfficialCode(*)

Código oficial da cidade (IBGE)

OBF_CIDADE_IBGE.cidade_ibge

OBS: Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_Description

Descrição da cidade

CIDADES.den_cidade

_FederalUnit

Unidade de federação

OBF_CIDADE_IBGE.estado_logix

Nota:

(*) Para a integração de cidades é considerado como campo chave entre os sistemas o código oficial, proveniente do IBGE. Desta forma, no Logix torna-se obrigatório o preenchimento desta informação no cadastro de cidades (VDP3080), quando esta mensagem estiver habilitada para envio ou recebimento.


1.5          Cadastro de Unidade de Medida – UnitOfMeasure


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


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

  • MAN1170 - Cadastro de Unidades de Medida (versão 10.2)
  • MAN10013 - Cadastro de Unidades de Medida (versão 11.0)


As informações tratadas atualmente nesta mensagem são:


Tag

Descrição

Origem / Destino da Informação

_Code(*)

Código da unidade de medida

UNID_MED.cod_unid_med

_Description

Descrição da unidade de medida

UNID_MED.den_unid_med_30

Nota:

(*) Como no Protheus o limite do campo de código da unidade de medida é de 2 (dois) caracteres, quando esta mensagem estiver habilitada no Logix será possível realizar o cadastramento de unidades de medida contendo no máximo este mesmo número de caracteres, nos programas MAN1170 (versão 10.2) e MAN10013 (versão 11.0).


1.6          Cadastro de Cotação de Moeda – CurrencyQuotation


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


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

  • PAT0150 - Cadastro de Cotações de Moeda (versão 10.2)
  • CON10018 - Cadastro de Cotações de Moeda (versão 11.0)


As informações tratadas atualmente nesta mensagem são:


Tag

Descrição

Origem / Destino da Informação

_CurrencyCode

Código da moeda

COTACAO.cod_moeda

_Period.

_Year

Ano da cotação

Ano da COTACAO.dat_ref

_Period.

_Month

Mês da cotação

Mês da COTACAO.dat_ref

_ListOfQuotation.

_Day

Dia da cotação

Dia da COTACAO.dat_ref

_ListOfQuotation.

_Value

Valor da cotação

COTACAO.val_cotacao


1.7          Cadastro de Transportador – Carrier


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


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

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


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_CarrierCode

Código do transportador

FORNECEDOR.cod_fornecedor

_ShortName

Nome reduzido do transportador

VDP_CLI_FORNEC_CPL.razao_social_reduz (se estiver preenchido) ou então FORNECEDOR.raz_social_reduz

_Name

Nome do transportador

VDP_CLI_FORNEC_CPL.razao_social (se estiver preenchido) ou então FORNECEDOR.raz_social

_GovernmentalInformation

Esta tag pode conter até 4 (quatro) informações diferentes, que são diferenciadas pelo atributo _Name:

_Name

_Scope

_Id

_ExpiresOn

“CPF”

“Federal”

CPF do fornecedor (quando Pessoa Física)

NULL

“CNPJ”

“Federal”

CNPJ do fornecedor (quando Pessoa Jurídica)

NULL

“Inscricao Estadual”

“State”

Número da Inscrição Estadual do fornecedor

NULL

“Inscricao Municipal”

“Municipal”

Número da Inscrição Municipal do fornecedor

NULL

CPF → FORNECEDOR.num_cgc_cpf


CNPJ → FORNECEDOR.num_cgc_cpf


Inscrição Estadual → FORNECEDOR.ins_estadual


Inscrição Municipal → FORNEC_COMPL.ins_municipal

_Address.

_Address

Endereço do transportador

VDP_CLI_FORNEC_CPL.logradouro (se estiver preenchido) ou então FORNECEDOR.end_fornec

_Address.

_Number

Número do endereço do transportador

VDP_CLI_FORNEC_CPL.num_iden_lograd

_Address.

_Complement

Complemento do endereço do transportador

VDP_CLI_FORNEC_CPL.compl_endereco

_Address.

_City.

_Code

Código da cidade do endereço do transportador. Será considerado o código IBGE, conforme cadastro nacional.

FORNECEDOR.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_Address.

_City.

_Description

Nome da cidade do transportador

CIDADES.den_cidade

_Address.

_District

Bairro do transportador

VDP_CLI_FORNEC_CPL.bairro (se estiver preenchido) ou então FORNECEDOR.den_bairro

_Address.

_State.

_Code

Sigla do estado (UF) do transportador

FORNECEDOR.cod_uni_feder

OBS: Se a UF do transportador não for uma das unidades de federação brasileiras é fixado o valor “EX” (Exterior).

_Address.

_State.

_Description

Nome do estado (UF) do transportador

UNI_FEDER.den_uni_feder

_Address.

_Country.

_Code

Código do país do transportador

UNI_FEDER.cod_pais

_Address.

_Country.

_Description

Nome do país do transportador

PAISES.den_pais

_Address.

_ZIPCode

Código de Endereçamento Postal (CEP) do transportador

FORNECEDOR.cod_cep

OBS: São considerados apenas os dígitos.

_ListOfCommunicationInformation.

_PhoneNumber

Número do telefone do transportador

VDP_CLI_FORNEC_CPL.telefone_1 (se estiver preenchido) ou então FORNECEDOR.num_telefone

_ListOfCommunicationInformation.

_FaxNumber

Número do fax do transportador

FORNECEDOR.num_fax

_ListOfCommunicationInformation.

_HomePage

Home (site) do transportador

VDP_CLI_FORNEC_CPL.endereco_web (se estiver preenchido) ou então FORNEC_COMPL.endereco_web

_ListOfCommunicationInformation.

_Email

Email principal do transportador

VDP_CLI_FORNEC_CPL.correio_eletronico (se estiver preenchido) ou então FORNEC_COMPL.e_mail

_ListOfContacts.

_Code

Código do contato (número seqüencial)

SUP_CNTT_FORNEC.sequencia_contato

_ListOfContacts.

_Name

Nome do contato do transportador

SUP_CNTT_FORNEC.nom_contato

_ListOfContacts.

_CommunicationInformation.

_PhoneNumber

Telefone do contato do transportador

SUP_CNTT_FORNEC.telefone

_ListOfContacts.

_CommunicationInformation.

_FaxNumber

Fax do contato do transportador

SUP_CNTT_FORNEC.fax

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.


Somente fornecedores com tipo igual a “2” (Transportador) é que serão considerados para envio de mensagem.

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.


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_InvoiceNumber

Número da nota fiscal

NF_SUP.num_nf

_DocumentSeries

Série da nota fiscal

NF_SUP.ser_nf

_CustomerCode

Código do fornecedor

NF_SUP.cod_fornecedor

_InvoiceDate

Data de emissão da nota fiscal

NF_SUP.dat_emis_nf

_InputDate

Data de entrada da nota fiscal

NF_SUP.dat_entrada_nf

_InvoiceDescounts

Valor total de desconto da nota fiscal

NF_SUP.val_tot_desc

_GoodsValue

Valor líquido dos itens da nota fiscal

Somatória do campo AVISO_REC.val_liquido_item

_InvoiceGrossValue

Valor total da nota fiscal

NF_SUP.val_tot_nf_d

_InsuranceValue

Valor do seguro da nota fiscal

SUP_PAR_AR.parametro_val (onde o parâmetro é igual a “val_seguro”)

_SefazNFeKey

Chave de acesso da NF-e

SUP_PAR_AR.parametro_texto (onde o parâmetro é igual a “chav_aces_nf_eletr”)

_TypeFreight

Tipo de frete

MODO_EMBARQUE.ies_tip_frete

OBS: Se for igual a “0” (Sem Frete), considera-se “4” (Sem Frete); se for igual a “1” (Frete Pago), considera-se “1” (CIF); se for igual a “2” (Frete a Pagar), considera-se “2” (FOB).

_FreightValue

Valor total de frete

Somatória do campo AVISO_REC.val_frete

_CustomerTicket

Tipo da nota fiscal

NF_SUP.ies_nf_aguard_nfe

_CalculationBasisICMS

Valor da base de cálculo do ICMS

Se existir o valor declarado na NF considera a somatória de AVISO_REC.val_base_c_item_d, caso contrário considera o valor calculado, AVISO_REC.val_base_c_item_c

_ICMSValue

Valor do ICMS

Se existir o valor declarado na NF considera o NF_SUP.val_tot_icms_nf_d, caso contrário considera o valor calculado, NF_SUP.val_tot_icms_nf_c

_CalculationBasisIPI

Valor da base de cálculo do IPI

Se existir o valor declarado na NF considera a somatória de AVISO_REC_COMPL_SQ. val_base_d_ipi_it, caso contrário considera o valor calculado, AVISO_REC.val_base_c_ipi_it

_IPIValue

Valor do IPI

Se existir o valor declarado na NF considera o NF_SUP.val_ipi_nf, caso contrário considera o valor calculado, NF_SUP.val_ipi_calc

_PaymentCode

Código da condição de pagamento

NF_SUP.cnd_pgto_nf

OBS: Para esta informação é tratado o relacionamento De/Para de Condições de Pagamento de Nota Fiscal Recebimento.

Ver também o parâmetro “Máscara da condição de pagamento”.

_TypeOfDocument

Espécie da nota fiscal

NF_SUP.ies_especie_nf

OBS: Se o depositante for Produtor Rural (indicado no cadastro do fornecedor no VDP0815), será enviada a espécie “NFP”.

_ListOfItems.

_ItemInvoice

Sequência do item da nota fiscal

AVISO_REC.num_seq

_ListOfItems.

_ItemCode

Código do item

AVISO_REC.cod_item

_ListOfItems.

_UnitOfMeasure

Código da unidade de medida

AVISO_REC.cod_unid_med_nf

_ListOfItems.

_Quantity

Quantidade declarada

AVISO_REC.qtd_declarad_nf

_ListOfItems.

_UnitValue

Preço unitário

AVISO_REC.pre_unit_nf

_ListOfItems.

_DiscountValue

Valor do desconto do item

AVISO_REC.val_desc_item

_ListOfItems.

_IncreaseValue

Valor de acréscimo do item

AVISO_REC.val_acrescimos

_ListOfItems.

_GrandTotal

Valor líqudo do item

AVISO_REC.val_liquido_item

_ListOfItems.

_TypeOperation

Tipo da operação. No Logix será obtido através do CFOP da nota fiscal.

NF_SUP.cod_operacao e AVISO_REC_COMPL.cod_fiscal_compl

OBS: Para esta informação é tratado o relacionamento De/Para de CFOP de Recebimento x TES.

_ListOfItems.

_OperationFiscalCode

CFOP do item da nota fiscal

AVISO_REC.cod_fiscal_item

_ListOfItems.

_WarehouseId

Código do local (armazém) de estoque

AVISO_REC.cod_local_estoq

OBS: Para esta informação é tratado o relacionamento De/Para de Locais de Estoque.

_ListOfItems.

_LotNumberInSupplier

Número do lote do fornecedor

AVISO_REC.num_lote

_ListOfItems.

_FreightValue

Valor do frete do item da nota fiscal

AVISO_REC.val_frete

_ListOfItems.

_CalculationBasisIPI

Valor da base de cálculo do IPI

Se existir o valor declarado na NF considera o campo AVISO_REC_COMPL_SQ. val_base_d_ipi_it, caso contrário considera o valor calculado, AVISO_REC.val_base_c_ipi_it

_ListOfItems.

_IPITaxRate

Percentual de IPI

Se existir o valor declarado na NF considera o campo AVISO_REC.pct_ipi_declarad, caso contrário considera o valor calculado, AVISO_REC.pct_ipi_tabela

_ListOfItems.

_IPIValue

Valor do IPI

Se existir o valor declarado na NF considera o campo AVISO_REC.val_ipi_decl_item, caso contrário considera o valor calculado, AVISO_REC.val_ipi_calc_item

_ListOfItems.

_CalculationBasisICMS

Valor da base de cálculo do ICMS

Se existir o valor declarado na NF considera o campo AVISO_REC. val_base_c_item_d, caso contrário considera o valor calculado, AVISO_REC.val_base_c_item_c

_ListOfItems.

_ICMSTaxRate

Percentual de ICMS

Se existir o valor declarado na NF considera o campo AVISO_REC.pct_icms_item_d, caso contrário considera o valor calculado, AVISO_REC.pct_icms_item_c

_ListOfItems.

_ICMSValue

Valor do ICMS

Se existir o valor declarado na NF considera o campo AVISO_REC.val_icms_item_d, caso contrário considera o valor calculado, AVISO_REC.val_icms_item_c

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.


No Logix o envio desta mensagem 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 nota fiscal 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 nota fiscal 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 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).


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.


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_DocumentNumber

Número da nota fiscal de regularização (Definitiva)

NF_SUP.num_nf, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_regularizacao

_DocumentSeries

Série da nota fiscal de regularização

NF_SUP.ser_nf, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_regularizacao

_CustomerCode

Código do fornecedor da nota fiscal de regularização

NF_SUP.cod_fornecedor, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_regularizacao

_PaymentCode

Código da condição de pagamento da nota fiscal de regularização

NF_SUP.cnd_pgto_nf, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_regularizacao

OBS: Para esta informação é tratado o relacionamento De/Para de Condições de Pagamento de Nota Fiscal Recebimento.

Ver também o parâmetro “Máscara da condição de pagamento”.

_TypeOfDocument

Espécie da nota fiscal

NF_SUP.ies_especie_nf, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_regularizacao

_InvoiceDate

Data de emissão da nota fiscal

NF_SUP.dat_emis_nf

_InputDate

Data de entrada da nota fiscal

NF_SUP.dat_entrada_nf

_InvoiceGrossValue

Valor total da nota fiscal

NF_SUP.val_tot_nf_d

_SefazNFeKey

Chave de acesso da NF-e

SUP_PAR_AR.parametro_texto (onde o parâmetro é igual a “chav_aces_nf_eletr”)

_ListOfTaxes.

_Tax.

_Taxe

Identificação do imposto

Esta tag pode ser preenchida com uma destas duas informações: “ICMS” ou “IPI”

_ListOfTaxes.

_Tax.

_CalculationBasis

Valor da base de cálculo do ICMS ou IPI

Para “ICMS”: Se existir o valor declarado na NF considera o campo AVISO_REC. val_base_c_item_d, caso contrário considera o valor calculado, AVISO_REC.val_base_c_item_c

Para “IPI”: Se existir o valor declarado na NF considera o campo AVISO_REC_COMPL_SQ. val_base_d_ipi_it, caso contrário considera o valor calculado, AVISO_REC.val_base_c_ipi_it

_ListOfTaxes.

_Tax.

_Value

Valor do ICMS ou IPI

Para “ICMS”: Se existir o valor declarado na NF considera o campo AVISO_REC.val_icms_item_d, caso contrário considera o valor calculado, AVISO_REC.val_icms_item_c

Para “IPI”: Se existir o valor declarado na NF considera o campo AVISO_REC.val_ipi_decl_item, caso contrário considera o valor calculado, AVISO_REC.val_ipi_calc_item

_ListOfItems.

_InvoiceDocumentSequence

Sequência da nota fiscal de regularização

WMS_IDEN_NF_REC_REGULARIZACAO.seq_ar_regularizacao

_ListOfItems.

_ItemCode

Código do item regularizado

AVISO_REC.cod_item, sendo esta tabela acessada pelos campos WMS_IDEN_NF_REC_REGULARIZACAO.ar_regularizacao e WMS_IDEN_NF_REC_REGULARIZACAO.seq_ar_regularizacao

_ListOfItems.

_DocumentNumber

Número da nota fiscal que foi regularizada

NF_SUP.num_nf, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_recebto

_ListOfItems.

_DocumentSeries

Série da nota fiscal que foi regularizada

NF_SUP.ser_nf, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_recebto

_ListOfItems.

_CustomerCode

Código do fornecedor da nota fiscal que foi regularizada

NF_SUP.cod_fornecedor, sendo esta tabela acessada pelo campo WMS_IDEN_NF_REC_REGULARIZACAO.ar_recebto

_ListOfItems.

_CoverageSequence

Sequência da nota fiscal que foi regularizada

WMS_IDEN_NF_REC_REGULARIZACAO.seq_ar_recebto

_ListOfItems.

_Quantity

Quantidade regularizada

WMS_IDEN_NF_REC_REGULARIZACAO.qtd_regularizada

_ListOfItems.

_UnitValue

Preço unitário da nota fiscal de regularização

AVISO_REC.pre_unit_nf

_ListOfItems.

_DiscountValue

Valor do desconto do item

AVISO_REC.val_desc_item

_ListOfItems.

_TypeOperation

CFOP da nota fiscal de regularização

NF_SUP.cod_operacao e AVISO_REC_COMPL.cod_fiscal_compl

OBS: Para esta informação é tratado o relacionamento De/Para de CFOP de Regularização x TES.

_ListOfItems.

_OperationFiscalCode

CFOP do item da nota fiscal de regularização

AVISO_REC.cod_fiscal_item

_ListOfItems.

_WarehouseId

Código do local (armazém) de estoque

AVISO_REC.cod_local_estoq

OBS: Para esta informação é tratado o relacionamento De/Para de Locais de Estoque.

_ListOfItems.

_CalculationBasisIPI

Base de cálculo do IPI do item

AVISO_REC.val_base_c_ipi_it

_ListOfItems.

_IPITaxRate

Alíquota de IPI do item

AVISO_REC.pct_ipi_tabela

_ListOfItems.

_IPIValue

Valor de IPI do item

AVISO_REC.val_ipi_calc_item

_ListOfItems.

_CalculationBasisICMS

Base de cálculo do ICMS do item

AVISO_REC.val_base_c_item_c

_ListOfItems.

_ICMSTaxRate

Alíquota de ICMS do item

AVISO_REC.pct_icms_item_c

_ListOfItems.

_ICMSValue

Valor de ICMS do item

AVISO_REC.val_icms_item_c

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.


No Logix o envio desta mensagem 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.


1.3          Solicitação de Carga – EDIDocumentForTransportation


Nesta mensagem serão integradas informações básicas da solicitação de carga WMS, cujo objetivo é alimentar o TMS do Protheus com informações que permitam a preparação das informações para o transporte das mercadorias. Dentro do EAI esta mensagem é identificada pelo nome EDIDocumentForTransportation.


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_SenderCode

CNPJ/CPF do remetente do produto. No Logix será o código do depositante.

WMS_SOLICITACAO_CARGA_MESTRE.deposit

_BoardingDate

Data de inclusão da solicitação de carga

WMS_SOLICITACAO_CARGA_MESTRE.dat_inclusao

_AddresseeCode

CNPJ/CPF do destinatário do produto.

WMS_SOLICITACAO_CARGA_MESTRE.destinatario

_DocumentNumber

Número da nota fiscal

WMS_SOLICITACAO_CARGA_MESTRE.nota_fiscal

_DocumentSeries

Série da nota fiscal

WMS_SOLICITACAO_CARGA_MESTRE.serie_nota_fiscal

_InvoiceIssueDate

Data de emissão da nota fiscal

WMS_SOLICITACAO_CARGA_MESTRE.dat_emissao

_FiscalOperationCode

CFOP da nota fiscal

WMS_SOLICITACAO_CARGA_MESTRE.cfop

_SEFAZNFeKey

Chave de acesso da NFe

WMS_PARAMETRO_COMPLEMENTAR.val_texto (onde o parâmetro é igual a “chave_acesso_nfe”)

_ListOfItems.

_ItemCode

Código do item da solicitação de carga

WMS_SOLICITACAO_CARGA_ITEM.item

OBS: É considerado o código do item da primeira sequência existente na solicitação.

_ListOfItems.

_VolumeQuantity

Quantidade de volumes da solicitação de carga

Se a situação da solicitação de carga for igual a “X” (Aguardando Expedição) ou igual a “N” (Aguardando NF) será a somatória da quantidade de volumes encontrados nas tabelas WMS_VOLUME_EXPED e WMS_VOLUME_PALETE.

Caso contrário será o campo WMS_SOLICITACAO_CARGA_MESTRE.qtd_volume

_ListOfItems.

_Value

Valor total da nota fiscal

WMS_SOLICITACAO_CARGA_MESTRE.val_docum

_ListOfItems.

_Weight

Peso bruto total dos volumes

Se a situação da solicitação de carga for igual a “X” (Aguardando Expedição) ou igual a “N” (Aguardando NF) será a somatória do campo WMS_VOLUME_EXPED.peso_bruto.

Caso contrário será o campo WMS_SOLICITACAO_CARGA_MESTRE.peso_bruto

_ListOfItems.

_CubicMeters

Metragem cúbica total dos volumes

Se a situação da solicitação de carga for igual a “X” (Aguardando Expedição) ou igual a “N” (Aguardando NF) será a somatória do campo WMS_VOLUME_EXPED.volume_m3.

Caso contrário será 0 (zero).

_ListOfItems.

_CalculationBasisICMS

Valor da base de cálculo do ICMS

WMS_SOLICITACAO_CARGA_MESTRE.val_base_icms

_ListOfItems.

_ICMSValue

Valor do ICMS

WMS_SOLICITACAO_CARGA_MESTRE.val_icms

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.


Para a integração somente são consideradas as solicitações de carga do tipo “ND” (Nota Fiscal Digitada) e “NE” (Nota Fiscal Recebida por EDI). Os demais tipos de documento não são integrados pois somente uma nota fiscal é um documento válido para a configuração do transporte (TMS).


No Logix o envio desta mensagem ocorre a partir destes programas:

  • WMS6325 – Solicitação de Carga
  • EDI0009 – Processamento de Arquivos EDI
  • WMS6218 – Conferência via coletor
  • WMS6219 – Conferência PDV
  • WMS6231 – Conferência via Coletor gerando volumes automaticamente
  • WMS6258 – Conferência PDV montando volumes automaticamente
  • WMS6358 – Conferência via Coletor gerando volumes semi-automaticamente
  • WMS6393 – Conferência Palete via coletor
  • WMS6222 – Pesagem de Volumes


1.4          Preparação NF Retorno Simbólico – SalesOrder


Nesta mensagem serão integradas as informações referentes a pedido de venda cujo objetivo é permitir que o Protheus emita a nota fiscal de retorno simbólico para o depositante. No EAI esta mensagem é identificada pelo nome SalesOrder.


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_OrderId(**)

Número do pedido de venda

WMS_DOCUM_SAIDA.pedido

_CustomerCode

Código do cliente. Para este tipo de pedido será considerado o código do depositante.

WMS_SOLICITACAO_CARGA_MESTRE.deposit

_DeliveryAddress.

_Address

Endereço de entrega do destinatário

VDP_CLI_FORNEC_CPL.logradouro

_DeliveryAddress.

_Number

Número do endereço de entrega do destinatário

VDP_CLI_FORNEC_CPL.num_iden_lograd

_DeliveryAddress.

_Complement

Complemento do endereço de entrega do destinatário

VDP_CLI_FORNEC_CPL.compl_endereco

_DeliveryAddress.

_City.

_Code

Código da cidade do endereço de entrega do destinatário

CLIENTES.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_DeliveryAddress.

_City.

_Description

Nome da cidade do endereço de entrega do destinatário

CIDADES.den_cidade

_DeliveryAddress.

_District

Bairro do endereço de entrega do destinatário

CLIENTES.bairro

_DeliveryAddress.

_State.

_Code

UF do endereço de entrega do destinatário

CIDADES.cod_uni_feder

_DeliveryAddress.

_State.

_Description

Nome da UF do endereço de entrega do destinatário

UNI_FEDER.den_uni_feder

_DeliveryAddress.

_Country.

_Code

Código do país do endereço de entrega do destinatário

UNI_FEDER.cod_pais

_DeliveryAddress.

_Country.

_Description

Nome do país do endereço de entrega do destinatário

PAISES.den_pais

_DeliveryAddress.

_ZIPCode

CEP do endereço de entrega do destinatário

CLIENTES.cod_cep

_CarrierCode

Código do transportador

WMS_SOLICITACAO_CARGA_MESTRE.transportador

_PaymentTermCode

Código da condição de pagamento

A partir do parâmetro “wms_cnd_pgt_nf_retn_simb” (LOG00087).

OBS: Para esta informação é tratado o relacionamento De/Para de Condições de Pagamento de Pedido de Venda.

Ver também o parâmetro “Máscara da condição de pagamento”.

_RegisterDate

Data da emissão do pedido

Data atual

_InvoiceMessages

Textos da nota fiscal

Os textos gerados para o pedido (nota fiscal) devem seguir a legislação do segmento de operadores logísticos, e que pode ser diferente para cada cliente/estado.

_NetWeight

Peso líquido

Somatória de WMS_VOLUME_EXPED.peso_liquido

_GrossWeight

Peso bruto

Se existir o peso obtido pela balança será a somatória de WMS_VOLUME_EXPED.peso_balanca.

Caso contrário será considerada a somatória de WMS_VOLUME_EXPED.peso_bruto.

_TareWeight

Peso bruto obtido pela balança

Somatória de WMS_VOLUME_EXPED.peso_balanca

_CubicVolume

Volume (metros cúbicos)

Somatória de WMS_VOLUME_EXPED.volume_m3

_NumberOfVolumes

Número de volumes

Somatória da quantidade de volumes encontrados nas tabelas WMS_VOLUME_EXPED e WMS_VOLUME_PALETE.

_Finality

Finalidade

1 = Se o depositante for contribuinte de ICMS

2 = Se o depositante não for contribuinte de ICMS

_SalesOrderItens.

_CompanyId

Código da empresa

Variável global p_cod_empresa

_SalesOrderItens.

_OrderItem

Sequência do pedido

Controle seqüencial realizado pela própria rotina

_SalesOrderItens.

_ItemCode

Código do item

WMS_SOLICITACAO_CARGA_ITEM.item

_SalesOrderItens.

_ItemDescription

Descrição do item

ITEM.den_item

_SalesOrderItens.

_Quantity

Quantidade total retornada do item

WMS_REGULARIZACAO_FISCAL.qtd_regularizada

_SalesOrderItens.

_UnityPrice

Preço unitário de retorno

AVISO_REC.pre_unit_nf

_SalesOrderItens.

_TotalPrice

Valor total retornado

(WMS_REGULARIZACAO_FISCAL.qtd_regularizada * AVISO_REC.pre_unit_nf)

_SalesOrderItens.

_TypeOperation

Código do tipo de operação. No Logix será obtido a partir do código da natureza de operação.

A partir de parâmetros do sistema (LOG00087), conforme regras abaixo:

  • Se for processamento de Regime Especial será o parâmetro “wms_nat_oper_depos_rgm_armz”;
  • Se for processamento sem Regime Especial e for um retorno ao depositante será o parâmetro “wms_nat_oper_nf_retn_merc”;
  • Se for processamento sem Regime Especial, não for retorno ao depositante e o destinatário for estrangeiro será o parâmetro “wms_nat_oper_ret_simb_dest_ext”;
  • Se for processamento sem Regime Especial, não for retorno ao depositante e o destinatário for nacional será o parâmetro “wms_nat_oper_nf_retn_simb”.

OBS: Para esta informação é tratado o relacionamento De/Para de Natureza de Operação x TES (Tipo de Entrada/Saída).

_SalesOrderItens.

_ItemMessages

Textos do item da nota fiscal

Os textos gerados para o pedido (nota fiscal) devem seguir a legislação do segmento de operadores logísticos, e que pode ser diferente para cada cliente/estado.

_SalesOrderItens.

_ListOfReturnedInputDocuments.

_InputDocumentNumber

Número da nota fiscal definitiva sobre a qual está sendo efetuado o retorno

WMS_NF_RETN_MERC_DEPOSITANTE.nota_fiscal_retorno

_SalesOrderItens.

_ListOfReturnedInputDocuments.

_InputDocumentSerie

Série da nota fiscal definitiva

WMS_NF_RETN_MERC_DEPOSITANTE.serie_nota_fiscal_retorno

_SalesOrderItens.

_ListOfReturnedInputDocuments.

_InputDocumentSequence

Sequência da nota fiscal definitiva

WMS_NF_RETN_MERC_DEPOSITANTE.sequencia_item_retorno

_SalesOrderItens.

_ListOfReturnedInputDocuments.

_InputDocumentQuantity

Quantidade que está sendo retornada referente a nota fiscal definitiva

WMS_NF_RETN_MERC_DEPOSITANTE.qtd_item_retorno

Notas:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.

(**) Na inclusão é enviado como NULL. Na exclusão é enviado o número do pedido gerado quando o pedido foi incluído.


No Logix o envio desta mensagem ocorre a partir destes programas:

  • WMS0745 – Emissão Notas Fiscais
  • WMS6196 – 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
  • WMS6429 – Integração de Pedidos de Venda – Exclusão


1.5          Preparação NF Conta e Ordem – SalesOrder


Nesta mensagem serão integradas as informações referentes a pedido de venda cujo objetivo é permitir que o Protheus emita a nota fiscal de conta e ordem. A nota fiscal de 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.


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_OrderId(**)

Número do pedido de venda

WMS_DOCUM_SAIDA.pedido

_CustomerCode

Código do cliente. Para este tipo de pedido será considerado o código do destinatário (cliente do depositante).

WMS_SOLICITACAO_CARGA_MESTRE.destinatario

_DeliveryCustomerCode

Código do cliente de entrega. Será o próprio código do destinatário.

WMS_SOLICITACAO_CARGA_MESTRE.destinatario

_DeliveryAddress.

_Address

Endereço de entrega do destinatário

VDP_CLI_FORNEC_CPL.logradouro

_DeliveryAddress.

_Number

Número do endereço de entrega do destinatário

VDP_CLI_FORNEC_CPL.num_iden_lograd

_DeliveryAddress.

_Complement

Complemento do endereço de entrega do destinatário

VDP_CLI_FORNEC_CPL.compl_endereco

_DeliveryAddress.

_City.

_Code

Código da cidade do endereço de entrega do destinatário

CLIENTES.cod_cidade

OBS: Através desta informação é obtido o código IBGE na tabela OBF_CIDADE_IBGE)

Ver também o parâmetro “Máscara do código da cidade IBGE na mensagem de integração via EAI”.

_DeliveryAddress.

_City.

_Description

Nome da cidade do endereço de entrega do destinatário

CIDADES.den_cidade

_DeliveryAddress.

_District

Bairro do endereço de entrega do destinatário

CLIENTES.bairro

_DeliveryAddress.

_State.

_Code

UF do endereço de entrega do destinatário

CIDADES.cod_uni_feder

_DeliveryAddress.

_State.

_Description

Nome da UF do endereço de entrega do destinatário

UNI_FEDER.den_uni_feder

_DeliveryAddress.

_Country.

_Code

Código do país do endereço de entrega do destinatário

UNI_FEDER.cod_pais

_DeliveryAddress.

_Country.

_Description

Nome do país do endereço de entrega do destinatário

PAISES.den_pais

_DeliveryAddress.

_ZIPCode

CEP do endereço de entrega do destinatário

CLIENTES.cod_cep

_CarrierCode

Código do transportador

WMS_SOLICITACAO_CARGA_MESTRE.transportador

_PaymentTermCode

Código da condição de pagamento

A partir do parâmetro “wms_cnd_pgt_nf_conta_ordem” (LOG00087).

OBS: Para esta informação é tratado o relacionamento De/Para de Condições de Pagamento de Pedido de Venda.

Ver também o parâmetro “Máscara da condição de pagamento”.

_RegisterDate

Data da emissão do pedido

Data atual

_InvoiceMessages

Textos da nota fiscal

Os textos gerados para o pedido (nota fiscal) devem seguir a legislação do segmento de operadores logísticos, e que pode ser diferente para cada cliente/estado.

_NetWeight

Peso líquido

Somatória de WMS_VOLUME_EXPED.peso_liquido

_GrossWeight

Peso bruto

Se existir o peso obtido pela balança será a somatória de WMS_VOLUME_EXPED.peso_balanca.

Caso contrário será considerada a somatória de WMS_VOLUME_EXPED.peso_bruto.

_NumberOfVolumes

Número de volumes

Somatória da quantidade de volumes encontrados nas tabelas WMS_VOLUME_EXPED e WMS_VOLUME_PALETE.

_Finality

Finalidade

1 = Se o depositante for contribuinte de ICMS

2 = Se o depositante não for contribuinte de ICMS

_InsuranceValue

Valor do seguro

WMS_SOLICITACAO_CARGA_MESTRE.val_seguro

_SalesOrderItens.

_CompanyId

Código da empresa

Variável global p_cod_empresa

_SalesOrderItens.

_OrderItem

Sequência do pedido

Controle seqüencial realizado pela própria rotina

_SalesOrderItens.

_ItemCode

Código do item

WMS_SOLICITACAO_CARGA_ITEM.item

_SalesOrderItens.

_ItemDescription

Descrição do item

ITEM.den_item

_SalesOrderItens.

_Quantity

Quantidade total do item

Somatória de WMS_SOLICITACAO_CARGA_ITEM.qtd_reservada

_SalesOrderItens.

_UnityPrice

Preço unitário

WMS_SOLICITACAO_CARGA_ITEM.val_unit

_SalesOrderItens.

_TotalPrice

Valor total retornado

(WMS_SOLICITACAO_CARGA_ITEM.qtd_reservada * WMS_SOLICITACAO_CARGA_ITEM.val_unit)

_SalesOrderItens.

_TypeOperation

Código do tipo de operação. No Logix será obtido a partir do código da natureza de operação.

A partir de parâmetros do sistema (LOG00087), conforme regras abaixo:

  • Se for processamento de Regime Especial será o parâmetro “wms_nat_oper_depos_rgm_armz”;
  • Se for processamento sem Regime Especial e for um retorno ao depositante será o parâmetro “wms_nat_oper_nf_retn_merc”;
  • Se for processamento sem Regime Especial, não for retorno ao depositante e o destinatário for estrangeiro será o parâmetro “wms_nat_oper_ret_simb_dest_ext”;
  • Se for processamento sem Regime Especial, não for retorno ao depositante e o destinatário for nacional será o parâmetro “wms_nat_oper_nf_retn_simb”.

OBS: Para esta informação é tratado o relacionamento De/Para de Natureza de Operação x TES (Tipo de Entrada/Saída).

_SalesOrderItens.

_ItemMessages

Textos do item da nota fiscal

Os textos gerados para o pedido (nota fiscal) devem seguir a legislação do segmento de operadores logísticos, e que pode ser diferente para cada cliente/estado.

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.

(**) Na inclusão é enviado como NULL. Na exclusão é enviado o número do pedido gerado quando o pedido foi incluído.


No Logix o envio desta mensagem ocorre a partir destes programas:

  • WMS0745 – Emissão Notas Fiscais
  • WMS6429 – Integração de Pedidos de Venda – Exclusão


1.6          Preparação NF Faturamento Serviço – SalesOrder


Nesta mensagem serão integradas as informações referentes a pedido de venda cujo objetivo é permitir que o Protheus 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:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_OrderId(**)

Número do pedido de venda

WMS_DOCUM_SAIDA.pedido

_CustomerCode

Código do cliente. Para este tipo de pedido será considerado o código do depositante.

WMS_APURACAO_FATURAMENTO.depositante

_PaymentTermCode

Código da condição de pagamento

WMS_PROCESSO_FATURAMENTO.condicao_pagto

OBS: Para esta informação é tratado o relacionamento De/Para de Condições de Pagamento de Pedido de Venda.

Ver também o parâmetro “Máscara da condição de pagamento”.

_RegisterDate

Data da emissão do pedido

Data atual

_InvoiceMessages

Textos da nota fiscal

Texto de observação informado no momento da geração do pedido (WMS6412).

_SalesOrderItens.

_CompanyId

Código da empresa

Variável global p_cod_empresa

_SalesOrderItens.

_OrderItem

Sequência do pedido

Controle seqüencial realizado pela própria rotina

_SalesOrderItens.

_ItemCode

Código do item

WMS_PROCESSO_FATURAMENTO.item_faturamento_servico, se o mesmo estiver preenchido.

Caso contrário será utilizado WMS_CONTRATO.item_faturamento_servico

_SalesOrderItens.

_ItemDescription

Descrição do item

WMS_PROCESSO_FATURAMENTO.agrupamento_item_nota_fiscal, se o mesmo estiver preenchido.

Caso contrário será utilizado WMS_PROCESSO_FATURAMENTO.des_processo_faturamento

_SalesOrderItens.

_Quantity

Quantidade total do item

1 (um) – Fixo

_SalesOrderItens.

_UnityPrice

Preço unitário

WMS_APUR_FATURAMENTO_PROCESSO.val_total

_SalesOrderItens.

_TotalPrice

Valor total do item

WMS_APUR_FATURAMENTO_PROCESSO.val_total

_SalesOrderItens.

_TypeOperation

Código do tipo de operação. No Logix será obtido a partir do código da natureza de operação.

WMS_PROCESSO_FATURAMENTO.natureza_operacao

OBS: Para esta informação é tratado o relacionamento De/Para de Natureza de Operação x TES (Tipo de Entrada/Saída).

_SalesOrderItens.

_ItemDiscounts

Valor de desconto do item

WMS_APUR_FATURAMENTO_PROCESSO.val_desconto

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.

(**) Na inclusão é enviado como NULL. Na exclusão é enviado o número do pedido gerado quando o pedido foi incluído.


No Logix o envio desta mensagem ocorre a partir destes programas:

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


1.7          Inventário – Inventory


Nesta mensagem serão integradas as informações referentes ao saldo atual de estoque dos itens, após ter sido realizado ajuste proveniente da execução de um inventário. No EAI esta mensagem é identificada pelo nome Inventory.


As informações tratadas atualmente nesta mensagem são:


Tag(*)

Descrição

Origem / Destino da Informação

_CompanyId

Código da empresa

Variável global p_cod_empresa

_ItemCode

Código do item

ESTOQUE_LOTE_ENDER.cod_item

_WarehouseCode

Código do local de estoque

ESTOQUE_LOTE_ENDER.cod_local

OBS: Para esta informação é tratado o relacionamento De/Para de Locais de Estoque.

_Quantity

Quantidade de saldo

Somatória de ESTOQUE_LOTE_ENDER.qtd_saldo para a Empresa/Item/Local

_DateInventory

Data do inventário

Data atual

Nota:

(*) As tag´s existentes no XSD (schema) da mensagem e que não foram mencionadas na lista acima não possuem tratamento na integração, ou seja, não são consideradas no envio ou recebimento da mensagem.


No Logix o envio desta mensagem ocorre a partir do programa SUP5830 (Gerenciador do Inventário).


Limitações / Restrições Gerais

  • No cadastro de Cidades (VDP3080) passará a ser obrigatório o preenchimento do “Munícipio IBGE” pois esta informação será a chave de integração desta mensagem.


  • No cadastro de Unidade de Medida (MAN1170 e MAN10013) será permitido informar apenas dois caracteres para o código, devido a limitação existente no Protheus.


  • 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, pedido de venda de retorno simbólico, pedido de venda de conta/ordem).


  • Para os depositantes identificados com “Regime Especial”, para os processos de expedição que forem executados antes da ativação da integração e que ainda não tiveram a nota fiscal de retorno gerada será necessário executar o processamento do programa WMS6361 (Cancelamento de Processo Fiscal sem Nota), processando novamente o programa WMS0745 (Emissão Documentos WMS) com a integração ativada, onde serão geradas informações necessárias para o segundo processamento (quando efetivamente será gerada a NF).


  • 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 Protheus já deverá ter sido gerada com várias sequências de maneira que seja possível efetuar o relacionamento 1 para 1.

 

Como fazer (opcional)


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


  • No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.


  • No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.


  • No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.


  • No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).


  • No Datasul consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.


  • No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.


  • No Datasul verificar se foi efetuado corretamente o relacionamento entre os dois documentos. Acessar o documento fiscal referenciado:


  • No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.


  • No Protheus efetuar o faturamento do pedido de venda recebido.


  • No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).


  • No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.


  • No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido 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 (WMS0745, WMS9745 e WMS6429) poderão ser consultadas pelo Monitor de Integração, rotina WMS80000. Nesta rotina também é possível reprocessar documentos que ficaram pendentes.

  • 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.




  • Caso necessite observar o XML enviado pelo Datasul, clique no símbolo da lupa onde será aberto o XML através do programa padrão definido no sistema operacional para este tipo de arquivo.

  • Caso uma transação falhe, é possível recolocá-la na fila clicando no botão Tentar novamente (). Caso deseje bloquear uma transação, clique no Botão Bloquear (). É possível também atualizar a lista de mensagens processadas através do botão Atualizar ().

  • Para realizar o monitoramento das transações no Logix acesse o programa EAI10000. Dentro dele acesse a opção Monitoramento -> Geral e realize a pesquisa:



  • Na lista de mensagens são exibidas a mensagem enviada (Type = "BusinessMessage") e a mensagem de resposta (Type = "Response)". Ao selecionar uma mensagem é exibido abaixo todo o seu conteúdo.

  • É possível também exportar o XML recebido utilizando para isso o botão "Exportar XML" que está na barra de tarefas.

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 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

WMS0745

WMS6196

SUP50100


O código do produto apresentado na DANFE de retorno simbólico emitida pelo Protheus não é o código do depositante, e sim o código interno.

Para que seja utilizado o código do item do depositante no momento da emissão, verificar as seguintes informações:

- O código de TES utilizado na geração do pedido de venda de retorno simbólico deve estar configurado como Poder Terc. = “D” (Devolução) e Atu.Estoque = “Sim”;

- O tipo de pedido registrado no Protheus deve ser como “Normal”;

- Deve existir o relacionamento Produto x Cliente cadastrado corretamente no Protheus, onde o cliente registrado deverá ser o depositante do produto.

WMS0745

Mensagem: “A quantidade informada para o retorno deste documento não está correta.”

Para que o retorno simbólico de mercadorias possa ser realizado corretamente, é necessário que a nota fiscal de remessa para armazenagem esteja devidamente registrada no Protheus. As principais características que este documento deve ter são:

- Tipo igual a “B” (Beneficiamento);

- O código de TES informado para os itens do documento estarem parametrizados como “R” (Remessa), o que faz com que as quantidades regularizadas tenham alimentado as tabelas de controle de terceiros do Protheus.

- O número do documento de entrada registrado no Protheus deve estar de acordo com o número da nota fiscal de armazenagem para a qual está sendo feito o retorno simbólico. No Protheus o número do documento não pode conter zeros à esquerda.

WMS6156

Mensagem: “Documento não encontrado”

Falta realizar a integração da nota fiscal de recebimento relacionada aos produtos que estão sendo regularizados. Para isto deve-se executar a rotina WMS6628 (Integração Nota Fiscal Recebimento – Inclusão).

WMS6156

Mensagem: “Campo obrigatório do cabeçalho da nota fiscal não preenchido”.

Verificar se o fornecedor registrado na nota fiscal de recebimento dos produtos está devidamente cadastrado no Protheus.

WMS0745

WMS6196

WMS6412

SUP50100

A TES utilizada no pedido de venda está incorreta.

Revisar os relacionamentos de/para das naturezas de operação parametrizadas no LOG00087 (Parâmetros do Sistema) com os Tipos de Entrada/Saída (TES) do Protheus. Estes relacionamentos são cadastrados no programa VDP10141 (De/Para Geral).

WMS0745

WMS6196

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).

WMS0745


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.

WMS0745

O número, série e data de emissão da nota fiscal de remessa por conta e ordem não estão sendo referenciados na nota fiscal de retorno simbólico.

Para que estas informações sejam geradas corretamente é necessário cadastrar o texto da nota fiscal de retorno simbólico com algumas variáveis, conforme abaixo:


Mercadoria remetida pela nossa nota fiscal  nr. @N série @S de @D para [NOME_DESTINATARIO] com estabelecimento a [ENDERECO_DESTINATARIO] em [CIDADE_DESTINATARIO], [UF_DESTINATARIO] – IE [IE_DESTINATARIO] e CNPJ [CNPJ_DESTINATARIO].

 

As variáveis @N, @S e @D serão substituídas pelo Protheus no momento da emissão da DANFE. Se referem número, série e data de emissão da nota fiscal de remessa por conta e ordem, respectivamente.


As variáveis delimitadas por colchetes são substituídas pelo próprio Logix.



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 Protheus você deve conseguir visualizar na lista de serviços o “FWWSEAI”. No WebService do Logix você deve conseguir visualizar na lista de serviços o “EAISERVICE”.
  • Faça o teste de comunicação entre os sistemas utilizando uma mensagem simples de cadastro (sugestão: Unidade de Medida). Faça o envio de um cadastro do Logix para o Protheus e do Protheus para o Logix.