# Cómo hacer búsquedas en el Dashboard

Usa el Dashboard para buscar pagos, clientes y más.

[Stripe Sigma](https://docs.stripe.com/stripe-data.md) pone a tu disposición todos los datos de tu empresa como un entorno SQL interactivo en el Dashboard. Puedes usarlo para realizar búsquedas muy avanzadas y generar informes personalizados.

Usa la búsqueda del Dashboard para encontrar recursos importantes de Stripe y navegar por ellos, como *cuentas 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), *facturas* (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), *trasferencias* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) y *productos* (Products represent what your business sells—whether that's a good or a service).

Cuando realiza una búsqueda, los primeros resultados aparecen de inmediato Para ver todas las coincidencias, haz clic en **Ver todos los resultados** o presiona **Intro**. En los grupos de resultados de búsqueda resultantes, haz clic en **Ver todo** para ver una pantalla expandida con encabezados de columna, algunos de los cuales ofrecen opciones para ordenar los resultados.

## Empezar

Usar diferentes datos como términos de búsqueda:

- Los últimos cuatro dígitos de un número de tarjeta o cuenta (**4242**).
- El tipo de método de pago (**iDEAL**).
- El nombre comercial de una cuenta de Stripe conectada (**Rocketship**).
- El número de recibo por correo electrónico (**1817-9523**).

Para las búsquedas que requieren fechas, puedes usar diferentes formatos, como **08/22**, **2020-07-12** o ** la semana pasada**. Usa identificadores de objetos (ID de disputa) para ir directamente al objeto que estás buscando. No se necesita contexto adicional para la mayoría de las búsquedas. El Dashboard busca automáticamente la información más relevante conforme a la consulta. Puedes usar filtros y operadores de búsqueda para tener un control más detallado.

## Filtros y operadores de búsqueda

De forma predeterminada, el Dashboard busca valores que coincidan con el término de búsqueda en los campos más lógicos dentro de los objetos (por ejemplo, buscará una dirección de correo electrónico en el campo `email` o una descripción del objeto). Puedes usar filtros y operadores para refinar aún más tus búsquedas. Cuantos más términos proporciones en la consulta de búsqueda, menor será el número de resultados.

#### Filtros

Usa filtros para limitar los términos de búsqueda de manera que solo se apliquen a campos específicos dentro de los objetos aplicables. Introduce un término de búsqueda con uno de estos filtros. Si tu término de búsqueda debe incluir un espacio, usa comillas (`name:"John Doe"`). Muchos campos se comparten entre diferentes objetos. Por ejemplo, el campo `amount` se aplica a pagos, facturas, transferencias y mucho más.

| Filtrar       | Descripción                                                                                                                                                                                                                   | Ejemplo                           |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `amount:`     | El importe de un objeto. Para monedas con decimales, debes usar el punto decimal para ambas unidades de la moneda (por ejemplo, dólares y centavos).                                                                          | **amount:149.99**                 |
| `brand:`      | La marca de la tarjeta asociada con un objeto.                                                                                                                                                                                | **brand:visa**                    |
| `country:`    | El [código ISO](https://en.wikipedia.org/wiki/ISO_3166-1) de dos letras que representa al país asociado con un objeto.                                                                                                        | **country:GB**                    |
| `created:`    | La fecha en que se creó un objeto (idéntica a `date`).                                                                                                                                                                        | **created:2020/07/12**            |
| `currency:`   | El [código ISO](https://en.wikipedia.org/wiki/ISO_4217) de tres letras que representa la moneda de un objeto.                                                                                                                 | **currency:EUR**                  |
| `date:`       | La fecha en que se creó un objeto (idéntica a `created`).                                                                                                                                                                     | **date:yesterday**                |
| `email:`      | El correo electrónico (la dirección completa o parte de una dirección) de un objeto.                                                                                                                                          | **email:jenny.rosen@example.com** |
| `exp:`        | La fecha de vencimiento de la tarjeta asociada con un objeto.                                                                                                                                                                 | **exp:08/22**                     |
| `flow:`       | El tipo de [flujo de acción del cliente](https://docs.stripe.com/sources.md#flow-for-customer-action) que se aplica a un pago con objetos [Source](https://docs.stripe.com/sources.md).                                       | **flow:redirect**                 |
| `last4:`      | Los últimos cuatro dígitos del número de la tarjeta o de la cuenta asociada con un objeto.                                                                                                                                    | **last4:4080**                    |
| `metadata:`   | El valor de [metadatos](https://docs.stripe.com/api.md#metadata) en un objeto compatible. También hay disponibles otras [opciones de búsqueda](https://docs.stripe.com/dashboard/search.md#metadata-searches) para metadatos. | **metadata:555-5555**             |
| `name:`       | El nombre del titular de la tarjeta o del cliente asociado con un objeto.                                                                                                                                                     | **name:jenny**                    |
| `number:`     | El número único que identifica a la factura.                                                                                                                                                                                  | **number:06b2b1a642-0023**        |
| `postal:`     | El código postal asociado con un objeto.                                                                                                                                                                                      | **postal:12345**                  |
| `receipt:`    | El número de recibo utilizado en el recibo por correo electrónico de un pago o rembolso.                                                                                                                                      | **receipt:3330-2392**             |
| `risk_level:` | El [nivel de riesgo](https://docs.stripe.com/radar/risk-evaluation.md) de un pago determinado por [Radar](https://docs.stripe.com/radar.md).                                                                                  | **risk\_level:elevated**          |
| `status:`     | El estado de un objeto.                                                                                                                                                                                                       | **status:canceled**               |
| `type:`       | El tipo de [PaymentMethod](https://docs.stripe.com/payments/payment-methods.md) o [Source](https://docs.stripe.com/sources.md) utilizado para crear un pago.                                                                  | **type:ideal**                    |
| `usage:`      | La disponibilidad de [uso](https://docs.stripe.com/sources.md#single-use-or-reusable) de un método de pago con objetos [Source](https://docs.stripe.com/sources.md).                                                          | **usage:single\_use**             |
| `zip:`        | El código postal asociado con un objeto.                                                                                                                                                                                      | **zip:12345**                     |

#### Operadores

Cuando busques cantidades o fechas, puedes usar los siguientes operadores para ajustar la búsqueda a un determinado rango:

| Operador | Descripción                                                | Ejemplo                |
| -------- | ---------------------------------------------------------- | ---------------------- |
| `>`      | Mayor de una cantidad o después de una fecha especificada. | **amount:>149.99**     |
| `<`      | Menor de una cantidad o antes de una fecha especificada.   | **date:<2020-07-12**   |
| `..`     | Dentro de un intervalo de fechas o cantidades.             | **amount:50.00…99.99** |

También puedes usar el operador booleano `is:` para filtrar los resultados a un tipo de objeto o estado específico.

Usa `is:` con un tipo de objeto para mostrar solo resultados de ese tipo.

| Operador           | Descripción                                      | Ejemplo                  |
| ------------------ | ------------------------------------------------ | ------------------------ |
| `account`          | Una cuenta conectada.                            | **is:account**           |
| `charge`           | Un pago (idéntico a `payment`).                  | **is:charge**            |
| `checkout_session` | Una sesión de Checkout.                          | **is:checkout\_session** |
| `coupon`           | Un cupón.                                        | **is:coupon**            |
| `credit_note`      | Una nota de crédito.                             | **is:credit\_note**      |
| `customer`         | Un cliente.                                      | **is:customer**          |
| `dispute`          | Una disputa.                                     | **is:dispute**           |
| `document`         | Un documento.                                    | **is:document**          |
| `invoice`          | Una factura.                                     | **is:invoice**           |
| `invoiceitem`      | Un ítem de factura.                              | **is:invoiceitem**       |
| `order`            | Un pedido.                                       | **is:order**             |
| `payment`          | Un pago (idéntico a `charge`).                   | **is:payment**           |
| `payment_intent`   | Un PaymentIntent.                                | **is:payment\_intent**   |
| `payment_link`     | Un enlace de pago.                               | **is:payment\_link**     |
| `payment_method`   | Un PaymentMethod.                                | **is:payment\_method**   |
| `payout`           | Una transferencia.                               | **is:payout**            |
| `plan`             | Un plan de suscripción.                          | **is:plan**              |
| `price`            | Un precio.                                       | **is:price**             |
| `product`          | Un producto.                                     | **is:product**           |
| `promotion_code`   | Un código de promoción.                          | **is:promotion\_code**   |
| `quote`            | Un presupuesto.                                  | **is:quote**             |
| `refund`           | Un reembolso.                                    | **is:refund**            |
| `setup_intent`     | Un SetupIntent.                                  | **is:setup\_intent**     |
| `source`           | Un [Source](https://docs.stripe.com/sources.md). | **is:Source**            |
| `subscription`     | Una suscripción.                                 | **is:subscription**      |
| `transfer`         | Un movimiento de fondos entre cuentas de Stripe. | **is:transfer**          |

Usa `is:` con un estado para mostrar solo los resultados que coincidan con ese estado.

| Operador    | Descripción                                          | Ejemplo          |
| ----------- | ---------------------------------------------------- | ---------------- |
| `active`    | Un plan, precio o tarjeta de regalo que esté activo. | **is:active**    |
| `captured`  | Un pago que ha sido capturado.                       | **is:captured**  |
| `disputed`  | Un pago que ha sido disputado.                       | **is:disputed**  |
| `paid`      | Un pago o una factura que ha sido abonada.           | **is:paid**      |
| `recurring` | Un precio que es recurrente.                         | **is:recurring** |
| `refunded`  | Un pago que se reembolsó.                            | **is:refunded**  |

### Combinar y negar términos de búsqueda

Utiliza más de un término de búsqueda para limitar la búsqueda. También puedes negar un filtro de búsqueda con un guion (`-`) para que las coincidencias con ese valor no se incluyan.

| Ejemplo                           | Descripción                                                                                       |
| --------------------------------- | ------------------------------------------------------------------------------------------------- |
| `type:card last4:4242 exp:08/22`  | Los últimos cuatro dígitos de la tarjeta son `4242` y la fecha de vencimiento es `08/22`.         |
| `type:card last4:4242 -exp:08/22` | Los últimos cuatro dígitos de la tarjeta son `4242` y la fecha de vencimiento *no* es `08/22`.    |
| `type:ideal status:canceled`      | Los pagos con iDEAL en los que la fuente ha sido cancelada y no utilizada para completar un pago. |

Para buscar una frase completa, use comillas. Por ejemplo, **“Stripe Shop”** proporciona coincidencias para esa frase completa, pero **Stripe Shop** busca las palabras **Stripe** y **Shop** por separado.

### Búsquedas de metadatos

Puedes buscar [metadatos](https://docs.stripe.com/api.md#metadata) que agregaste a objetos compatibles. Por ejemplo, puedes encontrar documentos que tengan la clave de metadatos `order_id` con el valor de metadatos `xyn712` correspondiente mediante alguna de las siguientes consultas de búsqueda:

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

## Busca en toda la organización

Después de agregar varias cuentas de Stripe a una [organización](https://docs.stripe.com/get-started/account/orgs.md), los miembros de tu equipo pueden buscar en todas las cuentas a las que tengan acceso dentro de esa organización. De forma predeterminada, las búsquedas muestran los resultados de todas estas cuentas. Si un miembro del equipo está viendo el Dashboard desde una cuenta, hay una opción en el menú desplegable de búsqueda para buscar solo dentro de esa cuenta.

## Mejores prácticas

Muchas búsquedas se pueden hacer con un solo término de búsqueda. Usa algo que sea bastante específico, como un nombre o una dirección de correo electrónico. Si ves muy pocos resultados, haz que el término de búsqueda sea menos específico. Si obtienes demasiados resultados, incluye otros términos, uno por vez.

Usa un rango de valores más amplio cuando incluyas fechas o cantidades como términos de búsqueda. Las conversiones de moneda y las diferencias entre tu zona horaria y la del cliente suelen ser motivos comunes de confusión al buscar información sobre un pago. En estos casos, puede resultar de útil agregar términos de búsqueda adicionales o incluso diferentes.

> #### Búsquedas de marcadores
> 
> Como los términos de búsqueda se incluyen en la URL, puedes agregar un marcador a la búsqueda o compartirla con otros miembros del equipo como con cualquier otra página web.