Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Ir para o início dos metadados

1. Integração de

...

Credito de Devolução (AccountReceivebleDocument e AccountReceivableDocumentDisCharge) Protheus x Gemco

       Nesta integração de reservade crédito de devolução(AccountReceivableDocument), o sistema Protheus recebe envia uma mensagem padronizada de ItemReserve enviada pelo sistema Gemco.AccountReceivableDocument com cliente indentificado para gerar credito no sistema Gemco.

     Nesta integração de utilização de crédito de devolução(AccountReceivableDocumentDischarge), o sistema Protheus recebe uma mensagem padronizada de AccountReceivableDocumentDistarge com cliente indentificado para baixar o saldo do Cliente no sistema Protheus

2. Fluxo das Mensagens

AccountReceivableDocument

Produto

Fluxo

Tipo da Mensagem

Versão MSU

Formato

GEMCO

Recebe

Assíncrona

1.000 (link da api.totvs.com)

Json/XML

Protheus

Envia

Assíncrona

1.000 (link da api.totvs.com)

XML


Image Added


AccountReceivableDocumentDischarge

Produto

Fluxo

Tipo da Mensagem

Versão MSU

Formato

GEMCO

Envia

Assíncrona

1.000 (link da api.totvs.com)

Json/XML

Protheus

Recebe

Assíncrona

1.000 (link da api.totvs.com)

XML

Image RemovedImage Added


2.1 Protheus

         a. Pré-Condição   


Produto:

Microsiga Protheus

DbAcess

Versão XYZ

AppServer

LoboGuará

Build

XYXW

Sistema Operacional

Windows 10

Banco de Dados

SqlServer/Oracle


         b. Descrição do Processo

Os Pedidos Os créditos de Venda devolução serão incluídos no sistema Gemco, será enviada uma mensagem de ItemReserve gerando uma reserva para os produtos no sistema Protheus através de comunicação de Mensagem Única.

Para esta integração é necessário todos os atributos de chaveamento no XML a serem importados para o Protheus quanto à funcionalidade de geração de reserva, tabela "SC0".

Em outro momento, será enviado pelo sistema Gemco uma integração de venda RetailSales para o sistema Protheus através de comunicação de Mensagem Única, nesta mensagem, deverá ser informado na Lista de Produtos a informação da reserva relacionada a este, reserva que foi incluída pela integração ItemReserve, poderão ser utilizadas as tags: ItemReserveInternalId (InternalId da reserva integrada pela integração ItemReserve) ou então, ItemReserveCode (Código da reserva gerada no Protheus), será priorizada a tag ItemReserveInternalId.

Após o recebimento desta mensagem, será realizada no sistema Protheus o processo de explosão da venda para geração do  BackOfficce, chamado de GravaBatch, nesse momento, a reserva será finalizada e estoque atualizado.

 Procedimento para Verificação dos XML:

  1. Após o recebimento do xml do ItemReserve no Protheus, acesse e o Configurador (SIGACFG), Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
  2. O sistema Protheus apresenta De-Para das integrações com o Sistema Gemco. 
  3. Localize o campo Alias com conteúdo SC0.
  4. Verifique através dos campos Valor Externo que é a chave da Gemco e Valor Interno que é a chave Protheus.

Image Removed

...

criados no sistema Protheus e integrados ao sistema Gemco através da mensagem padronizada de AccountReceivabledocument. Para utilização dos créditos criados, o sistema Gemco

deve enviar uma mensagem padronizada de AccountReceivableDocument com o valor da baixa e o cliente identificado. Para estorno dos créditos utilizado o sistema Gemco deve enviar uma mensagem padronizada de AccountReceivableDocumentDischarge indentificando na tag "Operation" da mensagem o tipo da operação com o valor "REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE" e as tags "InternalId" e "AccountReceivableDocumentInternalId" devem conter o mesmo valor exemplo: "40|1|265|00|2"

b. Descrição do Processo

  1. Acesse no Controle de Lojas (SIGALOJA) acesse Atualizações / Gerencia de Financas / Contas a Receber (FINA040).
  2. Clique em Incluir.
  3. O campo Tipo deve estar preenchido como NCC, e a Natureza deve estar preenchido como NOTA DE CR.
    Importante: Ao cadastrar um Adapter AccountReceivableDocument em SIGACFG > Ambiente > Schedule > Adapter E.A.I. (CFGA020), caso queira realmente exportar/importar somente NCC em Contas a Receber via Mensagem Única, favor configurar, no campo Condição, a seguinte expressão: ALLTRIM(SE1→E1_TIPO) == "NCC". Caso optar por exportar todos os títulos de Contas a Receber, favor deixar em branco.
  4. Preencha as informações obrigatórias e clique em Salvar.

    Image Added


Após efetuar a gravação, será realizada a integração do titulo do sistema Protheus para o sistema Gemco.

Observação:

          Consullte o status da  mensagem de Títulos a Receber - AccountReceivableDocument, através do monitor EAI. Para mais detalhes, acesse o link Status de Mensagens EAI

...

Legendas:

           Status das mensagens no EAI Protheus

           Atualmente, existem 7 status disponíveis para uma mensagem na fila do EAI Protheus:

Image RemovedAguardando execução - A mensagem está na fila do EAI e ainda não começou a execução (o seu envio ou o seu processamento pelo adapter);

