diff --git a/poscreators/middleware-doc/appendix-me/appendix-me.md b/poscreators/middleware-doc/appendix-me/appendix-me.md deleted file mode 100644 index ade567e..0000000 --- a/poscreators/middleware-doc/appendix-me/appendix-me.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro -title: Introduction ---- - -# Fiscalization in Montenegro -This chapter expands on the information provided in the _General_ chapter by adding details specific to the fiscalization for Montenegro. This additional information is provided only where applicable. The remaining chapters, for which there is no extra information required, were omitted. - -Legal regulations and further information can be found on the website of the Montenegran tax authority. - - - \ No newline at end of file diff --git a/poscreators/middleware-doc/appendix-me/reference-tables/reference-tables.md b/poscreators/middleware-doc/appendix-me/reference-tables/reference-tables.md deleted file mode 100644 index fbf46e0..0000000 --- a/poscreators/middleware-doc/appendix-me/reference-tables/reference-tables.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro/reference-tables -title: Reference tables ---- - -# Reference tables - -This chapter expands on the reference tables covered in [Reference Tables in General Part](../../general/reference-tables/reference-tables.md), with country-specific information applicable to the Montenegrin market. The respective tables can be found in the following sub-sections. diff --git a/poscreators/middleware-doc/appendix-me/reference-tables/service-status-ftstate.md b/poscreators/middleware-doc/appendix-me/reference-tables/service-status-ftstate.md deleted file mode 100644 index 413a9d8..0000000 --- a/poscreators/middleware-doc/appendix-me/reference-tables/service-status-ftstate.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro/reference-tables/ftstate -title: 'Service Status: ftState' ---- - -# Service Status: ftState - -The country-specific code is made of the country's code value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex. For Montenegro (ME) this is `0x4D45`, which results in `0x4D45000000000000` as the value for the "ready" status. - -The table below describes its supported statuses for the `ftState` field following Montenegrin law. These codes can be added through the logic operator `OR`. - -| **Value** | **Description** | **Middleware version** | -|----------------------|-----------------------------------------------------------------------------------------------------|---------------------| -| `0x4D45000000000002` | The security mechanism was not able to communicate with the _central invoice register_ web service for at least one cycle. If this is the case, no more communication attempts are done to avoid long waiting times for each Receipt request/Receipt response sequence. To leave this state, a Zero-Receipt must be sent, which forces a communication retry towards the web service.
Receipts created in a state where no communication is possible with the central invoice register device are protected by the security mechanism of fiskaltrust and re-sent when the communication is restored with a zero receipt. | 1.3.40- | -| `0x4D45000000000003` | An error occurred when processing the request, see further details in ftStateData. | 1.3.40- | -| `0x4D45000000000004` | CashDeposit missing! This receipt could not be processed, as the first receipt each day must be a cash-deposit according to Montenegrin law. | 1.3.40- | -| `0x4D45000000000005` | Invoice already received! The field cbReceiptReference must be unique, but has already been used. Please make sure to use an unique cbReceiptReference for each receipt. | 1.3.40- | diff --git a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-payment-ftpayitemcase.md b/poscreators/middleware-doc/appendix-me/reference-tables/type-of-payment-ftpayitemcase.md deleted file mode 100644 index 49040c7..0000000 --- a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-payment-ftpayitemcase.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro/reference-tables/ftpayitemcase -title: 'Type of Payment: ftPayItemCase' ---- - -# Type of Payment: ftPayItemCase - -This table expands on the values provided in table [ftPayItemCase in General Part](../../general/reference-tables/reference-tables.md#type-of-payment-ftpayitemcase) with values applicable to the Montenegrin market. - -| **Value** | **Description** | **Payment type in CIS** | **Middleware version** | -|---|---|---|---| -| `0x4D45000000000000` | Unknown payment type for ME
This is handled like a cash payment in national currency. | BANKNOTE | 1.3.40- | -| `0x4D45000000000001` | Cash payment in national currency | BANKNOTE | 1.3.40- | -| `0x4D45000000000002` | Cash payment in foreign currency | BANKNOTE | 1.3.40- | -| `0x4D45000000000003` | Crossed cheque | OTHER | 1.3.40- | -| `0x4D45000000000004` | Debit card payment with a card issued to a natural person | CARD | 1.3.40- | -| `0x4D45000000000005` | Credit card payment with a card issued to a natural person | CARD | 1.3.40- | -| `0x4D45000000000006` | Debit card payment with a card issued to a taxpayer/non-natural person | BUSINESSCARD | 1.3.40- | -| `0x4D45000000000007` | Credit card payment with a card issued to a taxpayer/non-natural person | BUSINESSCARD | 1.3.40- | -| `0x4D45000000000008` | Online payment | OTHER | 1.3.40- | -| `0x4D45000000000009` | Customer card payment (gift cards and similar prepaid cards) | COMPANY | 1.3.40- | -| `0x4D4500000000000A` | SEPA transfer | OTHER | 1.3.40- | -| `0x4D4500000000000B` | Other bank transfer | OTHER | 1.3.40- | -| `0x4D4500000000000C` | Internal / material consumption | - | 1.3.40- | -| `0x4D4500000000000D` | Change in national currency | BANKNOTE | 1.3.40- | -| `0x4D4500000000000E` | Change in foreign curreny | BANKNOTE | 1.3.40- | -| `0x4D4500000000000F` | One-time voucher | SVOUCHER | 1.3.40- | -| `0x4D45000000000010` | Invoice to be paid in summary invoice (cash) | ORDER | 1.3.40- | -| `0x4D45000000000011` | Invoice to be paid in summary invoice (non-cash) | ORDER | 1.3.40- | -| `0x4D45000000000012` | Advance payment | ADVANCE | 1.3.40- | -| `0x4D45000000000013` | Transaction account | ACCOUNT | 1.3.40- | -| `0x4D45000000000014` | Factoring | FACTORING | 1.3.40- | -| `0x4D45000000000015` | Other non-cash payment types | OTHER | 1.3.40- | -| `0x4D45000000000016` | Other cash payment types | OTHER-CASH | 1.3.40- | - diff --git a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-receipt-ftreceiptcase.md b/poscreators/middleware-doc/appendix-me/reference-tables/type-of-receipt-ftreceiptcase.md deleted file mode 100644 index d44ba55..0000000 --- a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-receipt-ftreceiptcase.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro/reference-tables/ftreceiptcase -title: 'Type of receipt: ftReceiptCase' ---- - -# Type of Receipt: ftReceiptCase - -The `ftReceiptCase` indicates the receipt type and defines how the fiskaltrust.SecurityMechanism should process it following Montenegrin law. - -For Montenegro (ME), the country code is `0x4D45`. Thus, the value of an unknown `ftReceiptCase` in Montenegro is `0x4D45000000000000`. - -| **Value** | **Description** | **Middleware version** | -|-----------|-----------------|-------------------------| -| `0x4D45000000000000` | **Unknown type for country-code "ME"**

