Versão 6.04 Novembro/2013

Transcrição

1 Versão 6.04 Novembro/2013 Integração ERP Pirâmide X Bionexo Doc-To-Help Standard Template Sumário i

2 ii Introdução Doc-To-Help Standard Template

3 Sumário Introdução 1 A Integração entre Pirâmide e Bionexo... 1 Escopo da Integração 3 Visão Geral... 3 A integração entre o Bionexo e o Pirâmide ERP... 3 Compatibilidade... 4 Ativação 5 Ativando a Integração entre Pirâmide e Bionexo... 5 Configurações Gerais... 5 É necessário fazer a compilação das packages PCK_PIR_XML.pck, PCK_PIR_COTACAO_XML.pck e PCK_PIR_PEDIDO_CMP_XML.pck no banco Oracle. Este deverá estar na versão 10g ou versões posteriores Configurações no Pirâmide... 5 Operações 11 Fluxo das Operações entre Pirâmide e Bionexo Parâmetros Solicitação de Compras Cotação dos Itens Geração de Fornecimento Confirmação do Pedido Cancelamento da Autorização de Fornecimento Doc-To-Help Standard Template Sumário iii

4

5 Introdução 1 A Integração entre Pirâmide e Bionexo Neste manual serão apresentadas as configurações e os procedimentos para proporcionar a integração da funcionalidade Cotação de Compras entre os sistemas Pirâmide e Bionexo. O Pirâmide é o software encarregado das funções Solicitação de Compras, Autorização de Fornecimento e Nota Fiscal de Entrada do processo de compras nesta integração. Caberá ao sistema Bionexo receber as solicitações de compras incluídas no Pirâmide, executar a cotação com os fornecedores e retornar os dados para o Pirâmide. O Sistema Bionexo O Bionexo é um sistema orientado a compras eletrônicas direcionado exclusivamente ao ramo das empresas hospitalares. Isto é, funciona como uma central de compras que busca continuamente a associação com novos fornecedores, na busca de competitividade e melhor posibilidade de negociação com redução de custos. Doc-To-Help Standard Template Introdução 1

6

7 Escopo da Integração 2 Visão Geral Este capítulo tem como finalidade proporcionar o entendimento para o usuário quanto ao processo de integração (como ocorre?), conceitos relacionados a este processo, fluxo das operações, tanto no Bionexo quanto no Pirâmide e o escopo da integração. A integração entre o Bionexo e o Pirâmide ERP Para possibilitar o envio/importação/regeração dos arquivos XML entre os sistemas Bionexo e Pirâmide, é necessário verificar que os arquivos deverão ser criados no formato XML. O escopo básico desta integração é permitir a comunicação das informações entre os sistemas Pirâmide e Bionexo, conforme modelo abaixo: Figura 1 - Imagem do fluxo das informações entre o Pirâmide e o Bionexo Abaixo serão mostradas as etapas que cada sistema efetuará para realização do processo de envio, importação e regeração do arquivo XML: Doc-To-Help Standard Template Escopo da Integração 3

8 1. Itens de Solicitação de Compras Os itens de solicitação de compras serão enviados do Pirâmide para o Bionexo a partir de tela Itens de Solicitação de Compras (menu: Módulo Compras Solicitação Itens). Esses arquivos serão armazenados no local que foi definido no Módulo Integração (menu: Módulo Integração Configurações Botão - Aba Parâmetros). Após a geração do arquivo XML através do botão na tela Itens de Solicitação de Compras, o usuário deverá acessar o site do Bionexo e transmitir o arquivo gerado. 2. Cotação dos Itens Confirmados O Bionexo enviará para o Pirâmide os itens confirmados juntamente com os fornecedores vencedores, ou seja, a cotação finalizada. A partir da tela de Itens Escolhidos, o usuário acionará o botão para importar o arquivo XML enviado pelo sistema Bionexo e acessar as informações das cotações contidas nele. 3. Confirmação do Pedido Após a inclusão da autorização de fornecimento de acordo com o que foi acordado na cotação enviada pelo Bionexo (botão da tela Itens Escolhidos), o usuário deverá acionar o botão na tela Itens da Autorização de Fornecimento para gerar o arquivo XML com as informações da AF. 4. Cancelamento da Autorização de Fornecimento Se por algum motivo, após a geração do arquivo XML for necessário realizar o cancelamento da AF, o usuário deverá realizar esse cancelamento no Bionexo e este sistema enviará um arquivo com os dados para cancelamento para o Pirâmide e na tela Itens da Autorização de Fornecimento, o usuário deverá importar o arqquivo XML enviado pelo Bionexo. Compatibilidade A versão X do Bionexo liberada no dia 02/02/2009 é compatível com o migrador X em diante do Pirâmide na versão ; e com o migrador X em diante do Pirâmide na versão Doc-To-Help Standard Template