Image RemovedExecutando - A mensagem está sendo enviada para o sistema integrado ou a mensagem recebida está sendo processada;

Image RemovedFinalizada - A mensagem foi processada sem erros ou foi enviada sem erros;

Image RemovedFalhou - Houve um erro no envio da mensagem ou no seu recebimento;

Image RemovedBloqueado - A mensagem foi bloqueada para execução pelo usuário;

Image RemovedNão entregue - A mensagem não foi enviada para o destino (ou ainda, ocorreu um erro por time-out e não foi possível definir se a mensagem foi recebida e processada);

Image RemovedRecusada - A mensagem foi recusada por conter divergências entre a mensagem e o seu XSD.

Image Removed

Processo de Pedido de Venda     

1.  Realizar um Pedido de Venda no Gemco

2 . Após o processo de Pedido de Venda é enviado o XML para reserva de produto no Protheus, através deste você pode identificar o número da reserva que será integrada no Protheus.

         3. No Faturamento (SIGAFAT) acesse  Atualizações / Pedidos / Controle de Reservas.

                  4. Observe a reserva integrada:

Image Removed

Image Removed

 

Processo de Vendas e baixa da reserva     

1.  Realizar uma venda no Gemco, podendo ser Cupom Fiscal / NFC-e ou SAT;

2 . Após o processo de venda é enviado o XML para o Protheus, através deste você pode identificar o número da venda que será integrada no Protheus, ressaltando que este processo é opcional pois a venda integrada mesmo sem a consulta, o processo de identificação está descrito no início deste documento;

         3. No Controle de Lojas (SIGALOJA) acesse  Atualizações / Atendimento / Venda Assistida.

                  4. Observe o cupom de venda integrado:

Image Removed

Image Removed

Pressionar a tecla F8 para verificar a reserva relacionada ao produto:

Image Removed

5. No Faturamento (SIGAFAT) acesse  Atualizações / Pedidos /  Controle de Reservas.

6. Observe que a reserva 000025 não é exibida pois foi finalizada:

Image Removed

Image Removed

2.2 Gemco

              a. Pré-Condição

Produto:

Mozart

Versão

5.1.0.1

Browser

Firefox/Google Crome/IE

Sistema Operacional

Windows Server

Banco de Dados

SqlServer

Observação: Para mais detalhes da configuração do Mozart acesse o link Mozart EAI

Produto:

Gemco

Build

120 SP13

Sistema Operacional

Windows XP, 7, 10

Banco de Dados

SqlServer/Oracle

                b. Descrição do Processo

No Gemco para enviar uma reserva de produtos para o Protheus basta apenas fazer um pedido de venda de qualquer tipo (RetiraEntrega ou Retira Posterior). Abaixo segue passo a passo do fluxo de geração de reserva.

Image Removed

Assim que o pedido de venda é gerado no gemco, o status da integração pode ser acompanhado pelo Mozart EAI.

As imagens abaixo, mostram os passo status que a reserva pode receber em um cenário de dados ok.

Image Removed Image Removed Image Removed

Significado dos status dos processos(Status de integração) do Mozart :

AguardandoProcessamento : Mozart mostra a quantidade de processos especificos por exemplo (Reserva) estão aguardando na fila para serem executados.

Processando : Significa que após aguardar na fila o arquivo é envidado para ser processado.

Processado : Significa que o arquivo foi processado com sucesso, como por exemplo, enviou uma reserva para o Protheus e o mesmo retorno uma mensagem de sucesso. 

AguardandoCallback : Significa que o Mozart EAI enviou uma mensagem de ItemReserve contendo os dados do pedido para ser reservado as mercadorias pelo Protheus e está aguardando retorno.

Erro : Significa que receberá o log de erro da integração especifica, tanto ao tentar enviar quanto AguardoCallback com retorno de erro.

Assim que a reserva é feita no Protheus, o mesmo envia uma mensagem de estoque atualizando os estoque dos produtos da reserva no Gemco

Image Removed

...

Os Títulos a Receber serão gerados no sistema Protheus e deverão ser integrados através da comunicação de Mensagem Única.

Procedimento para Utilização

Pré-requisitos:

  • Configuração Mozart
  • Cadastro De/Para Eventos Contas a Receber
  • Configuração do adapter AccountReceivableDocument. Para detalhes, clique aqui
    Importante (informação)
  1. Configuração Mozart
    Exemplo do arquivo de configuração do Mozart “configuracao.json” com as informações da Operação de Crédito de Devolução:
    Image Added

    Exemplo do comando SQL para inclusão da Operação de Crédito de Devolução nas tabelas do Mozart:
    Image Added


  2. Configurações Gemco
    Cadastros manuais de DePara
    Exemplo do Evento do Contas a Receber

    Image Added

    SISTEMA_INT: Código do Sistema Protheus, vem na tag SourceApplication.

    COD_INT: Código do Evento do Contas a Receber no Protheus.

    CODEVECRC: Código do Evento do Contas a Receber no Gemco.

    CODORIGCRC: Código de Origem do Contas a Receber no Gemco.

    PROCESSO:


    • 0 - AccountReceivableDocument

    • 1 - AccountReceivableDocumentDischarge

    • 2 - ReversalAccountReceivableDocument

3. Processos Relacionados

...