openapi-documents · diff
git:20260610.a6e7f3f to git:20260610.0dfad19
23 added, 17 removed. Audit A to A.
---
name: openapi-documents
- description: Obtain official Italian documents through Openapi - chamber of commerce reports (visure camerali), financial statements/balance sheets, company files (fascicoli), bylaws, DURC, protest reports, cadastral documents. Use when the user needs an official PDF document about an Italian company or person.
+ description: Obtain official Italian documents through Openapi - chamber of commerce reports (visure camerali), financial statements/balance sheets, company files (fascicoli), bylaws, DURC, protest reports. Use when the user needs an official PDF document about an Italian company or person.
---
# Openapi official documents
- Three services deliver official documents; all are **asynchronous** (request → poll → download PDF).
+ Two main services deliver official documents; both are **asynchronous** (request → poll → download PDF) and **paid per document** — check wallet credit (`openapi-auth` skill) and confirm with the user before bulk requests.
- | Service | Base URL | Use for |
- |---|---|---|
- | DocuEngine (preferred) | `https://docuengine.openapi.com` | All documents: Business Register, Revenue Agency, Municipalities, INPS (DURC), protests, balance sheets |
- | Visure Camerali | `https://visurecamerali.openapi.it` | Chamber of commerce registrations and financial statements |
- | Visengine (legacy) | `https://visengine2.altravia.com` | Older engine for the same document families |
+ ## DocuEngine (preferred) — `https://docuengine.openapi.com`
- Authentication: Bearer token — see the `openapi-auth` skill.
+ Official documents from the Business Register, Revenue Agency, Municipalities and INPS, behind one uniform API:
- ## DocuEngine workflow
+ 1. `GET /documents` — list available document services (codes, prices).
+ 2. `POST /requests` — create a request with the service code and subject (VAT/tax code); optionally pass a `callback` URL.
+ 3. `GET /requests/{id}` — poll until the request state is fulfilled (`EVASA`).
+ 4. `GET /requests/{id}/documents` — download the resulting documents.
+ 5. `PATCH /requests/{id}` — update a request when the service asks for it (e.g. optical balance-sheet processing).
- 1. `GET /services` — discover available document types and prices.
- 2. `POST /documents` with the service code and subject (VAT/tax code) — returns a request `id`. Optionally pass a `callback` URL.
- 3. `GET /documents/{id}` — poll status until the document is ready.
- 4. Download the PDF from the returned URL/payload.
+ Document families: visura camerale (ordinaria/storica, per company type, also in English), fascicolo società (current/historical), bilancio (XBRL, ottico, riclassificato), statuto, certificato di iscrizione, certificato artigiano, DURC online, visura protesti and pregiudizievoli (companies and natural persons), cariche/quote/soci attivi, eventi negativi, atto ottico.
- Document families include: visura camerale (ordinaria/storica, by company type), fascicolo (company file, current/historical), bilancio (XBRL, ottico, riclassificato), statuto (bylaws), certificato di iscrizione, DURC online, protesti and pregiudizievoli (companies and persons), cariche/quote/soci (offices, shares, shareholders), eventi negativi.
+ ## Visure Camerali — `https://visurecamerali.openapi.it`
+ Direct chamber-of-commerce endpoints, one resource per document type, all with the same pattern `POST /<type>` → `GET /<type>/{id}` → `GET /<type>/{id}/allegati` (download):
+
+ - `ordinaria-impresa-individuale`, `storica-impresa-individuale`
+ - `ordinaria-societa-capitale`, `storica-societa-capitale`
+ - `ordinaria-societa-persone`, `storica-societa-persone`
+ - `bilancio-ottico`, `certificato-iscrizione`, `certificato-iscrizione-vigenza`, …
+ - Company search first: `GET /impresa?...` or `GET /impresa/{cf_piva_id}` to identify the subject.
+
+ Visengine (`https://visengine2.altravia.com`) is the older engine for the same families — prefer DocuEngine for new work.
+
## Notes
- - These calls are **paid per document** — check wallet credit first (`openapi-auth`) and confirm with the user before bulk requests.
- - Sandbox responses are illustrative; enable sandbox credit first.
- - Specs: [docuengine](../../knowledge/oas/docuengine.openapi.json) · [visurecamerali](../../knowledge/oas/visurecamerali.openapi.json) · [visengine](../../knowledge/oas/visengine.openapi.json) — endpoint lists in [knowledge/services/](../../knowledge/services/).
+ - Sandbox responses are illustrative; enable sandbox credit in the console first.
+ - Full specs: https://console.openapi.com/oas/en/docuengine.openapi.json · https://console.openapi.com/oas/en/visurecamerali.openapi.json · https://console.openapi.com/oas/en/visengine.openapi.json