Fatture in Cloud
Connect a laboratory to Fatture in Cloud, choose the company, configure numbering and tax, map clients, and submit e-invoices to SDI.
Fatture in Cloud is the Italian invoicing platform GuideLab uses as the fiscal ledger for laboratories that bill in euro. GuideLab issues the commercial document; Fatture in Cloud assigns its fiscal number, keeps it in the company ledger, and transmits it to the Sistema di Interscambio (SDI).
The connection is made once per laboratory from Settings → Integrations, in the Finance & Procurement section.
Before you start
You need:
- a Fatture in Cloud account with access to the company GuideLab should write into;
- an organization that bills in EUR. Fatture in Cloud only holds euro documents, so the connect button stays disabled for any other currency and the card explains that the currency must be changed in Company settings first;
- the manager role in the laboratory organization. Connecting, choosing the company, changing settings, and submitting to SDI are all manager-only.
One Fatture in Cloud company can be linked to one GuideLab organization only.
Connect
Start the authorization
Open the Fatture in Cloud card and, on the Connection tab, select Connect to Fatture in Cloud. GuideLab redirects to Fatture in Cloud, where you sign in and approve the requested permissions.
GuideLab asks for the permissions it needs and nothing more: read and create clients, create invoices and credit notes and update their payment schedules, and read your numeration series, VAT types, payment accounts and payment methods. Your Fatture in Cloud password is never seen by GuideLab, and the resulting access tokens are encrypted at rest.
Choose the company
If the authorized account holds more than one company, the card shows Choose the company with each company's name and VAT number. Select the one GuideLab should write documents into.
An account holding a single company is bound automatically and this step does not appear. A company already linked to another GuideLab organization is refused.
Configure the ledger
Open the Settings tab. GuideLab reads the live configuration of the connected company, so the choices below are your own Fatture in Cloud settings, not a separate copy:
- Numeration series: the series the fiscal number is assigned inside, for
example
/GL. Leave it empty to use the company's default series. - Default VAT type: applied to exported document lines. A taxed invoice without a configured VAT type is held for review rather than exported with a guess.
- VAT type per rate: every VAT rate your laboratory charges needs its Fatture in Cloud VAT type, including the rates of your shipping types, because shipping is exported as its own line at its own rate. A line whose rate has no VAT type is held for review.
- Payment account and Payment method: used when recording paid amounts on exported documents.
- Auto-export invoices on send: exports an invoice as soon as it is issued in GuideLab.
- Auto-sync payments: updates the document's payment schedule when a payment is recorded in GuideLab.
Select Save Settings to apply them.
Verify with one document
Issue a single invoice and open the Sync Log tab. The operation should appear as Success with the fiscal number Fatture in Cloud assigned, and the same document should be visible in your company ledger with the next progressive number in the chosen series.
Fatture in Cloud owns the number
GuideLab creates the document without a number and never sends a progressive, so the series cannot gap or collide. The GuideLab invoice reference travels in the document's visible subject.
Client mappings
The Client Mappings tab links your clinics to Fatture in Cloud clients by fiscal identity, using the VAT number or tax code, never by name similarity. Mappings are created automatically the first time a document for that clinic is exported.
The table shows the clinic, the matched Fatture in Cloud client, the fiscal identity used, and how the match was made: VAT number, Tax code, Manual, or Auto-created.
To correct a match, select the client name and search your Fatture in Cloud clients, then pick the right one. To discard a match and let it be made again on the next export, remove it with the delete action on the row.
Sync log
The Sync Log tab lists the most recent operations with their date, document type (Invoice or Credit note), action (Create, Payments, SDI send, SDI status), status, assigned fiscal number, and SDI state.
An operation is one of:
- Success: the operation completed on the Fatture in Cloud side;
- Pending: the operation is queued or in progress;
- Failed: the operation did not complete and can be retried;
- Needs review: the document cannot be exported safely as it stands, for example a taxed invoice with no configured VAT type, or an outcome GuideLab could not confirm. Fix the underlying cause, then retry.
Retry re-runs a failed or needs-review operation. GuideLab reconciles against the ledger before acting, so a retry does not create a duplicate document.
Corrections
A numbered fiscal document is never deleted or overwritten through the API. To correct an exported invoice, issue a credit note in GuideLab; it is exported as a nota di credito against the original.
If a payment exists in Fatture in Cloud that GuideLab does not know about, payment reconciliation stops and reports the conflict instead of overwriting your ledger.
Send an e-invoice to SDI
SDI submission is switched off by default. Turning on Enable SDI submission in the Settings tab does not send anything: it only reveals the Send to SDI action on individual invoices in the sync log.
To submit, find the invoice's successful Create operation in the sync log and select Send to SDI. A confirmation dialog states that this transmits a legal fiscal document to the Sistema di Interscambio through Fatture in Cloud, and that it cannot be recalled once sent. The e-invoice is validated before transmission.
The SDI column then tracks the outcome: Not sent, In progress, Delivered, Accepted, Rejected, Error, or Needs review. Use Refresh status on an in-progress submission to fetch the current state; GuideLab also refreshes submissions in flight on its own.
Submission is a legal act
There is no automatic path to SDI in GuideLab. Every submission is a deliberate action on one named invoice, confirmed by a manager, and irreversible once accepted by the exchange system. Test against a trial company before submitting real documents.
Disconnect
Disconnect on the Connection tab stops exporting invoices and payments to Fatture in Cloud. Documents already in your ledger are not affected, and you can reconnect at any time.
Disconnecting does not revoke the authorization inside Fatture in Cloud itself. To remove GuideLab's access there as well, revoke it from your Fatture in Cloud account settings.
If the connection fails
The card reports the specific reason rather than a generic failure. The most common ones:
- the request expired: the connection attempt is valid for a short window. Start it again from the integrations page;
- the company is already linked: that Fatture in Cloud company belongs to another GuideLab organization;
- the tax details do not match: the company's VAT number does not match the registration number on your GuideLab organization profile;
- no companies are visible: the account you signed in with cannot reach the company. Sign in with one that can;
- euro billing required: set the organization currency to EUR in Company settings, then connect.