API Endpoints
Fracttal →
Start typing to search…

Create purchase orders

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

Through this EndPoint you can create a purchase order to a warehouse.

A purchase order is made within a warehouse and it is mandatory that the assets that are being associated are part of the warehouse.

When making integration purchase orders, the following characteristics must be taken into account:

  • The currency or currency with which the PO is generated is the one associated by default with the company
  • The conditions are automatically selected from the supplier information chosen.

Input parameters

Parameter Type Required Description
warehouse_code *Text* yes Warehouse Code
body *JSON* Optional JSON with the necessary information for the creation of the PO

Body parameters

Parameter Type Required Description
document *Text* Yes Purchase order reference
code_third_party *Text* Optional Supplier code of the purchase order (Third party supplier or service provider in Fracttal)
description_cost_center *Text* Optional Description of the cost center. (It is not necessary to send it if the value of the cost center is sent).
value_cost_center *Text* Optional Cost center code. (It is not necessary to send it if the cost center description is sent).
date *Text* Optional Date of delivery. Must be sent in the format 'YYYYY-MM-DD'. If this field is not entered, the default is the time the purchase order was created in Fracttal.
id_priority *Integer* Optional 1: Very High 2: High 3: Medium 4: Low 5: Very Low
description *Text* Optional Purchase order notes
items *Array de Json* Yes
Parameter Type of field Description
code Text Code of the item to be associated in the purchase order (must be associated to the warehouse)
tax_name Text Tax name
qty Text Required quantity
unit_cost Real Unit cost. Must have the tax associated with it applied
total_cost Real Total Cost.Must be the multiplication of the quantity and unit cost
.

Output parameters

Parámetro Tipo Descripción
id *Integer* Id of the movement
date *Date* Delivery date
description *Text* Description of the entry.
document *Text* Reference
id_third_party *Text* id of the third party
third_parties_name *Text* Name of third party
third_parties_code *Text* Third party code
id_cost_center *Text* Cost Center Id
costs_center_description *Text* Description of the Cost Center
costs_center_value *Text* Cost center value
folio_source *Text* Source warehouse movement ID
folio_target *Text* Destination warehouse movement ID
date_create *Text* Date of creation of the movement
id_priority *Text* Id Priority
priorities_description *Text* Priority
id_currency *Number* Currency id
currency_description *Text* Currency description
currency_symbol *Text* Currency symbol
currency_symbol *Text* Currency symbol
movements_states_description *Text* Description of the movement status

Example:

Request: (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
}

Test It

Language