Solicitação de Compra/Armazém

Contexto de negócio (Introdução)

Adapter responsável pela integração de Solicitações de Compra/Armazém.

Modulo RM	Identificador	Versão	Forma de Envio	Tipo do Adapter
Gestão Estoque / Suprimentos	REQUEST	1.009	Síncrona	Envio
	REQUEST	1.008	Síncrona	Envio
	REQUEST	1.000	Síncrona	Recebimento
	REQUEST	1.008	Síncrona	Recebimento
	REQUEST	1.009	Síncrona	Recebimento

Mapeamento de Campos

REQUEST (RECEBIMENTO)

Regras de Integridade:

O local de estoque do primeiro item de movimento será utilizado como local de estoque da capa (movimento), uma vez que este campo é obrigatório e não é enviado pelo Protheus.
O tipo de movimento para Solicitação de Compras será obtido a partir do parâmetro 'TMVSolicitacaoCompra'.
O tipo de movimento para Solicitação de Armazém será obtido a partir do parâmetro 'TMVSolicitacaoArmazem'.
Solicitações de compra criadas a partir de Pedidos de Materias (Extra ou não) somente poderão ser excluídos no TOP, retornando erro ao Protheus caso o mesmo tente efetuar a exclusão.
Solicitações de compra que possuírem Ordem de Manutenção vinculada na mensagem deverão ter seu tipo de movimento parametrizado com integração com SigaMNT.

Versão 1.000

Mensagem Padrão	Descrição	Tabela	Campo	Observação
CompanyInternalId	Chave externa da Filial	TMOV	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
CompanyInternalId	Chave externa da Filial	TMOV	CODFILIAL	Código da Filial é obtido a partir do De-Para.
Number	Número do Movimento	TMOV	NUMEROMOV
RegisterDateTime	Data de Emissão	TMOV	DATAEMISSAO
DeliveryDateTime	Data de Entrega	TMOV	DATAENTREGA
AbatementDateTime	Data de Dedução	TMOV	DATADEDUCAO
Series	Série do Movimento	TMOV	SERIE
Type	Tipo de Solicitação			Campo utilizado na identificação do tipo de Solicitação, conforme descrito abaixo. "000": Solicitação de compra "001": Solicitação de armazém
CustomerVendorInternalId	Cliente/Fornecedor	TMOV	CODCFO CODCOLCFO	Código do Cli/For é obtido a partir do De-Para.
PaymentConditionInternalId	Condição de Pagamento	TMOV	CODCPG	O código é obtido a partir do De-Para.
MainOrderInternalId	Chave externa da Ordem de Manutenção			Chave do movimento referente à Ordem de Manutenção vinculada.
Observation	Observação	TMOV	OBSERVACAO
RequestItem - CompanyInternalId	Chave externa da Filial	TMOV	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
RequestItem - CompanyInternalId	Chave externa da Filial	TMOV	CODFILIAL	Código da Filial é obtido a partir do De-Para.
RequestItem - ItemInternalId	Produto	TITMMOV	IDPRD	O código é obtido a partir do De-Para.
RequestItem - UnitOfMeasureInternalId	Unidade de Medida	TITMMOV	CODUND	O código é obtido a partir do De-Para.
RequestItem - Quantity	Quantidade	TITMMOV	QUANTIDADE
RequestItem - UnityPrice	Valor Unitário	TITMMOV	PRECOUNITARIO
RequestItem - TotalPrice	Valor Líquido	TITMMOV	VALORLIQUIDO
-	Sequencial do Item de Movimento	TITMMOV	NSEQITMMOV	Sequencial é gerado a inclusão e obtido no De-Para na alteração.
RequestItem - Code	Número Sequencial do Item de Movimento	TITMMOV	NUMEROSEQUENCIAL
RequestItem - WarehouseInternalId	Local de Estoque	TITMMOV	CODLOC	O código é obtido a partir do De-Para.
RequestItem - DeliveryDateTime	Data de Entrega	TITMMOV	DATAENTREGA
RequestItem - CostCenterInternalId	Centro de Custo	TITMMOV	CODCCUSTO	O código é obtido a partir do De-Para.
RequestItem - ProjectInternalId	Projeto	TITMMOV	IDPRJ	O código é obtido a partir do De-Para.
RequestItem - TaskInternalId	Tarefa	TITMMOV	IDTRF	O código é obtido a partir do De-Para.
ApportionRequestItem - CompanyInternalId	Chave externa da Filial	TITMMOVRATCCU	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
ApportionRequestItem - CompanyInternalId	Chave externa da Filial	TITMMOVRATCCU	CODFILIAL	Código da Filial é obtido a partir do De-Para.
ApportionRequestItem - ProjectInternalId	Projeto	TITMMOVRATCCU	IDPRJ	O código é obtido a partir do De-Para.
ApportionRequestItem - TaskInternalId	Tarefa	TITMMOVRATCCU	IDTRF	O código é obtido a partir do De-Para.
ApportionRequestItem - CostCenterInternalId	Centro de Custo	TITMMOVRATCCU	CODCCUSTO	O código é obtido a partir do De-Para.
ApportionRequestItem - TotalValue	Valor Total	TITMMOVRATCCU	VALOR
ApportionRequestItem - Percentual	Percentual	TITMMOVRATCCU	PERCENTUAL
ApportionRequestItem - Quantity	Quantidade	TITMMOVRATCCU	QUANTIDADE
ApportionRequestItem - Observation	Observação	TITMMOVRATCCU	HISTORICO

