Accounting API Invoices & Orders

Update a one-time invoice

POST https://api.tamio.com/v2/orders/update/{uuid}

Updates an existing one-time invoice with new customer details, products, payment configuration, and other settings.

Path Parameters

uuid string*

UUID of the one-time invoice to update

Body Parameters

customer object*

Customer information for the invoice

JSON

{ "customer": { "id": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890", "billing_address_id": "b2c3d4e5-f678-90a1-b2c3-d4e5f67890a1", "shipping_address_id": "c3d4e5f6-7890-a1b2-c3d4-e5f67890a1b2" } }

id string*

Customer UUID

billing_address_id string

Billing address UUID (uses default if omitted)

shipping_address_id string

Shipping address UUID (uses default if omitted)

date object*

Invoice date (ISO format or Unix timestamp)

due_date object

Payment due date (ISO format or Unix timestamp)

label string

Invoice label/title

locale string

Language code for localization

currency string*

Three-letter ISO currency code

taxes string

Tax calculation method

accountoff

prefix string

Invoice number prefix (e.g., 'INV-')

invoice_number integer

Custom invoice number (auto-generated if omitted)

send_to_customer boolean

Send updated invoice to customer via email

custom_payment string

Custom payment instructions (required when no payment methods)

payments array of string

Payment method IDs enabled for this invoice

fulfillment_options FulfillmentOptions

shipping object

Shipping information and cost

JSON

{ "shipping": { "label": "Express Delivery", "cost": 1500 } }

label string*

Shipping method name

cost integer*

Shipping cost in smallest currency unit

products array of InvoiceProduct*

Products or services to invoice

JSON

{ "products": [ { "name": "Web Design", "price": 50000, "quantity": 1 } ] }

id string

Product UUID from catalog

variant string

Product variant UUID

name string

Custom product name (required if no id or variant)

price integer

Price in smallest currency unit (required if no id or variant)

quantity integer

Quantity

Responses

200 Invoice updated successfully

Invoice updated successfully

status integer

transaction object

Updated transaction object

invoice string

UUID of the updated invoice

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Invoice not found or belongs to another account

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Create a recurring invoice

Update a recurring invoice

/orders/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/orders/update/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "customer": {
9       "id": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
10       "billing_address_id": "b2c3d4e5-f678-90a1-b2c3-d4e5f67890a1",
11       "shipping_address_id": "c3d4e5f6-7890-a1b2-c3d4-e5f67890a1b2"
12     },
13     "date": "2024-01-15T10:00:00Z",
14     "due_date": "2024-02-15T10:00:00Z",
15     "label": "Updated Consultation Services",
16     "locale": "en",
17     "currency": "USD",
18     "taxes": "account",
19     "prefix": "INV-",
20     "invoice_number": 1042,
21     "send_to_customer": true,
22     "custom_payment": "Please pay via wire transfer to...",
23     "payments": [
24       "mollie_123"
25     ],
26     "fulfillment_options": {
27       "stock": false,
28       "accounting_systems": false,
29       "merchant_emails": false,
30       "customer_emails": false,
31       "automations": false,
32       "shipping_providers": false
33     },
34     "shipping": {
35       "label": "Express Delivery",
36       "cost": 1500
37     },
38     "products": [
39       {
40         "name": "Web Design",
41         "price": 50000,
42         "quantity": 1
43       }
44     ]
45   })
46 });
47 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/orders/update/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   customer: {
16     id: "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
17     billing_address_id: "b2c3d4e5-f678-90a1-b2c3-d4e5f67890a1",
18     shipping_address_id: "c3d4e5f6-7890-a1b2-c3d4-e5f67890a1b2"
19   },
20   date: "2024-01-15T10:00:00Z",
21   due_date: "2024-02-15T10:00:00Z",
22   label: "Updated Consultation Services",
23   locale: "en",
24   currency: "USD",
25   taxes: "account",
26   prefix: "INV-",
27   invoice_number: 1042,
28   send_to_customer: true,
29   custom_payment: "Please pay via wire transfer to...",
30   payments: ["mollie_123"],
31   fulfillment_options: {
32     stock: false,
33     accounting_systems: false,
34     merchant_emails: false,
35     customer_emails: false,
36     automations: false,
37     shipping_providers: false
38   },
39   shipping: {
40     label: "Express Delivery",
41     cost: 1500
42   },
43   products: [
44     {
45       name: "Web Design",
46       price: 50000,
47       quantity: 1
48     }
49   ]
50 }.to_json
51 
52 response = https.request(request)
53 puts response.read_body

Responses

{
  "status": 200,
  "transaction": {},
  "invoice": "00000000-0000-0000-0000-000000000000"
}

1	const response = await fetch("https://api.tamio.com/v2/orders/update/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"customer": {
9	"id": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
10	"billing_address_id": "b2c3d4e5-f678-90a1-b2c3-d4e5f67890a1",
11	"shipping_address_id": "c3d4e5f6-7890-a1b2-c3d4-e5f67890a1b2"
12	},
13	"date": "2024-01-15T10:00:00Z",
14	"due_date": "2024-02-15T10:00:00Z",
15	"label": "Updated Consultation Services",
16	"locale": "en",
17	"currency": "USD",
18	"taxes": "account",
19	"prefix": "INV-",
20	"invoice_number": 1042,
21	"send_to_customer": true,
22	"custom_payment": "Please pay via wire transfer to...",
23	"payments": [
24	"mollie_123"
25	],
26	"fulfillment_options": {
27	"stock": false,
28	"accounting_systems": false,
29	"merchant_emails": false,
30	"customer_emails": false,
31	"automations": false,
32	"shipping_providers": false
33	},
34	"shipping": {
35	"label": "Express Delivery",
36	"cost": 1500
37	},
38	"products": [
39	{
40	"name": "Web Design",
41	"price": 50000,
42	"quantity": 1
43	}
44	]
45	})
46	});
47	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/orders/update/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	customer: {
16	id: "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
17	billing_address_id: "b2c3d4e5-f678-90a1-b2c3-d4e5f67890a1",
18	shipping_address_id: "c3d4e5f6-7890-a1b2-c3d4-e5f67890a1b2"
19	},
20	date: "2024-01-15T10:00:00Z",
21	due_date: "2024-02-15T10:00:00Z",
22	label: "Updated Consultation Services",
23	locale: "en",
24	currency: "USD",
25	taxes: "account",
26	prefix: "INV-",
27	invoice_number: 1042,
28	send_to_customer: true,
29	custom_payment: "Please pay via wire transfer to...",
30	payments: ["mollie_123"],
31	fulfillment_options: {
32	stock: false,
33	accounting_systems: false,
34	merchant_emails: false,
35	customer_emails: false,
36	automations: false,
37	shipping_providers: false
38	},
39	shipping: {
40	label: "Express Delivery",
41	cost: 1500
42	},
43	products: [
44	{
45	name: "Web Design",
46	price: 50000,
47	quantity: 1
48	}
49	]
50	}.to_json
51
52	response = https.request(request)
53	puts response.read_body