Consulta Integrações Athos
Sobre o programa
O processo de manuseio é um conjunto de programas customizados desenvolvidos por nossa equipe de TI para o ERP TOTVS que tem a funcionalidade de montar, preparar e acompanhar toda a montagem dos KITs através de ordens de produção envolvendo as áreas de Operações, Logística e Faturamento.
O principal programa desse processo é o MOUN803 - Consulta Integrações Athos que será detalhado nesta documentação.
O procedimento descrito nesse documento é relacionado a(s) área(s) acima mencionada(s).
Tópicos
Glossário
Termo | Significado |
|---|---|
NFT | Nota Fiscal de Transferência |
NFS | Nota Fiscal de Serviço |
OP | Ordem de produção |
OC | Ordem de compra |
TD | Transações Diversas |
Aca | Material acabado |
Req | Requisições |
Div | Diversos |
01. Conceito
O processo de manuseio envolve diversos programas e consiste em montar os KITs solicitados através de OPs e/ou OCs feitos e armazenados em estabelecimentos internos ou externos.
A principal forma de acompanhar todo o processo do manuseio é através da consulta dos IDs dos KITs no programa MOUN803 onde é possível verificar toda a etapa da integração com o operador logístico Athos.
02. Parâmetros e Programas
Para atender o processo de manuseio é necessário configurar alguns parâmetros em programas já existentes e atualizados com novos campos para se adequar ao processo.
Requisitos
Para que seu processo ocorra sem problemas, verifique se os perfis de acesso das funcionalidades para seu usuário estão parametrizados corretamente:
Programa responsável pela solicitação de montagem dos KITs.
Clique aqui para saber mais sobre o programa.
Programa responsável por informar o tipo e local de manuseio dos IDs dos KITs e gerar ordens.
Clique aqui para saber mais sobre o programa.
Programa responsável pela definição dos manuseios em lote.
Clique aqui para saber mais sobre o programa.
Programa responsável pelo cadastro das exceções da tabela de preço.
Clique aqui para saber mais sobre o programa.
Programa responsável por ajustar os valores da tabela de preço.
Clique aqui para saber mais sobre o programa.
Programa responsável por realizar as integrações das OPs de forma manual.
Clique aqui para saber mais sobre o programa.
Programa responsável pela fila de integração do manuseio, mostra quais itens ainda estão pendentes. É possível reenviar uma OP que teve erro de integração e também priorizar os IDs da fila.
Clique aqui para saber mais sobre o programa.
Programa repsonsável pelo cadastro para relacionar o tipo de manuseio à um local.
Clique aqui para saber mais sobre o programa.
Através do programa deverá ser liberado as funções nos programas utilizados no manuseio.
Programas Relacionados
Outros programas que estão relacionados, mas não são impeditivos para o processo:
CD0709 - Atualização Manutenção Linhas Produção
CD9070 - Ordens Produção
CP0513 - Consulta Quantidade Alocada Ordem
CP0301 - Manutenção Ordem Produção
MOUN555 - Monitor de Faltas
MOUN805 - Parâmetros Integrações Athos
MOCP003 - Abertura OPs em Lote
MOCF001 - Relatório de Especificações de Produtos
MOFT058 - Integração de Pedidos Op. Logístico
03. Processos
O programa principal do processo de manuseio e montagem dos KITs é o monitor MOUN803 - Consulta Integrações Athos, onde é possível acompanhar todas as etapas do manuseio dos KITs, mas para iniciar o processo a área de operações precisará analisar a demanda de KITs e iniciar seu planejamento.
Geração dos pedidos de montagem do KIT (IDs)
Para iniciar o preparo do ID de montagem do KIT é necessário abrir o programa MOUN303 para realizar as solicitações.
Também é possível realizar as solicitações das montagem dos pedidos através do programa MOUN555.
Nele será informado qual(is) o(s) pedido(s) de venda será vinculado ao kit através de importação direta de uma planilha corrretamente preenchida ou através do preenchimento no sistema a partir do botão “Layout”.
É necessário informar o ano de referência antes de clicar no botão “Layout”.
Preenchimento no sistema
Ao clicar no botão “Layout” irá abrir o programa MOUN303A e haverá duas opções:
Branco - O sistema irá gerar uma planilha modelo em branco para que seja preenchido os itens manualmente;
Pedido de Venda - Irá abrir uma nova tela para que o usuário selecione os itens dos pedidos e incluí-los.
Ao clicar em “Pedido de Venda” é preciso que seja informado o estabelecimento, número do pedido, os itens e suas respectivas quantias.
Para preencher primeiro procure pelos pedidos para que possa montar o KIT. Preencha o filtro acima das tabelas e clique no ícone ✔️.
Após isso dê duplo clique em cada item que deseja para o KIT na tabela "LISTADOS" e clique em adicionar (➕).
É possível marcar todos os itens através do botão.
Caso queira remover algum item, selecione o item na tabela "SELECIONADOS" e clique em remover (➖).
Feito isso clique em gerar no ícone de arma.
O sistema irá gerar uma planilha com todos os itens selecionados. Verifique se todos os campos estão de acordo com o que deseja.
Colunas da planilha
Campo | Descrição |
|---|---|
Contrato | Número do contrato. O sistema traz o valor automaticamente de acordo com o pedido. Campo obrigatório. |
Emitente | Número do emitente. O sistema traz o valor automaticamente de acordo com o pedido. Campo obrigatório. |
Anexo | Número do anexo. O sistema traz o valor automaticamente de acordo com o pedido. Campo obrigatório. |
Tabela Preço | Número da tabela de preço. O sistema traz o valor automaticamente de acordo com o pedido. Campo obrigatório. |
Item | Número do item. O sistema traz o valor automaticamente de acordo com o pedido. |
Semestre | Número do semestre |
Qtde Pedida | Número da quantidade pedida do item. Campo obrigatório. |
Expectativa | Data de expectativa |
Desmontagem (S/N) | Sim ou Não |
Repique (S/N) | Sim ou Não |
Acumula (S/N) | Sim ou Não |
Reserva (S/N) | Sim ou Não |
OBS Desmonte | Detalhes do desmonte |
Estab | Número do estabelecimento. Campo obrigatório. |
Nome Abrev | Nome abreviado. |
Pedido de Venda | Número do pedido de venda. |
Armazenar (S/N) | Sim: o KIT montado será expedido diretamente do estabelecimento; |
Importação da planilha
Com a planilha pronta selecione o arquivo através do ícone de pasta, clique em importar e em seguida clique em “Gerar” para gerar a solicitação de ordem de produção do KIT.
Caso necessite do modelo da planilha, clique em “Layout” e “Pedido em Branco”.
Após isso o sistema irá mostrar um log com os itens liberados e seus respectivos ID’s.
É possível consultar detalhes da solicitação de OP no programa MOUN066. Nele também haverá os dados atualizados das integrações, mantendo suas atribuições de gestão.
Para prosseguir é necessário definir o tipo de manuseio para os itens, para isso abra o programa MOUN063.
Manuseio
Após a geração dos ID’s o programa MOUN063 irá estabelecer inicialmente o tipo de manuseio para os ID’s do KIT.
Só irá aparecer os ID’s referentes ao estabelecimento em que o usuário estiver logado.
Para prosseguir no processo localize a partir do filtro os ID’s do KIT e clique no ícone ✔️.
Na tabela "MONTAGEM" selecione as ordens desejadas com duplo clique e em seguida clique no botão “Manuseio”, o sistema irá abrir o programa MOUN063K.
Definindo manuseio
Nesta tela informe o tipo de manuseio do(s) KIT(s):
Interno - Manuseio realizado por pessoal interno, a quantia das reservas serão alocadas e não ficará disponível para movimentação no estoque;
Externo - Manuseio realizado por pessoal externo onde o material fica em poder de terceiros;
Indefinido - Definição padrão;
Operador Interno - Manuseio realizado por um operador logístico terceiro em um estoque em nossas dependências.
E informe o local de manuseio caso o manuseio seja do tipo “Externo” ou “Operador Interno”.
Importante: Se o local do manuseio for diferente do estabelecimento o sistema não deixará prosseguir.
Caso seja necessário relacionar um novo local para o tipo de manuseio, faça um novo cadastro de local através do programa MOUN809.
Para seguir clique em “OK” para salvar.
Para agilizar o processo também é possível realizar a definição dos manuseios através do programa MOUN501, porém o programa não irá gerar as OPs.
Detalhes da interface
Na tabela “Montagem” no programa MOUN063 é possível visualizar várias colunas com detalhes dos IDs.
Na coluna “X” será indicado quais os itens estão selecionados e o que é possível gerar.
Na coluna colorida "Saldo" e cada cor simboliza algo diferente para o ID:
Verde - Saldo disponível;
Amarelo - Saldo parcial;
Vermelho - Saldo indisponível.
Para gerar a ordem de produção é necessário que exista saldo para o ID, caso contrário irá aparecer uma mensagem de erro.
Na coluna “Pedido Venda”. Nesse caso haverá orientação quanto seu armazenamento, informando ao operador que será emitida uma NF de venda ao cliente ao invés de uma NFT automática (de acordo com o programa MORE067) para o estabelecimento centralizador.
Gerando solicitação de OP
Para gerar a ordem de produção basta clicar no ícone “Geração na Ordem de Produção” no cabeçalho do programa.
A partir disso o sistema irá gerar a OP do KIT e irá encaminhar a produção para linhas diferentes:
Tipo de manuseio Interno - Linha 4 - Produção;
Tipo de manuseio Externo - Linha 5 - Ordem de produção;
Tipo de manuseio Operador Interno - Linha 4 - Produção.
É possível conferir detalhes da linha de produção através do programa CD0709.
Após a geração das OP's na linha 4, a quantia dos itens das reservas são alocadas para utilização futura, não sendo possível ser movimentadas no estoque e é possível checar a quantia alocada através do programa CP0513.
É possível consultar mais detalhes das ordens de produção geradas através do programa CD9070.
Monitor de integrações
Após a geração das ordens de produção é possível acompanhar o processo através do programa de monitor MOUN803 - Consulta Integrações Athos.
As OPs com manuseio tipo interno entrará em uma fila para integração no operador logístico - Athos. É possível acompanhar a fila através do programa MOUN808.
Interface
Botões cabeçalho
Seleção - Filtro das OPs
Pesquisar/Atualizar tabelas
Fila do manuseio. Abre o programa MOUN808 onde é possível checar a fila de integrações do manuseio no operador logístico (Athos).
Situação dos serviços - Abre o subprograma MOUN803E onde é possívle checar a situação por local de manuseio.
Relatório Reportes/Geração de Recibos - Relatório dos reportes das montagens realizadas no período.
Ao clicar no botão de relatório o sistema irá abrir o programa MOUN803C e onde é possível gerar um relatório analítico via planilha excel com os movimentos do período informado contendo o preço de montagem (movimento DIV reportada na OP) para que possa ser utilizado para solicitar a NFS ao Operador Logístico (Athos).
Tabela do ID
Campo | Descrição |
|---|---|
Sel | Indica se a linha está selecionada ou não |
Est | Código do estabelecimento |
ID | ID da ordem do KIT gerado no programa MOUN303 |
Manuseio | Tipo do manuseio informado no programa MOUN063 |
Estoque | Tipo de manuseio do estoque |
Ord. Produção | ID da ordem de produção do KIT |
Ord. Parcial | Número da ordem parcial, caso tenha reporte parcial. |
Situação | Situação atual do manuseio |
Erro | Informa caso houver algum erro (sim ou não) |
Tipo Erro | Informa detalhes do erro caso haja |
Situação Externa | Status do pedido |
Ped Compra | Número do pedido de compra |
Ord. Compra | Número da ordem de compra |
Item | Número do item |
Descrição Item | Nome do item |
Qtd | Quantidade do item |
Status Pedido | Integrado ou não |
Status Produto | Integrado ou não |
Status Kit | Integrado ou não |
Status Emb Kit | Integrado ou não |
Status Emb Contenção | Integrado ou não |
Tabela dos detalhes do ID
Campo | Descrição |
|---|---|
Dt Mensagem | Data da mensagem |
Hr Mens | Horário da mensagem |
Usuario | Usuário responsável |
Tipo de Registro | Tipo do registro |
Nr Reporte | Número sequêncial do reporte |
Estabel Transf | Número do estabelecimento de transferência |
Serie Transf | número da série de transferência |
Nota Fiscal Transferência | NFT enviada ao operador logístico (Athos) |
Entrada/Saída |
|
Erro | Se o registro é erro (Sim ou Não) |
Mensagem | Mensagem de retorno |
Justificativa Advertencias | Justificativa |
Data Justificativa | Data da justificativa |
Hora Justificativa | Hora da justificativa |
Usuario Justificativa | Usuário que realizou a justificativa |
Filtros e botões dos ID’s
Filtrar por tipo.
Filtrar por erro.
Refaz o reporte - Quando há alguma inconsistência no ID, o operador logístico (Athos) realiza um reporte informando o problema e a linha do ID ficará em destaque vermelho.
Após feito os ajustes deverá ser refeito o reporte para o operador logístico.
Refaz a TD.
Refaz a NFT - Após feita a TD manualmente é necessário refazer a NFT caso o tipo do manuseio seja externo ou operador interno.
Justifica Advertência - Quando há algum problema durante a produção do(s) KIT(s) o sistema destaca a linha em vermelho. A partir disso é possível ser feito uma justificativa de advertência para que o processo possa prosseguir sem interrupções. O problema ou erro deverá ser corrigido manualmente em paralelo com a montagem do KIT.
O botão retorna detalhes do envio:
Caso seja:
Entrada: Detalhes dos dados da integração (Athos -> Santillana)
Saída: Detalhes dos dados da integração (Santillana -> Athos)
O botão retorna detalhes do retorno:
Caso seja:
Saída: Detalhes de sucesso ou erro na comunicação (Athos -> Santillana)
Entrada: Detalhes de sucesso ou erro na comunicação (Santillana -> Athos)
Botões dos status da última integração
Todos os botões acima mostraram seu respectivo resultado na tela de “Status da última integração” acima deles.
Botões de ações manuais
Para cancelar um pedido de KIT é necessário que ele não tenha sido feito sua produção. Para realizar a ação selecione o ID do KIT e clique no botão “Cancelar Pedido Athos”. Será necessário informar uma justificativa e após sua confirmação o KIT será cancelado e a ação não poderá ser desfeita.
Fila de integração
É possível checar a fila de integração ao clicar no botão do cabeçalho, ele irá abrir o programa MOUN808 - Fila Integração de Manuseio Operador.
odos os itens mostrados na tabela “Manuseio” serão integrados no operador logístico (Athos).
Ocorre a execução padrão de integração de 30 OPs a cada 5 minutos.
Por padrão todos os IDs tem prioridade 99, caso deseje priorizá-los clique com o botão direito sob o ID e clique em “Priorizar”. Essa ação irá alterar sua prioridade para 01 e não poderá ser desfeita.
Integração manual
Caso deseje mais agilidade na integração com o operador logístico (Athos) é possível fazê-las manualmente através do programa MOUN807. Basta informar o número de integrações desejadas e executar.
Integrações Athos
Quando um ID é encaminhado com sucesso para o Operador Logístico, os dados são registrados no seu sistema de gestão.
Da mesma forma, as atualizações de status ocorridas e registradas a partir desse sistema nos são retornadas com a atualização do nosso Monitor.
Erros de integração
Caso exista algum erro de integração o programa MOUN803 irá destacar a linha em vermelho e será possível ver qual erro está ocorrendo (ex. como “Situação Externa: Bloqueado por divergência de preço”).
Erro por divergência de preço - Tabela de Preço
Durante a integração é possível ter divergência no preço por parte interna (ERP) ou externa (Operador logístico).
Para casos internos é necessário reajustar os valores corretamente através da correção da tabela de preço deverá (programa MOUN801). Após isso clique no ícone de raio no cabeçalho para aplicar a correção para que as integrações sejam recalculadas.
Para cadastrar exceções da tabela de preço acesse o programa MOUN800.
Após a correção deverão ser reenviadas novamente para integração com o Operador (Athos) através do MOUN808 ao clicar na linha com o botão direito do mouse, ir em executar e clicar em reenviar. Após isso a OP irá voltar a fila de integração e reiniciar seu processo.
É possível acessar o MOUN808 através do botão no cabeçalho do programa de MOUN803.
O processo de montagem dos KITs irá variar de acordo com o tipo de manuseio, explicados a seguir nesse manual.
Processo do Manuseio por Operador (3º) Interno
Sobre
A montagem dos KITs realizados por operadores internos ocorre em estabelecimento interno e não é cobrado por OP como os outros manuseios. Seu faturamento ocorre somente ao fim do mês quando é gerado o relatório de todas as montagens feitas no período e emitido uma Nota Fiscal de Serviço de cobrança pelas montagens feitas (mão de obra).
O processo
Os manuseios feitos por operadores internos terceirizados serão realizados na linha 4 de processos.
Após a geração da OP do KIT o sistema enviará os seguintes dados do KIT para a Athos para realizar a integração:
Número da ordem de produção;
Item(s);
Quantidade das reservas;
Quantidade das transferências;
Quantidade do pedido de compra.
Após isso a Athos integrará o pedido da montagem e, caso não tenha erros, prosseguirá para conferência, separação dos componentes do KIT e a montagem dele.
Durante o processo, enquanto a produção do KIT não se iniciar é possível cancelar a OP, caso deseje.
Após a montagem a Athos irá reportar ao ERP os dados da montagem:
Número operação;
Item(s);
Quantidade reportada (aca);
Requisições (req) dos componentes que estavam alocados nas OPs do KIT;
Manuseio (div).
No momento do reporte é possível que a produção tenha sido feita parcialmente por diversos motivos, nesse caso o sistema irá dividir os reportes de acordo com sua produção. Para acompanhamento de cada produção o sistema irá dividir os reportes renomeando a OP dele de forma sequencial e terá o detalhe de qual é o ID original.
Ex. a ordem de produção 779947 passará a ser 779947A e 779947B caso seja feito dois reportes, essa informação é possível ser consultada ao clicar no botão “Retorno”.
Mesmo que o reporte da OP seja dividida, o fluxo do processo será o mesmo.
Ao finalizar o processo o status será mostrado que o pedido foi dividido (pedido parcial) e informará o ID de cada pedido com seu sequencial e quantia de itens feitos em cada um.
Descrição do pedido: NUMPEDIDO + Nímero do pedido + sequencial, NUM_ITENS + quantia de itens realizados no pedido.
Após o reporte o sistema realizará automaticamente: requisição dos materiais, geração da entrada do item acabado no estoque e em seguida faz uma movimentação da requisição do valor da montagem através de uma TD.
Caso tenha alguma divergência no reporte o sistema irá destacar a linha de status em vermelho com o descritivo do que houve e aguardará movimentação manual para prosseguir o processo.
Os valores exibidos no relatório no fim do mês são referentes as TDs das montagens feitas.
O sistema irá verificar se o material deve ou não ser transferido de estabelecimento:
Com transferência: O sistema irá emitir a NFT, integrar o manuseio novamente (ERP > Athos > ERP) e realizar a expedição na Athos;
Sem transferência: O sistema fará o faturamento automático pelo programa MOFT058, integrar no faturamento da Athos e ir para a expedição.
Na expedição a Athos verá se o KIT irá ou não para a editora:
Com editora: Será emitido a NFT/NFS de Retorno do Beneficiamento da cobrança de serviço e irá fazer o recebimento no ERP e reportar e NFS. Com isso será feito uma expedição no mesmo estabelecimento e irá faturar ao cliente e finalizar o processo;
Sem editora: Será emitido uma NF de beneficiamento externo de faturamento ao cliente e finalizará o processo.
Fluxo dos status da produção em Operador Logístico
Processo do Manuseio Interno
Quando o manuseio é realizado internamente o sistema irá gerar apenas uma OP que será realizada na linha 4 - Processos.
Após gerada a OP o sistema irá enviá-la para a fila de produção e seu processo de montagem poderá ser acompanhado pelo programa MOUN066.
Após sua montagem feita o sistema irá fazer o faturamento automático através do programa MOFT058 caso esteja vinculado a um pedido de compra e finalizará o processo.
Fluxo dos status da produção interna
Processo do Manuseio Externo
A montagem de KIT por manuseio externo será gerado uma OC para compra dos materiais e OP para a produção e montagem do KIT que será realizada na linha 5 - Ordens de produção.
Após gerada as ordens, sua OC/Pedido de compra juntamente ao material serão enviados ao operador logístico para que seja realizado a montagem do KIT.
No operador logístico (Athos) será integrado o pedido da OC para dar início a produção do KIT. O processo irá iniciar pela conferência do material, separação dos componentes e então será feito a montagem do KIT.
Feito sua montagem será reportado ao ERP os dados da produção e fará uma entrada no recebimento do material acabado junto com a NFS da montagem. No momento da entrada no estoque o sistema irá transferir o material acabado que está em poder de terceiro para o estabelecimento interno correto.
Nesse momento ele irá emitir a NFT, integrar o manuseio novamente (ERP > Athos > ERP) e realizar a expedição na Athos.
Na expedição a Athos verá se o KIT irá para a editora ou não:
Com editora: Será emitido a NFT para a transferência entre estabelecimentos e NFS de Retorno do Beneficiamento da cobrança do serviço pela montagem do KIT, irá fazer o recebimento no ERP e reportar e NFS. Com isso será feito uma expedição e irá faturar ao cliente com a NF de beneficiamento externo, assim finalizando o processo;
Sem editora: Será emitido uma NF de beneficiamento externo de faturamento ao cliente e finalizará o processo.
Fluxo dos status da produção externa
Processo final - Fechamento
Ao iniciar o fechamento, o setor fiscal deverá gerar um relatório para analisar os movimentos realizados no período e gerar a NFS de cobrança ao operador logístico.
Para acessar o relatório será necessário clicar no botão de cifrão no programa MOUN803 e será aberto o subprograma MOUN803C onde é possível conferir com detalhes os valores do preço das montagens do período informado.
É possível gerar um relatório analítico via excel ao clicar no ícone de impressora.
Após conferir o relatório deverá ser selecionado no subprograma os registros desejados que farão parte da cobrança e então clicar no botão "Gerar Recibo", após isso será emitido um número de Recibo que será vinculado as montagens selecionadas e seu status "Cobrado" irá alterar para "Sim".
Após o recibo gerado esses registros serão exibidos ao filtrar as opções "Todos", “Recibo Gerado s/Pedido Compra” e “Recibo Gerado c/Pedido Compra” independente se a cobrança definitiva ocorreu ou não.
Caso precise desfazer a cobrança enquanto ela não foi efetivada, selecione os registros desejados e clique no botão "Cancela Recibo."
Uma vez que o recibo foi gerado eles não necessitam passar por hierarquia de aprovações, pois se trata de um processo com urgência para os trâmites de fechamento.
Caso a montagem possua um pedido de compra vinculado, após a NF do fornecedor gerada o campo "Nro Nota Fiscal" será habilitado e deverá ser informado a natureza de operação e série do documento como parâmetro para a geração do documento de entrada no programa RE1001.
Em caso de desatualização da nota esse registro perderá o vínculo com a NF.
Importante: Caso não tenha a NF antes de iniciar o fechamento deverá ser realizada uma apropriação do valor que será revertida logo após a conclusão do fechamento até que tenha a NF do fornecedor para finalização do processo. Para realizar o processo deverá selecionar o registro, marcar a opção "Apropriação" e clicar no ícone ✅. Com isso o Recibo terá o status "Apropriação provisória" e poderá dar prosseguimento no fechamento.
Após o período do recibo estiver fechado o sistema fará a reversão da apropriação automaticamente.
Importante: O processo de fechamento de estoque só poderá ser feita uma vez que não haja mais reporte de montagens disponíveis. Caso o pagamento da montagem ao fornecedor não deva ser considerada o registro deverá ser justificado através do botão X. (é possível reverter essa decisão apenas durante o período prévio ao fechamento).
É possível conferir o período de fechamento no canto superior do programa.
Fluxograma geral
04. Detalhes Técnicos
Abaixo seguem os detalhes técnicos do programa MOUN803 - Consulta Integrações Athos.
Permissões
Tabelas acessadas
Programa | Tabela | Tipo de ação |
|---|---|---|
MOUN803 | tabela criada/atualizada | |
MOUN803 | Tabela lida |
Programas envolvidos
Programa | Função |
|---|---|
mop\MOUN803c.w | Relatório dos reportes das montagens realizadas no período |
mop\MOUN803e.w | Situação dos serviços |