INTEGRAÇÃO LOGIX X GFE
Gestão de Frete Embarcador (SIGAGFE) é um aplicativo desenvolvido sobre a plataforma TOTVS.
Utiliza o framework de funcionalidades do Microsiga Protheus e tem como objetivos funcionais:
Os Cadastros e Processos que são sincronizados e integrados entre os sistemas, na direção do Logix para o SIGAGFE são:
Logix | SIGAGFE | |
---|---|---|
Cadastros | Fornecedores/Transportadores/Clientes | Emitentes |
Embalagens | ???? | |
Cidades | ???? | |
Processos | Emissão de nota fiscal de saída | ???? |
Os Processos realizados dentro do SIGAGFE e que tem informações enviadas aos módulos do Logix são:
SIGAGFE | Logix | |
---|---|---|
Processos | Documentos Fiscais | Documentos de Frete de Vendas |
Simulação de frete simplificada | Simulação de frete de venda | |
Desenvolvida integração que tem por objetivo permitir aos clientes Logix (BackOffice) o uso do sistema especialista para Gestão de Frete Embarcador.
A arquitetura utlizada para a integração é a mensageria única/EAI2 na maioria das integrações e REST especificamente na integração do cálculo da simulação do frete pelo GFE na rotina de Pedidos e Faturamento Logix.
Envio de dados do Logix para o GFE
Para a sincronização de cadastros e movimentos originados no ERP são associados os Adapters da Mensagem Única nas interfaces do cadastro no ERP.
As principais ações (inclusão, alteração, eliminação) permitindo assim replicação para a base de dados do TOTVS SIGAGFE e ficando os cadastros iguais em ambos os lados.
Também é possível uma carga inicial de dados através de rotina que permite o envio de toda a massa de dados, ou através de filtros (FIN00000).
Recebimento de dados do GFE no Logix
Para a integração dos documentos registrados no TOTVS GFE para o ERP é utilizada uma rotina de execução contínua do próprio EAI2, essa rotina monitora a entrada de XMLs das mensagens únicas mapeadas para recebimento no ERP Logix.
O controle dos dados que estão aptos para integração é efetuado pelo Monitor de integração (EAI10000).
Cada Adapter utiliza as rotinas de negócio do Logix para processar os dados; ao final de cada processamento interage novamente com o TOTVS SIGAGFE para atribuir o retorno: Sucesso ou Erro.
Liberação oficial: release 12.1.19 e posteriores.
EAI2/Mensageria única instalado e configurado.
Insira aqui as informações pertinentes ao Protheus.
Configuração das transações do EAI Logix:
Executar o programa EAI10000 (Monitor EAI)
Mensagem\Transação | Versão |
CustomerVendor | 2.000 |
Invoice | 3.011 |
City | 1.000 |
Packaging | 1.000 |
Parâmetros Gerais (LOG00087)
Os parâmetros abaixo fazem parte desta integração e devem ser devidamente atualizados antes da utilização:
Parâmetro | Objetivo |
CT-e sobre NF de vendas será tratado pelo GFE? (gfe_cte_venda) | Indica se CT-e sobre NF de vendas será tratado pelo GFE(Gestão de Frete Embarcador) e depois integrado ao Logix. OBS: Sim/Não (Alterar para S para habilitar a integração). |
Grupo de despesa padrão para inclusão do conhecimento de frete VIA GFE (grupo_desp_frete_gfe) | Parâmetro é opcional, se não informado considera: 1- O grupo de despesa que veio na mensagem Invoice via integração; 2- Ou se o primeiro não tiver sido informado considera o grupo de despesa padrão para frete de venda. LOG00087: 'Grupo de despesa a ser utilizado nos fretes de venda incluídos pelo SUP0580, SUP9220 e SUP0552.(grp_desp_frete_venda). OBS: Somente permite informar um grupo de despesa cadastrado no Logix. |
Condição de pagamento sem pagamento para recebimento de CTE (cond_pgto_cte_sem_pgto) | Indica a condição de pagamento a ser sugerida para preenchimento automático da condição de pagamento, pois o conhecimento de frete não terá pagamento. OBS: Somente permite informar uma condição de pagamento cadastrada no Logix. |
Conhecimento venda integrado GFE pode sofrer modificações no Logix? (ies_conhec_gfe_altera) | Indica se quando trabalhar com integração do Logix com o GFE permitirá incluir, alterar ou excluir um frete de vendas no Logix. 1 - Alerta (No sup0580 ao tentar incluir um conhecimento de nota de venda irá alertar que trabalha com integração com GFE e inclusão deveria ser realizada no GFE. Ainda no sup0580, ao tentar modificar ou excluir um conhecimento de notas ficais de venda, alerta o usuário que o frete foi integrado via GFE e a alteração ou exclusão deveria ser realizada no GFE). 2- Trava (No sup0580 ao tentar incluir um conhecimento de nota de venda irá bloquear a inclusão, avisando que existe a integração com GFE e inclusão deve ser realizada no GFE. Ainda no sup0580, ao tentar modificar ou excluir um conhecimento de notas ficais de venda, bloqueia a transação e avisa ao usuário que o frete foi integrado via GFE e a alteração ou exclusão deverá ser realizada no GFE). 3- Permite Incluir Modificar ou Excluir Conhecimento( No sup0580 mesmo que esteja com a integração GFE ligada irá permitir incluir, modificar ou excluir qualquer conhecimento de frete, sem exibir aviso em tela). |
Assume automaticamente erros do frete recebido via integração GFE? (assu_auto_erro_integ_fret_gfe) | Indica se assume automaticamente os erros na consistência do frete, recebido via integração GFE. OBS: Sim/Não (Alterar para S para habilitar a integração). |
Diretório XML Frete/Venda quando empresa trabalha com integração GFE (diretorio_gfe_cte_v) | Caso empresa trabalhar com integração do Logix com GFE (Gestão do Frete Embarcador) e os fretes de venda são tratados pelo GFE, então no JOB de Recebimento de XML de Nota/Frete no TOTVS Colaboração irão mover os XML's que forem de frete relacionado a nota fiscal de venda para este diretório. Posteriormente o Gfe irá buscar estes XMLs deste diretório e importar no módulo para cálculos e tratamentos do frete. |
Utilizar integração com o GFE - Gestão de Frete Embarcador? (utiliza_integracao_gfe) | Indica se utiliza integração com o produto Gestão de Frete Embarcador (GFE) para simulação, cálculo e controle do frete no processo saídas. |
Servidor e porta para requisições dos serviços REST do módulo de GFE. (servidor_de_servicos_rest_gfe) | Informar o IP do servidor e porta para realização das requisições dos serviços REST disponíveis para integração entre o produto Logix e o módulo do GFE (Gestão de Frete Embarcador). |
Relacionamento De/Para de Empresa/Filial:
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 LOG00083 (Cadastro de Empresas).
Nota: Para que estes campos possam ser informados é necessário ativar o parametro “Permite informar empresa/filial externa no cadastro de empresas?”, no LOG00087.
Totvs Colaboração
Como a recepção do frete de venda é realizada diretamente no GFE o mesmo é desviado da recepção via Totvs Colaboração no Suprimentos/Logix.
Para isso é feito um desvio, e são movidos os XMLs do frete de venda para o diretório parametrizado no LOG00087: "Diretório XML Frete/Venda quando empresa trabalha com integração GFE".
Posteriormente o GFE irá buscar estes XMLs deste diretório e importar no Protheus SIGAGFE para cálculos e tratamentos do frete e após então o Conhecimento é enviado e integrado ao Logix.
Tratamentos no ERP
Insira aqui as informações pertinentes ao Protheus.
O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Logix e Protheus SIGAGFE estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Método | ID | Descrição | Origem | Destino | XSD (versões podem variar) |
Cadastros | 01 | Cliente/Fornecedor/Transportador | Logix | Protheus | CustomerVendor_2_000.xsd |
02 | Embalagem | Logix | Protheus | Packaging_1_000.xsd | |
03 | Cidades | Logix | Protheus | City_1_000.xsd | |
Processos | 01 | Documento de Frete de Venda | Protheus | Logix | Invoice_3_011.xsd |
02 | Nota fiscal de saída | Logix | Protheus | Invoice_3_011.xsd | |
03 | Simulação de frete de venda | Protheus | Logix | API REST |
A seguir temos as rotinas responsáveis pelos cadastros das informações da integração:
ID | Descrição | Origem | Destino | XSD |
---|---|---|---|---|
01 | Fornecedor/Transportador | Logix | Protheus | CustomerVendor_2_000.xsd |
02 | Cliente | Logix | Protheus | CustomerVendor_2_000.xsd |
03 | Cidade | Logix | Protheus | City_1_000.xsd |
04 | Embalagem | Logix | Protheus | Packaging_1_000.xsd |
Ao executar o programa FIN00000 (Programas conversores), usuário poderá fazer a carga inicial dos cadastros:
Identificador da Mensagem: CustomerVendor
Versão: 2
Tipo de Envio: Síncrona
Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de Cliente/Fornecedor no programa VDP10000, irá gerar mensagem única, enviada para o Protheus.
Mensagem Padrão | PROTHEUS | LOGIX | ||
Tabela | Campo | Tabela | Campo | |
Code | fornecedor | cod_fornecedor | ||
ShortName | fornecedor | raz_social_reduz | ||
Name | fornecedor | raz_social | ||
Type = "Vendor" | ||||
EntityType= "Person"/"Company" | ||||
RegisterDate | fornecedor | dat_cadast | ||
RegisterSituation= "Active"/"Inactive" | fornecedor | ies_fornec_ativo | ||
GovernmentalInformation/Id scope="Federal" name="CNPJ" issueOn="0001-01-01" expiresOn="9999-12-31" | fornecedor | num_cgc_cpf | ||
GovernmentalInformation/Id scope="State" name="Inscricao Estadual" issueOn="0001-01-01" expiresOn="9999-12-31" | fornecedor | ins_estadual | ||
GovernmentalInformation/Id scope="Municipal" name="Inscricao Municipal" issueOn="0001-01-01" expiresOn="9999-12-31" | fornec_compl | ins_municipal | ||
GovernmentalInformation/Id scope="Federal" name="Inscricao Pis" issueOn="0001-01-01" expiresOn="9999-12-31" | sup_par_fornecedor onde empresa = 'SE' e parametro = "num_inscr_inss_2" | parametro_texto | ||
GovernmentalInformation/Id scope="Federal" name="NIF" issueOn="0001-01-01" expiresOn="9999-12-31" | sup_par_fornecedor onde empresa = 'SE' e parametro = "num_ident_fiscal" | parametro_texto | ||
Address/Address | fornecedor | end_fornec | ||
Address/Number | vdp_cli_fornec_cpl | num_iden_lograd | ||
Address/Complement | vdp_cli_fornec_cpl | compl_endereco | ||
Address/City/CityCode | obf_cidade_ibge (Origem=fornecedor) | cidade_ibge/(Origem=cod_cidade) | ||
Address/City/CityDescription | cidades | den_cidade | ||
Address/District | fornecedor | den_bairro | ||
Address/State/StateCode | cidades | uni_feder | ||
Address/State/StateDescription | uni_feder | den_uni_feder | ||
Address/Country/CountryCode | uni_feder | cod_pais | ||
Address/Country/CountryDescription | paises | den_pais | ||
Address/ZIPCode | fornecedor | cod_cep | ||
Address/InternationalDiallingCode | vdp_cli_parametro onde parametro = "ddi_telefone_eai" | texto_parametro | ||
Address/DiallingCode | vdp_cli_parametro onde parametro = "ddd_telefone_eai" | texto_parametro | ||
ListOfCommunicationInformation/CommunicationInformation/PhoneNumber | fornecedor | num_telefone | ||
ListOfCommunicationInformation/CommunicationInformation/FaxNumber | fornecedor | num_fax | ||
ListOfCommunicationInformation/CommunicationInformation/Email | fornec_compl | endereco_web | ||
ListOfBankingInformation/BankingInformation/BankCode | agencia_bco | cod_agen_bco | ||
ListOfBankingInformation/BankingInformation/BankName | bancos | nom_banco | ||
ListOfBankingInformation/BankingInformation/BranchCode | fornecedor | num_agencia | ||
ListOfBankingInformation/BankingInformation/BranchKey | fornecedor | num_agencia | ||
ListOfBankingInformation/BankingInformation/CheckingAccountNumber | fornecedor | num_conta_banco | ||
ListOfBankingInformation/BankingInformation/CheckingAccountNumberKey | fornecedor | num_conta_banco | ||
VendorInformation/VendorType/Code | fornecedor | ies_tip_fornec | ||
ListOfBankingInformation/BankingInformation/VendorTypeDescription= Fornecedor, Transportador, Cliente, Fornecedor/Cliente, Fornecedor/Transportador, Produtor Rural, Prestador de Serviço, Município, Cooperado, Microempreendedor individual. | ||||
Limitações/Restrições
Identificador da Mensagem: CustomerVendor
Versão: 2
Tipo de Envio: Síncrona
Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de Cliente/Fornecedor no programa VDP10000, irá gerar mensagem única, enviada para o GFE.
Tag(*) | Descrição | Origem da Informação - Logix | Destino - GFE | ||||||||||||||||||||||||
_Code | Código do cliente | CLIENTES.cod_cliente | |||||||||||||||||||||||||
_ShortName | Nome reduzido do cliente | VDP_CLI_FORNEC_CPL.razao_social_reduz | |||||||||||||||||||||||||
_Name | Nome do cliente | VDP_CLI_FORNEC_CPL.razao_social | |||||||||||||||||||||||||
_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:
| 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 | |||||||||||||||||||||||||
_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) conforme parâmetro "Máscara do código da cidade IBGE na mensagem de integração vai EAI" no LOG00087 | |||||||||||||||||||||||||
_Address._City._Description | Nome da cidade do cliente | CIDADES.den_cidade | |||||||||||||||||||||||||
_Address._District | Bairro do cliente | VDP_CLI_FORNEC_CPL.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) conforme parâmetro "Máscara do código da cidade IBGE na mensagem de integração vai EAI" no LOG00087 | |||||||||||||||||||||||||
_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 | |||||||||||||||||||||||||
_ListOfCommunicationInformation. _FaxNumber | Número do fax do cliente | CLIENTES.num_fax | |||||||||||||||||||||||||
_ListOfCommunicationInformation. _HomePage | Home (site) do cliente | VDP_CLI_FORNEC_CPL.endereco_web | |||||||||||||||||||||||||
_ListOfCommunicationInformation. _Email | Email principal do cliente | VDP_CLI_FORNEC_CPL.correio_eletronico | |||||||||||||||||||||||||
_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) conforme parâmetro "Máscara do código da cidade IBGE na mensagem de integração vai EAI" no LOG00087 | |||||||||||||||||||||||||
_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 da mensagem;
(**) Nos casos de registros do tipo “Ambos” (onde uma empresa é cliente e fornecedor ao mesmo tempo), o Logix enviará duas mensagens para o GFE, uma com o tipo “Customer” e outra com o tipo “Vendor”.
Identificador da Mensagem: City
Versão: 1
Tipo de Envio: Síncrona
Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de UF e Cidades (VDP10022) , irá gerar mensagem única, enviada para o GFE.
Tag | Descrição | Origem da Informação - Logix | Destino - GFE |
_Code | Código da cidade | OBF_CIDADE_IBGE.cidade_logix | |
_OfficialCode(*) | Código oficial da cidade (IBGE) | OBF_CIDADE_IBGE.cidade_ibge Obs: Conforme parâmetro "Máscara do código da cidade IBGE na mensagem de integração vai EAI" no LOG00087 | |
_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 (VDP10022), quando esta mensagem estiver habilitada para envio.
Identificador da Mensagem: Packaging
Versão: 1
Tipo de Envio: Síncrona
Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de Embalagens (VDP10026) , irá gerar mensagem única, enviada para o GFE.
Tag | Descrição | Origem da Informação - Logix | Destino - GFE |
_Code | Código da embalagem | EMBALAGEM.cod_embal | |
_Description | Descrição da embalagem | EMBALAGEM.den_embal | |
_Weight | Peso da embalagem | EMBALAGEM.pes_unit | |
_Height | Altura da Embalagem | EMBALAGEM.altura | |
_Width | Largura da embalagem | EMBALAGEM.largura | |
_Depth | Profundidade da embalagem | EMBALAGEM.profundidade | |
_Volume | Volume da embalagem | EMBALAGEM.volume |
A seguir temos os processos que transitam entre os produtos na integração:
ID | Descrição | Origem | Destino | XSD |
---|---|---|---|---|
01 | Conhecimento de frete de Venda | Protheus | Logix | Invoice_3_011.xsd |
02 | Nota fiscal de saída | Logix | Protheus | Invoice_3_011.xsd |
03 | Simulação de frete de venda | |||
04 |
Identificador da Mensagem: Invoice
Versão: 3
Tipo de Envio: Assíncrona
Ao receber a Invoice no Logix com tag indicando que trata-se de um conhecimento de venda (TypeofDocument = "COV") é acionado Adapter EaiAdapterInvoice3.
Este irá incluir ou excluir (de acordo com o tipo de processamento enviado) através de métodos padrões do ERP o conhecimento de frete de venda no Logix.
Para conferir se a integração ocorreu com sucesso pode-se utilizar a consulta do Status e Passo-a-passo no Monitor de integração do EAI: EAI100000.
Para validar o documento no ERP utilizar o programa Sup0580.
Mensagem Padrão | PROTHEUS | LOGIX | ||
Tabela | Campo | Tabela | Campo | |
CompanyId | frete_sup | cod_empresa | ||
InvoiceNumber | frete_sup | num_conhec | ||
InvoiceSerie | frete_sup | ser_conhec | ||
InvoiceModel | sup_compl_fret_sup | reservado | ||
TypeOfDocument = "COV" | frete_sup | ies_tip_frete = "V" | ||
VendorCode | frete_sup | cod_transpor | ||
IssueDate | sac_embarque | dat_entrega | ||
InvoiceAmount | frete_sup | val_frete | ||
InsuranceAmount | sup_par_frete onde parametro = "val_seguro_frt" | parametro_texto | ||
PaymentConditionCode | frete_sup | cnd_pgto_frt | ||
PaymentConditionCode | frete_sup | cnd_pgto_tab | ||
TaxOpCode | frete_sup | cod_fiscal_frete | ||
TaxOperationCodeComplement | frete_sup | cod_fiscal_compl | ||
GrossWeight | frete_sup | pes_vol_frete | ||
ElectronicAccessKey | sup_par_frete onde parametro = "num_ft_eletronica" | parametro_texto | ||
ElectronicProtocol | sup_par_frete onde parametro = "chave_acesso_cte" | parametro_texto | ||
ElectronicKeyJustification | sup_par_frete onde parametro = "justif_chave_cte | parametro_texto | ||
ElectronicKeyJustification | obf_justif_cte_sefaz | justificativa | ||
TollValue | pedagio_frete | val_pedagio | ||
ListofRelatedInvoices/RelatedInvoices/InvoiceNumber | frete_sup_x_nff | num_nff | ||
ListofRelatedInvoices/RelatedInvoices/InvoiceSerie | frete_sup_x_nff | ser_nf_saida | ||
ListofRelatedInvoices/RelatedInvoices/InvoiceDateIssue | frete_sup_x_nff | dat_hr_emis_nota_fiscal_fatura | ||
ItemExpenseGroupCode | frete_sup | gru_ctr_desp_frete | ||
ListofItens/Item/ListofTaxes/Taxe = "ICMS" | ||||
ListofItens/Item/ListofTaxes/CalculationBasis | frete_sup | val_base_c_frete_c | ||
ListofItens/Item/ListofTaxes/Value | frete_sup | val_tot_icms_frt_c | ||
ListofItens/Item/ListofTaxes/Taxe = "RETEN_INSS" | ||||
ListofItens/Item/ListofTaxes/CalculationBasis | sup_par_frete onde parametro = "bc_retencao_inss" | parametro_val | ||
ListofItens/Item/ListofTaxes/Percentage | sup_par_frete onde parametro = "perc_reten_inss" | parametro_val | ||
ListofItens/Item/ListofTaxes/HasTax | sup_par_frete onde parametro = "RETEN_INSS" | par_ind_especial | ||
ListofItens/Item/ListofTaxes/Taxe = "RECOLH_INSS" | ||||
ListofItens/Item/ListofTaxes/CalculationBasis | sup_par_frete onde parametro = "bc_recolhimento_inss" | parametro_val | ||
ListofItens/Item/ListofTaxes/HasTax | sup_par_frete onde parametro = "RECOLHIMENTO_INSS" | par_ind_especial | ||
ListofItens/Item/ListofTaxes/Taxe = "RETEN_ISS" | ||||
ListofItens/Item/ListofTaxes/HasTax | sup_par_frete onde parametro = "RETEN_ISS" | par_ind_especial | ||
ListofItens/Item/ListofTaxes/Taxe = "RETEN_SEST_SENAT" | ||||
ListofItens/Item/ListofTaxes/HasTax | sup_par_frete onde parametro = "RETEN_SEST_SENAT" | par_ind_especial | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/AccountantAcountInternalId | dest_frete_sup | num_conta_deb_desp | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/ProjectInternalId | dest_frete_sup | cod_area_negocio | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/SubProjectInternalId | dest_frete_sup | cod_lin_negocio | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/Percentual | dest_frete_sup | pct_particip_comp | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/AccountantAcountInternalId | dest_frete_sup4 | num_conta_deb_desp | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/ProjectInternalId | dest_frete_sup4 | cod_area_negocio | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/SubProjectInternalId | dest_frete_sup4 | cod_lin_negocio | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/MarketSegmentCode | dest_frete_sup4 | cod_seg_merc | ||
ListofItens/Item/ListofApportionInvoiceItem/ApportionInvoiceItem/ClassValueCode | dest_frete_sup4 | cod_cla_uso | ||
ShippingAddress/City/CityCode | frete_sup_compl | cod_cidade |
Identificador da Mensagem: Invoice
Versão: 3
Tipo de Envio: Assíncrona
Gatilho: Sempre que realizado o envio de uma nota fiscal de saída para a SEFAZ, após a geração da chave de acesso será feito o envio da nota fiscal via mensagem única (EAI2) para o GFE.
Quando a nota fiscal possuir tipo de frete diferente de 3 (FOB) será adicionado o contexto "gfe" na mensagem. Dessa forma é possível parametrizar no EAI10000 (EAI) apenas o envio de notas fiscais com frete para o GFE, utilizando-se do conceito de "rotas".
Tag(*) | Descrição | Origem / Destino da Informação |
_CompanyId | Código da empresa | FAT_NF_MESTRE.empresa |
_InvoiceNumber | Número da nota fiscal | FAT_NF_MESTRE.nota_fiscal |
_InvoiceSerie | Série da nota fiscal | FAT_NF_MESTRE.serie_nota_fiscal |
_InvoiceModel | Modelo da Nota Fiscal (Convênio ICMS 31/99) | FAT_NF_MESTRE.modelo_nota_fiscal |
_InvoiceSituation | Situação da Nota Fiscal (1-Normal 2-Cancelada) | FAT_NF_MESTRE.sit_nota_fiscal |
_TypeOfDocument | Tipo do documento (Controle da natureza de operação) | NAT_OPERACAO.ies_tip_controle |
_IssueDate | Data de Emissão | FAT_NF_MESTRE.dat_hor_emissao |
_InvoiceAmount | Valor da Nota Fiscal | FAT_NF_MESTRE.val_nota_fiscal |
_ValueofGoods | Valor da Mercadoria | FAT_NF_MESTRE.val_mercadoria |
_FreightAmount | Valor do frete | FAT_NF_MESTRE.val_frete_rodov |
_InsuranceAmount | Valor do Seguro | FAT_NF_MESTRE.val_seguro_rodov |
_DiscountAmount | Valor do Desconto | FAT_NF_MESTRE.val_desc_nf |
_CurrencyRate | Taxa da Moeda Utilizada para Calcular o Valor da Nota Fiscal | COTACAO.val_cotacao (ou PED_INF_COM_MESTRE.val_cotacao_fixa caso informada cotação fixa no pedido) |
_CustomerCode | Código do Cliente | FAT_NF_MESTRE.cliente |
_CarrierCode | Código do Transportador | FAT_NF_MESTRE.transportadora |
_ElectronicAccessKey | Chave de acesso eletrônica | OBF_NF_ELETR.chave_acesso |
_ListOfItems. _InvoiceSequence | Sequência do item da nota fiscal | FAT_NF_ITEM.seq_item_nf |
_ListOfItems. _OrderNumber | Número do Pedido que Originou o Item da Nota | FAT_NF_ITEM.pedido |
_ListOfItems. _OrdemItem | Sequência do Item do Pedido que Gerou o Item da Nota | FAT_NF_ITEM.seq_item_pedido |
_ListOfItems. _ItemCode | Código do item | FAT_NF_ITEM.item |
_ListOfItems. _Quantity | Quantidade do Item | FAT_NF_ITEM.qtd_item |
_ListOfItems. _UnitofMeasureCode | Código da Unidade de Medida | FAT_NF_ITEM.unid_medida |
_ListOfItems. _UnityPrice | Preço Unitário do Item x Taxa da Moeda | FAT_NF_ITEM.preco_unit_bruto |
_ListOfItems. _GrossValue | Valor Bruto do Item. (Quantidade x Preço Unitário x Taxa da Moeda) | FAT_NF_ITEM.preco_unit_liquido |
_ListOfItems. _FreightValue | Valor do Frete Unitário | FAT_NF_ITEM.val_frete_cliente |
_ListOfItems. _InsuranceValue | Valor do Seguro Unitário | FAT_NF_ITEM.val_seguro_cliente |
_ListOfItems. _DiscountValue | Valor do Desconto Unitário | FAT_NF_ITEM.val_desc_item |
_ListOfItems. _NetValue | Valor Líquido (Valor Bruto + Frete + Seguro - Desconto) | FAT_NF_ITEM.val_contab_item |
_ListOfItems. _AreAndLineOfBusinessCode | Código da área e linha. No Logix será uma string que poderá ter 4 (área/linha de negócio com 2 níveis) ou 8 caracteres (área/linha de negócio com 4 níveis). Os campos serão concatenados sem separador, respeitando a sequencia da chave da tabela "linha_prod". | (FAT_AEN_ITEM_NF.linha_produto + FAT_AEN_ITEM_NF.linha_receita + FAT_AEN_ITEM_NF.segmto_mercado + FAT_AEN_ITEM_NF.classe_uso) ou (ITEM.cod_lin_prod + ITEM.cod_lin_recei + ITEM.cod_seg_merc + ITEM.cod_cla_uso) |
_ListOfItems. _ItemGrossWeight | Peso total do item mais o peso rateado das embalagens da nota fiscal que estão relacionadas ao item. Peso em Kg | N/A |
_ListOfItems. _ItemNetWeight | Peso liquído total do item em Kg | N/A |
_ListOfItems. _ItemVolume | Volume total do item em metros cúbicos, considerando as embalagens relacionadas ao item na nota fiscal | N/A |
_ListOfItems. _ItemDescription | Descrição do item | FAT_NF_ITEM.des_item |
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 da mensagem.
Os passos para viabilizar a integração são:
Exemplo:
Erro ao enviar a mensagem de Cidade via Integração
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.