Taxones

Son los subelementos que componen una taxonomía, los cuales pueden estar organizados jerárquicamente (múltiples niveles) para ofrecer una navegación organizada y/o filtros de búsqueda en el ecommerce. Los taxones son asociados a los productos a través del campo (taxon_ids) del método de productos.

Ejemplo de taxonomías y taxones

Listar taxones de una taxonomía

GET https://tiendagoshop.com/api/v1/taxonomies/:taxonomy_id/taxons

Path Parameters

Name	Type	Description
taxonomy_id	integer	ID de la taxonomía asociada al taxón

Query Parameters

Name	Type	Description
q[name_cont]	string	Nombre del taxón (en GoShop) – string
q[ext_id_cont]	string	ID externo del taxón (en sistema externo) – string
q[ext_name_cont]	string	Nombre externo del taxón (en sistema externo) – string

Headers

Name	Type	Description
X-Spree-Token	string	Token generado desde el CMS de GS

200

{
  "taxons": [
    {
      "id": 472,
      "name": "Brenwood",
      "pretty_name": "Marcas -> Brenwood",
      "permalink": "marcas/brenwood",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 481,
      "name": "Stretch film",
      "pretty_name": "Marcas -> Stretch film",
      "permalink": "marcas/stretch-film",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 482,
      "name": "Formül",
      "pretty_name": "Marcas -> Formül",
      "permalink": "marcas/formul",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 483,
      "name": "Mangos escobas/suapers",
      "pretty_name": "Marcas -> Mangos escobas/suapers",
      "permalink": "marcas/mangos-escobas-slash-suapers",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 484,
      "name": "Goliat",
      "pretty_name": "Marcas -> Goliat",
      "permalink": "marcas/goliat",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 485,
      "name": "Energizer",
      "pretty_name": "Marcas -> Energizer",
      "permalink": "marcas/energizer",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 486,
      "name": "Universal notes",
      "pretty_name": "Marcas -> Universal notes",
      "permalink": "marcas/universal-notes",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 473,
      "name": "Esseti",
      "pretty_name": "Marcas -> Esseti",
      "permalink": "marcas/esseti",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 474,
      "name": "P.t. wide",
      "pretty_name": "Marcas -> P.t. wide",
      "permalink": "marcas/pt-wide",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 475,
      "name": "Rayen",
      "pretty_name": "Marcas -> Rayen",
      "permalink": "marcas/rayen",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 476,
      "name": "Fiplasto",
      "pretty_name": "Marcas -> Fiplasto",
      "permalink": "marcas/fiplasto",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 477,
      "name": "Soga rafia",
      "pretty_name": "Marcas -> Soga rafia",
      "permalink": "marcas/soga-rafia",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 478,
      "name": "Clavos de zinc",
      "pretty_name": "Marcas -> Clavos de zinc",
      "permalink": "marcas/clavos-de-zinc",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 479,
      "name": "Clavos galvanizados",
      "pretty_name": "Marcas -> Clavos galvanizados",
      "permalink": "marcas/clavos-galvanizados",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 480,
      "name": "Papel de aluminio",
      "pretty_name": "Marcas -> Papel de aluminio",
      "permalink": "marcas/papel-de-aluminio",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 487,
      "name": "Alianca",
      "pretty_name": "Marcas -> Alianca",
      "permalink": "marcas/alianca",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 488,
      "name": "Star light",
      "pretty_name": "Marcas -> Star light",
      "permalink": "marcas/star-light",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 489,
      "name": "Cloro",
      "pretty_name": "Marcas -> Cloro",
      "permalink": "marcas/cloro",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 490,
      "name": "Zinc acanalado",
      "pretty_name": "Marcas -> Zinc acanalado",
      "permalink": "marcas/zinc-acanalado",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 491,
      "name": "Cemento blanco",
      "pretty_name": "Marcas -> Cemento blanco",
      "permalink": "marcas/cemento-blanco",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 492,
      "name": "Induplastic",
      "pretty_name": "Marcas -> Induplastic",
      "permalink": "marcas/induplastic",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 493,
      "name": "Fortigas",
      "pretty_name": "Marcas -> Fortigas",
      "permalink": "marcas/fortigas",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 494,
      "name": "Frotas criollas",
      "pretty_name": "Marcas -> Frotas criollas",
      "permalink": "marcas/frotas-criollas",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 495,
      "name": "Alambres mosquito",
      "pretty_name": "Marcas -> Alambres mosquito",
      "permalink": "marcas/alambres-mosquito",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    },
    {
      "id": 496,
      "name": "Espejos de baño",
      "pretty_name": "Marcas -> Espejos de baño",
      "permalink": "marcas/espejos-de-bano",
      "parent_id": 471,
      "taxonomy_id": 2,
      "meta_title": null,
      "meta_description": null,
      "taxons": []
    }
  ],
  "count": 25,
  "total_count": 273,
  "current_page": 1,
  "per_page": 25,
  "pages": 11
}

