Documento para Integraes

Integrao Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Este documento modelo relaciona algumas informaes que no podem faltar na documentao de uma integrao. Porm, ningum melhor do que o aquele que especificou ou desenvolveu a integrao para saber quais so as informaes importantes para o entendimento do cliente. Por isso este documento no deve ser considerado como um guia de preenchimento de documentao, mas como um exemplo de informaes mnimas necessrias.

Data da reviso 20/07/2012

Responsvel Ederson Tonial

Descrio da reviso Verso inicial

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Contedo

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

Contedo ........................................................................................................................................ 3 Contexto de negcio (introduo) .................................................................................................... 4 Sistemas envolvidos ........................................................................................................................ 5 Integrao ...................................................................................................................................... 5 Escopo ............................................................................................................................................ 5 Pr-requisitos instalao/implantao/utilizao ............................................................................. 5 Instalao/Atualizao .................................................................................................................... 5 Controle de verso .......................................................................................................................... 9 Suporte .......................................................................................................................................... 9 Transaes/Entidades/Mensagens nicas ........................................................................................ 9 Fluxo das informaes ..................................................................................................................... 11 Limitaes/Restries gerais ........................................................................................................... 12 Como fazer (opcional) ..................................................................................................................... 12 Situaes comuns (opcional) ........................................................................................................... 12 Checklist de suporte da aplicao .................................................................................................... 13 Anexos ........................................................................................................................................... 13

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Contexto de negcio (introduo)

A oferta TOTVS Colaborao, compreende toda integrao entre os ERPs TOTVS com a soluo NeoGrid. A responsabilidade do TSS (TOTVS Service SPED) no TOTVS Colaborao de integrar os ERPs com a NeoGrid, provendo servios que possibilitem a comunicao e transmisso de documentos entre as partes, conforme pode ser visto na figura 6.

Figura 6 Oferta TOTVS Colaborao A oferta TOTVS Colaborao Compras compreende a integrao entre os ERPs TOTVS com a soluo NeoGrid, possibilitando o envio de Pedidos de compra para o fornecedor, conforme fluxo da figura 7.

Figura 7 Fluxo da oferta TOTVS Colaborao fase II

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Sistemas envolvidos
ERP Datasul mdulo de compras (pedido de compra), TOTVS Service Sped (TSS), Portal Neogrid e ERP do fornecedor.

Integrao

A integrao tem o objetivo de permitir que o cliente com ERP Datasul realize de pedido de compra para fornecedores via oferta do TOTVS Colaborao.

Escopo

O escopo desta integrao o envio da entidade pedido de compra do cliente para o fornecedor por meio da oferta TOTVS Colaborao. No faz parte do escopo o envio de mensagens separadas com as entidades relacionadas ao pedido de compra, como por exemplo: Informaes especficas do Item (Produto), Cadastro do Cliente. A estrutura da mensagem foi montada para que o receptor possa realizar a implantao de um pedido de venda tendo as informaes principais.

Pr-requisitos instalao/implantao/utilizao
Pr-requisitos (tcnicos ou de negcio) para o funcionamento da integrao: Verses mnimas de produto: o Datasul EMS 2.06B (label 0006) ou o Datasul 11.5.3 ou superior Pr-requisitos de negcio: o Contratao da oferta do TOTVS Colaborao (TOTVS e Neogrid). o Acordo comercial cadastrado no portal da Neogrid referente aos CNPJ trafegados. o TSS configurado para utilizao das transaes a serem utilizadas no TOTVS Colaborao. Ferramentas que so necessrias a integrao: TSS (TOTVS Service Sped).

Instalao/Atualizao
Este tpico tem por objetivo orientar a instalao da integrao, visando o seu funcionamento completo. Instalao do aplicativo servidor do TSS (TOTVS Service Sped) verso 2.09 ou superior.

Observao: No faz parte do escopo deste documento detalhar a instalao do TSS no ambiente.

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Mdulos ou programas (ERP Datasul) que geram informaes necessrias a integrao: o Parmetros Globais (CD0101) Ativao da funcionalidade global referente ao TOTVS Colaborao, pasta Colab II. Observao: Esta funcionalidade somente ficar habilitada quando estiver liberada no License Server a contratao do TOTVS Colaborao. o Manuteno de Estabelecimento (CD0403) Parametrizao do TSS por estabelecimento para trabalhar com TOTVS Colaborao. A configurao do TSS feita acessando o boto que aparece na parte superior da tela, conforme figura 1.

