Generate Quote

Resource:
/api/quote/generate
Method:
POST

This interface is used to generate a quote. A quote can contain multiple projects.

Quotes can be generated using different inputs:

  • Product elements, which are are inserted into the generate quote request
  • Files that were uploading using the Add File API.
  • Projects that were added using the Add Project API. These projects contain either files or products. The advantage of generating a quote out of individual projects is that it allows you more flexibility. For example, you can have different source languages, target languages, and even services.

The API client should use an API key set associated with a customer (merchant) account when submitting and retrieving projects on behalf of that customer. This will establish ownership of that project for access control and also attribute transactions to individual customer accounts. The API client can create an customer account using the Create Account API.

Request Body

Parameter Type Comments
TranslationOptions
Container

Contains information

specifying the

translation project.

TranslationOptions

.Currency
String

String representing

currency that the

merchant wishes to pay

with. See glossary for

list of valid

currencies.

TranslationOptions

.ServiceID
Integer

Numeric service code

for the translation

service.  The service

defines a set of

options such as machine

translation with post

edit on the title and

raw machine translation

on the body.  This

element is optional

and ignored for quotes

that are generated from

projects.

TranslationOptions

.SourceLanguage
Container

Contains 1 source

language. This

element is optional

and ignored for quotes

that are generated from

prjoects.

TranslationOptions

.SourceLanguage

.LanguageCode

String See LanguageCode in glossary

TranslationOptions

.SpecialInstructions
String (optional)

Special instructions for use

by translators.

TranslationOptions

.TargetLanguages
Container

Contains 1 or more

target languages. This

element is optional

and ignored for quotes

that are generated from

projects.

TranslationOptions

.TargetLanguages

.TargetLanguage

.LanguageCode

String See LanguageCode in glossary

TranslationOptions

.TranslationAcceptanceMethod
String (optional)

Tells onDemand how you would

like to track file

acceptance. With the

default method, “implicit,”

we consider a file accepted

when it is downloaded.

With the optional “explicit”

method we do not mark the

file as accepted until we

receive a request to the

Accept Translation API,

see Accept File Translation.

File acceptance/rejection

is only intended to be used

by API clients that do

integrity checks on

deliveries.

These methods are not

intended to be used for

subjective feedback on

translation quality.

Products
List

List of Product

Elements. Products

are only allowed as

input if the service

supports products.

Products

.Product

.Title

String The title of the product

Products

.Product

.PrimaryCategory

Integer

ID of the product’s

primary category

Products

.Product

.TopLevelCategory

Integer

ID of the top level

category that the

product sits in

Products

.Product

.CategoryPath

String

Delimited string

showing the path

through the category

hierarchy to the

primary category.  This

is mainly for

contextual information

for the translators.

Products

.Product

.Description

String

The description of the

item.  This element can

contain sub-elements.

HTML that is not well

formed XML should be

wrapped in CDATA tags.

Products

.Product

.SKUs

Container Contains a SKU elements

Products

.Product

.SKUs

.SKU

Container

Contains a SKU Number

and a list of

ItemSpecifics that are

relevant to the SKU

Products

.Product

.SKUs

.SKU

.SKUNumber

String SKU Number

Products

.Product

.SKUs

.SKU

.ItemSpecifics

Container

Contains elements

representing

specifications.

Products

.Product

.SKUs

.SKU

.ItemSpecifics

.ItemSepecific

Container

Contains elements

representing name-value

pairs

Products

.Product

.SKUs

.SKU

.ItemSpecifics

.ItemSpecific

.Name

String The name of the name value pair

Products

.Product

.SKUs

.SKU

.ItemSpecifics

.ItemSpecific

.Value

String The name of the name value pair
Files
Container

A collection of file

elements. The files

referenced need to

supported by the

selected service.

See List Services

Files

.File
Container

A file is described

with a AssetID of a

previously uploaded file

(see Add File)

Files

.File

.AssetID

Integer

AssetID of previously

uploaded file. Note:

the file type needs to

be consistent with the

valid file types for

the service. Also,

a file cannot be

associated with more

that one quote.