Obtener un taxón

GET https://tiendagoshop.com/api/v1/taxonomies/:taxonomy_id/taxons/:id

Path Parameters

Name	Type	Description
id	integer	ID del taxón.
taxonomy_id	integer	ID de la taxonomía asociada al taxón.

Headers

Name	Type	Description
X-Spree-Token	string	Token generado desde el CMS de GS

200

{
   "taxons":[
      {
         "id":1,
         "name":"Categorías",
         "pretty_name":"Categorías",
         "permalink":"categorias",
         "parent_id":null,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            {
               "id":8,
               "name":"Comida",
               "pretty_name":"Categorías -\u003e Comida",
               "permalink":"categorias/comida",
               "parent_id":1,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  {
                     "id":9,
                     "name":"Carnes",
                     "pretty_name":"Categorías -\u003e Comida -\u003e Carnes",
                     "permalink":"categorias/comida/carnes",
                     "parent_id":8,
                     "taxonomy_id":1,
                     "meta_title":null,
                     "meta_description":null,
                     "taxons":[
                        
                     ]
                  }
               ]
            },
            {
               "id":5,
               "name":"Categ uno",
               "pretty_name":"Categorías -\u003e Categ uno",
               "permalink":"categorias/categ-uno",
               "parent_id":1,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  
               ]
            },
            {
               "id":6,
               "name":"Categ dos",
               "pretty_name":"Categorías -\u003e Categ dos",
               "permalink":"categorias/categ-dos",
               "parent_id":1,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  
               ]
            },
            {
               "id":7,
               "name":"Ropa",
               "pretty_name":"Categorías -\u003e Ropa",
               "permalink":"categorias/ropa",
               "parent_id":1,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  {
                     "id":10,
                     "name":"Camisetas",
                     "pretty_name":"Categorías -\u003e Ropa -\u003e Camisetas",
                     "permalink":"categorias/ropa/camisetas",
                     "parent_id":7,
                     "taxonomy_id":1,
                     "meta_title":null,
                     "meta_description":null,
                     "taxons":[
                        
                     ]
                  }
               ]
            },
            {
               "id":16,
               "name":"Maquillaje",
               "pretty_name":"Categorías -\u003e Maquillaje",
               "permalink":"categorias/maquillaje",
               "parent_id":1,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  
               ]
            }
         ]
      },
      {
         "id":10,
         "name":"Camisetas",
         "pretty_name":"Categorías -\u003e Ropa -\u003e Camisetas",
         "permalink":"categorias/ropa/camisetas",
         "parent_id":7,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            
         ]
      },
      {
         "id":8,
         "name":"Comida",
         "pretty_name":"Categorías -\u003e Comida",
         "permalink":"categorias/comida",
         "parent_id":1,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            {
               "id":9,
               "name":"Carnes",
               "pretty_name":"Categorías -\u003e Comida -\u003e Carnes",
               "permalink":"categorias/comida/carnes",
               "parent_id":8,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  
               ]
            }
         ]
      },
      {
         "id":9,
         "name":"Carnes",
         "pretty_name":"Categorías -\u003e Comida -\u003e Carnes",
         "permalink":"categorias/comida/carnes",
         "parent_id":8,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            
         ]
      },
      {
         "id":5,
         "name":"Categ uno",
         "pretty_name":"Categorías -\u003e Categ uno",
         "permalink":"categorias/categ-uno",
         "parent_id":1,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            
         ]
      },
      {
         "id":6,
         "name":"Categ dos",
         "pretty_name":"Categorías -\u003e Categ dos",
         "permalink":"categorias/categ-dos",
         "parent_id":1,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            
         ]
      },
      {
         "id":7,
         "name":"Ropa",
         "pretty_name":"Categorías -\u003e Ropa",
         "permalink":"categorias/ropa",
         "parent_id":1,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            {
               "id":10,
               "name":"Camisetas",
               "pretty_name":"Categorías -\u003e Ropa -\u003e Camisetas",
               "permalink":"categorias/ropa/camisetas",
               "parent_id":7,
               "taxonomy_id":1,
               "meta_title":null,
               "meta_description":null,
               "taxons":[
                  
               ]
            }
         ]
      },
      {
         "id":16,
         "name":"Maquillaje",
         "pretty_name":"Categorías -\u003e Maquillaje",
         "permalink":"categorias/maquillaje",
         "parent_id":1,
         "taxonomy_id":1,
         "meta_title":null,
         "meta_description":null,
         "ext_id":null,
         "ext_name":null,
         "taxons":[
            
         ]
      }
   ],
   "count":8,
   "total_count":8,
   "current_page":1,
   "per_page":25,
   "pages":1
}

