{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Italy ( IT )","description":"Complete documentation for integrating Cheqi's digital receipt platform","keywords":["cheqi","digital receipts","api","sdk","java","javascript"]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"italy--it-","__idx":0},"children":["Italy (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT_DOCUMENTO_COMMERCIALE"]}," to preserve the result of the merchant's RT"," ","device or applicable Agenzia issuance service."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-cheqi","__idx":1},"children":["Before Cheqi"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Process the sale through the merchant's RT device or issuance service."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the applicable electronic storage/transmission operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain the commercial-document number, sequence, device/software identity,"," ","transmission reference/time, fiscal evidence, and QR payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain a lottery code only when the transaction explicitly uses that flow."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"in-the-cheqi-request","__idx":2},"children":["In the Cheqi request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Request location"},"children":["Request location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["External regime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.regime = IT_DOCUMENTO_COMMERCIALE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Regime contract version"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.regimeVersion"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commercial-document number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.fiscalDocumentNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RT device"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.fiscalDeviceId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sequence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.sequenceNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transmission reference"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.authorityReference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Software ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.softwareId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transmission timestamp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.timestamp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lottery code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT:LOTTERY_CODE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal QR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes[]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-payload-fragment","__idx":3},"children":["Example payload fragment"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"barcodes\": [\n    {\n      \"type\": \"QR_CODE\",\n      \"data\": \"exact-rt-fiscal-payload\",\n      \"label\": \"Fiscal verification\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"IT\",\n    \"regime\": \"IT_DOCUMENTO_COMMERCIALE\",\n    \"regimeVersion\": \"2026-07\",\n    \"fiscalization\": {\n      \"system\": \"IT_RT\",\n      \"status\": \"FISCALIZED\",\n      \"fiscalDocumentNumber\": \"IT-DC-001\",\n      \"fiscalDeviceId\": \"IT-RT-001\",\n      \"sequenceNumber\": \"42\",\n      \"authorityReference\": \"IT-TRANSMISSION-001\",\n      \"softwareId\": \"IT-SOFTWARE-01\",\n      \"verificationCode\": \"opaque-fiscal-evidence\",\n      \"timestamp\": \"2026-07-29T08:15:30Z\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT:LOTTERY_CODE"]}," only to the explicit lottery variant. Cheqi does not"," ","operate an RT device, transmit fiscal data, enroll a lottery code, or generate"," ","the QR."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":4},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/jurisdictional-data"},"children":["Supplying jurisdiction data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/overview"},"children":["Country support boundary"]}]}]}]},"headings":[{"value":"Italy ( IT )","id":"italy--it-","depth":1},{"value":"Before Cheqi","id":"before-cheqi","depth":2},{"value":"In the Cheqi request","id":"in-the-cheqi-request","depth":2},{"value":"Example payload fragment","id":"example-payload-fragment","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Italy","description":"Create Italian commercial-document receipts with RT evidence","seo":{"title":"Italy ( IT )"}},"lastModified":"2026-07-29T20:49:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/it","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}