Registro de entregas
Registro de entregas — Suprimentos (ERPAtak)
A rotina Registro de entregas, do módulo Suprimentos (menu Recebimento), é onde o usuário registra a chegada da mercadoria de um pedido de compra.
Visão Geral
A rotina Registro de entregas, do módulo Suprimentos (menu Recebimento), é onde o usuário registra a chegada da mercadoria de um pedido de compra. A listagem mostra, uma linha por item, os itens dos pedidos de compra (documentos do perfil SUP0104) da filial que estão “201 – Aguardando Entrega” ou “202 – Entregue”. Ao abrir uma linha, a tela “Registrar entrada” mostra os dados da carga de entrada (tipo de movimento de frete, documento da carga, datas, veículo, motorista, transportadora, valores e observação). Ao registrar a entrega, o sistema grava a carga (perfil SUP0201, “Carga – Compra de suprimentos”) com a mesma chave do pedido, vincula a carga ao pedido e leva todos os itens do pedido para “202 – Entregue”, acompanhando os itens de orçamento, cotação e solicitação de origem. A tela também permite cancelar a entrega: o sistema exclui a carga, desvincula o pedido e devolve os itens do pedido para “201 – Aguardando Entrega”. A rotina não cria pedidos: o pedido nasce do processo de compra (solicitação, cotação, orçamento e pedido).
Pré-requisitos
- Pedidos de compra do perfil SUP0104, com data de entrega informada e itens em “201 – Aguardando Entrega” (ou “202 – Entregue”, para consultar ou corrigir uma entrega já registrada).
- Parâmetro de suprimentos 7006 (Tipo de documento para cargas de entrada): documento usado na numeração da carga. Sem ele, ao abrir uma entrega ainda não registrada o sistema recusa com a mensagem do Troubleshooting.
- Configuração geral 160 (tipo de movimento de frete da compra): valor inicial do campo Tipo mvto. frete ao abrir uma entrega nova. Se não houver conteúdo, a tela abre sem dados.
- Série ativa de numeração para o documento do parâmetro 7006 na filial logada, de onde vêm a série e o número iniciais da carga.
- Data de movimentação do usuário, que preenche as datas de movimento e competência iniciais.
Permissões e Acesso
Recursos de menu do Registro de entregas
A rotina aparece no menu Suprimentos > Recebimento como recurso 1125 (“Registro de entregas”), com ordem 0 no grupo. O usuário só vê a opção de menu se o seu grupo tiver acesso a esse recurso. Os títulos em inglês e espanhol são “Delivery Register” e “Registro de Entregas”.
| Recurso | Ação protegida |
|---|---|
| 1125 | Abrir a tela de listagem de entregas |
| 1126 | Registrar a entrega (gravar a carga e atualizar os itens) |
| 1127 | Exportar a listagem |
| 5888 | Cancelar a entrega (menu “Cancelar Entrega”) |
Quando o grupo do usuário não tem acesso a uma ação protegida, o sistema responde “Você não tem permissão para acessar este recurso”.
Ações do Registro de entregas sem conferência de recurso
Duas ações não conferem o grupo do usuário: listar as entregas e abrir uma entrega (carregar os dados da carga). Mesmo sem conferência de recurso, a listagem usa a filial informada ou, se vier vazia, a filial logada do usuário. A carga dos dados de uma entrega nova usa o usuário logado (série ativa, cadastro geral e data de movimentação).
Regras de permissão dentro do serviço
O serviço de registro e de cancelamento da entrega não confere a ação “Editar” do usuário no tipo de movimento do pedido, nem o perfil de filial: vale somente a conferência dos recursos 1126 e 5888.
Fluxo Operacional
Fluxo de registro de uma entrega
- O usuário abre Suprimentos > Recebimento > Registro de entregas; a tela abre “Lista de Entregas pendentes”.
- Confere os filtros do painel “Filtros” (Filial e período da data de entrega já vêm preenchidos) e aciona “Buscar”.
- Dá duplo clique numa linha (ou aciona “Edição”); a tela abre “Registrar entrada” com o número do pedido.
- Informa o veículo, o motorista, a transportadora, o tipo de frete e os valores, quando houver, e revisa data, hora e competência.
- Aciona “Registrar Entrega” (ou “Registrar Entrega e Fechar”). O sistema grava a carga e passa os itens do pedido para “202 – Entregue”.
Fluxo de cancelamento de uma entrega
- O usuário abre a linha do pedido na tela “Registrar entrada”.
- Aciona “Cancelar Entrega” e confirma a pergunta.
- O sistema exclui a carga, limpa o vínculo do pedido com a carga e devolve os itens do pedido para “201 – Aguardando Entrega”. A tela avisa, atualiza a listagem e fecha a aba.
Interface e Comportamentos da Tela
Listagem de entregas pendentes
A listagem do Registro de entregas mostra uma linha por item de pedido, com 30 linhas por página, ordenada por data de entrega decrescente quando o usuário não escolhe outra ordem. A coluna Chave de fato fica oculta.
| Coluna | Conteúdo |
|---|---|
| Documento | Filial, tipo de documento, série e número do pedido, separados por hífen |
| Fornecedor | Código do fornecedor |
| Nome | Nome do fornecedor |
| CNPJ/CPF | Documento do fornecedor, com máscara |
| Dt. compra | Data da compra do pedido, formato dd/mm/aa |
| Dt. entrega | Data de entrega do pedido, formato dd/mm/aa |
| Item | Código e referência do item, separados por ponto |
| Nome | Nome do item |
| Estágio | Estágio do item, por exemplo “201 – Aguardando Entrega” |
Filtros da listagem de entregas
Os filtros ficam num painel “Filtros”, recolhido ao abrir. Campos:
- Filial: obrigatória; vem preenchida com a filial logada.
- Dt. entrega inicial e Dt. entrega final: obrigatórias; vêm preenchidas com a data de movimentação do usuário.
- Dt. compra inicial e Dt. compra final: opcionais.
- Cod. doc. (tipo de documento), Série (até 3 caracteres) e Número.
- Item: busca por código ou por código e referência.
- Fornecedor e CNPJ/CPF (até 18 caracteres).
- Chave de fato (até 18 caracteres).
- Estágio: a lista mostra somente “201 – Aguardando entrega” e “202 – Entregue”.
- Buscar aplica os filtros; Limpar esvazia todos os campos, inclusive Filial e as datas de entrega, que precisam ser preenchidas de novo antes de buscar.
Barra de ferramentas da listagem de entregas
A barra “Suprimentos -> Entregas pendentes” oferece “Edição” (Ctrl + E, abre a entrega da linha selecionada), “Exportar” para Excel, Word, PDF e HTML, e “Fechar Aba” (Ctrl + O). Há também a barra “Personalizar Listagens”.
Janela de registro de entrada
A janela “Registrar entrada” tem o grupo “Registro de entrega”, com os campos abaixo. Filial, Série, Documento, Número e Chave de fato ficam protegidos (somente leitura). O foco inicial vai para Tipo mvto. frete.
| Campo | Obrigatório | Observação |
|---|---|---|
| Tipo mvto. frete | Sim | Lista de tipos de movimento de frete; inicia com a configuração geral 160 |
| Filial | Sim | Protegido; inicia com a filial logada |
| Série | Sim | Protegido; até 3 caracteres; inicia com a série ativa do documento do parâmetro 7006 |
| Documento | Sim | Protegido; inicia com o documento do parâmetro 7006 |
| Número | Sim | Protegido; inicia com o próximo número da sequência |
| Chave de fato | Sim | Protegido; é a chave do pedido de compra |
| Data (movimentação) | Sim | Formato dd/mm/aa; inicia com a data de movimentação do usuário |
| Hora | Não | Máscara de hora; inicia com a hora atual no formato HH:mm |
| Competência | Sim | Formato dd/mm/aa; inicia com a data de movimentação do usuário |
Campos de veículo, motorista e observação
| Campo | Obrigatório | Observação |
|---|---|---|
| Caminhão | Não | Placa do veículo |
| Carreta | Não | Segunda placa do veículo |
| Tipo veículo | Não | Lista de tipos de veículo |
| KM ent. | Não | Quilometragem de entrada |
| KM saida | Não | Quilometragem de saída |
| Motorista | Não | Pesquisa de motoristas |
| Transportadora | Não | Pesquisa de transportadoras |
| Tipo frete | Não | Lista de tipos de frete |
| Vlr. Unit. | Não | Valor com 2 casas decimais |
| Vlr. total | Não | Valor com 2 casas decimais, digitado pelo usuário |
| Observação | Não | Texto de até 1024 caracteres |
Ao abrir uma entrega já registrada, a janela mostra os dados gravados na carga. Ao abrir uma entrega ainda não registrada, mostra os valores iniciais descritos acima.
Barra de ferramentas da janela de registro
A barra de ferramentas da janela oferece:
- Registrar Entrega (Ctrl + S): grava e mantém a janela aberta.
- Registrar Entrega e Fechar (Ctrl + Alt + S).
- Cancelar Entrega (Ctrl + D).
- Cancelar (“Desfazer alterações”, também Ctrl + D): descarta as alterações do formulário.
- Fechar Aba (Ctrl + O).
Os dois botões de gravação usam os nomes “Registrar Entrega” e “Registrar Entrega e Fechar” no lugar de “Salvar”. O atalho Ctrl + D está atribuído a “Cancelar Entrega” e a “Cancelar”.
Feedbacks ao Usuário
Feedbacks da listagem e do registro da entrega
| Situação | Feedback | Texto exato |
|---|---|---|
| Buscar sem Filial ou sem as datas de entrega | Informação “Registro de entregas” | “Por favor, preencha todos os parâmetros para realizar a pesquisa.” |
| Entrega registrada com sucesso | Informação “Registro de entregas” | “Registro de entregas salvo.” |
Feedbacks do cancelamento da entrega
| Situação | Feedback | Texto exato |
|---|---|---|
| Cancelar sem chave do pedido na janela | Informação “Registro de entregas” | “Nenhum pedido selecionado para cancelar a entrega.” |
| Pergunta de confirmação | Confirmação “Registro de entregas” | “Deseja cancelar a entrega selecionada?” |
| Entrega cancelada | Informação “Registro de entregas” | “Entrega cancelada com sucesso.” |
As validações do sistema aparecem como mensagem padronizada com três partes, Erro, Motivo e Solução, ou como texto único. Os textos estão em Troubleshooting.
Regras de Negócio
Itens que aparecem no Registro de entregas
A listagem do Registro de entregas inclui só itens de pedidos de compra do perfil SUP0104 da filial, com data de entrega (Dt. entrega) dentro do período informado, e cujo item esteja em um destes estágios:
| Estágio | Descrição |
|---|---|
| 201 | Aguardando Entrega |
| 202 | Entregue |
Qualquer outro estágio (por exemplo “200 – Aguardando Liberação” ou “203 – Cancelado”) não aparece, mesmo que o filtro Estágio seja usado.
Filtros da listagem de entregas
- Filial e datas de entrega: a tela exige Filial, Dt. entrega inicial e Dt. entrega final antes de buscar; o sistema usa a filial logada e a data de hoje quando esses valores não chegam.
- Dt. compra: filtra pela data da compra do pedido, maior ou igual à inicial e menor ou igual à final.
- Cod. doc., Série, Número, Chave de fato, Fornecedor: igualdade exata com o documento, a série, o número, a chave do pedido e o código do fornecedor.
- CNPJ/CPF: a máscara é retirada e o sistema compara com o documento do fornecedor por igualdade.
- Item: sem ponto, filtra pelo código do produto; com ponto, o texto antes do ponto é o produto e o texto depois é a referência.
- Estágio: igualdade com o código do estágio do item.
- Não há limite de período nem uso do parâmetro 7013 nesta listagem.
Pesquisa livre na listagem de entregas
A pesquisa livre interpreta o texto digitado assim:
- Número inteiro: busca por código do fornecedor igual, filial igual ao texto, série igual ao texto, número do documento igual, CNPJ/CPF contendo o texto, código do produto contendo o texto ou nome do produto contendo o texto.
- Data no formato brasileiro: busca pela data de compra ou pela data de entrega do pedido.
- Outro texto: se contém “.” ou “/”, o sistema retira “/”, “-” e “.”; depois busca por filial igual, série igual, tipo de documento igual, nome do fornecedor contendo o texto, CNPJ/CPF contendo o texto, código do produto contendo o texto ou nome do produto contendo o texto.
Ordenação da listagem de entregas
Sem ordenação escolhida, a listagem ordena por data de entrega decrescente. Ao ordenar por uma coluna, vale só a primeira coluna escolhida. A coluna Documento ordena por filial, tipo de documento, série e número; Item ordena pelo código do produto; Estágio, pelo código do estágio; coluna sem regra própria volta à data de entrega decrescente.
Validação de datas e hora do registro da entrega
O registro só é aceito quando:
- a data de movimento é igual ou anterior à data de hoje do sistema;
- a competência está preenchida e é igual ou anterior à data de hoje do sistema;
- a hora está preenchida e, comparada como texto HH:mm, é igual ou anterior à hora atual do sistema.
A comparação da hora é feita com a hora atual de qualquer dia: uma data de movimento anterior a hoje também precisa de hora igual ou anterior à hora atual. Reprovando qualquer condição, o sistema recusa com a mensagem de data ou hora maior que a atual.
Gravação da carga da entrega
A carga é gravada com a mesma chave de fato do pedido, com o perfil SUP0201. Campos gravados a partir da tela: tipo de movimento de frete, filial, série, número da carga, data de movimento, competência, hora, placas, tipo de veículo, KM ent. (quilometragem anterior), KM saida (quilometragem), motorista (e o nome dele), transportadora, valor unitário, valor total e observação. O participante da carga é o fornecedor do pedido.
- Valor total: é gravado como digitado; o sistema não o calcula a partir do valor unitário.
- Tipo frete: numa carga já existente o tipo de frete não é alterado pela tela; numa carga nova vale o valor informado.
- Número da carga: vale o número mostrado na tela. O sistema também consome o próximo número da sequência do documento ao registrar, de modo que a sequência avança a cada registro.
Estágios que o registro da entrega atribui aos itens
Ao registrar a entrega, para cada item do pedido de compra (todos os itens do pedido, não apenas o da linha), o sistema aplica:
| Documento | Estágio atribuído |
|---|---|
| Item do pedido | 202 – Entregue |
| Item de orçamento de origem | 37 – Orçamento Entregue |
| Item de cotação de origem | 25 – Cotação Entregue |
| Item de solicitação de origem | 8 – Solicitação Entregue |
A subida pelos documentos de origem só continua enquanto o item tem documento, item e subitem de origem informados: sem origem no pedido, só o item do pedido muda; sem origem no orçamento, a cotação e a solicitação não mudam; sem origem na cotação, a solicitação não muda.
Estágios que o cancelamento da entrega atribui aos itens
Ao cancelar a entrega, todos os itens do pedido voltam para “201 – Aguardando Entrega”. Os itens de orçamento, cotação e solicitação de origem não são alterados pelo cancelamento: permanecem em “37 – Orçamento Entregue”, “25 – Cotação Entregue” e “8 – Solicitação Entregue”. O cancelamento exige a chave do pedido, exclui a carga vinculada e limpa do pedido a chave, a série e o número da carga. Ele não confere se a entrega estava registrada.
Efeito do registro e do cancelamento em outros documentos
O registro grava no pedido de compra a chave da carga, a série e o número da carga, e cria (ou atualiza) a carga de entrada do perfil SUP0201 com a chave do pedido. O cancelamento desfaz esse vínculo e exclui a carga. Os estágios de orçamento, cotação e solicitação seguem a tabela acima.
Relatórios e Exportações
Exportação da listagem de entregas
A exportação do Registro de entregas exige o recurso 1127. Ela gera o arquivo “SolicitacaoDeCompras” (nome fixo, igual ao de outra rotina) em Excel, Word, PDF ou HTML, com até 1000 linhas, sem aplicar os filtros da tela: valem apenas a filial logada e a data de entrega igual à data de hoje do sistema, e os itens em “201 – Aguardando Entrega” ou “202 – Entregue”.
Integrações
Documentos de origem do pedido
O registro e o cancelamento da entrega atuam no pedido de compra e, no registro, sobem pela cadeia pedido, orçamento, cotação e solicitação conforme as regras de estágio. As cargas de entrada (perfil SUP0201) também aparecem nas rotinas de logística, que consultam as movimentações de frete.
Troubleshooting
Registro recusado: data ou hora maior que a atual
Mensagem exibida: Erro “Não foi possível Salvar”, Motivo “As datas de movimentação, competência e/ou a hora não podem ser maiores que a data atual do servidor. Data atual: {0}, Hora atual: {1}”, Solução “Favor corrijas as datas de movimentação e tente novamente.”
Cenário: data de movimento ou competência posterior a hoje, competência em branco, hora em branco ou hora posterior à hora atual do sistema.
O que fazer: corrigir data, competência e hora para valores até o momento atual e registrar de novo.
Abertura da entrega recusada: tipo de documento para cargas não definido
Mensagem exibida: “Nenhum documento definido para o parametro 7006 – Tipo de documento para cargas de entrada”
Cenário: o usuário abre uma entrega ainda não registrada e o parâmetro 7006 está vazio.
O que fazer: configurar o parâmetro 7006 (Customização -> Parâmetros -> Suprimentos).
Cancelamento recusado: chave de fato inválida
Mensagem exibida: “Chave de Fato inválida”
Cenário: o cancelamento chegou ao sistema sem a chave do pedido.
O que fazer: reabrir a entrega pela listagem e repetir o cancelamento.
Cancelamento recusado: pedido de compra não encontrado
Mensagem exibida: Erro “Erro ao localizar pedido de compra.”, Motivo “Nenhum pedido de compra foi encontrado para o ID informado.”, Solução “Verifique se o ID está correto e se o pedido está devidamente cadastrado no sistema.”
O que fazer: atualizar a listagem e confirmar se o pedido ainda existe.
Ação recusada: sem permissão no recurso
Mensagem exibida: “Você não tem permissão para acessar este recurso”
Cenário: o grupo do usuário não tem o recurso 1126 (registrar), 1127 (exportar) ou 5888 (cancelar entrega).
O que fazer: pedir ao administrador que libere o recurso da ação.
Busca bloqueada: parâmetros de pesquisa em branco
Mensagem exibida: Informação “Registro de entregas”: “Por favor, preencha todos os parâmetros para realizar a pesquisa.”
Cenário: Filial, Dt. entrega inicial ou Dt. entrega final em branco, por exemplo depois de usar “Limpar”.
O que fazer: preencher Filial e o período de entrega e acionar “Buscar”.
Cancelamento bloqueado: nenhum pedido selecionado
Mensagem exibida: Informação “Registro de entregas”: “Nenhum pedido selecionado para cancelar a entrega.”
Cenário: a janela não tem a chave do pedido.
O que fazer: reabrir a entrega pela listagem e acionar “Cancelar Entrega” de novo.
Item ou pedido não aparece na listagem
Mensagem exibida: Nenhuma — o pedido não aparece na grade.
Cenário: o pedido não é do perfil SUP0104; a data de entrega está fora do período do filtro; a filial é outra; o item não está em “201 – Aguardando Entrega” ou “202 – Entregue”; ou algum filtro (fornecedor, item, documento) não combina.
O que fazer: conferir o período de Dt. entrega, a Filial e o estágio do item do pedido.
Entrega cancelada, mas solicitação, cotação e orçamento continuam como entregues
Mensagem exibida: Nenhuma — o cancelamento conclui com “Entrega cancelada com sucesso.”.
Cenário: o cancelamento devolve só os itens do pedido a “201 – Aguardando Entrega”; os itens de origem permanecem em “37 – Orçamento Entregue”, “25 – Cotação Entregue” e “8 – Solicitação Entregue”.
O que fazer: registrar a entrega de novo, se for o caso, ou tratar os estágios de origem fora desta rotina.
Janela de registro abre em branco
Mensagem exibida: Nenhuma — a janela “Registrar entrada” abre sem dados.
Cenário: a entrega ainda não foi registrada e a configuração geral 160 (tipo de movimento de frete da compra) está sem conteúdo.
O que fazer: configurar a configuração geral 160.
Casos de Uso
Caso 1 — Registro da entrega de um pedido
O pedido 1-PC-A-120 do fornecedor “Papelaria Exemplo Ltda” está com os itens “201 – Aguardando Entrega”. O usuário filtra pela data de entrega do dia, abre a linha, informa a placa do caminhão, o motorista e a observação “Entrega na doca 2” e aciona “Registrar Entrega e Fechar”. O sistema grava a carga com a chave do pedido e passa todos os itens do pedido para “202 – Entregue”, os de orçamento para “37 – Orçamento Entregue”, os de cotação para “25 – Cotação Entregue” e os de solicitação para “8 – Solicitação Entregue”.
Caso 2 — Correção dos dados de uma entrega já registrada
O usuário filtra pelo estágio “202 – Entregue”, abre o pedido e corrige o valor do frete e a transportadora. Ao acionar “Registrar Entrega”, o sistema atualiza a carga existente e reaplica os estágios de entrega aos itens.
Caso 3 — Cancelamento de uma entrega registrada por engano
O usuário abre o pedido na janela “Registrar entrada” e aciona “Cancelar Entrega”. Confirma “Deseja cancelar a entrega selecionada?”. O sistema exclui a carga, desvincula o pedido e devolve os itens do pedido para “201 – Aguardando Entrega”; a tela avisa “Entrega cancelada com sucesso.” e fecha a aba.
Caso 4 — Registro recusado por hora futura
Às 10:30, o usuário informa a hora 11:00 e aciona “Registrar Entrega”. O sistema recusa com “Não foi possível Salvar” e a janela continua aberta. O usuário corrige a hora para 10:30 ou anterior e registra de novo.
Caso 5 — Consulta das entregas do mês de um fornecedor
O usuário informa a Filial, o período de Dt. entrega do mês, escolhe o Fornecedor no filtro e aciona “Buscar”. A listagem mostra os itens desse fornecedor em “201 – Aguardando Entrega” e “202 – Entregue”, ordenados pela data de entrega mais recente.