Using 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, the ID of the purchase order created in the warehouse must be sent. You can make a TOTAL OR PARTIAL entry of 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 you return materials that have been delivered through a warehouse issue. For this type of entry, the ID of the issue created in the warehouse must be sent.

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.

EndPoint

https://app.fracttal.com/api/warehouse_entries_orders/:warehouse_code

warehouse_code = Warehouse code

POST Method

Parameters Input

Parameter

Field type

Required

Description

warehouse_code

Texto

Yes

Warehouse Code

body

JSON

Optional

JSON with the necessary information for the creation of the entry

Body parameters

Parameter

Field type

Required

Description

movement_type

Number

Yes

Type of movement:

is_from_movement

Boolean

Opcional

1 = Purchase

document

Text

Yes

2 = Return

code_user

Text

True, in case you want to make an entry for an existing movement in Fracttal (purchase order or output). False in the case of creating a new entry, manually entering the items. The default value is false

code_supplier

Text

Optional

Reference of the entry. If it comes from a purchase order or an output within Fracttal, the ID of that transaction must be sent, otherwise it is a random text defined by the user.

value_cost_center

Text

Optional

Code of the user responsible for the transaction

description_cost_center

Text

Optional

Code of the third party that is classified as a supplier.

note

Text

Optional

Code of the cost center. (It is not necessary to send it if the description of the cost center is sent).

items

Json Array

Yes

Description of the cost center. (Not required if the value of the cost center is submitted)

Output parameters

Parameter

Field type

Description

folio_target

Integer

Transaction ID

date

date

Date of entry

description

Text

Note of the entry.

document

Text

Reference

id_third_party

Text

id of the third party

third_parties_name

Text

Name of the 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

Cost center description

folio_source

Text

Source Warehouse Movement ID

date_create

Text

Date the movement was created

id_priority

Text

Priority ID

priorities_description

Text

Priority

id_currency

Número

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

Examples:

Example New Entry without associated transactions :

EndPoint: https://app.fracttal.com/api/warehouse_entries_orders/002

Body

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

Reply

{ 
"success": true,
"message": "200",
"data": {
"id": 3977,
"folio_target": "MOV206ANTO",
"date": "2019-10-18",
"description": " Entry by integration ",
"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": " CHILEAN PESO ",
"currency_symbol": "$",
"movements_states_description": "IN",
"movement_details": [
{
"id_item": 5075,
"items_description": " VALVOLINE OIL EURO 15W40 { 38079 } VALVOLINE",
"code": "38079",
"units_description": "LITERS",
"qty": 50,
"unit_cost": 5794,
"total_cost": 344743,
"tax_name": "IVA",
"tax_rate": 19
},
{
"id_item": 12437,
"items_description": " HAGIE MESH FILTER 690629 MMRVH6900 HYUNDAI { MMRVH6900 }",
"code": "MMRVH6900",
"units_description": "UNIT",
"qty": 8,
"unit_cost": 42533,
"total_cost": 404914,
"tax_name": "IVA",
"tax_rate": 19
},
{
"id_item": 5470,
"items_description": " CROWN AND PINION GEAR SHORT SHAFT KIT 11X38 MFSerie 300 11X38 Fabricante { 4890255A-R1 }",
"code": "4890255A-R1",
"units_description": "UNIT",
"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": " Machine ",
"qty": 5,
"unit_cost": 135,
"total_cost": 803.25,
"tax_name": "IVA",
"tax_rate": 19
}
]
},
"total": 1
}

2. Example New Entry from a purchase order :

EndPoint: https://app.fracttal.com/api/warehouse_entries_orders/002

Body

{ 
"movement_type":"1",
"is_from_movement":true,
"code_user": "25198772-2",
"document":"OC34ANTO",
"note":" Entry from integration purchase order "
}

Reply

{ 
"success": true,
"message": "200",
"data": {
"id": 3998,
"folio_target": "MOV224ANTO",
"date": "2019-10-18",
"description": " Entry from integration purchase order ",
"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": "CHILEAN PESO",
"currency_symbol": "$",
"movements_states_description": "IN",
"movement_details": [
{
"id_item": 5470,
"items_description": " CROWN AND PINION SHORT SHAFT KIT 11X38 MFSeries 300 { 4890255A-R1 } Manufacturer ",
"code": "4890255A-R1",
"units_description": "UNIT",
"qty": 45,
"unit_cost": 980,
"total_cost": 52479,
"tax_name": "IVA",
"tax_rate": 19
},
{
"id_item": 20,
"items_description": " CALIBRATION TABS { 0000AC-21 }",
"code": "0000AC-21",
"units_description": "GAME",
"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": "LITERS",
"qty": 5,
"unit_cost": 6894.86,
"total_cost": 41024.4,
"tax_name": "IVA",
"tax_rate": 19
}
]
},
"total": 1
}

Did this answer your question?