Taxonomías

Son las distintas agrupaciones que se necesiten para catalogar los productos en el ecommerce. Algunos ejemplos de taxonomías habituales son: Categorías, Marcas, Departamentos, etc. Cada taxonomía está compuesta por taxones.

Listar taxonomías

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

Headers

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

200

{
  "taxonomies": [
    {
      "id": 1,
      "name": "Departamentos",
      "root": {
        "id": 1,
        "name": "Departamentos",
        "pretty_name": "Departamentos",
        "permalink": "categorias",
        "parent_id": null,
        "taxonomy_id": 1,
        "meta_title": null,
        "meta_description": null,
        "taxons": [
          {
            "id": 2,
            "name": "Automotriz",
            "pretty_name": "Departamentos -> Automotriz",
            "permalink": "departamentos/automotriz",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 8,
            "name": "Jardinería y agricultura",
            "pretty_name": "Departamentos -> Jardinería y agricultura",
            "permalink": "departamentos/jardineria-y-agricultura",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 3,
            "name": "Baños",
            "pretty_name": "Departamentos -> Baños",
            "permalink": "departamentos/banos",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 4,
            "name": "Cerrajería",
            "pretty_name": "Departamentos -> Cerrajería",
            "permalink": "departamentos/cerrajeria",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 5,
            "name": "Eléctricos",
            "pretty_name": "Departamentos -> Eléctricos",
            "permalink": "departamentos/electricos",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 6,
            "name": "Herramientas y maquinarias",
            "pretty_name": "Departamentos -> Herramientas y maquinarias",
            "permalink": "departamentos/herramientas-y-maquinarias",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 7,
            "name": "Hogar",
            "pretty_name": "Departamentos -> Hogar",
            "permalink": "departamentos/hogar",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 9,
            "name": "Pintura",
            "pretty_name": "Departamentos -> Pintura",
            "permalink": "departamentos/pintura",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 10,
            "name": "Plomería",
            "pretty_name": "Departamentos -> Plomería",
            "permalink": "departamentos/plomeria",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 11,
            "name": "Seguridad industrial",
            "pretty_name": "Departamentos -> Seguridad industrial",
            "permalink": "departamentos/seguridad-industrial",
            "parent_id": 1,
            "taxonomy_id": 1,
            "meta_title": null,
            "meta_description": null
          }
        ]
      }
    },
    {
      "id": 2,
      "name": "Marcas",
      "root": {
        "id": 471,
        "name": "Marcas",
        "pretty_name": "Marcas",
        "permalink": "marcas",
        "parent_id": null,
        "taxonomy_id": 2,
        "meta_title": null,
        "meta_description": null,
        "taxons": [
          {
            "id": 680,
            "name": "Yanex",
            "pretty_name": "Marcas -> Yanex",
            "permalink": "marcas/yanex",
            "parent_id": 471,
            "taxonomy_id": 2,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 681,
            "name": "Fortex",
            "pretty_name": "Marcas -> Fortex",
            "permalink": "marcas/fortex",
            "parent_id": 471,
            "taxonomy_id": 2,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 682,
            "name": "Foset",
            "pretty_name": "Marcas -> Foset",
            "permalink": "marcas/foset",
            "parent_id": 471,
            "taxonomy_id": 2,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 683,
            "name": "Pretul",
            "pretty_name": "Marcas -> Pretul",
            "permalink": "marcas/pretul",
            "parent_id": 471,
            "taxonomy_id": 2,
            "meta_title": null,
            "meta_description": null
          },
          {
            "id": 684,
            "name": "Hermex",
            "pretty_name": "Marcas -> Hermex",
            "permalink": "marcas/hermex",
            "parent_id": 471,
            "taxonomy_id": 2,
            "meta_title": null,
            "meta_description": null
          }
        ]
      }
    }
  ],
  "count": 2,
  "current_page": 1,
  "pages": 1
}

Obtener una taxonomía

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

Path Parameters

Name	Type	Description
id	integer	ID de la taxonomía.

Headers

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

200

{
   "id":1,
   "name":"Categorías",
   "root":{
      "id":1,
      "name":"Categorías",
      "pretty_name":"Categorías",
      "permalink":"categorias",
      "parent_id":null,
      "taxonomy_id":1,
      "meta_title":null,
      "meta_description":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
         },
         {
            "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
         },
         {
            "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
         },
         {
            "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
         },
         {
            "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
         }
      ]
   }
}

Crear una taxonomía

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

Headers

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

Request Body

Name	Type	Description
name	string	Nombre de la taxonomía.
id	integer	ID de la taxonomía.
show_in_megamenu	boolean	Mostrar en menú principal de la parte pública.
megamenu_design	string	Diseño del megamenu: Imagen + texto ó Sólo texto
is_default	boolean	Taxonomía predeterminada.
store_id	integer	Id de la tienda, en caso de estar suscripto al plan multitienda

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 una taxonomía

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

Path Parameters

Name	Type	Description
id	integer	ID de la taxonomía.

Headers

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

Request Body

Name	Type	Description
name	string	Nombre de la taxonomía.
id	integer	ID de la taxonomía.
show_in_megamenu	boolean	Mostrar en menú principal de la parte pública.
megamenu_design	string	Diseño del megamenu: Imagen + texto ó Sólo texto
is_default	boolean	Taxonomía predeterminada.
store_id	integer	Id de la tienda, en caso de estar suscripto al plan multitienda

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 una taxonomía

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

Path Parameters

Name	Type	Description
id	integer	ID de la taxonomia.

Headers

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

200