Recomendar Categorías

Endpoint

https://sellercenter-api.falabella.com/?Action=GetCategorySuggestion

Este endpoint es opcional y entrega una categoría recomendada en base al nombre de un producto. Úsalo como apoyo y valida siempre el resultado contra GetCategoryTree antes de publicar.

GETRecomendar Categorías

?Action=GetCategorySuggestion

curl -G "https://sellercenter-api.falabella.com/" \
  --data-urlencode "Action=GetCategorySuggestion" \
  --data-urlencode "Name=pantalones de trecking" \
  --data-urlencode "Format=XML" \
  --data-urlencode "Timestamp=2015-07-01T11:11+0000" \
  --data-urlencode "[email protected]" \
  --data-urlencode "Version=1.0" \
  --data-urlencode "Signature=1a497a8bc55c08b9c124ea3f23b1af44ec7f4a2a5f20e2eae9080d6db25f3c36"

Este endpoint es de uso opcional y entrega una categoría recomendada en base al nombre de un producto. Es un complemento útil dentro del flujo de creación de productos, pero no es obligatorio para completar el proceso. Se recomienda siempre contrastar la categoría sugerida contra el árbol de categorías disponible en el endpoint GetCategoryTree, para confirmar que la categoría recomendada existe, está vigente y es la más adecuada para tu producto antes de utilizarla.

Parámetros

Action

string

Requerido

Nombre de la función que se va a llamar. Obligatorio y debe ser 'GetCategorySuggestion' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory' (El parámetro Action es obligatorio). Si se proporciona una cadena de función desconocida, se devuelve un mensaje de error 'E008: Invalid Action' (Acción no válida). GetCategorySuggestion

Format

string

Opcional

Si se proporciona, debe ser 'JSON' o 'XML'. Si no se proporciona, se asume 'XML'. XML

Timestamp

date

Requerido

La hora actual en formato ISO8601 relativa a UTC (p. Ej., Marca de tiempo = 2015-04-01T10: 00: 00 + 02: 00 para Berlín), de modo que las llamadas no puedan ser reproducidas por un tercero que espíe (es decir, aquellas llamadas demasiado lejos en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se proporciona, aparece el mensaje de error 'E001: La marca de tiempo del parámetro es obligatoria'. Si la marca de tiempo es demasiado antigua o está en el futuro, se devuelve un mensaje de error "E003: Timestamp has expired" (Timestamp expiró).

UserID

string

Requerido

El ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web del Centro de vendedores en Configuración general / Administrar usuarios.

Version

string

Requerido

La versión de API contra la que se ejecutará esta llamada, en formato mayor-punto-menor. Actualmente debe ser 1.0, aunque la versión real de la API es 2.6.20. Si se omite, se devuelve un mensaje de error "E001: Parameter Version is mandatory" (El parámetro Version es obligatorio).

El cuerpo de la respuesta está compuesto por los siguientes atributos:

Nombre	Tipo	Descripción
Name	String	Título de la publicación consultada
CategoryId	Integer	Devuelve la categoría recomendada para el título entregado
CategoryName	String	Devuelve el nombre de la categoría recomendada para el título entregado

Respuesta 200

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
    <Head>
        <RequestId/>
        <RequestAction>getCategorySuggestion</RequestAction>
        <ResponseType>Category Suggestion</ResponseType>
        <Timestamp>2025-12-01T19:12:26-0300</Timestamp>
    </Head>
    <Body>
        <SuggestedCategory>
            <Name>pantalones de trecking</Name>
            <SuggestedCategory>G08020207</SuggestedCategory>
            <CategoryId>2748</CategoryId>
            <CategoryName>Prendas deportivas para la parte inferior del cuerpo</CategoryName>
        </SuggestedCategory>
    </Body>
</SuccessResponse>

Errores

Código de error	Mensaje	Mitigación
1000	E1000: Input Name Is Missing/Invalid