This receipt case is handled like a "pos-receipt" (`0x4D45000000000001`). See below: | 1.3.40- | -| `0x4D45000000000001` | **POS receipt**

Represents the main kind of receipt processed by a POS-System. Creates a turnover and/or change in the amount of cash in the till or similar operations.

Use the `ftChargeItems` and `ftPayItems` to hand over details for processing. The `ftChargeItems` and `ftPayItems` should contain the full final state of the receipt, not a partial state. | 1.3.40- | -| `0x4D45000000000002` | **Zero-receipt**

Used for communication test and functional test of the fiskaltrust.SecurityMechanism.

If the Middleware is in _failed mode_, zero-receipts will try to restore the communication. If this succeeds, the Middleware re-sends receipts that were processed by the Middleware while it was in failed mode to the _central invoice register_, according to national requirements. | 1.3.40- | -| `0x4D45000000000003` | **Initial operation receipt / start-receipt**

The request is only valid with the same property requirements as a zero-receipt. It initializes a new fiskaltrust.SecurityMechanism including and registers the instance at the _central invoice register_.

The request is only valid when the charge items block (`ftChargeItems`) and the pay items block (`ftPayItems`) in the `ftReceiptRequest` are empty arrays.

| 1.3.40- | -| `0x4D45000000000004` | **Out of operation receipt / stop-receipt**

The request is only valid with the same property requirements as a zero-receipt. It is disabling the fiskaltrust.SecurityMechanism and de-registers the instance from the _central invoice register_.

The request is only valid when the charge items block (`ftChargeItems`) and the pay items block (`ftPayItems`) in the `ftReceiptRequest` are empty arrays. | 1.3.40- | -| `0x4D45000000000005` | **Monthly-closing**

