- Getting Started
- Endpoints
- Authentication
- Customers
- Exemptions
- Transactions
- Address Validation
- Sales Tax Rates
- Vat Validation
- Special Features
Upsert VAT / GT Transactio
PUT
/v1/transactions/source/{source}/externalId/{externalId}
transaction
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************
Path Params
externalId
string
required
Example:
{{transactionExternalId}}
source
string
required
Example:
{{source}}
Match pattern:
[1-9]
Body Params application/json
A transaction between the API consumer and a customer
complytId
string <uuid>
optional
externalId
string
required
>= 1 characters<= 256 characters
source
string
required
Match pattern:
^(10|[1-9])$
documentName
string
optional
>= 0 characters<= 50 characters
items
array [object {16}]
required
unitPrice
number
optional
quantity
number
optional
totalPrice
number
optional
calculatedTotal
number
optional
description
string
optional
name
string
required
>= 1 characters<= 256 characters
taxCode
string
required
>= 0 characters<= 256 characters
jurisdictionalSalesTaxRules
object
optional
salesTaxRates
object (SalesTaxRates)
optional
gtRates
object (GtRates)
optional
manualSalesTax
boolean
optional
manualSalesTaxRate
number
optional
<= 0.2
discount
number
optional
relativeTransactionDiscount
number
optional
tangibleCategory
enum<string>
optional
Allowed values:
TANGIBLEINTANGIBLE
taxableCategory
enum<string>
optional
Allowed values:
TAXABLENOT_TAXABLE
isTaxInclusive
boolean
optional
billingAddress
object (billingAddress)
optional
city
string
optional
>= 0 characters<= 100 characters
country
string
optional
>= 0 characters<= 50 characters
county
string
optional
>= 0 characters<= 100 characters
state
string
optional
>= 0 characters<= 100 characters
street
string
optional
>= 0 characters<= 200 characters
region
string
optional
>= 0 characters<= 20 characters
zip
string
optional
>= 0 characters<= 20 characters
shippingAddress
object (shippingAddress)
required
city
string
required
>= 0 characters<= 100 characters
country
string
required
>= 0 characters<= 50 characters
county
string
optional
>= 0 characters<= 100 characters
state
string
required
>= 0 characters<= 100 characters
street
string
required
>= 0 characters<= 200 characters
region
string
optional
>= 0 characters<= 20 characters
zip
string
required
>= 0 characters<= 20 characters
isPartial
boolean
required
matchedAddressData
object
optional
customerId
string <uuid>
required
customer
object (Customer)
optional
complytId
string <uuid>
optional
externalId
string
required
>= 1 characters<= 256 characters
source
string
required
Match pattern:
^(10|[1-9])$
name
string
optional
>= 1 characters<= 256 characters
address
object
optional
email
string
optional
customerType
enum<string>
optional
Allowed values:
RETAILMARKETPLACERESELLERRETAIL_EXEMPT
internalTimestamps
object (internalTimestamps)
optional
externalTimestamps
object (externalTimestamps)
required
comment
string
optional
>= 0 characters<= 200 characters
salesTax
object
optional
amount
number
optional
rate
number
optional
salesTaxRates
object
optional
gtRates
object (GtRates)
optional
transactionStatus
enum<string>
required
Allowed values:
ACTIVECANCELLEDPAID
internalTimestamps
object (internalTimestamps)
optional
externalTimestamps
object (externalTimestamps)
required
transactionType
enum<string>
required
Allowed values:
SALES_ORDERINVOICEESTIMATEREFUNDTAXABLE_REFUND
shippingFee
object (ShippingFee)
optional
manualSalesTax
boolean
optional
manualSalesTaxRate
number
optional
totalPrice
number
optional
taxCode
string
required
>= 0 characters<= 256 characters
salesTaxRates
object (SalesTaxRates)
required
gtRates
object (GtRates)
required
createdFrom
string
optional
>= 0 characters<= 256 characters
taxableItemsAmount
number