Exibir código-fonte para SAI - Integração com ERP KP Consulting

== Leitura de Arquivo de Remessa ==

Capacidade máxima de leitura de dados para integração com ERP KP Consulting, está ajustada de acordo com a capacidade máxima atual de controle pelo SAI, sendo:

* 6 Agregados (Caixas)
* 4 Cimentos (Silos)
* 3 Aditivos (Dosadores Balança/Hidrometro)
* 3 Águas (Dosadores Balança/Hidrometro)


'''TOTAL DA LEITURA 16 POSIÇÕES.'''


A importação dos dados dos arquivos de remessa gerados pelo ERP - KP  Consulting é realizada pela aplicação de "[http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Programa%C3%A7%C3%A3o_de_Produ%C3%A7%C3%A3o Programação de Produção]".

Para integração com outros ERP's pode-se adotar os padrões já definidos e homologados entre a CyberControl e a KP Consulting.

Informações sobre o ERP - KP Consulting acesse o site: '''[http://www.kpconsulting.com.br www.kpconsulting.com.br]'''


'''Definição de posições no equipamento'''

0 = Agregados (locais 1 à 8)

1 = Cimentos (locais 1 à 4)

2 = Aditivos (locais 1 à 3)

3 = Águas (locais 1 à 3)


Esta informações são essenciais para a leitura correta do arquivos de remessa.

== Valores para Aditivos ==

Devido aos valores informados para dosagem de aditivos enviados pelo ERP KP Consulting - serem no formato decimal (em quilos), a formatação do PLC aceitar somente valores inteiros, efetuaremos automaticamente a conversão dos valores de aditivos de quilos para gramas.


== Valores de Dosagem de Materiais ==

Os arquivos gerados pelo ERP - KP consulting contém valores desejados para dosagem de 1 metro cúbico, no momento da importação destes arquivos o SAI realizada o ajustes das quantidades de metros cúbicos solicitados para a carga.


== Controle de Umidade de Materiais ==

Durante o processo de importação dos arquivos gerados pelo ERP - KP Consulting o SAI realiza a atualização dos percentuais de umidades dos materiais com base nas informações fornecidas pelo ERP.

A aplicação dos descontos de valores devido a umidade de materiais são realizadas no inicio do processo de produção e somente são aplicadas quando a opção de controle de umidade do material estiver marcada no [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Cadastro_de_Materiais '''Cadastro de Materiais'''].

Atenção: Os materiais tem sua umidade atualizada conforme o ultimo arquivos importado, portando pode haver diferenças de valores caso uma ordem de produção importada fique por muito tempo a espera da produção.

== Geração do Arquivo Retorno ==

O SAI gera no final de cada processo de produção um arquivo de retorno com as informações obtidas durante o processo, este arquivo e importado automaticamente pelo ERP - KP Consulting onde o mesmo faz o processamento dos dados.

A opção para geração do arquivo de retorno deverá ser ativada em referências na aba "Comunicação".

O SAI possui 2 padrões de geração do arquivo de retorno com informações sobre a produção:

Padrão1 - Informações geradas conforme o layout original fornecida para a integração com o ERP da KP Consulting.

Padrão2 - Este padrão foi gerado para a integração do cliente Concrevisa para ser usando com o sistema SAP.

A partir da versão 1.0.4.5 é possível selecionar o layout do arquivo de retorno nas opções acima através da alteração do arquivo de inicialização (SAI.ini).

Para esta seleção localize e abra o arquivo SAI.ini pelo editor notepad, localize em [CONFIG_EQUIP] a opção [RETORNO], defina o valor do parâmetro conforme abaixo:

RETORNO=0 <- Padrão1
RETORNO=-1 <- Padrao2

== Nomenclatura do Arquivo ==

O arquivo de retorno é gerado no seguinte padrão de nomenclatura "SAIXXXXRET.TXT" onde, "SAI = padrão do sistema", "XXXX = número da ordem de produção" e "RET = Padrão do sistema".


== Local para Geração do Arquivo ==

Através do SAI é possível definir o local / pasta para geração do arquivo retorno, para configurar este local acesse no menu as opções "Ferramentas / Informação do Sistema", na aba "Comunicação" há uma área com os campos para definição caminho do local / pasta para geração dos arquivos de retorno.


== Layout do Arquivo de Remessa ==

