(POST) Crear Órdenes de Compra

Mediante este EndPoint se puede crear una orden de compra a un almacén.

Una orden de compra se realiza dentro de un almacén y es obligatorio que los activos que se estén asociando  hagan parte del almacén.

Cuando se realizan órdenes de compra por integración, se debe tener en cuenta las siguientes características:

  • La divisa o moneda con la que se genera la OC es la que tiene asociada por defecto la empresa.
  • Las condiciones se seleccionan automáticamente de la información del proveedor que se elija.

EndPoint
https://app.fracttal.com/api/warehouse_purchase_order/:warehouse_code

warehouse_code = Código del almacén

Método POST

Parámetros Entrada

Parámetro Tipo de campo Requerido Descripción
warehouse_code Texto Código del Almacén
body JSON Opcional JSON con la información necesaria para la creación de la OC

Parámetros del body

Parámetro Tipo de campo Requerido Descripción
document Texto Referencia de la orden de compra
code_third_party Text Opcional Código del proveedor de la orden de compra (Tercero de tipo proveedor ó proveedor de servicios en Fracttal)
description_cost_center Text Opcional Descripción del centro de costo. (No es necesario enviarlo si se envía la el valor del centro de costo)
value_cost_center Text Opcional Código del centro de costo. (No es necesario enviarlo si se envía la description del centro de costo)
date Text Opcional Fecha de entrega. Debe ser enviada en el formato 'YYYY-MM-DD'. En caso de no ingresar este campo, por defecto es la hora de creación de la orden de compra en Fracttal
id_priority int Opcional 1: Muy Alta
2: Alta
3: Media
4: Baja
5: Muy baja
description Text Opcional Notas de la orden de compra
items Array de Json
Parámetro Tipo de campo Descripción
code Text Código del item a asociar en la orden de compra (debe estar asociado al almacén)
tax_name Text Nombre del impuesto
qty Texto Cantidad Solicitada
unit_cost Real Costo unitario. Debe tener aplicado el impuesto que se le asoció
total_cost Real Costo Total.Debe ser la multiplicación de la cantidad y el costo unitario

Parámetros de salida

Parámetro Tipo de campo Descripción
id Integer Id del movimiento
date date Fecha de entrega
description Text Descripción de la entrada.
document Text Referencia
id_third_party Text id del tercero
third_parties_name Text Nombre del tercero
third_parties_code Text Código del tercero
id_cost_center Text Id Centro de Costos
costs_center_description Text Descripción del centro de Costos
costs_center_value Text Valor del centro de Costos
folio_source Text Id del movimiento del almacén fuente
folio_target Text Id del movimiento del almacén de destino
date_create Text Fecha de creación del movimiento
id_priority Text Id Prioridad
priorities_description Text Prioridad
id_currency Número Id divisa
currency_description Text Descripción de la divisa
currency_symbol Text Símbolo de la divisa
currency_symbol Text Símbolo de la divisa
movements_states_description Text Descripción del estado del movimiento

Ejemplo:

Ejemplo Petición:

EndPointhttps://app.fracttal.com/api/warehouse_purchase_orders/1254

Body

{
"document":"OC_325",
"code_third_party":"00063960000109",
"cost_center": "Activos",
"date":"2019-10-22",
"id_priority":"2",
"description":"Nota de OC mediante integración",
"items":[
{
"code":"DEST01",
"qty": "9",
"unit_cost":5000,
"tax_name": "IVA"
},
{
"code":"0005010000100222",
"qty": "15",
"unit_cost":9800,
"tax_name": "IVA"
}
]

}

Respuesta

{
"success": true,
"message": "200",
"data": {
"id": "30",
"date": "2019-10-22",
"description": "Nota de OC mediante integración",
"document": "OC_325",
"id_third_party": 225,
"third_parties_name": "Walmart ",
"third_parties_code": "00063960000109",
"id_cost_center": 5,
"costs_center_description": "Activos",
"costs_center_value": "456465",
"folio_source": null,
"folio_target": "30",
"date_create": "2019-10-22T20:00:28.868832+00:00",
"id_priority": 2,
"priorities_description": "HIGH",
"id_currency": 4,
"currency_description": "Peso Colombiano",
"currency_symbol": "$",
"movements_states_description": "NOT_DELIVERED",
"movement_details": [
{
"id_item": 168,
"items_description": "VIDRIO OSCURO PARA CARETA SOLDADOR N°12 { 0005010000100222 }",
"code": "0005010000100222",
"qty": 15,
"unit_cost": 98700,
"total_cost": 1761800,
"tax_name": "IVA",
"tax_rate": 19
},
{
"id_item": 16,
"items_description": "Destornillador { DEST01 }",
"code": "DEST01",
"qty": 9,
"unit_cost": 5000,
"total_cost": 53550,
"tax_name": "IVA",
"tax_rate": 19
}
]
},
"total": 1
}