API de registro de actividad de CRM

42 min

Comenzando

Para ayudar a los concesionarios a mejorar la gestión de sus oportunidades de venta y proporcionar a BRP información del mercado y conocimientos sobre la demanda, su CRM envía un registro diario de actividad.

El registro de actividad del CRM proporciona información sobre cómo el concesionario gestiona las oportunidades de venta enviadas por BRP (oportunidades de nivel 1) y sobre las oportunidades creadas directamente dentro de su CRM (oportunidades de nivel 3).

El objetivo de BRP es obtener una visión general de la gestión de oportunidades de venta por parte de los concesionarios, por ejemplo:

¿Cuántas oportunidades crea el concesionario en su CRM?

¿Cuántas resultaron en una venta de una unidad?

¿Cuáles son las acciones más comunes realizadas?

Tener esta visibilidad ayudará a BRP a mejorar las promociones y crear programas para mejorar la gestión de oportunidades de venta por parte de los concesionarios.

❗❗ Si no hay cambios en las oportunidades de venta realizados durante el día, no envíe un payload vacío, no llame a la API ❗❗

❗El registro de actividad del CRM se envía solo si el concesionario consiente compartir los datos.

¿Dónde empezar? ¡Léeme primero!

Antes de comenzar a trabajar en esta API, debes leer las siguientes secciones si aún no las has revisado:

¡Comienza aquí con la lectura obligatoria!
Información Técnica para información técnica general sobre la API y los entornos.
Autenticación y Credenciales para detalles sobre autenticación y credenciales.
Proceso de Certificación para detalles sobre el proceso de certificación y Jira.
Obteniendo Apoyo para detalles sobre cómo obtener ayuda y Jira.

Información técnica

Características

Tipo de API	Tipo DSP	Versión DCP	Complejidad
Obtener datos de BRP	DMS	V3 - Internacional	Bajo
Enviar datos a BRP	CRM	V4 - Norteamérica	Un poco más
Transacción con BRP			Algo más

Autenticación

La API está usando Autenticación de Aplicaciones.

Necesitas un token de acceso válido antes de llamar a esta API, o tienes que llamar a la API de Autenticación de Aplicaciones para obtener uno.

¡El token de acceso es válido por 30 minutos! (1799 segundos)

URL base

Prueba	https://qa-cloud-api.brp.com/dcp/<v3 o v4>
Producción	https://cloud-api.brp.com/dcp/<v3 o v4>

Recurso: Actividad CRM

El Actividad CRM recurso permite que un CRM envíe oportunidades de ventas actualizadas por el concesionario, junto con la lista de acciones para cada una.

Representación JSON

{
    "items": [
        {
            "lead_id": "523452345346564",
            "sales_opportunity_id": "00Q6s000001TQcaEAG",
            "dealer_no": "0000691888",
            "customer_id": "1234567",
            "customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
            "source": "brp",
            "crm_source": "BRP",
            "language": "en",
            "product_interest": {
                "category": "Watercraft",
                "model": "Spark",
                "brand": "seadoo_watercraft"
            },
            "status": [
                {
                    "code": "new",
                    "set_on": "2020-06-12T14:48:12Z",
		    "crm_code": "created"
                },
                {
                    "code": "contacted",
                    "set_on": "2020-06-13T14:48:12Z",
		    "crm_code": "sent SMS"
                }
            ],
            "comments": "I am looking for a specific color for this sea doo. I would like it black and white",
            "actions": [
                {
                    "code": "received",
                    "set_on": "2020-06-13T14:48:12Z",
                    "user_name": "",
		    "crm_code": "created"
                },
                {
                    "code": "opened",
                    "set_on": "2020-06-13T14:59:12Z",
                    "user_name": "John Smith",
		    "crm_code": "processed"
                },
                {
                    "code": "status changed",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith",
		    "crm_code": "updated"
                }
            ]
        }
    ]    
}

Propiedades

