Trip API (v2)

Download OpenAPI description
Languages
Servers
Mock server
https://developer.spotnana.com/_mock/openapi/tripapi/
Staging URL
https://apis.spotnana.com/

Trips

APIs to manage trips and PNRs.

Operations

Invoicing

Operations

Get Invoice Data

Request

This endpoint gets the invoice data for given invoice numbers

Bodyapplication/json
invoiceIdsArray of strings(uuid)

One or more Invoice IDs being requested

Example: ["15c94ac1-f540-4916-9243-306a75fbd8a9"]
tmcIdstringDeprecated

TMC for which invoice is being requested. Deprecated in favor of invoiceIds.

Example: "15c94ac1-f540-4916-9243-306a75fbd8a9"
invoiceNumbersArray of stringsDeprecated

One or more invoice numbers being requested. Deprecated in favor of invoiceIds.

curl -i -X POST \
  https://developer.spotnana.com/_mock/openapi/tripapi/v2/invoicing/invoice-data \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "tmcId": "15c94ac1-f540-4916-9243-306a75fbd8a9",
    "invoiceNumbers": [
      "string"
    ],
    "invoiceIds": [
      "15c94ac1-f540-4916-9243-306a75fbd8a9"
    ]
  }'

Responses

OK

Bodyapplication/json
invoicesArray of objects(Invoice)required

List of invoices which were requested.

invoices[].​invoiceNumberstringrequired

The invoice number

Example: "SPOT-0001232"
invoices[].​invoiceIdstringrequired

The invoice ID

Example: "d694cf94-534e-410e-b66b-11ef970622bc"
invoices[].​dataobject(InvoiceData)required

Actual Data

invoices[].​data.​issuedDateobject(DateModel)required

Date in ISO 8601 standard.

invoices[].​data.​issuedDate.​iso8601string^\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01...required
Example: "2017-07-21"
invoices[].​data.​sellerobject(SellerInfo)required

Entity that sold the items mentioned in the invoice.

invoices[].​data.​seller.​namestringrequired

Name of seller, usually a TMC Legal Entity.

Example: "Spotnana India Pvt. Ltd."
invoices[].​data.​seller.​addressstringrequired

Address of seller.

Example: "115 Broadway Suite 04-101,\nNew York, NY 10006"
invoices[].​data.​seller.​idInfoArray of objects(IdInfo)

The seller ID information.

invoices[].​data.​seller.​taxIdstringDeprecated

Tax number for the seller, for ex GSTN in India

Example: "TXG239023092"
invoices[].​data.​buyerobject(BuyerInfo)required

Buyer of items mentioned in the invoice.

invoices[].​data.​buyer.​namestringrequired

Name of buyer, usually a traveler.

Example: "John Doe"
invoices[].​data.​buyer.​addressstringrequired

Address of buyer. Could be office, legal entity or org address.

Example: "115 Broadway Suite 04-101,\nNew York, NY 10006"
invoices[].​data.​buyer.​idInfoArray of objects(IdInfo)

The seller ID information.

invoices[].​data.​buyer.​taxIdstringDeprecated

Tax number for the seller, for ex GSTN in India

Example: "TXG239023092"
invoices[].​data.​itemsArray of objects(Item)required

Items being invoiced.

invoices[].​data.​items[].​namestringrequired

Name of the item.

Example: "Air Ticket SFO-EWR"
invoices[].​data.​items[].​identifierstringrequired

Number identifying the item, for ex, the ticket number for air ticket.

Example: "00129383829"
invoices[].​data.​items[].​purchaseTypestringrequired

Type of item, indicates what type of item is being sold

Enum"TRIP_FEE""FLIGHT""ANCILLARY""HOTEL""CAR""RAIL"
Example: "TRIP_FEE"
invoices[].​data.​items[].​typestringrequired

Type of item, indicates if the item was purchased vs refunded.

Enum"PURCHASE""REFUND"
Example: "PURCHASE"
invoices[].​data.​items[].​amountobject(FareAmount)required

Fare amount including base fare and tax.

invoices[].​data.​items[].​amount.​baseobject(Money)required

Money object containing details such as the amount, the currency code, and the converted amount.

invoices[].​data.​items[].​amount.​taxobject(Money)required

Money object containing details such as the amount, the currency code, and the converted amount.

invoices[].​data.​items[].​travelerNamestringrequired

Name of the traveler.

Example: "John Doe"
invoices[].​data.​items[].​taxBreakdownArray of objects(TaxBreakdown)

Tax breakdown for the invoice, this will be present for UK invoices with VAT

invoices[].​data.​items[].​itemNameMetadataticketMetadata (object) or ticketMetadata (object) or ticketMetadata (object)(ItemNameMetadata)
One of:

AirItemNameMetadata information.

invoices[].​data.​paymentsArray of objects(PaymentInformation)required

Information on how the items have been paid for.

invoices[].​data.​payments[].​idstring

Payment reference ID.

Example: "sdkljhafisudlls"
invoices[].​data.​payments[].​transactionTimeobject(DateTimeOffset)

ISO8601 UTC Date Time

invoices[].​data.​payments[].​amountobject(Money)required

Money object containing details such as the amount, the currency code, and the converted amount.

