Stripe

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Usar la conexión de Stripe en una integración

Una vez que hayas creado la conexión, estará disponible tanto en Apigee Integration como en Application Integration. Puedes usar la conexión en una integración mediante la tarea Conectores.

• Para saber cómo crear y usar la tarea Conectores en la integración de Apigee, consulta Tarea Conectores.
• Para saber cómo crear y usar la tarea Conectores en Application Integration, consulta Tarea Conectores.

Acciones

En esta sección se enumeran las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción ConfirmPaymentIntent

Esta acción confirma la intención de pago.

Parámetros de entrada de la acción ConfirmPaymentIntent

Para ver un ejemplo de cómo configurar la acción ConfirmPaymentIntent, consulta los ejemplos de acciones.

Acción CapturePaymentIntent

Esta acción captura la intención de pago.

Parámetros de entrada de la acción CapturePaymentIntent

Para ver un ejemplo de cómo configurar la acción ConfirmPaymentIntent, consulta los ejemplos de acciones.

Acción CancelPaymentIntent

Esta acción cancela la intención de pago.

Parámetros de entrada de la acción CancelPaymentIntent

Para ver un ejemplo de cómo configurar la acción CancelPaymentIntent, consulta los ejemplos de acciones.

Acción AttachPaymentMethodToCustomer

Con esta acción se adjunta un objeto PaymentMethod a un cliente.

Parámetros de entrada de la acción AttachPaymentMethodToCustomer

Para ver un ejemplo de cómo configurar la acción AttachPaymentMethodToCustomer, consulta los ejemplos de acciones.

Acción DetachPaymentMethodFromCustomer

Esta acción desvincula un objeto PaymentMethod de un cliente. Una vez que se ha desvinculado un PaymentMethod, no se puede volver a vincular al cliente.

Parámetros de entrada de la acción DetachPaymentMethodFromCustomer

Para ver un ejemplo de cómo configurar la acción DetachPaymentMethodFromCustomer, consulta los ejemplos de acciones.

Acción FinalizeInvoice

Con esta acción se finaliza la factura provisional.

Parámetros de entrada de la acción Finalizar factura

Para ver un ejemplo de cómo configurar la acción FinalizeInvoice, consulta Ejemplos de acciones.

FinalizeQuote action

Esta acción finaliza la cotización borrador.

Parámetros de entrada de la acción FinalizeQuote

Para ver un ejemplo de cómo configurar la acción FinalizeQuote, consulta Ejemplos de acciones.

Acción AcceptQuote

Con esta acción se acepta la solicitud de presupuesto y se genera una factura.

Parámetros de entrada de la acción AcceptQuote

Para ver un ejemplo de cómo configurar la acción AcceptQuote, consulta Ejemplos de acciones.

CancelQuote action

Esta acción cancela la cotización creada.

Parámetros de entrada de la acción CancelQuote

Para ver un ejemplo de cómo configurar la acción CancelQuote, consulta Ejemplos de acciones.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: confirmar la intención de pago

En este ejemplo se muestra cómo confirmar la intención del pago especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ConfirmPaymentIntent y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "ReturnUrl": "http://google.com/",
   "PaymentIntentId": "pi_3OggwFANHgX3SHp71AVrNtT3"
   }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea ConfirmPaymentIntent tendrá un valor similar al siguiente:

[{
"Success": "true",
"id": "pi_3OggwFANHgX3SHp71AVrNtT3",
"object": "payment_intent",
"amount": "33000",
"amount_capturable": "0",
"amount_received": "33000",
"canceled_at": null,
"cancellation_reason": null,
"capture_method": "automatic",
"client_secret": "pi_3OggwFANHgX3SHp71AVrNtT3_secret_YEfjrYL5uHQZrGCx66cJbedlA",
"confirmation_method": "automatic",
"created": "1707196279",
"currency": "usd",
"invoice": null,
"last_payment_error": null,
"latest_charge": "ch_3OggwFANHgX3SHp71uYScRAw",
"level3": null,
"livemode": "false",
"next_action": null,
"on_behalf_of": null,
"payment_method": "pm_1Oggu6ANHgX3SHp7zaRNKNVL",
"payment_method_configuration_details": null,
"payment_method_options.card.installments": null,
"review": null,
"setup_future_usage": null,
"statement_descriptor_suffix": null,
"status": "succeeded",
"transfer_data": null,
"transfer_group": null
}]

Ejemplo: captar la intención de pago

