Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

O Protheus recebe e disponibiliza dados a partir de suas APIs como também envia dados utilizando as APIs do Quírons.

Para que o Protheus envie mensagens a comunicação aconteça os seguintes passos serão necessários:

...

MensagemRotina
ITEMMATA010 
UNITOFMEASUREQIEA030
WAREHOUSEAGRA045
STOCKTURNOVERMATA241
STOCKLEVELMATA225
REQUESTMATA105

...

idMENSAGENS
effectTypefade

...

id1
labelITEM
effectTypefade

A mensagem ITEM irá realizar o envio das informações do cadastro de produtos (MATA010) para o Quírons que irá consumir as seguintes tag's contidas na mensagem:

...

CompanyId

...

BranchId

...

ItemDescription

...

StandardCostPrice

...

Expandir
titleExemplo de mensagem JSON

{
   "Header":{
      "BusinessUnit":"MG ",
      "ProductName":"PROTHEUS",
      "Transaction":"ITEM",
      "Version":"4.005",
      "UUID":"989bd96b-e333-0b74-f6da-2ac8d4c7f625",
      "Event":"upsert",
      "CompanyId":"T1",
      "GeneratedOn":"2022-04-20T13:49:25Z",
      "BranchId":"D MG 01 ",
      "DeliveryType":"Async",
      "Type":"BusinessMessage",
      "CompanySharingMode":"E",
      "BusinessUnitySharingMode":"E",
      "StandardVersion":"1.000",
      "BranchSharingMode":"E",
      "SubType":"event",
      "Enterprise":"D ",
      "SourceApplication":"QUIRONS",
      "ProductVersion":"12"
   },
   "Content":{
      "ItemStatus":"2",
      "StandardWarehouseInternalId":"T1|D MG|33",
      "ItemTitle":"                                                                                                    ",
      "ItemWidth":"0",
      "CompanyId":"T1",
      "UnitOfMeasureCode":"Q5",
      "Code":"PRODQUIRONS01",
      "FiscalInformation":{
         "CsllAliquot":"0",
         "IrrfIncidence":"false",
         "IssServiceCode":"         ",
         "PisRetaining":"false",
         "CsllRetaining":"false",
         "PisAliquot":"0",
         "CofinsAliquot":"0",
         "TaxSubstitutionCode":"         ",
         "CofinsRetaining":"false",
         "IssAliquot":"0",
         "MunicipalTaxCod":"                    "
      },
      "ItemLenght":"0",
      "EconomicLot":"0",
      "Name":"PRODUTO PADRAO",
      "MinimumLot":"0",
      "ManufacturerCode":"                    ",
      "ItemHeight":"0",
      "NetWeight":"0",
      "Values":{
         "CostPrice":"0",
         "SalesPrice":"0",
         "AverageCostPrice":"0",
         "StandardCostPrice":"0"
      },
      "Brand":"",
      "ShortName":"PRODUTO PADRAO",
      "Active":"1",
      "MultiplicationFactorValue":"0",
      "CompanyinternalId":"T1|D MG 01 ",
      "InternalId":"T1|D MG 01|PRODQUIRONS01",
      "ProductType":"10",
      "GrossWeight":"0",
      "ItemFeaturesTechnical":"",
      "ItemDescription":"",
      "ItemDimensions":"0",
      "BranchId":"D MG 01 ",
      "UnitOfMeasureInternalId":"T1|D MG|Q5",
      "StandardWarehouseDescription":"QUIRONS",
      "TypeUMConversion":[
         {
            "type":"M",
            "Description":"Multiplicador"
         }
      ],
      "StandardWarehouseCode":"33",
      "Trail":"N",
      "BinControl":"False",
      "Origin":""
   }
}

...

id2
labelUNITOFMEASURE
effectTypefade

A mensagem UNITOFMEASURE irá enviar as informações do cadastro de unidade de medidas do Protheus para o Quírons que irá consumir as seguintes tag's:

...

CompanyId

...

BranchId

...

Description

...

Expandir
titleExemplo de mensagem JSON

{
   "Header":{
      "ProductVersion":"12",
      "BranchId":"D MG 01 ",
      "Type":"BusinessMessage",
      "ProductName":"PROTHEUS",
      "BusinessUnit":"MG ",
      "DeliveryType":"Async",
      "Transaction":"UNITOFMEASURE",
      "StandardVersion":"1.000",
      "Version":"2.002",
      "UUID":"99b01fde-72a2-4c27-afbc-fe64e6afe94e",
      "SubType":"event",
      "Enterprise":"D ",
      "Event":"upsert",
      "CompanyId":"T1",
      "GeneratedOn":"2022-04-20T13:27:56Z",
      "SourceApplication":"QUIRONS"
   },
   "Content":{
      "Code":"Q5",
      "ShortName":"UNIDADE M",
      "InternalId":"T1|D MG|Q5",
      "Description":"UNIDADE QUIRONS"
   }
}

...

labelWAREHOUSE
effectTypefade

 A mensagem WAREHOUSE irá enviar as informações do cadastro de armazéns para o Quírons que irá consumir as seguintes tag's:

