Crear entrada a un almacén

Endpoint

POST https://app.fracttal.com/api/warehouse_entries_orders/{warehouse_code}

Parámetro de URL

Parámetro	Tipo	Requerido	Descripción
`warehouse_code`	Texto	Sí	Código del almacén al que se realizará la entrada. Puedes consultarlo en Consultar almacenes, campo `code`.

Tipos de entrada

Puedes crear entradas por compra o por devolución.

Entrada por compra

Compra nueva: envía todos los recursos que ingresarán al almacén con sus cantidades y precios. A cada recurso se le asigna por defecto el impuesto que la compañía tiene seleccionado como predeterminado.
Compra desde una orden de compra: envía el ID de la orden de compra creada en el almacén. Puedes realizar una entrada total o parcial de los recursos asociados a la orden de compra. Para una entrada parcial, envía el arreglo items con el código y la cantidad de cada recurso. Para una entrada total, no es necesario enviar items.

Entrada por devolución

Usa este tipo de entrada cuando se devuelven materiales que fueron entregados mediante una salida de almacén.

Para crearla, envía el ID de la salida creada en el almacén. Puedes realizar una entrada total o parcial de los recursos asociados a la salida. Para una entrada parcial, envía el arreglo items con el código y la cantidad de cada recurso. Para una entrada total, no es necesario enviar items.

Requisitos

Envía el código de un recurso humano responsable de la transacción en code_user.
Verifica que el usuario asociado a code_user tenga una cuenta creada en Fracttal.
Si la entrada está relacionada con una orden de compra o una salida, Fracttal asignará automáticamente el proveedor, centro de costo y divisa desde el movimiento fuente. Si necesitas modificar esos valores, envía los parámetros correspondientes en el body.

Body de la petición

Envía la siguiente información 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	Usa `true` para crear una entrada desde un movimiento existente en Fracttal, como una orden de compra o una salida. Usa `false` para crear una entrada nueva ingresando manualmente los ítems. Valor por defecto: `false`.
`document`	Texto	Sí	Referencia de la entrada. Si proviene de una orden de compra, envía el `folio_target` de la orden de compra. Puedes consultarlo en Consulta órdenes de compra. Para devolución, envía el `document` de la salida. Puedes consultarlo en Consulta de movimientos de salida. Si no proviene de un movimiento, envía un valor de libre elección.
`code_user`	Texto	Sí	Código del usuario asociado al recurso humano responsable de la transacción. Puedes consultarlo en Consulta de recursos humanos, campo `code`.
`code_supplier`	Texto	Opcional	Código del tercero clasificado como proveedor. Puedes consultarlo en Consulta de terceros, campo `code`.
`value_cost_center`	Texto	Opcional	Código del centro de costo. No es necesario enviarlo si envías `description_cost_center`. Puedes consultarlo en Consultar centros de costo, campo `value`.
`description_cost_center`	Texto	Opcional	Descripción del centro de costo. No es necesario enviarlo si envías `value_cost_center`. Puedes consultarlo en Consultar centros de costo, campo `description`.
`note`	Texto	Opcional	Notas de la entrada.
`items`	Array de objetos JSON	Sí para entradas nuevas o parciales	Listado de recursos que se agregarán a la entrada. En entradas totales desde una orden de compra o una salida, no es necesario enviar este arreglo.

Objetos de `items`

Parámetro	Tipo	Requerido	Descripción
`code`	Texto	Sí	Código del recurso que se agregará a la entrada. El recurso debe estar asociado al almacén.
`qty`	Texto	Sí	Cantidad del recurso.
`unit_cost`	Real	Sí	Costo unitario.
`tax_name`	Texto	Opcional	Nombre del impuesto. Si no se envía, se asocia el impuesto por defecto de la empresa.
`serial_numbers`	Array de strings	Opcional	Envía este campo solo cuando el recurso está controlado por serial. Debes enviar la misma cantidad de seriales que la cantidad de recursos indicada en `qty`.

Ejemplo: entrada parcial desde una salida

{
  "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"
    }
  ]
}

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 del 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 de prioridad.
`priorities_description`	Texto	Prioridad.
`id_currency`	Entero	ID de 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`	Array JSON	Listado de los ítems asociados a la entrada.

Ejemplo 1: 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"
    }
  ]
}

Respuesta

{
  "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 2: nueva entrada desde una orden de compra