POST Create supplier

The Create Supplier API will let you create a new supplier into your Toursys platform.

Parameters:

• supplier_type - (String, Required) | Suppliers's categorization. The supplier types are registered in a table in the Toursys platform, if a supplier type is sent, and is not registered in Toursys it will be created within the system automatically, and you will be able to filter by this information.

• supplier_code - (String, Required) | Supplier's unique reference code

• supplier_legal_name - (String, Required) | Supplier's legal name

• supplier_commercial_name - (String, Required) | Supplier’s commercial name

• supplier_id_type - (String, Required) | Id type code, you can check on the id type code here. If the id type code you send is not correct, then an error will be shown and the customer will not be created.

• supplier_id_number - (String, Required) | Id number base on the "supplier_id_type" information

• supplier_language - (String, Required) | Language code that represents the language the supplier communicates with you or speaks. You can check on the managed languages on here

• supplier_location - (String, Required) | Country, city or place where this supplier resides. You will be able to filter by this information

• supplier_office_address - (String, Required) | Specific address for the supplier

• supplier_email - (String, Required) | Supplier's communication email

• supplier_internal_comments - (String, Optional) | Comments only the Toursys users will see

• supplier_transactional_currency - (String, Optional) | Supplier's main currency (Currency ISO code)

• supplier_rate_currency - (String, Optional) | Supplier's rates currency (Currency ISO code)

• supplier_prepayment_days - (Int, Optional) | Number of days prior to service by which the supplier must be paid

• supplier_credit_days - (Int, Optional) | Payment date will be the end date of the reservation + credit days. If credit days are 0 and prepayment days are 0, this is a cash supplier.

• supplier_accepts_pets - (Boolean, Optional) | If supplier allows pets or not. | (0 = No pets allowed, 1 = Pets allowed)

• supplier_certificate_1 - (String, Optional) | Certification type name (ex. stars, leaves, forks, etc.)

• supplier_certificate_1_ranking - (Int, Optional) | Ranking number for the certificate

• supplier_certificate_2 - (String, Optional) | Certification type name (ex. stars, leaves, forks, etc.)

• supplier_certificate_2_ranking - (Int, Optional) | Ranking number for the certificate

• supplier_certificate_3 - (String, Optional) | Certification type name (ex. stars, leaves, forks, etc.)

• supplier_certificate_3_ranking - (Int, Optional) | Ranking number for the certificate

• supplier_business_address - (String, Optional) | Supplier’s business address

• supplier_website - (String, Optional) | Supplier's website URL

• supplier_phone - (String, Optional) | Supplier's phone number

• supplier_contacts - (List, Required) | List of supplier contacts

  • • contact_code - (String, Required) | Code to identify the contact

    • contact_first_name - (String, Required) | First name of the contact

    • contact_last_name - (String, Required) | Last name of the contact

    • contact_gender - (Boolean, Required) | Gender of the contact | (0 = Male, 1 = Female)

    • contact_email - (String, Required) | Contact email

    • contact_phone - (String, Required) | Contact phone or cellphone

• supplier_information - (List, Optional) | List of supplier information

  • • information_language - (String, Required) | Language code that identifies the language the information is being provided. You can check on the managed languages on here

    • information_short_description - (String, Required) | Short description for the supplier

    • information_long_description - (String, Optional) | Long more detailed description for the supplier

    • information_policies - (String, Optional) | Supplier's policies

    • information_general_comments - (String, Optional) | Supplier's general comments

Example Request

Error codes:

BAD_GATEWAY - 500

• 001 - A supplier with the code provided already exists in Toursys. Each supplier code must be unique.

• 002 - The following fields are required, please check they all have data: supplier code, supplier legal name, supplier commercial name, supplier type, supplier language, supplier location, supplier office address, and supplier email.

• 003 - You must provide at least 1 contact for the supplier. 

• 004 - Invalid supplier ID type code. Please provide a valid one.

• 005 - There is no supplier with that identification code in Toursys.

Related links:

Endpoint

General Error Codes

Language codes

Id Type codes