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.
# 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.