Saltar al contenido principal

Procesar publicaciones

Por webhook (recomendado)​

Suscribirse a los tópicos publication/create y publication/update. El webhook contendrá todo el objeto de publicación, producto, vendedor asociado y más, evitando la necesidad de hacer más API calls para obtener información de la publicación a procesar.

publication_notification.png

Por API​

Programar un proceso que consulte periódicamente publicaciones pendientes de sincronización usando el query-param toUpdate=1 y la paginación. Recomendado como método fallback de sincronización en caso de haber perdido notificaciones o querer destrabar casos específicos.

discover_publications.png

Indicar estado de sincronización​

Cuando una publicación fue procesada por el canal, ya sea de manera exitosa o fallida, debe informarlo a Fulljaus, para que le informemos al seller el estado de sincronización de esa publicación.

Los sellers ven en Fulljaus el estado de una publicación con un semáforo. Además, pueden ver un mensaje que envíe el canal en caso de que la sincronización haya fallado.

Es importante hacer este paso por varias razones:

  1. Transparencia con el seller. Sabe en todo momento si su catálogo está al día en el canal.
  2. Notificar problemas al seller. Si algo no estuvo bien y el seller debe corregirlo, mirará ahí, y podrá leer un mensaje que se espera provea instrucciones sobre qué corregir para avanzar.
  3. Evitar reprocesamiento. El filtro de publicaciones toUpdate funciona en base a esto, y evita que al procesar publicaciones aparezcan elementos ya procesados correctamente que no hayan tenido cambios.

La sincro de una publicación se indica usando el endpoint PATCH /v1/{marketplace_code}/publications/{id}:

require 'rest-client'

url = "https://marketplace.api.fulljaus.com/v1/acme/publications/95800"
headers = {
  Authorization: "Bearer aa4f19d8c7a26b4f2943ca606d91c5f64cf354fcddadebfc5a",
  Content_Type: :json
}

payload = {
  checksum: "e91347915e81731107c58a37b2dce7f230467f19faa945c7ad0f45453fd36589",
  to_update: true,
  error_at: "2025-01-30T17:30:00-03:00",
  published_at: "2025-01-30T17:30:00-03:00",
  synchronized_at: "2025-01-30T17:30:00-03:00",
  last_error_message: "Falta completar el título."
}

response = RestClient.patch(url, payload.to_json, headers)

Consideraciones operativas​

  • El atributo active de una publicación indica si el seller desea que el producto de la publicación se venda. Su valor en false indica que el producto NO se debe vender en el canal.
  • El canal debe validar si el seller está internamente habilitado antes de continuar con el procesamiento.
  • Los mensajes a mostrar al seller deben ser resumidos, no muy extensos.