Quotes.batch_create_or_update

Create or update an batch of Quotes

Request

Query Params

validation-level

integer <int32>

optional

Specify validation level of Quotes on change. Use them as bit mask: 0 - validate each field on entity,
2 - validate only changed fields, 4 - validate only system fields, 8 - allows to override readonly fields,
16 - allows to set entity on deleted relationship.

rollback-method

integer <int32>

optional

Specify rollback method for Quotes. 0 - rollback all, 1 - rollback only failed records.

Body Params application / json

array of:

currency_exchange_rates_list_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

description

string

optional

Multi-line text input field.

Example:

string

expiration_date

string <date>

optional

Date information.

Example:

2019-01-01

is_archived

boolean

optional

Boolean value.

Example:

false

name

string

optional

Name of the entity and its default text representation.

Example:

string

oppty_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

owner_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

product_currency_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

product_price_list_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

product_sections

object

optional

Product sections on Opportunity in json format

quick_account_email

string

optional

Simple text input field.

Example:

string

quick_account_name

string

optional

Simple text input field.

Example:

string

quick_account_phone

string

optional

Simple text input field.

Example:

string

quick_contact_name

string

optional

Simple text input field.

Example:

string

quick_email

string

optional

Simple text input field.

Example:

string

quick_phone

string

optional

Simple text input field.

Example:

string

quote_type_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

reason_of_close_description

string

optional

Multi-line text input field.

Example:

string

reason_of_close_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

share_mode

enum<integer>

optional

Integer enum value: 0 - Standard, 1 - Private, 2 - AllView, 3 - AllEdit

Allowed values:

0123

Example:

step_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

unit_id

string <uuid>

optional

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

version

integer <int32>

optional

Whole natural number.

Example:

revision

integer <int32>

optional

Revision when entity was lastly changed.

Example:

total_amount

object

optional

Monetary value in a foreign currency.

base_value

number <double>

required

Currency.

Example:

4.32

currency_id

string <uuid>

required

Relation to single entity instance.

Example:

01234567-abcd-dcba-ffff-000000000000

value_foreign

number <double>

required

Decimal number.

Example:

4.32

product_relations

array [object {1}]

optional

Relations to Products.

string <uri>

optional

contact_relations

array [object {1}]

optional

Relations to Contacts.

string <uri>

optional

account_relations

array [object {1}]

optional

Relations to Accounts.

string <uri>

optional

documents

array [object {1}]

optional

Relations to CloudObjects.

string <uri>

optional

sharing_units

array [object {1}]

optional

Relations to SalesUnits.

string <uri>

optional

sharing_clients

array [object {1}]

optional

Relations to Clients.

string <uri>

optional

is_active_in_opportunity

boolean

optional

If quote is set as active in opportunity.

Example:

false

static_profiles

array [object {1}]

optional

Relations to Profiles.

string <uri>

optional

string <uuid>

optional

ID of object to update.

Example

[
    {
        "currency_exchange_rates_list_id": "01234567-abcd-dcba-ffff-000000000000",
        "description": "string",
        "expiration_date": "2019-01-01",
        "is_archived": false,
        "name": "string",
        "oppty_id": "01234567-abcd-dcba-ffff-000000000000",
        "owner_id": "01234567-abcd-dcba-ffff-000000000000",
        "product_currency_id": "01234567-abcd-dcba-ffff-000000000000",
        "product_price_list_id": "01234567-abcd-dcba-ffff-000000000000",
        "product_sections": {},
        "quick_account_email": "string",
        "quick_account_name": "string",
        "quick_account_phone": "string",
        "quick_contact_name": "string",
        "quick_email": "string",
        "quick_phone": "string",
        "quote_type_id": "01234567-abcd-dcba-ffff-000000000000",
        "reason_of_close_description": "string",
        "reason_of_close_id": "01234567-abcd-dcba-ffff-000000000000",
        "share_mode": 0,
        "step_id": "01234567-abcd-dcba-ffff-000000000000",
        "unit_id": "01234567-abcd-dcba-ffff-000000000000",
        "version": 1,
        "revision": 1,
        "total_amount": {
            "base_value": "4.32",
            "currency_id": "01234567-abcd-dcba-ffff-000000000000",
            "value_foreign": "4.32"
        },
        "product_relations": [
            {
                "id": "http://example.com"
            }
        ],
        "contact_relations": [
            {
                "id": "http://example.com"
            }
        ],
        "account_relations": [
            {
                "id": "http://example.com"
            }
        ],
        "documents": [
            {
                "id": "http://example.com"
            }
        ],
        "sharing_units": [
            {
                "id": "http://example.com"
            }
        ],
        "sharing_clients": [
            {
                "id": "http://example.com"
            }
        ],
        "is_active_in_opportunity": false,
        "static_profiles": [
            {
                "id": "http://example.com"
            }
        ],
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/entities/Quotes/batch-modify' \
--header 'Content-Type: application / json' \
--data-raw '[
    {
        "currency_exchange_rates_list_id": "01234567-abcd-dcba-ffff-000000000000",
        "description": "string",
        "expiration_date": "2019-01-01",
        "is_archived": false,
        "name": "string",
        "oppty_id": "01234567-abcd-dcba-ffff-000000000000",
        "owner_id": "01234567-abcd-dcba-ffff-000000000000",
        "product_currency_id": "01234567-abcd-dcba-ffff-000000000000",
        "product_price_list_id": "01234567-abcd-dcba-ffff-000000000000",
        "product_sections": {},
        "quick_account_email": "string",
        "quick_account_name": "string",
        "quick_account_phone": "string",
        "quick_contact_name": "string",
        "quick_email": "string",
        "quick_phone": "string",
        "quote_type_id": "01234567-abcd-dcba-ffff-000000000000",
        "reason_of_close_description": "string",
        "reason_of_close_id": "01234567-abcd-dcba-ffff-000000000000",
        "share_mode": 0,
        "step_id": "01234567-abcd-dcba-ffff-000000000000",
        "unit_id": "01234567-abcd-dcba-ffff-000000000000",
        "version": 1,
        "revision": 1,
        "total_amount": {
            "base_value": "4.32",
            "currency_id": "01234567-abcd-dcba-ffff-000000000000",
            "value_foreign": "4.32"
        },
        "product_relations": [
            {
                "id": "http://example.com"
            }
        ],
        "contact_relations": [
            {
                "id": "http://example.com"
            }
        ],
        "account_relations": [
            {
                "id": "http://example.com"
            }
        ],
        "documents": [
            {
                "id": "http://example.com"
            }
        ],
        "sharing_units": [
            {
                "id": "http://example.com"
            }
        ],
        "sharing_clients": [
            {
                "id": "http://example.com"
            }
        ],
        "is_active_in_opportunity": false,
        "static_profiles": [
            {
                "id": "http://example.com"
            }
        ],
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    }
]'

Responses

🟢200OK

application/json

Creation confirmation. Returns a list of created / updated Quotes

Body

success

boolean

optional

True when response succeeded, false on error.

Example:

true

data

array [oneOf]

optional

string <uuid>

optional

And ID of created / updated entity.

object (Error)

optional

Example

{
    "success": true,
    "data": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
}

🔴500Server Error