Cotação de Moeda
Contexto de negócio (Introdução)
Adapter responsável pelo cadastro de cotação de moeda.
Modulo RM | Identificador | Versão | Forma de Envio | Tipo do Adapter |
---|---|---|---|---|
Gestão Financeira | CURRENCYQUOTATION | 2.001 | Síncrona | Recebe |
CURRENCYQUOTATION | 2.001 | Assíncrono | Envio |
Mapeamento de Campos
CURRENCYQUOTATION (RECEBIMENTO)
Regras de Integridade:
- A mensagem de Cotação de Moeda deve ser parametrizada como compartilhada por Grupo de Empresa, Empresa, Unidade de Negócios e Filial, sendo aplicadas as regras abaixo durante execução da integração.
- Caso o cadastro esteja exclusivo a nível de Filial do RM o adapter retornará mensagem de erro informando a configuração incompatível.
- Caso o cadastro esteja exclusivo a nível de Coligada do RM (Grupo de Empresa ou Empresa) somente será apresentada mensagem de alerta e tratará os registros com mesmo símbolo no Protheus como sendo o mesmo registro no RM.
- Por exemplo, caso exista no Protheus dois grupos de empresa e a moeda R$ exista nos dois grupos somente será inserido um registro no RM e serão inseridos duas referencias na tabela De-Para indicando esta equivalência.
- O parâmetro de integração "MOEDAPADRAO" deve ser informado e o mesmo será utilizado como Moeda de referência da cotação.
Mensagem Padrão | Descrição | Tabela | Campo | Observação |
---|---|---|---|---|
InternalId | Campo não utilizado na integração | |||
CurrencyInternalId | InternalId da Moeda | GCotacao | SIMBOLO | Campo utilizado para obtenção da tabela De-Para. |
GCotacao | SIMBOLOREF | Campo da moeda de referência é obtido a partir do parâmetro "MOEDAPADRAO" | ||
Period / Month | Mês da Cotação | GMoeda | DATA | Campo utilizado para compor o mês da data da cotação. |
Period / Year | Número de casas decimais | GMoeda | DATA | Campo utilizado para compor o ano da data da cotação. |
Quotation / InternalId | InternalId da Cotação | GMoeda | SIMBOLO|DATA|SIMBOLOREF | |
Quotation / Day | Dia da cotação | GMoeda | DATA | Campo utilizado para compor o dia da data da cotação. |
Quotation / Value | Valor da cotação | GMoeda | FATOR | |
FATORREAL |
CURRENCYQUOTATION (ENVIO)
Regras de Integridade:
- O parâmetro de integração "MOEDAPADRAO" deve ser informado e o mesmo será utilizado como Moeda de referência da cotação.
Mensagem Padrão | Descrição | Tabela | Campo | Observação |
---|---|---|---|---|
InternalId | Campo não utilizado na integração | |||
CurrencyInternalId | InternalId da Moeda | GCotacao | SIMBOLO | Campo utilizado para obtenção da tabela De-Para. |
GCotacao | SIMBOLOREF | Campo da moeda de referência é obtido a partir do parâmetro "MOEDAPADRAO" | ||
Period / Month | Mês da Cotação | GCotacao | DATA | Campo utilizado para compor o mês da data da cotação. |
Period / Year | Número de casas decimais | GCotacao | DATA | Campo utilizado para compor o ano da data da cotação. |
Quotation / InternalId | InternalId da Cotação | GCotacao | SIMBOLO|DATA|SIMBOLOREF | |
Quotation / Day | Dia da cotação | GCotacao | DATA | Campo utilizado para compor o dia da data da cotação. |
Quotation / Value | Valor da cotação | GCotacao | FATOR | |
FATORREAL | Campo enviado na tag Value por conter o valor com casas decimais. |
Exemplos:
Exemplo de Envio em JSon
{ "Header":{ "UUID":"e79052db-2a88-4cae-ad74-e2d0781302f9", "Type":"BusinessMessage", "SubType":"event", "Transaction":"CURRENCYQUOTATION", "Version":"2.001", "StandardVersion":"1.000", "SourceApplication":"RM", "ProductName":"RM", "ProductVersion":"12.1.2302.0", "CompanyId":"1", "BranchId":"1", "GeneratedOn":"2022-10-21T14:22:28.5795019Z", "DeliveryType":"Async", "CompanySharingMode":null, "BusinessUnitySharingMode":null, "BranchSharingMode":null, "Event":"upsert" }, "Content":{ "CurrencyCode":"U$", "CurrencyInternalId":"U$", "Period":{ "Year":2022, "Month":10 }, "ListOfQuotation":[ { "InternalId":"U$|21/10/2022 00:00:00|R$", "Day":21, "Value":5.27 } ] } }
Exemplo de Envio em XML
<TOTVSMessage> <MessageInformation version="2.001"> <UUID>b88a3caf-8ea5-47d0-a8da-8bd5f26c2d19</UUID> <Type>BusinessMessage</Type> <Transaction>CURRENCYQUOTATION</Transaction> <StandardVersion>1.000</StandardVersion> <SourceApplication>RM</SourceApplication> <CompanyId>1</CompanyId> <BranchId>1</BranchId> <Product name="RM" version="12.1.2302.0" /> <GeneratedOn>2022-10-20T15:22:18</GeneratedOn> <DeliveryType>Sync</DeliveryType> </MessageInformation> <BusinessMessage> <BusinessEvent> <Entity>CURRENCYQUOTATION</Entity> <Event>Upsert</Event> </BusinessEvent> <BusinessContent> <CurrencyCode>U$</CurrencyCode> <CurrencyInternalId>U$</CurrencyInternalId> <Period> <Year>2022</Year> <Month>10</Month> </Period> <ListOfQuotation> <Quotation> <InternalId>U$|20/10/2022 00:00:00|R$</InternalId> <Day>20</Day> <Value>5.27</Value> </Quotation> </ListOfQuotation> </BusinessContent> </BusinessMessage> </TOTVSMessage>
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas