Entidade HISTORICOS_PEDIDOS

PEDIDOS.HISTORICOS_PEDIDOS

Descrição

Os históricos dos pedidos mantém informações sobre eventos relacionados ao pedido. Alguns históricos são registrados automaticamente pelo pedido, tais como:

Revisão
Aprovação
Cancelamento
etc.

Outros históricos são lançados manualmente através de operações específicas como:

Consumo de materiais
Uso de ferramentas
Execução dos serviços
Apropriações de horas
etc.

Atributos

Atributo	Domínio	Regras	Descrição
ID	ID(18)	Rqd PK	Id: Chave de identificação interna
PEDIDO_ID	ID(18)	Rqd FK	Pedido: Indica o pedido a que este histórico se refere. Referência para PEDIDOS
TIPO_HISTORICO_ID	ID(18)	Rqd FK	Tipo de histórico: Indica o tipo do histórico de pedido registrado e possui várias parametrizações que indicam o comportamento a ser seguido. Referência para TIPOS_HISTORICOS_PEDIDOS
USUARIO_ID	ID(18)	Rqd FK	Usuário: Indica o usuário que informou o histórico. Valor padrão = [USER_ID] Referência para USUARIOS
DATA	DATE_TIME	Rqd	Data do histórico: Data em que o histórico foi realizado. Valor padrão = [SYSDATE]
DATA_INICIO_ATENDIMENTO	DATE_TIME	AK	Data de início do atendimento: Para históricos que representam um evento pontual, informa a data e a hora em que o evento ocorreu. Para históricos que representam uma atividade que consumiu algum tempo, informa a data e a hora em que o evento iniciou.
HORA_INICIO	DAY_TIME(5)		Hora de início: Hora em que a tarefa foi iniciada.
DATA_TERMINO_ATENDIMENTO	DATE_TIME		Data de término do atendimento: Data de término do atendimento pelo técnico.
HORA_TERMINO	DAY_TIME(5)		Hora de término: Hora em que encerrou a tarefa.
DESCRICAO	TEXT_LONG		Descrição: Texto descritivo. Muitas vezes representa o motivo do histórico (motivo do cancelamento, ressalva da aprovação, motivo da revisão, etc.)
TECNICO_RESPONSAVEL_ID	ID(18)	FK	Técnico responsavel: Pessoa que foi responsável pela efetivação deste histórico. Normalmente, seria o técnico que foi responsável pela execução, mas pode ser uma pessoa executando um papel qualquer do ciclo de processo de atendimento do pedido. Referência para PESSOAS
QUANTIDADE	VALUE(18)		Quantidade: Quantidade do produto consumida neste histórico. A grandeza depende da unidade de medida do respectivo produto. No caso de serviços, representa um tempo em horas.
SITUACAO	OPCAO(1)	Rqd AK	Situação: Situação atual do histórico, utilizada para identificar históricos que representam eventos que estão em andamento. Valores permitidos: E - Encerrado - O histórico é atemporal ou já foi encerrado. P - Pendente - O histórico é um evento temporal que está ocorrendo. Existe uma data de início informada mas não existe uma data de término. Valor padrão = E
PRODUTO_ID	ID(18)	FK	Produto: Relacionamento com a entidade de produtos ou serviços. Caso não informado e o tipo de histórico possua um produto, será utilizado o mesmo. Referência para PRODUTOS
DATA_IMPRESSAO	DATE_TIME		Data de impressão: Data de impressão do recibo de saída/entrada.
VENDEDOR_ID	ID(18)	FK	Vendedor: Vendedor que realizou a venda/entrega da mercadoria/serviço Referência para VENDEDORES
ITEM_PEDIDO_ID	ID(18)	FK	Item de pedido: Relacionamento com um item do pedido que gerou o histórico Referência para ITENS_PEDIDOS
ITEM_FICHA_TECNICA_ID	ID(18)	FK	Item da ficha tecnica: Item da ficha técnica do produto, somente deve se preenchido caso o tipo de histórico determine Referência para COMPONENTES_PRODUTOS
ITEM_DOCUMENTO_ID	ID(18)	FK	Item de documento: Quanto ocorrer um registro da produção, deve ficar registrado no histórico a qual item de documento foi gerado para atender a operação. Referência para ITENS_DOC_ENTRADAS_SAIDAS
ARQUIVOS_ANEXO	ATTACHED_FILE_LIST		Arquivos em Anexo: Utilizado para incluir anexos a um histórico.
ITEM_DOCUMENTO_REFERENCIADO_ID	ID(18)	FK	Item de documento referenciado: Item de documento referenciado ao histórico do pedido. P.ex: Item do documento para envio para beneficiamento. Referência para ITENS_DOC_ENTRADAS_SAIDAS
ITEM_PEDIDO_DESTINO_ID	ID(18)	FK	Item pedido destino: Item de pedido no qual a operação feita no histórico reflete. Por exemplo, quando o item do pedido for atendido por outro item de outro pedido. Utilizado em operações que unificam pedidos. Referência para ITENS_PEDIDOS
PESO_INFORMADO	DECIMAL_VALUE		Peso informado: Peso informado para o histórico do pedido

