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