API Endpoints
Fracttal →
Start typing to search…

Crear ordenes de compra

post https://app.fracttal.com/api/warehouse_purchase_orders/

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. Es por esto que el parámetro en la url warehouse_code es el código del almacén al cual se le quiere crear una orden de compra. Se puede consultar aquí. (campo code)

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.

Parámetros de entrada

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

Parámetro Tipo Requerido Descripción
document *Texto* Sí Referencia de la orden de compra
code_third_party *Texto* Opcional Código del proveedor de la orden de compra (Tercero de tipo proveedor ó proveedor de servicios en Fracttal). [Se puede consultar aquí. ](https://api.fracttal.com/reference/consulta-de-terceros)(campo *code*)
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)
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)
date *Texto* 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 *Entero* Opcional 1: Muy Alta 2: Alta 3: Media 4: Baja 5: Muy baja
description *Texto* Opcional Notas de la orden de compra
items *Array de objetos Json* Sí
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 Descripción
id *Entero* Id del movimiento
date *Date* Fecha de entrega
description *Texto* Descripción 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_description *Texto* Descripción del centro de Costos
costs_center_value *Texto* Valor del centro de Costos
folio_source *Texto* Id del movimiento del almacén fuente
folio_target *Texto* Id del movimiento del almacén de destino
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
currency_symbol *Texto* Símbolo de la divisa
movements_states_description *Texto* Descripción del estado del movimiento
movement_details *Arrays de objetos Json* Detalle de los items en la orden de compra

Detalle del objeto movement_details

Parámetro Tipo Descripción
id_item *Entero* Id del item
items_description *Fecha* Descripción del ítem
code *Texto* Código del item
qty *Texto* Cantidad pedida en la orden de compra
unit_cost *Texto* Costo unitario
total_cost *Texto* Costo total
tax_name *Texto* Descripción del tipo de impuesto que aplica

Ejemplo:

Petición: (POST)https://app.fracttal.com/api/warehouse_purchase_orders/1254

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