Histórico da Página
Tem como objetivo registrar os serviços e materiais utilizados pelos mecânicos nas manutenções dos equipamentos, sendo que a inclusão é realizada através da Ordem ordem de Serviço serviço (OS) de Oficina Mecânicaoficina mecânica.
O PIMS Multicultivos é responsável por gerar a OS e apontar os materiais que serão solicitados ao ERP, identificando para cada material qual o procedimento para sua obtenção, se é aquisição ou consumo de estoque. O ERP por sua vez iniciará o processo de compra, para os casos de aquisição, e o processo de solicitação ao armazém, para os casos de consumo de estoque.
...
- Interna: Peças que movimentarão o estoque, caso não existam em estoque, será gerado processo de compras;
- Externa: Peças que realizarão processo de compras;
- Mão de Obra Externa: Mão de Obra que serão executadas por terceiros.
A opção "Tipo de Peça / Serviço", informada no cadastro de solicitação de materiais do PIMS, influencia diretamente no comportamento da integração, pois essa opção determina qual processo será criado, seja uma Solicitação de Armazém ou Solicitação de Comprassolicitação de armazém (estoque) ou solicitação de compras. Ao definir Tipo de Peça / Serviço o tipo de peça ou serviço como externa ou mão de obra externa, será gerada uma Solicitação solicitação de Compracompra, caso selecione "Interna", será gerada uma Solicitação de Armazémsolicitação de armazém (estoque).
draw.io Diagram | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
O campo "Tipo de Peça ou / Serviço" será representado na mensagem Request pelas tags Type e ItemType. A identificação de Solicitação solicitação de Compra compra ou Solicitação solicitação de Armazéns armazém pelo ERP, deverá ser realizada através da tag Type. O preenchimento da tag Type, será realizado pelo PIMS , quando o usuário definir o "Tipo de Peça / Serviço", segue abaixo os valores válidos para a tag Type:
- 000 - Solicitação de Compracompra;
- 001 - Solicitação de Estoqueestoque.
Informações da Mensagem
- Identificador da Mensagem: Request
- Versão: 1.009
- Módulo PIMS Multicultivos: Apontamentos > Manutenção > Serviços de Oficina
- Tipo de Envio: Assíncrona / Síncrona
Campos Enviados na Integração
- Código da Movimentaçãomovimentação;
- Origem do Apontamentoapontamento;
- Tipo de Movimentomovimento;
- Código da Empresaempresa;
- Identificador Único único da Requisiçãorequisição;
- Usuário Requisitanterequisitante;
- Data da Requisiçãorequisição;
- Número do Boletim boletim PIMS;
- Código do Itemitem;
- Código da Referenciareferencia;
- Código do Itemitem;
- Quantidade Solicitadasolicitada;
- Unidade de Medidamedida;
- Depósito;
- Centro de Custocusto;
- Conta Contábilcontábil;
- Observação.
Exemplos de Mensagens
Mensagem XML
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <TOTVSMessage> <MessageInformation version="1.009"> <BranchId>D MG 01</BranchId> <CompanyId>T1</CompanyId> <DeliveryType>Sync</DeliveryType> <GeneratedOn>2018-04-12T15:56:20</GeneratedOn> <Product name="PIMS" version="12.1.21"/> <SourceApplication>PIMSCONNECTOR</SourceApplication> <StandardVersion>1.000</StandardVersion> <Transaction>Request</Transaction> <Type>BusinessMessage</Type> <UUID>c109c32f-0bdc-4889-a826-05bf70b39613</UUID> </MessageInformation> <BusinessMessage> <BusinessEvent> <Entity>Request</Entity> <Event>upsert</Event> </BusinessEvent> <BusinessContent> <Code>28434</Code> <InternalId>T1|D MG 01|1111188197030017682</InternalId> <Origin>OS-PED</Origin> <Number>28434</Number> <Type>001</Type> <CompanyId>T1</CompanyId> <RequestNumberUniqueId>94979208</RequestNumberUniqueId> <BranchId>D MG 01</BranchId> <UserRequesterCode>Filipe</UserRequesterCode> <UserRequesterName>Filipe</UserRequesterName> <Series>PMSS</Series> <RegisterDateTime>2018-04-12</RegisterDateTime> <NumberPIMS>28434</NumberPIMS> <ListOfRequestItem> <RequestItem> <Code>2</Code> <InternalId>T1|D MG 01|7672781010605401745</InternalId> <ItemCode>75841</ItemCode> <ItemInternalId>||585537277071829039</ItemInternalId> <ItemReferenceCode/> <ItemType>000</ItemType> <UnitPrice>0</UnitPrice> <TotalPrice>0</TotalPrice> <Quantity>100.0000</Quantity> <UnitOfMeasureCode>UN</UnitOfMeasureCode> <UnitOfMeasureInternalId>||1645600824977155300</UnitOfMeasureInternalId> <WarehouseCode>77</WarehouseCode> <WarehouseInternalId>||8778181452619063920</WarehouseInternalId> <DeliveryDateTime>2018-04-12</DeliveryDateTime> <CostCenterCode>98854</CostCenterCode> <CostCenterInternalId>||5297406413088842707</CostCenterInternalId> <Observation/> <ListOfApportionRequestItem> <ApportionRequestItem/> </ListOfApportionRequestItem> </RequestItem> </ListOfRequestItem> </BusinessContent> </BusinessMessage> </TOTVSMessage> |
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <TOTVSMessage> <MessageInformation version="1.009"> <BranchId>D MG 01 </BranchId> <CompanyId>T1</CompanyId> <DeliveryType>Sync</DeliveryType> <GeneratedOn>2018-04-12T19:02:17Z</GeneratedOn> <Product name="ERP" version="12"/> <SourceApplication>P12_DEV_WST1</SourceApplication> <StandardVersion>1.000</StandardVersion> <Transaction>REQUEST</Transaction> <Type>Response</Type> <UUID>3970962b-8b46-7515-9f07-bee154049fb3</UUID> </MessageInformation> <ResponseMessage> <ProcessingInformation> <ProcessedOn>2018-04-12T19:02:17Z</ProcessedOn> <Status>ok</Status> </ProcessingInformation> <ReceivedMessage> <SentBy>PIMS</SentBy> <UUID>c109c32f-0bdc-4889-a826-05bf70b39613</UUID> </ReceivedMessage> <ReturnContent> <ListOfInternalId> <InternalId> <Destination>T1|D MG 01|000001</Destination> <Name>Request</Name> <Origin>T1|D MG 01|1111188197030017682</Origin> </InternalId> <InternalId> <Destination>T1|D MG 01|000001|02|12/04/2018</Destination> <Name>RequestItem<<Name>RequestInternalId</Name> <Origin>T1|D MG 01|7672781010605401745</Origin> </InternalId> </ListOfInternalId> </ReturnContent> </ResponseMessage> </TOTVSMessage> |
Mensagem JSON
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "TOTVSMessage" : { "MessageInformation" : { "@version" : "1.009", "BranchId" : "D MG 01", "CompanyId" : "T1", "DeliveryType" : "Sync", "GeneratedOn" : "2018-04-12T15:56:20", "Product" : { "@name" : "PIMS", "@version" : "12.1.21" }, "SourceApplication" : "PIMSCONNECTOR", "StandardVersion" : "1.000", "Transaction" : "Request", "Type" : "BusinessMessage", "UUID" : "c109c32f-0bdc-4889-a826-05bf70b39613" }, "BusinessMessage" : { "BusinessEvent" : { "Entity" : "Request", "Event" : "upsert" }, "BusinessContent" : { "Code" : "28434", "InternalId" : "T1|D MG 01|1111188197030017682", "Origin" : "OS-PED", "Number" : "28434", "Type" : "001", "CompanyId" : "T1", "RequestNumberUniqueId" : "94979208", "BranchId" : "D MG 01", "UserRequesterCode" : "Filipe", "UserRequesterName" : "Filipe", "Series" : "PMSS", "RegisterDateTime" : "2018-04-12", "NumberPIMS" : "28434", "ListOfRequestItem" : { "RequestItem" : { "Code" : "2", "InternalId" : "T1|D MG 01|7672781010605401745", "ItemCode" : "75841", "ItemInternalId" : "||585537277071829039", "ItemReferenceCode" : null, "ItemType" : "000", "UnitPrice" : "0", "TotalPrice" : "0", "Quantity" : "100.0000", "UnitOfMeasureCode" : "UN", "UnitOfMeasureInternalId" : "||1645600824977155300", "WarehouseCode" : "77", "WarehouseInternalId" : "||8778181452619063920", "DeliveryDateTime" : "2018-04-12", "CostCenterCode" : "98854", "CostCenterInternalId" : "||5297406413088842707", "Observation" : null, "ListOfApportionRequestItem" : { "ApportionRequestItem" : null } } } } } } } |
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "TOTVSMessage" : { "MessageInformation" : { "@version" : "1.009", "BranchId" : "D MG 01 ", "CompanyId" : "T1", "DeliveryType" : "Sync", "GeneratedOn" : "2018-04-12T19:02:17Z", "Product" : { "@name" : "ERP", "@version" : "12" }, "SourceApplication" : "P12_DEV_WST1", "StandardVersion" : "1.000", "Transaction" : "REQUEST", "Type" : "Response", "UUID" : "3970962b-8b46-7515-9f07-bee154049fb3" }, "ResponseMessage" : { "ProcessingInformation" : { "ProcessedOn" : "2018-04-12T19:02:17Z", "Status" : "ok" }, "ReceivedMessage" : { "SentBy" : "PIMS", "UUID" : "c109c32f-0bdc-4889-a826-05bf70b39613" }, "ReturnContent" : { "ListOfInternalId" : { "InternalId" : [ { "Destination" : "T1|D MG 01|000001", "Name" : "Request", "Origin" : "T1|D MG 01|1111188197030017682" }, { "Destination" : "T1|D MG 01|000001|02|12/04/2018", "Name" : "RequestItemRequestInternalId", "Origin" : "T1|D MG 01|7672781010605401745" } ] } } } } } |
Descrição Detalhada das Tags
SEGMENTO | TAGS | TIPO | TAMANHO | DESCRITIVO DA TAG |
---|---|---|---|---|
BusinessEvent | Entity | String | 50 | Nome da entidade que gerou o evento |
Event | String | 10 | Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração ou delete – eliminação) | |
BusinessContent | Code | String | 25 | Código da solicitação |
Number | String | 25 | Número da solicitação | |
Type | String | 3 | Tipo da solicitação
| |
CompanyId | String | 20 | Código da Emrpesaempresa | |
BranchId | String | 10 | Código da Filialfilial | |
UserRequesterCode | String | 25 | Código do usuário requisitante | |
UserRequesterName | String | 25 | Nome do usário requisitante | |
RegisterDateTime | DateTime | - | Data de emissão da solicitação | |
NumberPIMS | String | 22 | Número da solicitação no PIMS | |
RequestItem | - | - | Lista de itens da requisição | |
Code | String | 25 | Código do item da solicitação | |
ItemCode | String | 20 | Código do Itemitem | |
ItemType | Number | 3 | Tipo da solicitação
| |
UnitPrice | Number | 16,6 | Preço Unitáriounitário | |
TotalPrice | Number | 16,6 | Preço Totaltotal | |
Quantity | Number | 16,6 | Quantidade | |
UnitOfMeasureCode | String | 20 | Código da Unidade unidade de Medidamedida | |
WarehouseCode | String | 20 | Código do Local local de Estoque estoque (Armazémarmazém) | |
DeliveryDateTime | DateTime | - | Data de entrega ou previsão de entrega do item | |
CostCenterCode | String | 20 | Código do Centro centro de Custocusto | |
Observation | String | 500 | Observação |
Resposta da Solicitação
...
Compras e Armazém (Estoque)
Na resposta da Integração de Solicitação Compras / Armazémintegração de solicitação de compra e de armazém, o ERP ao enviar a mensagem com o status de processamento das solicitações (Sucesso sucesso ou Erroerro), deverá preencher a estrutura da tag ListOfInternalId, conforme ilustrado abaixo, pois essas informações serão essenciais para o atendimento dos materiais solicitados.
Exemplo da Estrutura da Tag - ListOfInternalId no formatado XML
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<ListOfInternalId> <InternalId> <Destination>T1|D MG 01|000001|02</Destination> <Name>RequestItem<<Name>RequestInternalId</Name> <Origin>T1|D MG 01|7672781010605401745</Origin> </InternalId> </ListOfInternalId> |
Exemplo da estrutura da Tag – ListOfInternalId no formatado Json
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "ListOfInternalId" : { "InternalId" : { "Destination" : "T1|D MG 01|000001|02", "Name" : "RequestItemRequestInternalId", "Origin" : "T1|D MG 01|7672781010605401745" } } } |
Descrição Detalhadas das Tags
SEGMENTO | TAGS | DESCRITIVO DA TAG |
---|---|---|
ListOfInternalId | Destination | Tag composta pelas seguintes informações: Empresa|Filial|Código da Movimentação movimentação ERP|SquenciaSequencia Exemplo: T1|D MG 01|000001|02 |
Name | Deverá ser preenchida com "RequestItemRequestInternalId" | |
Origin | Retornar o conteúdo enviado pelo PIMSConnector |
...
Atendimento da Solicitação de Compras
...
e Solicitação de Armazém (Estoque)
Tem como objetivo atender os Materiais Requisitados materiais requisitados na Solicitação solicitação de Materiais materiais da Ordem ordem de Oficinaoficina, seja Solicitação de Compra ou ou Solicitação de Armazém. O atendimento da Solicitação solicitação de Materiais materiais da Ordem ordem de Oficina oficina utiliza a mensagem "StockTurnOver"..
Exemplos de Mensagens
Mensagem XML
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="1.005">
<BranchId>D MG 01</BranchId>
<CompanyId>T1</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-04-27T17:48:07</GeneratedOn>
<Product name="PIMS" version="12.1.21"/>
<SourceApplication>PIMSCONNECTOR</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>StockTurnOver</Transaction>
<Type>BusinessMessage</Type>
<UUID>f71bc5a1-907b-4e92-bba6-523648f6d358</UUID>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>StockTurnOver</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<Code>46546546</Code>
<InternalId>T1|D MG 01|1235464582823451998</InternalId>
<Number>46546546</Number>
<Type>S</Type>
<MovementTypeCode>510</MovementTypeCode>
<DocumentType>28</DocumentType>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<Series/>
<RegisterDateTime>2018-04-27 00:00:00.0</RegisterDateTime>
<ListOfStockTurnoverItem>
<StockTurnoverItem>
<Code>200</Code>
<InternalId>T1|D MG 01|I4151082686999853407</InternalId>
<EmissionDate>2018-04-27 00:00:00.0</EmissionDate>
<ItemCode>200</ItemCode>
<ItemInternalId>||3188980518467137755</ItemInternalId>
<UnitPrice>0</UnitPrice>
<TotalPrice>0</TotalPrice>
<Quantity>1.0000</Quantity>
<UnitOfMeasureCode>UN</UnitOfMeasureCode>
<UnitOfMeasureInternalId>||1645600824977155300</UnitOfMeasureInternalId>
<WarehouseCode>12</WarehouseCode>
<WarehouseInternalId>||1243787465212347649</WarehouseInternalId>
<BinLocation/>
<NumberSeries/>
<LotOrSerialNumber/>
<LotExpirationDate/>
<CostCenterCode>10023</CostCenterCode>
<CostCenterInternalId>||7314408448087859654</CostCenterInternalId>
<AccountantAcountCode/>
<Observation/>
<MainOrderCode/>
<FieldWorkOrderCode>0</FieldWorkOrderCode>
<FieldWorkOrderInternalId/>
</StockTurnoverItem>
</ListOfStockTurnoverItem>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> |
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="1.005">
<BranchId>D MG 01 </BranchId>
<CompanyId>T1</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-04-27T20:52:11Z</GeneratedOn>
<Product name="ERP" version="12"/>
<SourceApplication>P12_DEV_WST1</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>STOCKTURNOVER</Transaction>
<Type>Response</Type>
<UUID>532a0999-e0b6-dea9-d7d4-69ae500fc8cf</UUID>
</MessageInformation>
<ResponseMessage>
<ProcessingInformation>
<ProcessedOn>2018-04-27T20:52:11Z</ProcessedOn>
<Status>ok</Status>
</ProcessingInformation>
<ReceivedMessage>
<SentBy>PIMS</SentBy>
<UUID>f71bc5a1-907b-4e92-bba6-523648f6d358</UUID>
</ReceivedMessage>
<ReturnContent>
<ListOfInternalId>
<InternalId>
<Destination>T1|D MG 01|000000013|000790</Destination>
<Name>StockTurnover</Name>
<Origin>T1|D MG 01|1235464582823451998</Origin>
</InternalId>
</ListOfInternalId>
</ReturnContent>
</ResponseMessage>
</TOTVSMessage> |
Mensagem JSON
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "1.005",
"BranchId" : "D MG 01",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-04-27T17:48:07",
"Product" : {
"@name" : "PIMS",
"@version" : "12.1.21"
},
"SourceApplication" : "PIMSCONNECTOR",
"StandardVersion" : "1.000",
"Transaction" : "StockTurnOver",
"Type" : "BusinessMessage",
"UUID" : "f71bc5a1-907b-4e92-bba6-523648f6d358"
},
"BusinessMessage" : {
"BusinessEvent" : {
"Entity" : "StockTurnOver",
"Event" : "upsert"
},
"BusinessContent" : {
"Code" : "46546546",
"InternalId" : "T1|D MG 01|1235464582823451998",
"Number" : "46546546",
"Type" : "S",
"MovementTypeCode" : "510",
"DocumentType" : "28",
"CompanyId" : "T1",
"BranchId" : "D MG 01",
"Series" : null,
"RegisterDateTime" : "2018-04-27 00:00:00.0",
"ListOfStockTurnoverItem" : {
"StockTurnoverItem" : {
"Code" : "200",
"InternalId" : "T1|D MG 01|I4151082686999853407",
"EmissionDate" : "2018-04-27 00:00:00.0",
"ItemCode" : "200",
"ItemInternalId" : "||3188980518467137755",
"UnitPrice" : "0",
"TotalPrice" : "0",
"Quantity" : "1.0000",
"UnitOfMeasureCode" : "UN",
"UnitOfMeasureInternalId" : "||1645600824977155300",
"WarehouseCode" : "12",
"WarehouseInternalId" : "||1243787465212347649",
"BinLocation" : null,
"NumberSeries" : null,
"LotOrSerialNumber" : null,
"LotExpirationDate" : null,
"CostCenterCode" : "10023",
"CostCenterInternalId" : "||7314408448087859654",
"AccountantAcountCode" : null,
"Observation" : null,
"MainOrderCode" : null,
"FieldWorkOrderCode" : "0",
"FieldWorkOrderInternalId" : null
}
}
}
}
}
} |
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "1.005",
"BranchId" : "D MG 01 ",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-04-27T20:52:11Z",
"Product" : {
"@name" : "ERP",
"@version" : "12"
},
"SourceApplication" : "P12_DEV_WST1",
"StandardVersion" : "1.000",
"Transaction" : "STOCKTURNOVER",
"Type" : "Response",
"UUID" : "532a0999-e0b6-dea9-d7d4-69ae500fc8cf"
},
"ResponseMessage" : {
"ProcessingInformation" : {
"ProcessedOn" : "2018-04-27T20:52:11Z",
"Status" : "ok"
},
"ReceivedMessage" : {
"SentBy" : "PIMS",
"UUID" : "f71bc5a1-907b-4e92-bba6-523648f6d358"
},
"ReturnContent" : {
"ListOfInternalId" : {
"InternalId" : {
"Destination" : "T1|D MG 01|000000013|000790",
"Name" : "StockTurnover",
"Origin" : "T1|D MG 01|1235464582823451998"
}
}
}
}
}
} |
Para o funcionamento do atendimento dos materiais solicitados, é necessário que o ERP preencha a tag RequestItemInternalIdPara o funcionamento do atendimento dos materiais solicitados, é necessário que o ERP preencha a tag "RequestItemInternalId". Está tag será a junção das informações empresa, filial, número da solicitação do armazém e número da sequência do item, com estas informações será possível identificar no PIMS em qual solicitação o atendimento foi realizado.
É importante ressaltar que as informações presentes na tag RequestItemInternalId deverão ser as mesmas retornadas na Resposta resposta de Solicitação solicitação de Compras compras / Armazéns armazém (ResquestRequest), caso contrário o PIMSConnector não conseguirá atualizar o status da solicitação no PIMS.
O atendimento no PIMS, iniciará com as atualizações de algumas informações das Solicitações solicitações de Materiaismateriais, bem como:
- Situação da Solicitação: Identifica se o atendimento foi de forma Parcial parcial ou Totaltotal;
- Valor Unitário Previsto: Valor unitário enviado pelo ERP no momento do atendimento;
- Número da Solicitação: Número da solicitação gerada no ERP;
- Status: Situação de processamento da integração.
Após atualizar as informações da Solicitação solicitação de Materiaismateriais, é iniciado o preenchimento da Aba Materiais aba materiais aplicados. Os Materiais materiais aplicados têm como responsabilidade demonstrar o histórico dos materiais atendidos e os valores dos materiais a serem utilizados para o processamento de custo. A inclusão das informações na aba de materiais aplicados, finaliza o fluxo da integração de Solicitações solicitações de Materiais materiais da Ordem ordem de Serviço serviço de Oficinaoficina.