Integração ERP Ti9 - Processos PCP via Serviços Web

OBJETIVO

Este manual descreve a parametrização necessária no ERP Ti9 e processo da integração com os serviços da API (ver documentação desta API para informações técnicas).

UTILIZAÇÃO

1. Inclusão das Variáveis da Integração

Algumas variáveis/campos precisam ser parametrizados para o funcionamento da integração. Para isto, acesse o cadastro "Grupo de Variáveis para EDI e Etiquetas" e crie o grupo "INTEGRACAO_GELCOINFO", conforme Figura 1 abaixo:

Figura 1 - Grupo de Variáveis para EDI e Etiquetas

Em seguida, clique no item de menu "Campos" na janela para incluir as variáveis do grupo, para cada indicado a seguir.

Cadastro de Produtos

a) Inclua as variáveis abaixo para o Código de Transação dos produtos. Este código interno da empresa pode variar de acordo com a filial, produto e movimento (entrada/saída).

Exemplo (Figura 2): 

Id: 001_COD_TRANSACAO_ENT (deve ter este formato NNN_COD_TRANSACAO_ENT, onde "NNN" é a filial)
Nome: CÓDIGO ENTRADA
Tipo Dado: 1 -> STRING (texto)
Tamanho: 20 (para permitir até 20 caracteres no código, por exemplo)
Máscara: @! (permite letras maiúsculas, números e símbolos)

Figura 2 - Variável Código de Transação

b) Inclua a variável "Valida Halal" (Figura 3) para obrigar o preenchimento do campo "Certificado Halal" quando este produto for incluído nos itens do Documento de Entrada: 

 Figura 3 - Variável Valida Halal

Cadastro de Fornecedores

Para especificar os fornecedores que serão utilizados na integração, é necessário incluir a variável "INTEGRA_CADASTRO", demonstrada na Figura 4:

Id: INTEGRA_CADASTRO
Nome: INTEGRA CADASTRO
Tipo Dado: 6 -> BOOLEAN (permite "S" ou "N" = sim ou não)
Tamanho: 1 (permite um caractere)
Máscara: A (permite uma letra maiúscula)

Figura 4 - Variável Integra Cadastro para os Fornecedores

2. Preenchimento dos Cadastros

O campo das variáveis da integração criadas no item 1 deve ser preenchido de acordo com o cadastro e a finalidade da variável.

Cadastro de Produtos

a) Acesse o cadastro do produto e clique na opção "Campos do EDI e Etiquetas" (veja a Figura 5 abaixo).

Figura 5 - Cadastro de Produtos - opção Campos do EDI e Etiquetas

b) Inclua o Grupo de Variáveis "INTEGRACAO_GELCOINFO" e clique na opção Campos:

Figura 6 - Cadastro de Produtos - Grupo de Variáveis

c) Cadastre os códigos de transação mencionados no item "1. a)" deste manual. Exemplo: código "001-CFE-E" para a entrada do produto CFE na filial 001 (Figura 7).

Esta informação será enviada ao sistema GELCOINFO nas notas fiscais de entrada e saída. Também será utilizado para consulta do GELCOINFO ao ERP Ti9 pelo mesmo código.

Figura 7 - Códigos de Transação do Produto

d) Para ativar e obrigar o preenchimento do campo "Certificado Halal" quando este produto for incluído nos itens do Documento de Entrada, cadastre "S" na variável "VALIDA_HALAL" (Figura 8):

Figura 8 - Variável Valida Halal no Produto

Para esta integração, foram adicionados os seguintes campos demonstrados na figura 9:

• Força de Gelificação (Bloom)
• Tamanho de Partícula (Mesh)

Figura 9 - Novos campos no Cadastro de Produtos

Cadastro de Fornecedores

a) Execute o mesmo procedimento dos itens "2 a) e b)" acima para especificar os fornecedores que serão utilizados na integração (Figura 10):

Figura 10 - Cadastro dos Fornecedores - Grupo de Variáveis

b) Inclua a variável "INTEGRA_CADASTRO" com o valor "S" (Figura 11) para que o fornecedor seja enviado na consulta que o sistema GELCOINFO faz na integração.

Figura 11 - Inclusão do Fornecedor na Integração

3. Lançamentos 

Documento de Entrada

a) Na janela "Campos Adicionais dos Itens" do Documento de Entrada foi adicionado o campo Peso Balança, conforme demonstrado na Figura 12.

Figura 12 - Peso Balança nos itens do Documento de Entrada

b) Quando o item do Documento de Entrada for um produto que está com a variável VALIDA_HALAL = "S" (veja o tópico "2 d)" acima), será exibido o campo "Certificado Halal = Sim / Não" da Figura 13.

Figura 13 - Campo Certificado Halal no Item do Documento de Entrada

4. Informações Técnicas

Configuração do Servidor

Para realizar a integração dos apontamentos de produção, é necessário configurar um arquivo Batch (.bat) e incluir no "Agendador de Tarefas do Windows®" uma execução periódica (semanal, diária, horária etc.) deste arquivo para verificar a inclusão de novos apontamentos de produção. No arquivo Batch deve ser feita a chamada para o executável DCOMP.exe, com a passagem do parâmetro "INTEGRATI9PCP" e demais parâmetros de conexão. A figura 14 demonstra um exemplo de arquivo tipo ".bat".

Figura 14 - Configuração do Arquivo Batch

Servidor do Banco de Dados: 10.0.0.22

Banco de Dados Teste: gelco_teste

Usuário da Integração: INTEGRA

Manuais Técnicos

API TI9 - WebService - Manual de utilização

Layout de Integracao Ti9 - 1.6.pdf

ti9-pcp-api Endpoints V1.5.pdf