Asociación LINE_ITEM a DEAL desde Ecommerce Bridge

Smart CRM & Sales Hub CRM
1

Hola, estamos trabajando con la sincronización a través del Api de Ecommerce bridge. Tras la carga nos hemos dado cuenta de que existen muchos DEALS que no tienen LINE_ITEM asociado y tras verificar con estos endpoints que los datos estan subidos al ecommerce, y que existen los external_object_id para poder hacer las asociaciones os dejo ejemplos:

https://api.hubapi.com/extensions/ecomm/v2/sync/status/ecommercebridge-tienda-sepin/LINE_ITEM/PL-350816?hapikey=**************

https://api.hubapi.com/extensions/ecomm/v2/sync/status/ecommercebridge-tienda-sepin/DEAL/P-95967?hapikey=************************

Volvemos a lanzar la sincronizacion de un ejemplo en concreto de LINE_ITEM y la asociación no se lleva a cabo. ENDPOINT: PUT https://api.hubapi.com/extensions/ecomm/v2/sync/messages?hapikey=*******

JSON:

{ “storeId”:“ecommercebridge-tienda-sepin”,

“objectType”:“LINE_ITEM”,

“messages”:[ {

“action”:“UPSERT”,

“externalObjectId”:“PL-350816”,

“properties”:

{

“activo”:true,

“precio”:“60”,

“cantidad”:“1”,

“porcentaje_descuento”:“”,

“descuento”:“”,

“frecuencia”:“”

},

“associations”:

{

“DEAL”:[ “P-95967” ],

“PRODUCT”:[ “Producto-1550” ]

}

} ] }

Podeis ayudarme, estoy desesperada por que no encuentro una logica de porque esto no esta funcionando, y el api no devuelve errores.

Gracias

Un saludo

2

Hola, @GCotrina:

¡Encantado de saludarte! En primer lugar, es recomendable no compartir el API Key para evitar problemas de seguridad. Pese a que ha sido sustituida por asteriscos en el texto del mensaje, es posible ver ese dato al pulsar en los enlaces. Si es la API Key que estás utilizando todavía, sería aconsejable generar una nueva para prevenir inconvenientes.

Parece que tu llamada es correcta y no hemos podido detectar problemas. Ten en cuenta que siempre existe una demora entre la creación del Deal y la asociación, pero parece que el Deal ha sido ya creado en tu sistema por lo que debería producirse la asociación.

Dicho esto, nos gustaría verificar que no se devuelven errores al realizar la llamada. Si accedes a esta URL, ¿ves algún error?

https://api.hubapi.com/extensions/ecomm/v2/sync/errors/app/NNN_YOUR_APP_ID_NNN?hapikey=YOUR_API_KEY

Quedo atento a tus comentarios.

Saludos,

3

Hola @ajubete , gracias por tu respuesta. Ya he modificado mi ApiKey para evitar problemas.

En cuanto a lo que me indicas, no consigo que dicha url me funcione.

He cambiado donde pones en la url NNN_YOUR_APP_ID_NNN el valor de mi ID de aplicacion de Hubspot y el nuevo ApiKey generado. Que lo he probado con otros endppoints y funciona perfectamente.

Y el resultado de mi llamada es este:

This hapikey has not authorized the required scopes to complete this action

Estoy lanzando bien la url??

Gracias

4

Hola, @GCotrina :

Gracias por la información adicional. Es posible que la API Key que estás utilizando no sea la correcta y de ahí ese mensaje de error. ¿Podrías confirmar que estás utilizando la API Key del portal de desarrollador? (Developer API Key). Puedes encontrala en tu portal de Desarrollador > Apps (esquina superior derecha).

También sería posible utilizar la API Key del portal en el que estás creando los objetos, pero tendríamos que usar otro endpoint: https://api.hubapi.com/extensions/ecomm/v2/sync/errors/portal?hapikey=

Dicho esto, nos llama la atención las propiedades utilizadas en los Line Items, ¿podrías confirmar que existen? Puedes recuperar esas propiedades a través del endpoint V2 o V3.

Si no hay errores y las propiedades de los line items existen, ¿podrías pasarnos el JSON de un negocio, producto y line item?

Un saludo,

5

Gracias por la información. Efectivamnte el EndPoint que yo habia cheakeado era este:

