Store Transaction

You can use this endpoint and a POST method to store transaction data.

The service stores a transaction to enable the displaying of tax information for unconfirmed payments.

To store a transaction, use a POST method and the following URL:

{Taxamo_MP_URL}/api/v3/marketplace/transactions

where {Taxamo_MP_URL} is the URL of the Taxamo environment.

For example:

curl --request POST \
  --url https://marketplace-api.sandbox.marketplace.taxamo.com/api/v3/marketplace/transactions \

Details

Type	Value
Endpoint	`/api/v3/marketplace/transactions`
Method	POST
Seller API Reference Documentation	Store Transaction

Fields

For more information about the fields that you can include in the request, see Fields Reference Overview.

Request Example

For example, here is the body of an operation for store the sale as an unconfirmed transaction:

curl --request POST \
  --url https://marketplace-api.sandbox.marketplace.taxamo.com/api/v3/marketplace/transactions \
  --header 'content-type: application/json' \
  --header "x-marketplace-token: $TOKEN" \
  --data '{
	"transaction": {
		"currency_code": "EUR",
		"buyer_name": "Scenario #1 buyer",
    "invoice_timestamp": "2020-05-20T01:59:59+04:00",
		"ship_to_address": {
			"street_name": "30 Monmouth Street",
			"city": "Bath",
			"postal_code": "BA1 2AP",
			"country_code": "GB"
		},   
		"description": "Example sale to GB.",
		"transaction_lines": [
			{
        "seller_code": "EU1M",
				"custom_id": "line_1",
				"amount": 200,
				"ship_from_address": {"country_code": "CN"},
				"product_class": "P",
				
				"description": "Goods #1",				
				"parcel_reference": "3897329872423",
				"carrier_id": "DHL",
        "product_cn_code": "8504 31 80 15",
        "product_reference_number": ""
        
        
			}, 
    {
        "seller_code": "CN1M",
				"custom_id": "line_2",
				"amount": 100,
				"ship_from_address": {"country_code": "PL"},
				"product_class": "P",
				
				"description": "Goods #2",				
				"parcel_reference": "3897329872423",
				"carrier_id": "DHL",
        "product_cn_code": "8504 31 80 15",
        "product_reference_number": ""
        
        
    }]
	}
}'

Response Example

The following output is returned, containing the key ( "key" : "PJyj7WQAAAAYTSOvTCmQLpBvs7KRe1lL6v3GSnQ") attribute that will be used in the subsequent requests.

{
   "transaction" : {
      "update_timestamp" : 1591104250934,
      "required_fields" : {
         "storage_required_fields" : [],
         "tax_required_fields" : [],
         "audit_required_fields" : []
      },
      "invoice_timestamp" : "2020-05-20T01:59:59+04:00",
      "tax_amount" : 20,
      "ship_to_address" : {
         "country_code" : "GB",
         "street_name" : "30 Monmouth Street",
         "city" : "Bath",
         "postal_code" : "BA1 2AP"
      },
      "description" : "Example sale to GB.",
      "currency_code" : "EUR",
      "tax_liability_owner_codes" : "buyer,P1",
      "invoice_place" : "VILLENEUVE D'ASCQ, 4 BD DE MONS",
      "location_evidence" : {},
      "invoice_address" : {
         "country_code" : "GB",
         "postal_code" : "BA1 2AP",
         "city" : "Bath",
         "street_name" : "30 Monmouth Street"
      },
      "product_classes" : "P",
      "amount" : 300,
      "total_amount" : 320,
      "transaction_lines" : [
         {
            "deducted_tax_amount" : 0,
            "reverse_charge" : false,
            "carrier_id" : "DHL",
            "tax_engine" : "taxamo",
            "unit_price" : 200,
            "kind" : "b2c",
            "quantity" : 1,
            "tax_country_code" : "GB",
            "taxes" : [],
            "product_reference_number" : "",
            "description" : "Goods #1",
            "tax_liability_owner_code" : "buyer",
            "tax_liability_rule" : "physical-shipment-into-EU-goods-above-150-eur",
            "amount" : 200,
            "custom_id" : "line_1",
            "tax_entity_name" : "United Kingdom",
            "total_amount" : 200,
            "product_cn_code" : "8504 31 80 15",
            "parcel_reference" : "3897329872423",
            "ship_from_address" : {
               "country_code" : "CN"
            },
            "line_num" : 1,
            "deducted_tax_rate" : 0,
            "tax_address_kind" : "ship-to-address",
            "seller_code" : "EU1M",
            "tax_region" : "EU",
            "product_class" : "P",
            "tax_supported" : true,
            "tax_number_service" : "vies",
            "line_key" : "mpbZeqL1Dclo52tp"
         },
         {
            "line_num" : 2,
            "ship_from_address" : {
               "country_code" : "PL"
            },
            "seller_code" : "CN1M",
            "tax_region" : "EU",
            "tax_address_kind" : "ship-to-address",
            "tax_entity_name" : "United Kingdom",
            "total_amount" : 120,
            "product_cn_code" : "8504 31 80 15",
            "parcel_reference" : "3897329872423",
            "back_to_back_transaction_key" : "PUEp5agAAAAg3V1FBAAAAAEFBQVkAAA5pVFNPdlBKeWo3V1FBQUFBWVRTT3ZUQ21RTHBCdnM3S1JlMWxMNnYzR1NuUS5QLlBMLjg",
            "line_key" : "5fdQ8TiVelhNXMrZ",
            "tax_supported" : true,
            "product_class" : "P",
            "tax_number_service" : "vies",
            "back_to_back_invoice_country_code" : "PL",
            "tax_engine" : "taxamo",
            "unit_price" : 100,
            "quantity" : 1,
            "kind" : "b2c",
            "back_to_back_external_unique_id" : "PJyj7WQAAAAYTSOvTCmQLpBvs7KRe1lL6v3GSnQ.P.PL.8",
            "reverse_charge" : false,
            "carrier_id" : "DHL",
            "tax_amount" : 20,
            "tax_liability_rule" : "physical-shipment-inside-EU-seller-outside-EU",
            "tax_liability_owner_code" : "P1",
            "custom_id" : "line_2",
            "amount" : 100,
            "tax_country_code" : "GB",
            "product_reference_number" : "",
            "taxes" : [
               {
                  "amount_fraction_taxable" : 1,
                  "tax_name" : "European VAT physical",
                  "rate" : 20,
                  "rate_type" : "Standard"
               }
            ],
            "description" : "Goods #2"
         }
      ],
      "test" : false,
      "buyer_name" : "Scenario #1 buyer",
      "key" : "PJyj7WQAAAAYTSOvTCmQLpBvs7KRe1lL6v3GSnQ",
      "countries" : {},
      "marketplace_code" : "P1",
      "create_timestamp" : "2020-06-02T13:24:10Z",
      "status" : "N",
      "tax_country_codes" : "GB"
   }
}