Notas de la versión

Esta página contiene un resumen de los cambios más importantes en la documentación de la API de AWS Partner Central, empezando por la actualización más reciente.

Historial de revisiones

Cambio	Descripción	Fecha
RC 6.0	AWS Partner Central agregó nuevas API de medición de ingresos para socios.	30 de junio de 2020
ARC 5.3	Actualizaciones de ACE Resonate: GetAwsOpportunitySummary respuesta actualizada.	16-06-20
ARC 5.2	Soporte de divisas EUR: CreateOpportunityUpdateOpportunity,, y CreateEngagementInvitation ahora se acepta EUR además del código USD de moneda MRR. Si la partición de AWS es aws-eusc (AWS European Sovereign Cloud), el código de divisa debe serEUR. El EUR aparece en las operaciones de lectura: GetOpportunityListOpportunities, y GetAwsOpportunitySummary ahora aparece EUR en el CurrencyCode campo correspondiente a las oportunidades de la aws-eusc partición.	30-03-2020
ARC 5.1	Soporte de divisas EUR: CreateOpportunityUpdateOpportunity,, y CreateEngagementInvitation ahora se acepta EUR además del código USD de moneda MRR. Si la partición de AWS es aws-eusc (AWS European Sovereign Cloud), el código de divisa debe serEUR. El EUR aparece en las operaciones de lectura: GetOpportunityListOpportunities, y GetAwsOpportunitySummary ahora aparece EUR en el CurrencyCode campo correspondiente a las oportunidades de la aws-eusc partición.	30-03-2020
ARCO 5	Se introdujo la API de cuentas: se agregó una nueva API de cuentas a AWS Partner Central, que permite a los socios administrar la información de sus cuentas, el registro, los perfiles, la administración de dominios y las conexiones con los socios. Documentación de referencia sobre la API de cuentas: se agregó una documentación de referencia completa sobre la API de cuentas, que incluye el registro de socios, la administración de perfiles, la verificación del dominio y los flujos de trabajo de conexión de cuentas. Registro de la API de cuentas: se agregó soporte de registro y documentación para la API de cuentas para ayudar a auditar y rastrear el uso de la API. Notificaciones de la API de la cuenta: se ha añadido la función de notificación de eventos a la API de la cuenta, lo que permite a los socios recibir actualizaciones en tiempo real sobre las actividades relacionadas con la cuenta, incluidas las conexiones entre ellas. Cuotas de la API de cuentas: se agregó documentación sobre las cuotas de servicio para la API de cuentas. Pruebas de entorno limitado para la API de cuentas: se agregaron capacidades de pruebas de entorno limitado para la API de cuentas, lo que permitió a los socios probar los flujos de trabajo de administración de cuentas en un entorno que no fuera de producción. Se introdujo la API de beneficios: se agregó una nueva API de beneficios a AWS Partner Central, que permite a los socios descubrir, solicitar y administrar los beneficios de todos los programas de AWS socios a través de una interfaz centralizada. Documentación de referencia de la API de beneficios: se agregó una documentación de referencia completa sobre la API de beneficios, que abarca las solicitudes de beneficios, las asignaciones y los procesos de cumplimiento. Registro de la API de beneficios: se agregó soporte de registro y documentación para la API de beneficios para ayudar a auditar y rastrear el uso de la API. Notificaciones de la API de beneficios: se agregó el soporte de notificación de eventos a la API de beneficios, lo que permite a los socios recibir actualizaciones en tiempo real sobre las solicitudes y asignaciones de beneficios. Cuotas de la API de beneficios: se agregó documentación sobre las cuotas de servicio para la API de beneficios. Pruebas de entorno limitado para la API de beneficios: se agregaron capacidades de pruebas de entorno aislado para la API de beneficios, lo que permitió a los socios probar los flujos de trabajo de gestión de beneficios en un entorno no productivo. API de ventas actualizada: acciones de participación de la API de ventas mejoradas para respaldar el flujo de trabajo de gestión de clientes potenciales. Actualizaciones de la documentación de la API de ventas: documentación mejorada de la API de ventas con una estructura mejorada y flujos de trabajo actualizados para la gestión de clientes potenciales. Actualizaciones de las notificaciones de la API de ventas: documentación de notificación de eventos mejorada para los eventos de participación e invitación a la participación. Ampliación de la estructura de la API: estructura de documentación ampliada para admitir cuatro API distintas (cuenta, beneficios, ventas y canal) con secciones dedicadas a los permisos, el registro, las notificaciones, las cuotas y las pruebas de entorno limitado de cada API. Documentación de uso de las API mejorada: se han añadido guías de uso exhaustivas para las API de cuentas y beneficios, con flujos de trabajo y patrones de integración detallados. Documentación de las regiones compatibles: se agregó documentación sobre las AWS regiones compatibles con las API de cuentas y beneficios. Nuevo filtro paraListOpportunities: Se agregó un TargetCloseDate filtro para permitir filtrar las oportunidades por su fecha de cierre prevista AfterTargetCloseDate y por BeforeTargetCloseDate los campos en YYYY-MM-DD formato.	2025-11-30
ARCO 4	Se introdujo la API de canal: se agregó una nueva API de canal a AWS Partner Central, que permite a los socios gestionar las relaciones entre los canales y las colaboraciones entre socios. Documentación de referencia sobre la API del canal: se agregó una documentación de referencia completa sobre la API del canal, que incluye todas las acciones y los modelos de datos disponibles. Permisos de la API de canal: se agregaron políticas de permisos de IAM y documentación de control de acceso específicas para la API de canal. Registro de la API de canal: se agregó soporte de registro y documentación para la API de canal para ayudar a auditar y rastrear el uso de la API. Notificaciones de la API de canal: se ha añadido la compatibilidad con las notificaciones de eventos a la API de canal, lo que permite a los socios recibir actualizaciones en tiempo real sobre las actividades relacionadas con el canal. Cuotas de la API del canal: se agregó la documentación sobre las cuotas de servicio para la API del canal. Pruebas de entorno limitado para la API de canal: se han añadido capacidades de pruebas de entorno aislado para la API de canal, lo que permite a los socios probar los flujos de trabajo del canal en un entorno que no es de producción. Reorganización de la estructura de las API: se reorganizó la documentación para distinguir entre la API de ventas y la API de canal, con secciones dedicadas a los permisos, los registros, las notificaciones y las cuotas de cada API. Documentación de las regiones compatibles: se ha añadido documentación sobre las AWS regiones compatibles con las API de venta y de canal.	-19 de noviembre de 2021
ARCO 3	Políticas de permisos de la API actualizadas: las políticas se han actualizado para reflejar las nuevas acciones introducidas en esta versión. Asegúrese de que sus funciones y permisos de IAM se ajusten en consecuencia. Detalles de uso del encabezado personalizado: se agregaron detalles sobre cómo usar el encabezado personalizado X-Amzn-User-Agent para ayudar a auditar y medir el uso de la API. Acciones sustituidas por acciones asíncronas: se han sustituido por acciones asincrónicas StartEngagementByAcceptingInvitationTask y el formato de carga útil ha cambiado AcceptOpportunityEngagementInvitation con respecto a RC2. Cambio de nombre de entidad y acción: cambiado a. OpportunityEngagementInvitation EngagementInvitation Los atributos de estas acciones también han cambiado para alinearse con la nueva entidad. Se sustituyeron las siguientes acciones: GetOpportunityEngagementInvitationes ahoraGetEngagementInvitation. Se han cambiado, agregado o eliminado varios atributos de la invitación. ListOpportunityEngagementInvitationslo es ahoraListEngagementInvitations. RejectOpportunityEngagementInvitationes ahoraRejectEngagementInvitation. AssignOpportunityactualización de parámetros: AssignOpportunity ahora toma Assignee en lugar deAssigneeEmail. Actualice sus implementaciones en consecuencia. SubmitOpportunitycambio de funcionalidad: ahora SubmitOpportunity se realiza mediante la acción asíncrona. StartEngagementFromOpportunityTask SubmitOpportunityahora acepta y. InvolvementType Visibility Cambio de nombre y expansión de atributos: EstimatedAwsMonthlyRevenue cambiado aExpectedCustomerSpend. ExpectedCustomerSpendahora incluye nuevos atributos, como Frequency yTargetCompany. Resumen de una nueva acción para AWS una oportunidad: La visibilidad de las oportunidades ahora se proporciona a través de una acción independiente denominadaGetAwsOpportunitySummary. Actualizaciones del flujo de trabajo para trabajar con las oportunidades: el flujo de trabajo para trabajar con las oportunidades se actualizó para utilizar las nuevas acciones introducidas en esta versión. Actualizaciones del flujo de trabajo para trabajar con oportunidades: el flujo de trabajo para trabajar con oportunidades se actualizó para usarloEngagementInvitations, lo que mejora el manejo de las oportunidades que ofrece AWS. Actualizaciones del flujo de trabajo para el seguimiento de las actualizaciones: el flujo de trabajo para el seguimiento de las actualizaciones ahora funciona con las actualizaciones de las oportunidades, lo que mejora la claridad y la eficiencia a la hora de supervisar el estado de las oportunidades. Nuevos filtros para enumerar las acciones: hay nuevos filtros disponibles para ListOpportunities las acciones ListSolutions y las acciones. ParaListSolutions, los nuevos filtros son FilterCategoryFilterIdentifier, yFilterStatus. ParaListOpportunities, los nuevos filtros son FilterCustomerCompanyNameFilterIdentifier, FilterLastModifiedDateFilterLifeCycleApprovalStatus,FilterLifeCycleStage, yFilterOrigin. Eliminación del AccessControl subobjeto: se ha eliminado el AccessControl subobjeto del modelo de oportunidades. NationalSecurityahora es un atributo de nivel superior. Atributos reubicados enGetAwsOpportunitySummary: atributos comoAWSOpportunityTeam, información (EngagementScore,NextBestAction), origen y ahora InvolvementType están disponibles GetAwsOpportunitySummary en lugar de. GetOpportunity Introducción del InvolvementType campo: se introdujo el InvolvementType campo para diferenciar entre las oportunidades de venta conjunta y las de solo visibilidad. Actualizaciones del nombre del evento: los eventos se actualizaron para reflejar los cambios. Por ejemplo, la invitación de participación de Opportunity creada ahora es una invitación de participación creada. Actualizaciones de la carga útil de respuesta: todas las cargas útiles de respuesta ahora incluyen un ARN and/or de ID. Solicitar actualizaciones de carga útil: todas las cargas útiles de solicitud ahora utilizan identificadores como entrada, que aceptan un ID o un ARN. Actualización de la entidad de contratación: se cambió el nombre del atributo de título de la entidad de contratación. EngagementTitle Eliminación del prefijo del filtro: todos los filtros ya no incluyen el prefijo del filtro, lo que simplifica el mecanismo de filtrado. StartEngagementFromOpportunityactualización de la acción: el atributo AwsInvolvement se cambió a. AwsSubmission Actualización de los detalles del proyecto de invitación: Invitation.ProjectDetails.TargetCompletionDate se cambió el nombreInvitation.ProjectDetails.EstimatedCompletionDate. Actualización de la estimación de ingresos: ya Invitation.PartnerRevenueEstimate estáExpectedCustomerSpend. El tipo de datos cambió de un objeto a una matriz que contiene un objeto. Actualización de la cuenta del destinatario: ReceiverAccount se cambió el nombre del campoAccountReceiver. Atributo nuevo de invitación de compromiso: se introdujo un SenderContact atributo para las invitaciones de compromiso. Customer.Contactahora es una matriz en lugar de un objeto. OpportunityOwner, PartnerAccountManager son valores admitidos comoBusinessTitle. PartnerOpportunityTeam ahora se llama OpportunityTeam. APNPrograms ahora es ApnPrograms Se actualizaron los estados de las invitaciones de compromiso. ListEngagementInvitationsahora requiere ParticipantType comoRECEIVER.	2024-10-17
ARCO 2	Introdujo una nueva entidad llamada OpportunityEngagementInvitation. Introdujo una nueva acción: ListOpportunityEngagementInvitations. Introdujo una nueva acción: GetOpportunityEngagementInvitation. Presentó un nuevo evento: «Se creó una invitación de participación en la oportunidad». AcceptOpportunity Reemplazado por AcceptOpportunityEngagementInvitation. RejectOpportunity Reemplazado por RejectOpportunityEngagementInvitation. Se reemplazó «Oportunidad aceptada» por «Invitación de participación de oportunidad aceptada». Se sustituyó «Oportunidad rechazada» por «Invitación de captación de oportunidad rechazada». PrimaryNeedsFromAWScambiado a PrimaryNeedsFromAws. AWSOpportunityTeamcambiado aAwsOpportunityTeam. AWSSalesLifeCyclecambiado aAwsSalesLifeCycle. PrimaryNeedsFromAWSChangeReasoncambiado aPrimaryNeedsFromAwsChangeReason. AWSAccountIdcambiado aAwsAccountId. ExpectedMonthlyAWSRevenuecambiado aExpectedMonthlyAwsRevenue. AWSFundingUsedcambiado aAwsFundingUsed. AWSMarketplaceOfferscambiado aAwsMarketplaceOffers. Countrycambiado aCountryCode. PartnerOpportunityContactcambiado aPartnerOpportunityTeam. Se actualizó el campo Contact.Title aContact.BusinessTitle. Se actualizó el campo ContactInfo aOwnerInfo. Cambió el AWS equipo de un mapa a una lista. Se agregaron detalles sobre la lista de aceptados RejectionReasons. Se proporcionó información sobre cómo usar el token de cliente. Incluye detalles sobre cómo usarlo UpdateOpportunity. Se agregó una guía sobre el uso de AWS productos y soluciones de socios. Proporcionó detalles sobre la OpportunityEngagementInvitation entidad. Se actualizó StateOrRegion para incluir una lista revisada de valores aceptados. Se han implementado varias correcciones de errores para mejorar el rendimiento y los mensajes de error.	2024-08-07
ARCO 1	[Última hora] Cambiar el nombre del campo ApprovalStatus a ReviewStatus: Hemos cambiado el nombre del ApprovalStatus campo ReviewStatus a para reflejar mejor su propósito. Además, vamos a introducir un nuevo estado, Pendiente de envío, para indicar una oportunidad de borrador. Ahora aceptará los siguientes valores: pendiente de envío, enviado, en revisión, aprobado, rechazado y acción requerida. ReviewStatus El estado anterior de borrador se sustituirá por el de «Envío pendiente». [Última hora] Introducción de la SubmitOpportunity acción: Se ha introducido una nueva acción SubmitOpportunity,. A diferencia del comportamiento actual, en el que CreateOpportunity también se envía la oportunidad, ahora puede crear una oportunidad en el estado de envío pendiente sin vincular inmediatamente una solución o un AWS producto. Para completar el envío, utilice la AssociateOpportunity acción de vincular una solución o un producto y, a continuación, SubmitOpportunity Esta separación proporciona un mejor rendimiento de respuesta de la API y una fase de preparación flexible antes del envío. [Última hora] El requisito de un parámetro de catálogo y la obsolescencia del punto final Sandbox: el punto final «gamma» (partnercentral-selling-gamma.us-east-1.amazonaws.com) dejará de estar disponible después de /2024. 7/30 Todas las acciones de la API ahora requieren un parámetro de catálogo para especificar si la operación se realiza en el entorno aislado o en el catálogo.AWS Las reglas de notificación ahora se filtrarán por el catálogo en lugar de por EnvironmentName. [Última hora] Cambiar el nombre de OpportunityIdentifier a Identifier: Actions AssignOpportunity AcceptOpportunity, y RejectOpportunity ahora usar Identifier en lugar de OpportunityIdentifier para mantener la coherencia con. UpdateOpportunity Cambia del tipo Enum a String para APNProgram CustomerUseCase, y UseCase: Vamos a convertir Project.APNPrograms Marketing.ActivityUseCases, y Project.CustomerUseCase del tipo de enumeración al tipo de cadena para reducir los riesgos asociados con el cambio de valores. Estos campos solo aceptarán valores de listas predefinidas, pero no estarán disponibles de forma nativa en los SDK. Gestión de errores mejorada: la gestión de errores en las API se ha mejorado considerablemente para facilitar la depuración y la resolución más rápida de los problemas. La nueva gestión de errores estructura los errores en dos etapas: 1. Falló la validación de la solicitud: comprueba los tipos y el formato de los datos, o 2. Falló la validación empresarial: todos los problemas de una carga útil se enumerarán en una respuesta, especificando el campo que contiene los errores. Estos comentarios consolidados te permiten solucionar problemas y corregir los errores de forma más eficiente. Se han estandarizado los códigos y formatos de errores. Identificador de origen del cliente: los socios pueden incluir el X-Amzn-User-Agent encabezado en sus solicitudes, lo que ayuda a identificar el origen del tráfico. Utilice el formato [Nombre de la solución, incluido el proveedor de la solución] | [Versión] Por ejemplo:AWS Partner CRM Connector | v2.0.1 Corrección de error, ya implementada, sin cambios en el SDK] Creación de oportunidades e ID de AWS cuenta: los socios ahora pueden lanzar una oportunidad y cambiar el ID de AWS cuenta de nulo a un valor válido sin errores. Anteriormente, un error impedía a los socios realizar estas acciones por separado. Corrección de un error, ya implementada, sin cambios en la solución [SDK]. Asociación con nuevas oportunidades: los socios pueden asociar una solución a una oportunidad recién creada. Antes, cuando los socios creaban una nueva oportunidad y asociaban simultáneamente una solución, la información de la solución se perdía. Este problema se ha resuelto. Corrección de error, ya implementada, sin cambios en el SDK] Visualización de los detalles del propietario de la oportunidad: se ha corregido el problema por el que algunas oportunidades mostraban los detalles del propietario en un campo combinado LastName «» en lugar de los campos FirstName «Correo electrónico», «y «» esperados. LastName Corrección de error, ya implementada, sin cambios en el Customer.Account.WebsiteUrl campo [SDK] (opcional): el Customer.Account.WebsiteUrl campo se ha hecho opcional cuando el AccessControls.NationalSecurity campo es «Sí», lo que permite alinear el comportamiento de la API con el comportamiento de la interfaz de usuario existente. Si el AccessControls.NationalSecurity campo es «No» o nulo, será obligatorio como validación empresarial. WebsiteUrl Se corrigió un error, ya se implementó. [Sin cambios en el SDK]. [Requisito de identificación de AWS cuenta para los socios consultores]: se ha resuelto la incoherencia en la interfaz de usuario que mostraba el campo de ID de AWS cuenta como opcional para los socios consultores. Ahora es un campo obligatorio condicional, según la documentación. Se ha corregido un error. Para su implementación 6/19, el SDK [Stage of a Co-sell Opportunity to Closed Lost] Los socios ahora pueden actualizar correctamente el Stage of a Co-sell Opportunity a Closed Lost, siempre que se indique un motivo de cierre perdido. Esto resuelve el error anterior que decía: «Falta un campo obligatorio: se requiere cerrar el motivo de pérdida para cerrar la oportunidad». Documentación] Mejoras en la documentación: se realizaron varias mejoras en la documentación para reflejar los cambios. Problemas conocidos relacionados con una solución pendiente y una lista de las próximas funciones: Al realizar alguna AssociateOpportunity acción con las soluciones o los productos, los mensajes de error de las ofertas se muestran de forma incorrecta. Capacidad para crear oportunidades de forma remota y simular el proceso AWS de validación en Sandbox El código postal devuelve un valor nulo cuando tiene el formato XXXXX-XXXX de EE. UU. Next Steps y Next Step History no están disponibles para las oportunidades que estén marcadas como «No necesito apoyo de»AWS. No se puede obtener un historial de oportunidades con descripciones de problemas comerciales de clientes de más de 255 caracteres. Posibilidad de eliminar las oportunidades que están pendientes de ser enviadas. LeadSource no está disponible en el modelo de datos.	2024-06-21
Beta 5	Cambiado LifeCycle.ApprovalStatus a LifeCycle.ReviewStatus Cambiado Insights.ReviewComments a LifeCycle.ReviewComments Añadido LifeCycle.ReviewStatusReason (nuevo atributo) Se ha añadido el nuevo valor «Pendiente» a PartnerAcceptance.Status Se publicaron los SDK para dotnet, java, javascript, python y ruby. Se actualizó la guía de referencia de la API para reflejar los cambios anteriores.	2024-04-19
Beta 4	Se agregaron las pruebas de sandbox: se puede probar la notificación de eventos de oportunidad en Sandbox. Documentación añadida: se introdujeron ejemplos de reglas de notificación de eventos de oportunidad. Versiones de SDK agregadas: SDK publicados para Java (V2), Javascript (V2), DotNet (V3) y Python (V3). Formato de fecha actualizado: actualizado para cumplir con las normas ISO.	04-03-2022
Beta 3	Archivo de registro de cambios agregado: se introdujo un archivo de registro de cambios para un mejor seguimiento de las actualizaciones y los cambios. Guía de referencia de la API actualizada (PDF): se publicó una nueva versión de la guía de referencia de la API en formato PDF. Guía de referencia de la API actualizada (versión web): se actualizó la versión web de la Guía de referencia de la API. DotNet SDK agregado: lanzamos el DotNet SDK, ampliando nuestro soporte para diferentes entornos de programación. SDK de Python Boto 3 (V2) actualizado: se publicó la versión 2 del SDK de Python Boto 3, que presenta nuevas funciones y mejoras.	24 de enero de 2022
Beta 2	Guía de referencia de la API agregada (versión web): se publicó una nueva versión de la Guía de referencia de la API (versión web). Nota: Esta versión requiere que se ejecute un servidor web local después de la extracción para que funcione correctamente.	2024-01-07
Beta 1	Se agregó Boto3 (versión inicial): lanzamos la versión inicial de Boto3, un SDK de Python para nuestros servicios. Se agregó una guía del programa beta: introdujimos una guía para los participantes en nuestro programa de pruebas beta. Se agregó la guía de referencia de la API (PDF): se cargó la primera versión de nuestra guía de referencia de la API en formato PDF, que proporciona una documentación completa sobre nuestra API.	15 de diciembre de 2023
Beta 0	Esta versión inicial proporciona un conjunto de funcionalidades para gestionar y optimizar las interacciones y oportunidades de los socios en AWS Partner Central.	15 de noviembre de 2023