Setup
Fiscal receipts and payments
How to set up electronic receipt transmission and card collection from your phone, before you ring up the first sale.
The dematerialised receipt — the Italian documento commerciale — is issued from counter sales and from completed work orders. But first you have to tell CrankPal who transmits it to the Italian Revenue Agency: your fiscal register or a software provider. That's what this tab is for, plus card collection from your phone.
You'll find it all under SettingsTill. It needs the manage_workshop permission, and the tab only appears if your plan includes e-invoicing, electronic receipts or SoftPOS: Pro and up.
Choosing the transmission mode#
In the Electronic receipts card, pick a mode from the list. The line under the dropdown always explains what that choice does.
- Off — no commercial document leaves the app.
- Demo (simulation) — transmission is faked. It's there to try the flow with no hardware and no provider.
- Epson fiscal register — a fiscal printer on the workshop's local network. The register itself transmits to the Revenue Agency; all you need is its IP address on the local network.
- API provider (software solution) — a generic endpoint, configured by hand: no preset provider. It asks for an API endpoint and an API key.
- Openapi (receipts + invoices) — a software solution through Openapi. It asks for the base URL (sandbox or production, depending on whether you're testing or working for real) and a Bearer token. The workshop's VAT number is used as the fiscal identifier.
You get the base URL, token and API key from the dashboard of the provider you chose: CrankPal does not generate them.
Once saved, the register of issued documents lives in Invoices and receipts.
Taking card payments: SumUp Tap to Pay#
The second card, SoftPOS · SumUp Tap to Pay, lets you take card payments without a physical terminal: all you need is the SumUp app installed on the workshop's phone.
Here's how it works: in counter sales a Collect with SumUp button appears, which opens the app for the contactless payment and, once done, returns to the app and records the sale.
To switch it on you need an affiliate key, which you generate yourself at me.sumup.com/developers, tied to the SumUp app on your account. Paste it into the field and save.
Verifying the payments#
Once the affiliate key is saved, a Payment verification block appears below. Turning it on is recommended.
The Connect with SumUp button links your SumUp account to the app, so every payment is confirmed directly with SumUp and not only from the phone app. When it's active you see a confirmation badge with your merchant code, and a Disconnect button if you want to undo it.
Common problems#
The “Till” tab doesn't show up in settings.
It depends on the plan: it appears from Pro up. You also need the manage_workshop permission. See features by plan.
The fiscal register doesn't respond.
The IP address you enter has to be reachable from the same local network you work on. If the counter computer and the printer sit on two different Wi-Fi networks they can't see each other: that's the most common cause.
I can't see the “Payment verification” block.
It only appears after the SumUp affiliate key has been saved. If you've just pasted the key, save the configuration and reload the page.
The “Collect with SumUp” button doesn't appear in counter sales.
Check that the affiliate key is saved here and that the phone you use at the counter has the SumUp app installed: the payment happens there, the app just opens it.