La documentación que estás leyendo no cuenta con los últimos cambios. ¡Revisa nuestra documentación actualizada!
Listar y editar detalles de las listas de precio en Bsale.
Bsale gestiona 1 o más listas de precio. (Ej Lista de precios temporada, lista distribuidores, lista por mayor, etc). Pueden ser concebidas con distintos tipos de moneda (dolar, franco, uf, etc)
Para usar las lista de precio creadas, revisar priceListId en el envío del documento.
Al realizar una petición HTTP, el servicio retornara un JSON con la siguiente estructura:
{
"href": "https://api.bsale.cl/v1/price_lists/3.json",
"id": "3",
"name": "LISTA USD",
"description": null,
"state": 0,
"coin": {
"href": "https://api.bsale.cl/v1/coins/3.json",
"id": "3"
},
"details": {
"href": "https://api.bsale.cl/v1/price_lists/3/details.json"
}
}
href, url de la lista de precio (String).
id, identificador único de la lista de precio (Integer).
name, nombre de la lista de precio (String).
state, estado de la lista de precio indica si esta activo(0) o inactivo (1) (Boolean).
coin, nodo que indica la moneda que utiliza la lista de precio.
details, nodo que indica los detalles de la lista de precio.
GET /v1/price_lists.json retornara todas las listas de precio.
Parámetros
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 de la lista de precio.
coinid, filtra por la moneda.
state, boolean (0 o 1) indica si las listas de precio están activas(0) inactivas (1).
Ejemplos
GET /v1/price_lists.json?limit=10&offset=0
GET /v1/price_lists.json?fields=[name,description,state]
GET /v1/price_lists.json?coinid=1
GET /v1/price_lists.json?expand=[coin,details]
Respuesta
{
"href": "https://api.bsale.cl/v1/price_lists.json",
"count": 3,
"limit": 25,
"offset": 0,
"items": [
{
"href": "https://api.bsale.cl/v1/price_lists/1.json",
"id": "1",
"name": "Lista Base",
"description": "",
"state": 0,
"coin": {
"href": "https://api.bsale.cl/v1/coins/1.json",
"id": "1"
},
"details": {
"href": "https://api.bsale.cl/v1/price_lists/1/details.json"
}
},
{
"href": "https://api.bsale.cl/v1/price_lists/2.json",
"id": "2",
"name": "Lista UF",
"description": "",
"state": 0,
"coin": {
"href": "https://api.bsale.cl/v1/coins/2.json",
"id": "2"
},
"details": {
"href": "https://api.bsale.cl/v1/price_lists/2/details.json"
}
},
{
"href": "https://api.bsale.cl/v1/price_lists/3.json",
"id": "3",
"name": "LISTA USD",
"description": null,
"state": 0,
"coin": {
"href": "https://api.bsale.cl/v1/coins/3.json",
"id": "3"
},
"details": {
"href": "https://api.bsale.cl/v1/price_lists/3/details.json"
}
}
]
}
GET /v1/price_lists/3.json retornara un cliente específico.
Parámetros
expand, permite expandir instancias y colecciones.
Ejemplos
GET /v1/price_lists/3.json?expand=[details, coin]
Respuesta
{
"href": "https://api.bsale.cl/v1/price_lists/3.json",
"id": "3",
"name": "LISTA USD",
"description": null,
"state": 0,
"coin": {
"href": "https://api.bsale.cl/v1/coins/3.json",
"id": "3"
},
"details": {
"href": "https://api.bsale.cl/v1/price_lists/3/details.json"
}
}
GET /v1/price_lists/1/details.json
Parámetros
expand, permite expandir instancias y colecciones.
variantid, filtra por el identificador de la variante (Integer)
code, filtra por el SKU de la variante (String).
barcode, filtra por el código de barras de la variante (String).
Ejemplos
GET /v1/price_lists/1/details.json?expand=[variant]
GET /v1/price_lists/1/details.json?variantid=149
GET /v1/price_lists/1/details.json?code=12345
GET /v1/price_lists/1/details.json?barcode=45412431
Respuesta
{
"href": "https://api.bsale.cl/v1/price_lists/1/details.json",
"count": 7634,
"limit": 4,
"offset": 0,
"items": [
{
"href": "https://api.bsale.cl/v1/price_lists/1/details/663.json",
"id": 663,
"variantValue": 4590,
"variantValueWithTaxes": 5462,
"variant": {
"href": "https://api.bsale.cl/v1/variant/388.json",
"id": "388"
}
},
{
"href": "https://api.bsale.cl/v1/price_lists/1/details/681.json",
"id": 681,
"variantValue": 25000.23,
"variantValueWithTaxes": 29750,
"variant": {
"href": "https://api.bsale.cl/v1/variant/407.json",
"id": "407"
}
},
{
"href": "https://api.bsale.cl/v1/price_lists/1/details/683.json",
"id": 683,
"variantValue": 10000,
"variantValueWithTaxes": 11900,
"variant": {
"href": "https://api.bsale.cl/v1/variant/426.json",
"id": "426"
}
},
{
"href": "https://api.bsale.cl/v1/price_lists/1/details/689.json",
"id": 689,
"variantValue": 10000,
"variantValueWithTaxes": 11900,
"variant": {
"href": "https://api.bsale.cl/v1/variant/460.json",
"id": "460"
}
}
],
"next": "https://api.bsale.cl/v1/price_lists/1/details.json?limit=4&offset=4"
}
href, url del detalle de la lista de precio (String).
id, identificador único del detalle (Integer).
variantValue, Valor neto de la variante (Float).
variantValueWithTaxes, Valor con impuestos de la variante (Float).
variant, nodo que indica la variante relacionada con el detalle de la lista de precio.
GET /v1/price_lists/3/details/663.json
{
"href": "https://api.bsale.cl/v1/price_lists/1/details/663.json",
"id": 663,
"variantValue": 4590,
"variantValueWithTaxes": 5462,
"variant": {
"href": "https://api.bsale.cl/v1/variant/388.json",
"id": "388"
}
}
GET /v1/price_lists/count.json
Parámetros
state, permite filtrar por estado, activos (0) inactivos (1).
Respuesta
{
"count": 3
}
PUT /v1/price_lists/19/details/1412.json
NOTA: El id que se debe agregar pertenece al de detalle de Lista de precio.
Se debe enviar un Json con la siguiente estructura.
{
"variantValue": 2000,
"id": 1412
}
Respuesta
{
"href": "https://api.bsale.cl/v1/price_lists/19/details/1412.json",
"variantValue": 2000.0,
"variantValueWithTaxes": 2380.0,
"variant": {
"href": "https://api.bsale.cl/v1/variant/351.json",
"id": "351"
},
"id": 1412
}