Skip to main content
POST
/
v3
/
transactions
/
queue
Queue Transaction
curl --request POST \
  --url https://api.{tenant}.getomneo.com/api/v3/transactions/queue \
  --header 'Content-Type: application/json' \
  --data '
{
  "total": 123,
  "transacted_at": "2023-11-07T05:31:56Z",
  "timezone": "<string>",
  "id": 123,
  "profile_id": "<string>",
  "profile_id_handle": "<string>",
  "redemption_id": 123,
  "external_id": "<string>",
  "location_id": "<string>",
  "currency": "<string>",
  "total_original": 123,
  "rounding": 123,
  "tender": "<string>",
  "is_void": true,
  "margin": 123,
  "meta": [
    "<string>"
  ],
  "staff_id": "<string>",
  "payments": [
    "<string>"
  ],
  "receipt_is_email": true,
  "receipt_ref": "<string>",
  "linked_receipt_ref": "<string>",
  "receipt_email": "jsmith@example.com",
  "need_action": true,
  "tags": [
    "<string>"
  ],
  "systems": [
    "<string>"
  ],
  "items": [
    {
      "name": "<string>",
      "price_current": 123,
      "price_sell": 123,
      "quantity": 123,
      "id": "<string>",
      "external_id": "<string>",
      "price_original": 123,
      "price_margin": 123,
      "discounts": [
        "<string>"
      ],
      "sku": "<string>",
      "variant_external_id": "<string>",
      "product_variant_sku": "<string>",
      "product_variant_id": 123,
      "product_variant": {
        "product_id": "<string>",
        "sku": "<string>",
        "title": "<string>",
        "category": "<string>",
        "subcategory": "<string>",
        "brand": "<string>",
        "price": 123
      }
    }
  ]
}
'
import requests

url = "https://api.{tenant}.getomneo.com/api/v3/transactions/queue"

payload = {
    "total": 123,
    "transacted_at": "2023-11-07T05:31:56Z",
    "timezone": "<string>",
    "id": 123,
    "profile_id": "<string>",
    "profile_id_handle": "<string>",
    "redemption_id": 123,
    "external_id": "<string>",
    "location_id": "<string>",
    "currency": "<string>",
    "total_original": 123,
    "rounding": 123,
    "tender": "<string>",
    "is_void": True,
    "margin": 123,
    "meta": ["<string>"],
    "staff_id": "<string>",
    "payments": ["<string>"],
    "receipt_is_email": True,
    "receipt_ref": "<string>",
    "linked_receipt_ref": "<string>",
    "receipt_email": "jsmith@example.com",
    "need_action": True,
    "tags": ["<string>"],
    "systems": ["<string>"],
    "items": [
        {
            "name": "<string>",
            "price_current": 123,
            "price_sell": 123,
            "quantity": 123,
            "id": "<string>",
            "external_id": "<string>",
            "price_original": 123,
            "price_margin": 123,
            "discounts": ["<string>"],
            "sku": "<string>",
            "variant_external_id": "<string>",
            "product_variant_sku": "<string>",
            "product_variant_id": 123,
            "product_variant": {
                "product_id": "<string>",
                "sku": "<string>",
                "title": "<string>",
                "category": "<string>",
                "subcategory": "<string>",
                "brand": "<string>",
                "price": 123
            }
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    total: 123,
    transacted_at: '2023-11-07T05:31:56Z',
    timezone: '<string>',
    id: 123,
    profile_id: '<string>',
    profile_id_handle: '<string>',
    redemption_id: 123,
    external_id: '<string>',
    location_id: '<string>',
    currency: '<string>',
    total_original: 123,
    rounding: 123,
    tender: '<string>',
    is_void: true,
    margin: 123,
    meta: ['<string>'],
    staff_id: '<string>',
    payments: ['<string>'],
    receipt_is_email: true,
    receipt_ref: '<string>',
    linked_receipt_ref: '<string>',
    receipt_email: 'jsmith@example.com',
    need_action: true,
    tags: ['<string>'],
    systems: ['<string>'],
    items: [
      {
        name: '<string>',
        price_current: 123,
        price_sell: 123,
        quantity: 123,
        id: '<string>',
        external_id: '<string>',
        price_original: 123,
        price_margin: 123,
        discounts: ['<string>'],
        sku: '<string>',
        variant_external_id: '<string>',
        product_variant_sku: '<string>',
        product_variant_id: 123,
        product_variant: {
          product_id: '<string>',
          sku: '<string>',
          title: '<string>',
          category: '<string>',
          subcategory: '<string>',
          brand: '<string>',
          price: 123
        }
      }
    ]
  })
};

