Crear entrada a un almacén

Mediante este servicio web se puede crear una entrada a un almacén no integrado de Fracttal.

El parámetro en la url warehouse_code es el código del almacén al que se le quiere realizar la entrada. Se puede consultar aquí. (campo code)

Los tipos de entrada que se pueden realizar son: Compra y Devolución

Entrada por una compra:

-Una compra nueva: En este tipo de entrada se deben enviar todos lo recursos que ingresarán al almacén con sus respectivas cantidades y precios. En este tipo de entrada, a los recursos se les asigna por defecto el impuesto que cada compañía tiene seleccionado como predeterminado.
-Una compra que proviene de una orden de compra: para este tipo de entrada se debe enviar el ID de la orden de compra creada en el almacén. Se puede realizar una entrada TOTAL Ó PARCIAL de los recursos que están asociados a la orden de compra seleccionada. Si se desea realizar una entrada parcial, se debe enviar el array con el código de items y cantidades que tendrá. Para el caso de una entrada Total, no es necesario enviar los items.

Entrada por devolución:

Este tipo de entrada se realiza cuando se devuelve los materiales que han sido entregados mediante una salida de almacén. Para este tipo de entrada se debe enviar el ID de la salida creada en el almacén.
Al utilizar este tipo de entrada, se puede realizar una entrada TOTAL Ó PARCIAL de los recursos asociados a la salida. Si se desea realizar una entrada parcial, se debe enviar el array con el código de items y cantidades que tendrá la entrada. Para el caso de una entrada Total, no es necesario enviar los items.

Ejemplo entrada parcial:

{
"movement_type":"2",
"is_from_movement":true,
"code_user": "25198772-2",
"document":"784",
"note":"Entrada desde una salida por integración",
"items":[
         {
           "code":"HERRA01",
           "qty": "1"
         }
 ]
}

Cuando se realizan entradas por integración es obligatorio enviar el código de un recurso humano responsable de la transacción. Dicho usuario debe tener cuenta creada Fracttal.

Cuando las entradas están relacionadas con movimientos dentro del almacén, la información del proveedor, centro de costo y divisa se asignará automáticamente del movimiento fuente (ya sea de una orden de compra o de una salida). En caso tal de querer modificarlos se debe enviar los parámetros en el servicio web.

Parámetros del body

La siguiente información debe ser enviada en el body de la petición.

Parámetro Tipo Requerido Descripción

movement_type *Entero* Sí Tipo de movimiento: 1 = Compra 2 = Devolución

is_from_movement *Booleano* Opcional True, en el caso de que se desee realizar una entrada por un movimiento existente en Fracttal (orden de compra o salida). False en el caso de crear una entrada nueva, ingresando manualmente los items. El valor por defecto es false

document *Texto* Sí Referencia de la entrada. Si proviene de una orden de compra o una salida dentro de Fracttal.
Para orden de compra se debe enviar el *folio_target* de la orden de compra. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-ordenes-de-compra)
Para devolución se debe enviar el *document* de la salida. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-de-movimentos-de-salida)

En caso de no provenir de un movimiento se establece un valor de libre elección.

code_user *Texto* Sí Código del usuario asociado al recurso humano responsable de la transacción. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-de-recursos-humanos) (campo *code*)