Property	Type	Definition	Notes
items	list of objects	List of activities performed by the dealers. There is one object per sales opportunity.
items. lead_id	string	Internal lead ID from your CRM.
items. sales_opportunity_id	string	Sales opportunity identifier from BRP. An empty string if the sales opportunity wasn’t sent by BRP (Tier-3). The sales opportunity identifier is sent by the API de oportunidad de ventas.	Max Length:18
items. dealer_no	string	Code that uniquely identifies a dealer. Must be 10 characters. If fewer than 10 characters, add '0' at the beginning.	Length: 10
items. customer_id	string	Unique identifier at the dealer (or CRM) level for this customer. NULL if there is no account for the customer in the CRM.	Max length: 50 characters
Items. customer_hash	string	A SHA-256 hash on the customer's phone number and email. Required format is SHA-256(^\+[1-9]\d{1,14} \S+@\S+\.\S+$) i.e., SHA-256(E.164 phone number space email address). e.g.:SHA-256(+18882729222 [email protected]) If the email or phone number is missing, then use null. 👉 The email must be made all lowercase for the hash calculation.	Format: ^[a-fA-F0-9]{64}$
items. source	string	The source of the lead: website lead brp walk_in email call service other	Max Length:25
Item. crm_source	string	The CRM raw source information.	Max Length:50
items. language	string	Communication language of the customer, in ISO language code (ISO-639-1)	Format xx
items. product_interest	object	The product the customer is interested in.	Max Length:50
items. product_interest. category	string	The category of the product in which the consumer is interested.	Max Length:100
items. product_interest. model	string	Model of the product in which the consumer is interested.	Max Length:50
items. product_interest. brand	string	The product brand that interests the consumer. One of: canam canam_atv canam_offroad canam_roadster canam_side_by_side canam_2wv lynx seadoo seadoo_pontoon seadoo_watercraft skidoo	Max Length:100
items. status	list of objects	List of statuses attached to the sales opportunity.
items. status. code	string	.Status code. One of : new contacted unit_sold abandoned	Max Length:15
items. status. crm_code	string	The CRM raw status code.	Max Length:50
items. status. set_on	datetime	Date and time at which the status has been set, in ISO 8601 format.	Format: YYYY-MM-DDTHH:MM:SSZ
items. comments	string	Any comments left by the user, free text.	Max Length:4000
items. actions	list of objects	Actions taken by a user when they communicate with the lead.
items. actions. code	string	Action code. One of: received opened lead closed status changed email sent SMS sent customer called customer call no answer customer call done customer walk-in customer appointment scheduled customer appointment showed customer appointment missed	Max Length:25
items. actions. crm_code	string	The CRM raw action code.	Max Length:50
items. actions. set_on	string	Date and time at which the status has been set, in ISO 8601 format.	Format: YYYY-MM-DDTHH:MM:SSZ
items. actions. username	string	User name from your CRM of the user who acted on the sales opportunity. Empty if no user is involved in the action.

Limitaciones y restricciones

Tamaño de la Carga Útil

La API del Registro de Actividades del CRM se ejecuta en APIGee, que tiene un tamaño máximo de carga útil de 10 MB.

Consulte la sección 413 Entidad de Solicitud Demasiado Grande para obtener más información sobre cómo manejar el código de estado 413.

Comprender el Registro de Actividades del CRM

Esta sección proporciona información sobre varios aspectos del registro de actividades del CRM para ayudarle a implementar la interfaz.

Terminología de BRP

Antes de comenzar, definamos algunos términos.

Lead de ventas: Un cliente potencial interesado en un producto BRP. Se dispone de cierta información sobre este cliente potencial, incluida su nombre, número de teléfono o dirección de correo electrónico, así como el producto que le interesa.

Oportunidad de venta: Un cliente potencial validado y calificado ha sido asignado a un distribuidor.

Disposición: Es el resultado de la oportunidad de venta procesada por el distribuidor. La oportunidad de venta puede resultar en contactar al cliente, una venta de una unidad o abandono.

