v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB
receipts

aid_receipts_receipt_token_post

Update customer_id on receipt identified by token. The token will be invalid after the claim.

scopes:

  • admin:receipts
  • write:receipts
  • user:receipts
post/accounts/{aid}/receipts/receipt-token

Path parameters

aidstring ^[PT]{1}\d{8}$ required

An id that uniquely identifies the account.

Query parameters

tokenstring required

JWT token for receipt

Request body

customer_idstring required

Response

Receipt claimed

idstring uuid

An UUID that uniquely identifies the resource

created_atstring date-time

The date-time when the resource was created

created_bystring

The ID of the user/client created the resource

updated_atstring date-time

The date-time when the resource was last updated

deleted_bystring

The ID of the user/client created the resource

deleted_atstring date-time
receipt_idstring required
customer_idstring

The customer id identifying the customer. (must not have trailing or leading spaces)

gross_amountinteger

Monetary amount in smallest unit for the currency before discounts

gross_amount_dwhstring

Monetary amount in smallest unit for the currency before discounts with decimal

net_amountinteger

Monetary amount in smallest unit for the currency after discounts

net_amount_dwhstring

Monetary value in smallest unit for the currency after discounts with decimal

round_off_to_coininteger
currencystring

The three-character ISO-4217 currency. https://en.wikipedia.org/wiki/ISO_4217

purchase_atstring date-time required

The date and time for the receipt purchase

order_numberstring
transaction_datestring date-time
amount_dueinteger

How much more need to be paid before the transaction is completed. Monetary amount in smallest unit for the currency

amount_due_dwhstring

Monetary value with decimal

no_of_itemsnumber

How many items did the customer buy

is_changedboolean

Discount applied to gross amount

transaction_idstring
total_discountinteger
total_manual_discount_amountinteger

Monetary amount in smallest unit for the currency

total_manual_percentage_discountinteger
operator_idstring

POS user

operator_namestring

Name of the POS user

salesperson_idstring

ID of the POS user

salesperson_namestring
entry_status'None' | 'Voided' | 'Posted' | 'Concluded' | 'Cancelled' | 'OnHold' | 'Training' | 'Reprinted'

Status for the transaction

commentstring
receipt_textstring
discount_codestring[]

