Store Transaction

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"
    }
}