...

CompanyId

...

BranchId

...

Description

...

Expandir
titleExemplo de mensagem JSON

{
   "Header":{
      "ProductVersion":"12",
      "BranchId":"D MG 01 ",
      "Type":"BusinessMessage",
      "ProductName":"PROTHEUS",
      "BusinessUnit":"MG ",
      "DeliveryType":"Async",
      "Transaction":"WAREHOUSE",
      "StandardVersion":"1.000",
      "Version":"1.000",
      "UUID":"4848af38-5962-d1c1-faeb-cfad85908058",
      "SubType":"event",
      "Enterprise":"D ",
      "Event":"upsert",
      "CompanyId":"T1",
      "GeneratedOn":"2022-04-20T13:44:20Z",
      "SourceApplication":"QUIRONS"
   },
   "Content":{
      "BranchId":"D MG 01 ",
      "Code":"33",
      "Active":"true",
      "Type":"1",
      "Purpose":1,
      "WarehouseClassification":"3",
      "Event":"upsert",
      "InternalId":"T1|D MG|33",
      "WorkCenterCode":"      ",
      "CompanyId":"T1",
      "StandardWarehouse":2,
      "Entity":"WAREHOUSE",
      "CompanyinternalId":"T1|D MG 01 ",
      "Description":"QUIRONS"
   }
}

...

id4
labelREQUEST
effectTypefade

A mensagem REQUEST contém as informações das solicitações de estoque enviadas pelo Quírons.

...

UnitOfMeasureInternalId

...

WarehouseInternalId

...

Quantity

...

Nota
titleType

O conteúdo da tag Type será sempre fixo com o valor '001'

Expandir
titleExemplo de mensagem JSON

{
   "Header":{
      "BranchId":"D MG 01 ",
      "CompanyId":"T1",
      "DeliveryType":"Sync",
      "Event":"upsert",
      "GeneratedOn":"2022-04-20T11:37:53Z",
      "ProductName":"PROTHEUS",
      "ProductVersion":"1.0.0",
      "SourceApplication":"QUIRONS",
      "StandardVersion":"1.000",
      "Type":"BusinessMessage",
      "SubType":"event",
      "UUID":"4d5f50b0-b423-11ec-9191-33b31221ae01",
      "BranchSharingMode":null,
      "BusinessUnitySharingMode":null,
      "CompanySharingMode":null,
      "Version":"1.009",
      "Transaction":"REQUEST"
   },
   "Content":{
      "Code":"",
      "InternalId":"4d4cda20-b423-11ec-9191-33b17223ae01",
      "CompanyId":"T1",
      "BranchId":"D MG 01 ",
      "Number":"",
      "RegisterDateTime":"2022-04-20T11:37:53Z",
      "CompanyInternalId":"T1|D MG 01 ",
      "DeliveryDateTime":"2022-04-20T11:37:53Z",
      "UserRequesterCode":"[email protected]",
      "UserRequesterInternalId":"Usuário Estoque",
      "Type":"001",
      "ListOfRequestItem":[
         {
            "Event":"upsert",
            "CostCenterCode":"000000901",
            "Code":"01",
            "InternalId":"4d1ace18-b423-11ec-b337-d3c1947b8001",
            "DeliveryDateTime":"2022-04-20T11:37:53Z",
            "ItemInternalid":"T1|D MG 01|PRODQUIRONS01",
            "Quantity":"1",
            "TotalPrice":"1",
            "UnitPrice":"1",
            "UnitOfMeasureInternalId":"T1|D MG|Q5",
            "WarehouseInternalId":"T1|D MG|33",
            "Observation":"Lorem ipsum dolor sit amet"
         },
         {
            "Event":"upsert",
            "CostCenterCode":"000000901",
            "Code":"02",
            "InternalId":"4d1e28f6-b423-11ec-b337-c18a880fb401",
            "DeliveryDateTime":"2022-04-20T11:37:53Z",
            "ItemInternalid":"T1|D MG 01|PRODQUIRONS02",
            "Quantity":"1",
            "TotalPrice":"1",
            "UnitPrice":"1",
            "UnitOfMeasureInternalId":"T1|D MG|Q5",
            "WarehouseInternalId":"T1|D MG|33",
            "Observation":"Lorem ipsum dolor sit amet"
         }
      ]
   }
}

...

id5
labelSTOCKTURNOVER
effectTypefade

A mensagem STOCKTURNOVER contém as informações das movimentações de estoque dos tipos de movimento 'Requisição' e 'Devolução' que podem ser enviadas do Protheus para o Quírons e também enviadas do Quírons para o Protheus.

...

InternalId

...

MovementTypeCode

...

ItemInternalId

...

UnitOfMeasureInternalId

...

WarehouseInternalId

...

Nota
titleTipo de Movimento

Os códigos do tipo de movimento (MovementTypeCode) enviado do Quírons para o Protheus devem estar previamente cadastrados no cadastro de Tipos de Movimento (MATA230).

Caso a tag MovementTypeCode envie contéudo "E", "S", "001" ou "000", poderá ser utilizado os parâmetros MV_MTI241E e MV_MTI241S para informar o Tipo de Movimento (SF5) no recebimento da mensagem única.