ReferenceFiles

.ReferenceFile
Container

Container for a reference file.

A reference file is used to

inform the work that is being

done. There is no charge for

reference files. Reference

are always optional.

ReferenceFiles

.ReferenceFile

.AssetID

Integer Asset ID of the reference file.

NotificationSubscriptions

.NotificationSubscription
Container

Container for a notification

subscription. See the

Notification Subscriptions

page for more information

NotificationSubscriptions

.NotificationSubscription

.EventName

String

Event in a project’s life cycle

that will trigger the sending of

the notification.

NotificationSubscriptions

.NotificationSubscription

.Endpoint

String

Where the notification should be

sent.

Product Request Example

<GenerateQuote>
    <TranslationOptions>
        <Currency>EUR</Currency>
        <ServiceID>54</ServiceID>
        <SourceLanguage>
            <LanguageCode>en-gb</LanguageCode>
        </SourceLanguage>
        <TargetLanguages>
            <TargetLanguage>
                <LanguageCode>it-it</LanguageCode>
            </TargetLanguage>
                <TargetLanguage>
                    <LanguageCode>fr-fr</LanguageCode>
                </TargetLanguage>
         </TargetLanguages>
        <SpecialInstructions>Special instructions for this project</SpecialInstructions>
    </TranslationOptions>
    <Products>
        <Product>
            <Title>The title of the item</Title>
            <PrimaryCategory>123</PrimaryCategory>
            <TopLevelCategory>1</TopLevelCategory>
            <CategoryPath>Clothing : Menswear : Shoes</CategoryPath>
            <Description>
                <!--
                    This can be an XML block containing arbitrary,
                    well formed sub elements.
                -->

                <Summary>
                    <![CDATA[
                            This is a summary it can contain HTML markup.
                            To tell the translation service to ignore some
                            text, wrap it in a
                            [do-not-translate]
                            do not translate
                            [/do-not-translate]
                            tag
                            ]]>

                </Summary>
                <Features>
                    <Feature1>Feature 1</Feature1>
                    <Feature2>Feature 2</Feature2>
                </Features>
            </Description>
            <SKUs>
                <SKU>
                   <SKUNumber>1234</SKUNumber>
                    <ItemSpecifics>
                        <ItemSpecific>
                            <Name>Color</Name>
                            <Value>White</Value>
                        </ItemSpecific>
                        <ItemSpecific>
                            <Name>Size</Name>
                            <Value>Large</Value>
                        </ItemSpecific>
                  </ItemSpecifics>
                </SKU>
            </SKUs>
        </Product>
    </Products>
    <ReferenceFiles>
        <ReferenceFile>
            <AssetID>12345</AssetID>
        </ReferenceFile>
        <ReferenceFile>
            <AssetID>12346</AssetID>
        </ReferenceFile>
    </ReferenceFiles>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscriptions>
</GenerateQuote>

File Request Example

<GenerateQuote>
    <TranslationOptions>
        <Currency>EUR</Currency>
        <ServiceID>54</ServiceID>
        <SourceLanguage>
            <LanguageCode>en-gb</LanguageCode>
        </SourceLanguage>
        <TargetLanguages>
            <TargetLanguage>
                <LanguageCode>it-it</LanguageCode>
            </TargetLanguage>
                <TargetLanguage>
                    <LanguageCode>fr-fr</LanguageCode>
                </TargetLanguage>
         </TargetLanguages>
    </TranslationOptions>
    <Files>
        <File>
            <AssetID>123456</AssetID>
        </File>
    </Files>
    <ReferenceFiles>
        <ReferenceFile>
            <AssetID>12345</AssetID>
        </ReferenceFile>
        <ReferenceFile>
            <AssetID>12346</AssetID>
        </ReferenceFile>
    </ReferenceFiles>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscriptions>
</GenerateQuote>

Project Request Example

<GenerateQuote>
    <TranslationOptions>
        <Currency>EUR</Currency>
        <SpecialInstructions>Special instructions for this project</SpecialInstructions>
    </TranslationOptions>
    <Projects>
        <Project>
            <ProjectID>123456</ProjectID>
        </Project>
    </Projects>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscriptions>