https://api.hubapi.com/extensions/ecomm/v2/sync/errors/portal?hapikey= en el obtengo errores pero es un historico de errores donde el ultimo se produjo el dia 4 de marzo. Te pego pantallazo para que veas que el timespam que devuelve es de dicha fecha.

GCotrina_0-1646929791051.png
GCotrina_0-1646929791051.png1347×754 93.5 KB

En cuanto a las propiedades del line_item comprobado que existen y de hecho te muestro el mapeo de todas las propiedades que ejecuto para mi Ecommerce Bridge.

{

“enabled”:true,

“webhookUri”:null,

“mappings”:{

  "CONTACT":{

     "properties":\[

        {

           "externalPropertyName":"nombre",

           "hubspotPropertyName":"firstname",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"email",

           "hubspotPropertyName":"email",

           "dataType":"STRING"

        }

     ]

  },

  "DEAL":{

     "properties":\[

        {

           "externalPropertyName":"nombre\_pedido",

           "hubspotPropertyName":"dealname",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"fecha\_creacion",

           "hubspotPropertyName":"createdate",

           "dataType":"DATETIME"

        },

        {

           "externalPropertyName":"fecha\_cierre",

           "hubspotPropertyName":"closedate",

           "dataType":"DATETIME"

        },

        {

            "externalPropertyName": "fecha\_inicio\_vigencia",

            "hubspotPropertyName":"fecha\_inicio\_vigencia",

            "dataType":"DATETIME"

        },

        {

            "externalPropertyName": "fecha\_fin\_vigencia",

            "hubspotPropertyName":"fecha\_fin\_vigencia",

            "dataType":"DATETIME"

        },

        {

           "externalPropertyName":"activo\_deal",

           "hubspotPropertyName":"activo\_deal",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"importe\_total",

           "hubspotPropertyName":"amount",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"estado",

           "hubspotPropertyName":"dealstage",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"estado\_sage",

           "hubspotPropertyName":"estado\_sage",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"url\_carrito\_abandonado",

           "hubspotPropertyName":"ip\_\_ecomm\_bride\_\_abandoned\_cart\_url",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"id\_acuerdo",

           "hubspotPropertyName":"id\_acuerdo",

           "dataType":"STRING"

        }

     ]

  },

  "PRODUCT":{

     "properties":\[

        {

           "externalPropertyName":"nombre\_producto",

           "hubspotPropertyName":"name",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"subtitulo",

           "hubspotPropertyName":"frase\_mkt",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"descripcion",

           "hubspotPropertyName":"description",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"id\_pto",

           "hubspotPropertyName":"id\_producto",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"url\_imagen",

           "hubspotPropertyName":"ip\_\_ecomm\_bridge\_\_image\_url",

           "dataType":"AVATAR\_IMAGE"

        },

        {

           "externalPropertyName":"precio\_tarifa",

           "hubspotPropertyName":"hs\_price\_eur",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"iva",

           "hubspotPropertyName":"iva",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"app\_relacionadas",

           "hubspotPropertyName":"pto\_rel\_app",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"activo\_venta",

           "hubspotPropertyName":"activo\_venta",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"sin\_gastos\_envio",

           "hubspotPropertyName":"sin\_gastos\_de\_envio",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"disponible\_promocion",

           "hubspotPropertyName":"disponible\_promocion",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"autor",

           "hubspotPropertyName":"autor\_mkt",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"indice",

           "hubspotPropertyName":"indice",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"indice\_cuaderno",

           "hubspotPropertyName":"indice\_cj",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"isbn",

           "hubspotPropertyName":"isbn",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"issn",

           "hubspotPropertyName":"issn",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"num\_paginas",

           "hubspotPropertyName":"numero\_de\_paginas",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"coleccion",

           "hubspotPropertyName":"coleccion",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"editorial",

           "hubspotPropertyName":"editorial",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"mes\_publicacion",

           "hubspotPropertyName":"mes\_publicacion",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"ano\_publicacion",

           "hubspotPropertyName":"ano\_publicacion",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"fecha\_hora\_curso",

           "hubspotPropertyName":"fecha\_hora\_curso",

           "dataType":"STRING"

        }

     ]

  },

  "LINE\_ITEM":{

     "properties":\[

        {

           "externalPropertyName":"activo",

           "hubspotPropertyName":"activo",

           "dataType":"STRING"

        },

        {

           "externalPropertyName":"precio",

           "hubspotPropertyName":"price",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"cantidad",

           "hubspotPropertyName":"quantity",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"descuento",

           "hubspotPropertyName":"discount",

           "dataType":"NUMBER"

        },

        {

           "externalPropertyName": "porcentaje\_descuento",

            "hubspotPropertyName": "hs\_discount\_percentage",

            "dataType":"NUMBER"

        },

        {

           "externalPropertyName":"frecuencia",

           "hubspotPropertyName":"recurringbillingfrequency",

           "dataType":"STRING"

        }

     ]

  }

}

}

