Mediante este EndPoint se puede crear 2 tipos de salidas de almacén:
Salida por una OT: Cuando se genera la salida desde los recursos solicitados en una requisición de material generada por una OT.
De tipo general: se asocian los repuestos que se desean descontar del almacén.
Ambas salidas de almacén generarán la entrega total de los recursos solicitados.
Para generar una salida por una OT es obligatorio tener la información del almacén, la requisición, la OT y que la requisición tenga entregas pendientes. En caso de que alguno de los artículos de la requisición sean gestionados por serial, se deberá enviar el parámetro “items” (array) con toda la información de los items que harán parte de la salida.
Para generar una salida general es obligatorio tener la información del almacén, la referencia de la transacción, enviar el tipo de movimiento, y el array de items que se desean asociar.
La información opcional que se puede agregar a la salida es el código o descripción del centro de costos y las notas de la salida de almacén. Es necesario tener en cuenta que se debe enviar la información de un centro de costos existente en Fracttal.
Parámetros del Body
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
warehouse_code | Texto | Sí | Código del Almacén |
wo_folio | Texto | Sí | Id de la orden de trabajo que tiene la requisición asociada |
id_movement | Texto | Sí (solo para salidas de tipo OT) | Id de la requisición de material |
id_movement_type | Número | Sí | Tipo de salida a realizar: 4: salida por OT ( valor por defecto) 5: Salida General |
responsible_code | Texto | Sí | Código del recurso humano responsable de la salida de almacén. Debe ser un recurso humano existente en Fracttal. |
document | Texto | Sí (Para salidas de tipo General) | Referencia de la transacción. |
items | Array Json | Sí (Para salidas de tipo General ó por OTs con items controlados por serial) | Array de Json, con la información de los items que se desean asociar a la salida. Los valores que debe tener cada item son: { "code":string, "id_type_item": int, "qty": real, "serial_numbers": array de textos } "id_type_item", es el tipo de activo. Puede ser: 3: Herramientas 4: Repuesto y suministro "serial_numbers", aplica sólo para los items controlados por serial |
date | Texto | Opcional | Fecha de entrega. Por defecto es la fecha actual en UTC-0 |
description | Texto | Opcional | Notas de la salida de almacén |
description_cost_center | Texto | Opcional | Descripción del centro de costos. Debe existir en Fracttal |
value_cost_center | Texto | Opcional | Valor del centro de costos. Debe existir en Fracttal. Sólo es necesario enviar uno de los 2: el description_cost_center ó el value_cost_center. |
Parámetros de salida
Parámetro | Tipo | Descripción |
---|---|---|
date | Fecha | Fecha de entrega |
description | Texto | Nota asignada a la salida |
document | Texto | Orden de trabajo |
date_create | Fecha | Fecha de creación |
description | Texto | Descripción de la entrada. |
items | json | Información de los items que se asociaron a la salida y a los que se les realizó la entrega total |
Body
{
"warehouse_code":"1254",
"wo_folio":"1109",
"id_movement":"109",
"responsible_code":"3457899",
"description":"Salida de almacén mediante API",
"description_cost_center":"Activos"
}
{
"success": true,
"message": "200",
"data": {
"date": "2019-07-24",
"description": "Salida de almacén API",
"document": "1109",
"id_cost_center": 5,
"id_responsible": 53,
"folio_source": "109",
"folio_target": null,
"date_create": "2019-07-24T13:04:24.235573+00:00",
"items": {
"id_movement": 378,
"id_company": 69,
"qty": 1,
"unit_cost": 5000,
"total_cost": 5000,
"id": 460,
"qty_pending": 1,
"id_item_log": 171,
"id_taxes": 1,
"item_status": 1,
"items_description": "Martillo { MART01 }"
}
},
"total": 1
}
Ejemplo:
Salida de OT (ítems serializados):
Petición: https://app.fracttal.com/api/warehouse_outputs_orders/
{
"warehouse_code":"BD_SERIAL",
"wo_folio":"OT-1737",
"id_movement":"25",
"responsible_code":"AP87757",
"description":"Salida de almacén mediante API",
"items":[
{
"code":"CLL0976",
"id_type_item":4,
"qty":2,
"serial_numbers":["85564","98756"]
}
]
}
{
"success": true,
"message": "200",
"data": {
"id": 425748,
"id_company": 69,
"id_movement_type": 4,
"id_warehouse_source": 1642,
"id_warehouse_target": null,
"date": "2021-09-14",
"description": "Salida de almacén mediante API",
"document": "OT-1737",
"id_third_party": null,
"id_cost_center": null,
"id_responsible": 86,
"folio_source": "25",
"folio_target": null,
"id_movement_state": 2,
"id_priority": null,
"date_create": "2021-09-14T04:23:19.062941+00:00",
"id_condition": null,
"id_currency": null,
"exchange_value": null,
"id_work_orders_tasks": null,
"id_movement_reference": null,
"id_accounts_log": null,
"approved": null,
"approved_comment": null,
"is_input": null,
"id_currency_iso": null,
"approval_date": null,
"items": [
{
"id_movement": 425748,
"id_company": 69,
"qty": 2,
"unit_cost": 666.4000244140625,
"total_cost": 1332.8,
"id": 995244,
"qty_pending": 0,
"id_item_log": 656215,
"id_taxes": 1,
"item_status": 1,
"items_description": "CUCHILLA ABB { CLL0976 }"
}
]
},
"total": 1
}
Ejemplo Salida General:
{
"warehouse_code":"1254",
"responsible_code":"7845123",
"description":"Salida de almacén mediante API",
"description_cost_center":"Activos",
"document":"OUTGOING",
"date":"2021-05-10",
"id_movement_type":5,
"items":[
{
"code":"HERRA01",
"id_type_item":3,
"qty":2
},
{
"code":"09877",
"id_type_item":4,
"qty":1
}
]
}
{
"success": true,
"message": "200",
"data": {
"id": 186592,
"id_company": 69,
"id_movement_type": 5,
"id_warehouse_source": 2,
"id_warehouse_target": null,
"date": "2021-05-10",
"description": "Salida de almacén mediante API",
"document": "OUTGOING",
"id_third_party": null,
"id_cost_center": 5,
"id_responsible": 7,
"folio_source": null,
"folio_target": null,
"id_movement_state": 2,
"id_priority": null,
"date_create": "2021-06-11T19:14:42.224853+00:00",
"id_condition": null,
"id_currency": null,
"exchange_value": null,
"id_work_orders_tasks": null,
"id_movement_reference": null,
"id_accounts_log": null,
"approved": null,
"approved_comment": null,
"is_input": null,
"id_currency_iso": null,
"id_warehouse": null,
"items": [
{
"id_movement": 186592,
"id_company": 69,
"qty": 1,
"unit_cost": 4590,
"total_cost": 4590,
"id": 450042,
"qty_pending": 1,
"id_item_log": 306,
"id_taxes": 1,
"item_status": 1,
"items_description": "ABRAZADERA 1/4 R16 Y70 Dunlop RM340 { ITM-002 }"
},
{
"id_movement": 186592,
"id_company": 69,
"qty": 1,
"unit_cost": 4800,
"total_cost": 4800,
"id": 450043,
"qty_pending": 1,
"id_item_log": 401,
"id_taxes": 1,
"item_status": 1,
"items_description": "NIPLE DE 3\" { 0002020000201612 }"
}
]
},
"total": 1
}
PROBAR CONEXION