</GenerateQuote>

Return Codes

Status Code Comments
Created 201 The project was created
Bad Request 400

This is probably

because of a malformed

request body.

Unauthorized 401

The request did not

pass authentication or

the customer is not a

member of an enterprise

site.

Conflict 409

This is probably

because of an invalid

parameter such as the

wrong service id or

incompatible file types.

Response Body

The response body contains a quote for a project. Please note: the response may not contain a price. If the submitted files

Property Type Comments
QuoteID
Integer

onDemand ID of the

Quote.

CreationDate
String

String representing the

date/time in the ISO

8601 format. that the

project was created in

UTC.

Status
String

The status of the quote.

“Pending” means that the

source content has been

analyzed and the

project(s) has/have

been priced.

“Analyzing” means that

the price is still

being determined and

the client should

call Get Quote

later to check on the

status.

AuthorizeURL
String

URL to authorize the

quote.  See

Authorize Quote

RejectURL
String

Use this to reject the

quote. See Reject Quote

TotalTranslations
Integer

The number of

translations requested.

For example, if the

merchant sends 5

products to be

translated into 3

languages, the value of

TotalTranslations would

be 15.

TranslationCredit
Integer

Number of free

translations available

at the selected service

level.

Currency
String

Currency that the price

is in. See glossary

for list of valid

currencies.

TotalCost
Decimal

Total price that needs

to be paid. Exclude

translation credit.

PrepaidCredit
Decimal

If a merchant has a

positive credit balance

with onDemand, it will

be reported here.

AmountDue
Decimal TotalCost - PrepaidCredit
TranslationAcceptanceMethod
String

Method to track file

acceptance.

Projects

.Project

.Products

Container Container of products

Projects

.Project

.Products

.Product

.SKUs

Container

Container of SKU

elements

Projects

.Project

.Products

.Product

.SKUs

.SKU

Container Container of a SKU

Projects

.Project

.Products

.Product

.SKUs

.SKU

.SKUNumber

String Item SKU

Projects

.Project

.Products

.Product

.AssetID

Integer

onDemand internal ID

for the listing

Projects

.Project

.Products

.Product

.DueDate

String

String representing

date/time (ISO 8601

format) that the

translation of the item

is scheduled to be

completed in UTC

Projects

.Project

.Files

.File

.AssetID

Integer Asset ID of the file.

Projects

.Project

.Files

.File

.FileName

String

Original name of the

file.

Projects

.Project

.ProjectID

Integer

ProjectID of included

project

Projects

.Project

.ProjectName

String The name of the project

Projects

.Project

.ServiceID

Integer

The ID of the service

used.

Projects

.Project

.SourceLanguage

.LanguageCode

String

The language code of

source language.

Projects

.Project

.TargetLanguages

.TargetLanguage

.LanguageCode

String

The language code of

a target language.

Projects

.Project

.ReferenceFiles

.ReferenceFile

Container

Container for a

reference file. A

reference file is used

to inform the work that

is being done. There is

no charge for reference

files.

Projects

.Project

.ReferenceFiles

.ReferenceFile

.AssetID

Integer

Asset ID of the

reference file.

Projects

.Project

.ReferenceFiles

.ReferenceFile

.FileName

String

Original name of

the file.

Projects

.Project

.ReferenceFiles

.ReferenceFile

.URL

String

URL where the file

can be downloaded.

Projects

.Project

.ReferenceFiles

.ReferenceFile

.TargetLanguages

Container Empty element.

NotificationSubscriptions

.NotificationSubscription
Container

Container for a

notification

subscription.

NotificationSubscriptions

.NotificationSubscription

.EventName

String

Event in a project’s

life cycle that will

trigger the sending of

the notification.

NotificationSubscriptions

.NotificationSubscription

.Endpoint

String

Where the notification

will be sent.

Product-Based Quote Response Example