Nivel 1: Un cliente potencial que fue enviado a su CRM como una oportunidad de venta. Un cliente creó el cliente potencial a través de una de las plataformas de comunicación de BRP.

Nivel 3: Un cliente potencial creado en su CRM por el distribuidor tras una llamada del cliente, visita a la concesionaria o a través del sitio web del distribuidor.

El ID y el Hash del Cliente

El objetivo del hash y el ID del cliente es identificar a los clientes sin compartir su información personal, y recopilar información sobre clientes recurrentes y sus solicitudes.

Las reglas y leyes de privacidad de datos han estado vigentes en algunos países durante años y ahora se están implementando en muchos otros.

Por esta razón, la carga útil del registro de actividad del CRM no contiene la información personal del cliente.

Puede ver que la carga útil incluye la propiedad customer_id, que es el identificador de la cuenta del cliente en el CRM.

Es un elemento que puede ayudar a identificar a un cliente, pero es posible que el distribuidor no haya creado una cuenta para el cliente, y que un cliente pueda acudir a diferentes concesionarios y tener múltiples customer_id.

La customer_hashpropiedad en el objeto customer ha sido diseñada para no ser reversible: no se pueden recuperar el correo electrónico ni el número de teléfono del cliente a partir del hash.

Es esencial incluir el valor hash ÚNICAMENTE si tanto el correo electrónico como el número de teléfono del cliente están disponibles.

Si falta uno de ellos, el valor hash debe establecerse en null.

El hash se calcula utilizando un hash SHA-256 del número de teléfono, codificado según el estándar E.164, un espacio y la dirección de correo electrónico, todo en minúsculas.

Actividades Diarias vs Registro Histórico

El registro de actividades del CRM contiene dos tipos de información para cada oportunidad de venta: detalles de actividad e historial de actividad.

La propiedad del estado de la oportunidad de venta (items.status), que coincide con el estado enviado a BRP a través de la API de oportunidad de ventas.

La lista de acciones realizadas por el concesionario sobre la oportunidad de venta (items.actions).

❗ Todas las demás propiedades siempre se envían ❗

Cada uno de estos elementos es una lista que contiene todos los estados de las oportunidades de venta y todas las acciones realizadas desde su creación.

La información se puede enviar de dos maneras:

Si tu CRM almacena todo el historial de oportunidades de venta y puede acceder a él fácilmente, la información enviada para cada oportunidad de venta puede incluir todos los cambios de estado y acciones.

Si tu CRM no tiene el historial de oportunidades de venta, puede enviar los cambios de estado y las acciones realizadas desde la última carga del registro de actividad del CRM.

❗ Si una oportunidad de venta no fue modificada, no la envíes ❗

En el primer caso, la carga útil del registro de actividad de tu CRM contiene todos los datos de las oportunidades de venta modificadas.

Se muestra un ejemplo en el payload a continuación. La status y la lista de actions contiene muchas entradas ya que se envió el historial.

{
    "items": [
        {
            "lead_id": "523452345346564",
            "sales_opportunity_id": "00Q6s000001TQcaEAG",
            "dealer_no": "0000691888",
            "customer_id": "1234567",
            "customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
            "source": "brp",
            "crm_source": "oem",
            "language": "en",
            "product_interest": {
                "category": "Watercraft",
                "model": "Spark",
                "brand": "seadoo_watercraft"
            },
            "status": [
                {
                    "code": "new",
                    "crm_code": "created",
                    "set_on": "2020-06-12T14:48:12Z"
                },
                {
                    "code": "contacted",
                    "crm_code": "active",
                    "set_on": "2020-06-13T14:48:12Z"
                }
            ],
            "comments": "I am looking for a specific color for this sea doo. I would like it black and white",
            "actions": [
                {
                    "code": "received",
                    "crm_code": "created",
                    "set_on": "2020-06-13T14:48:12Z",
                    "user_name": ""
                },
                {
                    "code": "opened",
                    "crm_code": "processed",
                    "set_on": "2020-06-13T14:59:12Z",
                    "user_name": "John Smith"
                },
                {
                    "code": "status changed",
                    "crm_code": "updated",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith"
                }
            ]
        }
    ]    
}

