Publicaciones

🔹 Índice de publicaciones

Consulta: GET /v1/{marketplace_code}/publications

Parámetros:

Nombre	Descripción	Valores permitidos	Comentarios
seller	ID del vendedor		Si no se envía se devuelven las publicaciones de todos los vendedores
to_update	Publicaciones con novedades	true | false	Si no se envía se devuelven todas las publicaciones
order_by	Orden	Ver abajo

Uso del parámetro order_by:

Permite elegir el atributo por el cual ordenar y el orden de aparición de las entidades. Tiene el formato {atributo}:{orden}.

• Atributos disponibles:
  • created_at: Fecha de creación.
  • updated_at: Fecha de la última actualización.
  • synchronized_at: Fecha de la última sincronización.
  • error_at: Fecha del último error.
• Órdenes disponibles:
  • ASC: Ascendente.
  • DESC: Descendente.

Ejemplo de uso:

Se deben enviar ambas partes del formato {atributo}:{orden}.

# ✔️ Uso válido
order_by=creation_date:ASC

# ❌ Uso inválido
order_by=creation_date

# ❌ Uso inválido
order_by=ASC

Errores:

Evento	Código HTTP
No respetar el formato esperado de algún parámetro	400

Respuesta:

Código HTTP: 200

{
  // Publications Index
}

🔹 Obtener una publicación

Consulta: GET /v1/{marketplace_code}/publications/{id}

Respuesta:

Código HTTP: 200

{
  // Publications Show
}

🔹 Actualizar una publicación

Consulta: PATCH /v1/{marketplace_code}/publications/{id}

Campos actualizables:

Nombre	Descripción	Tipo de dato	Obligatorio
checksum	Checksum de la publicación	String
to_update	Si la publicación tiene novedades	Boolean
error_at	Fecha del último error	Date	Ver abajo
published_at	Fecha de publicación	Date
synchronized_at	Fecha de última sincronización	Date
last_error_message	Último mensaje de error	String	Ver abajo

Aclaraciones:

• Los campos error_at y last_error_message se vuelven obligatorios si se envía al menos uno de los dos, es decir que se deberá enviar ambos o ninguno.

Ejemplo de payload para la consulta:

{
  "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."
}

Respuesta:

Código HTTP: 200

Devuelve la entidad actualizada.