Crear una salida de almacén

Mediante este EndPoint se puede crear los siguientes 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.
De tipo transferencia de almacén: se debe indicar el almacén destino de la transferencia y el array de items que se desean asociar.
De tipo devolución al proveedor: se puede indicar el proveedor (es opcional) y los artículos que estarán involucrados en la transferencia.

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 6: Devolución al proveedor 8: Salida por transferencia
`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í (Excepto para salidas por OT donde se desea la entrega total de la requisición o para requisiciones que contienen 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 } "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.
`target_warehouse_code`	Texto	Sí (Para salidas tipo transferencia)	Código de almacén destino. Se puede consultar aquí. (campo code)
`code_supplier`	Texto	Opcional	Código del proveedor (tercero). Se puede consultar aquí. (campo code)

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 (entrega total de requisición)
Petición: https://app.fracttal.com/api/warehouse_outputs_orders/

{    
    "id_movement_type": 4,
    "warehouse_code": "JCD-HERR-001",
    "responsible_code": "JCDIAZG",
    "wo_folio": "OT-25484",
    "id_movement": "40"
}

{
   "success":true,
   "message":"200",
   "data":{
      "id":23401475,
      "city":null,
      "date":"2025-01-23",
      "items":[
         {
            "id":23945934,
            "qty":1,
            "code":"1384ST03030900CC164",
            "id_item":10298,
            "id_taxes":1,
            "tax_name":"Exempt",
            "tax_rate":0,
            "unit_cost":0,
            "id_company":1190,
            "total_cost":0,
            "id_item_log":13679554,
            "id_movement":23401475,
            "item_status":1,
            "qty_pending":1,
            "items_description":"ABRAZADERA 1.1/4 P/MANG.1PULG    { 1384ST03030900CC164 }",
            "units_description":"UNIDAD"
         }
      ],
      "state":null,
      "approved":null,
      "document":"OT-25484",
      "is_input":null,
      "zip_code":null,
      "id_company":1190,
      "date_create":"2025-01-23T14:55:05.324917+00:00",
      "description":null,
      "id_accounts":null,
      "id_currency":null,
      "id_item_log":null,
      "id_priority":null,
      "folio_return":52,
      "folio_source":"51",
      "folio_target":null,
      "id_condition":null,
      "approval_date":null,
      "currency_code":"COP",
      "exchange_value":1,
      "id_cost_center":null,
      "id_responsible":618713,
      "id_third_party":null,
      "number_details":1,
      "currency_symbol":"$",
      "id_accounts_log":null,
      "id_currency_iso":51,
      "approved_comment":null,
      "id_movement_type":4,
      "responsible_code":"JCDIAZG",
      "total_cost_stock":308.81,
      "accounts_log_name":null,
      "id_movement_state":2,
      "costs_center_value":null,
      "third_parties_code":null,
      "third_parties_name":null,
      "id_warehouse_source":41346,
      "id_warehouse_target":null,
      "third_parties_email":null,
      "currency_description":"Colombian Peso",
      "id_work_orders_tasks":null,
      "id_movement_reference":23401462,
      "items_log_description":null,
      "tasks_log_description":null,
      "third_parties_address":null,
      "conditions_description":null,
      "priorities_description":null,
      "warehouses_source_code":"JCD-HERR-001",
      "warehouses_target_code":null,
      "responsible_description":"Juan Camilo Diaz Gmail ",
      "costs_center_description":null,
      "third_parties_telephone_1":null,
      "third_parties_telephone_2":null,
      "id_movement_state_reference":5,
      "movements_types_description":"WORK_ORDER",
      "movements_states_description":"OUT",
      "warehouses_source_description":"ALMACEN HERRAMIENTAS JCD",
      "warehouses_target_description":null
   },
   "total":1
}

Ejemplo salida por OT parcial (í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
}

Ejemplo salida por transferencia
Petición: https://app.fracttal.com/api/warehouse_outputs_orders/

 {    
    "id_movement_type": 8,
    "warehouse_code": "JCD-HERR-001",
    "target_warehouse_code": "AAA-001",
    "responsible_code": "JCDIAZG",
    "document": "D-0001", 
    "items": [
        {
            "code": "JCD-H-0001",
            "id_type_item": 3,
            "qty": 1         
        }
    ]

}

{
    "success": true,
    "message": "200",
    "data": {
        "id": 23401470,
        "city": null,
        "date": "2025-01-23",
        "items": [
            {
                "id": 23945929,
                "qty": 1,
                "code": "JCD-H-0001",
                "id_item": 37656894,
                "id_taxes": 1,
                "tax_name": "Exempt",
                "tax_rate": 0,
                "unit_cost": 141.61,
                "id_company": 1190,
                "total_cost": 141.61,
                "id_item_log": 13679560,
                "id_movement": 23401470,
                "item_status": 1,
                "qty_pending": 1,
                "items_description": "HERRAMIENTA JCD 0001    { JCD-H-0001 }",
                "units_description": "UNIDAD"
            }
        ],
        "state": null,
        "approved": null,
        "document": "79",
        "is_input": null,
        "zip_code": null,
        "id_company": 1190,
        "date_create": "2025-01-23T14:49:48.930612+00:00",
        "description": null,
        "id_accounts": null,
        "id_currency": null,
        "id_item_log": null,
        "id_priority": null,
        "folio_return": 49,
        "folio_source": "48",
        "folio_target": "79",
        "id_condition": null,
        "approval_date": null,
        "currency_code": "COP",
        "exchange_value": 1,
        "id_cost_center": null,
        "id_responsible": 618713,
        "id_third_party": null,
        "number_details": 1,
        "currency_symbol": "$",
        "id_accounts_log": null,
        "id_currency_iso": 51,
        "approved_comment": null,
        "id_movement_type": 8,
        "responsible_code": "JCDIAZG",
        "total_cost_stock": 265.77,
        "accounts_log_name": null,
        "id_movement_state": 2,
        "costs_center_value": null,
        "third_parties_code": null,
        "third_parties_name": null,
        "id_warehouse_source": 41346,
        "id_warehouse_target": 39450,
        "third_parties_email": null,
        "currency_description": "Colombian Peso",
        "id_work_orders_tasks": null,
        "id_movement_reference": null,
        "items_log_description": null,
        "tasks_log_description": null,
        "third_parties_address": null,
        "conditions_description": null,
        "priorities_description": null,
        "warehouses_source_code": "JCD-HERR-001",
        "warehouses_target_code": "AAA-001",
        "responsible_description": "Juan Camilo Diaz Gmail ",
        "costs_center_description": null,
        "third_parties_telephone_1": null,
        "third_parties_telephone_2": null,
        "id_movement_state_reference": null,
        "movements_types_description": "WAREHOUSE_TRANSFER",
        "movements_states_description": "OUT",
        "warehouses_source_description": "ALMACEN HERRAMIENTAS JCD",
        "warehouses_target_description": "ALMACEN MRX"
    },
    "total": 1
}

Ejemplo salida por devolución al proveedor
Petición: https://app.fracttal.com/api/warehouse_outputs_orders/

 {    
    "id_movement_type": 6,
    "warehouse_code": "JCD-HERR-001",
    "responsible_code": "JCDIAZG",
    "document": "D-0001",    
    "code_supplier": "TRD-MRX-001",
    "items": [
        {
            "code": "JCD-H-0001",
            "id_type_item": 3,
            "qty": 1         
        }
    ]

}

{
    "success": true,
    "message": "200",
    "data": {
        "id": 23401474,
        "city": "MDE",
        "date": "2025-01-23",
        "items": [
            {
                "id": 23945933,
                "qty": 1,
                "code": "JCD-H-0001",
                "id_item": 37656894,
                "id_taxes": 1,
                "tax_name": "Exempt",
                "tax_rate": 0,
                "unit_cost": 70.81,
                "id_company": 1190,
                "total_cost": 70.81,
                "id_item_log": 13679562,
                "id_movement": 23401474,
                "item_status": 1,
                "qty_pending": 1,
                "items_description": "HERRAMIENTA JCD 0001    { JCD-H-0001 }",
                "units_description": "UNIDAD"
            }
        ],
        "state": "ANT",
        "approved": null,
        "document": "D-0001",
        "is_input": null,
        "zip_code": "",
        "id_company": 1190,
        "date_create": "2025-01-23T14:54:22.591792+00:00",
        "description": null,
        "id_accounts": null,
        "id_currency": null,
        "id_item_log": null,
        "id_priority": null,
        "folio_return": 51,
        "folio_source": "50",
        "folio_target": null,
        "id_condition": null,
        "approval_date": null,
        "currency_code": "COP",
        "exchange_value": 1,
        "id_cost_center": null,
        "id_responsible": 618713,
        "id_third_party": 549358,
        "number_details": 1,
        "currency_symbol": "$",
        "id_accounts_log": null,
        "id_currency_iso": 51,
        "approved_comment": null,
        "id_movement_type": 6,
        "responsible_code": "JCDIAZG",
        "total_cost_stock": 336.58,
        "accounts_log_name": null,
        "id_movement_state": 2,
        "costs_center_value": null,
        "third_parties_code": "TRD-MRX-001",
        "third_parties_name": "AAA TERCERO MRX INDUSTRIES",
        "id_warehouse_source": 41346,
        "id_warehouse_target": null,
        "third_parties_email": "",
        "currency_description": "Colombian Peso",
        "id_work_orders_tasks": null,
        "id_movement_reference": null,
        "items_log_description": null,
        "tasks_log_description": null,
        "third_parties_address": "valle sur",
        "conditions_description": null,
        "priorities_description": null,
        "warehouses_source_code": "JCD-HERR-001",
        "warehouses_target_code": null,
        "responsible_description": "Juan Camilo Diaz Gmail ",
        "costs_center_description": null,
        "third_parties_telephone_1": "",
        "third_parties_telephone_2": "",
        "id_movement_state_reference": null,
        "movements_types_description": "RETURN_SUPPLIER",
        "movements_states_description": "OUT",
        "warehouses_source_description": "ALMACEN HERRAMIENTAS JCD",
        "warehouses_target_description": null
    },
    "total": 1
}