Si tu CRM está enviando solo los cambios desde la carga de la lista, el payload para el mismo lead se ve como el mostrado a continuación. Solo se envían el último estado y la última acción.

{
    "items": [
        {
            "lead_id": "523452345346564",
            "sales_opportunity_id": "00Q6s000001TQcaEAG",
            "dealer_no": "0000691888",
            "customer_id": "1234567",
            "customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
            "source": "brp",
            "crm_source": "oem",
            "language": "en",
            "product_interest": {
                "category": "Watercraft",
                "model": "Spark",
                "brand": "seadoo_watercraft"
            },
            "status": [
                {
                    "code": "contacted",
                    "crm_code": "active",
                    "set_on": "2020-06-13T14:48:12Z"
                }
            ],
            "comments": "I am looking for a specific color for this sea doo. I would like it black and white",
            "actions": [
                {
                    "code": "status changed",
                    "crm_code": "updated",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith"
                }
            ]
        }
    ]    
}

Es posible enviar un registro de actividad solo con la acción realizada si el estado no fue cambiado.

{
    "items": [
        {
            "lead_id": "523452345346564",
            "sales_opportunity_id": "00Q6s000001TQcaEAG",
            "dealer_no": "0000691888",
            "customer_id": "1234567",
            "customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
            "source": "brp",
            "crm_source": "oem",
            "language": "en",
            "product_interest": {
                "category": "Watercraft",
                "model": "Spark",
                "brand": "seadoo_watercraft"
            },
            "status": [],
            "comments": "I am looking for a specific color for this sea doo. I would like it black and white",
            "actions": [
                {
                    "code": "SMS sent",
                    "crm_code": "texto sent",
                    "set_on": "2020-06-13T14:48:12Z",
                    "user_name": ""
                }
            ]
        }
    ]    
}

Código de estado de la oportunidad de venta

Una oportunidad de venta puede tener uno de los cuatro valores de estado siguientes. Su CRM puede tener valores de estado más detallados, y la tabla debería ayudarle a mapear su estado interno con un estado de oportunidad de venta.

👉 Los mismos estados se utilizan en el endpoint de actualización de API de oportunidad de ventas .

Estado de Oportunidad de Venta	Significado
nuevo	La oportunidad de venta ha sido creada en tu CRM.
contactado	El cliente ha sido contactado por algún medio (SMS, llamada telefónica, correo electrónico, etc.). 👉 Mientras se mantenga la comunicación con el cliente, el estado permanece como contactado.
unit_sold	La oportunidad de venta ha resultado en la venta de un vehículo.
abandonado	La oportunidad de venta se ha cerrado sin la venta de un vehículo.

Propiedades mapeadas vs sin procesar

Verá en la carga útil que tres de las propiedades tienen dos formatos:

Un formato BRP.

El formato de tu CRM.

Las tres propiedades en el formato de BRP son:

La propiedad source: de dónde se origina el lead.

La propiedad status.code: el estado del lead de venta.

La propiedad action.code: la acción tomada por el concesionario.

Para estas tres propiedades, tu CRM debe asignar sus valores internos a uno de los valores válidos para cada propiedad.

Para cada una de las propiedades, existe otra que se envía con el valor interno de tu CRM:

crm_source

status.crm_code

actions.crm_code

El objetivo de los dos formatos es que BRP analice rápidamente los datos, utilizando valores estandarizados para cada propiedad.

Sin embargo, en algunos casos, más de un valor en tu CRM puede asignarse al mismo valor de BRP.

Por ejemplo, el estado abandonado podría representar muchos estados diferentes de oportunidades de venta, como cerrado, cancelado, no show, etc.

Valor faltante para una propiedad

Si tu CRM no tiene la información para una propiedad, puedes establecer la propiedad según el tipo de propiedad:

String: una cadena vacía ("") o null.

Número: un valor nulo.

Fecha: un valor nulo.

