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 de Serviço (OS) de Oficina 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.
Na inclusão das solicitações de materiais, será determinado o tipo de peça ou serviço, conforme mostrado a seguir:
- 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 Compras. Ao definir Tipo de Peça / Serviço como externa ou mão de obra externa, será gerada uma Solicitação de Compra, caso selecione Interna, será gerada uma Solicitação de Armazém.
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 de Compra ou Solicitação de Armazéns 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 Compra;
- 001 - Solicitação de Estoque.
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
- Tipo de Evento: Upsert / Delete
Campos Obrigatórios
- Descrever os campos obrigatórios
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> <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" : "RequestItem", "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 Emrpesa | |
BranchId | String | 10 | Código da Filial | |
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 Item | |
ItemType | Number | 3 | Tipo da solicitação
| |
UnitPrice | Number | 16,6 | Preço Unitário | |
TotalPrice | Number | 16,6 | Preço Total | |
Quantity | Number | 16,6 | Quantidade | |
UnitOfMeasureCode | String | 20 | Código da Unidade de Medida | |
WarehouseCode | String | 20 | Código do Local de Estoque (Armazém) | |
DeliveryDateTime | DateTime | - | Data de entrega ou previsão de entrega do item | |
CostCenterCode | String | 20 | Código do Centro de Custo | |
Observation | String | 500 | Observação |