# Clientes Aprende a utilizar el recurso Customer con Stripe Invoicing. If your integration uses [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), replace `Customer` and event references in the code examples with the equivalent Accounts v2 API references. For more information, see [Represent customers with Account objects](https://docs.stripe.com/connect/use-accounts-as-customers.md). Crea un cliente por cada empresa o usuario nuevo al que le quieras facturar. Al crear un cliente nuevo, define un [perfil básico de cliente](https://docs.stripe.com/invoicing/customer.md#customer-profile) que te ayude a generar facturas más útiles y habilita Smart Retries (si eres usuario de [Invoicing Plus](https://stripe.com/invoicing/pricing)). Después de configurar el cliente, podrás emitir facturas únicas o crear *suscripciones* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis). > Antes de crear un nuevo cliente, asegúrate de que el cliente no exista en el Dashboard. Si creas varias entradas de clientes para el mismo cliente, puedes tener problemas más adelante, por ejemplo, cuando necesites conciliar el historial de transacciones o coordinar los métodos de pago guardados. #### Dashboard Puedes crear y administrar clientes en la [página Clientes](https://dashboard.stripe.com/customers) cuando no quieras usar código para crear clientes o si quieres facturarle una factura puntual a un cliente manualmente. > También puedes crear un cliente en el Dashboard mientras generas una factura. ### Crear un cliente Cuando creas un cliente nuevo, puedes definir los datos de facturación y de la cuenta, como el **correo electrónico**, el **nombre** y el **país**. También puedes establecer la moneda y el idioma preferidos del cliente, además de cualquier otro dato relevante. En la página **Clientes**, también puedes llevar a cabo estas acciones: - Filtrar clientes. - Eliminar clientes. - Ver todos los clientes. - Exportar una lista de datos de clientes. Para crear un cliente, sigue estos pasos: 1. Verifica que el cliente no exista. 1. En la página **Clientes**, haz click en **Agregar cliente** o presiona la tecla **N**. 1. Como mínimo, ingresa el **nombre** y el **correo electrónico de la cuenta** de tu cliente. 1. En el cuadro de diálogo, haz click en **Agregar cliente**. ### Editar un cliente Para editar el perfil de un cliente, sigue estos pasos: 1. En la página **Clientes**, busca el cliente que quieras modificar y haz click en su nombre. 1. En la página de datos de la cuenta, haz click en **Acciones** > **Editar información**. 1. Modifica el perfil del cliente. 1. Haz click en **Actualizar cliente**. ### Eliminar un cliente Para eliminar un cliente, sigue estos pasos: 1. En la página **Clientes**, busca el cliente que quieras eliminar. 1. Haz click en la casilla que se encuentra al lado del nombre del cliente y luego en **Eliminar**. También puedes ir a la página de datos del cliente y seleccionar **Acciones** > **Eliminar cliente**. #### API Antes de crear un nuevo cliente, verifica que no exista ese cliente. Por ejemplo, especifica una dirección de correo electrónico a la API [enumera todos los clientes](https://docs.stripe.com/api/customers/list.md). ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` En el siguiente ejemplo, verás cómo crear un nuevo cliente con una dirección de correo electrónico y un método de pago predeterminado. Consulta [crear un cliente](https://docs.stripe.com/api/customers/create.md) para ver una lista completa de los argumentos que se pueden especificar en la API. ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d payment_method=pm_card_visa \ -d "invoice_settings[default_payment_method]=pm_card_visa" ``` ## Perfiles de clientes Utiliza el perfil básico del cliente para la generación de facturas y recibos o como sistema ligero de gestión de la relación con el cliente (CRM) para tu aplicación. Para crear un perfil básico de cliente, debes definir las siguientes propiedades: - Dirección de correo electrónico. - Nombre del cliente. - Metadatos con una referencia al ID interno del cliente en tu aplicación. Stripe utiliza la [dirección de correo electrónico](https://docs.stripe.com/api/customers/object.md#customer_object-email) de los clientes para notificarles los pagos fallidos. También utiliza esta dirección para notificarles cuándo deben llevar a cabo una acción para completar un pago. Guarda el ID interno del cliente para tu aplicación en el atributo [metadata](https://docs.stripe.com/api/customers/object.md#customer_object-metadata). Como la mayoría de los recursos de Stripe, el recurso `Customer` incluye el hash del objeto [Metadata](https://docs.stripe.com/api/metadata.md) para almacenar de forma flexible información contextual de clave-valor. Para ayudar en el proceso de auditoría y soporte, guarda el ID interno del cliente como par clave-valor en el recurso `Customer`. Esto te permite buscar a un cliente usando su ID interno de referencia. Te recomendamos almacenar los ID de clientes de Stripe en el modelo de cliente interno de tu aplicación. ### Direcciones de facturación y envío Usa los [atributos de dirección](https://docs.stripe.com/api/customers/object.md#customer_object-address) para definir una dirección de facturación para generar facturas y notas de crédito. Para el envío de bienes físicos, debes agregar una dirección de [envío](https://docs.stripe.com/api/customers/object.md#customer_object-shipping). > Las facturas, las notas de crédito y los recibos muestran la dirección de facturación. Es un requisito habitual de cumplimiento de la normativa fiscal. ### Localización del idioma en los correos electrónicos y los PDF Al crear un cliente, usa el menú desplegable **Idioma** para definir su idioma de preferencia. (También puedes agregar o editar el idioma de preferencia en la página **Datos del cliente** o al crear una factura). Stripe utilizará este idioma para localizar las facturas que se envíen por correo electrónico y en PDF, los recibos que se envíen por correo electrónico y en PDF, y las notas de crédito en PDF. Para actualizar el idioma en la API, usa el parámetro [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales). Este parámetro acepta una lista de idiomas ordenados por preferencia. Estos valores de configuración regional preferidos se basan en la normativa [RFC-4646](https://tools.ietf.org/html/rfc4646), por ejemplo, “en” para inglés o “fr-CA” para francés canadiense. Para obtener más información, consulta la página [Idiomas preferidos del cliente](https://docs.stripe.com/invoicing/customize.md#customer-language). ## Propiedades de cliente La siguiente tabla contiene propiedades de cliente adicionales: | Propiedad | Descripción | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Propiedades de pago | Stripe cobra los pagos usando los datos de [pago](https://docs.stripe.com/payments.md) asociados al cliente, y cada cliente puede tener varias modalidades de pago, entre las que se incluyen la [API Payment Methods](https://docs.stripe.com/payments/payment-methods.md) y el [saldo acreedor del cliente](https://docs.stripe.com/invoicing/customer/balance.md). Los clientes tienen una sola moneda, lo que quiere decir que una vez que asignaste una moneda, facturaste o definiste un saldo acreedor de cliente, ya no puedes cambiar la moneda. Este bloqueo es visible en el Dashboard, en el menú desplegable **Moneda**, que estará desactivado. Si tienes que facturarle a una misma entidad en varias monedas, debes crear un nuevo cliente para cada moneda. | | Propiedades de facturación | Todos los [recursos relacionados con la facturación](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) se asocian al cliente al que se le está facturando. | | Propiedades de impuestos | Para cumplir con los requisitos fiscales de cada jurisdicción, es posible que debas incluir en las facturas los números de identificación fiscal y otros datos del cliente. Eres responsable de que las facturas contengan la información correcta. Esto incluye las [identificaciones fiscales](https://docs.stripe.com/invoicing/customer/tax-ids.md), la [condición de exención fiscal](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) y las [direcciones](https://docs.stripe.com/invoicing/customer.md#addresses). Las identificaciones fiscales permiten guardar y procesar uno o más números de identificación fiscal en las facturas. La condición de exención fiscal indica si la entidad está sujeta a impuestos o no. El valor predeterminado del parámetro `tax_exempt` de un cliente es `none`, lo que significa que es una entidad con facturación sujeta a impuestos. Sin embargo, puedes definir `tax_exempt` en `reverse` para los clientes que deben pagar el impuesto de la factura. También puedes marcar al cliente como exento estableciendo el estado en `exempt`. Puedes obtener más información sobre el uso de `tax_exempt` y `reverse` en la página sobre [Tasas impositivas](https://docs.stripe.com/billing/taxes/tax-rates.md#tax-exempt-and-reverse-charge). | ## Tareas habituales A continuación, se explican algunas de las tareas habituales que puedes llevar a cabo con el recurso `Customer`: - **Enviar una factura a un cliente**: después de crear el cliente, puedes [enviarle una factura](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). - \**Almacenar el saldo acreedor de un cliente **: la funcionalidad de saldo acreedor del cliente te permite asignar ajustes de crédito y débito a un cliente específico, y luego aplicar el saldo resultante a las facturas futuras de ese cliente. - **Agregar y validar números de identificación fiscal**: por lo general, se exige exhibir la identificación fiscal del cliente en las facturas. Con Stripe, puedes agregarle a un solo cliente varias identificaciones fiscales. Las identificaciones fiscales de un cliente aparecen en el encabezado de las facturas y las notas de crédito en PDF. Para obtener más información, consulta la página [Identificaciones fiscales de clientes](https://docs.stripe.com/invoicing/customer/tax-ids.md). - **Configurar la moneda de un cliente**: con el Dashboard, puedes configurar la moneda predeterminada para cobrar las facturas de un cliente. Para ello, navega a la página **Clientes**, selecciona a tu cliente y haz clic en **Editar**, que se encuentra junto a **Detalles**. Consulta la página [Clientes en varias monedas](https://docs.stripe.com/invoicing/multi-currency-customers.md) para obtener más información sobre cómo facturar al mismo cliente con una moneda diferente a su moneda predeterminada. - **Crear clientes de manera masiva**: carga clientes de forma masiva mediante las [Productivity Stripe Apps](https://marketplace.stripe.com/categories/productivity).