Cuándo enviar

Su CRM debe enviar el registro de actividad del CRM diariamente, por ejemplo, al final del día laboral del concesionario o a una hora fija.

❗El registro de actividad del CRM se envía solo si el concesionario consiente compartir datos.

❗ Si no hay cambios en un lead de ventas, no lo envíe ❗

❗❗ Si no hay cambios en los leads de ventas realizados durante el día, no envíe un payload vacío, no llame a la API ❗❗

Referencia de API

Send CRM Activity Log

Send the sales opportunity activity log. Only for a CRM.

POST

/dsp/{dealer_no}/crm-activity

curl --location 'https://cloud-api.brp.com/dcp/v3/dsp/0000690095/crm-activity' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "items": [
        {
            "lead_id": "523452345346564",
            "sales_opportunity_id": "00Q6s000001TQcaEAG",
            "dealer_no": "0000691888",
            "customer_id": "1234567",
            "customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
            "source": "brp",
            "crm_source": "oem",
            "language": "en",
            "product_interest": {
                "category": "Watercraft",
                "model": "Spark",
                "brand": "seadoo_watercraft"
            },
            "status": [
                {
                    "code": "new",
                    "crm_code": "created",
                    "set_on": "2020-06-12T14:48:12Z"
                },
                {
                    "code": "contacted",
                    "crm_code": "active",
                    "set_on": "2020-06-13T14:48:12Z"
                }
            ],
            "comments": "I am looking for a specific color for this sea doo. I would like it black and white",
            "actions": [
                {
                    "code": "received",
                    "crm_code": "created",
                    "set_on": "2020-06-13T14:48:12Z",
                    "user_name": ""
                },
                {
                    "code": "opened",
                    "crm_code": "processed",
                    "set_on": "2020-06-13T14:59:12Z",
                    "user_name": "John Smith"
                },
                {
                    "code": "status changed",
                    "crm_code": "updated",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith"
                }
            ]
        }
    ]    
}'

Cómo hacerlo

Esta sección proporciona información sobre cómo obtener resultados específicos con la API.

Enviar registro de actividad del CRM

En este ejemplo, su CRM envía un registro de actividad para dos oportunidades de venta, una de BRP y otra creada en su CRM por el concesionario.

❗El registro de actividad del CRM se envía solo si el concesionario acepta compartir los datos.

❗ Si no hay cambios en un cliente potencial de ventas, no lo envíe ❗

❗❗ Si no hay cambios en los clientes potenciales de ventas realizados durante el día, no envíe una carga útil vacía, no llame a la API ❗❗

👉 En este ejemplo, se envía el historial completo del registro de actividad.

Send CRM Activity Log