invoices[].​data.​payments[].​amount.​amountnumber(double)required

The numeric value for the amount of money.

Example: 510
invoices[].​data.​payments[].​amount.​currencyCodestringrequired

The 3-letter currency code for the money amount (defined using ISO 4217 standard).

Example: "GBP"
invoices[].​data.​payments[].​amount.​convertedAmountnumber(double)

The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).

Example: 715.42
invoices[].​data.​payments[].​amount.​convertedCurrencystring

The 3-letter currency code for the converted currency (defined using ISO 4217 standard).

Example: "USD"
invoices[].​data.​payments[].​amount.​otherCoinageArray of objects(OtherCoinage)

List of the dollar amount in other coinage systems like reward points, cryptocurrency etc.

invoices[].​data.​payments[].​paymentModestringrequired

Mode of Payment shown on invoice.

Enum"CREDIT_CARD""ON_ACCOUNT""DIRECT""EXCHANGE""BREX_POINTS""CASH""QANTAS_POINTS""VENDOR_PROGRAM_PAYMENT""AMADEUS_CHECKOUT""PREVIOUS_BOOKING_VALUE"
Example: "CREDIT_CARD"
invoices[].​data.​payments[].​paymentInstrumentIdentifierstringrequired

An identifier for the payment instrument used. For example, last four credit card number digits in case a credit card was used.

Example: "**2343"
invoices[].​data.​payments[].​actualPaymentobject(ActualPayment)

Payment done via supported Spotnana payment types.

invoices[].​data.​payments[].​exchangePaymentobject(ExchangePayment)

In case of exchange, payment accounted to the original ticket.

invoices[].​data.​productIdstringrequired

ID of the product being invoiced

Example: "123243223"
invoices[].​data.​productTypestring(ProductType)required

Type of product being invoiced

Enum"PNR""SERVICE_FEE"
invoices[].​data.​invoiceAmountobject(FareAmount)required

Fare amount including base fare and tax.

invoices[].​data.​invoiceAmount.​baseobject(Money)required

Money object containing details such as the amount, the currency code, and the converted amount.

invoices[].​data.​invoiceAmount.​base.​amountnumber(double)required

The numeric value for the amount of money.

Example: 510
invoices[].​data.​invoiceAmount.​base.​currencyCodestringrequired

The 3-letter currency code for the money amount (defined using ISO 4217 standard).

Example: "GBP"
invoices[].​data.​invoiceAmount.​base.​convertedAmountnumber(double)

The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).

Example: 715.42
invoices[].​data.​invoiceAmount.​base.​convertedCurrencystring

The 3-letter currency code for the converted currency (defined using ISO 4217 standard).

Example: "USD"
invoices[].​data.​invoiceAmount.​base.​otherCoinageArray of objects(OtherCoinage)

List of the dollar amount in other coinage systems like reward points, cryptocurrency etc.

invoices[].​data.​invoiceAmount.​taxobject(Money)required

Money object containing details such as the amount, the currency code, and the converted amount.

invoices[].​data.​invoiceAmount.​tax.​amountnumber(double)required

The numeric value for the amount of money.

Example: 510
invoices[].​data.​invoiceAmount.​tax.​currencyCodestringrequired

The 3-letter currency code for the money amount (defined using ISO 4217 standard).

Example: "GBP"
invoices[].​data.​invoiceAmount.​tax.​convertedAmountnumber(double)

The converted currency and amount that has been converted (if a currency conversion has been requested). For example, if the call requests that money be sent in a specified currency (because the frontend requested the backend to send money in the user's preferred currency).

Example: 715.42
invoices[].​data.​invoiceAmount.​tax.​convertedCurrencystring

The 3-letter currency code for the converted currency (defined using ISO 4217 standard).

Example: "USD"
invoices[].​data.​invoiceAmount.​tax.​otherCoinageArray of objects(OtherCoinage)

List of the dollar amount in other coinage systems like reward points, cryptocurrency etc.

invoices[].​data.​taxBreakdownArray of objects(TaxBreakdown)

Tax breakdown for the invoice, this will be present for UK invoices with VAT

invoices[].​data.​referenceIdsArray of objects(ReferenceId)required

Reference Numbers to be shown on the invoice, for ex, Trip ID, PNR ID etc.

invoices[].​data.​referenceIds[].​labelstringrequired

Label for the reference ID on invoice.

Enum"TRIP_ID""PNR_ID""AGENCY_REFERENCE"
Example: "AGENCY_REFERENCE"
invoices[].​data.​referenceIds[].​valuestringrequired

The reference ID.

Example: "122332432"
invoices[].​data.​regionCodestring(RegionCode)

The region code for which the following invoicing information is applicable.

Enum"US""UK""NL""SG""CA""MX""DO""AR""BR""CO"
Example: "US"
invoices[].​data.​documentTypestring

Type of document

Enum"INVOICE""RECEIPT""NONE"
Example: "INVOICE"
invoices[].​data.​footerTextstring

Text shown at bottom of the PDF document. Nothing is shown if not set.

Example: "This document is proof of payment. If you require a tax invoice, please request one from the travel provider."
Response
application/json
{ "invoices": [ {} ] }