Fracttal →

Crear una salida de almacén

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ámetroTipoRequeridoDescripción
warehouse_codeTextoCódigo del Almacén
wo_folioTextoId de la orden de trabajo que tiene la requisición asociada
id_movementTextoSí (solo para salidas de tipo OT)Id de la requisición de material
id_movement_typeNúmeroTipo de salida a realizar:
4: salida por OT ( valor por defecto)
5: Salida General
responsible_codeTextoCódigo del recurso humano responsable de la salida de almacén. Debe ser un recurso humano existente en Fracttal.
documentTextoSí (Para salidas de tipo General)Referencia de la transacción.
itemsArray JsonSí (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
dateTextoOpcionalFecha de entrega. Por defecto es la fecha actual en UTC-0
descriptionTextoOpcionalNotas de la salida de almacén
description_cost_centerTextoOpcionalDescripción del centro de costos. Debe existir en Fracttal
value_cost_centerTextoOpcionalValor 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ámetroTipoDescripción
dateFechaFecha de entrega
descriptionTextoNota asignada a la salida
documentTextoOrden de trabajo
date_createFechaFecha de creación
descriptionTextoDescripción de la entrada.
itemsjsonInformació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

Language