Figura 1 Manuteno de Estabelecimentos

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Configuraes do TSS (CD0403B) Tela utilizada para informar as configuraes de acesso ao TSS: URL de conexo, tipos de ambiente (Homologao/Produo) e o usurio e senha para autenticao no portal Neogrid, figuras 2 e 3.

Figura 2 Configuraes do TSS (Pasta Colaborao) Configuraes importantes para a integrao (pasta Colaborao exibida na figura 2): 1. URL de conexo com o TSS. 2. Usurio e senha de autenticao com o portal da Neogrid.

Figura 3 Configuraes do TSS (Pasta Colab II)

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Configuraes importantes para a integrao (pasta Colab II exibida na figura 3): 3. Habilitar a funcionalidade de Pedidos de Compra/Venda. 4. Configurar o tipo do ambiente (Homologao/Produo).

Manuteno Fornecedores (CD0401) - Parametrizar o Fornecedor para trabalhar com TOTVS Colaborao, conforme figura 4.

Figura 4 Manuteno de fornecedores (Pasta Comun.)

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

Emisso de Pedido de Compra (CC0305) Realiza o envio de pedido de compra para o fornecedor via TOTVS Colaborao, conforme figura 5.

Figura 5 Emisso de Pedido de Compra Observaes: No faz parte do escopo deste documento detalhar a implantao de um pedido de compra, etapa anterior a Emisso de pedido de compra.

Controle de verso
No se aplica.

Suporte
No se aplica.

10 Transaes/Entidades/Mensagens nicas
Esto detalhadas aqui as entidades e transaes que sero enviadas no documento XML de pedido de compra, no sero replicados cadastros de uma ponta a outra de forma integrada, para que a integrao seja concretizada de forma correta os cadastros base devero existir nas duas pontas. Segue consideraes:

Vnculos feitos a partir do CNPJ (ERP que recebe o documento XML deve encontrar as informaes baseado no CNPJ): Cadastro de Estabelecimento (CD0403) Folder Endereo. Cadastro de Fornecedores (CD0401) Folder Fiscal.
Datasul x TOTVS Colaborao Compras 9

Datasul x TOTVS Colaborao Compras

Cadastro de Transportadores (CD0402) Folder Fiscal.

Entidade Item (identificao do Produto): Para o envio da tag <itemcode>, o sistema ir realizar a seguinte validao: Caso exista cdigo EAN cadastrado na manuteno de itens materiais (CC0103), ele ser enviado ao fornecedor, caso contrrio, ser enviado o cdigo de item interno do EMS (CD0204). No caso da tag <prodcodsuplli>, ser enviado sempre o cdigo de item do fornecedor, cadastrado na manuteno item fornecedor (CC0105). Outras entidades/cadastros: Moeda Caso a moeda seja Real, ser enviado o cdigo 1 na tag <CurrencyId>, caso contrrio, ser enviado 6 e a descrio da moeda na tag <Currencydesc>. Unidade de Medida Ser enviada a unidade de medida interna do ERP na tag <internalmensuunit> e a unidade de medida do fornecedor (CC0105) na tag <supllimensuunit>. Estrutura da mensagem nica de pedido de compra (Order) que ser trafegada:
<BusinessContent> Pedido (CC0300): 1 ocorrncia <VendorGovInfo> <CustomerGovInfo> <BillingLocationGovInfo> <DeliveryCustomerGovInfo> <DeliveryAddress> <City> <State> <Country> <CarrierGovInfo> <InvoiceMessages> <InvoiceMessage> <Discounts> <Discount> <OTHER> <ADDFIELDS> <ADDFIELD> <PAYMENTPLAN> Parcelas das condies de pagamento: de 0 a N ocorrncias <TERM> <LISTOFTAXESDOCUMENT> <VALUESANDTAXES> <SalesOrderItens> Ordens de Compra/Itens: de 1 a N ocorrncias <Item> <ItemDiscounts> <ItemDiscount> <ItemMessages> <ItemMessage> <ListOfReturnedInputDocuments> <ReturnedInputDocument> <GRADE> <GRADE_ITEM> <CROSSDOCKING> Entregas: de 0 a N ocorrncias <CROSSDOCKING_ITEM> <LISTOFTAXESITEM> <VALUESANDTAXES> <OTHER> <ADDFIELDS> <ADDFIELD> <SUMMARY> Resumo: 1 ocorrncia