9 Ativação 3 Ativando a Integração entre Pirâmide e Bionexo A ativação da integração consiste em sinalizar no Pirâmide a transferência dos dados através do formato XML para o Bionexo. Configurações Gerais É necessário fazer a compilação das packages PCK_PIR_XML.pck, PCK_PIR_COTACAO_XML.pck e PCK_PIR_PEDIDO_CMP_XML.pck no banco Oracle. Este deverá estar na versão 10g ou versões posteriores. Configurações no Pirâmide Módulo Integração No Módulo Integração, o usuário deverá realizar a configuração da integração do Pirâmide e com Bionexo. Para isto deverá selecionar o executável Pirâmide. na pasta bin de instalação do Integração Sistema O usuário deverá selecionar o sistema BIO - Bionexo e assinalar a coluna Integra c/ Pirâmide através da marcação. Doc-To-Help Standard Template Ativação 5

10 Figura 2 - Janela para integração entre sistemas Após definir a integração, será gerada na tela Integrações do Pirâmide com Outros Sistemas a opção INTEGRAÇÃO COMPRAS BIONEXO. Integração Configurações 6 Ativação Doc-To-Help Standard Template

11 Figura 3 - Janela com sistemas a serem integrados O usuário deverá clicar no botão para acessar a tela Objetos de Intragração para a configuração Figura 4 - Janela para configuração dos parâmetros Na Aba Parâmetros, a coluna Conteúdo deverá obrigatoriamente ser preenchida de acordo com as indicações abaixo: PREENCHIMENTO DOS CAMPOS Parâmetro Nome do arquivo XML Conteúdo Informar um nome para o arquivo XML a ser gerado após o cadastro da Autorização de Fornecimento com a Doc-To-Help Standard Template Ativação 7

12 para a gravação da AF Atributo da solicitação complementar que armazenará a solicitação original Complemento do motivo de cancelamento do saldo da solicitação Código do motivo de cancelamento do saldo da solicitação Forma de Pagamento Nome do arquivo XML para a gravação dos itens de solicitação Descrição do motivo da solicitação complementar Caminho para a gravação do confirmação do pedido a ser enviada para o Bionexo. Ou seja, esse arquivo que será gerado após o recebimento da cotação pelo Bionexo. O Pirâmide gerará o nome do arquivo a partir da concatenação do conteúdo deste parâmetro com o código de referência, data e hora da geração. Exemplo: AF_ _ _ xml Informar o atributo da solicitação complementar que armazenará o código da solicitação original. A solicitação de compras complementar é gerada com a diferença da quantidade que foi cotada maior ou menor que a solicitada. Por exemplo: Foi cadastrada a solicitação de compras com 50 unidades, mas o Bionexo retornou uma cotação com 60 unidades, será gerada uma solicitação complementar com 10 unidades. Informar uma descrição complementar do motivo de cancelamento do saldo da solicitação de compras. Informar um código do motivo de cancelamento do saldo da solicitação de compras original. Informar o código de pagamento que será considerado na geração do arquivo XML que será enviado para Bionexo para cotação. É recomendado preencher este parâmetro com a seguinte descrição: A Definir, pois no Pirâmide na solicitação de compras ainda não existe a informação da forma de pagamento, porém para o Bionexo esse informação é obrigatória. Este campo comporta até 2000 caracteres. Informar um nome para o arquivo XML a ser gerado após o cadastro da Solicitação de Compras. Este será o arquivo que será enviado para o Bionexo realizar a cotação. O Pirâmide gerará o nome do arquivo a partir da concatenação do conteúdo deste parâmetro com o código da solicitação de compras, data e hora da geração. Exemplo: SOLIC_ _ _ xml Informar uma descrição do motivo de geração da solicitação de compras complementar. Informar o caminho (menu) onde será gravado o arquivo XML gerado a partir da Autorização de 8 Ativação Doc-To-Help Standard Template

13 XML da AF Caminho para a gravação do XML dos itens de solicitação Requisitante da solicitação complementar Fornecimento, ou seja, após a entrega da cotação pelo Bionexo. Informar o caminho (menu) onde será gravado o arquivo XML gerado a partir dos Itens da Solicitação de Compras. Ou seja, antes da entrega da cotação pelo Bionexo. Informar um requisitante que será sempre sugerido quando for gerada a solicitação de compras complementar. Após o preenchimento dos campos acima mencionados, o usuário deverá clicar no botão e posteriormente no botão. Na tela Integrações do Pirâmide com Outros Sistemas selecionar novamente a opção INTEGRAÇÃO COMPRAS BIONEXO e acionar o botão. Módulo Administrador A geração do arquivo XML dos itens da Solicitação de Compras e Autorização de Fornecimento somente poderá ser realizada por usuário(s) que possua(m) direito de perfil GERAR_XML do Módulo Compras (menu: Módulo Administrador - Usuário - Direito de Perfil). Doc-To-Help Standard Template Ativação 9