curl --location 'https://qa-cloud-api.brp.com/dcp/v3/dsp/0000690095/crm-activity' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer VNFAyUxbLJcynBogyj5Q4o8wkdLg' \
--header 'Cookie: BrowserId=JpPoTqgdEe-njU30fg4qUA; CookieConsentPolicy=0:1; LSKey-c$CookieConsentPolicy=0:1' \
--data '{
    "items": [
        {
            "lead_id": "523452345346564",
            "sales_opportunity_id": "00Q6s000001TQcaEAG",
            "dealer_no": "0000691888",
            "customer_id": "1234567",
            "customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
            "source": "brp",
            "crm_source": "oem",
            "language": "en",
            "product_interest": {
                "category": "new",
                "model": "Spark",
                "brand": "seadoo_watercraft"
            },
            "status": [
                {
                    "code": "new",
                    "crm_code": "created",
                    "set_on": "2020-06-12T14:48:12Z"
                },
                {
                    "code": "contacted",
                    "crm_code": "active",
                    "set_on": "2020-06-13T14:48:12Z"
                }
            ],
            "comments": "I am looking for a specific color for this sea doo. I would like it black and white",
            "actions": [
                {
                    "code": "received",
                    "crm_code": "created",
                    "set_on": "2020-06-13T14:48:12Z",
                    "user_name": ""
                },
                {
                    "code": "opened",
                    "crm_code": "processed",
                    "set_on": "2020-06-13T14:59:12Z",
                    "user_name": "John Smith"
                },
                {
                    "code": "status changed",
                    "crm_code": "updated",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith"
                }
            ]
        },
        {
            "lead_id": "392487928374987",
            "sales_opportunity_id": "",
            "dealer_no": "0000691888",
            "customer_id": "34345",
            "customer_hash": "b25d0a94ad6707d044497e53f25f1991d7323d0864e7957ca22400aeae92ba7a",
            "source": "walk_in",
            "crm_source": "visit",
            "language": "en",
            "product_interest": {
                "category": "new",
                "model": "Mavrick",
                "brand": "canam_offroad"
            },
            "status": [
                {
                    "code": "new",
                    "crm_code": "created",
                    "set_on": "2020-06-12T14:48:12Z"
                },
                {
                    "code": "contacted",
                    "crm_code": "active",
                    "set_on": "2020-06-13T14:48:12Z"
                },
                {
                    "code": "unit_sold",
                    "crm_code": "sale",
                    "set_on": "2020-06-26T14:48:12Z"
                }
            ],
            "comments": "I have a Polaris unit for trade-in",
            "actions": [
                {
                    "code": "received",
                    "crm_code": "created",
                    "set_on": "2020-06-13T14:48:12Z",
                    "user_name": ""
                },
                {
                    "code": "opened",
                    "crm_code": "processed",
                    "set_on": "2020-06-13T14:59:12Z",
                    "user_name": "John Smith"
                },
                {
                    "code": "status changed",
                    "crm_code": "updated",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith"
                }                ,
                {
                    "code": "customer called",
                    "crm_code": "phone call",
                    "set_on": "2020-06-13T15:48:12Z",
                    "user_name": "John Smith"
                }
            ]
        }

    ]    
}   
'

Manejo de errores

Esta sección presenta varios escenarios de llamadas incorrectas que resultan en mensajes de error y resultados inexactos.

400 Solicitud Incorrecta

El código de estado 400 se encuentra típicamente durante el desarrollo y la integración, y no debería aparecer en operaciones normales. La respuesta devuelta contiene la información necesaria para corregir el problema.

Muchos problemas pueden causar un código de estado 400; los más comunes se encuentran en la tabla siguiente.

Respuesta	Resolución
Indicar que falta un campo obligatorio. { "status": "400", "id": "7acecbc0-7970-4505-86a7-fd6c48a5cc7c79012", "title": "bad_request", "meta": { "service": "01", "detail": "la validación de la solicitud falló", "payload": { "details": [ { "message": "[Path '/items/0'] El objeto tiene propiedades obligatorias faltantes ([\"sales_opportunity_id\"]): []" } ] } } }	Asegúrate de enviar todos los campos del payload.
El arreglo de estado está vacío. { "status": "400", "id": "f0bc7d7c-f043-42da-88d7-501a1c34938979852", "title": "bad_request", "meta": { "service": "01", "detail": "la validación de la solicitud falló", "payload": { "details": [ { "message": "[Path '/items/0/status'] El arreglo es demasiado corto: debe tener al menos 1 elemento pero tiene 0: []" } ] } } }	El payload debe incluir al menos un estado para cada oportunidad de venta.
El arreglo de acciones está vacío. { "status": "400", "id": "f0bc7d7c-f043-42da-88d7-501a1c34938979910", "title": "bad_request", "meta": { "service": "01", "detail": "la validación de la solicitud falló", "payload": { "details": [ { "message": "[Path '/items/0/actions'] El arreglo es demasiado corto: debe tener al menos 1 elemento pero tiene 0: []" } ] } } }	El payload debe incluir al menos una acción para cada oportunidad de venta.

401 No autorizado

El código de estado de error 401 No autorizado se devuelve cuando intentas llamar a la API con un access_token expirado.

Debes obtener un nuevo access_token con una llamada a la API de Autenticación de Aplicaciones.