Una vez lanzado el mapeo de las propiedades te paso un ejemplo de un DEAL, LINE_ITEM y PRODUCTO:

{

“storeId”: “ecommercebridge-tienda-sepin”,

“objectType”: “PRODUCT”,

“messages”: [

{

  "action":"UPSERT",

    "externalObjectId":"Producto-1550",

    "properties":{

        "nombre\_producto":"FORMULARIOS PROCESALES USB 2016",

        "subtitulo":"Colección de más de 1.000 formularios actualizados en formato USB",

        "descripcion":"La Editorial Jurídica Sepín, tras un año de profundas modificaciones legislativas en toda las leyes procesales, pone a disposición de los profesionales del Derecho su COLECCIÓN DE FORMULARIOS PROCESALES EN FORMATO PEN DRIVE. Un producto que por su indiscutible utilidad y mínimo precio está teniendo una enorme acogida en el sector",

        "id\_pto":"1550",

        "url\_producto":"[https://www.sepin.es/tienda-online/articulo/articulo.aspx?id\_articulo=1550](https://www.sepin.es/tienda-online/articulo/articulo.aspx?id_articulo=1550)",

        "url\_imagen":"[https://www.sepin.es/tienda-online/comunes/manejadores/imagen-articulo.ashx?id\_articulo=1550](https://www.sepin.es/tienda-online/comunes/manejadores/imagen-articulo.ashx?id_articulo=1550)",

        "precio\_producto":"60",

        "precio\_tarifa":"60",

        "iva":"4",

        "app\_relacionadas":"Procesal Civil;Formularios jurídicos;Formularios",

        "activo\_venta":false,

        "sin\_gastos\_envio":false,

        "disponible\_promocion":false,

        "autor":"",

        "indice":"",

        "indice\_cuaderno":"",

        "isbn":"",

        "issn":"",

        "num\_paginas":"",

        "coleccion":"USB",

        "editorial":"SEPIN",

        "mes\_publicacion":"2",

        "año\_publicacion":"2016",

        "fecha\_hora\_curso":""

     }

}

]

}

DEAL: en este JSON asocio un contacto creado a través de Ecommerce Bridge

{

“storeId”:“ecommercebridge-tienda-sepin”,

“objectType”:“DEAL”,

“messages”:[

  {

     "action":"UPSERT",

     "changedAt":null,

     "externalObjectId":"P-95967",

     "properties":{

        "nombre\_pedido":"P-95967",

        "fecha\_creacion":"1645722271000",

        "fecha\_cierre":"1645722271000",

        "fecha\_inicio\_vigencia":"1645722271000",

        "fecha\_fin\_vigencia":"1645722271000",

        "importe\_total":"60",

        "activo\_deal":true,

        "estado":"checkout\_pending",

        "estado\_sage":"Tramitado",

        "url\_carrito\_abandonado":"",

        "id\_acuerdo":""

     },

    "associations": {

        "CONTACT": \[

        "marchena@sepin.es"

        ]

    }

  }

]

}

LINE_ITEM: asocio el deal y el producto antes creado

{ “storeId”:“ecommercebridge-tienda-sepin”,

“objectType”:“LINE_ITEM”,

“messages”:[ {

          "action":"UPSERT",

          "externalObjectId":"PL-350816",

          "properties":

           {

                    "activo":true,

                     "precio":"60",

                     "cantidad":"1",

                     "porcentaje\_descuento":"",

                     "descuento":"",

                     "frecuencia":""

            },

             "associations":

              {

                        "DEAL":\[ "P-95967" ],

                        "PRODUCT":\[ "Producto-1550" ]

              }

} ] }

