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. Para realizar esto, 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.
De tipo general: se asocian los repuestos que se desean descontar del almacén. Para realizar esto, 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.
Ambas salidas de almacén generarán la entrega total de los recursos solicitados.
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.
Parámetros del Body
La siguiente información debe ser enviada en el body de la petición.
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
warehouse_code | Texto | Sí | Código del Almacén. Se puede consultar aquí. (campo code) |
wo_folio | Texto | Si (solo para salidas de tipo OT) | Id de la orden de trabajo que tiene la requisición asociada. Se puede consultar aquí. (campo folio) |
id_movement | Texto | Sí (solo para salidas de tipo OT) | Id de la requisición de material. Se puede consultar aquí (campo folio_source) |
id_movement_type | Entero | 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. Se puede consultar aquí. (campo code) |
document | Texto | Sí (Para salidas de tipo General) | Referencia de la transacción. |
items | Array de objetos 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, "idtype_item": int, "qty": real, "serial_numbers": array de textos } "code" es el código del item. Se puede consultar aquí. (campo _code) "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 |
---|---|---|
id_movement_type | Entero | Id del tipo de movimiento |
id_warehouse_source | Entero | id del almacén origen del movimiento |
id_warehouse_target | Entero | id del almacén destino del movimiento |
date | Fecha | Fecha del movimiento de salida |
description | Texto | Descripción del movimiento de salida |
document | Fecha | Referencia del movimiento de salida |
responsible_code | Texto | Usuario responsable del movimiento de salida |
items | Array de objetos json | Información de los items que se asociaron a la salida y a los que se les realizó la entrega total |
Detalle de los objetos ítems
Parámetro | Tipo | Descripción |
---|---|---|
id_movement | Texto | Id del movimiento |
qty | Texto | Cantidad en movimiento |
unit_cost | Texto | Costo unitario |
total_cost | Texto | Costo total |
items_description | Texto | Descripción del item en movimiento |
Ejemplo:
Ejemplo salida por 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
Petición: https://app.fracttal.com/api/warehouse_outputs_orders/
{
"warehouse_code": "ALM-RUBEN",
"id_movement_type": "5",
"responsible_code": "RH-002",
"document": "SALIDA-001",
"items": [
{
"code": "PPC.TH.AR2.346",
"id_type_item": 4,
"qty": 1
}
]
}
{
"success": true,
"message": "200",
"data": {
"id": 5633469,
"id_company": 1190,
"id_movement_type": 5,
"id_warehouse_source": 33700,
"id_warehouse_target": null,
"date": "2023-09-19",
"description": null,
"document": "SALIDA-001",
"id_third_party": null,
"id_cost_center": null,
"id_responsible": 210943,
"folio_source": "4",
"folio_target": null,
"id_movement_state": 2,
"id_priority": null,
"date_create": "2023-09-19T20:59:57.077487+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,
"show_transfer": null,
"items": [
{
"id_movement": 5633469,
"id_company": 1190,
"qty": 1,
"unit_cost": 5950,
"total_cost": 5950,
"id": 9227216,
"qty_pending": 0,
"id_item_log": 5470664,
"id_taxes": 1,
"item_status": 1,
"items_description": " Argolla de 5/8\\ con lado plano para 4tn { PPC.TH.AR2.346 }"
}
]
},
"total": 1
}