API

Create a transaction

Create a transaction

POST/v1/hq/transactions
AuthorizationBearer <token>

The Noona HQ API uses Bearer token for authentication.

Endpoints that return generic information that does not contain sensitive data do not require authentication. Endpoints that require authentication are specifically marked in the documentation.

Authorization: Bearer your-token

In: header

Query Parameters

behavior?
select?array<string>
expand?array<string>

Request Body

application/json

company?string|
sale*|string
subtransactions?
employees?
line_items?
refunds?array<string>

References refunds for this transaction.

refund_origin?string

References the original transaction that was refunded.

Example"8wa9uiah28dawd123"
note?string
issuer?
fiscalization?string
currency?string
Example"ISK"
origin?string

The origin of the transaction.

  • marketplace: The transaction was created via the marketplace.
  • pos: The transaction was created via the POS.
Value in"marketplace" | "pos"
Example"marketplace"
type?string
Value in"invoice" | "return" | "refund" | "refunded"
Example"invoice"
status?string
Value in"draft" | "completed"
Example"draft"
completed_at?string
Formatdate-time
voided_at?string

Only supported to unset this field. That is done by providing the value as "zero date" (0001-01-01T00:00:00Z)

Formatdate-time

Response Body

application/json

curl -X POST "https://api.noona.is/v1/hq/transactions" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "8wa9uiah28dawd123",
  "company": "string",
  "sale": {
    "id": "8wa9uiah28dawd123",
    "transactions": [
      {
        "id": "string"
      }
    ],
    "events": [
      {
        "id": "string"
      }
    ],
    "company": "string",
    "customer": {
      "id": "string"
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  },
  "subtransactions": [
    "string"
  ],
  "employees": [
    "string"
  ],
  "line_items": [
    {
      "id": "string"
    }
  ],
  "refunds": [
    "8wa9uiah28dawd123"
  ],
  "refund_origin": "8wa9uiah28dawd123",
  "invoice_number": 9001,
  "note": "string",
  "issuer": {
    "id": "8wa9uiah28dawd123",
    "type": "company",
    "name": "Noona cuts",
    "bin": "string",
    "legal_address": "My Street 1, 101 Reykjavik",
    "extra_invoice_info": "Some extra info to include on invoices.",
    "vat_id": "string",
    "other": "string"
  },
  "fiscalization": "string",
  "currency": "ISK",
  "total_amount": 1990,
  "total_amount_without_vat": 1990,
  "vat_amount": 478,
  "due_amount": 990,
  "paid_on_marketplace_amount": 1000,
  "origin": "marketplace",
  "tax_exemption_reason": "M01",
  "type": "invoice",
  "status": "draft",
  "drafted_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "voided_at": "2019-08-24T14:15:22Z",
  "invopop_header": {
    "uuid": "0199dd45-e893-7208-ac79-8f4fe5449e04",
    "code": "FR IXTEST-01/8849",
    "digest": {
      "algorithm": "sha256",
      "value": "ead24e3c59a8b23f4953145566c8371e1c5b8d86280612654531b421d263e89d"
    },
    "stamps": [
      {
        "provider": "at-atcud",
        "value": "AAJFJRJYD4-8849"
      }
    ]
  }
}
Empty
Empty
Empty