Abaixo segue layout do arquivo de remessa gerado pelo ERP para integrações com o SAI.

 CA
 000011
 999138424
 CONCREGELL CONCRETO LTDA
 FCK 25,0/B0/Sl 65/AD-P
 1
 FCK 25,0/B0/Sl 65/AD-P
 1,00
 TopCon
 0
 RIM2E76 -  RONALDO VIEIRA INACI
 1064
 BRITA 0
 881
 KG
 02
 0
 1069
 AR NAT GROSSA
 895
 KG
 03
 0
 13649
 CONCERA SA 8235
 3
 KG
 0
 0
 1062
 CP V - ARI
 355
 KG
 11
 0
 1068
 MIRA SET 63
 1,35
 KG
 21
 0
 1000
 AGUA
 159
 KG
 31
 0

Observar que o ERP deverá gerar um arquivo rigorosamente dentro do layout acima, qualquer mudança no formato de linhas ou tamanho do campo pode afetar o processo de importação, neste casos o sistema notificará o usuário com a mensagem "'''Arquivo fora do padrão de leitura, favor exclui-lo da pasta'''".

Tabela com especificações dos campos:

[[Arquivo:Tabala KP.jpg]]

Abaixo figura com o schema de leitura do arquivo de remessa padrão txt com a posição de leitura dos caracteres enviado.

[[Arquivo:SchemaRemessa.png]]

Observações:

* Os valores decimais para quantidade de materiais devem ser expressos com virgula e sem o ponto de milhar (exemplo: 300,5 ou 1000,8).
* Linha 1: o valor para determinar o ponto de carga do equipamento deve estar sempre na 6 posição, depois do código do equipamento.
* Linha 15x: atenção para a formação da linha com o grupo dos materiais e seus limites de posições, consulte as posições disponíveis de acordo com a versão do seu sistema.

Para maiores informações acesse: '''[http://www.cybercontrol.com.br/arquivos_downloads/integracao_automacao.pdf Manual Integração KP-Consulting]'''

== Layout do Arquivo de Retorno == 

Abaixo demonstramos exemplo de nosso arquivo de retorno padrão que pode ser utilizado para importação dos dados de produção para o ERP.

 CÓDIGO DA CENTRAL  :1
 CÓDIGO DO CLIENTE :1
 NOME DO CLIENTE :CANOPUS EMP INCORPORACOES LTDA
 CÓDIGO DO TRAÇO :000000566
 NÚMERO DA NOTA FISCAL  :20600
 DESCRIÇÃO DO TRAÇO :CBN fck 30,0 B01 14+-02 000000566
 VOLUME :6
 CAIXA 1 :0000205184 - AREIA NATU DES= 3288 REAL:3822 UMIDADE= 14 TEMPO= 00:00:22
 CAIXA 2 :0000205249 - AREIA INDU DES= 1434 REAL:1547 UMIDADE= 6 TEMPO= 00:00:08
 CAIXA 3 :0000205265 - BRITA 0 -  DES= 1620 REAL:1820 UMIDADE= 0 TEMPO= 00:00:08
 CAIXA 4 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 CAIXA 5 :0000205273 - BRITA 1 -  DES= 3786 REAL:3731 UMIDADE= 0 TEMPO= 00:00:21
 CAIXA 6 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 SILO 1 :0000100056 - PEDRO LEOP DES= 2088 REAL:980 UMIDADE= 0 TEMPO= 00:01:27
 SILO 2 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 SILO 3 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 SILO 4 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 ADITIVO 1 :0000300047 - TECMULT 44 DES= 14616 REAL:13914 UMIDADE= 0 TEMPO= 00:00:47
 ADITIVO 2 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 ADITIVO 3 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 AGUA 1 :0000500011 - AGUA DES= 1182 REAL:633 UMIDADE= 0 TEMPO= 00:00:51
 AGUA 2 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 AGUA 3 :000000000000000000-VAZIO    DES= 0       REAL= 0      UMIDADE= 0      TEMPO= 0
 FINALIZOU CARREGAMENTO
 Chave em Automático
 
 Confirmou carregamento
 
 
 
 
 Tempo Carga         : 00:12:59
 
 USUARIO  :Administrador
 DIGITO :
 Nro. FORNECIMENTO  :
 Nro DA ORDEM  :000000566
 PREFIXO DO EQUIPAMENTO  :
 TIPO TRAÇO  :
 CORTE DESEJADO Kg :
 PRE LAVAGEM DESEJADA % :
 ENXAGUE DESEJADO % :
 DATA E HORA :13/10/2012 14:57:56

'''Integração do arquivo retorno com o sistema KP Consulting'''

Abaixo estão descritos o locais para preenchimento dos campos adicionais exigidos no arquivo retorno para a integração com o sistema KP.

 CORTE DESEJADO Kg :'0' -> Configuração do Equipamento / Liquidos / Campo "Corte Ajuste 1" (em Água).
 PRE LAVAGEM DESEJADA % :'60' -> Configuração do Equipamento / Liquidos / Campo "Água Inicio %" (em Água).
 ENXAGUE DESEJADO % :'40'   -> Cálculo Automático a partir do valor informado em  "Água Inicio %" (em Água).