Regras

Preencher produto e pedido

(Antes de inserir)

Quando informado o item de pedido o produto e pedido devem ser preenchidos conforme o informado no item.

Sinalizar o processo correto no pedido

(Depois de inserir)

Sinalizar o pedido (emissão, aprovação, revisão, embarque, etc.) conforme o comportamento programado para o tipo de histórico.

Calcular o número de horas

(Antes de inserir, Antes de alterar)

Calcular o número de horas consumidas neste histórico.

Encerrar histórico anterior da pessoa

(Antes de inserir)

Se configurado no respectivo tipo de histórico, encerra o histórico anterior da mesma pessoa (desde que seja no mesmo dia).

Calcular situação

(Antes de inserir, Antes de alterar)

Se tiver data de início e não tiver data de término, então a situação é "Pendente", caso contrário a situação é "Encerrado".

Atualizar quantidade efetiva do item

(Depois de inserir, Depois de alterar, Depois de excluir)

Somente deve ser executada se informado um produto:
1. Incluir o item no pedido caso não exista um com este produto, mantendo a quantidade 0.
2. Atualizar a quantidade "efetiva" quando ocorrer alterações nos históricos.
3. Quando ocorrer que a quantidade efetiva fique 0, e a quantidade do item estiver 0, deve ser excluído o item.
4. Se a quantidade efetiva ficar negativa, deve dar um erro!

Atualizar o papel da pessoa no pedido

(Depois de inserir)

Atualizar o papel da pessoa caso o tipo de histórico esteja configurado para isso.

Verificar se produto é não autorizado

(Antes de inserir, Antes de alterar)

Verifica se o produto informado foi cancelado ou se o produto/item não foi autorizado pelo cliente (item cancelado) e o tipo de histórico não permite o uso de produtos não autorizados.

Validar ou atualizar o responsável pelo item

(Depois de inserir, Depois de alterar)

Verifica e/ou atualiza o técnico responsável pelo item de pedido conforme definido pelo atributo "Responsável pelo ítens" no respectivo tipo de pedido.

Cancelar documento de produção

(Antes de excluir)

Caso exista um documento vinculado ao histórico, deve ser cancelado.

Somente deve permitir a operação quando o documento não for fiscal.

Não é possível excluir históricos de pedidos!

(Antes de excluir)

Como os históricos registram mudanças de estado no pedido, não é possível simplesmente excluir um histórico. Se um histórico foi inserido erradamente, um novo histórico deverá ser lançado para desfazer a operação.

ATENÇÃO!!!! REGRA REVISAR ESTA REGRA !!! PRECISA ISSO????

Não é possível alterar o tipo de histórico!

(Antes de alterar)

Se o tipo de histórico informado estava errado, será necessário incluir novos históricos.

Data e hora de término deve ser superior a data e hora de início!

(Antes de inserir, Antes de alterar)

Data e hora de término deve ser superior a data e hora de início.

Não é permitido alterar o produto!

(Antes de alterar)

Não permitido alterar o produto do histórico do pedido.

Mostrar itens de pedido duplicados(pedido, produto, item_pedido_id)

Caso o mesmo produto esteja informado em mais de um item do pedido, será apresentado um campo (radio) populado com os itens deste produto.
As opções de itens mostrarão o número do item, a quantidade pedida e a quantidade efetiva atual

Validar pedido informado

(Antes de inserir)

Valida se o pedido informado é do tipo de pedido com categoria "Serviços".