Se puede consultar todos los productos creados hasta el momento mediante el método getProducts
Parámetro | Valor |
|---|---|
Nombre servicio |
getProducts | |
Tipo método | POST |
URL | https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/ |
getProducts | |
Content type | application/json |
Post/createProduct
Servicio utilizado para la creación de productos que permite la identificación de los mismos en los formularios de ingreso.
Parámetros de consulta
...
Parámetro Post
...
Tipo
...
Longitud
...
Obligatorio
...
Descripción
...
code_product
...
string
...
150
...
Si
...
Identificación interna del producto
...
code_subheading
...
string
...
80
...
Si
...
Código de la subpartida
...
convertion_factor_product
...
float
...
Si
...
Factor de conversión equivalente a la unidad de medida ingresado
...
description_product
...
text
...
Si
...
Descripción del producto creado
...
group_product
...
string
...
80
...
Si
...
Grupo al cual pertenece un producto
...
businessUnit_id
...
integer
...
Si
...
Id de la unidad de medida
...
subheading_id
...
integer
...
Si
...
Id de la subpartida
Importante: Para conocer el id interno de la subpartida y de la unidad de medida creada, se debe consumir los servicios getSubheadingProduct y getUnitQualifiedUser. De los cuales explicaremos más adelante.
Ejemplo:
Cabecera de la petición
{
...
Parámetro de búsqueda
Parámetro | Descripción |
|---|---|
search | Parámetro de búsqueda, puede buscar por descripción del producto, código de producto y subpartida. |
POST/getProducts
Respuesta:
| Bloque de código |
|---|
{ "status": { "code": 200, "message": "Procesado con éxito", "data": { "current_page": 1, "data": [ { "code_product": "0MTT1943", "typeProduct_id": "Insumos", "description_product": "0MTT1943 RETREFLECTIV SENSOR RF BOS18KF-PA-1QDC02", "convertion_factor_product": " |
...
1", "group_product": " |
...
}
Respuesta
{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"id": 430,
"qualifiedUser_id": 214,
"subheading_id": 1,
"businessUnit_id": 67,
"code_product": "ACT-10",
"description_product": "Actaminofen por 10",
"convertion_factor_product": "2",
"group_product": "Analgésicos",
"tracking": null,
"status_product": 1
}
}
}
Crear unidades de medida
Antes de crear el producto, se debe crear las unidades de medida propias del usuario calificado, manteniendo la equivalencia con la unidad comercial de la subpartida.
...
Parámetro
...
Valor
...
Nombre servicio
...
createUnitMeasurementQualifiedUser
...
Tipo método
...
POST
...
URL
...
https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/products/unitMeasuremente/createUnitMeasurementQualifiedUser
...
Content type
...
application/json
POST/createUnitMeasurementQualifiedUser
...
Parámetro
...
Tipo
...
Longitud
...
Obligatorio
...
Descripción
...
unit_measurement
...
string
...
30
...
Si
...
Nombre de la unidad de medida
...
code_unit_measurement
...
string
...
30
...
Si
...
Código de la unidad de medida
Ejemplo
Cabecera de la petición
...
Respuesta
{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"id": 67,
"qualifiedUser_id": 214,
"code_unit_measurement": "T10",
"unit_measurement": "Tableta x10",
"status_unit_measurement": 1
}
}
}
Obtener id de la unidad de medida
Para conocer el id con que se relaciona la unidad de medida creada, hay que consultar el servicio getUnitQualifiedUser
...
Parámetro
...
Valor
...
Nombre servicio
...
getUnitQualifiedUser/{#code_unit_measuement}
...
Tipo método
...
GET
...
URL
...
https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/getUnitQualifiedUser/{#code_unit_measuement}
...
Content type
...
application/json
GET/getUnitQualifiedUser/{#code_unit_measuement}
Se envía el parámetro por medio de la URL, en este caso el código de la unidad de medida que queremos consultar.
Ejemplo:
Se creó la unidad de medida T10, para conocer el id interno, invocamos el endpoint getUnitQualifiedUser, y por parámetro se le pasa el código de la unidad de medida, es importante enviar dicho código tal cual como fue creado inicialmente.
https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/getUnitQualifiedUser/T10
Respuesta:
{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"id": 10
}
}
}
Si la unidad no se identifica, se obtendrá el siguiente resultado
{
"status": {
"code": 400,
"message": "No existe la unidad de medida para el usuario calificado."
}
}
Consultar subpartidas
Para conocer el id interno de la subpartida, utilizaremos el método getSubheadingProduct el cual, por parámetro le enviaremos la subpartida que queremos consultar y retornará el id y la unidad comercial que le corresponde.
...
Parámetro
...
Valor
...
Nombre servicio
...
getSubheadingProduct/{#subpartida}
...
Tipo método
...
GET
...
URL
...
https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/getSubheadingProduct /{#subpartida}
...
Content type
...
application/json
GET/getSubheadingProduct/{#subpartida}
Se envía el parámetro por medio de la URL, en este caso el código de la subpartida que queremos consultar.
Respuesta:
El servicio retorna dos variables que son, el id interno de la subpartida y la unidad comercial que la relaciona.
...
REPUESTO", "subheading_id": "8422900000", "nit_qualified": "8020193394", "name_qualified": "ADAMA ANDINA B.V SUCURSAL COLOMBIA.", "businessUnit_id": "U", "unit_measurement": "Unidad o artículo 1", "nickname_qualified": null, "status_product": 1, "decimal_values_precision": "4", "tracking": null }, { "code_product": "LH194321", "typeProduct_id": "Insumos", "description_product": "LH194321 PARAXONE 200 SL UPL BIDON X 1 LT", "convertion_factor_product": "1.08", "group_product": "UPL", "subheading_id": "3808931900", "nit_qualified": "8020193394", "name_qualified": "ADAMA ANDINA B.V SUCURSAL COLOMBIA.", "businessUnit_id": "U", "unit_measurement": "Unidad o artículo 1", "nickname_qualified": null, "status_product": 1, "decimal_values_precision": "4", "tracking": null } ], "first_page_url": "http://127.0.0.1:8000/api/auth/products/getProducts?page=1", "from": 1, "last_page": 1, "last_page_url": "http://127.0.0.1:8000/api/auth/products/getProducts?page=1", "links": [ { "url": null, "label": "« Anterior", "active": false }, { "url": "http://127.0.0.1:8000/api/auth/products/getProducts?page=1", "label": "1", "active": true }, { "url": null, "label": "Siguiente »", "active": false } ], "next_page_url": null, "path": "http://127.0.0.1:8000/api/auth/products/getProducts", "per_page": 25, "prev_page_url": null, "to": 2, "total": 2 } } } |