En este ejemplo se muestra cómo capturar la intención del pago especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CapturePaymentIntent y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "PaymentIntentId": "pi_3Ogh4sANHgX3SHp72YB0YotA"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CapturePaymentIntent tendrá un valor similar al siguiente:

[{
"Success": "true",
"id": "pi_3Ogh4sANHgX3SHp72YB0YotA",
"object": "payment_intent",
"amount": "33000",
"amount_capturable": "0",
"amount_received": "33000",
"canceled_at": null,
"cancellation_reason": null,
"capture_method": "manual",
"client_secret": "pi_3Ogh4sANHgX3SHp72YB0YotA_secret_jgqc0olEAOTcurQSDeQThJa3X",
"confirmation_method": "automatic",
"created": "1707196814",
"currency": "usd",
"customer": "cus_Okyi4e7t7BImUL",
"description": null,
"invoice": null,
"last_payment_error": null,
"latest_charge": "ch_3Ogh4sANHgX3SHp72uGBS7g4",
"level3": null,
"livemode": "false",
"next_action": null,
"on_behalf_of": null,
"payment_method": "pm_1Ogh4FANHgX3SHp7GBJJvfGR",
"payment_method_configuration_details": null,
"payment_method_options.card.installments": null,
"payment_method_types": null,
"processing": null,
"receipt_email": null,
"review": null,
"statement_descriptor_suffix": null,
"status": "succeeded",
"transfer_data": null,
"transfer_group": null
}]

Ejemplo: cancelar una intención de pago

En este ejemplo se muestra cómo cancelar la intención del pago especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CancelPaymentIntent y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "PaymentIntentId": "pi_3Ogh7HANHgX3SHp738skMdSQ"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CancelPaymentIntent tendrá un valor similar al siguiente:

[{
"Success": "true",
"id": "pi_3Ogh7HANHgX3SHp738skMdSQ",
"object": "payment_intent",
"amount": "33000",
"amount_capturable": "0",
"amount_received": "0",
"canceled_at": "1707197160",
"cancellation_reason": null,
"capture_method": "manual",
"client_secret": "pi_3Ogh7HANHgX3SHp738skMdSQ_secret_NqQsBexbdyk19ETdMnpQXF19j",
"confirmation_method": "automatic",
"created": "1707196963",
"currency": "usd",
"customer": "cus_Okyi4e7t7BImUL",
"description": null,
"invoice": null,
"last_payment_error": null,
"latest_charge": "ch_3Ogh7HANHgX3SHp73LJMZiy5",
"level3": null,
"livemode": "false",
"next_action": null,
"on_behalf_of": null,
"payment_method": "pm_1Ogh75ANHgX3SHp79MNT6IHs",
"payment_method_configuration_details": null,
"receipt_email": null,
"review": null,
"setup_future_usage": null,
"shipping": null,
"status": "canceled",
"transfer_data": null,
"transfer_group": null
}]

Ejemplo: asociar un método de pago a un cliente

En este ejemplo se muestra cómo adjuntar un método de pago al cliente especificado.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción AttachPaymentMethodToCustomer y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "PaymentMethodId": "pm_1OYm2nANHgX3SHp7ihGfm5U8",
   "CustomerId": "cus_PNX7n9xMDsMPH4"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea AttachPaymentMethodToCustomer tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: Desvincular un método de pago de un cliente

En este ejemplo se muestra cómo desvincular un método de pago de un cliente.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DetachPaymentMethodFromCustomer y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "PaymentMethodId": "pm_1OYm2nANHgX3SHp7ihGfm5U8"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DetachPaymentMethodFromCustomer tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: Finalizar una factura

En este ejemplo se muestra cómo finalizar una factura.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción FinalizeInvoice y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "InvoiceId": "in_1OhnXRANHgX3SHp73ufStlXy"
   }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea Finalize Invoice tendrá un valor similar al siguiente:

[{
"Success": "true",
"id": "in_1OhnXRANHgX3SHp73ufStlXy",
"object": "invoice",
"account_country": "US",
"account_name": "ZBTA_US_SAPDPA_TestAccount",
"billing_reason": "manual",
"charge": null,
"collection_method": "charge_automatically",
"created": "1707459976",
"currency": "usd",
"discounts": null,
"due_date": null,
"effective_at": "1707460034",
"ending_balance": "0",
"footer": null,
"lines.data": null,
"lines.has_more": "false",
"lines.total_count": "0",
"livemode": "false",
"next_payment_attempt": null,
"number": "F3C0E263-0004",
"on_behalf_of": null,
"paid": "true",
"paid_out_of_band": "false",
"payment_intent": null,
}]

