Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de un CRM anterior con la integración de Amazon S3
**importante**
La Central de socios de AWS dejó de aceptar nuevas solicitudes para este tipo de integración en 2024. Esta sección solo se aplica a los socios que utilizan Amazon S3.
Para comenzar con una nueva integración de CRM personalizada, consulte la [referencia de API de AWS Partner Central](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html).
**Topics**
+ [Actualización de un CRM con integración de Amazon S3 a la API de Partner Central](upgrade-crm-api.md)
+ [Configuración del conector para un CRM con la integración de Amazon S3](s3-config.md)
+ [Recursos de integración](resources.md)
+ [Intercambio de clientes potenciales](custom-lead-sharing.md)
+ [Compartir oportunidades](custom-opportunity-sharing.md)
+ [Asignación de campo](custom-field-mapping.md)
+ [Creación de programas de sincronización](crm-connector-scheduling.md)
+ [Prácticas recomendadas](best-practices.md)
+ [Cuotas](quotas.md)
+ [Historial de versiones](version-history.md)
+ [FAQs](faqs.md)
# Actualización de un CRM con integración de Amazon S3 a la API de Partner Central
**nota**
En los temas de esta sección se supone que ha completado los requisitos previos para una integración de AWS Partner Central, una integración de AWS Marketplace o ambas. Para obtener más información, consulte [Requisitos previos para la integración](crm-integration-setting-up.md) y [Introducción](crm-integration-getting-started.md) anteriormente en esta guía.
En los pasos de las siguientes secciones se explica cómo actualizar una versión anterior de CRM con integración de Amazon S3 a la API de AWS Partner Central. La actualización elimina la necesidad de varios requisitos de ACE, como la necesidad de un usuario de integración y la necesidad de configurar programas de sincronización.
**Topics**
+ [Características de actualización](api-upgrade-features.md)
+ [Configure las credenciales con nombre](set-up-api-credentials.md)
+ [Agregue el botón de estado de aprobación a la página de registro de Opportunity Lightning](add-approval-status-button.md)
+ [Añada los botones restantes](add-remaining-buttons.md)
+ [Actualice la pestaña Ofertas de soluciones](refresh-the-solutions-from-the-solution-offerings-tab.md)
# Características de actualización
La actualización ofrece las siguientes funciones:
+ Ya no necesita un conjunto de permisos de usuario de integración de ACE en Salesforce.
+ Ya no necesita crear un cronograma para las oportunidades de ACE en Salesforce.
+ La API de Partner Central también incluye un conjunto de botones que permiten realizar las siguientes acciones en su página de **registro de Opportunity Lightning**:
+ **Estado de aprobación**: acepte o rechace AWS las oportunidades recomendadas.
**nota**
Este botón reemplaza a la lista de **estados de aceptación de los socios**. Debe usar el botón para aceptar las oportunidades AWS originadas por usted.
+ **Compartir con AWS**: cree y actualice oportunidades.
+ **Asociar o desasociar: asocie** o desasocie una oportunidad con las soluciones, los AWS productos y las AWS Marketplace ofertas de los socios durante todo el ciclo de vida de la oportunidad.
+ **Asignar**: reasigne una oportunidad a otro usuario de su cuenta de Partner Central.
Los botones se añaden después de configurar las credenciales con nombre asignado. En los temas siguientes se explica cómo realizar esas tareas.
# Configure las credenciales con nombre
Para actualizar a la API de Partner Central, primero debe configurar las credenciales con nombre asignado. El conector de CRM utiliza las credenciales de su organización de Salesforce para autenticarse en Partner Central.
**Para configurar las credenciales**
1. Inicie sesión en Salesforce como administrador del sistema.
1. En **Credenciales con nombre**, seleccione **Nuevo anteriormente.**
1. En el formulario **Nueva credencial con nombre** asignado, introduzca los valores de la siguiente tabla.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/set-up-api-credentials.html)
1. Seleccione **Save**.
1. Vuelva a la página de **configuración AWS guiada**. En la sección **Detalles de autenticación**, selecciona **Revisar** y confirmar las credenciales.
# Agregue el botón de estado de aprobación a la página de registro de Opportunity Lightning
Los siguientes pasos explican cómo añadir el botón de **estado de aprobación** a su página de registro de Opportunity Lightning. El botón le permite ver el estado de sus oportunidades a medida que pasan por el proceso de aprobación.
**Para añadir el botón**
1. Inicie sesión en su organización de Salesforce como administrador del sistema.
1. Diríjase a la página **Opportunity Lightning Record**.
1. Elija el panel resaltado para abrir el panel de propiedades.
1. Selecciona **Actualizar ahora**.
1. Selecciona **Migrar acciones existentes** y, a continuación, selecciona el diseño de página desde el que quieres actualizar las acciones.
-O BIEN-
Comience desde cero y añada las acciones manualmente.
1. En la lista de **acciones**, seleccione **Estado de aprobación**.
1. Seleccione **Save**.
**nota**
Solo necesita completar los pasos 4 y 5 una vez.
El botón de **estado de aprobación** solo aparece en la página de **registro de Opportunity Lightning** para las AWS oportunidades recomendadas.
# Añada los botones restantes
Puede añadir algunos o todos los botones que se muestran en los siguientes pasos.
**Para añadir los botones**
1. Inicie sesión en su organización de Salesforce como administrador del sistema.
1. Navegue hasta la **página de registro de Opportunity Lightning**.
1. Elija el panel resaltado para abrir el panel de propiedades.
1. **Elija Asignar entre acciones** y, a continuación, seleccione algunos o todos los elementos siguientes:
+ **Comparte con AWS**
+ **Asociarse o desasociarse**
+ **Asignar**
Para obtener más información sobre la función de cada botón, consulte la [Características de actualización](api-upgrade-features.md) sección anterior de esta guía.
1. Seleccione **Save**.
# Actualice la pestaña Ofertas de soluciones
En los siguientes pasos se explica cómo actualizar los datos en la pestaña **Ofertas de soluciones**.
1. Inicie sesión en su organización de Salesforce como administrador del sistema.
1. Diríjase a la pestaña **Ofertas de soluciones**.
1. Seleccione **Actualizar soluciones**.
# Configuración del conector para un CRM con la integración de Amazon S3
**importante**
A partir de 2024, AWS Partner Central hizo que este tipo de integración no estuviera disponible para los nuevos usuarios.
**nota**
En los temas de esta sección se supone que ha completado los requisitos previos para una integración de AWS Partner Central, una integración de AWS Marketplace o ambas. Para obtener más información, consulte [Requisitos previos para la integración](crm-integration-setting-up.md) y [Introducción](crm-integration-getting-started.md) anteriormente en esta guía.
La integración obsoleta de CRM con Amazon S3 utiliza un bucket de Amazon S3 para transferir clientes potenciales y oportunidades. Recomendamos utilizar la integración de la API de Partner Central, tal y como se muestra en la sección anterior, para crear y gestionar oportunidades. Sin embargo, puede usar esta configuración si quiere usar el conector para gestionar los clientes potenciales en Salesforce.
**Topics**
+ [Introducir los detalles de autenticación de la conexión](#apn-s3-authentication-details)
+ [Introducir los ajustes de configuración del sistema](#apn-s3-config-settings)
+ [Comprobación de la conexión de](#apn-s3-testing)
+ [Envío y recepción de oportunidades y clientes potenciales](#sending-receiving-opportunities-leads)
+ [Lista de control de producción](ace-production-checklist.md)
+ [Actualización del conector AWS Partner CRM al nuevo modelo de datos](connector-upgrade-plan.md)
+ [Pruebas en entorno aislado con los objetos ACE Opportunity y ACE lead personalizados](custom-ace-opportunity.md)
+ [Vincular ofertas AWS Marketplace privadas con oportunidades de ACE](#linking-private-offers-to-ace)
## Introducir los detalles de autenticación de la conexión
Los socios comienzan el proceso de integración introduciendo los detalles necesarios para conectarse a su punto de conexión Amazon S3. Siga cada conjunto de pasos en el orden indicado y complete cada conjunto antes de continuar con el siguiente.
Las siguientes tareas se realizan desde la pestaña de **configuración AWS guiada**. Para obtener información sobre el uso de la pestaña, consulte la sección [Uso de la configuración guiada](use-guided-setup.md) anterior de esta guía.
**Para introducir los detalles de autenticación**
1. En Salesforce, abra la pestaña de **configuración AWS guiada**. Para obtener información sobre cómo abrir esa pestaña, consulte la sección [Uso de la configuración guiada](use-guided-setup.md) anterior de esta guía.
1. Expanda **el paso 1: detalles de autenticación de la AWS conexión** y seleccione **Iniciar.**
1. En la página **Credenciales con nombre**, seleccione **Nuevo anteriormente**.
1. En el formulario **Nueva credencial con nombre** asignado, introduzca los valores de la siguiente tabla.
| **Campo** | **Valor** |
| --- | --- |
| Etiqueta | Conexión API de APN |
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| Tipo de identidad | Nombrado director |
| Protocolo de autenticación | AWS firma, versión 4 |
| AWS ID de clave de acceso | Cloud-Ops proporciona el ID durante los pasos previos |
| AWS clave de acceso secreta | Cloud-Ops proporciona la clave de acceso durante los pasos previos |
| AWS Region | us-west-2 |
| AWS service | s3 |
| Genera un encabezado de autorización | checked |
| Permitir combinar campos en el encabezado HTTP | sin marcar |
| Permitir combinar campos en el cuerpo HTTP | sin marcar |
1. Seleccione **Save**.
1. Vuelva a la página de **configuración AWS guiada**. En la sección **Detalles de autenticación**, selecciona **Revisar** y confirmar las credenciales.
1. Mantén abierta la página **de configuración AWS guiada** y continúa con los pasos siguientes.
## Introducir los ajustes de configuración del sistema
En los pasos siguientes se explica cómo introducir los ajustes de configuración del sistema correctos para la integración.
1. Amplíe el **paso 2: Ajustes de configuración del sistema** y seleccione **Iniciar.**
1. Localice la **configuración del conector AWS Partner CRM** y seleccione **Administrar**.
1. Seleccione **Nuevo** y, a continuación, introduzca los valores necesarios de la siguiente tabla.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/s3-config.html)
1. Seleccione **Save**.
1. Vuelva a la página de **configuración AWS guiada.** En la sección **Detalles de autenticación**, selecciona **Revisar** y confirmar las credenciales.
## Comprobación de la conexión de
Antes de probar la conexión, asegúrese de completar los pasos de las secciones anteriores.
**Para probar la conexión**
1. Amplíe **el paso 3: Pruebe la configuración de la API de APN.**
1. Seleccione **Probar**
Si la conexión se realiza correctamente, recibirá un mensaje de confirmación.
## Envío y recepción de oportunidades y clientes potenciales
Puede enviar y recibir oportunidades y clientes potenciales sincronizándolos con Partner Central. **Para sincronizar una oportunidad o un cliente potencial, debe establecer el campo **Sincronizar con Partner Central** en True.** Los campos clave adicionales para la integración incluyen la **fecha de la última sincronización de APN** y los campos **Apto para sincronizarse con APN**.
Estos campos se incluyen para las oportunidades y clientes potenciales estándar. Sin embargo, debe crearlos y mapearlos para cualquier objeto fuente personalizado.
+ **Sincronícelo con Partner Central**: se incluye en la aplicación para obtener oportunidades y clientes potenciales estándar. Si AWS Partner opta por mapear objetos personalizados, se debe crear y mapear un campo booleano personalizado en las asignaciones de oportunidades y clientes potenciales, respectivamente.
+ **Fecha de última sincronización con APN**: indica la última vez que el registro se envió o recibió correctamente de APN. Este campo se configura automáticamente cuando el registro se envía correctamente a APN o cuando APN recibe una actualización.
+ **Apto para sincronizarse con APN**: campo de fórmula que determina si el registro está destinado a enviarse a APN en el siguiente trabajo programado. Se calcula en función de si el registro se modificó desde la última vez que se publicó la programación de salida y si lo actualizó un usuario distinto del usuario de integración designado para la organización de la AWS Partner organización.
# Lista de control de producción
Siga estos pasos para completar la instalación de producción de su conector AWS Partner CRM.
1. Confirme que ha completado el [proceso de incorporación de](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) la integración de CRM. En la [etapa 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) de este proceso, configura su entorno de producción y realiza la migración de datos para poder gestionar las oportunidades y los clientes potenciales a través de la integración.
1. Instale y configure el conector CRM. Para obtener más información, consulta [Instalación del conector](install-connector.md).
1. Mapee las oportunidades y los objetos principales mediante la elección de una de las siguientes opciones de mapeo. Como referencia, consulte esta lista de [campos obligatorios](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) en GitHub.
+ Utilice el objeto personalizado AWS ACE Opportunity que viene con el conector AWS Partner CRM para registrar las oportunidades y compartirlas con él AWS. Con esta opción, puede asignar automáticamente AWS los campos a los campos de Salesforce.
+ Utilice el objeto estándar de Salesforce y asigne los campos necesarios. AWS
+ Utilice un objeto de oportunidad personalizado de ACE. Primero debe crear un flujo de trabajo para rellenar una tabla intermedia de objetos de oportunidad de ACE y, a continuación, asignar los campos de Salesforce. AWS
1. Para obtener información y orientación adicionales sobre las opciones de mapeo, consulte. [Mapeo de objetos ACE](crm-connector-mapping.md)
1. (Opcional) Configure los horarios de sincronización de entrada y salida entre la AWS Partner red y Salesforce. Consulte [Creación de programas de sincronización](crm-connector-scheduling.md) para obtener más información.
1. Para validar una oportunidad de producción originada por un socio, plantee un [caso de soporte](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) con Partner Central Operations (PCO) en su cuenta de Partner Central. En este proceso, crea una oportunidad ficticia, la sincroniza con AWS el agente de soporte y pide al agente de AWS soporte que confirme que AWS ha recibido la oportunidad. Al final de la prueba, pídele a tu agente de AWS soporte que rechace la solicitud de oportunidad para que puedas eliminarla por tu cuenta.
1. (Opcional) Rellene los datos. Este proceso garantiza que las referencias de oportunidades AWS originadas y originadas por el socio puedan identificarse en futuras actualizaciones. Para obtener más información, consulte la [etapa 6: aprobación de la producción](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) en el proceso de incorporación del CRM.
1. Active la integración de producción para permitir el intercambio de archivos a través del bucket de Amazon S3. Para obtener más información, consulte la [Etapa 7: Lanzamiento](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html).
# Actualización del conector AWS Partner CRM al nuevo modelo de datos
**importante**
Pruebe y apruebe la nueva actualización del modelo de datos en su organización sandbox de Salesforce antes de actualizar su entorno de producción. Para ver el nuevo modelo de datos y los cambios entre el modelo antiguo y el nuevo, consulte los siguientes [partner-crm-integration-samplesaws-samples/](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) on: GitHub
**Oportunidad- - -V14.3.xlsx FieldsAndStandardValues DiffWithPrevVersion**
**Opportunity-Fields.xlsx**
**Oportunidad\$1-\$1.xlsx StandardValues**
## Requisitos previos
+ Utilice las definiciones de campo para las nuevas directrices del modelo de datos de la integración de ACE CRM y migre las oportunidades y clientes potenciales que necesite al nuevo modelo de datos.
+ Añada o elimine columnas en sus objetos personalizados o estándar (objetos utilizados en la representación cartográfica).
+ Asegúrese de utilizar la versión 2.0 o posterior del conector AWS Partner CRM.
**Para actualizar al nuevo modelo de datos**
1. Inicie sesión en su organización de Salesforce como administrador del sistema.
1. Desactive todos los horarios activos.
1. Seleccione **Configuración, Configuración** **personalizada, Configuración** **del conector AWS Partner CRM** y, a continuación, actualice la versión a **2.0** o posterior.
**nota**
A partir de la versión 2.0, el campo **Versión** es obligatorio. Este campo especifica la versión de carga útil que utilizan los socios para interactuar con la integración de CRM. Cuando los socios pasen a la versión 2.0, deberán adoptar plenamente sus especificaciones. No se permite volver a versiones anteriores.
1. Seleccione la pestaña **ACE Mapping**.
1. Cree, revise y actualice todos los mapeos y detalles de campos necesarios. Para las pruebas de entorno aislado, utilice la oportunidad ACE personalizada y el objeto principal de ACE para probar las nuevas características del modelo de datos. Para obtener más información, consulta [Pruebas en entorno aislado con los objetos ACE Opportunity y ACE lead personalizados](custom-ace-opportunity.md).
1. Active los cronogramas de oportunidades y clientes potenciales.
1. Revise los registros de sincronización de ACE para ver si hay errores de sincronización y realice las correcciones necesarias.
1. Revise las oportunidades y clientes potenciales sincronizados para asegurarse de que la transformación de los datos sea precisa. Como alternativa, revise las oportunidades y los clientes potenciales de ACE para asegurarse de que los cambios en el nuevo modelo de datos se capturen con precisión.
1. Siga el proceso de implementación de sus productos para migrar los cambios a su entorno de producción de Salesforce.
**nota**
Si necesita ayuda, consulte. [Obtener ayuda](getting-help.md)
# Pruebas en entorno aislado con los objetos ACE Opportunity y ACE lead personalizados
**nota**
Si ya es usuario de CRM Connector, consulte. [Actualización del conector AWS Partner CRM al nuevo modelo de datos](connector-upgrade-plan.md)
1. Inicie sesión en su organización de Salesforce como administrador del sistema.
1. Seleccione **Configuración, Configuración** **personalizada, Configuración** **del conector AWS Partner CRM** y actualice la versión a **2**.
1. Seleccione la pestaña **ACE Mapping**.
1. En **Opportunity**, asígnelo al objeto personalizado **ACE opportunity**.
1. Elija el **objeto ACE de mapeo automático**.
**nota**
Si desea actualizar a la nueva versión del conector CRM y utilizar la oportunidad ACE personalizada y los objetos principales de ACE del conector para realizar pruebas en un entorno aislado, le recomendamos que elimine manualmente todos los registros `Field Mappings` y `Field Mapping Details` objetos disponibles de la base de datos antes de utilizar la función de mapeo automático de objetos ACE. Solo tiene que hacerlo una vez.
1. Revise las asignaciones de campos y los valores de las asignaciones de campos para la lista de selección y la lista de selección múltiple.
1. Active los cronogramas de oportunidades y clientes potenciales.
1. Revise los registros de sincronización de ACE para ver si hay errores de sincronización y realice las correcciones necesarias.
1. Revise las oportunidades y clientes potenciales sincronizados para asegurarse de que la transformación de los datos sea precisa. Como alternativa, revise las oportunidades y los clientes potenciales de ACE para asegurarse de que los cambios en el nuevo modelo de datos se hayan capturado con precisión.
## Ver los registros detallados del registro de sincronización para ver las oportunidades de ACE
Puede ver los detalles del registro de sincronización de las oportunidades AWS de ACE ofrecidas en la pestaña **Relacionado** del registro de oportunidades de ACE.
**nota**
Estos pasos solo se aplican a los objetos AWS de oportunidad de ACE entregados. Si mapea objetos estándar o personalizados de su organización de Salesforce, puede ver los detalles del registro de sincronización en la pestaña **Registro de sincronización de ACE**.
1. Inicie sesión en su organización de Salesforce.
1. En el **iniciador de aplicaciones**, selecciona el conector **AWS Partner CRM**.
1. Seleccione la pestaña **ACE Opportunities**.
1. Elija un registro de oportunidades de ACE.
1. Seleccione la pestaña **Relacionado** para ver los detalles, incluidos el **nombre del registro de sincronización**, **el estado**, **el mensaje de error** y la **fecha de creación**.
## Vincular ofertas AWS Marketplace privadas con oportunidades de ACE
Puede vincular las ofertas privadas directamente desde la página de registro de oportunidades de ACE AWS proporcionada.
1. Inicie sesión en su organización de Salesforce.
1. **En el **iniciador de aplicaciones**, selecciona el conector CRM.AWS Partner **
1. Seleccione la pestaña **ACE Opportunities**.
1. Elija un registro de oportunidades de ACE.
1. Elija **Link Private Offer**.
1. En **Offer ID Look Up**, selecciona la oferta privada.
1. Seleccione **Save**.
# Recursos de integración
AWS proporciona los siguientes recursos para ayudarle a crear una integración personalizada.
**Topics**
+ [Definiciones de campo](#custom-field-definitions)
+ [Valores estándar](#standard-values)
+ [Ejemplos de archivos entrantes](#sample-inbound-files)
+ [Ejemplos de archivos salientes](#sample-outbound-files)
+ [Muestra de resultados procesados](#sample-processed-results)
+ [Ejemplos de casos de prueba](#sample-test-cases)
+ [Fragmentos de código de muestra](#sample-code-snippets)
## Definiciones de campo
En los enlaces de las siguientes secciones se enumeran todos los campos y se explican sus tipos de datos, su uso y cualquier restricción o regla de formato que se aplique. Sirven de referencia para garantizar que los socios e AWS intercambien datos, estos tengan el formato y la comprensión correctos.
Los siguientes enlaces lo llevan a GitHub.
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Valores estándar
Estas listas describen los valores estándar y las enumeraciones de varios campos. Ayudan a mantener la coherencia de los datos intercambiados y garantizan que ambas partes comprendan en común los valores utilizados.
Los siguientes enlaces lo llevan a GitHub.
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## Ejemplos de archivos entrantes
Los siguientes archivos de ejemplo muestran la estructura de la carga útil JSON de un archivo enviado por un socio a. AWS
Los siguientes enlaces lo llevan a GitHub.
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## Ejemplos de archivos salientes
Los siguientes archivos de ejemplo muestran la estructura de la carga útil JSON de un archivo enviado desde un AWS socio.
Los siguientes enlaces lo llevan a GitHub.
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## Muestra de resultados procesados
Los siguientes archivos muestran un resultado típico después de AWS procesar una carga útil enviada por un socio.
Los siguientes enlaces lo llevan a GitHub.
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## Ejemplos de casos de prueba
Los siguientes enlaces lo llevan a GitHub.
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## Fragmentos de código de muestra
Los siguientes enlaces lo llevan a. GitHub
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [Apex\$1sample\$1rest\$1 ode.cls API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Sample\$1.cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC apex s3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [Apex\$1get\$1files\$1from\$1S3\$1ACE\$1PARTNER\$1TEST.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# Intercambio de clientes potenciales
## ¿Cómo AWS comparte los clientes potenciales
1. **Exportaciones incrementales**: Amazon Web Services (AWS) exporta los nuevos clientes potenciales (y actualizaciones) referidos por AWS cada hora.
1. **Creación de archivos**: AWS genera archivos de clientes potenciales con un formato específico. Para obtener especificaciones detalladas de los archivos, consulte. [Definiciones de campo](resources.md#custom-field-definitions)
1. **Carga de archivos**: los archivos principales se cargan en la `lead-outbound` carpeta.
## Consumir clientes potenciales de AWS
Para consumir clientes potenciales de manera efectiva AWS, cree una integración personalizada con las siguientes funcionalidades.
1. **Recuperación de archivos**:
+ Escanee la `lead-outbound` carpeta con regularidad mediante un trabajo programado en el intervalo que elija.
+ Recupera los archivos principales para procesarlos.
1. **Transformación y mapeo de datos**:
+ Después de leer el contenido de cada archivo, transforme y asigne los datos a los registros de clientes potenciales de su sistema de gestión de relaciones con los clientes (CRM).
+ Para obtener orientación sobre el mapeo de campos, consulte[Asignación de campo](custom-field-mapping.md).
1. **Identificación de clientes potenciales**:
+ Identifique de forma única cada cliente potencial utilizando una de las `partnerCrmLeadId` siguientes `apnCrmUniqueIdentifier` opciones:
+ Si `partnerCrmLeadId` está en blanco y `apnCrmUniqueIdentifier` está presente, el cliente potencial es una nueva referencia de Customer Engagement AWS Partner Network (ACE) (APN).
+ Si ambos identificadores están presentes, el registro se considera una actualización de ACE.
1. **Ingestión de plomo**:
+ Ingiera nuevos clientes potenciales o actualice los existentes en el sistema CRM.
1. **Gestión de archivos**:
+ Tras procesar correctamente cada cliente potencial y los datos completos del archivo, elimine los archivos de la carpeta de salida.
+ Cada archivo se archiva automáticamente en la `lead-outbound-archive` carpeta.
**Integración y referencia de código:**
+ Para leer los archivos subidos al bucket de Amazon Simple Storage Service (Amazon S3), puede AWS Lambda utilizarlos o leerlos directamente desde su sistema CRM.
+ Utilice los códigos de ejemplo que aparecen a continuación para las API REST de Lambda y Salesforce para validar y actualizar los registros de CRM.
+ **Lambda para validar archivos**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ **API REST de Salesforce**[: APEX\$1Sample\$1REST\$1 ode.cls. API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ Si utiliza un sistema CRM que no sea Salesforce, debe proporcionar el código específico de su sistema para actualizar sus datos.
## Compartir actualizaciones sobre clientes potenciales con AWS
1. **Identifique los clientes potenciales**: localice los clientes potenciales con las actualizaciones para compartirlos con ellos AWS.
1. **Transformación** de datos: convierta los datos al AWS formato descrito en[Definiciones de campo](resources.md#custom-field-definitions).
1. **Creación de archivos**:
+ Genere archivos de clientes potenciales en formato JSON.
+ Añada una marca de tiempo a cada archivo, asegurándose de que todos los nombres de los archivos sean únicos y sigan el formato:. `{name}_MMDDYYYY24HHMMSS.json`
1. **Autenticar** y cargar:
+ Autenticese en el bucket de Amazon S3 de ACE.
+ Cargue el archivo en la `lead-inbound` carpeta. Todos los archivos con los AWS que se comparte se archivan automáticamente en la `lead-inbound-archive` carpeta.
+ Cuando subas archivos a S3, asegúrate de proporcionar acceso completo al propietario del bucket.
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
Consulta un ejemplo del resultado de la ejecución de este comando en [«Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)».
1. **Procesamiento de archivos**:
+ Al recibirlos, procesa AWS automáticamente los archivos.
+ Los resultados del procesamiento se cargan en la `lead-inbound-processed-results` carpeta del bucket de Amazon S3. Esto incluye el estado de los éxitos y errores, así como cualquier mensaje de error de cada cliente potencial.
+ Estos resultados procesados también se archivan en la `lead-inbound-processed-results-archive` carpeta.
+ Para obtener más información, consulte la[Preguntas frecuentes técnicas: clientes potenciales y oportunidades](technical-faq-leads-and-opps.md).
1. **Manejo de respuestas**:
+ Debe desarrollar una lógica para consumir estas respuestas, revisar los registros erróneos, corregir cualquier error y volver a enviar los datos a ACE.
+ Puede encontrar ejemplos de errores en las secciones de preguntas frecuentes y solución de problemas.
+ Para cargar un archivo a Amazon S3 desde CRM:
+ Haga referencia a la versión de la AWS firma.
+ Usa una solicitud HTTPS para cargar el archivo.
+ Como referencia, utilice los siguientes archivos para cargar un archivo en el bucket de Amazon S3:
+ **Para autenticar un bucket de S3**[: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **Para cargar archivos a un bucket de S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **NOTA:** Los archivos no deben tener un tamaño superior a 1 MB y los archivos duplicados no se procesarán.
# Compartir oportunidades
## ¿Cómo AWS comparte las oportunidades
1. **Exportaciones incrementales**: Amazon Web Services (AWS) exporta nuevas oportunidades (y actualizaciones) referidas por AWS horas.
1. **Creación de archivos**: AWS genera archivos de oportunidades que se adhieren a un formato específico. Para obtener especificaciones detalladas de los archivos, consulte las [definiciones de los campos de oportunidades](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv).
1. **Carga de archivos**: los archivos de Opportunity se cargan en la `opportunity-outbound` carpeta.
## Aprovechando las oportunidades de AWS
Para aprovechar las oportunidades de forma eficaz AWS, es necesario crear una integración personalizada con estas funcionalidades.
1. **Recuperación de archivos**:
+ Utilice un trabajo programado para escanear la `opportunity-outbound` carpeta con regularidad, en el intervalo que elija.
+ Recupere los archivos de oportunidades para procesarlos.
1. **Transformación y mapeo de datos**:
+ Después de leer el contenido de cada archivo, transforme y asigne los datos a los registros de oportunidades de su sistema de gestión de relaciones con los clientes (CRM).
+ Para obtener orientación sobre el mapeo de campos, consulte[Asignación de campo](custom-field-mapping.md).
1. **Identificación de oportunidades**:
+ Identifique de forma única cada oportunidad utilizando una de las `partnerCrmOpportunityId` siguientes `apnCrmUniqueIdentifier` opciones:
+ Si `partnerCrmOpportunityId` está en blanco y `apnCrmUniqueIdentifier` está presente, la oportunidad es una nueva recomendación de Customer Engagement AWS Partner Network (ACE) (APN).
+ Si ambos identificadores están presentes, el registro se considera una actualización de ACE.
1. **Adquisición de** oportunidades: incorpore nuevas oportunidades o actualice las existentes en el sistema CRM.
1. **Gestión de archivos**:
+ Tras procesar correctamente cada oportunidad y todos los datos del archivo, elimine los archivos de la carpeta de salida.
+ Cada archivo se archiva automáticamente en la `opportunity-outbound-archive` carpeta.
**Integración y referencia de código:**
+ Para leer los archivos subidos al bucket de Amazon Simple Storage Service (Amazon S3), puede AWS Lambda utilizarlos o leerlos directamente desde su sistema CRM.
+ Utilice los códigos de ejemplo que aparecen a continuación para las API REST de Lambda y Salesforce para validar y actualizar los registros de CRM.
+ **Lambda para validar archivos**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ **API REST de Salesforce**[: APEX\$1Sample\$1REST\$1 ode.cls. API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ Si utiliza un sistema CRM que no sea Salesforce, debe proporcionar el código específico de su sistema para actualizar sus datos.
## Compartir las actualizaciones de las oportunidades con AWS
1. **Identifique las oportunidades**: localice las oportunidades con las actualizaciones con las que pueda compartirlas AWS.
1. **Transformación** de datos: convierta los datos al AWS formato descrito en[Definiciones de campo](resources.md#custom-field-definitions).
1. **Creación de archivos**:
+ Genere archivos de oportunidades en formato JSON.
+ Añada una marca de tiempo a cada archivo, asegurándose de que todos los nombres de los archivos sean únicos y sigan el formato:. `{name}_MMDDYYYY24HHMMSS.json`
1. **Autenticar** y cargar:
+ Autenticese en el bucket de Amazon S3 de ACE.
+ Cargue el archivo en la `opportunity-inbound` carpeta. Todos los archivos con los AWS que se comparte se archivan automáticamente en la `opportunity-inbound-archive` carpeta.
+ Cuando subas archivos a S3, asegúrate de proporcionar acceso completo al propietario del bucket:
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
Consulta un ejemplo del resultado de la ejecución de este comando en [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json).
1. **Procesamiento de archivos:**
+ Al recibirlos, procesa AWS automáticamente los archivos.
+ Los resultados del procesamiento se cargan en la `lead-inbound-processed-results` carpeta del bucket de Amazon S3. Esto incluye el estado de los éxitos y errores, así como los mensajes de error de cada oportunidad.
+ Estos resultados procesados también se archivan en la `opportunity-inbound-processed-results-archive` carpeta.
+ Para obtener más información, consulte la[Preguntas frecuentes técnicas: clientes potenciales y oportunidades](technical-faq-leads-and-opps.md).
1. **Manejo de respuestas**:
+ Debe desarrollar una lógica para consumir estas respuestas, revisar los registros erróneos, corregir cualquier error y volver a enviar los datos a ACE.
+ Puede encontrar ejemplos de errores en las secciones de preguntas frecuentes y solución de problemas.
+ Para cargar un archivo a Amazon S3 desde CRM:
+ Haga referencia a la versión de la AWS firma.
+ Usa una solicitud HTTPS para cargar el archivo.
+ Como referencia, utilice los siguientes archivos para cargar un archivo en el bucket de Amazon S3:
+ **Para autenticar un bucket de S3**[: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **Para cargar archivos a un bucket de S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **NOTA:** Los archivos no deben superar 1 MB de tamaño y los archivos duplicados no se procesarán.
# Asignación de campo
El mapeo de campos es un paso esencial en el proceso de integración, en el que los socios alinean los campos de su sistema de gestión de relaciones con los clientes (CRM) con los definidos por Amazon Web Services (AWS). Esto garantiza que ambas partes intercambien y entiendan los datos con precisión. A continuación se presentan las pautas para ayudar en este proceso.
## Mapeo de campos obligatorio
+ Asigne cada campo obligatorio a su campo correspondiente en su sistema CRM. Es esencial para un intercambio de datos exitoso asegurarse de que todos los campos obligatorios estén mapeados. Para obtener más información, consulte [Definiciones de campo](resources.md#custom-field-definitions)
+ [Oportunidad](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [¿Plomo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Manejo de campos opcionales
+ Comprenda el papel de los campos opcionales en el proceso de integración. Decida si desea mapear estos campos en función de los requisitos de su empresa y tenga en cuenta las posibles implicaciones de dejarlos sin mapear.
## Asignación de valores
+ Alinee cada valor de campo de su CRM con el valor de lista de fidelización de clientes AWS Partner Network (ACE) requerido (APN), tal y como se especifica en. [Definiciones de campo](resources.md#custom-field-definitions) Esto es importante para mantener la coherencia e integridad de los datos.
## Validación del tipo y formato de los datos
+ Compruebe que los tipos y formatos de datos de los campos de su sistema CRM coincidan con los especificados en las *definiciones de los AWS campos*. Es esencial mantener la coherencia en los tipos y formatos de datos para evitar que los datos se corrompan y garantizar una integración perfecta.
## Longitud y limitaciones del campo
+ Tenga en cuenta las restricciones de longitud de los campos y otras limitaciones. Asegúrese de que los datos de su sistema CRM quepan en los campos correspondientes AWS sin truncarse ni provocar errores.
## Validación del tipo y formato de los datos
+ Compruebe que los tipos y formatos de datos de campo de su sistema CRM coincidan con los especificados en[Definiciones de campo](resources.md#custom-field-definitions). Es fundamental evitar la corrupción de los datos y garantizar una integración perfecta con coherencia en los tipos y formatos de datos.
## Revisión y actualización periódicas
+ Revise y actualice periódicamente sus mapeos de campo para adaptarlos a los cambios o AWS requisitos de su sistema de CRM. Este enfoque proactivo garantiza la precisión y la eficiencia del intercambio continuo de datos.
## Documentación de mapeo de campo
+ Mantenga una documentación completa de mapeo de campo. Esta práctica ayuda a solucionar problemas, a realizar futuras actualizaciones y a garantizar la claridad en la forma en que se transfieren los datos entre los sistemas.
## Pruebas y validación
+ Realice pruebas exhaustivas de mapeo de campo para validar que los datos se transfieran y transformen con precisión. Aborde cualquier discrepancia o problema de inmediato para garantizar la integridad de los datos.
## Gestionar las sobrescrituras no deseadas
+ Para evitar que AWS los datos sobrescriban campos específicos de CRM, tenga en cuenta lo siguiente:
+ Crear un campo de CRM personalizado para los datos que desee proteger.
+ Hacer que un representante de ventas revise este campo personalizado.
+ Una vez aprobado el campo personalizado, agréguelo al registro de oportunidades y a la canalización.
+ Esto es particularmente importante para campos como `MRR` o`Stage`, especialmente si significan que un producto se ha lanzado.
## Gestionar las dependencias descendentes
+ Si hay dependencias descendentes en el sistema que se basan en el intercambio de datos, tenga en cuenta lo siguiente:
+ Crear nuevos campos en su CRM para acomodar los AWS datos.
+ Realinee sus procesos empresariales según sea necesario para garantizar una integración y un flujo de datos perfectos.
# Creación de programas de sincronización
**nota**
En los temas de esta sección se supone que ha completado los requisitos previos para una integración de AWS Partner Central, una integración de AWS Marketplace o ambas. Para obtener más información, consulte [Requisitos previos para la integración](crm-integration-setting-up.md) y más [Introducción](crm-integration-getting-started.md) arriba en esta guía.
Puede crear programas de sincronización de entrada y salida entre Salesforce y AWS Partner Central. En los pasos de las siguientes secciones se explica cómo hacerlo.
**Topics**
+ [Requisitos previos](#scheduling-prerequisites)
+ [Creación de una programación](#creating-a-schedule)
+ [Desactivar un trabajo programado](#deactivating-a-scheduled-job)
+ [Visualización de todos los horarios](#viewing-all-schedules)
## Requisitos previos
Asegúrese de completar lo siguiente antes de crear un programa de sincronización:
+ [Asigne](crm-connector-mapping.md) todos los campos obligatorios a al menos un objeto, oportunidad o cliente potencial.
+ Cree un [usuario de integración de sistemas](#system-integration-user) en Salesforce.
### Crear un usuario de integración de sistemas
Antes de poder crear un programa de sincronización, debe usar Salesforce para crear un usuario de integración de sistemas con permisos de integración de APN. Para crear programas de sincronización, debe iniciar sesión en Salesforce como usuario de integración del sistema. La creación de un cronograma sin los permisos de usuario de la integración de APN puede interrumpir la integración de APN.
**Para crear un usuario de integración de sistemas**
1. Inicie sesión en su organización de Salesforce como administrador del sistema.
1. Cree un usuario en su organización de Salesforce. Asigne un perfil al usuario con acceso a los objetos necesarios en su organización de Salesforce. Para obtener más información, consulte [Añadir un solo usuario](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm).
1. Asigne al usuario el conjunto de permisos de **usuario de integración de APN**. Para obtener más información, consulte [Asignar un conjunto de permisos a los usuarios](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm).
## Creación de una programación
Tras cumplir los [requisitos previos](#scheduling-prerequisites), puede crear programas de sincronización entre Salesforce y APN.
**Para crear un programa de sincronización con APN**
1. Inicie sesión en Salesforce como usuario con permisos de usuario de integración de sistemas.
1. En la pestaña **Programaciones**, seleccione **Nuevo**.
1. Elija los objetos que desee programar. Puede configurar cronogramas para clientes potenciales y oportunidades, o para un solo objeto.
1. Elija la frecuencia de programación, desde un mínimo de cinco minutos hasta un máximo de una vez al día.
1. Elija **Schedule**.
**nota**
Solo puede estar activa una programación por objeto a la vez. Al crear una nueva programación para el mismo objeto, se desactiva la programación existente.
Para deshabilitar la integración entrante al crear una programación, seleccione **Desactivar la integración entrante**, programar.
La creación de un cronograma sin los permisos de usuario de la integración de APN puede interrumpir la integración de APN.
## Desactivar un trabajo programado
1. En la página **de programación**, seleccione **Desactivar todos los trabajos** para desactivar cualquier programa activo.
1. Continúe con la pantalla de confirmación para desactivar el programa de sincronización.
## Visualización de todos los horarios
En la pestaña **Programaciones**, utilice los filtros de la vista de lista para cambiar entre las programaciones de **sincronización **activa****, inactiva** y total**.
# Prácticas recomendadas
Utilice estas prácticas recomendadas para optimizar el desarrollo y el mantenimiento de su integración personalizada.
## Prácticas recomendadas generales
1. Asigne todos los campos *obligatorios* porque son los campos obligatorios del formulario de envío de Customer Engagement (ACE) (APN). AWS Partner Network
1. Conéctese con su usuario actual de ACE Pipeline Manager para comprender cómo es el proceso. Capture cualquier processes/field uso exclusivo para que pueda incorporarlo a su experiencia.
1. Considere la posibilidad de crear etapas de flujo de ventas independientes para las etapas de ventas reportadas por Amazon Web Services (AWS) (por ejemplo: etapa, fecha de cierre prevista, AWS ingresos mensuales esperados, próximos pasos). Si tenemos diferentes definiciones de etapas, podríamos anular las etapas de venta. Cuando creas etapas de ventas independientes, te permite gestionar tu cartera de ventas de forma adecuada y, al mismo tiempo, tener visibilidad de lo que AWS se proyecta.
1. En el caso de las oportunidades recomendadas por nuestros socios, el equipo de ACE approve/reject las necesita antes de aceptar cualquier actualización.
1. En el AWS caso de las oportunidades recomendadas, el socio debe aceptarlas o rechazarlas.
## Protocolos de intercambio de datos
1. **Convenciones de entrada**: separe las entradas de la lista de selección múltiple con punto y coma y omita los espacios.
1. **Atención a los detalles**: los nombres y valores de los campos distinguen entre mayúsculas y minúsculas, así que mantenga la precisión.
1. **Procedimientos de eliminación**: ejecute la eliminación de campos transmitiendo el valor `null` del campo elegido.
1. **Sincronización**: los procesos de sincronización funcionan cada hora, lo que provoca posibles retrasos en los data reflections. Las actualizaciones AWS pueden tardar hasta una hora en reflejarse en la gestión de las relaciones con los AWS clientes (CRM). Evite enviar varios documentos por hora.
## Mejores prácticas específicas para cada campo
1. **Modificaciones entrantes**: para proteger la integridad de sus datos, desactive las modificaciones de campos como`stage`, y`closedDate`. `closedLostReason` Para realizar un seguimiento de AWS los valores sin que ello afecte a los valores locales de Salesforce, utilice estos campos de solo lectura:`awsStage`, y. `awsCloseDate` `awsClosedLostReason`
1. **Mapeo y validación de clientes**: garantice la precisión del sitio web del cliente, ya que es fundamental para el mapeo de CRM. AWS Combínelo con el nombre del cliente para obtener un mejor mapeo de las cuentas de CRM.
1. **Claridad en la descripción del proyecto**: proporcione una descripción clara que detalle los desafíos de los clientes y las alineaciones de soluciones. AWS usa esto para validar la oportunidad.
1. **Aprovisionamiento**: (opcional) Al proporcionar información específica de contacto con el cliente final, se puede rastrear clientes AWS potenciales y campañas. Esto se traduce en una mejora de los veredictos sobre financiación.
## Prácticas recomendadas adicionales
1. Siga las directrices más recientes de definición de campos de carga útil.
1. Mantenga la coherencia en la nomenclatura de los cubos de arena con el formato especificado.
1. Usa el patrón de nomenclatura recomendado para el segmento de producción.
1. Priorice las pruebas en entornos sandbox antes de la implementación en vivo.
1. Mantenga identificadores distintos para los registros entre AWS un socio. CRMs
1. Tras el procesamiento, elimine los archivos de la carpeta saliente de Amazon Simple Storage Service (Amazon S3). Los originales permanecen en los archivos.
1. Para evitar errores, configure las validaciones a nivel de campo en la fuente.
# Cuotas
## Archivo entrante a Amazon Web Services ()AWS
| Operación | Límite |
| --- | --- |
| Máximas oportunidades | 500 por archivo |
| Tamaño máximo de archivo | 1 MB |
| Frecuencia de sincronización | Casi en tiempo real |
| Número máximo de archivos enviados | 10 000 por período de 24 horas |
## Archivo saliente al socio
| Operación | Límite |
| --- | --- |
| Tamaño máximo de archivo | 5 MB |
| Frecuencia de sincronización | Por hora |
# Historial de versiones
Versión actual de los campos: 14 (15 de noviembre de 2023)
La siguiente tabla describe los cambios importantes en los campos de integración personalizados para clientes potenciales y oportunidades después de 2020. Para recibir notificaciones de futuras actualizaciones, suscríbase a la fuente RSS.
| Cambio | Versión | Date |
| --- | --- | --- |
| Actualizar las cuotas de Amazon S3 | 14 | 17/01/2024 |
| **Cambios en los campos de oportunidades de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) | 14 | 15/11/2023 |
| **Cambios en los campos de oportunidades de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) | 13 | 29/03/2023 |
| **Cambios en los campos de oportunidades de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) **Cambios en los valores estándar en relación con la oportunidad:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **Cambios en los campos de oportunidades de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) **Cambios en los valores estándar de los campos de oportunidad:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) | 11 | 21/03/2022 |
| **Cambios en los campos de oportunidades de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) **Cambios en los valores estándar en función de la oportunidad:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) | 10 | 26/01/2022 |
| **Cambios en los valores estándar en los campos principales:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) **Cambios en los campos principales de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) **Cambios en los campos de oportunidades de integración:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/partner-central/latest/crm/version-history.html) | 9 | 16/09/2021 |
| Actualizar los códigos de motivo de pérdida cerrada | 8 | 24/06/2021 |
# FAQs
Utilice estas preguntas y respuestas comunes para facilitar la integración personalizada.
**Topics**
+ [Preguntas frecuentes generales](general-faq.md)
+ [Preguntas frecuentes técnicas: campos](technical-faq-fields.md)
+ [Preguntas frecuentes técnicas: Amazon S3](technical-faq-s3.md)
+ [Preguntas frecuentes técnicas: clientes potenciales y oportunidades](technical-faq-leads-and-opps.md)
+ [Preguntas técnicas frecuentes: control de versiones y compatibilidad con versiones anteriores](technical-faq-versioning.md)
# Preguntas frecuentes generales
## ¿Cómo funciona la integración?
**P: ¿Puedo acceder al depósito de Amazon Simple Storage Service (Amazon S3) que se utiliza para enviar y recibir los archivos?**
Sí. Los socios pueden acceder mediante programación al depósito de Amazon S3 mediante la secret/access clave del depósito AWS Identity and Access Management (IAM) que tiene acceso al depósito. Los socios no tendrán acceso de consola a los buckets de Amazon S3 porque estos buckets están en la propia cuenta de Amazon Web Services (AWS).
**P: ¿Qué conjunto de habilidades necesita el desarrollador del socio?**
El desarrollador del socio debe estar familiarizado con su sistema de gestión de relaciones con los clientes (CRM) y con Amazon S3.
**P: ¿Los archivos de código de muestra incluyen el código completo o el socio tiene que escribir el código?**
El socio debe escribir el código en función de los archivos de código de muestra proporcionados.
**P: Si el socio desarrolla su solución en Python, Golang o cualquier otro lenguaje, ¿proporciona AWS Partner Network (APN) Customer Engagement (ACE) algún kit de desarrollo de software (SDK) en esos lenguajes para esta integración?**
No.
**P: ¿Cuál es el proceso de sincronización del bucket de Amazon S3 al ACE interno?**
Cada hora, se ejecuta un proceso por lotes para recoger los archivos y sincronizar la información. Cualquier actualización que el equipo de AWS ventas introduzca en el registro puede tardar hasta una hora en enviarse a la carpeta de distribución del socio. Es posible que los socios reciban inmediatamente una notificación por correo electrónico sobre las actualizaciones, pero es AWS posible que las actualizaciones se retrasen una hora.
**P: ¿Con qué frecuencia ACE carga los archivos de clientes potenciales y oportunidades?**
ACE envía los datos de clientes potenciales y oportunidades cada hora.
**P: ¿Existe un entorno sandbox para ACE?**
Sí. Tenemos un entorno aislado para ACE, pero no podemos ofrecer acceso a los socios por motivos de seguridad. Plantee un caso de soporte en Partner Central si quiere tener nuevas oportunidades o clientes potenciales a su disposición.
**P: ¿Cómo mantenemos los identificadores en el CRM y APN del socio?**
Para ofrecer más flexibilidad a nuestros socios, utilizamos dos conjuntos de identificadores en nuestro sistema.
1. `apnCrmUniqueIdentifier`: AWS gestiona este identificador. Comienza con las `OXXXXXX` oportunidades y `LXXXXXX` los clientes potenciales.
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: El socio gestiona este identificador de oportunidades y clientes potenciales, respectivamente, dentro de su CRM. Los socios deberían añadir este identificador a la vez que aprovechan nuevas oportunidades para rastrear las actualizaciones hasta su CRM.
Cuando una oportunidad se envía sin ella `apnCrmUniqueIdentifier` o`partnerCrmUniqueIdentifier`, la AWS trata como una nueva oportunidad y asigna una nueva a esa `apnCrmUniqueIdentifier` oportunidad.
Cuando se envía una oportunidad con una `apnCrmUniqueIdentifier` o`partnerCrmUniqueIdentifier`, la AWS trata como una acción de actualización y actualiza la oportunidad existente con los datos de la carga útil.
**P: ¿Cómo puedo evitar que se creen registros duplicados en ambos sistemas?**
Desde el punto de vista del CRM asociado, debe haber un identificador único para cada registro que se envíe a ACE, que se denomina`partnerCrmUniqueIdentifier`. Del mismo modo, ACE también mantiene un identificador único para cada registro, que se denomina`apnCrmUniqueIdentifier`. Cuando se envían los datos, tanto ACE como el socio deben incluir estos dos campos, lo que ayuda a identificar si el registro es una nueva oportunidad (si está en blanco) o una oportunidad existente (si está rellenado).
# Preguntas frecuentes técnicas: campos
**P: ¿La integración admite el formato CSV?**
No. La integración solo acepta formatos de archivo JSON.
**P: ¿Cuándo se deben eliminar los archivos de las carpetas de salida?**
Elimine los archivos solo después de procesarlos correctamente.
**P: Si elimino accidentalmente los archivos de las carpetas salientes, ¿dónde puedo encontrar los archivos originales?**
Los archivos están disponibles en las `lead-outbound-archive` carpetas `opportunity-outbound-archive` y.
**P: ¿Qué debo hacer para obtener asistencia durante el desarrollo?**
Si necesitas ayuda durante el desarrollo, ponte en contacto con el servicio de asistencia de AWS Partner Network (APN) en Partner Central.
**P: ¿Cuál es la diferencia entre `opportunityOwnerName` y? `opportunityOwnerEmail`**
+ `opportunityOwnerName`: El nombre del propietario de la oportunidad en la organización asociada. Debe ser un usuario de Partner Central.
+ `opportunityOwnerEmail`: el correo electrónico del propietario de la oportunidad en la organización asociada. Debe ser un usuario de Partner Central. Si no se proporciona, la oportunidad se crea con el líder de la Alianza de Partner Central como propietario.
**P: ¿Cuál es la zona horaria de todos los campos de fecha (`targetCloseDate``lastModifiedDate`,`createdDate`, y`acceptBy`)?**
La zona horaria de los campos de fecha es la hora media de Greenwich (GMT).
**P: ¿Los archivos JSON entrantes están versionados?**
No. Amazon Web Services (AWS) no admite el control de versiones de los archivos. APN Customer Engagement (ACE) procesa el archivo inmediatamente después de recibirlo y, después, lo elimina una vez procesado correctamente. Si volvemos a recibir el mismo nombre de archivo, se rechaza.
**P: ¿Qué campos del archivo JSON de Amazon Simple Storage Service (Amazon S3) indican la fecha de creación y última actualización de un cliente potencial y una oportunidad concretos?**
`createdDate` y `lastModifiedDate`.
**P: ¿Cómo se determina si una oportunidad es nueva o existente?**
El campo `PartnerCrmUniqueIdentifier` es un identificador único para cada oportunidad que solicitamos al socio. Este identificador debe estar definido en el CRM de origen del sistema del socio. Lo utilizamos para determinar si existe una oportunidad en AWS. Si existe, actualizamos la oportunidad con la información compartida. Si no, creamos una nueva oportunidad.
Cuando enviamos datos al socio, incluimos `PartnerCrmUniqueIdentifier` tanto como`apnCrmUniqueIdentifier`. Si la oportunidad compartida por AWS se envía por primera vez, no verás ningún valor para ella`PartnerCrmUniqueIdentifier`. Esto le ayuda a considerar la oportunidad de ACE como si fuera nueva. Una vez que la incorpore a su CRM, nos envía las actualizaciones con `PartnerCrmUniqueIdentifier` y`apnCrmUniqueIdentifier`.
**P: ¿Es posible tener más de un archivo JSON de salida y de resultado en Amazon S3?**
Sí. A veces podemos generar más archivos en la carpeta de salida. Del mismo modo, si envías archivos a la carpeta de entrada, los procesamos y guardamos los archivos de resultados en la carpeta de resultados. Debe etiquetar o eliminar los archivos de resultados después del procesamiento.
**P: ¿El archivo saliente contiene más de un registro?**
Sí. El archivo saliente puede contener varios registros.
**P: Si se envían 20 oportunidades entrantes en un archivo JSON de una sola entrada en la sección de oportunidades y una de las oportunidades no cumple con el estándar de APN, ¿qué ocurre?**
Si el formato es incorrecto, sea cual sea el caso, se rechaza todo el archivo. Si el formato es correcto pero no podemos procesar solo una oportunidad por nuestra parte, el archivo de resultados incluye las 20 oportunidades y su estado, junto con el mensaje de error de la oportunidad fallida.
**P: ¿Cuáles son los atributos clave para validar si el archivo JSON se procesó correctamente?**
Estos son los atributos clave que le ayudarán a comprender si el archivo JSON se procesó correctamente.
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**P: ¿Qué ocurre si envío un JSON no válido?**
Recibes la siguiente respuesta de error: «no `[{input JSON}]` es del tipo`object`».
**P: ¿Cuántos lead/opportunity registros se pueden incluir en un único archivo JSON entrante?**
Puede haber un máximo de 50 registros en un archivo.
# Preguntas frecuentes técnicas: Amazon S3
**P: ¿Dónde puedo obtener la documentación de la API REST de Amazon Simple Storage Service (Amazon S3)?**
Para obtener más información, consulte la [Introducción a la API REST de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).
**P: ¿Cómo puedo obtener los detalles clave de Amazon Web Services AWS Key Management Service (AWS KMS) para autenticarme y acceder al bucket de Amazon S3?**
AWS Partner Network (APN) comparte una política que incluye el nombre de la clave.
**P: ¿Cómo puedo autenticar Amazon S3 desde Salesforce.com (SFDC)?**
Utilice el archivo de código de ejemplo [S3\$1Authentication.cls para autenticar](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) Amazon S3 desde SFDC.
**P: ¿Cómo puedo subir el archivo del kit de desarrollo de software (SDK) a S3? AWS **
Utilice el siguiente comando AWS CLI para cargar el archivo en S3.
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
El archivo de código de ejemplo [Sample\$1 AceOutboundBatch .cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) contiene código para cargar el archivo de datos desde SFDC.
**P: ¿Quién es el propietario del bucket de Amazon S3?**
AWS posee y administra el bucket de Amazon S3. Tiene acceso mediante programación a su propio bucket de Amazon S3 con el usuario AWS Identity and Access Management (IAM).
**P: ¿Hay carpetas o cubos separados para recibir y enviar archivos?**
Hay un depósito con diferentes carpetas para recibir y enviar los archivos. Consulte la guía del usuario para obtener más información sobre las carpetas.
**P: ¿Necesito acceder al bucket de Amazon S3 mediante AWS Lambda el sistema de gestión de relaciones con los clientes (CRM) o puedo acceder a él directamente?**
Puede acceder a él de ambas maneras.
**P: ¿El bucket de Amazon S3 está protegido o cifrado?**
Sí. Habilitamos el mecanismo de cifrado predeterminado que ofrece Amazon S3.
**P: ¿Es posible activar Amazon Simple Notification Service (Amazon SNS) para escuchar el bucket de Amazon S3 para que solo pueda actuar en función del evento, en lugar de realizar sondeos periódicos?**
No. Actualmente, APN Customer Engagement (ACE) no admite esta función.
**P: ¿A qué carpetas tengo acceso y cuál es el propósito de cada carpeta?**
Puede encontrar la lista de carpetas de Amazon S3 en[Requisitos previos para la integración](crm-integration-setting-up.md).
# Preguntas frecuentes técnicas: clientes potenciales y oportunidades
## Envíe y reciba clientes potenciales y oportunidades
**P: ¿Existe una convención de nomenclatura de archivos?**
El nombre de cada archivo debe ser único. Se recomienda el nombre del archivo`PartnerProvided FileName+{timestamp}.json`.
**P: ¿Cuál es la estructura de los resultados?**
Los archivos de muestra de los resultados (aciertos y errores) se pueden descargar de las siguientes ubicaciones:
+ [Ejemplo de éxito de Lead Results.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [Ejemplo de éxito y resultados de oportunidad.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Resultados principales con errores Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [Resultados de oportunidad con errores Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**P: ¿Cuál es la convención de nomenclatura de los resultados?**
`PartnerProvidedFileName_result.json`
**P: ¿Qué sucede si envío un segundo archivo JSON con el mismo nombre?**
No procesaremos el archivo y el archivo se moverá a la carpeta de almacenamiento.
**P: ¿Cuál es el límite de tamaño de los archivos entrantes?**
El límite de tamaño de los archivos entrantes es de 1 MB.
**P: ¿Existe un número máximo de oportunidades y clientes potenciales que se pueden agrupar en un archivo JSON?**
Dado el límite de 1 MB, te recomendamos que tengas una oportunidad o un lead por archivo.
**P: Recibo un mensaje de error de acceso denegado, por lo que no puedo subir los archivos. ¿Qué tengo que hacer?**
Los socios reciben un mensaje de *acceso denegado* por dos motivos.
1. Has subido el archivo a la `outbound` carpeta en lugar de a la `inbound` carpeta. Sube el archivo a la `inbound` carpeta.
1. Debe proporcionar una lista de control de acceso (ACL). Utilice el siguiente comando CLI de Amazon Web Services (AWS) para cargar el archivo de datos:
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**P: ¿Qué ocurre si se cargan archivos con extensiones como `.pdf``.docx`, o cualquier otra extensión que no `.json` sea?**
Rechazamos los archivos y generamos un `*.error.json` archivo con los detalles del motivo.
**P: ¿Qué hago después de recibir un mensaje de error sobre un problema con los datos durante el proceso de producción?**
1. Si es necesario corregir los datos en el sistema de gestión de relaciones con los clientes (CRM) del socio, después de corregir los datos, envíe el archivo modificado a Amazon Simple Storage Service (Amazon S3).
1. Si necesita alguna aclaración sobre los datos, póngase en contacto con su director de desarrollo de socios (PDM).
1. Para cualquier otro tipo de soporte técnico, plantee un caso de soporte AWS Partner Network (APN) en el portal de APN.
**P: ¿Dónde puedo encontrar los archivos de resultados y durante cuánto tiempo están disponibles?**
Los archivos de resultados se encuentran en las `opportunity-inbound-results` carpetas `lead-inbound-results` y. Están disponibles hasta que los elimines. Puede eliminar los archivos después de extraerlos correctamente.
**P: Si necesito encontrar un archivo de resultados después de eliminarlo, ¿dónde lo podemos encontrar?**
Puedes encontrar los archivos de resultados en las `opportunity-inbound-results-archive/YYYY/MM/DD` carpetas `lead-inbound-results-archive/YYYY/MM/DD` y.
**P: Si se produce algún error en el procesamiento del archivo por parte de APN, ¿cómo se me notifica?**
APN tiene alarmas que crean automáticamente tickets Sev2 para rastrear los errores de procesamiento. Los revisamos, resolvemos y comunicamos a los socios.
**P: ¿Qué campos se pueden actualizar una vez que se lance la oportunidad?**
Los siguientes campos solo los puede actualizar Accelerate Partners, un proveedor de software independiente (ISV):
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**P: He recibido un error de *registro no editable.* ¿Qué significa?**
Cuando envías una nueva oportunidad recomendada por un socio, esta pasa por el proceso de validación y el equipo de Customer Engagement (ACE) de APN debe aprobarla o rechazarla. Mientras la oportunidad esté en revisión y aún no se haya validado, no podrá actualizar el registro y recibirá este error.
**P: ¿Qué ocurre si no hay ninguna actividad por mi parte (por ejemplo, si no estoy procesando el archivo o no estoy enviando ninguna oportunidad entrante)?**
Si no envías información o no estás procesando los archivos que proporcionamos, actualmente no disponemos de un mecanismo para avisarte. Le recomendamos que supervise su sistema para asegurarse de que la información llegue a APN.
**P: ¿Cuándo estarán disponibles los resultados de JSON en la carpeta de resultados tras la presentación de una oportunidad o un new/updated prospecto entrante?**
El procesamiento es casi en tiempo real. Debería recibir los archivos en menos de cinco minutos.
**P: Si envío un CRM de oportunidades entrantes que no cumple con la format/length restricción del estándar de APN, ¿cómo lo gestiona el sistema? ¿Genera el informe de errores?**
Si el archivo no tiene el formato de definición de campo, el archivo de resultados de APN lo mostrará.
**P: No tengo un ID de AWS cuenta en el momento del lanzamiento. ¿Qué debo hacer?**
Según el proceso ACE, `Launched` significa que se ha completado la carga de trabajo y se ha iniciado la facturación. Esto requiere un ID AWS de cuenta. Para obtener más información, consulte el [Programa ACE FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ).
**P: Tras las pruebas de aceptación por parte del usuario (UAT), ¿cómo deben gestionarse los datos históricos durante el paso a la producción?**
De forma predeterminada, cuando se produce alguna actualización en ACE, enviamos esas oportunidades al bucket de Amazon S3. En el caso de los datos históricos que no desee procesar, debe proporcionarlos `partnerCrmUniqueIdentifier` con valores ficticios, como los que aparecen `X0001, X0002….X000N` en el extracto, para los datos que no desee procesar en su sistema. Debe escribir código para reconocer estos identificadores y procesarlos en consecuencia. El resto de las oportunidades proporcionan el `partnerCrmUniqueIdentifier` valor correcto. Esto garantiza que tenga el control total sobre qué procesar y qué no procesar en su sistema.
**P: ¿El archivo saliente contiene más de un registro?**
Sí. El archivo saliente puede contener más de un registro.
**P: ¿Por qué los datos se envían *a Accept para verlos* en algunos campos?**
En el caso de una AWS oportunidad o cliente potencial recomendado, todos los campos de información de identificación personal están enmascarados con la etiqueta *Aceptar para consultarla* hasta que usted acepte la oportunidad o el cliente potencial. Una vez aceptada, recibirá todos los campos de datos en el siguiente ciclo de sincronización.
**P: ¿Qué hago cuando una nueva AWS oportunidad o cliente potencial recomendado se sincroniza por primera vez?**
Cuando se sincroniza una nueva oportunidad o cliente potencial por primera vez, debes aceptarlo o rechazarlo para obtener datos adicionales (por ejemplo, los contactos de los clientes).
## Crear y actualizar oportunidades o clientes potenciales
**P: ¿Cómo puedo incorporar a ACE nuevas oportunidades recomendadas por *socios (originadas)* a través de la integración?**
Para crear nuevas oportunidades en ACE mediante la integración, es necesario introducir en la carpeta la información necesaria sobre las oportunidades en el formato JSON definido. `opportunity-inbound` AWS procesa esta información, crea una nueva oportunidad en ACE y comparte los resultados de una operación de successful/failed creación en la `opportunity-inbound-processed-results` carpeta.
**P: ¿Cómo diferencia la integración entre la presentación de nuevas oportunidades y las actualizaciones?**
El campo `PartnerCrmUniqueIdentifier` de cada oportunidad es un identificador único obligatorio. Este identificador debe estar definido en el CRM fuente de su sistema. AWS lo usa para determinar si ya existe una oportunidad en ACE. Si está disponible en ACE, utilizamos la información compartida para actualizar la oportunidad, pero si no está disponible en ACE, utilizamos la información compartida para crear una nueva oportunidad.
**P: Si ya he implementado la funcionalidad de actualización a través de la integración, ¿qué debo hacer para usar la integración y presentar (crear) nuevas oportunidades?**
Debe realizar los siguientes cambios en la integración existente:
1. Comience a aprovechar nuevas oportunidades de creación en la `opportunity-inbound` carpeta. Proporcione las actualizaciones en la misma carpeta.
1. Asegúrese de que los campos obligatorios necesarios para la creación estén disponibles en el JSON compartido de Opportunity.
1. Compruebe que cada nueva oportunidad tenga una única `PartnerCrmUniqueIdentifier` que no exista en ACE/Partner Central. Una buena práctica importante para la puesta en marcha es mapear y actualizar los datos existentes en ACE con cada uno `PartnerCrmUniqueIdentifier` de los datos de su CRM para no crear duplicados cuando recibimos actualizaciones. Para obtener ayuda, póngase en contacto con ACE.
**P: Como parte del proceso de puesta en marcha, ¿cómo actualizo las oportunidades existentes en ACE con las mías? `PartnerCrmUniqueIdentifier`**
El equipo de ACE le proporciona una lista de todas las oportunidades disponibles para ayudarlo a prepararse para el lanzamiento de la producción. Debe asignar estas oportunidades existentes en ACE a sus respectivas `PartnerCrmUniqueIdentifier` oportunidades y devolver el archivo actualizado a ACE para que lo integre en AWS el CRM.
Si eliges sincronizar solo un subconjunto de las oportunidades ofrecidas AWS , debes desarrollar una lógica para evitar AWS las actualizaciones en caso de que las oportunidades que no desees procesar. Este enfoque también debería aplicarse a las oportunidades futuras, después de la incorporación. Debe proporcionar la información asociada `partnerCrmUniqueIdentifier` para las oportunidades que necesiten alinearse entre ambas. CRMs Además, debe indicar qué oportunidades no actualizará (por ejemplo, marcando las oportunidades cerradas, perdidas o ganadas) para excluirlas de las actualizaciones. Es importante que a todas las oportunidades abiertas o activas que AWS compartas y que tú aceptes se les asigne un. `partnerCrmUniqueIdentifier`
**P: ¿Puedo actualizar solo campos específicos de la oportunidad o del prospecto?**
Sí. Puede proporcionar solo los campos que requieren actualizaciones, junto con los identificadores necesarios.
**P: ¿Es posible cambiarlos? *ApnCrmUniqueIdentifier***
No. Este identificador permanece constante AWS e identifica de forma única cada oportunidad.
**P: ¿Qué sucede si proporciono un *partnerCrmUniqueidentificador* incorrecto**?
Si proporciona un identificador incorrecto, se crea una nueva oportunidad. Garantice la precisión para evitar la duplicación de datos.
**P: ¿Puedo actualizar las oportunidades que AWS se presentaron?**
Sí. Puede actualizar las oportunidades AWS enviadas utilizando la dirección correcta`partnerCrmUniqueIdentifier`.
**P: ¿En cuánto tiempo puedo esperar los resultados de las oportunidades presentadas?**
El procesamiento se realiza casi en tiempo real y, por lo general, los resultados están disponibles en unos minutos en la `opportunity-inbound-processed-results` carpeta.
**P: ¿Qué debo hacer si se producen errores de procesamiento en las oportunidades presentadas?**
Revise los detalles de los errores en los archivos de resultados, solucione los problemas y solicite más ayuda al equipo de soporte de ACE.
**P: ¿Puedo eliminar una oportunidad a través de la integración?**
No. No se admite la eliminación directa. Puede actualizar una oportunidad para que refleje el estado *Cerrado*.
**P: ¿Qué significa el error «*Registro no editable*»?**
Este error se produce si intenta actualizar una oportunidad en ACE Review. Estas oportunidades no se pueden editar hasta que se validen.
**P: ¿Qué pasa si no envío actualizaciones o nuevas oportunidades?**
Si no envías actualizaciones o nuevas oportunidades a través de la integración, no se reciben ni procesan nuevos datos.
**P: ¿Durante cuánto tiempo están disponibles los archivos de resultados?**
Los archivos de resultados están disponibles durante un tiempo razonable. Debe recuperarlos y gestionarlos con prontitud.
# Preguntas técnicas frecuentes: control de versiones y compatibilidad con versiones anteriores
**P: ¿Qué es una carga útil en el intercambio de datos de Amazon Web Services (AWS)?**
Una carga útil es un dato estructurado formateado en JSON que se envía de entrada o de salida. AWS AWS*Cada clave de esta estructura JSON se denomina campo y cada *campo* tiene un valor asociado.*
**P: ¿Cómo se determina la versión de carga útil?**
La versión de la carga útil se especifica en el `version` campo de la propia carga útil. Las cargas útiles que cumplen con la definición de campo v13 se consideran carga útil versión 1.0, mientras que las que siguen el formato definido en la definición de campo v14 o superior se denominan carga útil versión 2.0.
**P: ¿Qué significa la compatibilidad con versiones anteriores en este contexto y cómo se gestiona?**
La compatibilidad con versiones anteriores garantiza que las oportunidades existentes no se pierdan cuando se introduzcan campos nuevos y obligatorios en las versiones más recientes de la carga útil. AWS lo mantiene mediante la asignación automática de valores predeterminados a los campos requeridos en la nueva versión. Es posible que observe valores en la AWS Partner Network interfaz de usuario de Customer Engagement (ACE) (APN) que no proporcionó explícitamente a través de la integración de la gestión de relaciones con los clientes (CRM). Los detalles y las condiciones de cada campo se explican en la descripción del campo o en detalles adicionales sobre el campo.
**P: ¿La compatibilidad con versiones anteriores es una característica permanente?**
No. La compatibilidad con versiones anteriores tiene un límite de tiempo y está diseñada para proporcionarle flexibilidad a la hora de planificar e implementar los próximos cambios. Deja de funcionar después de una fecha límite específica, que se anunciará más adelante en el año como parte de un lanzamiento más amplio.
**P: ¿Qué ocurre cuando empiezo a enviar cargas útiles con la versión 2.0?**
Una vez que se envía una carga útil con la versión 2.0, el sistema asume que se han implementado todos los cambios necesarios y las validaciones de la nueva versión de la carga útil se aplican a todos los cambios posteriores. Es esencial que no implementes funciones parcialmente entre las cargas útiles de la versión 1.0 y la versión 2.0.
**P: ¿Puedo volver a la versión 1.0 de la carga útil después de actualizar a la versión 2.0?**
No. La transición a la versión 2.0 de carga útil es un proceso unidireccional. Una vez que actualices a la versión 2.0, no podrás volver a la versión 1.0 de la carga útil.