Datasul x TOTVS Colaborao Compras

10

Datasul x TOTVS Colaborao Compras

OBSERVAES IMPORTANTES: A tag GRADE no gerada, assim como a GRADE_ITEM. A tag LISTOFTAXESDOCUMENT no gerada, assim como a tag VALUESANDTAXES.

As tags OTHER, ADDFIELDS e ADDFIELD no so geradas (Tags criadas para serem utilizadas pelo cliente).

11 Fluxo das informaes

Fluxo completo da Integrao: Cliente (montadora ou indstria) envia pedido de compra para o fornecedor. O ERP envia o XML do pedido de compra para o TSS. O TSS valida a estrutura e envia o XML do pedido de compra para a validao da NeoGrid. A soluo NeoGrid realiza a validao do arquivo enviado e disponibiliza o resultado. O ERP do fornecedor busca as informaes da soluo NeoGrid.

Datasul EMS
INCIO

TSS

Neogrid

Fornecedor

Emisso de Pedido de Compra

WebService TSS

WebService NEOGRID FORNECEDOR (Busca pedidos na Neogrid)

Enviar XML para TSS ERRO Mostra Descrio informada pelo TSS

XML est OK? (Validao de Schema)

FIM

OK Enviar XML para Neogrid

Datasul x TOTVS Colaborao Compras

11

Datasul x TOTVS Colaborao Compras

Fluxo do envio do ERP Datasul para o TSS:

INCIO

Emisso de Pedido Compra (CC0305) ou Emisso de Pedido Compra Flex

Cliente tem licena para utilizar o Totvs Colaborao? CD0101 SIM Estabelecimento parametrizado CD0403B

NO

NO SIM

SIM Gerao XML Pedido Compra

Fornecedor parametrizado para receber Pedido Compra via Totvs Colaborao? CD0401

NO

Marca Pedido de Compra como Impresso ERRO OK Mostra erro de integrao no relatrio

Verifica Conexo TSS OK Enviar XML para TSS

FIM

Retorno TSS

ERRO

12 Limitaes/Restries gerais
No se aplica.

13 Como fazer (opcional)

Detalhado no item 7 deste documento os passos que viabilizam a integrao.

14 Situaes comuns (opcional)

Mensagem de Invalid HTTP Connection no log do TSS (console.log) pode significar Acess Denied, ou seja, o usurio que foi informado para autenticao HTTP no portal da Neogrid pode estar invlido (veja figura 2 do tpico 2). Mensagem de 10060 : Connection timed out. no log do TSS (console.log) significa que a URL de conexo com a Neogrid pode estar incorreta ou o servio do portal da Neogrid est fora. 12

Datasul x TOTVS Colaborao Compras

Datasul x TOTVS Colaborao Compras

15 Checklist de suporte da aplicao

Check-list de verificao de alguns pontos importantes para o funcionamento e atendimento da integrao. Instalao/Configurao 1. 2. 3. 4. Verificar se o servio do TSS est disponvel via HTTP (Navegador Web). Normalmente a URL HTTP:\SERVIDOR:PORTA\SPED. Verificar se o servio da Neogrid est disponvel via HTTP (Navegador Web). Verificar no log do TSS (console.log) se ocorrem mensagens de erro na execuo dos JOBs. Em caso de retorno negativo do TSS para o Datasul a mensagem ser exibida no relatrio texto de emisso de pedido. Ex: Erro: 17006 - [TSS REMESSADOCTOTVSCOLAB] Erro no retorno, sem resposta do TSS.

Checklist de Verificaes de negcio: 1. 2. Habilitar o TOTVS colaborao no CD0101 (Parmetros Globais), folder "Integr II". Parametrizar o estabelecimento para trabalhar com TOTVS colaborao no CD0403B -> Via CD0403 -> Configurao do TSS. 2.1 Parametrizar o folder "Colaborao" (URL do TSS, Integrao com Neogrid usurio e senha) 2.2. Parametrizar o folder "Colab II" (Habilitar o pedido de compra e o ambiente) Parametrizar o Fornecedor para trabalhar com TOTVS Colaborao (CD0401), folder "Comun."; 3.1. Nas opes referentes a Parceiro, selecionar o checkbox "Colaborao Compras"

3.

16 Anexos
No se aplica.

Datasul x TOTVS Colaborao Compras

13