fetch('https://api.{tenant}.getomneo.com/api/v3/transactions/queue', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.{tenant}.getomneo.com/api/v3/transactions/queue",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'total' => 123,
    'transacted_at' => '2023-11-07T05:31:56Z',
    'timezone' => '<string>',
    'id' => 123,
    'profile_id' => '<string>',
    'profile_id_handle' => '<string>',
    'redemption_id' => 123,
    'external_id' => '<string>',
    'location_id' => '<string>',
    'currency' => '<string>',
    'total_original' => 123,
    'rounding' => 123,
    'tender' => '<string>',
    'is_void' => true,
    'margin' => 123,
    'meta' => [
        '<string>'
    ],
    'staff_id' => '<string>',
    'payments' => [
        '<string>'
    ],
    'receipt_is_email' => true,
    'receipt_ref' => '<string>',
    'linked_receipt_ref' => '<string>',
    'receipt_email' => 'jsmith@example.com',
    'need_action' => true,
    'tags' => [
        '<string>'
    ],
    'systems' => [
        '<string>'
    ],
    'items' => [
        [
                'name' => '<string>',
                'price_current' => 123,
                'price_sell' => 123,
                'quantity' => 123,
                'id' => '<string>',
                'external_id' => '<string>',
                'price_original' => 123,
                'price_margin' => 123,
                'discounts' => [
                                '<string>'
                ],
                'sku' => '<string>',
                'variant_external_id' => '<string>',
                'product_variant_sku' => '<string>',
                'product_variant_id' => 123,
                'product_variant' => [
                                'product_id' => '<string>',
                                'sku' => '<string>',
                                'title' => '<string>',
                                'category' => '<string>',
                                'subcategory' => '<string>',
                                'brand' => '<string>',
                                'price' => 123
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.{tenant}.getomneo.com/api/v3/transactions/queue"

	payload := strings.NewReader("{\n  \"total\": 123,\n  \"transacted_at\": \"2023-11-07T05:31:56Z\",\n  \"timezone\": \"<string>\",\n  \"id\": 123,\n  \"profile_id\": \"<string>\",\n  \"profile_id_handle\": \"<string>\",\n  \"redemption_id\": 123,\n  \"external_id\": \"<string>\",\n  \"location_id\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"total_original\": 123,\n  \"rounding\": 123,\n  \"tender\": \"<string>\",\n  \"is_void\": true,\n  \"margin\": 123,\n  \"meta\": [\n    \"<string>\"\n  ],\n  \"staff_id\": \"<string>\",\n  \"payments\": [\n    \"<string>\"\n  ],\n  \"receipt_is_email\": true,\n  \"receipt_ref\": \"<string>\",\n  \"linked_receipt_ref\": \"<string>\",\n  \"receipt_email\": \"jsmith@example.com\",\n  \"need_action\": true,\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"systems\": [\n    \"<string>\"\n  ],\n  \"items\": [\n    {\n      \"name\": \"<string>\",\n      \"price_current\": 123,\n      \"price_sell\": 123,\n      \"quantity\": 123,\n      \"id\": \"<string>\",\n      \"external_id\": \"<string>\",\n      \"price_original\": 123,\n      \"price_margin\": 123,\n      \"discounts\": [\n        \"<string>\"\n      ],\n      \"sku\": \"<string>\",\n      \"variant_external_id\": \"<string>\",\n      \"product_variant_sku\": \"<string>\",\n      \"product_variant_id\": 123,\n      \"product_variant\": {\n        \"product_id\": \"<string>\",\n        \"sku\": \"<string>\",\n        \"title\": \"<string>\",\n        \"category\": \"<string>\",\n        \"subcategory\": \"<string>\",\n        \"brand\": \"<string>\",\n        \"price\": 123\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.{tenant}.getomneo.com/api/v3/transactions/queue")
  .header("Content-Type", "application/json")
  .body("{\n  \"total\": 123,\n  \"transacted_at\": \"2023-11-07T05:31:56Z\",\n  \"timezone\": \"<string>\",\n  \"id\": 123,\n  \"profile_id\": \"<string>\",\n  \"profile_id_handle\": \"<string>\",\n  \"redemption_id\": 123,\n  \"external_id\": \"<string>\",\n  \"location_id\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"total_original\": 123,\n  \"rounding\": 123,\n  \"tender\": \"<string>\",\n  \"is_void\": true,\n  \"margin\": 123,\n  \"meta\": [\n    \"<string>\"\n  ],\n  \"staff_id\": \"<string>\",\n  \"payments\": [\n    \"<string>\"\n  ],\n  \"receipt_is_email\": true,\n  \"receipt_ref\": \"<string>\",\n  \"linked_receipt_ref\": \"<string>\",\n  \"receipt_email\": \"jsmith@example.com\",\n  \"need_action\": true,\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"systems\": [\n    \"<string>\"\n  ],\n  \"items\": [\n    {\n      \"name\": \"<string>\",\n      \"price_current\": 123,\n      \"price_sell\": 123,\n      \"quantity\": 123,\n      \"id\": \"<string>\",\n      \"external_id\": \"<string>\",\n      \"price_original\": 123,\n      \"price_margin\": 123,\n      \"discounts\": [\n        \"<string>\"\n      ],\n      \"sku\": \"<string>\",\n      \"variant_external_id\": \"<string>\",\n      \"product_variant_sku\": \"<string>\",\n      \"product_variant_id\": 123,\n      \"product_variant\": {\n        \"product_id\": \"<string>\",\n        \"sku\": \"<string>\",\n        \"title\": \"<string>\",\n        \"category\": \"<string>\",\n        \"subcategory\": \"<string>\",\n        \"brand\": \"<string>\",\n        \"price\": 123\n      }\n    }\n  ]\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.{tenant}.getomneo.com/api/v3/transactions/queue")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"total\": 123,\n  \"transacted_at\": \"2023-11-07T05:31:56Z\",\n  \"timezone\": \"<string>\",\n  \"id\": 123,\n  \"profile_id\": \"<string>\",\n  \"profile_id_handle\": \"<string>\",\n  \"redemption_id\": 123,\n  \"external_id\": \"<string>\",\n  \"location_id\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"total_original\": 123,\n  \"rounding\": 123,\n  \"tender\": \"<string>\",\n  \"is_void\": true,\n  \"margin\": 123,\n  \"meta\": [\n    \"<string>\"\n  ],\n  \"staff_id\": \"<string>\",\n  \"payments\": [\n    \"<string>\"\n  ],\n  \"receipt_is_email\": true,\n  \"receipt_ref\": \"<string>\",\n  \"linked_receipt_ref\": \"<string>\",\n  \"receipt_email\": \"jsmith@example.com\",\n  \"need_action\": true,\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"systems\": [\n    \"<string>\"\n  ],\n  \"items\": [\n    {\n      \"name\": \"<string>\",\n      \"price_current\": 123,\n      \"price_sell\": 123,\n      \"quantity\": 123,\n      \"id\": \"<string>\",\n      \"external_id\": \"<string>\",\n      \"price_original\": 123,\n      \"price_margin\": 123,\n      \"discounts\": [\n        \"<string>\"\n      ],\n      \"sku\": \"<string>\",\n      \"variant_external_id\": \"<string>\",\n      \"product_variant_sku\": \"<string>\",\n      \"product_variant_id\": 123,\n      \"product_variant\": {\n        \"product_id\": \"<string>\",\n        \"sku\": \"<string>\",\n        \"title\": \"<string>\",\n        \"category\": \"<string>\",\n        \"subcategory\": \"<string>\",\n        \"brand\": \"<string>\",\n        \"price\": 123\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
{
  "data": "<string>"
}
{
  "message": "<string>"
}
{
  "message": "<string>"
}
{
  "message": "<string>",
  "errors": {}
}

​
What happens when a transaction is queued?

The main difference between this endpoint and Add Transaction is queuing a transaction adds the transaction request to a batch processing queue. The response time for this request is much faster than an Add Transaction, as the job is submitted instantly. The payload required for this endpoint is identical to the Add Transaction endpoint. In addition to the above, this endpoint includes the same functionality as Create or Update a Transaction, where an existing transaction is first searched by external_id and then id which will update the transaction if found. If no existing transaction is found, the transaction is created instead.
Queued transactions may not be created instantlyThe processing time of transactions submitted to the queue is subject to the other jobs within the queue. The response will contain no data relating to the transaction. A transaction.created or transaction.updated event will be triggered as each transaction is processed. Developers can use this to retrieve data relating to the submitted transaction.

​
When to use Queue Transaction

Queueing is primarily used for batch importing transactions. The Queue endpoint allows developers to submit high volumes of transactions for processing on a batch queue. This is usually done by the developer by looping through transactions on the external system, and sending them to the Queue Transaction endpoint.

​
When not to use Queue Transaction

If response data is required after submitting the request to this endpoint. Queue Transaction will return a 200 response ‘OK’ with every successful submission. This will not contain any information about the submitted transaction. If response data is required for population on a website or internal system, use the Add Transaction endpoint instead If transactions need to be created immediately, this endpoint is not suitable. All transactions submitted via this endpoint are subject to the other jobs on the queue. Because of this, Omneo cannot guarantee the time of creation.

Body

application/json
​
total
number
required
​
transacted_at
string<date-time>
required
​
timezone
string
required
​
id
integer | null
​
profile_id
string | null
​
profile_id_handle
string | null
​
redemption_id
integer | null
​
external_id
string | null
​
location_id
string | null
​
currency
string | null
​
total_original
number | null
​
rounding
number | null
​
tender
string | null
​
is_void
boolean | null
​
margin
number | null
​
meta
string[] | null
​
staff_id
string | null
​
payments
string[]
​
receipt_is_email
boolean | null
​
receipt_ref
string | null
​
linked_receipt_ref
string | null
​
receipt_email
string<email> | null
​
need_action
boolean | null
​
tags
string[]
​
systems
string[]
​
items
object[] | null

Response

​
data
string
required
Allowed value: "OK"