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
Gestão Financeira	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.
1. Caso o cadastro esteja exclusivo a nível de Filial do RM o adapter retornará mensagem de erro informando a configuração incompatível.
2. 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.
  1. 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
Quotation / Value	Valor da cotação	GMoeda	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
Quotation / Value	Valor da cotação	GCotacao	FATORREAL	Campo enviado na tag Value por conter o valor com casas decimais.

Exemplos:

{
   "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
         }
      ]
   }
}

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