14

15 Operações 4 Fluxo das Operações entre Pirâmide e Bionexo Visando facilitar a compreensão do usuário, neste capítulo será detalhado o fluxo das operações para o envio, importação e regeração do arquivo XML. Parâmetros É importante que os cadastros dos parâmetros no Módulo Integração (conforme tela abaixo) estejam configurados antes da execução da integração. Isto é necessário por que o sistema efetuará a busca no Pirâmide dessas informações previamente cadastradas para efetuar a geração, importação e regeração do arquivo XML e até mesmo da solicitação de compras complementar. Figura 5 - Janela para configuração dos parâmetros Doc-To-Help Standard Template Operações 11

16 Solicitação de Compras O usuário irá gerar a solicitação de compras (SC) normalmente no Pirâmide (menu: Módulo Compras Solicitação Cadastro). Após o cadastro da SC, o usuário deverá ir para a tela Itens da Solicitação de Compras: Figura 6 - Janela para seleção dos itens da solicitação de compras Nesta tela, o usuário deverá selecionar a(s) solicitação(ões) para a(s) qual(is) será gerado o arquivo XML que será enviado para o sistema Bionexo e acionar o botão. Se for selecionada mais de uma solicitação de compras nesta tela, o Pirâmide irá gerar um arquivo XML para cada uma. O usuário poderá utilizar os filtros disponíveis nesta tela para agilizar a consulta da(s) solicitação(ões). Ressaltando que, os itens deverão pertecer ao mesmo tipo de material para geração do arquivo XML. Após a geração do arquivo XML, o usuário deverá acessar o site do Bionexo e transmitir o arquivo gerado. Ressaltando que, durante o envio, o Bionexo irá validar o arquivo e caso existam, apresentará os erros. Caso o usuário tenha apagado o arquivo XML, ou algum outro motivo que não tenha mais o arquivo gerado, poderá regerar o arquivo XML com a mesma data e itens do arquivo anterior. Para isso, deverá clicar no botão que permitirá que seja realizada outra vez a geração do arquivo XML. Ao clicar neste botão, será aberta a janela Regeração de Arquivo XML de Itens da Solicitação. Para maiores detalhes, o usuário poderá consultar o Manual do Usuário - Módulo Compras - Capítulo Solicitação de Compras - Tópico Regeração de Arquivo XML. A partir do momento que o arquivo XML for gerado, os itens enviados da solicitação de compras não poderão ser alterados e o 12 Operações Doc-To-Help Standard Template

17 usuário não poderá gerar cotação nem autorização de fornecimento para esta solicitação de compras. O usuário poderá cancelar uma solicitação já enviada para o Bionexo e neste caso, não será necessário enviar nenhuma informação para o Bionexo onde o processo será considerado encerrado. Cotação dos Itens Será o sistema Bionexo que realizará as cotações dos itens da solicitação de compras enviada no arquivo XML. Quando as cotações estiverem concluídas, o Bionexo enviará de volta o arquivo XML com as cotações finalizadas. Importando o arquivo XML a partir da tela Itens Escolhidos O usuário poderá importar o arquivo XML enviado pelo Bionexo na tela Itens Escolhidos (menu: Módulo Compras Cotação Itens Escolhidos). Figura 7 - Janela para importação de itens escolhidos O usuário poderá importar o arquivo XML com a cotação através do botão. No Pirâmide, essa cotação entrará finalizada e com a numeração sequenciada, ou seja, seguindo a numeração da última cotação cadastrada no Pirâmide. A numeração da cotação do Bionexo será considerada no Pirâmide como Código de Referência. O usuário poderá verificar os dados da cotação através do relatório Mapa de Cotação (menu: Módulo Compras - Relatórios - Operacionais - Mapa de Cotação). Para facilitar a consulta da cotação enviada pelo Bionexo, o usuário poderá filtrar as cotações pelo código de referência, informando o código no campo Referência da tela Itens Escolhidos. Para Doc-To-Help Standard Template Operações 13