code_supplier *Texto* Opcional Código del tercero que está clasificado como proveedor. [Se puede consultar aquí.](https://api.fracttal.com/reference/consulta-de-terceros) (campo *code*)

value_cost_center *Texto* Opcional Código del centro de costo. (No es necesario enviarlo si se envía la description del centro de costo). [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-centros-de-costo) (campo *value*)

description_cost_center *Texto* Opcional Descripción del centro de costo. (No es necesario enviarlo si se envía la el valor del centro de costo). [Se puede consultar aquí.](https://api.fracttal.com/reference/consultar-centros-de-costo) (campo *description*)

note *Texto* Opcional Notas de la entrada

items

*Array de Json*

Sí

Parámetro	Tipo de campo	Requerido	Descripción
code	Text	Si	Código del recurso a agregar a la entrada (debe estar asociado al almacén)
qty	Text	Si	Cantidad del recurso
unit_cost	Real	Si	Costo unitario.
tax_name	Texto	Opcional	Nombre del impuesto. Si no sé envía, se asocia el impuesto por defecto de la empresa
serial_numbers	Array de string	Opcional	Sólo se debe enviar esta información, cuando el recurso asociado es controlado por serial. Se debe enviar la misma cantidad de seriales y la cantidad de recursos

Detalle de los objetos ítems

Parámetro	Tipo	Descripción
`code`	Texto	Código del item. Se puede consultar aquí. (campo code)
`qty`	Fecha	Cantidad en movimiento
`unit_cost`	Texto	Costo unitario

Parámetros de salida

Parámetro	Tipo	Descripción
`folio_target`	Entero	Id del movimiento
`date`	Fecha	Fecha de la entrada
`description`	Texto	Nota de la entrada.
`document`	Texto	Referencia
`id_third_party`	Texto	id del tercero
`third_parties_name`	Texto	Nombre del tercero
`third_parties_code`	Texto	Código del tercero
`id_cost_center`	Texto	Id Centro de Costos
`costs_center_value`	Texto	Valor del centro de Costos
`costs_center_description`	Texto	Descripción del centro de Costos
`folio_source`	Texto	Id del movimiento del almacén fuente
`date_create`	Texto	Fecha de creación del movimiento
`id_priority`	Texto	Id Prioridad
`priorities_description`	Texto	Prioridad
`id_currency`	Entero	Id divisa
`currency_description`	Texto	Descripción de la divisa
`currency_symbol`	Texto	Símbolo de la divisa
`movements_states_description`	Texto	Descripción del estado del movimiento
`movement_details`	Json array	Listado de los items que fueron asociados a la entrada

Ejemplo Nueva Entrada sin movimientos asociados:

Petición: (POST)https://app.fracttal.com/api/warehouse_entries_orders/002

{
    "movement_type":"1",
    "code_user": "25198772-2",
    "code_supplier":"terc-00123e3",
    "value_cost_center":"500000000",
    "document":"In_7456",
    "note":"Entrada por integración",
    "items":[
    	{
    	    "code":"AFL_056",
            "qty": "5",
            "unit_cost":"135",
            "serial_numbers":["A5402","A5403","A5404","A5405","A5406"]
    	},
    	{
    	    "code":"4890255A-R1",
            "qty": "20",
            "unit_cost":"750"
        },
        {
    	    "code":"MMRVH6900",
            "qty": "8",
            "unit_cost":"42533"
        },
        {
    	    "code":"38079",
            "qty": "50",
            "unit_cost":"5794"
        }
    ]
}

{
    "success": true,
    "message": "200",
    "data": {
        "id": 3977,
        "folio_target": "MOV206ANTO",
        "date": "2019-10-18",
        "description": "Entrada por integración",
        "document": "In_7456",
        "id_third_party": 2062,
        "third_parties_name": "adecco",
        "third_parties_code": "terc-00123e3",
        "id_cost_center": 421,
        "costs_center_description": "Fracttal 2019",
        "costs_center_value": "500000000",
        "folio_source": null,
        "date_create": "2019-10-18T17:13:50.008899+00:00",
        "id_priority": null,
        "priorities_description": null,
        "id_currency": 7,
        "currency_description": "PESO CHILENO",
        "currency_symbol": "$",
        "movements_states_description": "IN",
        "movement_details": [
            {
                "id_item": 5075,
                "items_description": "ACEITE VALVOLINE EURO  15W40 { 38079 } VALVOLINE",
                "code": "38079",
                "units_description": "LITROS",
                "qty": 50,
                "unit_cost": 5794,
                "total_cost": 344743,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 12437,
                "items_description": " FILTRO DE  MALLA HAGIE 690629 MMRVH6900  HYUNDAI { MMRVH6900 }",
                "code": "MMRVH6900",
                "units_description": "UNIDAD",
                "qty": 8,
                "unit_cost": 42533,
                "total_cost": 404914,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 5470,
                "items_description": "CORONA Y PIÑON EJE CORTO KIT 11X38 MFSerie 300 11X38 Fabricante { 4890255A-R1 }",
                "code": "4890255A-R1",
                "units_description": "UNIDAD",
                "qty": 20,
                "unit_cost": 750,
                "total_cost": 17850,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 122,
                "items_description": "AFLOJATODO  ACOMPA015 { AFL_056 } LUBRITEX S.A",
                "code": "AFL_056",
                "units_description": "Maquina",
                "qty": 5,
                "unit_cost": 135,
                "total_cost": 803.25,
                "tax_name": "IVA",
                "tax_rate": 19
            }
        ]
    },
    "total": 1
}

Ejemplo Nueva Entrada desde una orden de compra :

Petición: (POST)https://app.fracttal.com/api/warehouse_entries_orders/002

{
    "movement_type":"1",
    "is_from_movement":true,
    "code_user": "25198772-2",
    "document":"OC34ANTO",
    "note":"Entrada desde orden de compra por integración"
}

{
    "success": true,
    "message": "200",
    "data": {
        "id": 3998,
        "folio_target": "MOV224ANTO",
        "date": "2019-10-18",
        "description": "Entrada desde orden de compra por integración",
        "document": "OC36ANTO",
        "id_third_party": 143,
        "third_parties_name": "FRACTTAL SPA",
        "third_parties_code": "036854",
        "id_cost_center": 22,
        "costs_center_description": "SUM3015",
        "costs_center_value": "",
        "folio_source": null,
        "date_create": "2019-10-18T19:27:07.279185+00:00",
        "id_priority": null,
        "priorities_description": null,
        "id_currency": 7,
        "currency_description": "PESO CHILENO",
        "currency_symbol": "$",
        "movements_states_description": "IN",
        "movement_details": [
            {
                "id_item": 5470,
                "items_description": "CORONA Y PIÑON EJE CORTO KIT 11X38  MFSerie 300 { 4890255A-R1 } Fabricante",
                "code": "4890255A-R1",
                "units_description": "UNIDAD",
                "qty": 45,
                "unit_cost": 980,
                "total_cost": 52479,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 20,
                "items_description": "LAINAS DE CALIBRACIÒN { 0000AC-21 }",
                "code": "0000AC-21",
                "units_description": "JUEGO",
                "qty": 5,
                "unit_cost": 6800,
                "total_cost": 40460,
                "tax_name": "IVA",
                "tax_rate": 19
            },
            {
                "id_item": 5075,
                "items_description": "ACEITE VALVOLINE EURO  15W40 { 38079 } VALVOLINE",
                "code": "38079",
                "units_description": "LITROS",
                "qty": 5,
                "unit_cost": 6894.86,
                "total_cost": 41024.4,
                "tax_name": "IVA",
                "tax_rate": 19
            }
        ]
    },
    "total": 1
}