This is a zero-receipt. It is recommended to send this receipt at the end of each month to define the time of the accounting closure, but there's no legal requirement to track the end of the month in Montenegran fiscalization. | 1.3.40- | -| `0x4D45000000000006` | **Yearly-closing**

This is a zero receipt. It is **mandatory** to send a yearly-closing receipt in Montenegro at the end of the fiscal year, as this resets the yearly counter the Middleware has to send to the _central invoice register_. | 1.3.40- | -| `0x4D45000000000007` | **Opening balance**

Used to register the initial cash amount that is deposited in the cash register before the beginning of each business day. It is **mandatory** to send this receipt in Montenegro on each day before the first POS receipt is processed, as this data has to be sent to the _central invoice register_. | 1.3.40- | -| `0x4D45000000000008` | **Cash withdrawal**

Used to register cash withdrawals from the till (e.g. in the evening when closing the store). It is **mandatory** to send this receipt in Montenegro whenever cash is withdrawn, as this data has to be sent to the _central invoice register_. | 1.3.40- | - -## ftReceiptCaseFlag -This table expands on the values provided in table [ftReceiptCaseFlag in General Part](../../general/reference-tables/reference-tables.md#ftreceiptcaseflag) with values applicable to the Montenegrin market. - -| Value | Description | Middleware-Version | -|-------|-------------|--------------------| -| 0x0000000000010000 | **Failed receipt**
Common behaviour, see [general part](../../general/reference-tables/reference-tables.md#ftreceiptcaseflag). | 1.3.40- | -| 0x0000000000040000 | **Reverse/voided receipt(complete).**
To cancel a complete receipt, resend it with this flag added to the ftReceiptCase. The field cbReceiptReference has to have a new reference and in cbPreviousReceiptReference the receipt to cancel.| 1.3.40- | -| 0x0000000000050000 | **Reverse/voided receipt(partial).**
To cancel a partial receipt, resend it with this flag added to the ftReceiptCase. The field cbReceiptReference has to have a new reference and in cbPreviousReceiptReference the receipt to cancel. All charge- and payitems for invoicing have to be included in the receipt. | 1.3.40- | -| 0x0000800000000000 | **Receipt request.**
Common behavior, see [general part](../../general/reference-tables/reference-tables.md#ftreceiptcaseflag). | 1.3.40- | diff --git a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-service-ftchargeitemcase.md b/poscreators/middleware-doc/appendix-me/reference-tables/type-of-service-ftchargeitemcase.md deleted file mode 100644 index 56b3c7e..0000000 --- a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-service-ftchargeitemcase.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro/reference-tables/ftchargeitemcase -title: 'Type of service: ftChargeItemCase' ---- - -# Type of Service: ftChargeItemCase - -This table expands on the values provided in the table [ftChargeItemCase in General Part](../../general/reference-tables/reference-tables.md#type-of-service-ftchargeitemcase), with country-specific values applicable to the German market. - - -| **Value** | **Description** | **VAT rate** | **Middleware version** | -|---|---|---|---| -| `0x4D45000000000000` | Unknown type of service for ME (VAT rate from the `VatRate` property is directly passed to the _central invoice service_) | custom | 1.3- | -| `0x4D45000000000001` | Undefined type of service for ME (normal VAT rate). | 21 % | 1.3- | -| `0x4D45000000000002` | Undefined type of service for ME (reduced VAT rate) | 7 % | 1.3- | -| `0x4D45000000000003` | Undefined type of service for ME (not taxable/exempt from VAT) | - | 1.3- | -| `0x4D45000000000004` | Undefined type of service for ME (zero) | 0% | 1.3- | -| `0x4D45000000000005` | Undefined type of service for ME (unknown VAT)
VAT rate from the `VatRate` property is directly passed to the _central invoice service_) | custom | 1.3- | -| `0x4D45000000000011` | Delivery (normal VAT rate). | 21 % | 1.3- | -| `0x4D45000000000012` | Delivery (reduced VAT rate) | 7 % | 1.3- | -| `0x4D45000000000013` | Delivery (not taxable/exempt from VAT) | - | 1.3- | -| `0x4D45000000000014` | Delivery (zero) | 0% | 1.3- | -| `0x4D45000000000015` | Delivery (unknown VAT)
VAT rate from the `VatRate` property is directly passed to the _central invoice service_) | custom | 1.3- | -| `0x4D45000000000019` | Other services (normal VAT rate). | 21 % | 1.3- | -| `0x4D4500000000001A` | Other services (reduced VAT rate) | 7 % | 1.3- | -| `0x4D4500000000001B` | Other services (not taxable/exempt from VAT) | - | 1.3- | -| `0x4D4500000000001C` | Other services (zero) | 0% | 1.3- | -| `0x4D4500000000001D` | Other services (unknown VAT)
VAT rate from the `VatRate` property is directly passed to the _central invoice service_) | custom | 1.3- | -| `0x4D45000000000020` | Cash deposit into the till | - | 1.3- | -| `0x4D45000000000021` | Cash withdrawal from the till | - | 1.3- | - -## ftChargeItemCaseFlag - -This table shows flags that can be added to each `ftChargeItemCase` with values applicable to the Montenegrin market. - -| Value | Description | Middleware version | -|---|---|---| -| 0x0000000000010000 | **ChargeItem is a voucher.**
In case a voucher was sold, this flag has to be set and the `ftChargeItemCaseData` property has to contain the expiration date and the serial number(s) of the voucher in JSON format: `ftChargeItemCaseData: "{\"ExpirationDate\": \"2022-12-24\", \"VoucherSerialNumbers\": [ \"2-2020-12345678\", \"optionally-more-numbers\" ]}"` (please note that this property accepts a string, and the content data needs to be accordingly escaped as shown in this example). | 1.3.40- | -| 0x0000000000020000 | **ChargeItem is exported to a country outside of Montenegro.**
In case the ChargeItem represents a goods or services meant for export, this flag has to be set. | 1.3.40- | -| 0x0000000000060000 | **ChargeItem is not an investment.**
In case the ChargeItem is not an investment for the buyer according to Montenegran law, this flag has to be set. | 1.3.40- | -| 0x0000000000070000 | **Discount applied on this ChargeItem does reduces base price.**
In case there's a discount applied to this ChargeItem which is reducing the tax base price of the item according to Montenegran law, this flag has to be set. The percentage has to be provided as: `ftChargeItemCaseData: "{\" DiscountPercentage\": 20}"` | 1.3.40- | -| 0x0000000000080000 | **Discount applied on this ChargeItem does not reduces base price.**
In case there's a discount applied to this ChargeItem which is not reducing the tax base price of the item according to Montenegran law, this flag has to be set. | 1.3.40- | diff --git a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-signature-ftsignaturetype.md b/poscreators/middleware-doc/appendix-me/reference-tables/type-of-signature-ftsignaturetype.md deleted file mode 100644 index bcd603a..0000000 --- a/poscreators/middleware-doc/appendix-me/reference-tables/type-of-signature-ftsignaturetype.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -slug: /poscreators/middleware-doc/montenegro/reference-tables/ftsignaturetype -title: 'Type of signature: ftSignatureType' ---- - -# Type of Signature: ftSignatureType - -The `ftSignatureType` indicates the type and origin of the signature. The data type is `Int64` and can contain a country-specific code, a value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex and used as byte 8 and 7. - - -| **Value** | **Description** | **Middleware version** | -|----------------------|--------------------------|------------------------| -| `0x4D45000000000001` | QR code content | 1.3.40- | -| `0x4D45000000000002` | Archiving required | 1.3.40- | -| `0x4D45000000000003` | Taxpayer identifying code (IIC/IKOF) | 1.3.40- | - -:::note - -The Types `0x4D45000000000001` "QR code content" and `0x4D45000000000003` "Taxpayer identifying code (IIC/IKOF)" are also returned if the government fiscalization service is not reachable and thus the receipt could not be signed. This is different to Germany where e.g. the QR code is only returned when the receipt could be signed. - -::: - diff --git a/poscreators/toc.js b/poscreators/toc.js index 6c9d52d..079bc64 100644 --- a/poscreators/toc.js +++ b/poscreators/toc.js @@ -435,10 +435,5 @@ module.exports = [ type: "link", label: "Development Kit", href: "https://github.com/fiskaltrust/possystemapi-devkit/blob/main/README.MD", - }, - { - type: "link", - label: "Development Platform", - href: "https://developer.fiskaltrust.eu/", - }, + }, ];