Ejemplo: Finalizar una solicitud de presupuesto

En este ejemplo se muestra cómo finalizar una solicitud de presupuesto.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción FinalizeQuote y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "QuoteId": "qt_1ObiPfANHgX3SHp7KT7DXaJe"
   }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea FinalizeQuote tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplo: aceptar una estimación

En este ejemplo se muestra cómo aceptar una oferta.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción AcceptQuote y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "QuoteId": "qt_1ObmqKANHgX3SHp7ahHydwav"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea AcceptQuote tendrá un valor similar al siguiente:

[{
"InvoiceId": "in_1Obmr5ANHgX3SHp7HKi6bJDu",
"Success": "true"
}]

Ejemplo: cancelar una solicitud de presupuesto

En este ejemplo se muestra cómo cancelar una solicitud de presupuesto.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CancelQuote y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "QuoteId": "qt_1Obmu3ANHgX3SHp7as57wBLf"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CancelQuote tendrá un valor similar al siguiente:

[{
"Success": "true"
}]

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Ejemplo: listar todos los clientes

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Customer en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, puede definir filterClause según los requisitos del cliente.

Debe usar comillas simples (") para incluir el valor de un filterClause. Puede usar filterClause para filtrar registros en función de las columnas.

Ejemplo: obtener los detalles de un cliente

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Customer en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca cus_OxHsz0u5bCGWuy en el campo Valor predeterminado.

   En este caso, cus_OxHsz0u5bCGWuy es un ID de registro único de la entidad Customer.

Ejemplo: crear un cliente

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Customer en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Name": "abc"
   }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "cus_OxIqiMh1W335rE"
   }
   
   

Ejemplo: crear un reembolso

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Refunds en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Charge": "ch_3OU27zANHgX3SHp73HqiDsh3",
     "Amount": 10.0
   }
   

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "re_3OU27zANHgX3SHp73nxqZMF2"
   }
   

Ejemplo: crear una tarjeta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Cards en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "CustomerId": "cus_OmptWC2kb2264y",
     "Token": "tok_1O9kUPANHgX3SHp7WcrPumVI"
   }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "card_1O9kUPANHgX3SHp7Q8Hsk35F",
     "CustomerId": "cus_OmptWC2kb2264y"
   }
   

Ejemplo: crear un precio

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Prices en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Currency": "usd",
     "Product": "prod_OlNe53LwNydXSx",
     "UnitAmount": 1200.0
   }
   

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "price_1OAR1TANHgX3SHp7EeiZTW9h"
   }
   

Ejemplo: Crear una factura

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Invoices en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "CustomerId": "cus_OhvXm2EI9bsFyN"
   }
   

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "in_1OXR9gANHgX3SHp7wHdnEe7U"
   }
   

Ejemplo: crear una línea de factura

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona InvoiceItems en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Customer": "cus_OksFS6F8HS7o5O",
     "Currency": "usd",
     "Amount": 1000.0
   }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "ii_1OZAfAANHgX3SHp7xsd9o7Qm"
   }
   

Ejemplo: crear una cotización

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Quotes en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "CustomerId": "cus_POGecLC3f3hwk2"
   }
   

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "qt_1OZU92ANHgX3SHp75zJzMSvC"
   }
   

Ejemplo: crear una cuenta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Accounts en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Type": "standard"
   }
   

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

   {
     "Id": "acct_1OZBcsQbE7mBlkdN"
   }
   

Ejemplo: crear un intento de pago

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona PaymentIntent en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "PaymentMethod": "pm_1OXN5YANHgX3SHp7Q5Y0rb39",
   "Currency": "usd",
   "Amount": 1500.0
   }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
   "Id": "pi_3OXN69ANHgX3SHp70tgsxkuR"
   }

Ejemplo: actualizar los detalles de un cliente

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Customer en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "Name": "Charlie"
   }

5. Haga clic en entityId y, a continuación, introduzca cus_OxHsz0u5bCGWuy en el campo Valor predeterminado.

   Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {
   "Id": "cus_OxHsz0u5bCGWuy"
   }

Ejemplo: actualizar un intento de pago

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona PaymentIntent en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Description": "Payment Intent"
   }
   

