Histórico da Página
A integração de item consiste na movimentação do cadastro no sentido Datasul para PIMS Multicultivos, ou seja, será realizado no Datasul e enviado para o PIMS Multicultivos através do PIMSConnector. O objetivo é permitir o controle do consumo dos insumos, materiais automotivos, serviços e variedade/híbridos pela sua respectiva classificação.
A integração de item no Datasul é realizado através da "Implantação Item" (CD0204), porém, no PIMS Multicultivos o cadastro pode ser realizado em duas tabelas distintas. Para que a integração ocorra, existe no Datasul a classificação do item que determina o tipo do item, se é genérico, produto ou insumo. Nesta integração é possível incluir, alterar e excluir um item. Os campos do cadastro de item do Datasul a serem considerados na integração, não são apenas os campos obrigatórios, mas todos os necessários ao funcionamento da integração.
Item (Item)
Identificador da Mensagem: Item
Versão: 3.001
Módulo do Datasul: Cadastros Gerais
Módulo do PIMS Multicultivos: (Tabelas > Insumos > Insumos) - (Tabelas > Manutenção > Material)
Tipo de Envio: Assíncrona
Tipo de Evento: Upsert / Delete
Adapter Datasul: ItemAdapter.cls
Classe Datasul: ItemFactory.cls
API de Integração Datasul: cdp/cdapi998.p
TAGS DA MENSAGEM | DATASUL | PIMS | ||
---|---|---|---|---|
Tabela | Campo | Tabela | Campo | |
Code | ITEM | IT-CODIGO | INSUMO | CD_INT_ERP |
Name | ITEM | DESC-ITEM | INSUMO | DE_INSUMO |
ProductType | ITEM | GE-CODIGO | INSUMO | - |
UnitOfMeasureCode | ITEM | UN | INSUMO | ID_UNIMEDIDA |
Trail | ITEM | LOTE-ECONOMI | INSUMO | FG_CTRL_LOTE |
StockGroupCode | ITEM | GE-CODIGO | INSUMO | ID_GRPINSUMO |
Code | ITEM | IT-CODIGO | MATERIAL | CD_INT_ERP |
Name | ITEM | DESC-ITEM | MATERIAL | DE_MATERIAL |
ProductType | ITEM | GE-CODIGO | MATERIAL | - |
UnitOfMeasureCode | ITEM | UN | MATERIAL | ID_UNIMEDIDA |
StockGroupCode | ITEM | GE-CODIGO | MATERIAL | ID_GRPMATERIAL |
Nota
A integração de item permite escolher como será tratada a formação do código do item no PIMS Multicultivos, seja de forma sequencial ou respeitando o código informado no ERP.
Para funcionamento em modo sequencial, é necessário alterar o parâmetro abaixo no PIMS Multicultivos, conforme descrito abaixo:
Nome Parâmetro | Contexto | Descrição | Valor |
---|---|---|---|
FG_PRODUTO_SEQ | PIMSGRAOS.EAI | Integração Insumo/Material: Determina se o código será sequencial ou será igual ao código ERP | Sim |
Para funcionamento em modo normal, é necessário alterar o parâmetro no PIMS Multicultivos, conforme descrito abaixo:
Nome Parâmetro | Contexto | Descrição | Valor |
---|---|---|---|
FG_PRODUTO_SEQ | PIMSGRAOS.EAI | Integração Insumo/Material: Determina se o código será sequencial ou será igual ao código ERP | Não |
A classificação do item no PIMS Multicultivos é realizada de acordo com a informação da tag "ProductType" enviada na mensagem de integração pelo Datasul. A seguir é descrito as três possíveis classificações existente no Datasul:
- 1 - Genérico: não suportado pelo PIMS Multicultivos, se enviado ocorrerá falha na integração;
- 2 - Produto: é integrado no PIMSMulticultivos como material;
- 3 - Insumo: é integrado no PIMS Multivcultivos como insumo.
Importante: O campo classificação do item só é apresentado no programa "CD0204" do Datasul, quando o parâmetro "Agroindústria" estiver habilitado no Cadastro Gerais de Parâmetros (CD0101) na pasta "Módulos I'.
Através do programa "CD1112" (Itens x Estabelecimentos) também é disparado está integração, mas como o PIMS não utiliza o relacionamento de item versos estabelecimento, a integração envia somente as informações do primeiro estabelecimento exportado. Também ocorre esta integração nos programas de exportação que chamam os programas "CD0204K1" (Exportação de Itens), "CD0138A" (Exportação Dados Item) e "CD0134A" (Exportação Dados Família) ao clicar no botão "OK".
Campos Obrigatórios para o Funcionamento da Integração
- Código;
- Descrição;
- Tipo;
- Unidade;
- Grupo.
Fluxo das Informações
O cadastro de item é realizado no Datasul e integrado com PIMS Multicultivos conforme fluxo ilustrado abaixo:
draw.io Diagram | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Limitações e Restrições
- Esta integração está disponível a partir da versão 12.1.21 do Datasul, PIMSConnector e PIMS Multicultivos;
- Caso já exista o cadastro item em ambos os sistemas e precisa ser habilitado o processo de integração, será necessário ajustar o cadastro do PIMS Multicultivos, informando o código do Datasul no campo "Código ERP" do PIMS Multicultivos, para depois realizar a movimentação das integrações. Caso isto não seja feito, o processo de integração não funcionará corretamente, gerando inconsistência nas informações trafegadas entre os aplicativos;
- É necessário que o grupo de produto informado no Datasul esteja devidamente cadastro no PIMS Multicultivos, caso contrário, a integração não funcionará corretamente;
- É necessária que a unidade de medida informada no cadastro de produtos no Datasul, esteja devidamente cadastrada no PIMS Multicultivos, caso contrário, a integração não funcionará corretamente;
- A integração de itens para o PIMS Multicultivos é realizada somente em modo compartilhado entre as unidades administrativas;
- A exclusão do insumo e material somente será realizada caso não haja relacionamento com as tabelas abaixo:
DESCRITIVO | TABELA |
---|---|
Apontamento de Abastecimento – detalhe | APABASTEC_DE |
Apontamento de Insumos - Detalhes (Insumo) | APAPLINS_INS |
Apontamento de Aplicação de Insumos - detalhe (insumos x locais) | APAPLINS_INSLC |
Apontamento de Aplicação de Insumos - Locais/Áreas Aplicadas | APAPLINS_LC |
Apontamento de utilização de produtos/embalagens | APEMBALAGEM |
Apontamento de Lubrificação – detalhe | APLUBRIF_DE |
Apontamento de Ordem de Serviço - Campo - Recursos | APORDSERVICO_CO |
Embalagens da Ordem de Serviço | APORDSERVICO_EMB |
Insumos da OS integrados com ERP | APORDSERVICO_INS_ERP |
Apontamento de Ordem de Serviço (solicitação de material) - Oficina Mecânica | APOSOFIC_SOL_MAT |
Apontamento de Plantio | APPLANTIO_IN |
Apontamento de Planejamento de Pulverização (fitossanidade) - insumos x locais | APPROGPULV_INSLC |
Apontamento de Tratamento de Semente - Insumos | APTRATSEMENT_IN |
Apontamento de Tratamento de Semente - Locais aplicados | APTRATSEMENT_LC |
Insumos consumidos no Lote de Beneficiamento | BF_LOTE_INS |
Plano Mestre para Consumo de Insumos - (Detalhe) | BF_PLMCOINS_DE |
Produção Final - Classificado/Beneficiado | BF_PRODUCAO |
Consumo Médio de Combustível x Modelo/Eqpto | CONSMEDIO |
Produtos a serem utilizados no Beneficiamento por Equipamento | EQUIPTO_PUBENEF |
Fitossanidades - Insumos recomendados | FITOSSANID_INS |
Grupo Produto - Produtos Beneficiados / Acabados para Cultura/Ocupação | OCUPACAO_GRPINS_BF |
Grupo Produto - Matéria Prima (produto colhido in natura) para Cultura/Ocupação | OCUPACAO_GRPINS_MP |
Produtos Terminados (beneficiados) por Ocupação | OCUPACAO_PRODT |
Insumos Permitidos/Não Permitidos por Operação | OPERACAO_INS |
Ordem de Colheita – Locais | ORDCOLHEITA_LC |
Plano Mestre de Lubrificação (detalhe) | PLANOLUBRIF_DE |
Produtos Beneficiados | PRODBENEF |
Produtos serão calculadas Receitas dos Locais Produção segundo o Contrato | RC_CONTRATO_PRO |
Descontos calculados sobre as Receitas do Local de Produção | RC_DESCONTO_LC |
Cadastro de Produtos com incidência de Desconto | RC_DESCONTO_PRO |
Receitas calculadas para o Local de Produção | RC_RECEITA_LC |
Materiais x Eventos do Conta Corrente | SV_MATER_EVENTO |
Produtos utilizados no beneficiamento do turno | TURNOBENEF_PRODU |
Variedades/Cultivares | VARIEDADE |
Variedade do Insumo | VARIEDADE_INS |