'''Informação do valor do corte desejado'''

Caso o usuário não informe um valor de corte desejado na rotina de Layout do Equipamento o SAI fará o calculo do corte automaticamente calculando a diferente entre a quantidade solicitada e dosada total de água no processo de produção.

A geração de arquivos de retorno pode ser ativa independentemente da integração do arquivo de remessa, gerando assim arquivos com as informações de dosagem mesmo para produções de estruturas cadastradas no próprio SAI.

Para ativa a geração do arquivo de retorno abra a rotina de configuração e acesse a aba Comunicação e marque a opção '''Gerar arquivos de retorno dos dados de produção''', o arquivos será gerando na caminho especificado da pasta de retorno.

''Algumas integrações com a KP utilizam a linha de Código do Cliente para a informação do número de contrato, caso utilize a leitura dos arquivos de retorno via ERP este campo deve ser personalizado, consulte nossos técnicos.''




Para maiores informações acesse: '''[http://www.cybercontrol.com.br/downloads/integracao_automacao.pdf Manual Integração KP-Consulting]'''

== Configuração do Sistema ==

Abaixo estão descritos os passos para configuração do sistema SAI para integração com o ERP KP-Consultig:

* Faça a limpeza da base de dados do cadastro de materiais do cadastro de traços e composição de traços e do cadastro de ordem de produção e itens da ordem de produção.
* Cadastre um traço com a descrição "CADASTRO PADRÃO ERP", não é necessário cadastrar uma composição para o mesmo mesmo porque neste momento não há nenhum material cadastrado.
* No menu nas opções "Ferramentas / Informações do Sistema" acesse a aba "Comunicação", defina o padrão de leitura de arquivos para a opção "BetonMIX - KP Consulting".
* Defina os caminhos a serem  utilizados para pastas de leitura e retorno de arquivos na opção "Comunicação com Programas Externos", faça uma pasta para o trabalho com os arquivos recebidos do ERP e outra pasta para que o SAI grave os arquivos de retorno de produção.
* Ajuste o tempo para leitura do arquivo (a cada 10 segundos é o padrão) e assinale a leitura automática na opção "Parâmetros de Leituras".

== ARQUIVOS IMPORTADOS ==

Caso trave a importação de arquivos no SAI o procedimento é:
1 - Entrar na pasta que o TopCon envia/gera os arquivos .txt. (REMESSA)
2 - Excluir todos arquivos .txt da pasta (REMESSA).
3 - Entrar no SAI excluir todas importações.

== Configuração do Equipamento ==

Para configuração do equipamento na utilização da integração com sistema de ERP sugerimos o suporte de um técnico certificado para o acompanhamento do processo.

== Cadastro de Materiais ==

O SAI efetua automaticamente o cadastro de materiais a partir dos arquivos de remessa da KP Consulting, é necessário logo no inicio de implantação do sistema no cliente que o técnico faça a limpeza de todos os dados do cadastro de materiais (Esta operação somente é realizada pelo administrador do sistema).


== Cadastro de Traços ==

Para melhor visualização dos dados do sistema, sugerimos que seja realizado o cadastro do primeiro traço como "Traço ERP / betonMIX" na campo descrição, este deve ser o traço de código "1" o qual o sistema de importação tomará como padrão.

Antes de iniciar o cadastro do traço, solicite a limpeza dos dados de traços(Esta operação somente é realizada pelo administrador do sistema).


== Outros ERP's ==

Outros ERP que utilizam o mesmo padrão para geração de arquivos para integração:

* '''[http://www.topsyss.com.br/ Topsyss - TopCon]'''
* '''[http://www.sap.com/brazil/index.epx SAP]'''
* '''[http://totvs.com TOTVS]'''
* '''[http://www.projedata.com.br Progedata]'''

== Veja Também ==

* [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Informa%C3%A7%C3%B5es_do_Sistema SAI - Informações do Sistema]
* [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Cadastro_de_Materiais SAI - Cadastro de Materiais]
* [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Programa%C3%A7%C3%A3o_de_Produ%C3%A7%C3%A3o SAI - Programação de Produção]
* [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Cadastro_de_Tra%C3%A7os SAI - Cadastro de Traços]
* [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Integra%C3%A7%C3%A3o_com_ERP SAI - Integração com ERP]
* [http://wiki.cybercontrol.com.br/index.php?title=SAI_-_Controle_de_Umidade SAI - Controle de Umidade]