Gracias

Un saludo

6

Hola, @GCotrina :

Perdona, no vi el mensaje antes. Incluye una mención a mi usuario cuando respondas para que pueda estar al tanto de la nueva información.

Hemos mirado el código y parece que todo es correcto, no sabría decirte dónde se origina el error. Nos gustaría conocer un detalle más. El error que has encontrado, ¿afecta siempre a los mismos productos/line items? Entendemos que no todos los negocios presentan el error y que solo se produce en ciertas ocasiones.

Si solo hay un puñado de productos que no son asociados correctamente, ¿podrías comprobar sus Source Store y SKU? Podría ser que algunos productos no estén asociados a la tienda actual y que al realizar la llamada el sistema no pueda recuperarlos.

Saludos,

7

Hola @ajubete , los errores que me devuelve el endpoint como bien dices no siempre afectan al mismo DEAL, ni a los mismos LINE_ITEM, de hecho como te mostraba en el pantallazo los errores relacionados con DEALS que devulve ya estan solventados. Eran errores de asociación con el CONTACTO, y esto era porque no se habian cargado como contactos a traves del Ecommerce Bridge y carecian de external_object_id para poder asociar.

En cuanto a los errores que aparacen relacionados con LINE_ITEM, tb estan solventados. Muchos de ellos tb eran problemas de asociacion con el DEAL pero que hoy por hoy dicho DEAL ya existe. Eso fue lo primero que mire que estuviesen creados y tuvieran un external_object_id ya que es el identificador por el cual se produce la asociación.

En cuanto a los productos revisaré lo que me indicas para el resto de productos asociados a line_items que no se asocian, pero para el del ejemplo que te pase, todo esta correcto en la biblioteca de productos, y al lanzar este endpoint me devuelve un error, que tb tiene un timespan antiguo, y ya esta solucionado.

GCotrina_0-1647274831309.png
GCotrina_0-1647274831309.png1455×698 84.4 KB

Luego todo parece correcto pero sin embargo el DEAL aparece sin lineas de pedido asociadas.

No entiendo nada, que puede estar pasando?? Como ves de ahi mi desesperación.

Gracias

Un saludo

8

Hola @ajubete , has podido mirar algo de lo que te puse en el mensaje anterior? Me sigue pasando lo mismo y estamos bloqueados con esto, porque tengo una lista importante de Deals a los que no se les asocia Line_Items. Si pudieses echarme un cable te lo agradeceria.

Gracias

Saludos

9

Hola, @GCotrina:

No hemos encontrado nada incorrecto en los datos que estás pasando hacia HubSpot y las asociaciones deberían producirse correctamente. Es curioso que no falle en todos los casos, solo en algunos. De ahí que mencionásemos que ciertos productos pudiesen estar asociados a una tienda incorrecta o que existiese algún problema con el SKU.

Parece que has descartado ese tipo de problemas. Dicho esto, no disponemos de información adicional para conocer la causa del problema. La consola de errores de la app suele devolver información relevante a la hora de conocer qué ha pasado y por qué no se ha realizado la asociación, pero en este caso también parece que no hay mensajes de error relacionados con la falta de asociación de los line items con los negocios.

Siento no poder ofrecer una solución a tu caso. Quizá puedas obtener más detalles sobre el problema a través del Servicio de Atención al Cliente de HubSpot.

Un saludo,

10

Hola @ajubete:

Efectivamente eso es lo extraño de todo esto, que unos DEALS si tengan sus lineas asociadas y otros no, cuando el proceso de carga es masivo y en bloques de 200 mensajes como pone en la documentación, luego en cuanto a estructura es correcto. Pense en la sincronizacion que esto fuese un problema pero tampoco porque cuando ejecutamos manualmente en potsman el ejemplo que te pase, con previa confirmación de que el producto este bien cargado sigue sin hacer nada, aparentemente no genera errores, luego la sistaxis esta bien pero el proceso no se lleva a cabo. En fin, bueno espero que el servicio técnico de Hubspot pueda darnos una solución.

Muchas gracias por tu tiempo y por la ayuda aportada.

Saludos

Gemma