Histórico da Página
...
- 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 (estoque) ou solicitação de compras. Ao definir 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 solicitação de Armazém armazém (Estoqueestoque).
draw.io Diagram | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
O campo Tipo tipo de Peça peça ou Serviço 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ção;
- Origem do apontamento;
- Tipo de movimento;
- Código da empresa;
- Identificador único da requisição;
- Usuário requisitante;
- Data da requisição;
- Número do boletim PIMS;
- Código do item;
- Código da referencia;
- Código do item;
- Quantidade solicitada;
- Unidade de medida;
- Depósito;
- Centro de custo;
- Conta contá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> <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 emrpesaempresa | |
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 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 do Processo de Solicitação de Armazém (Estoque)
Na resposta da integração de solicitação de armazém, o ERP ao enviar a mensagem com o status de processamento das solicitações (sucesso ou erro), 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> <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" : "RequestItem", "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 "RequestItem" | |
Origin | Retornar o conteúdo enviado pelo PIMSConnector |
Resposta do Processo de Solicitação de Compras
Tem como objetivo atender os materiais requisitados na solicitação de materiais da ordem de oficina, seja Solicitação de Compra ou Solicitação de Armazém. O atendimento da solicitação de materiais da ordem de 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 } } } } } } |
...