Histórico da Página

...

Deck of Cards

id	MENSAGENS
effectType	fade

Card

id	1
label	ITEM
effectType	fade

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:

Tag	Conteúdo
CompanyId	Empresa
BranchId	Filial
InternalId	Código do Produto
ItemDescription	Descrição do Produto
StandardCostPrice	Custo unitário
Active	Status do Produto Ativo/Inativo

Expandir

title	Exemplo 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":""
}
}

Card

id	2
label	UNITOFMEASURE
effectType	fade

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:

Tag	Conteúdo
CompanyId	Empresa
BranchId	Filial
InternalId	Código do Produto
Description	Descrição da unidade de medida
ShortName	Sigla

Expandir

title	Exemplo 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"
}
}

Card

label	WAREHOUSE
effectType	fade

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

Tag	Conteúdo
CompanyId	Empresa
BranchId	Filial
InternalId	Código do Produto
Description	Descrição do armazém
Active	Status do armazém

Expandir

title	Exemplo 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"
}
}

Card

id	4
label	REQUEST
effectType	fade

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

Tag	Conteúdo
CompanyId	Empresa
BranchId	Filial
InternalId	Código interno da requisição
Type	Tipo da requisição
RegisterDateTime	Data da Solicitação
DeliveryDateTime	Data da Entrega
ItemInternalId	Código interno do produto
UnitOfMeasureInternalId	Código interno da unidade de medida
WarehouseInternalId	Código interno do armazém
Quantity	Quantidade da solicitação

Nota

title	Type

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

Expandir

title	Exemplo 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.011",
"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"
}
]
}
}

Card

id	5
label	STOCKTURNOVER
effectType	fade

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.

Tag	Conteúdo
CompanyId	Empresa
BranchId	Filial
InternalId	Código interno da movimentação
Type	Tipo da movimentação
MovementTypeCode	Código do tipo de movimento
UnitPrice	Preço unitário do produto
Quantity	Quantidade do produto
ItemInternalId	Código interno do produto
UnitOfMeasureInternalId	Código interno da unidade de medida
WarehouseInternalId	Código interno do armazém
EmissionDate	Data da emissão

Nota

title	Tipo 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).

Expandir

title	Exemplo 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"
}
}

Card

id	6
label	STOCKLEVEL
effectType	fade

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

Tag	Conteúdo
CompanyId	Empresa
BranchId	Filial
ItemInternalId	Código do Produto
WarehouseInternalId	Código interno do armazém
SalesOrderQuantity	Quantidade

Aviso

title	Importante

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

title	Rotina 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

Expandir

title	Exemplo de mensagem JSON

{
"Header":{
"ProductVersion":"12",
"BranchId":"D MG 01 ",
"Type":"BusinessMessage",
"ProductName":"PROTHEUS",
"BusinessUnit":"MG ",
"DeliveryType":"Async",
"Transaction":"STOCKLEVEL",
"StandardVersion":"1.000",
"Version":"3.004",
"UUID":"48997d98-0480-0109-f17e-1fc7d8c844b0",
"SubType":"event",
"Enterprise":"D ",
"Event":"upsert",
"CompanyId":"T1",
"GeneratedOn":"2022-04-20T14:35:21Z",
"SourceApplication":"QUIRONS"
},
"Content":{
"BranchId":"D MG 01 ",
"Active":"true",
"ListOfReturnItem":[
{
"CurrentStockAmount":"1000",
"ReserveSource":" ",
"FutureStockAmount":"0",
"ValueOfCurrentStockAmount":"1000",
"ListOfAddressStock":{

},
"CompanyId":"T1",
"ItemInternalId":"T1|D MG 01|PRODQUIRONS01",
"AvailableStockAmount":"1000",
"BookedStockAmount":"0",
"Amountcommittedstock":"0",
"UnitItemCost":"1",
"UnitOfMeasureInternalId":"T1|D MG|Q5",
"BranchId":"D MG 01 ",
"TransitStockAmount":"0",
"CompanyInternalId":"T1|D MG 01 ",
"AverageUnitItemCost":"1000",
"SalesOrderQuantity":"0",
"ListOfWarehouseStock":[
{
"WarehouseInternalId":"T1|D MG|33",
"CurrentStockAmount":"1000",
"TransitStockAmount":"0",
"FutureStockAmount":"0",
"UnitItemCost":"1",
"ValueOfCurrentStockAmount":"1000",
"AvailableStockAmount":"1000",
"BookedStockAmount":"0",
"AverageUnitItemCost":"1000",
"SalesOrderQuantity":"0",
"Amountcommittedstock":"0"
}
],
"ListOfLotStock":{

},
"ListOfSeriesStock":{

}
}
],
"Event":"upsert",
"CompanyId":"T1",
"CompanyinternalId":"T1|D MG 01 ",
"Entity":"StockLevel"
}
}

05. ADAPTER

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

Para realizar o cadastro/configuração do adapter, antes é necessário ter uma ROTA cadastrada (Item 03). Após ter realizado o cadastro da rota, navegar no menu em Ambiente > Schedule > Adapter EAI (CFGA020).

Exemplo:

Obs.: Em todos adapters, no grid Roteamento de mensagens (para Mensagem Única com canal de envio EAI), selecionar a rota cadastrada conforme item 03 deste documento.