18 maiores detalhes sobre a importação do arquivo XML, o usuário deverá consultar o Manual do Usuário - Módulo Compras - Capítulo Cotação - Tópico Importando Arquivo XML a partir da tela Itens Escolhidos. Após a inclusão (importação do arquivo XML) será criada uma cotação atrelada à(s) solicitação(ões) de compras com as propostas e o encerramento será realizado automaticamente. Caso o parâmetro usa autorização na cotação por alçada esteja habilitado (menu: Módulo Administrador Gerais Parâmetros Por Filial - Aba Compras - Aba Cotação), a cotação estará disponível para aprovação. Caso existam erros de importação (integridade dos dados, regras de negócios, problemas de tecnologia, etc), o usuário poderá consultar o detalhamento desses erros ao selecionar na listagem o arquivo em questão. Condição para geração da cotação no Pirâmide Os fornecedores enviados na proposta do Bionexo deverão estar cadastrados previamente no Pirâmide. Caso exista algum fornecedor não cadastrado, será apresentada uma mensagem de erro com o(s) CNPJ(s) do(s) fornecedor(es) e a importação não será concluída. O usuário poderá realizar o cadastro do fornecedor no Módulo Financeiro (menu: Módulo Financeiro Contas a Pagar Fornecedores Cadastro) e em seguida clicar no botão novamente para concluir a importação. Quantidade cotada maior/menor que a quantidade solicitada A quantidade de alguns produtos pode ser fixa por embalagem, dependendo do fabricante, por esse motivo, poderá ser realizada uma cotação no Bionexo com a quantidade cotada maior ou menor que a solicitada. Para isso, será realizada a seguinte operação: 1 - sendo a quantidade negociada maior que a solicitada, será gerada uma solicitação de compras complementar automaticamente com a diferença da quantidade da solicitação original. Esta solicitação complementar será idêntica à original, com exceção da quantidade e até mesmo do requisitante (pois o requisitante da solicitação original pode ser diferente do requisitante da solicitação complementar informado no parâmetro no Módulo Integração). 2- sendo a quantidade cotada menor que a solicitada, o saldo da solicitação será cancelado. Alteração da proposta de cotação Caso seja necessário alterar alguma informação da proposta de cotação, por exemplo: prazo de entrega, esta alteração só poderá ser feita no Bionexo. O Bionexo disponibilizará novamente o arquivo XML com as novas informações, e o usuário do Pirâmide 14 Operações Doc-To-Help Standard Template

19 deverá importar o novo arquivo XML na tela Itens Escolhidos. O Pirâmide excluirá automaticamente a cotação cadastrada anteriormente. Ressaltando que esta ação só poderá ocorrer caso a autorização de fornecimento não tenha sido gerada. Poderão ser enviados produtos similares na cotação do Bionexo, desde que o produto similar esteja associado ao produto original (menu: Módulo Estoque Produto Cadastro Aba Similares). Geração de Fornecimento Após a importação do arquivo XML na tela Itens Escolhidos, o usuário poderá selecionar a cotação importada do Bionexo e gerar uma autorização de fornecimento a partir do botão. Confirmação do Pedido Após a inclusão da autorização de fornecimento de acordo com o que foi acordado na cotação enviada pelo Bionexo, o usuário deverá acionar o botão na tela Itens da Autorização de Fornecimento para gerar o arquivo XML com as informações da AF (menu: Módulo Compras Autorização de Fornecimento Itnes). Figura 8 - Janela para gerar arquivo XML com a cotação Este arquivo XML será enviado para o Bionexo com a confirmação de que poderá ser realizada a compra. Será o Bionexo que se encarregará de enviar os s para os fornecedores informando a confirmação do pedido. O Pirâmide irá gerar um arquivo XML para cada código de referência do Bionexo. O usuário poderá utilizar o filtro Referência para facilitar a consulta das AFs para geração do arquivo XML. Doc-To-Help Standard Template Operações 15

20 Cancelamento da Autorização de Fornecimento Se após a geração do arquivo XML seja necessário realizar o cancelamento da AF, esse cancelamento será realizado pelo Bionexo, e este sistema enviará um arquivo com os dados para cancelamento no Pirâmide. Importando o arquivo XML a partir da tela Itens da Autorização de Fornecimento O Bionexo enviará um arquivo XML com os dados para o cancelamento. Então, o usuário do Pirâmide poderá importar o arquivo XML enviado pelo Bionexo na tela Itens da Autorização de Fornecimento através do botão (menu: Módulo Compras - Autorização de Compras Itens), para que seja realizado o cancelamento do(s) item(ns) dessa cotação na tela Itens da Autorização de Fornecimento. Caso existam erros de importação (integridade dos dados, regras de negócios, problemas de tecnologia, etc), o usuário poderá consultar o detalhamento desses erros ao selecionar na listagem o arquivo em questão. Para maiores detalhes sobre a importação do arquivo XML, o usuário deverá consultar o Manual do Usuário - Módulo Compras - Capítulo Autorização de Fornecimento - Tópico Importando Arquivo XML. 16 Operações Doc-To-Help Standard Template

21 Doc-To-Help Standard Template 17