Through this web service you can create an entry to a non-integrated Fracttal warehouse.
The types of entries that can be made are: Purchase and Return
**Entry for a purchase
-A new purchase: In this type of entry you must send all the resources that will enter the warehouse with their respective quantities and prices. In this type of entry, the resources are assigned by default the tax that each company has selected as default. A purchase that comes from a purchase order: for this type of entry you must send the ID of the purchase order created in the warehouse. A FULL OR PARTIAL entry can be made for the resources that are associated to the selected purchase order. If you want to make a partial entry, you must send the array with the code of items and quantities it will have. In the case of a Total entry, it is not necessary to send the items.
**Entry by return
This type of entry is made when returning the materials that have been delivered by means of a stock removal. For this type of entry you must send the ID of the issue created in the warehouse. When using this type of entry, you can make a FULL OR PARTIAL entry of the resources associated with the issue. If you want to make a partial entry, you must send the array with the code of items and quantities that the entry will have. In the case of a Total entry, it is not necessary to send the items.
Example partial entry:
{
"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"
}
]
}
When entries are made by integration it is mandatory to send the code of a human resource responsible for the transaction. This user must have a Fracttal account created.
When the entries are related to movements within the warehouse, the information of the supplier, cost center and currency will be automatically assigned from the source movement (either from a purchase order or an issue). In case you want to modify them, you must send the parameters in the web service.
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 entry |
Body parameters
| Parameter | Type | Required | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
movement_type | Number | Yes* | Type of movement: 1 = Purchase 2 = Return | ||||||||||||||||||||||||
is_from_movement | Boolean | Optional* | True, in case you want to make an entry for an existing movement in Fracttal (purchase or exit order). False in the case of creating a new entry, manually entering the items. The default value is false. | ||||||||||||||||||||||||
document | Text | Yes* | Reference of the entry. If it comes from a purchase order or an output within Fracttal, the ID of that movement must be sent, otherwise it is a random text defined by the user. | ||||||||||||||||||||||||
code_user | Text | Yes* | Code of the user responsible for the transaction | ||||||||||||||||||||||||
code_supplier | Text | Optional* | Code of the third party that is classified as a supplier. | ||||||||||||||||||||||||
value_cost_center | Text | Optional* | Cost center code. (It is not necessary to send it if the cost center description is sent). | ||||||||||||||||||||||||
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). | ||||||||||||||||||||||||
note | Text | Optional* | Notes on the entry | ||||||||||||||||||||||||
items | Json Array | Yes* |
|
Output parameters
| Parameter | Type | Description |
|---|---|---|
folio_target | Intger | Id of the movement |
date | date | Date of entry |
description | Text | Note from 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_value | Text | Cost center value |
costs_center_description | Text | Description of the Cost Center |
folio_source | Text | Source 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 |
movements_states_description | Text | Description of the movement status |
movement_details | Json array | List of items that were associated with the entry |
- Example New Entry without associated transactions:
Request: (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
}
- Example New Entry from a purchase order :
Request: (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
}
Test It