El código de estado de error 401 No autorizado también se devuelve si no solicitaste acceso a la API creando un ticket en el Jira de DCP.

Cuando estés listo para comenzar a trabajar en una API, debes crear un ticket de certificación en Jira, como se describe en la sección Actividades de Certificación con Jira.

Si ya comenzaste a trabajar en una API y perdiste el acceso, crea un ticket de soporte como se describe en la sección Abrir un Ticket de Soporte.

413 Entidad de Solicitud Demasiado Grande

El código de estado 413 Request Entity Too Large se devuelve cuando la carga supera el límite de 10 MB de APIGee.

Tenga en cuenta que el código de estado 413 puede recibirse incluso si la carga que está enviando tiene menos de 10 MB. La carga se procesa y convierte antes de ser llamada por una API interna de BRP, y esta API interna puede devolver un código de estado 413.

Para corregir el problema, la única manera es dividir la carga en múltiples cargas. Debe definir el criterio que se utilizará para la división.

Requisitos DSP

Requisitos funcionales

ID	Tipo	Requisito
1	Obligatorio	El registro de actividades del CRM debe enviarse automáticamente diariamente, sin la intervención del concesionario.
2	Obligatorio	Su CRM debe llamar a la API de Información DSP para enviar una carga útil del registro de actividades del CRM para cada concesionario.
3	Obligatorio	Si no hay actividades del CRM para un concesionario, su CRM no debe enviar una carga útil del registro de actividades del CRM.

Actividades de certificación

Esta sección describe todas las actividades de certificación y validaciones necesarias para certificar la API.

Garantía de calidad

Las pruebas enumeradas en la tabla a continuación deben completarse exitosamente en el entorno de prueba antes de que pueda comenzar la fase piloto del concesionario.

ID	Prueba	Resultado esperado
1	Enviar un registro de actividad CRM para una oportunidad de ventas BRP	La propiedad sales_opportunity_id debe contener el ID de BRP.
2	Enviar un registro de actividad CRM para un prospecto de ventas creado en su CRM.	La propiedad sales_opportunity_id debe estar vacía.
3	Enviar registros de actividad CRM para un prospecto de ventas creado en su CRM, incluidas las acciones realizadas sobre el prospecto y los cambios de estado.	El registro de actividad CRM debe mostrar todas las acciones ejecutadas y los cambios de estado.

Piloto del distribuidor

La tabla a continuación describe los parámetros del piloto del distribuidor y sus validaciones correspondientes.

Parámetro	Valor
Entorno	Producción
Número de distribuidores	Todos sus distribuidores
Duración	2 semanas
Validación 1	El equipo DCP verifica que su CRM envía el registro de actividad diariamente.
Validación 2	Para uno o dos distribuidores, proporcione una muestra de 5 clientes potenciales de ventas enviados por BRP, junto con las acciones realizadas y los cambios de estado. La información debe proporcionarse en un formato legible para humanos. La información se compara con el registro de actividad del CRM enviado.
Validación 3	Para uno o dos distribuidores, proporcione una muestra de 5 clientes potenciales de ventas creados en su CRM (excluyendo los enviados por BRP), junto con las acciones realizadas y los cambios de estado. La información debe proporcionarse en un formato legible para humanos. La información se compara con el registro de actividad del CRM enviado.
Validación 4	Verifique que el customer_id y el customer_hash se proporcionen para la mayoría de los registros de actividad del CRM, y que la información enviada parezca válida.

Cartero

Esta sección describe lo que está disponible en Postman para explorar la API.

Entornos

Un entorno de Postman está disponible para probar la API de Dealers. Este entorno de Postman contiene variables utilizadas por las consultas y está configurado para conectarse al entorno de prueba.

Prueba - Entorno DSP

Colecciones

La colección CRM - CRM Activity Logs contiene ejemplos de llamadas API para enviar un registro de actividad CRM.

CRM - Registro de Actividad CRM

Registro de Cambios de la API

Revisión 1.0

Added

Primera versión