Example response

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "discounts": [
    {
      "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
      "deleted_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
      "updated_by": "3d1e4824-5474-48e7-a369-4f603fa4c5b8",
      "name": "Spar 100,-",
      "receipt_text": "Mai Salg",
      "description": "Gjør et Stablestol kupp!",
      "limitation": {
        "discount_hours": {
          "hours": [
            {
              "start": "10:00",
              "end": "20:00"
            }
          ]
        },
        "discount_reward_usage": 1,
        "stamp_expire_days": 100,
        "blacklist": [
          {
            "id": "b714118",
            "group_id": "B1"
          }
        ]
      },
      "requirement": {
        "customer": {
          "addresses": [
            {
              "country": [
                "NO"
              ],
              "postal_code": [
                "0349"
              ],
              "postal_place": [
                "Oslo"
              ],
              "custom_type": [
                "offsite"
              ],
              "type": [
                "custom"
              ]
            }
          ],
          "company": {
            "bussiness_name": [
              "TKP tech AS"
            ],
            "department": [
              "production",
              "research"
            ],
            "industry": [
              "J62.0.1",
              "J62.0.2"
            ],
            "number_of_employees": [
              "20"
            ],
            "organization_number": [
              "123456789MVA"
            ],
            "website": [
              "https://dintero.com"
            ]
          },
          "date_of_birth": [
            "1990-09-20",
            "1990-05-10"
          ],
          "enrolled_by": {
            "type": [
              "url"
            ],
            "value": [
              "https://mypage.example.dintero.com"
            ]
          },
          "favorite_store": [
            "sc029"
          ],
          "first_name": [
            "John"
          ],
          "gender": [
            "male"
          ],
          "last_name": [
            "Doe"
          ],
          "marketing_consent": {
            "email": {
              "consent": [
                "true"
              ]
            },
            "sms": {
              "consent": [
                "true"
              ]
            }
          },
          "status": [
            "vip"
          ]
        },
        "item": {
          "mixes": [
            {
              "items": [
                {
                  "id": "b714118"
                },
                {
                  "group_id": "g4"
                }
              ]
            }
          ],
          "items": [
            {
              "id": "b714118",
              "group_id": "B1"
            }
          ]
        },
        "store_ids": [
          "sc029"
        ],
        "currencies": [
          {
            "anything-but": [
              "NOK"
            ]
          }
        ],
        "stamp": 5,
        "discount_code": "TACO",
        "store": {
          "id": [
            "sc029"
          ],
          "name": [
            "SC Oslo"
          ],
          "business_name": [
            "SC Oslo AS"
          ],
          "address": {
            "country": [
              "NO"
            ],
            "postal_code": [
              "0349"
            ],
            "postal_place": [
              "Oslo"
            ]
          },
          "chain": [
            "SuperChain"
          ],
          "email": [
            "contact@superchain.com"
          ],
          "gln": [
            "5790001398644"
          ],
          "organization_number": [
            "123456789MVA"
          ],
          "phone_number": [
            "+4738260107"
          ],
          "bax": [
            "102603"
          ],
          "terminal_id": [
            "T0292"
          ]
        }
      },
      "reward": {
        "values": [
          {
            "items": [
              {
                "id": "b714118",
                "group_id": "B1"
              }
            ]
          }
        ]
      },
      "metadata": {
        "campaign_id": "V101",
        "is_featured": true,
        "dintero:private_text:kind": "Gold"
      },
      "links": [
        {
          "href": "https://example.dintero.com/c/photos/2018/6_20_thumbnail_discount_image.png",
          "rel": "thumbnail_discount_image"
        },
        {
          "href": "https://example.dintero.com/c/photos/2018/6_20_medium_discount_image.png",
          "rel": "medium_discount_image"
        },
        {
          "href": "https://example.dintero.com/shop?utm_source=dintero&utm_medium=email&utm_campaign=spring-summer",
          "rel": "webshoop"
        },
        {
          "href": "https://example.dintero.com/newsletter/2018.pdf",
          "rel": "newletter",
          "type": "application/pdf"
        }
      ],
      "refs": [
        {
          "id": "e3da6be5-d8e0-466c-af66-b7f69472ebb5",
          "amount": 10000,
          "bonus": 9050,
          "statistics": {
            "amount": 15050,
            "bonus": 11050,
            "debit_balance": 12350,
            "stamp": 11,
            "usage": 2
          },
          "items": [
            {
              "line_id": 1,
              "amount": 3000
            },
            {
              "line_id": 5,
              "amount": 7000
            }
          ],
          "usage": 1
        }
      ]
    }
  ],
  "store": {
    "id": "sc029",
    "name": "SC Oslo",
    "business_name": "SC Oslo AS",
    "address": {
      "address_line": "Sommerkroveien 34",
      "address_line_2": "PB 123",
      "postal_code": "0349",
      "postal_place": "Oslo",
      "country": "NO"
    },
    "chain": "SuperChain",
    "email": "contact@superchain.com",
    "gln": "5790001398644",
    "organization_number": "123456789MVA",
    "phone_number": "+4738260107",
    "mcc": "5814",
    "bax": "102603",
    "terminal_id": "T0292",
    "payout_destination_id": "seller-1"
  },
  "items": [
    {
      "id": "175938",
      "groups": [
        {
          "id": "B234",
          "name": "Stol"
        },
        {
          "id": "B1",
          "name": "Møbel"
        }
      ],
      "quantity": 2,
      "unit": "stk",
      "description": "Stablestol for utendørsbruk",
      "description_alias": "Stablestol",
      "net_amount": 27840,
      "net_amount_dwh": "27840.10",
      "gross_amount": 39800,
      "gross_amount_dwh": "34800.12",
      "unit_gross_price": 10900,
      "tax_percent": 25,
      "line_id": 1,
      "barcode": "3123212343212",
      "cost_price": 2033,
      "eligible_for_discount": true,
      "included_in_total_discount": true,
      "is_changed": true,
      "salesperson_id": "000111",
      "salesperson_name": "Jesper",
      "serial_id": "32424234231312312",
      "comment": "Kan være hva som helst",
      "infocode_lines": [
        {
          "line_id": 1,
          "amount_dwh": "1.14"
        }
      ],
      "tax_lines": [
        {
          "amount": 5584,
          "amount_dwh": "5584.0440",
          "included_in_price": true,
          "percentage": 25,
          "tax_basis": 27920,
          "tax_basis_dwh": "27920.22",
          "tax_code": "3",
          "tax_group": "Vmva-høy"
        }
      ],
      "discount_lines": [
        {
          "amount": 4400,
          "percentage": 44,
          "discount_id": "766da0ef-9283-42bd-b012-0582344ec53c",
          "line_id": 1
        }
      ],
      "bonus_lines": [
        {
          "bonus": 3130,
          "percentage": 10,
          "discount_id": "766da0ef-9283-42bd-b012-0582344ec53c",
          "line_id": 1
        }
      ]
    }
  ],
  "receipt_id": "714118",
  "delivery": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "customer@example.com",
    "phone_number": "+4799999999",
    "address": {
      "address_line": "Sommerkroveien 34",
      "address_line_2": "PB 123",
      "postal_code": "0349",
      "postal_place": "Oslo",
      "country": "NO"
    }
  },
  "customer_id": "C13db4f63",
  "customer": {
    "gender": "male",
    "first_name": "John",
    "last_name": "Doe",
    "email": "customer@example.com",
    "metadata": {
      "dob_year": 1985
    },
    "phone_number": "+4799999999",
    "addresses": [
      {
        "address_line": "Sommerkroveien 34",
        "address_line_2": "PB 123",
        "postal_code": "0349",
        "postal_place": "Oslo",
        "country": "NO"
      }
    ],
    "date_of_birth": "1990-09-20",
    "enrolled_by": {
      "type": "url",
      "value": "https://facebook.com"
    },
    "company": {
      "organization_number": "123456789MVA",
      "bussiness_name": "TKP tech AS",
      "department": "sales department",
      "industry": "computer industry"
    },
    "marketing_consent": {
      "sms": {
        "consent": true,
        "updated_at": "2018-01-12T13:42:00Z"
      },
      "email": {
        "consent": true,
        "updated_at": "2018-01-12T13:42:00Z"
      }
    },
    "token": {
      "token_id": "983558fe-05bd-495f-92b5-9075d085db32",
      "value": "5345346544ffea22",
      "type": "VIPPS"
    }
  },
  "gross_amount": 59800,
  "gross_amount_dwh": "59800.01",
  "net_amount": 47840,
  "net_amount_dwh": "47840.01",
  "round_off_to_coin": 100,
  "currency": "NOK",
  "order_number": "order12345",
  "amount_due": 2050,
  "amount_due_dwh": "2050.10",
  "no_of_items": 4,
  "transaction_id": "SC999-9991-1828",
  "operator_id": "000210",
  "operator_name": "Ole Anders",
  "salesperson_id": "000111",
  "salesperson_name": "Jesper",
  "comment": "Kunden ønsker mer for info",
  "tax_lines": [
    {
      "amount": 5584,
      "amount_dwh": "5584.0440",
      "included_in_price": true,
      "percentage": 25,
      "tax_basis": 27920,
      "tax_basis_dwh": "27920.22",
      "tax_code": "3",
      "tax_group": "Vmva-høy"
    }
  ],
  "payments": [
    {
      "line_id": 1,
      "token_id": "983558fe-05bd-495f-92b5-9075d085db32",
      "token_type": "VIPPS",
      "card_info": {
        "issuer_name": "Barcley",
        "session_id": "022",
        "terminal_id": "71015233",
        "card_number": "************00198-1",
        "card_type": "VISA",
        "receipt": "BAX: 111010-71015233\\n\\r\\11/11/2015 14:41\\n\\r\\345849\\n\\r\\ VISA CLASSIC\\n\\r\\************5671\\n\\r\\AID:A0000000031010\\n\\r\\ REF:011 006687000000\\n\\r\\RESP:00 GODKJENT\\n\\r\\RETUR AV VARER\\n\\r \\NOK=           50.00\\n\\r\\SIGNATUR................\\n\\r \\KORTHOLDERS KOPI\n"
      },
      "reference_id": "B00668107235",
      "infocode_lines": [
        {
          "line_id": 1,
          "amount_dwh": "1.14"
        }
      ]
    }
  ],
  "infocode_items": [
    {
      "line_id": 1,
      "amount_dwh": "1.14"
    }
  ]
}