Tipos de libro
Podrás obtener información de libros que Bsale acumula según compras y ventas se registran.
Estructura JSON
Al realizar una petición HTTP, el servicio retornara un JSON con la siguiente estructura:
{
"href": "https://api.bsale.cl/v1/book_types/1.json",
"id": 1,
"name": "Libro Venta",
"dteProcess": "Venta",
"code": "0",
"state": 1
}
href, url del tipo de libro (String).
id, identificador único del tipo de libro (Integer).
name, nombre del del tipo de libro (String).
dteProcess, proceso al que pertenece el tipo de libro (String).
code, código interno del tipo de libro (String).
state, estado del tipo de documento activo(0) o inactivo (1) (Boolean).
GET lista de tipos de libro
GET /v1/book_types.json retornara todos los tipos de libro.
####Parametros
limit, limita la cantidad de items de una respuesta JSON, por defecto el limit es 25, el máximo permitido es 50.
offset, permite paginar los items de una respuesta JSON, por defecto el offset es 0.
fields, solo devolver atributos específicos de un recurso
expand, permite expandir instancias y colecciones.
name, Permite filtrar por nombre tipo libro.
dteprocess, filtra por proceso.
code, filtra por código interno.
state, boolean (0 o 1) indica si los tipos de libro están activos(0) inactivos(1).
####Ejemplos
GET /v1/book_types.json?limit=10&offset=0
GET /v1/book_types.json?fields=[name,code,state]
####Respuesta
{
"href": "https://api.bsale.cl/v1/book_types.json",
"count": 3,
"limit": 25,
"offset": 0,
"items": [
{
"href": "https://api.bsale.cl/v1/book_types/3.json",
"id": 3,
"name": "Libro Boleta",
"dteProcess": "Boleta",
"code": "2",
"state": 0
},
{
"href": "https://api.bsale.cl/v1/book_types/2.json",
"id": 2,
"name": "Libro Compra",
"dteProcess": "Compra",
"code": "1",
"state": 1
},
{
"href": "https://api.bsale.cl/v1/book_types/1.json",
"id": 1,
"name": "Libro Venta",
"dteProcess": "Venta",
"code": "0",
"state": 1
}
]
}
GET un tipo de libro
GET /v1/book_types/1.json retornara un tipo de libro específico.
####Respuesta
{
"href": "https://api.bsale.cl/v1/book_types/1.json",
"id": 1,
"name": "Libro Venta",
"dteProcess": "Venta",
"code": "0",
"state": 1
}
GET cantidad de tipos de libro
GET /v1/book_types/count.json
{
"count": 3
}