Versão 1.008

As versões são cumulativas, tendo assim todos os campos da versão anterior adicionando os campos listados abaixo.

Mensagem Padrão	Descrição	Tabela	Campo	Observação
UserRequesterInternalId	Usuário do Item de Movimento	TMOV	CODUSUARIO
CompanyInternalId	Chave externa da Filial	TMOV	CODFILIAL

Versão 1.009

As versões são cumulativas, tendo assim todos os campos da versão anterior adicionando os campos listados abaixo.

Mensagem Padrão	Descrição	Tabela	Campo	Observação
RequestItem - QuantityReached	Quantidade atendida	TITMMOV	QTDATENDIDA

REQUEST (Envio)

Regras de Integridade:

O campo 'Type' será obtido a partir do tipo de movimento recebido e os parâmetros 'TMVSolicitacaoCompra' e 'TMVSolicitacaoArmazem'.

Versão 1.008

Mensagem Padrão	Descrição	Tabela	Campo	Observação
CompanyInternalId	Chave externa da Filial	TMOV	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
CompanyInternalId	Chave externa da Filial	TMOV	CODFILIAL	Código da Filial é obtido a partir do De-Para.
Number	Número do Movimento	TMOV	NUMEROMOV
RegisterDateTime	Data de Emissão	TMOV	DATAEMISSAO
DeliveryDateTime	Data de Entrega	TMOV	DATAENTREGA
AbatementDateTime	Data de Dedução	TMOV	DATADEDUCAO
Series	Série do Movimento	TMOV	SERIE
Type	Tipo de Solicitação	TMOV	CODTMV	Campo preenchido pela da identificação do tipo de Solicitação a partir dos respectivos parâmetros "TMVSolicitacaoCompra" = "000" "TMVSolicitacaoArmazem" = "001"
UserRequesterCode	Código do Usuário	TMOV	CODUSUARIO
UserRequesterInternalId	InternalId do Usuário	TMOV	CODUSUARIO
UserRequesterName	Usuário	TMOV	CODUSUARIO
PaymentConditionCode	Condição de Pagamento	TMOV	CODCPG
PaymentConditionInternalId	InternalId da Condição de Pagamento	TMOV	CODCOLIGADA\|CODCPG	O código é obtido a partir do De-Para para preenchimento com GUID.

ApportionRequest - CompanyInternalId	Chave externa da Filial	TITMMOVRATCCU	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
ApportionRequest - ProjectInternalId	Projeto	TITMMOVRATCCU	CODCOLIGADA\|IDPRJ	O código é obtido a partir do De-Para para preenchimento com GUID.
ApportionRequest - TaskInternalId	Tarefa	TITMMOVRATCCU	CODCOLIGADA\|IDPRJ\|IDTRF	O código é obtido a partir do De-Para para preenchimento com GUID.
ApportionRequest - CostCenterInternalId	Centro de Custo	TITMMOVRATCCU	CODCOLIGADA\|CODCCUSTO	O código é obtido a partir do De-Para para preenchimento com GUID.
ApportionRequest - TotalValue	Valor Total	TITMMOVRATCCU	VALOR
ApportionRequest - Percentual	Percentual	TITMMOVRATCCU	PERCENTUAL
ApportionRequest - Observation	Observação	TITMMOVRATCCU	HISTORICO