<Quote>
    <QuoteID>132</QuoteID>
    <CreationDate>2014-01-25T10:32:02Z</CreationDate>
    <Status>Pending</Status>
    <AuthorizeURL>https://…</AuthorizeURL>
    <RejectURL>https://</RejectURL>
    <TotalTranslations>2</TotalTranslations>
    <TranslationCredit>1</TranslationCredit>
    <TotalCost>10.00</TotalCost>
    <PrepaidCredit>5.00</PrepaidCredit>
    <AmountDue>5.00</AmountDue>
    <Currency>EUR</Currency>
    <TranslationAcceptanceMethod>implicit</TranslationAcceptanceMethod>
    <Projects>
            <Project>
                <ProjectID>999</ProjectID>
                <ProjectName>Name of project</ProjectName>
                <ServiceID>54</ServiceID>
                <SourceLanguage>
                    <LanguageCode>en-gb</LanguageCode>
                </SourceLanguage>
                <TargetLanguages>
                            <TargetLanguage>
                                <LanguageCode>it-it</LanguageCode>
                            </TargetLanguage>
                            <TargetLanguage>
                                <LanguageCode>fr-fr</LanguageCode>
                            </TargetLanguage>
                </TargetLanguages>
                <Products>
                        <Product>
                            <AssetID>999</AssetID>
                            <SKUs>
                                <SKU>
                                    <SKUNumber>123</SKUNumber>
                                </SKU>
                            </SKUs>
                            <DueDate>2014-02-11T10:22:46Z</DueDate>
                        </Product>
                </Products>
                <ReferenceFiles>
                    <ReferenceFile>
                        <AssetID>12345</AssetID>
                        <FileName>my-file.txt</FileName>
                        <URL>https://ondemand.liondemand.com/api/files/12345</URL>
                        <TargetLanguages />
                    </ReferenceFile>
                    <ReferenceFile>
                        <AssetID>12346</AssetID>
                        <FileName>my-file.txt</FileName>
                        <URL>https://ondemand.liondemand.com/api/files/12346</URL>
                        <TargetLanguages />
                    </ReferenceFile>
                </ReferenceFiles>
                <SpecialInstructions>Special instructions for this project</SpecialInstructions>
            </Project>
    </Projects>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
    <Errors></Errors>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
</Quote>

If the price is not yet ready, the response will look like:

<Quote>
    <QuoteID>132</QuoteID>
    <CreationDate>2014-01-25T10:32:02Z</CreationDate>
    <Status>Calculating</Status>
    <TotalTranslations>2</TotalTranslations>
    <TranslationCredit>1</TranslationCredit>
    <TotalCost/>
    <PrepaidCredit/>5.00</PrepaidCredit>
    <AmountDue/>
    <Currency>EUR</Currency>
    <TranslationAcceptanceMethod>implicit</TranslationAcceptanceMethod>
    <Projects>
            <Project>
                <ProjectID>999</ProjectID>
                <ProjectName>Name of project</ProjectName>
                <ServiceID>54</ServiceID>
                <SourceLanguage>
                    <LanguageCode>en-gb</LanguageCode>
                </SourceLanguage>
                <TargetLanguages>
                            <TargetLanguage>
                                <LanguageCode>it-it</LanguageCode>
                            </TargetLanguage>
                            <TargetLanguage>
                                <LanguageCode>fr-fr</LanguageCode>
                            </TargetLanguage>
                </TargetLanguages>
                <Products>
                        <Product>
                            <AssetID>999</AssetID>
                            <SKUs>
                                <SKU>
                                    <SKUNumber>123</SKUNumber>
                                </SKU>
                            </SKUs>
                        </Product>
                </Products>
                <ReferenceFiles>
                    <ReferenceFile>
                        <AssetID>12345</AssetID>
                        <FileName>my-file.txt</FileName>
                        <URL>https://ondemand.liondemand.com/api/files/12345</URL>
                        <TargetLanguages />
                    </ReferenceFile>
                    <ReferenceFile>
                        <AssetID>12346</AssetID>
                        <FileName>my-file.txt</FileName>
                        <URL>https://ondemand.liondemand.com/api/files/12346</URL>
                        <TargetLanguages />
                    </ReferenceFile>
                </ReferenceFiles>
                <SpecialInstructions>Special instructions for this project</SpecialInstructions>
            </Project>
    </Projects>
    <Errors></Errors>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
