Integrations
In short
At the top, "Company connections": the tax authority (fiscal invoice issuing, certificate, sending to AEAT) and marketplaces (what is exchanged: stock, prices, orders, payouts). Below, "Data and service providers": each block is connected separately; without a provider the program works manually.
Why it matters
- See whether the company is ready to issue fiscal invoices and what is not set up yet.
- Connect an external service with its key and, if it fails, a backup provider.
Who can
The administrator; a manager with access to the whole company, if they have permission for sales channels or for fiscal settings. The "Data and service providers" block: administrator only.
How to do it
- Tax authority. The block shows the NIF, the company certificate and the "What is missing" list; with sending to AEAT enabled, also "Waiting to be sent to AEAT". Fill in what is missing and the state becomes "ready". The certificate (.p12, .pfx) is uploaded right here and checked at once: password, key of this certificate, whether it works for signing in to AEAT, validity. A self-signed one gets a warning: AEAT only accepts certificates from a recognised authority (FNMT and others). "Check the certificate" repeats the check without sending anything to AEAT. It can be uploaded before sending starts.
- Marketplace. "Connect Allegro" → sign in on allegro.pl with the seller's account → the program comes back here already connected: the "intermediary marketplace" channel and the "Allegro" marketplace customer are created automatically (the same account again: the same connection). The button is there once the installation administrator has connected the "Allegro application" (below). The channel row shows its condition and "Data exchange"; "Reconnect" if the sign-in was lost. The channel name leads to the marketplace customer card with the channel settings (and the fallback sign-in with a code). Own website and price list links. The own website is a "marketplace as agent" channel without a marketplace connection: "Create key" turns on receiving website orders via API and shows the key once (the address and a request example are on the channel orders screen); with "New key" the previous one stops working at once. Price list links are exports with the "Link" delivery method: when the file was updated and how many times it was downloaded; "Copy the link" gives the address for the customer.
- Provider. In an empty block click the provider, paste the key → "Connect". The program checks the key with the provider right away and fills in the rest (for example, the model); if the key is not accepted it says why and saves nothing. "Applies to", the order and other settings are under "Advanced". "Test" sends a trial request.
- Backup provider. "+ Backup provider": it goes after the connected ones (for the same scope: the whole installation or the organisation) and is used if the main one does not respond. An organisation's connection always comes before whole-installation ones. The model and prices are shown in the connection row. "Edit" changes the model, prices and "Advanced" without entering the key again: leave the key field empty to keep the saved one; the program checks the connection and saves. ChatGPT has a "Model for voice notes" in "Advanced": audio models do not read photos or PDFs, so voice notes in requests use a separate model and invoices use the main one. Audio costs more than text: enter the voice note prices from OpenAI's pricing page next to it, otherwise their spending is not counted in the monthly AI limit. If voice notes are on and the model cannot handle them, a hint appears under the connection.
- Key cannot be decrypted — "Enter again": the provider and settings are kept.
- Document recognition (AI). The model that reads photos and PDFs of invoices: Claude, ChatGPT, Gemini or "Other, OpenAI-compatible" (Mistral, OpenRouter, your own model). The key comes from the provider's account; the program picks the model from those available to the key (for a compatible service, only if it has one; otherwise enter it; if you change the address, enter the key again). Claude's prices per million tokens are filled in automatically; for ChatGPT and Gemini enter them from the provider's pricing page under "Advanced" (without them the monthly limit is not counted for that provider). "Check" verifies the key and the model at no cost. The backup model is used if the main one does not respond or answers outside the schema. Invoices contain personal data: you need a data processing agreement (DPA) with the provider; for Gemini, a paid key only. Enabling and the spending limit are in the "Invoice recognition (AI)" module under "Modules".
- Mail (SMTP). The mailbox that sends mail to customers and suppliers (estimate link, supplier order, price list to a customer, shop mail). SMTP server, sender address and password (for Gmail and Outlook, an app password from the account security settings) → "Connect": the program logs in to the server and sends a test letter to the sender address; if that fails it says why and saves nothing. Port 587 (STARTTLS) or 465 (SSL) under "Advanced"; the password is never sent without a secure connection. A company's mail goes before the mail of the whole installation; without a connection, mail goes through the mail in the server settings, if there is one. Changed the server — enter the password again.
Common messages
- "not ready" for the tax authority — see the "What is missing" list.
- "key cannot be decrypted" — the server encryption key changed: "Enter again".
- "manual" — the provider is not connected and the program works without it.
- "The mail server did not accept the user or password" — Gmail and Outlook need an app password, not the mail login password.
Questions and answers
What is the difference between disabling and deleting an integration? An integration switched off is not used (the block moves on to the next provider or works manually), but its key and settings are kept and it can be switched on again. "Delete integration" removes it together with the key: to bring it back, the key has to be entered again. Both are recorded in the "Audit log".
Can I see a provider's saved key? No: the key is stored encrypted and the program only shows "key saved". To change it: "+ Backup provider" → the same provider and the same "Applies to" → the new key → "Connect"; the integration is updated in place and keeps its order, but enter the "Advanced" values again. The key is a secret: do not send it to anyone.
What should I do if a key has fallen into the wrong hands? For your website key, press "New key": the previous one stops working at once; enter the new one on the website. For a provider key, revoke it in the provider's account, create a new one and enter it as described in the previous answer.
Why can't the administrator see installation-wide integrations? Installation-wide integrations are seen and changed only by an installation-wide administrator; a company's integrations, by an administrator of that whole company. An administrator of a single branch neither sees nor changes connected providers.
Why are invoices not sent to AEAT although the certificate is uploaded? Sending to AEAT is enabled on the server for the mandatory Verifactu date. While it is off, the block shows "not sent to AEAT" and "Sending to AEAT starts on the mandatory Verifactu date; the company certificate can be uploaded and checked in advance." The Verifactu block on the "Companies" screen holds the invoice series and, once sending is on, also the certificate and the sending queue.
Where next
- "Modules" — enabling parts of the program.
- Customer page → "Sales channels" — marketplace settings.