RequestItem - InternalId	Chave do Item de Movimento	TITMMOV	CODCOLIGADA\|IDMOV\|NSEQITMMOV	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - CompanyInternalId	Chave externa da Filial	TMOV	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
RequestItem - CompanyInternalId	Chave externa da Filial	TMOV	CODFILIAL	Código da Filial é obtido a partir do De-Para.
RequestItem - Code	Número Sequencial do Item de Movimento	TITMMOV	NSEQITMMOV
RequestItem - ItemCode	Produto	TITMMOV	IDPRD
RequestItem - ItemInternalId	Produto	TITMMOV	CODCOLPRD\|IDPRD	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - UnitOfMeasureCode	Unidade de Medida	TITMMOV	CODUND
RequestItem - UnitOfMeasureInternalId	Unidade de Medida	TITMMOV	CODUND	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - Quantity	Quantidade	TITMMOV	QUANTIDADE
RequestItem - UnitPrice	Valor Unitário	TITMMOV	PRECOUNITARIO
RequestItem - TotalPrice	Valor Líquido	TITMMOV	VALORLIQUIDO
RequestItem - WarehouseCode	Local de Estoque	TITMMOV	CODLOC
RequestItem - WarehouseInternalId	Local de Estoque	TITMMOV	CODCOLIGADA\|CODFILIAL\|CODLOC	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - DeliveryDateTime	Data de Entrega	TITMMOV	DATAENTREGA
RequestItem - CostCenterCode	Centro de Custo	TITMMOV	CODCCUSTO
RequestItem - CostCenterInternalId	Centro de Custo	TITMMOV	CODCOLIGADA\|CODCCUSTO	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - ProjectInternalId	Projeto	TITMMOV	CODCOLIGADA\|IDPRJ	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - TaskInternalId	Tarefa	TITMMOV	CODCOLIGADA\|IDPRJ\|IDTRF	O código é obtido a partir do De-Para para preenchimento com GUID.
RequestItem - Observation	Observação	TITMMOV	HISTORICOCURTO

ApportionRequestItem - CompanyInternalId	Chave externa da Filial	TITMMOVRATCCU	CODCOLIGADA	Código da Coligada é obtido a partir do De-Para de Filial.
ApportionRequestItem - CompanyInternalId	Chave externa da Filial	TITMMOVRATCCU	CODFILIAL	Código da Filial é obtido a partir do De-Para.
ApportionRequestItem - ProjectInternalId	Projeto	TITMMOVRATCCU	CODCOLIGADA\|IDPRJ	O código é obtido a partir do De-Para para preenchimento com GUID.
ApportionRequestItem - TaskInternalId	Tarefa	TITMMOVRATCCU	CODCOLIGADA\|IDPRJ\|IDTRF	O código é obtido a partir do De-Para para preenchimento com GUID.
ApportionRequestItem - CostCenterInternalId	Centro de Custo	TITMMOVRATCCU	CODCOLIGADA\|CODCCUSTO	O código é obtido a partir do De-Para para preenchimento com GUID.
ApportionRequestItem - TotalValue	Valor Total	TITMMOVRATCCU	VALOR
ApportionRequestItem - Percentual	Percentual	TITMMOVRATCCU	PERCENTUAL
ApportionRequestItem - Quantity	Quantidade	TITMMOVRATCCU	QUANTIDADE

Versão 1.009

As versões são cumulativas, tendo assim todos os campos da versão anterior adicionando os campos listados abaixo.

Mensagem Padrão	Descrição	Tabela	Campo	Observação
UserRequesterName	Usuário do Movimento	TITMMOV	CODUSUARIOCRIACAO	Na versão 1.009 caso o campo CODUSUARIOCRIACAO esteja preenchido o mesmo será usado no preenchimento do campo UserRequesterName, caso contrário será mantido o uso do campo CODUSUARIO.