</Quote>

File-Based Quote Response Example

<Quote>
    <QuoteID>132</QuoteID>
    <CreationDate>2014-01-25T10:32:02Z</CreationDate>
    <Status>Pending</Status>
    <AuthorizeURL>https://…</AuthorizeURL>
    <RejectURL>https://</RejectURL>
    <TotalCost>10.00</TotalCost>
    <PrepaidCredit>5.00</PrepaidCredit>
    <AmountDue>5.00</AmountDue>
    <Currency>EUR</Currency>
    <TranslationAcceptanceMethod>implicit</TranslationAcceptanceMethod>
    <Projects>
            <Project>
                <ProjectID>999</ProjectID>
                <ProjectName>Name of project</ProjectName>
                <ServiceID>54</ServiceID>
                <SourceLanguage>
                    <LanguageCode>en-gb</LanguageCode>
                </SourceLanguage>
                <TargetLanguages>
                            <TargetLanguage>
                                <LanguageCode>it-it</LanguageCode>
                            </TargetLanguage>
                            <TargetLanguage>
                                <LanguageCode>fr-fr</LanguageCode>
                            </TargetLanguage>
                </TargetLanguages>
                <Files>
                        <File>
                            <AssetID>999</AssetID>
                            <FileName>example.txt</FileName>
                        </File>
                </Files>
                <ReferenceFiles>
                    <ReferenceFile>
                        <AssetID>12345</AssetID>
                        <FileName>my-file.txt</FileName>
                        <URL>https://ondemand.liondemand.com/api/files/12345</URL>
                        <TargetLanguages />
                    </ReferenceFile>
                    <ReferenceFile>
                        <AssetID>12346</AssetID>
                        <FileName>my-file.txt</FileName>
                        <URL>https://ondemand.liondemand.com/api/files/12346</URL>
                        <TargetLanguages />
                    </ReferenceFile>
                </ReferenceFiles>
                <SpecialInstructions></SpecialInstructions>
            </Project>
    </Projects>
    <Errors></Errors>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
</Quote>

If the price is not yet ready, the response will look like:

<Quote>
    <QuoteID>132</QuoteID>
    <CreationDate>2014-01-25T10:32:02Z</CreationDate>
    <Status>Calculating</Status>
    <TotalCost/>
    <PrepaidCredit/>5.00</PrepaidCredit>
    <AmountDue/>
    <Currency>EUR</Currency>
    <TranslationAcceptanceMethod>implicit</TranslationAcceptanceMethod>
    <Projects>
        <Project>
            <Files>
                <File>
                    <AssetID>999</AssetID>
                    <FileName>example.txt</FileName>
                </File>
            </Files>
            <ReferenceFiles>
                <ReferenceFile>
                    <AssetID>12345</AssetID>
                    <FileName>my-file.txt</FileName>
                    <URL>https://ondemand.liondemand.com/api/files/12345</URL>
                    <TargetLanguages />
                </ReferenceFile>
                <ReferenceFile>
                    <AssetID>12346</AssetID>
                    <FileName>my-file.txt</FileName>
                    <URL>https://ondemand.liondemand.com/api/files/12346</URL>
                    <TargetLanguages />
                </ReferenceFile>
            </ReferenceFiles>
            <SpecialInstructions></SpecialInstructions>
        </Project>
    </Projects>
    <Errors></Errors>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
</Quote>

If one of or more files submitted are not compatible with the selected service, the response will look like

<Quote>
    <Error>
        <ReasonCode>202</ReasonCode>
        <SimpleMessage>The file example.txt, is not supported by the Voiceover Translation Service</SimpleMessage>
        <DetailedMessage>The Video Translation Service only supports the following file types: .mov, .mp4, .flv, and .wmv</DetailedMessage>
    </Error>
</Quote>

Project Based Quote Response Example