Deck of Cards

id	ADAPTER

Card

id	1
label	ITEM
effectType	fade

Mensagem Única (XX4_UNMESS): 1-Sim
Rotina (XX4_ROTINA): MATA010
Mensagem (XX4_MODEL): ITEM
Descrição (XX4_DESCRI): PRODUTO
Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
Método (XX4_METHOD): Síncrono/Assíncrono
Operação (XX4_TPOPER): 1-Todas
Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
Versão Envio (XX4_SNDVER): 4.005
Formato (XX4_FORMAT): JSON

Card

id	2
label	UNITOFMEASURE
effectType	fade

Mensagem Única (XX4_UNMESS): 1-Sim
Rotina (XX4_ROTINA): QIEA030
Mensagem (XX4_MODEL): UNITOFMEASURE
Descrição (XX4_DESCRI): UNIDADE DE MEDIDA
Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
Método (XX4_METHOD): Síncrono/Assíncrono
Operação (XX4_TPOPER): 1-Todas
Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
Versão Envio (XX4_SNDVER): 2.002
Formato (XX4_FORMAT): JSON

Card

id	3
label	WAREHOUSE
effectType	fade

Mensagem Única (XX4_UNMESS): 1-Sim
Rotina (XX4_ROTINA): AGRA045
Mensagem (XX4_MODEL): WAREHOUSE
Descrição (XX4_DESCRI): LOCAIS DE ESTOQUE
Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
Método (XX4_METHOD): Síncrono/Assíncrono
Operação (XX4_TPOPER): 1-Todas
Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
Versão Envio (XX4_SNDVER): 1.000
Formato (XX4_FORMAT): JSON

Card

id	4
label	STOCKLEVEL
effectType	fade

Mensagem Única (XX4_UNMESS): 1-Sim
Rotina (XX4_ROTINA): MATA225
Mensagem (XX4_MODEL): STOCKLEVEL
Descrição (XX4_DESCRI): SALDOS EM ESTOQUE
Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
Recebe (XX4_RECEIV): Não (Não recebe mensagem JSON do Quírons)
Método (XX4_METHOD): Síncrono/Assíncrono
Operação (XX4_TPOPER): 1-Todas
Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
Versão Envio (XX4_SNDVER): 3.004
Formato (XX4_FORMAT): JSON

Card

id	5
label	REQUEST
effectType	fade

Mensagem Única (XX4_UNMESS): 1-Sim
Rotina (XX4_ROTINA): MATA105
Mensagem (XX4_MODEL): REQUEST
Descrição (XX4_DESCRI): SOLICITACAO AO ARMAZEM
Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
Método (XX4_METHOD): Síncrono/Assíncrono
Operação (XX4_TPOPER): 1-Todas
Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
Versão Envio (XX4_SNDVER): 1.011
Formato (XX4_FORMAT): JSON

Card

id	6
label	STOCKTURNOVER
effectType	fade

Mensagem Única (XX4_UNMESS): 1-Sim
Rotina (XX4_ROTINA): MATA241
Mensagem (XX4_MODEL): STOCKTURNOVER
Descrição (XX4_DESCRI): MOVIMENTACOES INTERNAS MULT.
Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
Método (XX4_METHOD): Síncrono/Assíncrono
Operação (XX4_TPOPER): 1-Todas
Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
Versão Envio (XX4_SNDVER): 1.000
Formato (XX4_FORMAT): JSON

Card

id	7
label	SCHADULE/AGENT
effectType	fade

Para que o envio das mensagens assíncronas seja realizado, é necessário efetuar o cadastro das rotinas FWEAIRECE/FWEAISEND, no Schedule Protheus.

FWEAISEND: Esta rotina é exclusiva para o envio das mensagens da fila do EAI. O agendamento desta rotina é realizado por Empresa cadastrada no sistema. No envio da mensagem, um canal de comunicação é aberto com o webservice do produto integrado, e esta comunicação é encerrada após o recebimento da mensagem de retorno (no caso das Mensagens Única Totvs, após o recebimento da ReceiptMessage, indicando que que o processo ocorreu corretamente) ou por timeout (mensagem com status de falha).
FWEAIRECE: Esta rotina é exclusiva para o recebimento das mensagens do EAI Protheus. Quando configurada esta rotina inicia o processamento das mensagens disponíveis para processamento na fila do EAI Protheus.

Antes de efetuar o cadastro das rotinas FWEAIRECE/FWEAISEND, é necessário a inclusão dos Agent.

AGENT: Este é o componente que gerencia as execuções e distribui as tarefas para que as Executes configuradas que estão disponíveis no momento. Os Agents podem estar localizados em servidores diferentes, possibilitando o balanceamento da carga de execuções.

Informações
DMANMAT01-2132 DT Envio Ativo para Produtos com Estoque Alterado Desde o Último Envio

Inclusão das rotinas FWEAIRECE/FWEAISEND no agendamento

06. DE/PARA EMPRESAS

Em uma integração entre sistemas é comum os sistemas terem códigos diferentes, neste caso é muito importante ter um 'De/Para" (XXD), para que seja mapeado e retornado o valor interno de um determinado registro da tabela informada no cadastro de De/Para.

...

Árvore de páginas

Versões comparadas

Versão antiga 67

Nova versão 68

Chave

05. ADAPTER

06. DE/PARA EMPRESAS