Skip to content

Getting Started with SDH

Taking into account the Glossary of Terms and the Frequently Asked Questions, the following explains the steps required to begin operating with the SDH platform.

Development or Test Environment Notes

  • Authentication Error:
    This occurs when you obtain the certificate for SDH authentication from the Real environment and then try to upload an invoice to the Test environment, resulting in an authentication error.
    This is because the periodic data transfer between the Real and Test environments has not yet been performed.
    In this case, you can send an email to support@solmicrosdh.com indicating this situation, or you can wait until this periodic transfer is completed.

  • QR Code for Invoices and Communication to the Spanish Tax Agency (AEAT):
    The Test environment is intended for development testing and not for clients to send real invoices including a QR code that is not real, as it points to the AEAT test environment.
    Until December 2025, this scenario of clients sending invoices to the Test environment so that they could then be transferred to the Live environment with minimal effort was permitted.
    As the mandatory implementation date has been delayed, and to avoid problems for end customers who may send their invoices through the SDH Test Environment, the following modifications have been made:

    • Billing records are no longer submitted to the tax authorities, and the generated QR code will contain a watermark.
      This does not mean that SDH will stop responding as before; it simply means that the information is no longer being sent to the Spanish Tax Agency (AEAT).
      Upon registration, the invoice will be treated as if it had been submitted to the AEAT, and querying the invoice will only return the registration status in SDH.

    • Billing records will only be submitted, and the QR code for the tax authority's test environment will only be generated, when using the tax identification number (NIF) A39200019.

What should you do as a Software Developer connecting to SDH?

  • Request registration in the Development or Test environment, providing, among other data: NIF, business name, and the name and email of the contact person. You will receive an email with access to SDH.

  • Manage the data required to connect to the SDH API (company and installation identifiers, and the authentication certificate) from the Development or Test environment. See SDH Role for Customer Administrator.
    In the Development or Test environment, the tax identification number (NIF) A39200019 is assigned for non-Spanish Software Developers.

  • Regarding tax‑related questions (what is taxable and how it is taxed), we can offer information based on our knowledge or on official documentation, but we do NOT act as tax advisors nor provide binding interpretations of tax regulations.
    We recommend reviewing Company Questions and Veri*Factu Compliance.

  • Develop the SDH connection according to the Compliance Checklist.

  • During implementation at your clients, take into account the Development or Test environment notes.

What should you do as a Distributor?

  • Request registration as a Distributor in the Production (Real) environment, providing, among other data: NIF, business name, and the name and email of the contact person. You will receive an email with access to SDH.

  • Request the registration of your customers in SDH, providing, among other data:

Required Data Optional Data
NIF of the taxpayer Address, city, postal code, and telephone number of the taxpayer
Business name of the taxpayer Name and email of the contact person
Name of the person who will act as the Company Administrator Name, email and NIF of the person who signs the SDH documents
Email of the person who will act as the Company Administrator
Document limit for the tariff plan: 500, 1000, 3000, 6000, 12000, 30000, 60000, 120000, 240000, 360000
In multi‑company environments, the Name and NIF of the Customer

  • In certain cases involving massive customer onboarding (e.g., Cloud‑based Software), and in coordination with the SDH Administrator, SDH may return the company and installation identifiers associated with each company.

  • Each customer will receive an email with the access to SDH.

  • Follow the indications provided in Roles as Distributor.

  • During implementation at your clients, take into account the Development or Test environment notes.

What should you do as a Customer?

You will have received an email with the access to SDH and one or more emails notifying the registration of associated companies.

Follow the indications in Roles as Customer.