HomeProductsTax Return Forms (730)

Tax Return Forms (730)

€0.001 + VAT

Integrate via API the online service for submitting the 730 Declaration in a fast, secure and simple way. The service is managed by selected and recognised CAFs or Patronati and everything is done in full compliance with regulations.

Delivery

24 hours

available for
  • it

Openapi provides access via API to all the main Patronato and CAF services such as 730, NASpI, Voluntary Resignation and Pension Calculation.

The service is provided via API directly by a qualified professional and the timing, since it is carried out manually by operators, depends on the complexity of the file. Openapi guarantees that the entire process takes place in full compliance with current privacy regulations, with data minimisation and encryption logics.

Model 730 submission (Single or Joint)

With Openapi you can easily integrate the submission of the Model 730 tax return, both single and joint.

The Model 730 can be submitted directly by the declarant or via selected and recognised CAF and Patronati (with delegation).

Types of Declaration available:

  • Single 730 Declaration
  • Joint 730 Declaration

In this second case, the incomes and expenses of the two spouses are not added together. The individuals continue to be considered separate for tax purposes and therefore their incomes remain taxed separately.

The two services are available via separate endpoints.

REQUEST 730

GET /visure

To request the 730 with Visengine, it is first necessary to identify the hash that uniquely identifies each document or file.

This is possible via the endpoint GET /visure which needs no parameters and will return the complete list of documents and files that can be requested via Visengine plus the respective hash.

https://visengine2.altravia.com/visure/

VERIFY COSTS AND DATA

To verify the information, required documents, and the cost of the document, you need to make a request via the GET /visure/{hash_visura} endpoint and provide the hash of the previously obtained document.

EXAMPLE REQUEST

GET /visure/{hash_visura}

https://visengine2.altravia.com/visure/38934ffe45179c4d5b88e2a6b849799a

EXAMPLE RESPONSE

GET /visure/{hash_visura}

The response will indicate all the information needed to complete the document request such as mandatory fields.

{ 
 "data": {
   "hash_visura": "38934ffe45179c4d5b88e2a6b849799a",
   "json_struttura": {
     "campi": {
      "$0": {
        "nome": "Nome",
        "tipo": "testo",
        "null": false,
        "istruzioni": "Inserisci il nome del richiedente"
      },
       "$1": {
         "nome": "COGNOME",
         "tipo": "testo",
         "null": false,
         "ordine": "1",
         "istruzioni": "Inserisci il cognome del richiedente"
       },
       "$2": {
         "nome": "Email",
         "tipo": "email",
         "null": false,
         "ordine": "4",
         "istruzioni": "Inserire l'indirizzo email del richiedente"      
       },
       "$3": {
      "nome": "CELLULARE",
      "tipo": "testo",
        "null": false,
        "ordine": "3",
        "istruzioni": "Inserisci il numero di telefono del richiedente"
      },
     "$4": {
      "nome": ""CODICE FISCALE",
      "tipo": ""codice_fiscale_persona_fisica",
      "null": false,
      "ordine": "2",
      "istruzioni": "Inserire il codice fiscale del richiedente"
    },
    "$5": {
      "nome": "COPIA DOCUMENTO D`IDENTITÀ FRONTE RETRO",
      "tipo": "file",
      "null": false,
      "ordine": "5",
      "istruzioni": "Caricare una copia fronte retro del documento d`identità del richiedente."
    },
    "$6": {
      "nome": "COPIA CODICE FISCALE FRONTE RETRO",
      "tipo": "file",
      "null": false,
      "ordine": "6",
      "istruzioni": "Caricare una copia fronte retro del codice fiscale del richiedente."
    },
    "$7": {
      "nome": "COPIA MANDATO DI ASSISTENZA E RAPPRESENTANZA",
      "tipo": "file",
      "null": false,
      "ordine": "7",
      "istruzioni": "Caricare una copia del mandato di assistenza e rappresentanza del Caf assegnato."
    }
  },
     "validazione": "($0 && $1 && $2 && $3 && $4 && $5 && $6 && $7) || ($0 && $1 && $2 && $3 && $4 && $5 && $6)",
     "istruzioni": "",
     "istruzioni_ricerca": ""
   },
   "nome_categoria": "Patronato",
   "nome_visura": "730 Singolo",
   "opzioni": [
     { 
      "tipo": "urgenza",
      "prezzo": 4,
      "nome": "opzione_0",
    },
    {
      "tipo": "assistenza_dedicata",
      "prezzo": 10,
      "nome": "opzione_1",
    }
  ],
  "prezzo_ricerca": 0,
  "prezzo_visura": 25.7,
   "ricerca": false,
   "sincrona": false,
   "fornitori": [
   ]
 },
 "success": true,
 "message": "",
 "error": null
}

In validation, the data(s) required to successfully complete the request are indicated.

The data required for the request are:

  • name
  • surname
  • email
  • mobile phone
  • tax code number
  • copy of identity document
  • copy of tax code
  • authorization

Additional documents useful for submitting the 730 Declaration will be requested by the CAF or Patronato, which will handle the file in accordance with privacy regulations.

REQUEST DOCUMENT

EXAMPLE REQUEST

POST /richiesta

{
   "hash_visura": "38934ffe45179c4d5b88e2a6b849799a",
   "json_visura": {
     "$0": "Nome",
     "$1": "Cognome",
     "$2": "Email",
     "$3": "Cellulare",
     "$4": "Codice Fiscale",
     "$5": "Copia Documento d'identità",
     "$6": "Copia Codice Fiscale",
     "$7": "Copia Mandato di Assistenza e Rappresentanza"
     }
 }

EXAMPLE RESPONSE

POST /richiesta

The response returns several pieces of information including the status, if callback is set, and the request ID that we will need later to download the document.

{ "data": 
   {
     "_id": "5f2829ce065afc21cc60ad0e",
   "state": 1,
   "hash_visura": "38934ffe45179c4d5b88e2a6b849799a",
   "nome": "730 Singolo",
   "ricerca": false,
   "id_ricerca": null,
   "prezzo_visura":  25.7,
   "prezzo_ricerca":  0,
   "indice_ricerca": null,
   "stato_richiesta": "In erogazione",
   "email_target": null,
   "allegati": [],
   "timestamp_creation": 1596467662,
   "timestamp_last_update": 1596467663,
   "timestamp_stati": {
     "in_ricerca": 1596467663,
     "in_erogazione": 1596467663
   },
   "callback_data": false,
   "opzioni": null,
   "owner": "[email protected]",
   "sincrona": false,
   "ricerche": [],
   "esito": {
     "codice": "0",
     "info": "OK"
   }

DOWNLOAD DOCUMENT

Once the status of the request is in 'evaso' (=‘processed’), it is possible to download the document via the GET /documento/{_id} method.

EXAMPLE REQUEST

GET /documento/{_id}

This is an example of a request using the previously obtained ID

https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e

EXAMPLE RESPONSE

GET /documento/{_id}

The response will contain the name, size and file.

{
 data{
   "nome":"5f22f5b5065afc21cc60a27a.zip",
   "dimensione"10206",
   "file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
   },
   "success": true,
   "message": "",
   "error": null
 }

By integrating the Openapi's API, companies can offer their customers an efficient and compliant service for the submission of Form 730, taking advantage of the professional management of recognised CAFs and Patronati.

Sign Up

Do you need help?

Haven't found the answer you're looking for?

Fill in all the details, we will get back to you as soon as possible!

Frequently Asked Questions

The service allows the integration via API of the 730 request, which is the income tax return that can be submitted by taxpayers, particularly employees, pensioners, or collaborators.

With Openapi, it is possible to request both the Single 730 and the Joint 730.

The service is fast, easy, and secure and is managed by selected and recognized CAFs or Patronati in compliance with the regulations.

What is the Tax Return Forms 730 service?

The service is part of Docuengine, the API for requesting over 128 official documents, benefits, and reports, with data coming from certified sources.

The main categories of documents available via Docuengine are as follows:

  • Chamber of Commerce documents
  • Cadastral documents
  • Real Estate Services
  • Patronato services
What API does the service belong to?

The services currently available on Openapi include:

  • Unemployment allowance NASpI, NASpI COM, and Early NASpI
  • ISEE, ISEE Adjustment, Current ISEE, Residential Socio-Health ISEE
  • Single and Joint 730 forms
  • Single Allowance Application
  • Pension Calculation and Forecast and Contribution Extract
  • Survivor's Pension and Old Age Pension
  • Financial Package
  • CUD for Pensioners
  • Restoration of Contributions
  • OBIS-M
  • Resignation and Revocation of Voluntary Electronic Resignation
  • Request and Renewal of Disability Allowance
  • Maternity Benefits
  • Military Service Buyback
  • Compensation for Extraordinary Leave (Law 104) and Parental Leave
What Patronato services are available via API?

The service is designed for companies that wish to easily integrate the request for 730 via API, providing their clients and employees with a quick and high-quality experience.

The 730 application is entrusted to CAF and Patronati managed by authorized and specialized personnel, and everything is done in full compliance with privacy regulations.

Who is the Tax Return Forms 730 service designed for?

Openapi manages the entire request process via API in full compliance with the current privacy regulations, with data minimization and encryption measures.

For more information, you can consult the Privacy documentation on our website.

How is privacy handled?

The produced documents are deleted from Openapi's systems based on the timelines visible in the Redemption Period (the deadline after which the document is deleted from our servers) within the privacy documentation. If necessary, the client can contact the authorized Professional who provided the service, who is required to keep a copy in accordance with regulations.

After how long does Openapi delete the produced documents from its systems?

The service is provided within 3-5 working days from the delivery of the complete documentation.

What are the service processing times?

The cost per request is €25.70.

What are the costs of the Tax Return Forms 730 service?