The project company and owner (Project Manager) will be set to the current token’s owner / company.

It’s possible to create multiple project lines with this service.

See the Project/LineItems service for a description of the necessary fields necessary to create a Project Line.

Invitations

When creating a Project, it’s possible to automatically create a few invitations for external partners.

See the example below for the format to be used:

invites: {
  users: [
    {
      "id": "user1@winddle.com",
      "position": "PositionA"
    },
    {
      "id": "user2@winddle.com"
      "position": "PositionA"
    }
  ],
  "workgroups": ["WorkgroupA"]
}

This would invite 2 users (with PositionA) as well as all the users in the WorkgroupA (with the correct position).

It’s equivalent to inviting them on each project lines individually.

Params

Param name Description
name
required

Project name

Must be a String
owner
optional

Project’s main project manager (owner), if not set, default to current user. Has to be an employee of the Project’s company.

A Winddle User. Can be either a user ID (unique integer) or a user Email.
line_items
optional

An array of Project Line to be created and attached to the new project (at least one)

Must be an array of any type
source_id
optional

ID in Customer’s source system (optional, max 255 char.)

Must be a String
reference
optional

Project reference

Must be a String
season
optional

Project season

Must be a String or an Integer
warehouse
optional

Warehouse (name)

Must be a String
warehouse_code
optional

Warehouse (code)

Must be a String
incoterm
optional

Incoterm

Must be one of: dat, dap, exw, fca, fas, fob, cfr, cif, cip, cpt, ddp.
departure_place
optional

Departure place

Must be a String
country_of_origin
optional

Country of origin

Must be a String
arrival_place
optional

Arrival place

Must be a String
transportation_mode
optional

Transportation mode

Must be a String
payment_conditions
optional

Payment conditions

Must be a String
project_type
optional

Project type

Must be one of: order, development, mixed.
laboratory
optional

Laboratory

Must be a String
final_customer
optional
Must be a String or an Integer
final_customer_name
optional

Final Customer name when there are no matching Winddle Company Contact

Must be a String
final_customer_clear
optional

Reset the final customer

Boolean (true/false)
factory
optional
Must be a String or an Integer
factory_name
optional

Factory name when there are no matching Winddle Factory Contact

Must be a String
factory_clear
optional

Reset the factory

Boolean (true/false)
supplier_name
optional

Supplier name when there are no matching Winddle Contact

Must be a String
supplier
optional
Must be a String or an Integer
supplier_clear
optional

Reset the supplier

Boolean (true/false)
forwarder_name
optional

Forwarder name when there are no matching Winddle Contact

Must be a String
forwarder
optional
Must be a String or an Integer
forwarder_clear
optional

Reset the forwarder

Boolean (true/false)
buyer
optional

Project’s secondary project manager. Has to be an employee of the Project’s company

A Winddle User. Can be either a user ID (unique integer) or a user Email.
customs
optional

Custom values for the Project

An array of Custom Values for the Product.

Each element of this array should have the following format:

{
 field: The Winddle ID or the Name of the Custom Field
 value: The value for this field
}

Not providing a value for a Field will leave it as blank or keep its current value if any has been set.

invoice_version
optional

{id: id of a temp attachment or invoice version, temp: true if temp attachment, type: standard or proformat}

Must be a Hash