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 | |
| REQUEST | 1.011 | Síncrona/Assincrona | 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;
- A partir da versão 1.010 o centro de custo do movimento será determinado pelo centro de custo do primeiro item do movimento, uma vez que este campo não está disponível entre os campos de movimento da mensagem;
- Caso a integração seja com o NG Quirons então se tratará de solicitação ou devolução de EPI e o tipo do movimento a ser criado será de acordo com o abaixo:
- O tipo de movimento para Solicitação de EPI será obtido a partir do parâmetro 'TMVEpiSolicitacao'.
- O tipo de movimento para Devolução de EPI será obtido a partir do parâmetro 'TMVEpiDevolucao'.
- Para as demais integrações o comportamento será:
- O tipo de movimento para Solicitação de Armazém será obtido a partir do parâmetro 'TMVSolicitacaoArmazem'.
- 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.
- Caso a integração seja com o NG Quirons então se tratará de solicitação ou devolução de EPI e o tipo do movimento a ser criado será de acordo com o abaixo:
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. |
| 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. |
| 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. |
| 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 |
Versão 1.011
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 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Type | Tipo de Solicitação | Campo utilizado na identificação do tipo de solicitação conforme descrito abaixo
Mais detalhes ver nas regras de integridade acima. | |||||||||||
| SellerCode | Código do vendedor | ||||||||||||
| SellerInternalId | InternalId do Vendedor | TMOV | CODCOLIGADA|CODVEN2 | O código do vendedor é obtido a partir do De-Para observando este SellerInternalId e de um vendedor (seller) integrado previamente. |
REQUEST (Envio)
Regras de Integridade:
- O gatilho de integração foi migrado para os assinantes de Inclusão e Exclusão, partindo do parâmetro "CodMensagemIntegracao" do tipo de movimento para identificar a necessidade de disparar o gatilho ou não.
- O campo 'Type' será obtido a partir do parâmetro "CodMensagemIntegracao" do tipo de movimento recebido no gatilho.
- Este campo será preenchido somente no configurador neste primeiro projeto, devendo ser adicionado em tela durante projetos de integração que necessitem de alteração do usuário.
- Atualmente são utilizados na mensagem Request os códigos para o parâmetro listados abaixo:
- Código "0" = Sem Integração
- Código "1" = Solicitação de Compra
- Código "2" = Solicitação de Armazém
- Código "3" = Solicitação de Histórico
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. |
| 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 identificação do parâmetro "CodMensagemIntegracao" do tipo de movimento, conforme listado nas regras de integridade. |
| 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. |
| 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. |
| 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. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas