# Faça pesquisas no Dashboard

Use o Dashboard para procurar pagamentos, clientes e muito mais.

O [Stripe Sigma](https://docs.stripe.com/stripe-data.md) torna todos os dados da sua empresa disponíveis como um ambiente SQL interativo no Dashboard. Você pode usá-lo para executar pesquisas altamente avançadas e gerar relatórios personalizados.

Use a pesquisa de Dashboard para encontrar recursos importantes e navegar por diferentes recursos Stripe, como *contas conectadas* (A person or business accepting payments or receiving payouts on a Connect platform), *clientes* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments), *faturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice), *repasses* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) e *produtos* (Products represent what your business sells—whether that's a good or a service).

Quando você realiza uma pesquisa, os principais resultados aparecem imediatamente. Veja todas as correspondências clicando em **Ver todos os resultados** ou pressionando **Enter**. Nos grupos de resultados de pesquisa obtidos, clique em **Ver tudo** para ver uma tela expandida com cabeçalhos de coluna que, em alguns casos, oferecem opções de classificação.

## Comece já

Use informações diferentes como termos de pesquisa:

- Os últimos quatro dígitos de um cartão ou número de conta (**4242**).
- O tipo de forma de pagamento (**iDEAL**).
- O nome da empresa de uma conta da Stripe conectada (**Rocketship**).
- O número do recibo de e-mail (**1817-9523**).

Para pesquisas que exigem datas, você pode usar formatos diferentes, como **22/08**, **12-07-2020** ou **semana passada**. Use identificadores de objeto (ID de contestação) para acessar diretamente o objeto que procurado. Nenhum contexto adicional é necessário para a maioria das pesquisas. O Dashboard procura automaticamente as informações mais relevantes com base na sua consulta de pesquisa. Você pode usar filtros e operadores de pesquisa para ter um controle mais detalhado.

## Filtros e operadores de pesquisa

Por padrão, o Dashboard procura valores que correspondam ao seu termo de pesquisa nos campos mais lógicos dos objetos (por exemplo, ele procura um endereço de e-mail no campo `email` ou uma descrição de objeto). Você pode usar filtros e operadores para refinar ainda mais as pesquisas. Quanto mais termos você informar na consulta de pesquisa, menor será o número de resultados.

#### Filtros

Use filtros para limitar seus termos de pesquisa, de forma que se apliquem somente a campos específicos dentro dos objetos aplicáveis. Prefira um termo de pesquisa com um desses filtros. Se o termo de pesquisa precisa incluir um espaço, coloque-o entre aspas (`name:"John Doe"`). Muitos campos são compartilhados por objetos diferentes. Por exemplo, o campo `amount` se aplica a pagamentos, faturas, repasses e assim por diante.

| Filtrar       | Descrição                                                                                                                                                                                                             | Exemplo                           |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `amount:`     | O valor de um objeto. Para moedas com casas decimais, use uma vírgula para as unidades de moeda (por exemplo, reais e centavos).                                                                                      | **amount:149,99**                 |
| `brand:`      | A marca do cartão associado a um objeto.                                                                                                                                                                              | **brand:visa**                    |
| `country:`    | O [código ISO](https://en.wikipedia.org/wiki/ISO_3166-1) de duas letras que representa o país associado a um objeto.                                                                                                  | **country:GB**                    |
| `created:`    | A data em que um objeto foi criado (idêntico a `date`).                                                                                                                                                               | **created:2020/07/12**            |
| `currency:`   | O [código ISO](https://en.wikipedia.org/wiki/ISO_4217) de três letras que representa a moeda de um objeto.                                                                                                            | **currency:EUR**                  |
| `date:`       | A data em que um objeto foi criado (idêntico a `created`).                                                                                                                                                            | **date:yesterday**                |
| `email:`      | O e-mail (endereço completo ou parcial) de um objeto.                                                                                                                                                                 | **email:jenny.rosen@example.com** |
| `exp:`        | A data de validade do cartão associado a um objeto.                                                                                                                                                                   | **exp:08/22**                     |
| `flow:`       | O tipo de [fluxo para ação de clientes](https://docs.stripe.com/sources.md#flow-for-customer-action) que se aplica a um pagamento do [Sources](https://docs.stripe.com/sources.md).                                   | **flow:redirect**                 |
| `last4:`      | Os quatro últimos dígitos do cartão ou número da conta associado a um objeto.                                                                                                                                         | **last4:4080**                    |
| `metadata:`   | O valor dos [metadados](https://docs.stripe.com/api.md#metadata) de um objeto compatível. Há [opções adicionais de pesquisa de metadados](https://docs.stripe.com/dashboard/search.md#metadata-searches) disponíveis. | **metadata:555-5555**             |
| `name:`       | O nome do titular do cartão ou cliente associado a um objeto.                                                                                                                                                         | **name:jenny**                    |
| `number:`     | O número único que identifica uma fatura.                                                                                                                                                                             | **number:06b2b1a642-0023**        |
| `postal:`     | O CEP ou código postal associado a um objeto.                                                                                                                                                                         | **postal:12345**                  |
| `receipt:`    | O número do recibo de um pagamento ou e-mail de reembolso.                                                                                                                                                            | **receipt:3330-2392**             |
| `risk_level:` | O [nível de risco](https://docs.stripe.com/radar/risk-evaluation.md) de um pagamento determinado pelo [Radar](https://docs.stripe.com/radar.md).                                                                      | **risk\_level:elevated**          |
| `status:`     | O status de um objeto.                                                                                                                                                                                                | **status:canceled**               |
| `type:`       | O tipo de [PaymentMethod](https://docs.stripe.com/payments/payment-methods.md) ou [Source](https://docs.stripe.com/sources.md) usado para criar um pagamento.                                                         | **type:ideal**                    |
| `usage:`      | A disponibilidade para [uso](https://docs.stripe.com/sources.md#single-use-or-reusable) de uma forma de pagamento do [Sources](https://docs.stripe.com/sources.md).                                                   | **usage:single\_use**             |
| `zip:`        | O CEP ou código postal associado a um objeto.                                                                                                                                                                         | **zip:12345**                     |

#### Operadores

Você pode usar os seguintes operadores ao pesquisar valores e datas para refinar sua pesquisa para um intervalo específico:

| Operador | Descrição                                         | Exemplo                |
| -------- | ------------------------------------------------- | ---------------------- |
| `>`      | Maior que um valor ou após a data especificada.   | **amount:>149,99**     |
| `<`      | Menor que um valor ou antes da data especificada. | **date:<2020-07-12**   |
| `..`     | Em um intervalo de datas ou valores.              | **amount:50,00…99,99** |

Você também pode usar o operador booleano `is:` para filtrar resultados para um tipo ou estado de objeto específico.

Use `is:` com um tipo de objeto para mostrar apenas resultados desse tipo.

| Operador           | Descrição                                         | Exemplo                  |
| ------------------ | ------------------------------------------------- | ------------------------ |
| `account`          | Uma conta conectada.                              | **is:account**           |
| `charge`           | Um pagamento (idêntico a `payment`).              | **is:charge**            |
| `checkout_session` | Uma sessão de checkout.                           | **is:checkout\_session** |
| `coupon`           | Um cupom.                                         | **is:coupon**            |
| `credit_note`      | Uma nota de crédito.                              | **is:credit\_note**      |
| `customer`         | Um cliente.                                       | **is:customer**          |
| `dispute`          | Uma contestação.                                  | **is:dispute**           |
| `document`         | Um documento.                                     | **is:document**          |
| `invoice`          | Uma fatura.                                       | **is:invoice**           |
| `invoiceitem`      | Um item de fatura.                                | **is:invoiceitem**       |
| `order`            | Um pedido.                                        | **is:order**             |
| `payment`          | Um pagamento (idêntico a `charge`).               | **is:payment**           |
| `payment_intent`   | Um PaymentIntent.                                 | **is:payment\_intent**   |
| `payment_link`     | Um link de pagamento.                             | **is:payment\_link**     |
| `payment_method`   | Uma forma de pagamento.                           | **is:payment\_method**   |
| `payout`           | Um repasse.                                       | **is:payout**            |
| `plan`             | Um plano de assinatura.                           | **is:plan**              |
| `price`            | Um preço.                                         | **is:price**             |
| `product`          | Um produto.                                       | **is:product**           |
| `promotion_code`   | Um código promocional.                            | **is:promotion\_code**   |
| `quote`            | Uma cotação.                                      | **is:quote**             |
| `refund`           | Um reembolso.                                     | **is:refund**            |
| `setup_intent`     | Um SetupIntent.                                   | **is:setup\_intent**     |
| `source`           | Uma [origem](https://docs.stripe.com/sources.md). | **is:source**            |
| `subscription`     | Uma assinatura.                                   | **is:subscription**      |
| `transfer`         | Uma movimentação de fundos entre contas Stripe.   | **is:transfer**          |

Use `is:` com um estado para mostrar apenas resultados que correspondam a esse estado.

| Operador    | Descrição                                 | Exemplo          |
| ----------- | ----------------------------------------- | ---------------- |
| `active`    | Um plano, preço ou cartão-presente ativo. | **is:active**    |
| `captured`  | Um pagamento capturado.                   | **is:captured**  |
| `disputed`  | Um pagamento contestado.                  | **is:disputed**  |
| `paid`      | Um pagamento ou fatura paga.              | **is:paid**      |
| `recurring` | Um preço recorrente.                      | **is:recurring** |
| `refunded`  | Um pagamento que foi reembolsado.         | **is:refunded**  |

### Combine e negue termos de pesquisa

Use mais de um termo de pesquisa para restringir sua pesquisa. Você também pode negar qualquer filtro de pesquisa com um hífen (`-`) para que as correspondências dele não sejam incluídas.

| Exemplo                           | Descrição                                                                                |
| --------------------------------- | ---------------------------------------------------------------------------------------- |
| `type:card last4:4242 exp:08/22`  | Os quatro últimos dígitos do cartão são `4242` e a data de validade é `08/22`.           |
| `type:card last4:4242 -exp:08/22` | Os quatro últimos dígitos do cartão são `4242` e a data de validade *não* é `08/22`.     |
| `type:ideal status:canceled`      | Pagamentos do iDEAL em que a fonte foi cancelada e não usada para concluir um pagamento. |

Para pesquisar uma frase inteira, use aspas. Por exemplo, **“Stripe Shop”** fornece correspondências para essa frase completa, mas **Stripe Shop** pesquisa as palavras **Stripe** e **Shop** separadamente.

### Pesquisas de metadados

É possível pesquisar [metadados](https://docs.stripe.com/api.md#metadata) que você adicionou a objetos que os aceitam. Por exemplo, você pode encontrar documentos que têm a chave de metadados `order_id` com o valor de metadados correspondente `xyn712` usando qualquer uma das seguintes consultas de pesquisa:

- `xyn712`
- `order_id:xyn712`
- `metadata:xyn712`
- `metadata:order_id=xyn712`

## Pesquisar em uma organização

Depois de adicionar várias contas Stripe a uma [organização](https://docs.stripe.com/get-started/account/orgs.md), os membros da sua equipe podem pesquisar em todas as contas às quais têm acesso nela. Por padrão, as pesquisas exibem resultados de todas essas contas. Se um membro da equipe estiver visualizando o Dashboard de uma conta, há uma opção no menu suspenso de pesquisa para pesquisar somente dentro dessa conta.

## Práticas recomendadas

Muitas pesquisas podem ser realizadas com um único termo de pesquisa. Use algo que seja bastante específico, como um nome ou endereço de e-mail. Se você estiver vendo poucos resultados, torne o termo de pesquisa menos específico. Se houver muitos resultados, inclua os termos adicionais, um de cada vez.

Use uma gama mais ampla de valores quando usar datas ou valores como termos de pesquisa. Conversões de moeda e diferenças de fuso horário entre você e seu cliente são uma fonte comum de confusão ao procurar informações sobre um pagamento. Nesses casos, termos de pesquisa adicionais ou até mesmo diferentes juntos podem ajudar.

> #### Pesquisas de favoritos
> 
> Como os termos de pesquisa são incluídos no URL, você pode adicionar a pesquisa aos favoritos ou compartilhá-la com outros membros da equipe, da mesma forma que qualquer outra página da web.