Para mais informações, acessar documentações abaixo.

PEST051 - MV_MTI241E - Tipo de Movimento EAI

PEST052 - MV_MTI241S - Tipo de Movimento EAI

Expandir
titleExemplo de mensagem JSON

{
   "Header":{
      "ProductVersion":"12",
      "BranchId":"D MG 01 ",
      "Type":"BusinessMessage",
      "ProductName":"PROTHEUS",
      "BusinessUnit":"MG ",
      "DeliveryType":"Async",
      "Transaction":"STOCKTURNOVER",
      "StandardVersion":"1.000",
      "Version":"1.000",
      "UUID":"63f4edf9-2f90-9e14-dc40-a05f25109e03",
      "SubType":"event",
      "Enterprise":"D ",
      "Event":"upsert",
      "CompanyId":"T1",
      "GeneratedOn":"2022-04-20T14:52:06Z",
      "SourceApplication":"QUIRONS"
   },
   "Content":{
      "Number":"",
      "Series":"        ",
      "BranchId":"D MG 01 ",
      "Code":"pcpACR01G",
      "Type":"S",
      "MovementTypeCode":"501",
      "DocumentType":"R",
      "ListOfStockTurnoverItem":[
         {
            "NumberSeries":"",
            "ItemReferenceCode":"PRODQUIRONS01",
            "UnitPrice":1,
            "LotExpirationDate":"",
            "InternalId":"T1|D MG 01|pcpACR01G|107528",
            "ItemInternalId":"T1|D MG 01|PRODQUIRONS01",
            "UnitOfMeasureCode":"Q5",
            "ProjectInternalId":"",
            "WarehouseCode":"33",
            "RequestItemInternalId":"T1|D MG 01|PMS119|01|20220420",
            "CostCenterCode":"000000901",
            "Observation":"",
            "LotOrSerialNumber":"",
            "UnitOfMeasureInternalId":"T1|D MG|Q5",
            "Code":"pcpACR01G",
            "ItemCode":"PRODQUIRONS01",
            "WarehouseInternalId":"T1|D MG|33",
            "DeliveryDateTime":"2022-04-20",
            "CostCenterInternalId":"T1|D MG 01 |000000901",
            "AccountantAcountInternalId":"",
            "BinLocation":"",
            "TaskInternalId":"",
            "EmissionDate":"2022-04-20",
            "TotalPrice":1,
            "Quantity":1,
            "TotalStock":1000
         },
         {
            "NumberSeries":"",
            "ItemReferenceCode":"PRODQUIRONS02",
            "UnitPrice":1,
            "LotExpirationDate":"",
            "InternalId":"T1|D MG 01|pcpACR01G|107529",
            "ItemInternalId":"T1|D MG 01|PRODQUIRONS02",
            "UnitOfMeasureCode":"Q5",
            "ProjectInternalId":"",
            "WarehouseCode":"33",
            "RequestItemInternalId":"T1|D MG 01|PMS119|02|20220420",
            "CostCenterCode":"000000901",
            "Observation":"",
            "LotOrSerialNumber":"",
            "UnitOfMeasureInternalId":"T1|D MG|Q5",
            "Code":"pcpACR01G",
            "ItemCode":"PRODQUIRONS02",
            "WarehouseInternalId":"T1|D MG|33",
            "DeliveryDateTime":"2022-04-20",
            "CostCenterInternalId":"T1|D MG 01 |000000901",
            "AccountantAcountInternalId":"",
            "BinLocation":"",
            "TaskInternalId":"",
            "EmissionDate":"2022-04-20",
            "TotalPrice":1,
            "Quantity":1,
            "TotalStock":1000
         }
      ],
      "DeliveryDateTime":"2022-04-20",
      "InternalId":"T1|D MG 01|pcpACR01G|107528",
      "CompanyId":"T1",
      "RegisterDateTime":"2022-04-20",
      "CompanyInternalId":"T1|D MG 01",
      "AbatementDateTime":"2022-04-20"
   }
}

...

id6
labelSTOCKLEVEL
effectTypefade

A mensagem STOCKLEVEL irá enviar o saldo atual de estoque dos produtos para o Quírons com as seguintes tag's:

...

CompanyId

...

BranchId

...

ItemInternalId

...

WarehouseInternalId

...

CurrentStockAmount

...

Aviso
titleImportante

Para utilizar a mensagem StockLevel na integração entre Protheus x Quirons, é necessário cadastrar a versão "3.004" da mensagem no cadastro do Adapter.

Nota
titleRotina SCHEDESTMG

Para que a mensagem STOCKLEVEL seja enviada a cada atualização de saldo de estoque é necessário configurar a rotina SCHEDESTMG no Schedule pelo Configurador do Protheus.

Para maiores informações sobre configuração do schedule consulte a documentação no link: DT Envio Ativo para Produtos com Estoque Alterado Desde o Último Envio

...

titleExemplo de mensagem JSON

...


05. ADAPTER

O cadastro de adapter são rotinas responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão.

...