Store Transaction
Read about how to use the Store Transaction request to enable the displaying of tax information for unconfirmed payments.
To store a transaction, use a POST method and the following URL:
{Taxamo_A_URL}/api/v3/seller/transactions
where {Taxamo_A_URL} is the URL of the sandbox or production environment.
For example:
curl --request POST \
--url https://seller-transaction-api.sandbox.marketplace.taxamo.com/api/v3/seller/transactions \
Details
| Type | Value |
|---|---|
| Endpoint | /api/v3/seller/transactions |
| Method | POST |
| Seller API Reference Documentation | Store Transaction |
Fields
The ship_to field is required for the Store Transaction request.
For a full list of fields, see Fields Reference Overview.
Request Example
The following example shows some information that you may want to add in the JSON of this request:
{
"transaction": {
"currency_code": "EUR",
"buyer_name": "Eric Papin",
"ship_to_address": {
"address_detail": "Chateuax 12",
"building_number": "55",
"street_name": "Rue du Saint-Germain",
"city": "Paris",
"postal_code": "75008 ",
"country_code": "FR"
},
"transaction_lines": [
{
"product_class": "P",
"quantity": 1,
"description": "Smoked herrings",
"amount": "19.95",
"custom_id": "51315A00-DC44-408E-A575-8CE42A32AE1B",
"import_address":{
"country_code": "FR"
},
"ship_from_address": {
"building_number": "12",
"street_name": "Wessex End Street",
"city": "London",
"postal_code": "SW1A 2AA",
"country_code": "GB"
},
"product_cn_code": "0305420000"
}
]
}
}
Response Example
Here is an example of some of the information that might be returned by the API:
{
"transaction": {
"ship_to_address": {
"city": "Paris",
"country_code": "FR",
"postal_code": "75008 ",
"street_name": "Rue du Saint-Germain",
"address_detail": "Chateuax 12",
"building_number": "55",
"tax_region": "EU"
},
"amount": 62.99,
"required_fields": {
"tax_required_fields": [],
"audit_required_fields": [],
"storage_required_fields": []
},
"marketplace_code": "Taxamo",
"tax_country_codes": "FR",
"key": "PoTgs5wAAG86O8NvyCmIBpBTKnNRg8CDMfw-zgw",
"tax_amount": 6.3,
"invoice_timestamp": "2021-07-15T11:49:32Z",
"tax_liability_owner_codes": "Taxamo",
"create_timestamp": "2021-07-15T11:49:32Z",
"countries": {},
"transaction_lines": [
{
"description": "Smoked herrings",
"reverse_charge": false,
"amount": 62.99,
"tax_rule_applied": "physical-tax",
"unit_price": 62.99,
"taxes": [
{
"rate": 10,
"tax_name": "European VAT",
"rate_type": "Reduced",
"amount_fraction_taxable": 1,
"tax_base_amount": 62.99
}
],
"tax_amount": 6.3,
"import_address": {
"country_code": "FR",
"tax_region": "EU"
},
"tax_liability_rule": "physical-shipment-into-EU-goods-below-150-eur-with-ioss-non-EU-supplier",
"platform_liability_assumed_amount": 62.99,
"seller_tax_number": "IE3764989CH",
"tax_region": "EU",
"invoice_place": "The RDI Hub, Killarney Road, Killorglin, Co. Kerry, V93 KP68",
"tax_exempt": false,
"additional_currencies": {
"consignment": {
"currency_code": "EUR",
"fx_date": "2021-07-15T11:49:32Z",
"fx_rate": 1,
"fx_source": "ECB"
}
},
"tax_country_code": "FR",
"special_tax_scheme": "IOSS",
"line_key": "bWSB5VXnAKfR2P1R",
"custom_id": "51315A00-DC44-408E-A575-8CE42A32AE1B",
"tax_address_kind": "ship_to_address",
"ship_from_address": {
"city": "London",
"country_code": "GB",
"postal_code": "SW1A 2AA",
"street_name": "Wessex End Street",
"building_number": "12",
"tax_region": "GB"
},
"tax_engine": "taxamo",
"invoice_status": "R",
"kind": "b2c",
"tax_number_service": "vies",
"product_class": "P",
"fees": [
{
"amount": {
"amount": 6.3,
"currency_code": "EUR"
},
"fee_key": "cf-7d535uzvGLwNP",
"rule": "tax-fee",
"type": "tax-fee",
"seller_code": "seller_vertex_5",
"currency_code": "EUR"
}
],
"tax_liability_owner_code": "Taxamo",
"line_num": 1,
"is_seller_permanent": true,
"quantity": 1,
"total_amount": 69.29,
"seller_code": "seller_vertex_5",
"product_cn_code": "0305420000",
"tax_entity_name": "France",
"tax_supported": true
}
],
"discounts": [],
"location_evidence": {},
"vouchers": [],
"refunded_tax_amount": 0,
"product_classes": "P",
"billing_address": {
"city": "Paris",
"country_code": "FR",
"postal_code": "75008 ",
"street_name": "Rue du Saint-Germain",
"address_detail": "Chateuax 12",
"building_number": "55",
"tax_region": "EU"
},
"status": "N",
"refunded_total_amount": 0,
"update_timestamp": "2021-07-15T11:49:32Z",
"fees": [
{
"amount": {
"amount": 2,
"currency_code": "GBP"
},
"fee_key": "bIjg2-uGHIrTOmOU",
"rule": "flat-fee",
"type": "amount-fee",
"seller_code": "seller_vertex_5"
}
],
"buyer_name": "Eric Papin",
"tax_timestamp": "2021-07-15T11:49:32Z",
"total_amount": 69.29,
"currency_code": "EUR"
}
}
Updated over 1 year ago