5. Asigna el valor pi_3OWzKoANHgX3SHp70nE8QKyn a entityId. Para definir el entityId, haga clic en entityId y, a continuación, introduzca pi_3OWzKoANHgX3SHp70nE8QKyn en el campo Valor predeterminado.

   En lugar de especificar el entityId, también puede definir filterClause como 'pi_3OWzKoANHgX3SHp70nE8QKyn'.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
     "Id": "pi_3OWzKoANHgX3SHp70nE8QKyn"
   }
   

Ejemplo: actualizar los detalles de una tarjeta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Cards en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "AddressCountry": "US",
     "Id": "card_1O9kUPANHgX3SHp7Q8Hsk35F",
     "CustomerId": "cus_OmptWC2kb2264y"
   }
   

5. Define filterClause como CustomerId = 'cus_OmptWC2kb2264y' y Id = 'card_1O9kUPANHgX3SHp7Q8Hsk35F'. Para definir filterClause, haz clic en filterClause y, a continuación, introduce CustomerId = 'cus_OmptWC2kb2264y' and Id = 'card_1O9kUPANHgX3SHp7Q8Hsk35F' en el campo Valor predeterminado.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
     "result": [{
       "Id": "card_1O9kUPANHgX3SHp7Q8Hsk35F",
       "CustomerId": "cus_OmptWC2kb2264y"
     }]
   } 
   

Ejemplo: actualizar los detalles del precio

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Prices en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Nickname": "Price Update"
   }
   

5. Asigna el valor price_1O9nTjANHgX3SHp7Zr552abc a entityId. Para definir el entityId, haga clic en entityId y, a continuación, introduzca price_1O9nTjANHgX3SHp7Zr552abc en el campo Valor predeterminado.

   En lugar de especificar el entityId, también puede definir filterClause como 'price_1O9nTjANHgX3SHp7Zr552abc'.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
    "Id": "price_1O9nTjANHgX3SHp7Zr552abc"
   }
   

Ejemplo: actualizar una factura

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Invoices en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Description": "Invoice for car"
   }
   

5. Asigna el valor in_1OA74xANHgX3SHp7YbC6x9R6 a entityId. Para definir el entityId, haga clic en entityId y, a continuación, introduzca in_1OA74xANHgX3SHp7YbC6x9R6 en el campo Valor predeterminado.

   En lugar de especificar el entityId, también puede definir filterClause como 'in_1OA74xANHgX3SHp7YbC6x9R6'.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
     "Id": "in_1OA74xANHgX3SHp7YbC6x9R6"
   }
   

Ejemplo: actualizar un elemento de factura

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona InvoiceItems en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "Quantity": 3.0
   }
   

5. Asigna el valor ii_1OZAfAANHgX3SHp7xsd9o7Qm a entityId. Para definir el entityId, haga clic en entityId y, a continuación, introduzca ii_1OZAfAANHgX3SHp7xsd9o7Qm en el campo Valor predeterminado.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
     "Id": "ii_1OZAfAANHgX3SHp7xsd9o7Qm"
   }
   

Ejemplo: actualizar una cotización

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Quotes en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "CustomerId": "cus_PQuEGGfutajbAs"
   }
   

5. Asigna el valor qt_1Oc2VaANHgX3SHp7PaM9Ph9o a entityId. Para definir el entityId, haga clic en entityId y, a continuación, introduzca qt_1Oc2VaANHgX3SHp7PaM9Ph9o en el campo Valor predeterminado.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
     "Id": "qt_1Oc2VaANHgX3SHp7PaM9Ph9o"
   }
   

Ejemplo: actualizar los detalles de la cuenta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Accounts en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "BusinessProfileName": "StagingName"
   }
   

5. Asigna el valor acct_1OZBcsQbE7mBlkdN a entityId. Para definir el entityId, haga clic en entityId y, a continuación, introduzca acct_1OZBcsQbE7mBlkdN en el campo Valor predeterminado.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   
   {
     "Id": "acct_1OZBcsQbE7mBlkdN"
   }
   

Ejemplo: eliminar un cliente

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Customer en la lista Entity.
3. Selecciona la operación Delete y, a continuación, haz clic en Hecho.
4. Haga clic en entityId y, a continuación, introduzca cus_OxIqiMh1W335rE en el campo Valor predeterminado.

Si la entidad tiene dos claves empresariales o primarias compuestas, en lugar de especificar entityId, puede definir filterClause como id='cus_OxIqiMh1W335rE'.