A interface de programação referente a Consulta de Precificação é primariamente composta por consultas que retornam o tipo MerchantTransactionFees a partir da consulta dos estabelecimentos comerciais ou segmentos comerciais.

Consulta de Precificação (depreciada)

cnpj

CompanyLegalIdsInput

Série de códigos [ISO18245](https://en.wikipedia.org/wiki/ISO_18245)
para categorias de comerciantes.

Também conhecido como MCC (_Merchant Category Code_), tem 4 dígitos.

Código [ISO18245](https://en.wikipedia.org/wiki/ISO_18245) mínimo
a ser incluído na série.

Código [ISO18245](https://en.wikipedia.org/wiki/ISO_18245) máximo
a ser incluído na série.

MerchantCategoryRangeInput

Critério de filtragem para comerciantes.

Se `null` ou vazio, não realiza filtragem.
Caso contrário, define texto que deve estar contido no nome do comerciante.

nameContains

Lista com os documentos legais para determinar o comerciante (i.e: CNPJ)

Se `null` ou vazio, não realiza filtragem.
Caso contrário, especifica série de documentos legais a serem
incluídas.

legalIds

Se `null` ou vazio, não realiza filtragem.
Caso contrário, especifica série de códigos ISO de categorias a serem
incluídas.

includeCategories

Se `null` ou vazio, não realiza filtragem.
Caso contrário, especifica série de códigos ISO de categorias a serem
excluídas.

excludeCategories

MerchantFilterInput

Limita a lista às primeiras entradas, caso provido.
Se for `null`, a listagem é ilimitada.
Utilizado em navegação para frente.

first

Inicia após o cursor opaco, se provido.
Utilizado em navegação para frente.

after

Limita a lista às últimas entradas, caso provido.
Se for `null`, a listagem é ilimitada.
Utilizado em navegação para trás.

last

Inicia antes do cursor opaco, se provido.
Utilizado em navegação para trás.

before

filter

_Query_ (consulta) comerciantes `Merchant`

merchants

Os documentos legais para determinar o comerciante (i.e: CNPJ)

Ao menos um documento legal deverá ser especificado para que
esta consulta retorne o comerciante.

Consulta um comerciante pelos seus documentos legais (i.e: CNPJ)

Pode retornar `null` se não existir comerciante com tal documento
na base de dados.

merchant

[ISO18245](https://en.wikipedia.org/wiki/ISO_18245)

Consulta uma categoria de comerciante pelo código
[ISO18245](https://en.wikipedia.org/wiki/ISO_18245).

Pode retornar `null` caso a categoria não seja conhecida.

merchantCategory

`PageInfo` compatível com [Relay](https://facebook.github.io/relay/docs/en/mutations.html).

hasPreviousPage

hasNextPage

startCursor

endCursor

PageInfo

Aresta de conexão contendo um comerciante (`Merchant`) em conformidade
com o [Relay](https://facebook.github.io/relay/graphql/connections.htm).

Cursor opaco para ser usado com _queries_ (consultas) `after` ou
`before`.

cursor

O objeto `Merchant` que compõe essa aresta de conexão.

node

MerchantsEdge

Conexão de comerciante (`Merchant`) em conformidade com o
[Relay](https://facebook.github.io/relay/graphql/connections.htm).

pageInfo

Lista de arestas que compõem esta conexão.

edges

Contagem total de objetos nesta conexão.

Arestas são limitadas a cursores `before` e `after`, assim como
primeiras e últimas contagens. Assim o tamanho de arestas é possivelmente
menor que a conexão como um todo.

`totalCount`, se não for `null`, indica o número total de itens na conexão
considerando-se o filtro.

totalCount

MerchantsConnection

Toda a possível identificação legal de uma empresa.

MerchantEcLegalIds

Endereço Físico Mundial, que pode ser usado para envios ou contas

MerchantEcAddress

Categoria de comerciantes

A Categoria de Comerciante é associada a um código
[ISO18245](https://en.wikipedia.org/wiki/ISO_18245) de 4 dígitos
disponível no membro `iso`.

Identificador Global Único para este objeto.

Código [ISO18245](https://en.wikipedia.org/wiki/ISO_18245).

Também conhecido como MCC (_Merchant Category Code_), tem 4
dígitos.

Língua a ser utilizada no retorno da consulta.

Por padrão adota-se a língua de quem faz a requisição, porém uma
diferente pode ser requisitada e está será utilizada, ou a mais
próxima disponível. O formato é: `en_US` (Inglês dos EUA), `en`
(Inglês genérico), `pt_BR` (Português do Brasil), `pt`
(Português genérico). O formato é o mesmo de [IETF language
tag](https://en.wikipedia.org/wiki/IETF_language_tag).

language

Nome da categoria de comerciante.

Por padrão adota-se a língua de quem faz a requisição, porém uma
diferente pode ser requisitada e está será utilizada, ou a mais
próxima disponível. O formato é: `en_US` (Inglês dos EUA), `en`
(Inglês genérico), `pt_BR` (Português do Brasil), `pt` (Português
genérico). O formato é o mesmo de [IETF language
tag](https://en.wikipedia.org/wiki/IETF_language_tag).

name

Caso fornecido, largura da imagem, em _pixels_.

width

Caso fornecido, altura da imagem, em _pixels_.

height

Caso fornecido, o tipo de arquivo desejado (`mime-type`).

mimeType

URL da imagem.
Caso sejam providos sugestões de altura e largura (opcionais) para
o tamanho a ser mostrado, o servidor irá retornar a URL para a imagem
com o tamanho mais próximo ao requisitado.
Caso seja provido o `mimeType`, a este será dada preferência, o que
é muito útil em dispositivos que lidam com um único formato de imagens.
Tanto o tamanho quanto o `mimeType` da imagem apontada pela URL
são retornados.

image

Preços de Transações para a Categoria de Comerciante.

As taxas e custos são associados a um uso (i.e: Crédito à vista,
Crédito parcelado pela loja...) e tem uma validade, ou seja, são
dinâmicos e podem ser consultados para esta categoria.

Note que alguns comerciantes possuem custos de transação
específicos, negociados individualmente. Para estes deve-se
consultar o comerciante e então seus preços diretamente via API
com `merchant(legalIds: {cnpj: X}) { transactionFees }`,
utilizando os valores da categoria aqui retornados apenas para
comerciantes sem preços específicos.

Os custos são dinâmicos: foram alterados em
`MerchantTransactionFees { lastModified } ` e são vigentes até
`MerchantTransactionFees { expiry }`. O usuário deve usar
`expiry` para invalidar o cache local, refrescando as informações
após tal data e horário.

transactionFees

Consulta comerciantes (`Merchant`) nesta categoria.

MerchantCategory

Custos de Transação ao Comerciante.

Baseado no tipo de uso (i.e: Crédito à vista, Crédito parcelado pela
loja...) e número de parcelas o comerciante terá que pagar uma taxa
à bandeira e ao credenciador. **Recomenda-se** que o usuário sempre
considere `cardUsage`, `installmentsRange` e `expiry` em todas as
consultas.

Exemplo de listagem:
 - `cardUsage: 70, installmentsRange: null`.
 - `cardUsage: 71, installmentsRange: null`.
 - `cardUsage: 72, installmentsRange { min: 1, max: 6 }`.
 - `cardUsage: 72, installmentsRange { min: 7, max: 12 }`.

Os custos são dinâmicos: foram alterados em `lastModified` e são
vigentes até `expiry`. O usuário deve usar `expiry` para invalidar o
cache local, refrescando as informações após tal data e horário.

O cálculo do valor final a ser pago é feito e esclarecido na
consulta `calc`.

Os custos de transação se referem a este uso.

Por exemplo:
 - Crédito à vista = 70
 - Débito = 71
 - Crédito parcelado pela loja = 72

Note que para produtos parcelados, como 72, serão retornadas
diversas entradas com o mesmo `cardUsage`, porém com faixas de
parcelamento diferentes em `installmentsRange`. Por exemplo se as
tarifas para parcelamento de 1 à 6 são diferentes que
parcelamentos de 7 à 12, então teríamos duas entradas com o mesmo
`cardUsage`, sendo que cada uma terá `installmentsRange`
diferente:
 - `cardUsage: 72, installmentsRange { min: 1, max: 6 }`.
 - `cardUsage: 72, installmentsRange { min: 7, max: 12 }`.

cardUsage

A faixa de parcelas a qual estes custos de transação se referem.

Para `cardUsage` que permite parcelamento, será retornado a faixa
de parcelas a qual estes custos se aplicam. Por exemplo se as
tarifas para parcelamento de 1 à 6 são diferentes que
parcelamentos de 7 à 12, então teríamos duas entradas com o mesmo
`cardUsage`, sendo que cada uma terá `installmentsRange`
diferente:
 - `cardUsage: 72, installmentsRange { min: 1, max: 6 }`.
 - `cardUsage: 72, installmentsRange { min: 7, max: 12 }`.

Para `cardUsage` que não permite parcelamento, será retornado
`null`.

installmentsRange

Data e horário da última modificação.

lastModified

Data e horário que limitam a vigência do valor, ou seja.

expiry

Percentual a ser pago para a tarifa de desenvolvimento da bandeira
e marketing.

Caso `marketingFeeCeilValue` seja não-nulo, então especifica um
teto em `BRL (R$)` pra limitar o valor final a ser pago.

marketingFee

Teto do custo da tarifa de desenvolvimento da bandeira e
marketing, em `BRL (R$)`.

Caso seja não-nulo, após aplicar `marketingFee` ao valor da compra
deve-se limitar o valor final em `BRL (R$)` ao montante
especificado.

marketingFeeCeilValue

Percentual a ser pago para desenvolvimento e suporte de produtos
ao credenciador.

Caso `acquiringServiceFeeCeilValue` seja não-nulo, então
especifica um teto em `BRL (R$)` pra limitar o valor final a ser
pago.

acquiringServiceFee

Teto do custo da tarifa de desenvolvimento e suporte de produtos
ao credenciador da transação, em `BRL (R$)`.

Caso seja não-nulo, após aplicar `acquiringServiceFee` ao valor da
compra deve-se limitar o valor final em `BRL (R$)` ao montante
especificado.

acquiringServiceFeeCeilValue

Tarifa de processamento na mensageria de autorizações, em `BRL (R$)`.

Este valor é fixo para este uso (`cardUsage`), independente do
valor ou número de parcelas.

processingCost

Tarifa adicional para cada parcela, em `BRL (R$)`.

Para uso parcelado, por exemplo `cardUsage` 72 (crédito parcelado
pela loja), cada parcela deve pagar este custo adicional.

Ou seja, para uma compra em 3 parcelas, paga-se `2 *
additionalInstallmentCost`.

Para `cardUsage` que não permite parcelamento, será retornado
`null`.

additionalInstallmentCost

Valor da transação a calcular o custo final, em `BRL (R$)`.

transactionValue

Número de parcelas da transação.

Para pagamentos à vista (`cardUsage` 70 ou 71), será
desconsiderado.

Se omitido, será considerado `1` (pagamento à vista).

installments

Calcula o custo final em `BRL (R$)` a ser pago para uma transação
de `transactionValue` realizada em `installments` parcelas com o
uso retornado no campo `cardUsage`.

Esta consulta é um utilitário que calcula:

```
let marketingCost = transactionValue * (marketingFee / 100);
if (marketingFeeCeilValue && marketingCost > marketingFeeCeilValue) {
   marketingCost = marketingFeeCeilValue;
}

let acquiringServiceCost = transactionValue * (acquiringServiceFee / 100);
if (acquiringServiceFeeCeilValue && acquiringServiceCost > acquiringServiceFeeCeilValue) {
   acquiringServiceCost = acquiringServiceFeeCeilValue;
}

let installmentsCost = 0.0;
if (installments && installments > 1) {
   installmentsCost = (installments - 1) * additionalInstallmentCost;
}

let totalCost = processingCost + installmentsCost + marketingCost + acquiringServiceCost;
```

calc

MerchantTransactionFees

Um estabelecimento comercial que realiza transações com cartões Elo.

legalName

address

Categorias de comerciantes (Código ISO, nome)

MerchantEC

Tipo do arquivo na convenção (_MIME - Multipurpose Internet Mail
Extensions_), como `image/png`, `image/jpeg`