Categoria

Consulta

Obtener listado de Categorías

GET https://api.contifico.com/sistema/api/v1/categoria/

Devuelve un listado con todas las categorías creadas en el sistema.

Respuesta al consultar todas las categorías

[
    {
        "padre_id": "P0023xkBKULMe5GB",
        "cuenta_compra": null,
        "tipo_producto": "SERV",
        "cuenta_venta": "P1QleXq5MKUMarNO",
        "para_supereasy": false,
        "para_comisariato": false,
        "agrupar": false,
        "nombre": "FIESTA EUROPA",
        "id": "7DkPb3333kWd5Y9L",
        "cuenta_inventario": null       
    },
    {
        "padre_id": "P0023xkBKULMe5GB",
        "cuenta_compra": null,
        "cuenta_venta": "PxBleXq5MKUMarYq",
        "tipo_producto": "PROD",
        "para_supereasy": false,
        "para_comisariato": false,
        "agrupar": false,
        "nombre": "FIESTA CASUAL",
        "id": "8J0ye266I1neER7O",
        "cuenta_inventario": null
    },
    {
        "padre_id": null,
        "cuenta_compra": null,
        "cuenta_venta": "A1BleXq5MKUMarNO",
        "tipo_producto": null,
        "para_supereasy": false,
        "para_comisariato": false,
        "agrupar": false,
        "nombre": "FIESTA AMAZON",
        "id": "PxBleXJwu0000NOR",
        "cuenta_inventario": null
    },
    ...
]

Parámetro	Tipo	Longitud	Descripción
padre_id	varchar	16	Identificador de la categoría padre.
cuenta_compra	varchar	16	Identificador de la cuenta para compras.
cuenta_venta	varchar	16	Identificador de la cuenta para ventas.
tipo_producto	varchar	4	Identificador del tipo de producto (PROD:producto, SERV:servicio).
para_supereasy	boolean	1	Valor que define si los productos de esta categoría son para Super Easy.
para_comisariato	boolean	1	Valor que define si los productos de esta categoría son para Mi Comisariato.
agrupar	boolean	1	Valor que define si los productos de esta categoría se agrupan en los documentos.
nombre	varchar	300	Nombre de la categoría.
id	varchar	16	Identificador de la categoria en el sistema.
cuenta_inventario	varchar	16	Identificador de la cuenta para inventariar.

Query Parameters

Parámetro	Tipo	Longitud	Descripción
fecha_inicial	date		Filtro para consultar las categorias desde la fecha de ultima modificacion.
fecha_final	date		Filtro para consultar las categorias hasta la fecha de ultima modificacion.

Obtener una Categoría

GET https://api.contifico.com/sistema/api/v1/categoria/<ID>/

Devuelve una categoria con el <ID> solicitado.

Ejemplo:

    {
        "padre_id": null,
        "cuenta_compra": null,
        "cuenta_venta": "P9aQWzZ25Uo11dDM",
        "tipo_producto": null,
        "para_supereasy": false,
        "para_comisariato": false,
        "agrupar": false,
        "nombre": "GENERAL",
        "id": "91qdGZOkJUANNbN8",
        "cuenta_inventario": null
    }

Parámetro	Tipo	Longitud	Descripción
padre_id	varchar	16	Identificador de la categoría padre.
cuenta_compra	varchar	16	Identificador de la cuenta para compras.
cuenta_venta	varchar	16	Identificador de la cuenta para ventas.
tipo_producto	varchar	4	Identificador del tipo de producto (PROD:producto, SERV:servicio).
para_supereasy	boolean	1	Valor que define si los productos de esta categoría son para Super Easy.
para_comisariato	boolean	1	Valor que define si los productos de esta categoría son para Mi Comisariato.
agrupar	boolean	1	Valor que define si los productos de esta categoría se agrupan en los documentos.
nombre	varchar	300	Nombre de la categoría.
id	varchar	16	Identificador de la categoria en el sistema.
cuenta_inventario	varchar	16	Identificador de la cuenta para inventariar.

Crear una Categoria

Para crear una categoria se debe de hacer uso de la url:

POST https://api.contifico.com/sistema/api/v1/categoria/

Por medio del método POST enviando en el cuerpo del requerimiento los datos de la categoria:

Estructura del JSON:

    {
        "padre_id": "NO8bYv2VATAWWd7j",
        "cuenta_compra": null,
        "tipo_producto": "SERV",
        "cuenta_venta": "P9aQWzZ25Uo11dDM",
        "agrupar": false,
        "nombre": "Prueba01",
        "cuenta_inventario": null
    }

Parámetro	Tipo	Longitud	Descripción	Obligatorio
padre_id	varchar	16	Identificador de la categoría padre	No
cuenta_compra	varchar	16	Identificador de la cuenta para compras	No
cuenta_venta	varchar	16	Identificador de la cuenta para ventas.	No
tipo_producto	varchar	4	Identificador del tipo de producto (PROD:producto, SERV:servicio).	No
para_supereasy	boolean	1	Valor que define si los productos de esta categoría son para Super Easy.	No
para_comisariato	boolean	1	Valor que define si los productos de esta categoría son para Mi Comisariato.	No
agrupar	boolean	1	Valor que define si los productos de esta categoría se agrupan en los documentos.	No
nombre	varchar	300	Nombre de la categoría.	Si
cuenta_inventario	varchar	16	Identificador de la cuenta para inventariar.	No

NOTA: los campos de para_supereasy y para_comisariato solo pueden ser consultados por las respectivas empresas habilitadas. De lo contrario, el servicio retornará este objeto sin los mismos.