3. Crear productos

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

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:

Cuerpo de la petición

{

"subheading_id": 1, "businessUnit_id":67, "code_product":"ACT-10", "description_product":"Actaminofen por 10", "convertion_factor_product":"2", "group_product":"Analgésicos"

}

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
}
}
}

3.1 Consultar 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

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."
}
}

3.2 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.

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.

https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/admin/configurations/subheadings/getSubheadingProduct/0303290000

Respuesta:

El servicio retorna dos variables que son, el id interno de la subpartida y la unidad comercial que la relaciona.

{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"id": 152,
"code_businessUnit": "KG"
}
}
}

3.3 Actualizar productos

Para actualizar productos se utilizará el servicio updateProduct

POST/updateProduct

Para realizar la actualización, como se ve en la tabla anterior, el campo id, es el requerido, por lo demás se puede actualizar solo el campo que nos interesa.

En el siguiente ejemplo, se actualizará el nombre del producto Acetaminofén por 10.

Ejemplo:

Cuerpo de la petición

{
"id": 430,
"code_product": "ACT-10",
"description_product":"Acetaminofén por 10"

}

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": "Acetaminofén por 10",
"convertion_factor_product": "2",
"group_product": "Analgésicos",
"tracking": null,
"status_product": 1
}
}
}

3.4 Consultar productos

Se puede consultar todos los productos creados hasta el momento mediante el método getProducts

GET/getProducts

Respuesta:

{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"current_page": 1,
"data": [
{
"id": 354,
"code_product": "BH-080",
"description_product": "Parlantes",
"convertion_factor_product": "2",
"group_product": null,
"subheading_id": 1,
"code_subheading": "0105140000",
"qualifiedUser_id": 214,
"nit_qualified": "9002488821",
"name_qualified": "CLINICA PORTOAZUL S.A.",
"unitMeasurement_id": 10,
"code_unit_measurement": "U",
"unit_measurement": "Unidad o artículo",
"nickname_qualified": "Portoazul",
"status_product": 1,
"decimal_values_precision": "4"
},
{
"id": 430,
"code_product": "ACT-10",
"description_product": "Actaminofen por 10",
"convertion_factor_product": "2",
"group_product": "Analgésicos",
"subheading_id": 1,
"code_subheading": "0105140000",
"qualifiedUser_id": 214,
"nit_qualified": "9002488821",
"name_qualified": "CLINICA PORTOAZUL S.A.",
"unitMeasurement_id": 67,
"code_unit_measurement": "T10",
"unit_measurement": "Tableta x10",
"nickname_qualified": "Portoazul",
"status_product": 1,
"decimal_values_precision": "4"
}
],
"first_page_url": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/products/getProducts?page=1%22,
"from": 1,
"last_page": 1,
"last_page_url": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/products/getProducts?page=1%22,
"links": [
{
"url": null,
"label": "« Anterior",
"active": false
},
{
"url": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/products/getProducts?page=1%22,
"label": "1",
"active": true
},
{
"url": null,
"label": "Siguiente »",
"active": false
}
],
"next_page_url": null,
"path": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/products/getProducts%22,
"per_page": 25,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}