Guardar un taxón

POST https://tiendagoshop.com/api/v1/taxonomies/:taxonomy_id/taxons

Path Parameters

Name	Type	Description
taxonomy_id	integer	ID de la taxonmía asociada al taxón.

Headers

Name	Type	Description
X-Spree-Token	string	Token generado desde el CMS de GS

Request Body

Name	Type	Description
name	string	Nombre del taxón.
id	integer	ID del taxón.
parent_id	integer	ID del taxón padre.
description	string	Descripción del taxón.
ext_id	string	ID externo del taxón (el identificador único que tenga asignado en el sistema externo ya que será distinto al de GoShop y de esta forma queda mapeado).
ext_name	string	Nombre externo del taxón (el nombre que tenga asignado en el sistema externo, el cual puede ser distinto al utilizado en GoShop).
show_in_megamenu	boolean	Mostrar en megamenú principal de la parte pública.
show_in_filters	boolean	Mostrar en filtros laterales de búsqueda de productos.
show_in_header	boolean	Mostrar en menú principal de la parte pública.

200

{
  "id": 6,
  "name": "Taxonomia tres",
  "root": {
    "id": 751,
    "name": "Taxonomia tres",
    "pretty_name": "Taxonomia tres",
    "permalink": "taxonomia-tres",
    "parent_id": null,
    "taxonomy_id": 6,
    "meta_title": null,
    "meta_description": null,
    "taxons": []
  }
}

Modificar un taxón

PUT https://tiendagoshop.com/api/v1/taxonomies/:taxonomy_id/taxons/:id

Path Parameters

Name	Type	Description
id	integer	ID de la taxonmía asociada al taxón.
taxonomy_id	integer	ID de la taxonmía asociada al taxón.

Headers

Name	Type	Description
X-Spree-Token	string	Token generado desde el CMS de GS

Request Body

Name	Type	Description
name	string	Nombre del taxón.
parent_id	integer	ID del taxón padre.
description	string	Descripción del taxón.
ext_id	string	ID externo del taxón (el identificador único que tenga asignado en el sistema externo ya que será distinto al de GoShop y de esta forma queda mapeado).
ext_name	string	Nombre externo del taxón (el nombre que tenga asignado en el sistema externo, el cual puede ser distinto al utilizado en GoShop).
show_in_megamenu	boolean	Mostrar en megamenú principal de la parte pública.
show_in_filters	boolean	Mostrar en filtros laterales de búsqueda de productos.
show_in_header	boolean	Mostrar en menú principal de la parte pública.

200

{
  "id": 3,
  "name": "Taxonomia prueba editada",
  "root": {
    "id": 745,
    "name": "Taxonomia prueba editada",
    "pretty_name": "Taxonomia prueba editada",
    "permalink": "test-222",
    "parent_id": null,
    "taxonomy_id": 3,
    "meta_title": null,
    "meta_description": null,
    "taxons": [
      {
        "id": 746,
        "name": "Test taxon",
        "pretty_name": "Taxonomia prueba editada -> Test taxon",
        "permalink": "test-222/test-taxon",
        "parent_id": 745,
        "taxonomy_id": 3,
        "meta_title": null,
        "meta_description": null
      },
      {
        "id": 748,
        "name": "Taxon de prueba",
        "pretty_name": "Taxonomia prueba editada -> Taxon de prueba",
        "permalink": "test-222/taxon-de-prueba",
        "parent_id": 745,
        "taxonomy_id": 3,
        "meta_title": null,
        "meta_description": null
      }
    ]
  }
}

Eliminar un taxón

DELETE https://tiendagoshop.com/api/v1/taxonomies/:taxonomy_id/taxons/:id

Path Parameters

Name	Type	Description
id	integer	ID del taxón
taxonomy_id	integer	ID de la taxonmía asociada al taxón.

Headers

Name	Type	Description
X-Spree-Token	string	Token generado desde el CMS de GS

200