<Quote>
    <QuoteID>132</QuoteID>
    <CreationDate>2014-01-25T10:32:02Z</CreationDate>
    <Status>Pending</Status>
    <AuthorizeURL>https://…</AuthorizeURL>
    <RejectURL>https://</RejectURL>
    <TotalCost>10.00</TotalCost>
    <PrepaidCredit>5.00</PrepaidCredit>
    <AmountDue>5.00</AmountDue>
    <Currency>EUR</Currency>
    <TranslationAcceptanceMethod>implicit</TranslationAcceptanceMethod>
    <Projects>
            <Project>
                <ProjectID>999</ProjectID>
                <ProjectName>Name of project</ProjectName>
                <ServiceID>54</ServiceID>
                <SourceLanguage>
                    <LanguageCode>en-gb</LanguageCode>
                </SourceLanguage>
                <TargetLanguages>
                            <TargetLanguage>
                                <LanguageCode>it-it</LanguageCode>
                            </TargetLanguage>
                            <TargetLanguage>
                                <LanguageCode>fr-fr</LanguageCode>
                            </TargetLanguage>
                </TargetLanguages>
            <ReferenceFiles/>
            <SpecialInstructions>Special instructions for this project</SpecialInstructions>
            </Project>
    </Projects>

    <Errors></Errors>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
</Quote>

If the price is not yet ready, the response will look like:

<Quote>
    <QuoteID>132</QuoteID>
    <CreationDate>2014-01-25T10:32:02Z</CreationDate>
    <Status>Calculating</Status>
    <TotalCost/>
    <PrepaidCredit/>5.00</PrepaidCredit>
    <AmountDue/>
    <Currency>EUR</Currency>
    <TranslationAcceptanceMethod>implicit</TranslationAcceptanceMethod>
    <Projects>
            <Project>
                <ProjectID>999</ProjectID>
                <ProjectName>Name of project</ProjectName>
                <ServiceID>54</ServiceID>
                <SourceLanguage>
                    <LanguageCode>en-gb</LanguageCode>
                </SourceLanguage>
                <TargetLanguages>
                            <TargetLanguage>
                                <LanguageCode>it-it</LanguageCode>
                            </TargetLanguage>
                            <TargetLanguage>
                                <LanguageCode>fr-fr</LanguageCode>
                            </TargetLanguage>
                </TargetLanguages>
                <ReferenceFiles/>
                <SpecialInstructions>Special instructions for this project</SpecialInstructions>
            </Project>
    </Projects>

    <Errors></Errors>
    <NotificationSubscriptions>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>mailto:test@test.com</Endpoint>
        </NotificationSubscription>
        <NotificationSubscription>
            <EventName>quote-ready</EventName>
            <Endpoint>http://www.test.com</Endpoint>
        </NotificationSubscription>
    </NotificationSubscription>
</Quote>

If one of or more of the projects is already included in another quote, the response will look like this:

<Quote>
    <Error>
        <ReasonCode>207</ReasonCode>
        <SimpleMessage>The Project(s) with IDs 1223, 2222 are already in use.</SimpleMessage>
        <DetailedMessage>
            Projects with the following IDs are already associated with another quote.
        </DetailedMessage>
    </Error>
</Quote>

Errors

If generate quote encountered an error, the response will contain an Error element consisting of a ReasonCode, SimpleMessage, and DetailedMessage elements. See Error Handling and Rate Throttling for more information. Here are some common cases.

ReasonCode SimpleMessage DetailedMessage
200 Miscellaneous error

A miscellaneous or

unexpected error

has occured.

201

There was a problem

with the source content.

Request body could not

parsed. Please verify

that the XML is well-

formd and the encoding

is correct.

202

This service is not

compatable with the

submitted source

content.

The selected service

does not support the

submitted source

content.

203 Asset does not exist.

A file with this asset

ID does not exist in

the system.

204 Asset is already in use.

One or more of the

referenced assets is

being used in another

project.

205

Incompatible Source

Language.

File with id {id} is in

the wrong language for

this project

206 Project does not exist.

A project with this

ID does not exist in

the system.

207

Project is already in

use.

One or more of the

referenced projects is

being used in another

quote.